cisco Gebruikershandleiding voor het maken van aangepaste workflowtaken

Cisco UCS Director Orchestrator biedt een lijst met goed gedefinieerde invoertypen voor aangepaste taken. Met Cisco UCS Director kunt u ook een aangepaste werkstroominvoer maken voor een aangepaste werkstroomtaak. U kunt een nieuw invoertype maken door een bestaand invoertype te klonen en te wijzigen.

Vereisten

Voordat u aangepaste taken schrijft, moet u aan de volgende vereisten voldoen:

Cisco UCS Director is geïnstalleerd en actief op uw systeem. Voor meer informatie over het installeren van Cisco UCS Director raadpleegt u de Cisco UCS Director Installatie- en configuratiehandleiding.
U beschikt over een login met beheerdersrechten. U moet deze login gebruiken wanneer u aangepaste taken maakt en wijzigt.

U moet over de schrijfmachtiging CloupiaScript beschikken om een aangepaste taak te schrijven met CloupiaScript.
U moet beschikken over de machtiging CloupiaScript uitvoeren om een aangepaste taak uit te voeren die is gemaakt met CloupiaScript.

Een aangepaste workflow-invoer maken

U kunt een aangepaste invoer maken voor een aangepaste werkstroomtaak. De invoer wordt weergegeven in de lijst met invoertypen die u kunt toewijzen aan aangepaste taakinvoer wanneer u een aangepaste werkstroomtaak maakt.

Stap 1 Kies Orchestratie.

Stap 2 Klik op Aangepaste workflow-invoer.
Stap 3 Klik op Toevoegen.

Stap 4 Vul op het scherm Aangepaste werkstroominvoer toevoegen de volgende velden in:
- Aangepaste invoertypenaam: een unieke naam voor het aangepaste invoertype.
- Invoertype: controleer een invoertype en klik op Selecteren. Op basis van de geselecteerde invoer verschijnen andere velden. Bijvoorbeeldample, wanneer u E-mailadres als invoertype kiest, verschijnt er een lijst met waarden (LOV). Gebruik de nieuwe velden om de waarden van de aangepaste invoer te beperken.
Stap 5 Klik op Verzenden.

De aangepaste werkstroominvoer wordt toegevoegd aan Cisco UCS Director en is beschikbaar in de lijst met invoertypen.

Aangepaste invoervalidatie

Klanten moeten mogelijk de workflow-invoer valideren met behulp van externe bronnen. Out-of-the-box kan Cisco UCS Director niet aan de validatiebehoeften van elke klant voldoen. Om deze leemte op te vullen, biedt Cisco UCS Director een optie om elke invoer tijdens runtime te valideren met behulp van een door de klant aangeleverd script. Het script kan fouten in de invoer markeren en kan geldige invoer vereisen voordat een serviceaanvraag wordt uitgevoerd. Het script kan in elke taal worden geschreven, heeft toegang tot elke externe bron en heeft toegang tot alle invoerwaarden van de workflow.
U kunt aangepaste validatiescripts schrijven met JavaScript, Python, een bash-shellscript of een andere scripttaal.

De volgende exampbestandsvalidatiescripts zijn te vinden in Cisco UCS Director in Orchestration > Custom Workflow Inputs:

Example-bash-script-validator

Example-javascript-validator
Example-python-validator

Je kunt het example scripted workflow-invoer om een nieuwe gevalideerde invoer te creëren. Je kunt ook gebruik maken van de example scripted workflow-invoer als leidraad voor het ontwikkelen van uw eigen scripts.

Ongeacht de scripttaal zijn de volgende functies en regels van toepassing op aangepaste invoervalidatie met scripts:

Alle scriptvalidatie wordt in een apart proces uitgevoerd, zodat een falend validatieproces geen invloed heeft op het Cisco UCS Director-proces.
Alleen generieke tekstinvoer kan worden gevalideerd met behulp van scripts.

Validatiescripts worden één voor één uitgevoerd, op volgorde, in dezelfde volgorde waarin de invoer verschijnt op de pagina met werkstroominvoer. Voor elke gevalideerde invoer wordt een afzonderlijk proces gestart.
Een retourwaarde die niet nul is uit het script, duidt op een mislukte validatie. Optioneel kunt u een foutmelding terugsturen naar het workflow-invoerformulier.

Alle workflowinvoer wordt op twee manieren doorgegeven aan het validatiescript:
- Als argumenten voor het script in de vorm “key”=”value”.
- Als omgevingsvariabelen voor het scriptproces. De namen van de variabelen zijn de invoerlabels.
  Bijvoorbeeldample, als de workflow een invoer heeft met het label Product-Code en de invoerwaarde AbC123 is, wordt de variabele doorgegeven aan het validatorscript als "Product-Code"="AbC123".
  Deze invoervariabelen kunnen indien nodig door het script worden gebruikt om de validatie te implementeren. Uitzondering: tabelwaarden bevatten alleen het rijnummer van de tabelselectie en zijn daarom waarschijnlijk nutteloos.
De pagina Aangepaste werkstroominvoer bewerken maakt het script beschikbaar in de aangepaste taakeditor. Syntaxis is gemarkeerd voor alle talen. Syntaxisfouten worden alleen gecontroleerd voor JavaScript-validators.

