Kettingsjablonen gebruiken

Bij het maken van een sjabloon kun je een gepubliceerde keten als basis gebruiken of een nieuwe reeks commando's en gebeurtenissen vanaf nul opbouwen.

Met deze sjablonen kun je een kant-en-klare reeks commando's en gebeurtenissen maken voor gebruik in andere ketens. Met sjablonen kun je bijvoorbeeld:

• Zorg voor een voorsprong om het creëren van ketens te vergemakkelijken.
• Standaardiseer gemeenschappelijke workflows, bijvoorbeeld om gegevens uit je recordsysteem te halen.

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

Een sjabloon maken van een bestaande ketting

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

• Je kunt de eerste ketting gebruiken als startpunt om andere kettingen te maken.
• Je kunt de keten delen met anderen met behulp van Chain Builder- ook met mensen bij andere organisaties, zoals in de Workiva Community. 

Om een sjabloon te maken van een bestaande ketting:

1. Ga naar Chains, klik op Chain Builder.
2. Selecteer het tabblad Chains  device_hub en selecteer vervolgens Edit create voor de keten.
3. Selecteer Sjabloon makenin het menu met drie puntjes rechtsboven in de ketting.
   
4. Voer een unieke naam en beschrijving in om de sjabloon te identificeren.
   
5. Selecteer onder Mappenwaar u de sjabloon wilt opslaan.
6. Klik op Opslaan.
7. Als de ketting variabelen heeft, stel dan elke sjabloonvariabele in:
   
   
   • Voer de standaardnaam voor de sjabloonvariabele in.

     Tip: Om te helpen bij het identificeren van de waarde die moet worden gebruikt bij een variabele, raden we aan om een voorvoegsel op te nemen bij de naam. 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 werkruimtebron de waarde zal leveren.
     

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

8. Klik op Opslaan en Publiceren.

 

Een sjabloon vanaf nul maken

Volg deze stappen om een nieuwe reeks commando's en gebeurtenissen te bouwen als een herbruikbaar raamwerk voor ketens.

Stap 1: De sjabloon toevoegen

1. Klik in Chain Builderop het tabblad Templates dynamic_feed op Create => Template rechtsboven.
2. Als u de sjabloon op een andere plaats dan de map Default wilt maken, klikt u op Bewerk bewerk voor de map, selecteert u de map waarin u de sjabloon wilt opslaan en klikt u op Verplaats.
3. Voer een unieke naam en beschrijving in om de sjabloon en de bedoeling ervan te helpen identificeren.

   Tip: Om aan te geven of een sjabloon een sequentie voor een volledige of gedeeltelijke keten bevat, kun je een voorvoegsel aan de naam toevoegen. Bijvoorbeeld Full- voor een volledige keten, of Part- voor een gedeeltelijke keten of knipsel.

Stap 2: De variabelen van de sjabloon instellen

Om het aanpassen en hergebruiken te vergemakkelijken, bevatten sjablonen variabelen als plaatshouders voor waarden die nodig zijn voor de variabelen of werkruimtebronnen van de opdrachten. Als je een ketting maakt van het sjabloon, vervangen de variabelen en bronnen van de ketting de variabelen van het sjabloon.

Voor elke variabele die moet worden opgenomen in de sjabloon:

1. Klik onder Templatevariabelenop Toevoegen.
2. Voer de naam en standaardwaarde van de variabele in.

   Tip: Om te helpen bij het identificeren van de waarde die moet worden gebruikt met een sjabloonvariabele, raden we aan om een voorvoegsel toe te voegen aan de naam. Bijvoorbeeld WSV- voor een werkruimtevariabele, CV- voor een ketenvariabele, DCV- voor een dynamische ketenvariabele, of Resource- voor een werkruimtebron.

3. Selecteer onder Typeof een dynamische ketenvariabele of een werkruimtebron de waarde van de variabele moet leveren.
   

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

