Workiva Support Center

Um flexible Pipelines und Mapping-Gruppen zu ermöglichen, können Sie variable Werte in Transformationen und Mapping-Regeln verwenden. 

Anforderungen

Data Prep wird vollständig auf Organisationsebene gesteuert und kennt keine individuellen Arbeitsbereiche oder deren Berechtigungen.

Dies bedeutet:

• Data Prep wird von allen autorisierten Benutzern in Ihrer Organisation gemeinsam genutzt.
• Jeder Benutzer mit Zugriff auf Chain Builder hat auch Zugriff auf Data Prep.
• Alle Benutzer, die Ketten erstellen oder bearbeiten können, haben die Möglichkeit, Pipelines in Data Prep zu verwalten.
• Eine einzige Datenvorbereitungspipeline kann über mehrere Ketten und Arbeitsbereiche innerhalb einer Organisation hinweg verwendet werden.
  
  

Variable-Typen

In einer Pipeline können Sie je nach dem zurückzugebenden Wert verschiedene Arten von Variablen verwenden.

Eingabe eines variablen Wertes

Sie können eine Variable für einige Werte innerhalb einer Transformation oder Mapping-Regel auswählen:

• Um eine Variable für eine Transformation auszuwählen, klicken Sie auf Variable code im Feld.
  
• Um eine Variable für eine Zuordnungsregel auszuwählen, klicken Sie auf das Feld von oder nach.
  

Sie können mehrere Variablenwerte in ein Feld aufnehmen oder Variablen mit statischen Werten kombinieren.

Erstellen von Laufzeitvariablen für eine Pipeline oder Mapping-Gruppe

Sie können Laufzeitvariablen erstellen, damit bei der Ausführung der Pipeline Werte für Transformationen oder Mapping-Gruppen festgelegt werden können.

Hinweis: Sie können eine Laufzeitvariable nur mit Spalten desselben Datentyps verwenden. Um eine Variable mit mehreren Spalten unterschiedlicher Datentypen zu verwenden, erstellen Sie für jeden Typ eine eigene Variable.

1. Wählen Sie in der Pipeline- oder Mapping-Gruppe die Registerkarte Variablen code.
2. Fügen Sie die Variable hinzu:
   • Wenn die erste Variable, klicken Sie auf Variablen erstellen.
     
   • Ansonsten klicken Sie unter Variablen bearbeiten auf Variable hinzufügen.
     
     
     
3. Wählen Sie den Datentyp der Spalten aus, in denen die Variable verwendet werden soll, z. B. String oder Number.
4. Wenn der Wert der Variablen für die Ausführung der Pipeline erforderlich ist, überprüfen Sie Erforderlich.

   Hinweis: Wenn Erforderlich markiert ist und der Wert nicht zur Laufzeit eingegeben wird, wird die Pipeline nicht ausgeführt, auch wenn die Variable einen Standardwert hat.

5. Geben Sie unter Anzeigename einen Namen ein, um die Variable zu identifizieren.
6. Geben Sie ggf. den Standardwert der Variablen ein.
7. Klicken Sie auf Speichern.

Tipp: Wenn Sie eine Laufzeitvariable für eine Mapping-Gruppe erstellen, erstellen Sie eine entsprechende Variable für jede Pipeline, die die Mapping-Gruppe in einer Mapping Transformation verwendet. Um die Zuordnung der Variablen zwischen der Pipeline und der Mapping-Gruppe zu erleichtern, verwenden Sie für beide den gleichen Namen. Um die Variable der Zuordnungsgruppe zu unterscheiden, hängen Sie ein Präfix an ihren Namen an, z. B. MG_.

Vorschauwerte für die Laufzeitvariablen einer Pipeline festlegen

Wenn eine Pipeline Laufzeitvariablen verwendet, legen Sie die Werte fest, die für die Vorschau ihrer Transformationen verwendet werden sollen.

Hinweis: Wenn eine Laufzeitvariable erforderlich ist, benötigt die Pipeline ihren Wert für die Vorschau von Transformationen. Wenn eine Laufzeitvariable nicht benötigt wird, erscheint null in der Vorschau, bis ihr Wert gesetzt ist.

1. Wählen Sie in der Pipeline die Registerkarte Variablen code und klicken Sie auf Variablen bearbeiten.
2. Unter Setze Vorschauvariablen geben Sie die Werte für die Laufzeitvariablen der Pipeline ein.
3. Klicken Sie auf Werte einstellen.

Hinweis: Die Meldung Es ist ein Fehler bei der Verarbeitung Ihrer Transformation aufgetreten.  Ausnahme bei der Vorschau der Pipeline #### in der Beispieldatei ####.  Variablen [] sind als erforderlich gekennzeichnet, haben aber keinen nicht leeren Wert. wird angezeigt, wenn eine Laufzeitvariable erforderlich ist, aber keine Vorschau ausgefüllt ist.

Laufzeitvariablen bearbeiten

Sie können Laufzeitvariablen jederzeit bearbeiten.

1. Wählen Sie in der Pipeline- oder Mapping-Gruppe die Registerkarte Variablen code und klicken Sie auf Variablen bearbeiten.
2. Aktualisieren Sie bei Bedarf den Datentyp der Variablen, Erforderlicher Status, Name oder Standardwert.
3. Klicken Sie auf Speichern.
4. Wenn Sie den Datentyp bearbeiten, aktualisieren Sie auch jede Transformation, die den Variablenwert verwendet.

Laufzeitvariablen löschen

Wenn Sie eine Laufzeitvariable nicht mehr benötigen, können Sie sie aus der Pipeline oder Mapping-Gruppe löschen.

1. Wählen Sie in der Pipeline- oder Mapping-Gruppe die Registerkarte Variablen code und klicken Sie auf Variablen bearbeiten.
2. Klicken Sie für die zu entfernende Variable auf Löschen löschen.
3. Klicken Sie auf Speichern.
4. Aktualisieren Sie jede Transformation, die die Variable verwendet, mit einem neuen Wert.