Een aangepaste workflowinvoer klonen

U kunt een bestaande aangepaste werkstroominvoer in Cisco UCS Director gebruiken om een aangepaste werkstroominvoer te maken.

Voordat je begint
Er moet een aangepaste werkstroominvoer beschikbaar zijn in Cisco UCS Director.

Stap 1 Kies Orchestratie.
Stap 2 Klik op Aangepaste workflow-invoer.
Stap 3 Klik op de rij met de aangepaste werkstroominvoer die u wilt klonen.
Het kloonpictogram verschijnt bovenaan de tabel met aangepaste workflowinvoer.
Stap 4 Klik op Klonen.
Stap 5 Voer de naam van het aangepaste invoertype in.
Stap 6 Gebruik de andere bedieningselementen in het scherm Aangepaste workflowinvoer klonen om de nieuwe invoer aan te passen.
Stap 7 Klik op Verzenden.
De aangepaste werkstroomtaakinvoer wordt na bevestiging gekloond en is beschikbaar voor gebruik in de aangepaste werkstroomtaak.

Een aangepaste taak maken

Ga als volgt te werk om een aangepaste taak te maken:

Stap 1 Kies Orchestratie.
Stap 2 Klik op Aangepaste workflowtaken.
Stap 3 Klik op Toevoegen.
Stap 4 Vul op het scherm Aangepaste workflowtaak toevoegen de volgende velden in:
- Veld Taaknaam: een unieke naam voor de aangepaste werkstroomtaak.
- Veld Taaklabel: een label om de aangepaste werkstroomtaak te identificeren.
- Veld Registreren onder categorie: de werkstroomcategorie waaronder de aangepaste werkstroomtaak moet worden geregistreerd.
- Selectievakje Taak activeren: indien ingeschakeld, wordt de aangepaste werkstroomtaak geregistreerd bij Orchestrator en is deze onmiddellijk bruikbaar in werkstromen.
- Veld Korte beschrijving: een beschrijving van de aangepaste werkstroomtaak.
- Veld Gedetailleerde beschrijving: een gedetailleerde beschrijving van de aangepaste werkstroomtaak.

Stap 5 Klik op Volgende.
Het scherm Aangepaste taakinvoer verschijnt.
Stap 6 Klik op Toevoegen.
Stap 7 Vul op het scherm Invoer toevoegen aan invoer de volgende velden in:
- Veld voor invoerveldnaam: een unieke naam voor het veld. De naam moet beginnen met een analfabetisch teken en mag geen spaties of speciale tekens bevatten.
- Invoerveld Labelveld: een label om het invoerveld te identificeren.
- Vervolgkeuzelijst Type invoerveld: Kies het gegevenstype van de invoerparameter.
- Toewijzen aan veld Invoertype (geen toewijzing): Kies een type invoer waaraan dit veld kan worden toegewezen, als dit veld kan worden toegewezen vanuit een andere taakuitvoer of globale werkstroominvoer.
- Verplicht selectievakje: indien aangevinkt, moet de gebruiker een waarde voor dit veld opgeven.
- RBID-veld: Voer de RBID-tekenreeks voor het veld in.
- Vervolgkeuzelijst Invoerveldgrootte: Kies de veldgrootte voor tekst- en tabelinvoer.
- Invoerveld Helpveld: (optioneel) Een beschrijving die wordt weergegeven als u met de muis over het veld beweegt.
- Invoerveld Annotatieveld: (Optioneel) Tiptekst voor het invoerveld.
- veld Veldgroepnaam: indien opgegeven worden alle velden met overeenkomende groepsnamen in de veldgroep geplaatst.
- Gebied TEKSTVELD ATTRIBUTEN: Vul de volgende velden in als het invoerveldtype tekst is.
- Selectievakje Meerdere invoer: Indien ingeschakeld, accepteert het invoerveld meerdere waarden op basis van het type invoerveld:
- Voor een LOV: het invoerveld accepteert meerdere invoerwaarden.
- Voor een tekstveld: het invoerveld wordt een tekstveld met meerdere regels.
- Maximale lengte van invoerveld: geef het maximale aantal tekens op dat u in het invoerveld kunt invoeren.
- Gebied LOV ATTRIBUTEN: Vul de volgende velden in als het invoertype Lijst met waarden (LOV) of LOV met keuzerondjes is.
- Veld Lijst met waarden: een door komma's gescheiden lijst met waarden voor ingesloten zoeklijsten.
  Veld Naam van LOV-provider: de naam van de LOV-provider voor niet-ingebedde LOV's.