Nadat u alle variabelen voor de sjabloon hebt toegevoegd, klikt u op Opslaan.

Opmerking: Als u een variabele uit de sjabloon wilt verwijderen, klikt u op X onder Acties.

Stap 3: De knooppunten van de sjabloon definiëren

Als je een sjabloon bouwt, stel je de knooppunten in de volgorde in en koppel je ze:

• Opdrachten of taken die worden uitgevoerd door ketens die zijn gemaakt van het sjabloon, bijvoorbeeld voor interactie 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-ingangen om variabelen in te stellen, zoals op specifieke accounts, regio's of tijdsperioden, wanneer u ketens uitvoert die zijn gemaakt van de sjabloon, of om de keten automatisch te starten op basis van wijzigingen in aangesloten bronnen.

Opmerking: Om maatwerk en hergebruik mogelijk te maken, maken de opdrachten van een sjabloon geen gebruik van verbindingen, runners of variabelen die in de keten of werkruimte zijn ingesteld.

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

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

Opmerking: Standaard wordt een knooppunt uitgevoerd wanneer het gekoppelde vorige knooppunt slaagt. Om voorwaardelijke logica in te schakelen, bijvoorbeeld om een knooppunt alleen uit te voeren als het vorige knooppunt faalt, dubbelklik je op de koppeling en selecteer je de voorwaarde: succes  check_circle, mislukking  fout, waarschuwing  waarschuwing, of elke  check_circle.

Nadat u de knooppunten van de sjabloon hebt gedefinieerd, klikt u op Publiceren.

De instellingen van een sjabloon bewerken

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

1. In Chain Builder, op het tabblad Templates dynamic_feed , klikt u op de naam van de sjabloon en Template Settings.
2. Bewerk de naam, beschrijving of variabelen van de sjabloon als dat nodig is.
3. Klik op Opslaan en Publiceren.

Kettingen bekijken die een sjabloon gebruiken

Om te zien welke ketens zijn gemaakt van een sjabloon, gaat u naar het tabbladSjablonen dynamic_feed en klikt u vervolgens op Bekijk voor de sjabloon onder Ketens gebruiken.

In het paneel In Use verschijnen de ketens die vanuit de sjabloon zijn gemaakt. Om een keten te openen, klik je op de naam. 

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

Sjablonen kopiëren

Om een sjabloon te gebruiken als startpunt voor een nieuwe sjabloon, maak je er een kopie van. In Chain Builder, op het tabblad Templates dynamic_feed , klikt u op file_copy voor de sjabloon.

Sjablonen delen met anderen

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

1. Klik in Chain Builderop het tabblad Templates dynamic_feed op Get shareable link open_in_new.
   
2. Klik op Kopieer naar klembord bestand_kopiëren en Sluit.
3. Plak de link en deel hem indien nodig met anderen.

Houd er rekening mee dat sjablonen afhankelijk zijn van het feit of beide workspaces toegang hebben tot dezelfde connectors en commando's. Als je een sjabloon deelt met een andere werkruimte, werkt de geïmporteerde keten niet tenzij alle vereiste connectors zijn ingeschakeld.

Bij het importeren van een keten heb je de mogelijkheid om ontbrekende connectoren aan te maken:

Toegang tot een gedeelde sjabloon intrekken

Als u de toegang van anderen tot een gedeelde sjabloon wilt intrekken, vernieuwt u de URL om een nieuwe koppeling te maken:

1. In Chain Builder, op de Templates dynamic_feed tab, klik Get shareable link open_in_new voor de template.
2. Klik op Regenereren token Vernieuwen en Sluiten.

Sjablonen archiveren

Als je een sjabloon niet langer nodig hebt, kun je deze archiveren. Klik in Chain Builderop Templates dynamic_feeden klik op Archive archive voor de sjabloon.

Opmerking: Om een gearchiveerde sjabloon te bekijken van Sjablonen, klik op Gearchiveerd.