Workiva-ondersteuningscentrum

Bij het maken van een sjabloon kunt u een gepubliceerde reeks als basis gebruiken of een geheel nieuwe reeks opdrachten en gebeurtenissen samenstellen.

Met deze sjablonen kunt u vervolgens een vooraf samengestelde reeks commando's en gebeurtenissen creëren die u in andere ketens kunt gebruiken. Met sjablonen kunt u bijvoorbeeld het volgende doen:

• Geef een voorsprong om het aanleggen van een ketting te vergemakkelijken.
• Standaardiseer gangbare workflows, bijvoorbeeld voor het extraheren van gegevens uit uw bronsysteem.

Opmerking: Je kunt een sjabloon met meerdere ketens, werkruimtes en omgevingen gebruiken in Chain Builder .

Maak een sjabloon van een bestaande keten

Het bouwen van een sjabloon op basis van een bestaande keten biedt een aantal voordelen:

• Je kunt de eerste ketting als uitgangspunt gebruiken om andere kettingen te maken.
• Je kunt de keten delen met anderen via Chain Builder —ook met mensen van andere organisaties, bijvoorbeeld in de Workiva Community . 

Om een ​​sjabloon te maken van een bestaande keten:

1. Klik vanuit Workiva op Kettingen .
2. Selecteer het tabblad Ketens en open vervolgens de keten die u als sjabloon wilt gebruiken.
3. Selecteer in het menu met de drie puntjes rechtsboven in de keten Sjabloon maken .
   
4. Voer een unieke naam en beschrijving in om de sjabloon te identificeren.
   
5. Selecteer onder Mappen de locatie waar u de sjabloon wilt opslaan.
6. Klik op Opslaan .
7. Als de keten variabelen bevat, stel dan elke sjabloonvariabele in:
   

   • Voer de standaardnaam in voor de sjabloonvariabele.

     Tip: Om de juiste waarde voor een variabele te identificeren, raden we aan een voorvoegsel aan de naam toe te voegen. Bijvoorbeeld: WSV- voor een werkruimtevariabele, CV- voor een ketenvariabele, DCV- voor een dynamische ketenvariabele, of Resource- voor een werkruimtebron.

   • Verwijder de standaardwaarden om de overdraagbaarheid en het hergebruik te vergemakkelijken.

   • Selecteer of een dynamische ketenvariabele of een werkruimtebron de waarde zal leveren.

     Opmerking: Als een ketenvariabele, werkruimtevariabele of runtimevariabele de waarde levert, selecteer dan noch Dynamisch noch Bron .

8. Klik op Opslaan en Publiceren .

Maak een sjabloon helemaal zelf.

Om een ​​nieuwe reeks commando's en gebeurtenissen te bouwen als herbruikbaar raamwerk voor ketens, volg je deze stappen.

Stap 1: Voeg de sjabloon toe

1. In Chain Builder , klik in het tabblad Templates dynamic_feed op Create => Template rechtsboven.
2. Om de sjabloon op een andere locatie dan de Standaard map te maken, klikt u op Bewerken bewerken voor de map, selecteert u de map waarin u de sjabloon wilt opslaan en klikt u op Verplaatsen .

3. Voer een unieke naam en beschrijving in om de sjabloon en het doel ervan te identificeren.

   Tip: Om te bepalen of een sjabloon een reeks voor een volledige of gedeeltelijke keten levert, kunt u een voorvoegsel aan de naam toevoegen. Bijvoorbeeld: Volledig- voor een complete keten, of Gedeeltelijk- voor een gedeeltelijke keten of fragment.

Stap 2: Stel de variabelen van de sjabloon in.

Om aanpassing en hergebruik te vergemakkelijken, bevatten sjablonen variabelen als plaatsaanduidingen voor waarden die nodig zijn voor de variabelen van de opdrachten of de resources van de werkruimte. Wanneer je een keten maakt op basis van de sjabloon, vervangen de variabelen en resources van de keten de variabelen van de sjabloon.

Voor elke variabele die in de sjabloon moet worden opgenomen:

1. Klik onder Template Variables op Add .

2. Voer de naam en de standaardwaarde van de variabele in.

   Tip: Om de juiste waarde voor een sjabloonvariabele te identificeren, raden we aan een voorvoegsel aan de naam toe te voegen. Bijvoorbeeld: WSV- voor een werkruimtevariabele, CV- voor een ketenvariabele, DCV- voor een dynamische ketenvariabele, of Resource- voor een werkruimtebron.

3. Selecteer onder Type of een dynamische ketenvariabele of een werkruimtebron de waarde van de variabele zal leveren.

   Opmerking: Als een ketenvariabele, werkruimtevariabele of runtimevariabele de waarde levert, selecteer dan noch Dynamisch noch Bron .

Nadat je alle variabelen voor de sjabloon hebt toegevoegd, klik je op Opslaan .

Opmerking: Om een ​​variabele uit de sjabloon te verwijderen, klikt u op de X onder Acties .

Stap 3: Definieer de knooppunten van de sjabloon