- Gebied TABEL ATTRIBUTEN: Vul de volgende velden in als het invoerveldtype Tabel, Pop-uptabel of Tabel met selectievakje is.
- Veld Tabelnaam: een naam van het tabelrapport voor de tabelveldtypen.
- Gebied VELDINVOERVALIDATIE: Afhankelijk van het door u geselecteerde gegevenstype worden een of meer van de volgende velden weergegeven. Vul de velden in om aan te geven hoe de invoervelden worden gevalideerd.
- Vervolgkeuzelijst Invoervalidator: Kies een validator voor de gebruikersinvoer.
- Reguliere-expressieveld: een reguliere-expressiepatroon waarmee de invoerwaarde kan worden vergeleken.
- Veld Bericht reguliere expressie: Een bericht dat wordt weergegeven wanneer de validatie van de reguliere expressie mislukt.
- Veld Minimumwaarde: een minimale numerieke waarde.
- Veld Maximale waarde: een maximale numerieke waarde.
- Gebied VERBERGEN OP VELDCONDITIE: Vul de volgende velden in om de voorwaarde in te stellen om het veld in een formulier te verbergen.
- Verbergen bij veldnaam veld: een interne naam voor het veld, zodat het programma dat het formulier verwerkt het veld kan identificeren.
- Verbergen bij veld Waardeveld: de waarde die moet worden verzonden zodra het formulier is verzonden.
- Vervolgkeuzelijst Verbergen op veldvoorwaarde: Kies een voorwaarde waarbij het veld moet worden verborgen.
- HTML Help-veld: de help-instructies voor het verborgen veld.

Stap 8 Klik op Verzenden.
De invoerinvoer wordt aan de tabel toegevoegd.
Stap 9 Klik op Toevoegen om meer invoer aan ingangen toe te voegen.
Stap 10 Wanneer u klaar bent met het toevoegen van invoer, klikt u op Volgende.
Het scherm Uitvoer aangepaste workflowtaken verschijnt.

Stap 11 Klik op Toevoegen.
Stap 12 Vul op het scherm Item toevoegen aan uitgangen de volgende velden in:
- Veld Naam uitvoerveld —Een unieke naam voor het uitvoerveld. Het moet beginnen met een alfabetisch teken en mag geen spaties of speciale tekens bevatten.
- Uitvoerveld Beschrijvingsveld —Een beschrijving van het uitvoerveld.
- Veld Type uitvoerveld: controleer een type uitvoer. Dit type bepaalt hoe de uitvoer kan worden toegewezen aan andere taakinvoer.
Stap 13 Klik op Verzenden.
De uitvoerinvoer wordt aan de tabel toegevoegd.

Stap 14 Klik op Toevoegen om meer invoer aan uitvoer toe te voegen.
Stap 15 Klik op Volgende
Het Controller-scherm verschijnt
Stap 16 (Optioneel) Klik op Toevoegen om een controller toe te voegen.

Stap 17 Vul op het scherm Ingang toevoegen aan controller de volgende velden in:
- Vervolgkeuzelijst Methode: Kies een marshalling- of unmarshalling-methode om de invoer en/of uitvoer voor de aangepaste werkstroomtaak aan te passen. De methode kan een van de volgende zijn:
- Vóór Marshall: gebruik deze methode om een invoerveld toe te voegen of in te stellen en de LOV op een pagina (formulier) dynamisch te maken en in te stellen.
- Na Marshall: gebruik deze methode om een invoerveld te verbergen of zichtbaar te maken.
- Vóór Unmarshall: gebruik deze methode om een invoerwaarde van het ene formulier naar het andere formulier te converteren, bijvoorbeeldample, wanneer u een wachtwoord wilt coderen voordat u het naar de database verzendt.
- Na Unmarshall: gebruik deze methode om een gebruikersinvoer te valideren en de foutmelding op de pagina in te stellen.
  Zie bijvampon: Controllers gebruiken, op pagina 14.
- Scripttekstgebied: Voeg voor de methode die u heeft gekozen in de vervolgkeuzelijst Methode de code voor het GUI-aanpassingsscript toe.
  Opmerking Klik op Toevoegen als u code voor meer methoden wilt toevoegen.
  Als er validaties zijn voor de ingevoerde wachtwoorden, zorg er dan voor dat u de controllervalidatie voor de wachtwoorden wijzigt, zodat u de aangepaste taken in workflows kunt bewerken.
  Opmerking
Stap 18 Klik op Verzenden.
De controller wordt aan de tabel toegevoegd.
Stap 19 Klik op Volgende.
Het Scriptscherm verschijnt.

Stap 20 Kies een taal uit de vervolgkeuzelijst Uitvoeringstaal.
Stap 21 Voer in het veld Script de CloupiaScript-code in voor de aangepaste workflowtaak.
De Cloupia-scriptcode wordt gevalideerd wanneer u de code invoert. Als er een fout in de code zit, wordt naast het regelnummer een foutpictogram (rood kruis) weergegeven. Beweeg de muis over het foutpictogram om view de foutmelding en de oplossing
Stap 22 Klik op Script opslaan.

Stap 23 Klik op Verzenden.
De aangepaste werkstroomtaak wordt gemaakt en is beschikbaar voor gebruik in de werkstroom

Aangepaste taken en opslagplaatsen

Wanneer u een aangepaste taak maakt, in plaats van de aangepaste taakcode in het scriptvenster te typen of code uit een teksteditor te knippen en plakken, kunt u de code importeren uit een file opgeslagen in een GitHub- of BitBucket-repository. Om dit te doen, moet u:

Maak een of meer tekst files in een GitHub- of BitBucket-repository, hetzij op github.com, hetzij in een GitHub-repository van een particuliere onderneming.
Opmerking Cisco UCS Director ondersteunt alleen GitHub (github.com of een GitHub-instantie van ondernemingen) en/of BitBucket. Het ondersteunt geen andere Git-hostingservices, waaronder GitLab, Perforce of Codebase.

