Om waarden in te stellen voor ingangen die herhaaldelijk voorkomen in meerdere ketens of opdrachten binnen één keten, kunt u variabelen gebruiken. In plaats van dezelfde waarde in meerdere ketens of opdrachten in te voeren, kunt u deze als variabele definiëren en de waarde ervan op één plaats beheren.
- Werkruimtevariabelen definiëren waarden die in meerdere ketens voorkomen.
- Kettingvariabelen definiëren waarden die in meerdere opdrachten van een keten voorkomen en vaak kunnen veranderen.
- Dynamische variabelen definiëren waarden die ingesteld moeten worden wanneer een keten wordt uitgevoerd of tijdens de uitvoering van een keten, bijvoorbeeld op basis van de uitvoer van een eerder commando.
Aanvullende training beschikbaar
U kunt de kracht van ketens leren met onze zelfstudiecursus in de Workiva Learning Hub. Deze uitgebreide cursus leidt u van begin tot eind door het proces van het creëren van een keten, waarbij u praktijkervaring opdoet en een diepgaand inzicht krijgt in het Chain Builder platform.
Bezoek de Workiva Learning Hub
Beheer de variabelen van uw werkruimte
Vanuit uw werkruimte kunt u de variabelen definiëren die door meerdere ketens worden gebruikt:
- In Chain Builder, selecteert u Settings links bovenaan.
- Klik rechts van Variables op Add.
- Om de variabele te helpen identificeren, voert u de naam en, indien nodig, de standaardwaarde en beschrijving in. Deze standaardwaarden kunnen later voor individuele ketens worden aangepast.
- Voor extra beveiliging selecteert u coderen - hierdoor worden gevoelige waarden zoals wachtwoorden verborgen.
- Klik op Opslaan.
Nadat u een variabele aan uw werkruimte hebt toegevoegd, kunt u de naam, waarde of codering ervan indien nodig bewerken. Om een variabele uit de werkruimte te verwijderen, klikt u op Verwijderen.
De variabelen van een keten beheren
Waarden die in meerdere opdrachten binnen een keten voorkomen en vaak veranderen, voegt u toe als variabelen voor de keten. Er is geen harde limiet aan het aantal variabelen in een keten, maar er is een verminderde reactiesnelheid waargenomen wanneer ketens 1000 variabelen benaderen.
- Klik in de keten op Keteninstellingen.
- Klik onder Variabelen op Toevoegen.
- Voer een unieke naam en beschrijving in om de variabele en de bedoeling ervan te helpen identificeren.
- Voer de standaardwaarde voor de variabele in.
- Om ervoor te zorgen dat alleen beheerders de waarde van de variabele kunnen zien, zoals voor wachtwoorden, selecteert u coderen.
- Klik op Opslaan.
Om een variabele bij te werken, klikt u op Bewerken voor de keten en past u de waarde aan onder Variabelen.
Om een variabele te verwijderen die u niet langer nodig hebt, klikt u op Verwijderen.
De dynamische variabelen van een keten beheren
Om waarden in te stellen wanneer de ketting loopt, of om waarden te baseren op de uitvoer van een ander commando, voegt u ze toe als dynamische variabelen voor de ketting.
Opmerking: Om opeenvolgende runs te vergemakkelijken, behouden dynamische variabelen de waarden die tijdens de vorige run van de keten zijn ingesteld.
- Klik in de keten op Keteninstellingen.
- Klik onder Dynamische variabelen op Toevoegen.
- Voer een unieke naam in om de variabele en de bedoeling ervan te helpen identificeren.
Opmerking: Het veld Beginwaarde is hier niet van toepassing en moet leeg blijven.
- Klik op Opslaan.
Opmerking: Om de waarden van de dynamische variabelen in te stellen wanneer een keten begint te lopen, start u deze met een Runtime Inputs trigger event. Om een keten te pauzeren om de waarde van een dynamische variabele te definiëren voordat u naar de volgende stap gaat, voegt u een Dynamische ketenvariabelen instellen gebeurtenis toe.
Om een variabele te verwijderen die u niet langer nodig hebt, klikt u op Verwijderen.
Variabelen als opdrachtinvoer gebruiken
Variabelen gebruiken als tekstgebaseerde invoer voor een opdracht:
- Selecteer in de keten de opdracht om de variabelen te gebruiken.
- Klik in de tekstgebaseerde invoer om een variabele te gebruiken op Variabele en selecteer de variabele.
Opmerking: Om meerdere variabelen binnen een invoer samen te voegen, selecteert u de variabelen die u wilt gebruiken en voert u vervolgens tekst in die voor of na elke variabele moet verschijnen.
- Klik op Opslaan.
Opmerking: Om een variabele te wijzigen of op te maken voor gebruik als invoer van een opdracht, past u een variabele transformatie toe.
Runtime variabelen
Om gegevens op te nemen die te maken hebben met wanneer een keten loopt, kunt u verschillende runtimevariabelen gebruiken.
| Variabel | Beschrijving |
|---|---|
| Keten.omgeving | De omgeving van de momenteel lopende keten |
| Chain.ExecutionDateTime | De datum en tijd waarop de ketting begint |
| Keten.UitvoerderId | Het numerieke ID van de momenteel lopende keten |
| Keten.Id | Het numerieke ID van een keten in de niet-lopende status |
| Keten.naam | De naam van de momenteel lopende ketting |
| Ketting.VorigeUitvoeringsDatumTijd | De datum en tijd waarop de ketting voor het laatst is uitgevoerd |
| Ketting.URL | De unieke URL van de momenteel lopende keten |
| Keten.werkruimte | De werkruimte van de momenteel lopende ketting |
| Command.ExecutorId | De numerieke ID van de momenteel lopende opdracht |
| Commando.Id | Het numerieke ID van een commando in de niet-lopende status |
| Commando.naam | De naam van de momenteel lopende opdracht |
| Commando.URL | De unieke URL van de momenteel lopende opdracht |
| Runner.InstallationDirectory | De installatiemap voor de GroundRunner van de keten; nul als een CloudRunner wordt gebruikt |
| Systeem.Datum | De huidige systeemdatum |
| System.DateTime | De huidige systeemdatum en -tijd |
| Gebruiker.e-mail | Het e-mailadres van de medewerker die de ketting heeft geleid |
| Gebruiker.Id | Het ID van de medewerker die de keten uitvoerde |
| Gebruiker.naam | De naam van de medewerker die de keten leidde |