Wanneer je een sjabloon maakt, stel je de knooppunten in en verbind je ze in de juiste volgorde:

• Commando's of taken die worden uitgevoerd door ketens die zijn gemaakt op basis van de sjabloon, bijvoorbeeld om te interageren met het Workiva-platform of een andere gegevensbron.
• Gebeurtenissen die plaatsvinden binnen de sjabloon, zoals het inschakelen van een goedkeuringsworkflow of het handmatig uploaden van bestanden.
• Triggergebeurtenissen , zoals runtime-inputs om variabelen in te stellen—bijvoorbeeld voor specifieke accounts, regio's of tijdsperioden—wanneer u ketens uitvoert die zijn gemaakt op basis van de sjabloon, of om de keten automatisch te starten op basis van wijzigingen in verbonden bronnen.

Opmerking: Om aanpassing en hergebruik mogelijk te maken, gebruiken de opdrachten van een sjabloon geen verbindingen, runners of variabelen die in de keten of werkruimte zijn ingesteld; u specificeert deze wanneer u een keten maakt op basis van de sjabloon.

Knooppunten toevoegen

Wanneer je een knooppunt toevoegt, verplaats je het naar de juiste positie in de reeks en koppel je het aan de volgende en vorige stappen.

• Om het eerste knooppunt van de sjabloon toe te voegen, verplaats je het naar Start .
• Om een ​​knooppunt toe te voegen als begin van een nieuwe tak van een logische boom, koppelt u de vorige stap in de sjabloon aan het eerste knooppunt van de meerdere takken.
• Om opdrachten parallel aan elkaar of samen als onderdeel van een serieel proces uit te voeren, maak een opdrachtgroep aan als stap.

Opmerking: Standaard wordt een knooppunt uitgevoerd wanneer het gekoppelde vorige knooppunt succesvol is. Om voorwaardelijke logica in te schakelen, bijvoorbeeld om een ​​knooppunt alleen uit te voeren wanneer het vorige knooppunt mislukt, dubbelklik je op de link en selecteer je de voorwaarde: succes check_circle , mislukking error , waarschuwing warning , of een willekeurige check_circle .

Nadat je de knooppunten van de sjabloon hebt gedefinieerd, klik je op Publiceren .

De instellingen van een sjabloon bewerken

Om de naam of beschrijving van een sjabloon aan te passen, of om de variabelen ervan te beheren:

1. In Chain Builder , klik in het tabblad Templates dynamic_feed op de naam van de sjabloon en vervolgens op Template Settings .
2. Bewerk de naam, beschrijving of variabelen van de sjabloon naar behoefte.
3. Klik op Opslaan en Publiceren .

Bekijk ketens die een sjabloon gebruiken

Om te zien welke ketens zijn gemaakt op basis van een sjabloon, ga je naar het tabblad Sjablonen dynamische_feed en klik je vervolgens op Bekijken voor de sjabloon onder Ketens die gebruiken.

Vanuit het paneel In gebruik worden de ketens weergegeven die zijn gemaakt op basis van de sjabloon. Om een ​​ketting te openen, klik je op de naam ervan. 

Tip : Om een ​​specifieke keten te vinden, zoek op naam .

Kopieer sjablonen

Om een ​​sjabloon als uitgangspunt te gebruiken voor een nieuw sjabloon, maak je er een kopie van. In Chain Builder , klik in het tabblad Templates dynamic_feed op Copy file_copy voor de sjabloon.

Deel sjablonen met anderen.

Om anderen te helpen bij het maken van ketens, kunt u links naar gepubliceerde sjablonen delen met anderen via Chain Builder —ook met mensen van andere organisaties, zoals in de Workiva Community . 

1. In Chain Builder , klik in het tabblad Templates dynamic_feed op Get shareable link open_in_new .
   
2. Klik op Kopiëren naar klembord file_copy en Sluiten .
3. Plak de link en deel deze indien nodig met anderen.

Houd er rekening mee dat sjablonen alleen werken als beide werkruimten toegang hebben tot dezelfde connectors en commando's. Wanneer je een sjabloon deelt met een andere werkruimte, werkt de geïmporteerde keten niet tenzij alle vereiste verbindingslijnen zijn ingeschakeld.

Bij het importeren van een keten krijgt u de mogelijkheid om eventuele ontbrekende verbindingsstukken toe te voegen:

De toegang tot een gedeelde sjabloon intrekken

Om de toegang van anderen tot een gedeelde sjabloon te intrekken, vernieuw je de URL om een ​​nieuwe link te creëren:

1. In Chain Builder , klik in het tabblad Templates dynamic_feed op Get shareable link open_in_new voor de template.
2. Klik op Token opnieuw genereren Vernieuwen en Sluiten .

Archiveringssjablonen

Als je een sjabloon niet meer nodig hebt, kun je het archiveren. Klik in Chain Builder op Templates dynamic_feed en vervolgens op Archive archive voor de template.

Opmerking: Om een ​​gearchiveerd sjabloon te bekijken vanuit Sjablonen , klikt u op Gearchiveerd .