Registreer de opslagplaats in Cisco UCS Director. Zie Een GitHub- of BitBucket-opslagplaats toevoegen in Cisco UCS Director, op pagina 7.
Selecteer de repository en specificeer de tekst file dat het aangepaste taakscript bevat. Zie Aangepaste taakscriptcode downloaden uit een GitHub- of BitBucket-opslagplaats, op pagina 8.

Een GitHub- of BitBucket-repository toevoegen in Cisco UCS Director
Ga als volgt te werk om een GitHub- of BitBucket-repository in Cisco UCS Director te registreren:

Voordat je begint
Maak een GitHub- of BitBucket-repository. De repository kan zich op elke GitHub- of BitBucket-server bevinden, openbaar of privé, die toegankelijk is vanuit uw Cisco UCS Director.
Check één of meerdere in files met JavaScript-code voor uw aangepaste taken in uw repository.

Stap 1 Kies Beheer > Integratie.
Stap 2 Klik op de pagina Integratie op Opslagplaatsen beheren.

Stap 3 Klik op Toevoegen.
Stap 4 Vul op de pagina Opslagplaats toevoegen de verplichte velden in, waaronder de volgende:
- Voer in het veld Bijnaam opslagplaats een naam in om de opslagplaats binnen Cisco UCS Director te identificeren.
- In de opslagplaats URL veld, voer het in URL van de GitHub- of BitBucket-repository.
- Voer in het veld Taknaam de naam in van de repositorytak die u wilt gebruiken. De standaardnaam is hoofdtak.
- Voer in het veld Repository-gebruiker de gebruikersnaam in voor uw GitHub- of BitBucket-account.
- Om de GitHub-repository toe te voegen, voert u in het veld Wachtwoord/API-token het gegenereerde API-token voor uw GitHub in.
  Als u het API-token wilt genereren met GitHub, klikt u op Instellingen en navigeert u naar Ontwikkelaarsinstelling > Persoonlijke toegangstokens en klikt u op Nieuw token genereren.
  Om de BitBucket-repository toe te voegen, voert u in het veld Wachtwoord/API-token het wachtwoord voor uw BitBucket in.
- Als u deze opslagplaats standaard wilt gebruiken wanneer u een nieuwe aangepaste taak maakt, vinkt u Maak dit mijn standaardopslagplaats aan.
- Om te testen of Cisco UCS Director toegang heeft tot de repository, klikt u op Connectiviteit testen.
  De status van de connectiviteit met de repository wordt weergegeven in een banner bovenaan de pagina.
  Als u geen verbinding kunt maken en kunt communiceren met de GitHub- of BitBucket-repository van Cisco UCS
  Director, update Cisco UCS Director voor toegang tot internet via een proxyserver. Zie de Cisco UCS Director Beheerhandleiding.
  Opmerking

Stap 5 Als u er zeker van bent dat de gegevens uit de repository correct zijn, klikt u op Indienen.

Aangepaste taakscriptcode downloaden vanuit een GitHub- of BitBucket-repository

Ga als volgt te werk om een nieuwe aangepaste taak te maken door tekst uit een GitHub- of BitBucket-repository te importeren:

Voordat je begint
Maak een GitHub- of BitBucket-repository en check een of meer tekst in files met de JavaScript-code voor uw aangepaste taken in uw repository.

Voeg de GitHub-opslagplaats toe aan Cisco UCS Director. Zie Een GitHub- of BitBucket-opslagplaats toevoegen in Cisco UCS Director, op pagina

Stap 1 Klik op de pagina Indeling op Aangepaste workflowtaken.

Stap 2 Klik op Toevoegen.
Stap 3 Vul de verplichte velden in op de pagina Aangepaste taakinformatie. Zie Een aangepaste taak maken, op pagina 3.
Stap 4 Vul de verplichte velden in op de pagina Aangepaste taakinvoer. Zie Een aangepaste taak maken, op pagina 3.

Stap 5 Vul de verplichte velden in op de pagina Aangepaste taakuitvoer. Zie Een aangepaste taak maken, op pagina 3.
Stap 6 Vul de verplichte velden in op de Controller-pagina. Zie Een aangepaste taak maken, op pagina 3.
Stap 7 Vul op de pagina Script de vereiste velden in:
- Selecteer JavaScript in de vervolgkeuzelijst Uitvoeringstaal.
- Vink Gebruik opslagplaats voor scripts aan om de aangepaste taak in te schakelen om een script te gebruiken file uit een opslagplaats. Hierdoor kunt u de repository selecteren en het script opgeven file gebruiken.
- Selecteer in de vervolgkeuzelijst Repository selecteren de GitHub- of BitBucket-repository die het script bevat fileS. Voor meer informatie over het toevoegen van opslagplaatsen raadpleegt u Een GitHub- of BitBucket-opslagplaats toevoegen in Cisco UCS Director, op pagina 7.
- Voer het volledige pad naar het script in file in het Script filenaam tekstveld.
- Om het script te downloaden, klikt u op Script laden.
  De tekst uit de file wordt gekopieerd in het bewerkingsgebied Scripttekst.
