Workiva-ondersteuningscentrum

Om flexibele pijplijnen en mappinggroepen mogelijk te maken, kunt u variabele waarden gebruiken in transformaties en mappingregels. 

Vereisten

Data Prep wordt volledig op org-niveau beheerd en herkent geen individuele workspaces of hun machtigingen.

Dit betekent:

• Data Prep wordt gedeeld door alle geautoriseerde gebruikers in uw org.
• Elke gebruiker met toegang tot Chain Builder heeft ook toegang tot Data Prep.
• Alle gebruikers die ketens kunnen maken of bewerken, zullen de mogelijkheid hebben om pijplijnen in Data Prep te beheren.
• Eén enkele Data Prep pipeline kan in meerdere ketens en workspaces binnen een organisatie worden gebruikt.
  
  

Variabele types

U kunt verschillende soorten variabelen gebruiken met een pijplijn, gebaseerd op de waarde die u wilt retourneren.

Een variabele waarde invoeren

U kunt een variabele selecteren voor sommige waarden binnen een transformatie- of mappingregel:

• Om een variabele voor een transformatie te selecteren, klikt u op Variabele code in het veld.
  
• Om een variabele voor een toewijzingsregel te selecteren, klikt u op het veld Van of Naar.
  

U kunt meerdere variabele waarden in een veld opnemen, of variabelen combineren met statische waarden.

Runtime variabelen aanmaken voor een pijplijn of mappinggroep

U kunt runtime variabelen aanmaken om waarden in te stellen voor transformaties of mappinggroepen wanneer de pijplijn wordt uitgevoerd.

Opmerking: U kunt een runtimevariabele alleen gebruiken met kolommen van hetzelfde gegevenstype. Om een variabele met meerdere kolommen van verschillende gegevenstypes te gebruiken, maakt u voor elk type een aparte variabele.

1. Selecteer in de pipeline of mapping groep het tabblad Variables code.
2. Voeg de variabele toe:
   • Als het de eerste variabele is, klikt u op Variabelen maken.
     
   • Anders klikt u onder Variabelen bewerken op Variabele toevoegen.
     
     
     
3. Selecteer het gegevenstype van de kolommen om de variabele te gebruiken, zoals String of Number.
4. Als de waarde van de variabele nodig is om de pijplijn uit te voeren, controleer dan Vereist.

   Opmerking: Als Vereist is aangevinkt en de waarde is niet ingevoerd tijdens runtime, wordt de pijplijn niet uitgevoerd, zelfs als de variabele een standaardwaarde heeft.

5. Voer in Weergavenaam een naam in om de variabele te helpen identificeren.
6. Voer de standaardwaarde van de variabele in, indien van toepassing.
7. Klik op Opslaan.

Tip: Als u een runtimevariabele aanmaakt voor een mappinggroep, maak dan een overeenkomstige variabele aan voor elke pijplijn die de mappinggroep gebruikt in een Mapping transformatie. Om de variabelen tussen de pijplijn en de mappinggroep in kaart te brengen, gebruikt u voor beide dezelfde naam. Om de variabele van de mappinggroep te onderscheiden, voegt u een voorvoegsel toe aan de naam, zoals MG_.

Voorbeeldwaarden instellen voor de runtimevariabelen van een pijplijn

Als een pijplijn runtimevariabelen gebruikt, stel dan de waarden in die gebruikt moeten worden om de transformaties te bekijken.

Opmerking: Als een runtimevariabele vereist is, heeft de pijplijn de waarde ervan nodig om transformaties vooraf te bekijken. Als een runtimevariabele niet vereist is, verschijnt null in de preview totdat de waarde ervan is ingesteld.

1. Selecteer in de pijplijn het tabblad Variabelen code en klik op Variabelen bewerken.
2. Onder Voorbeeldvariabelen instellen, voert u de waarden voor de runtimevariabelen van de pijplijn in.
3. Klik op Waarden instellen.

Opmerking: Het bericht, Er is een fout opgetreden bij het verwerken van uw transformatie. Uitzondering bij voorvertoning van pijplijn #### op voorbeeldbestand ####. Variabelen [] zijn gemarkeerd als vereist, maar hebben geen niet-lege waarde ingesteld. wordt weergegeven als een runtimevariabele vereist is, maar er geen voorbeeld is ingevuld.

Runtime variabelen bewerken

U kunt runtimevariabelen op elk moment bewerken.

1. Selecteer in de groep pijplijn of mapping het tabblad Variabelen code en klik op Variabelen bewerken.
2. Werk waar nodig het gegevenstype, de Required status, de naam of de standaardwaarde van de variabelen bij.
3. Klik op Opslaan.
4. Als u het gegevenstype bewerkt, moet u ook elke transformatie bijwerken die de variabele waarde gebruikt.

Runtime-variabelen verwijderen

Als u een runtimevariabele niet langer nodig hebt, kunt u deze uit de pijplijn of mappinggroep verwijderen.

1. Selecteer in de groep pijplijn of mapping het tabblad Variabelen code en klik op Variabelen bewerken.
2. Klik voor de variabele die u wilt verwijderen op verwijderen.
3. Klik op Opslaan.
4. Werk elke transformatie die de variabele gebruikte bij met een nieuwe waarde.