- Breng eventueel wijzigingen aan in het gedownloade script in het bewerkingsgebied Scripttekst.
- Als u het script wilt opslaan zoals het wordt weergegeven in het bewerkingsgebied Scripttekst, klikt u op Script opslaan.
  Wanneer u op Script opslaan drukt, wordt het script opgeslagen in uw huidige werksessie. U moet op Verzenden klikken om het script op te slaan in de aangepaste taak die u bewerkt.
  Opmerking
Stap 8 Om de aangepaste taak op te slaan, klikt u op Verzenden.
Als u wijzigingen hebt aangebracht in het gedownloade script in het bewerkingsgebied Scripttekst, worden de wijzigingen opgeslagen in de aangepaste taak. Er worden geen wijzigingen opgeslagen in de GitHub- of BitBucket-repository. Als u het geladen script wilt verwijderen en uw eigen script wilt invoeren, klikt u op Script negeren om het scriptvenster leeg te maken.

Wat nu te doen?
U kunt de nieuwe aangepaste taak in een workflow gebruiken.

Workflows, aangepaste taken, scriptmodules en activiteiten importeren

Ga als volgt te werk om artefacten in Cisco UCS Director te importeren:

Opmerking Globale variabelen die aan een workflow zijn gekoppeld, worden geïmporteerd tijdens het importeren van een workflow als de globale variabele niet beschikbaar is in het apparaat.

Stap 1 Kies Orchestratie.

Stap 2 Klik op de pagina Orchestration op Workflows.
Stap 3 Klik op Importeren.
Stap 4 Klik in het scherm Importeren op Selecteer a File.

Stap 5 Op de keuze File naar het uploadscherm, kies de file geïmporteerd worden. Cisco UCS Director import en export files hebben een .wfdx file verlenging.
Stap 6 Klik op Openen.
Wanneer de file wordt geüpload, de File Het upload-/validatiescherm wordt weergegeven File klaar voor gebruik en sleutel.
Stap 7 Voer de sleutel in die is ingevoerd bij het exporteren van het bestand file.

Stap 8 Klik op Volgende.
Op het scherm Importbeleid wordt een lijst weergegeven met Cisco UCS Director-objecten in de geüploade bestanden file.
Stap 9 (Optioneel) Geef op het scherm Importbeleid op hoe objecten moeten worden afgehandeld als ze namen dupliceren die al in de werkstroommap staan. Vul op het scherm Importeren de volgende velden in

Naam	Beschrijving
Werkstromen	Kies uit de volgende opties om op te geven hoe werkstromen met dezelfde naam worden afgehandeld: Vervangen—Vervang de bestaande workflow door de geïmporteerde workflow. Bewaar beide—Importeer de workflow als een nieuwe versie. Overslaan—Importeer de workflow niet.
Aangepaste taken	Kies uit de volgende opties om op te geven hoe aangepaste taken met dezelfde naam worden afgehandeld: Vervangen Bewaar beide Overslaan

Naam	Beschrijving
Scriptmodules	Kies uit de volgende opties om op te geven hoe scriptmodules met identieke namen worden verwerkt: Vervangen Bewaar beide Overslaan
Activiteiten	Kies uit de volgende opties om op te geven hoe activiteiten met een identieke naam worden afgehandeld: Vervangen Bewaar beide Overslaan
Importeer workflows naar map	Check Werkstromen importeren naar map om de werkstromen te importeren. Als u Import Workflows to Folder niet aanvinkt en als er geen bestaande versie van een workflow isw bestaat, wordt die workflow niet geïmporteerd.
Selecteer map	Kies een map waarin u de workflows wilt importeren. Als je kiest [Nieuw Map..] in de vervolgkeuzelijst wordt de Nieuwe map veld verschijnt.
Nieuwe map	Voer de naam in van de nieuwe map die u wilt maken als uw importmap.

Stap 10 Klik op Importeren.

Workflows, aangepaste taken, scriptmodules en activiteiten exporteren

Ga als volgt te werk om artefacten uit Cisco UCS Director te exporteren:

Opmerking Globale variabelen die aan een werkstroom zijn gekoppeld, worden automatisch geëxporteerd tijdens het exporteren van een werkstroom.

Stap 1 Klik op Exporteren.
Stap 2 Kies op het scherm Werkstromen selecteren de werkstromen die u wilt exporteren.
Aangepaste workflows, taken en scripts die vóór versie 6.6 in Cisco UCS Director zijn gemaakt, kunnen mogelijk niet worden geïmporteerd als ze XML-gegevens bevatten.
Opmerking
Stap 3 Klik op Volgende.
Stap 4 Kies op het scherm Aangepaste taken selecteren de aangepaste taken die u wilt weergeven
Opmerking De geëxporteerde aangepaste taak bevat alle aangepaste invoer die door die aangepaste taak wordt gebruikt.
Stap 5 Klik op Volgende.
Stap 6 Kies op het scherm Exporteren: Scriptmodules selecteren de scriptmodules die u wilt exporteren.
Stap 7 Klik op Volgende.
Stap 8 Kies op het scherm Exporteren: Activiteiten selecteren de activiteiten die u wilt exporteren.
Stap 9 Klik op Volgende.
Stap 10 Kies in het scherm Exporteren: Selecteer API's openen de API's die u wilt exporteren.
Stap 11 Vul op het scherm Exporteren: Bevestiging de volgende velden in:

Naam	Beschrijving
Geëxporteerd door	Uw naam of een notitie wie verantwoordelijk is voor de export.
Reacties	Opmerkingen over deze export.
Versleutel het geëxporteerde bestand file	Vink het selectievakje Het geëxporteerde coderen aan file selectievakje in om de file geëxporteerd worden. Standaard is het selectievakje aangevinkt.
Sleutel	Voer de sleutel in voor het coderen van het file. Dit veld wordt alleen weergegeven wanneer de optie Het geëxporteerde coderen file selectievakje is aangevinkt. Bewaar de sleutel zoals nodig tijdens het importeren van de workflow voor decodering.
Bevestigingstoets	Voer de sleutel nogmaals in ter bevestiging. Dit veld wordt alleen weergegeven wanneer de optie Het geëxporteerde coderen file selectievakje is aangevinkt.
Geëxporteerd File Naam	De naam van de file op uw lokale systeem. Typ alleen de basis filenaam; de file type-extensie (.wfdx) wordt automatisch toegevoegd.

Stap 12 Klik op Exporteren.
U wordt gevraagd om het bestand op te slaan file.

Een aangepaste workflowtaak klonen vanuit de takenbibliotheek

U kunt taken in de takenbibliotheek klonen om deze te gebruiken bij het maken van aangepaste taken. U kunt ook een aangepaste taak klonen om een aangepaste taak te maken.

De gekloonde taak is een raamwerk met dezelfde taakinvoer en -uitvoer als de oorspronkelijke taak. De gekloonde taak is echter slechts een raamwerk. Dit betekent dat u alle functionaliteit voor de nieuwe taak in CloupiaScript moet schrijven.

Houd er ook rekening mee dat selectiewaarden voor lijstinvoer, zoals vervolgkeuzelijsten en zoeklijsten, alleen naar de gekloonde taak worden overgedragen als de lijstwaarden niet systeemafhankelijk zijn. Zaken als namen en IP-adressen van bestaande systemen zijn systeemafhankelijk; zaken als configuratieopties die door Cisco UCS Director worden ondersteund, zijn dat niet. Bijvoorbeeldampbestands-, gebruikersgroepen, cloudnamen en poortgroepen zijn systeemafhankelijk; gebruikersrollen, cloudtypen en poortgroeptypen zijn dat niet.

Stap 1 Kies Orchestratie.
Stap 2 Klik op Aangepaste workflowtaken.
Stap 3 Klik op Klonen uit taakbibliotheek.
Stap 4 Vink op het scherm Klonen uit taakbibliotheek de rij aan met de taak die u wilt klonen.
Stap 5 Klik op Selecteren.
Er wordt een aangepaste werkstroomtaak gemaakt op basis van de takenbibliotheek. De nieuwe aangepaste taak is de laatste aangepaste taak in het rapport Aangepaste werkstroomtaken. De nieuwe aangepaste taak krijgt de naam van de gekloonde taak, met de datum eraan toegevoegd.
Stap 6 Klik op Verzenden

Wat nu te doen?
Bewerk de aangepaste werkstroomtaak om ervoor te zorgen dat de juiste naam en beschrijving aanwezig zijn voor de gekloonde taak.

Een aangepaste workflowtaak klonen

U kunt een bestaande aangepaste werkstroomtaak in Cisco UCS Director gebruiken om een aangepaste werkstroomtaak te maken.

Voordat je begint
Er moet een aangepaste werkstroomtaak beschikbaar zijn in Cisco UCS Director.

Stap 1 Kies Orchestratie.
Stap 2 Klik op Aangepaste workflowtaken.
Stap 3 Klik op de rij met de aangepaste werkstroomtaak die u wilt klonen.
Het kloonpictogram verschijnt bovenaan de tabel met aangepaste werkstroomtaken.
Stap 4 Klik op Klonen.
Stap 5 Werk op het scherm Aangepaste workflowtaak klonen de vereiste velden bij.
Stap 6 Klik op Volgende.
De invoer die is gedefinieerd voor de aangepaste werkstroomtaken verschijnt.
Stap 7 Klik op de rij met de taakinvoer die u wilt bewerken en klik op Bewerken om de taakinvoer te bewerken.
Stap 8 Klik op Toevoegen om een taakinvoeritem toe te voegen.
Stap 9 Klik op Volgende.
Bewerk de taakuitvoer.
Stap 10 Klik op Toevoegen om een nieuw uitvoeritem toe te voegen.
Stap 11 Klik op Volgende.
Stap 12 Bewerk de controllerscripts. Zie Aangepaste workflowtaakinvoer beheren, op pagina 13.
Stap 13 Klik op Volgende.
Stap 14 Om de aangepaste taak aan te passen, bewerkt u het taakscript.
Stap 15 Klik op Verzenden

Aangepaste workflowtaakinvoer beheren

Het gebruik van controllers
U kunt het uiterlijk en het gedrag van aangepaste taakinvoer wijzigen met behulp van de controllerinterface die beschikbaar is in Cisco UCS Director.

Wanneer moet u controllers gebruiken?
Gebruik controllers in de volgende scenario's:

Om complex GUI-gedrag voor tonen en verbergen te implementeren, inclusief een fijnere controle van zoeklijsten, tabellarische zoeklijsten en andere invoerbesturingselementen die aan de gebruiker worden weergegeven.
Om complexe validatielogica voor gebruikersinvoer te implementeren.

Met invoercontrollers kunt u het volgende doen:

GUI-besturingselementen weergeven of verbergen: u kunt op dynamische wijze verschillende GUI-velden weergeven of verbergen, zoals selectievakjes, tekstvakken, vervolgkeuzelijsten en knoppen, op basis van voorwaarden. BijvoorbeeldampAls een gebruiker UCSM selecteert in een vervolgkeuzelijst, kunt u om gebruikersreferenties voor Cisco UCS Manager vragen of de lijst met waarden (LOV's) in de vervolgkeuzelijst wijzigen zodat alleen beschikbare poorten op een server worden weergegeven.
Validatie van formuliervelden: u kunt de gegevens valideren die door een gebruiker zijn ingevoerd bij het maken of bewerken van workflows in de Workflow Designer. Bij ongeldige gegevens die door de gebruiker zijn ingevoerd, kunnen fouten worden weergegeven. De gebruikersinvoergegevens kunnen worden gewijzigd voordat deze in de database worden bewaard of voordat deze op een apparaat worden bewaard.
Dynamisch een lijst met waarden ophalen: u kunt dynamisch een lijst met waarden ophalen uit Cisco UCS Director-objecten en deze gebruiken om GUI-formulierobjecten in te vullen.

GUI-formulierobjecten verzamelen en verwijderen
Controllers zijn altijd gekoppeld aan een formulier in de taakinvoerinterface van de Workflow Designer. Er is een één-op-één mapping tussen een formulier en een controller. Controllers werken in twee secondentages, marshalling en unmarshalling. Beide stages hebben twee substages, voor en na. Om een controller te gebruiken, moet u de gerelateerde GUI-formulierobjecten rangschikken (beheersen van UI-formuliervelden) en/of demarshallen (valideren van gebruikersinvoer) met behulp van de scripts van de controller.

De volgende tabel vat deze s samentagen.

Stage	Sub-stage
Opstellen — Wordt gebruikt om formuliervelden te verbergen en zichtbaar te maken en voor geavanceerde controle over LOV's en tabellarische LOV's.	vóór Marshall — Wordt gebruikt om een invoerveld toe te voegen of in te stellen en de LOV op een pagina (formulier) dynamisch te maken en in te stellen. na Marshall — Wordt gebruikt om een invoerveld te verbergen of zichtbaar te maken.

Stage	Sub-stage
Niet-marshallen – Gebruikt voor validatie van formuliergebruikersinvoer.	vóór Unmarshall — Wordt bijvoorbeeld gebruikt om een invoerwaarde van het ene formulier naar het andere formulier te converterenample, om het wachtwoord te coderen voordat het naar de database wordt verzonden. na Unmarshall — Wordt gebruikt om een gebruikersinvoer te valideren en de foutmelding op de pagina in te stellen.

Controllerscripts bouwen
Voor controllers hoeven geen extra pakketten te worden geïmporteerd.
U geeft geen parameters door aan de controllermethoden. In plaats daarvan stelt het Cisco UCS Director-framework de volgende parameters beschikbaar voor gebruik bij het rangschikken en het opheffen van de rangschikking:

Parameter	Beschrijving	Example
Pagina	De pagina of het formulier dat alle taakinvoer bevat. U kunt deze parameter gebruiken om het volgende te doen: Haal of stel de invoerwaarden in een GUI-formulier op. Toon of verberg de invoer in een GUI-formulier.	page.setHidden(id + “.portList”, waar); page.setValue(id + “.status”, “Er is geen poort actief. Poortlijst is verborgen”);
id	De unieke identificatie van het formulierinvoerveld. Een ID wordt gegenereerd door het raamwerk en kan worden gebruikt met de formulierinvoerveldnaam.	page.setValue(id + “.status”, “Er is geen poort actief. Poortlijst is verborgen”);// hier is 'status' de naam van het invoerveld.
Pojo	POJO (gewoon oud Java-object) is een Java-boon die een invoerformulier vertegenwoordigt. Elke GUI-pagina moet een overeenkomstige POJO hebben met de waarden uit het formulier. De POJO wordt gebruikt om de waarden in de database op te slaan of om de waarden naar een extern apparaat te sturen.	pojo.setLunSize(asciiValue); //stel de waarde van het invoerveld 'lunSize' in

Zie bijvampon: Controllers gebruiken, op pagina 14 voor een werkende code sampbestand dat de functionaliteit van de controller demonstreert.

Example: Controllers gebruiken

De volgende code example laat zien hoe u de controllerfunctionaliteit kunt implementeren in aangepaste workflowtaken met behulp van de verschillende methoden: vóór Marshall, na Marshall, vóór Unmarshall en na Unmarshall.
/*

Methodebeschrijvingen:
Vóór Marshall: Gebruik deze methode om een invoerveld toe te voegen of in te stellen en dynamisch de LOV op een pagina (formulier) te maken en in te stellen.
Na Marshall: Gebruik deze methode om een invoerveld te verbergen of zichtbaar te maken.
Vóór UnMarshall: Gebruik deze methode om een invoerwaarde van het ene formulier naar het andere formulier te converteren,
bijvoorbeeldample, wanneer u het wachtwoord wilt coderen voordat u het naar de database verzendt. Na UnMarshall: Gebruik deze methode om een gebruikersinvoer te valideren en de foutmelding in te stellen op de
pagina.
*/
// Vóór Marshall:
/*
Gebruik de beforeMarshall-methode wanneer er een wijziging is in het invoerveld of om dynamisch zoeklijsten te maken en het nieuwe invoerveld op het formulier in te stellen voordat het wordt geladen.
In de exampHieronder wordt een nieuw invoerveld 'portList' toegevoegd op de pagina voordat het formulier in een browser wordt weergegeven.
*/
importPackage(com.cloupia.model.cIM);
importPackage(java.util);
importPackage(java.lang);
var portList = nieuwe ArrayList();
var lovLabel = “eth0”;
var lovWaarde = “eth0”;
var portListLOV = nieuwe Array();
portListLOV[0] = new FormLOVPair(lovLabel, lovValue);//maak het lov-invoerveld
//de parameter 'page' wordt gebruikt om het invoerveld op het formulier in te stellen
page.setEmbeddedLOVs(id + “.portList”, portListLOV);// stel het invoerveld in op het formulier ========================== ================================================= ================================
//Na Marshall:
/*
Gebruik deze methode om een invoerveld te verbergen of zichtbaar te maken.
*/
page.setHidden(id + “.portList”, waar); //verberg het invoerveld 'portList'.
page.setValue(id + “.status”, “Er is geen poort actief. Poortlijst is verborgen”);
page.setEditable(id + “.status”, false);
================================================= ================================================= =========
// Vóór Unmarshall:
/*
Gebruik de beforeUnMarshall-methode om de gebruikersinvoer te lezen en deze naar een ander formulier te converteren voordat u deze in de database invoegt. Bijvoorbeeldample kunt u het wachtwoord lezen en opslaan in de database nadat het is omgezet in base64-codering, of u kunt de naam van de werknemer lezen en converteren naar de werknemers-ID wanneer de naam van de werknemer naar de database wordt verzonden.
In de code exampbestand onder de lun-grootte wordt gelezen en omgezet in een ASCII-waarde.
*/
importPackage(org.apache.log4j);
importPackage(java.lang);
importPackage(java.util);
var size = page.getValue(id + “.lunSize”);
var logger = Logger.getLogger(“mijn logger”);
if(grootte != nul){
logger.info(“Groottewaarde “+grootte);
if((nieuwe java.lang.String(grootte)).matches(“\\d+”)){ var byteValue = size.getBytes(“US-ASCII”); // converteer de lun-grootte en haal de ASCII-tekenarray op

var asciiValueBuilder = nieuwe StringBuilder();
for (var i = 0; i < byteValue.length; i++) {
asciiValueBuilder.append(byteValue[i]);
}
var asciiValue = asciiValueBuilder.toString()+” – Ascii
waarde"
//id + “.lunSize” is de identificatie van het invoerveld
page.setValue(id + “.lunSize”,asciiValue); //de parameter
'page' wordt gebruikt om de waarde in het invoerveld in te stellen.
pojo.setLunSize(asciiValue); // stel de waarde in voor de pojo.
Deze pojo wordt naar de DB of een extern apparaat verzonden
}
================================================= ================================================= =========
// Na unMarshall:
/*
Gebruik deze methode om een foutmelding te valideren en in te stellen.
*/
importPackage(org.apache.log4j);
importPackage(java.lang);
importPackage(java.util);
//var size = pojo.getLunSize();
var size = page.get Value(id + “.lunSize”);
var logger = Logger .get Logger(“mijn logger”);
logger.info(“Groottewaarde “+grootte);
if (grootte> 50) {//valideer de grootte
pagina. set Error(id+”.lunSize”, “LUN-grootte mag niet groter zijn dan 50MB “); //set
de foutmelding op de pagina
page .set Paginabericht(“LUN-grootte mag niet groter zijn dan 50 MB”);
//pagina. stel Paginastatus in (2);
}

Uitvoer van een eerdere taak gebruiken in een workflow

U kunt de uitvoer van een eerdere taak gebruiken als invoer voor een andere taak in een workflow, rechtstreeks vanuit het script van een aangepaste taak en een Execute Cloupia Script-taak van de takenbibliotheek.
Om toegang te krijgen tot deze uitvoer kunt u een van de volgende manieren gebruiken:

Haal de variabele op uit de werkstroomcontext met behulp van de get Input() -methode.
Raadpleeg de uitvoer met behulp van de systeemvariabelenotatie.

Om een uitvoer op te halen met behulp van de context getInput() methode, gebruik je:
var naam = ctxt.getInput(“PreviousTaskName.outputFieldName”);

Bijvoorbeeldampon:
var naam = ctxt.getInput(“custom_task1_1684.NAME”); // NAME is de naam van de taak1-uitvoer
veld waartoe u toegang wilt hebben
Om een uitvoer op te halen met behulp van de notatie van systeemvariabelen, gebruikt u:
var name = “${Naam van vorige taak. uitvoer Veldnaam}”;

Bijvoorbeeldampon:
var naam = “${custom_task1_1684.NAME}”; // NAAM is de naam van het taak1-uitvoerveld waartoe u toegang wilt krijgen

Example: Een aangepaste taak maken en uitvoeren