Användarhandbok för cisco Skapa anpassade arbetsflödesuppgifter

Cisco UCS Director Orchestrator erbjuder en lista med väldefinierade inmatningstyper för anpassade uppgifter. Cisco UCS Director låter dig också skapa en anpassad arbetsflödesindata för en anpassad arbetsflödesuppgift. Du kan skapa en ny inmatningstyp genom att klona och ändra en befintlig inmatningstyp.

Förutsättningar

Innan du skriver anpassade uppgifter måste du uppfylla följande förutsättningar:

Cisco UCS Director är installerad och körs på ditt system. För mer information om hur du installerar Cisco UCS Director, se Cisco UCS Director Installation and Configuration Guide.
Du har en inloggning med administratörsbehörighet. Du måste använda denna inloggning när du skapar och ändrar anpassade uppgifter.

Du måste ha CloupiaScript-behörighet för att skriva en anpassad uppgift med CloupiaScript.
Du måste ha behörighet att köra CloupiaScript för att utföra en anpassad uppgift som skapats med CloupiaScript.

Skapa en anpassad arbetsflödesinput

Du kan skapa en anpassad indata för en anpassad arbetsflödesuppgift. Inmatningen visas i listan över indatatyper som du kan mappa till anpassade uppgiftsindata när du skapar en anpassad arbetsflödesuppgift.

Steg 1 Välj Orchestration.

Steg 2 Klicka på Anpassade arbetsflödesingångar.
Steg 3 Klicka på Lägg till.

Steg 4 Fyll i följande fält på skärmen Lägg till CustomWorkflow Input:
- Custom Input Type Name – Ett unikt namn för den anpassade inmatningstypen.
- Inmatningstyp—Kontrollera en typ av inmatning och klicka på Välj. Baserat på den valda inmatningen visas andra fält. Till exempelample, när du väljer e-postadress som inmatningstyp, visas en lista med värden (LOV). Använd de nya fälten för att begränsa värdena för den anpassade inmatningen.
Steg 5 Klicka på Skicka.

Den anpassade arbetsflödesinmatningen läggs till i Cisco UCS Director och är tillgänglig i listan över inmatningstyper.

Validering av anpassad indata

Kunder kan behöva validera arbetsflödesindata med hjälp av externa resurser. Utan lådan kan Cisco UCS Director inte uppfylla alla kunders valideringsbehov. För att fylla detta tomrum erbjuder Cisco UCS Director ett alternativ att validera alla indata under körning med hjälp av ett kundtillhandahållet skript. Skriptet kan flagga fel i inmatningen och kan kräva giltig inmatning innan en tjänsteförfrågan körs. Skriptet kan skrivas på vilket språk som helst, kan komma åt valfri extern resurs och har tillgång till alla arbetsflödesinmatningsvärden.
Du kan skriva anpassade valideringsskript med JavaScript, Python, ett bash-skalskript eller något annat skriptspråk.

Följande exampvalideringsskripten finns i Cisco UCS Director i Orchestration > Custom Workflow Inputs:

Example-bash-script-validator

Example-javascript-validator
Example-python-validator

Du kan kopiera eller klona exetample skriptade arbetsflödesingångar för att skapa en ny validerad indata. Du kan också använda example skriptade arbetsflödesingångar som en guide för att utveckla dina egna skript.

Oavsett skriptspråk gäller följande funktioner och regler för validering av anpassad inmatning med skript:

All skriptvalidering körs i en separat process, så att en misslyckad valideringsprocess inte påverkar Cisco UCS Director-processen.
Endast generiska textinmatningar kan valideras med skript.

Valideringsskript körs ett i taget, i ordningsföljd, i samma ordning som indatana visas på sidan för arbetsflödesinmatningar. En separat process startas för varje validerad ingång.
Ett returvärde som inte är noll från skriptet indikerar en misslyckad validering. Alternativt kan du skicka ett felmeddelande tillbaka till arbetsflödesinmatningsformuläret.

Alla arbetsflödesingångar skickas till valideringsskriptet på två sätt:
- Som argument till skriptet i formen "nyckel" = "värde".
- Som miljövariabler till skriptprocessen. Variabelnamnen är indataetiketterna.
  Till exempelample, om arbetsflödet har en indata märkt som Product-Code och inmatningsvärdet är AbC123, skickas variabeln till valideringsskriptet som "Product-Code"="AbC123".
  Dessa indatavariabler kan användas av skriptet vid behov för att implementera valideringen. Undantag: Tabellvärden innehåller endast radnumret för tabellvalet och är därför troligen värdelösa.
Sidan Redigera anpassat arbetsflödesinmatning gör skriptet tillgängligt i redigeraren för anpassad uppgift. Syntax är markerad för alla språk. Syntaxfel kontrolleras endast för JavaScript-validerare.

Klona en anpassad arbetsflödesinput

Du kan använda en befintlig anpassad arbetsflödesindata i Cisco UCS Director för att skapa en anpassad arbetsflödesindata.

Innan du börjar
En anpassad arbetsflödesindata måste vara tillgänglig i Cisco UCS Director.

Steg 1 Välj Orchestration.
Steg 2 Klicka på Anpassade arbetsflödesingångar.
Steg 3 Klicka på raden med den anpassade arbetsflödesinput som ska klonas.
Klonikonen visas överst i tabellen för anpassade arbetsflödesinmatningar.
Steg 4 Klicka på Klona.
Steg 5 Ange namnet på den anpassade inmatningstypen.
Steg 6 Använd de andra kontrollerna på skärmen Clone Custom Workflow Input för att anpassa den nya inmatningen.
Steg 7 Klicka på Skicka.
Inmatningen av den anpassade arbetsflödesuppgiften klonas efter bekräftelse och är tillgänglig för användning i den anpassade arbetsflödesuppgiften.

Skapa en anpassad uppgift

För att skapa en anpassad uppgift, gör följande:

Steg 1 Välj Orchestration.
Steg 2 Klicka på Anpassade arbetsflödesuppgifter.
Steg 3 Klicka på Lägg till.
Steg 4 Fyll i följande fält på skärmen Lägg till anpassad arbetsflödesuppgift:
- Uppgiftsnamnfält – Ett unikt namn för den anpassade arbetsflödesuppgiften.
- Fält för uppgiftsetikett – En etikett för att identifiera den anpassade arbetsflödesuppgiften.
- Register Under Category-fältet – Arbetsflödeskategorin under vilken den anpassade arbetsflödesuppgiften måste registreras.
- Kryssrutan Aktivera uppgift – om den är markerad, registreras den anpassade arbetsflödesuppgiften hos Orchestrator och kan omedelbart användas i arbetsflöden.
- Kort beskrivningsfält – En beskrivning av den anpassade arbetsflödesuppgiften.
- Detaljerad beskrivningsfält – En detaljerad beskrivning av den anpassade arbetsflödesuppgiften.

Steg 5 Klicka på Nästa.
Skärmen Custom Task Inputs visas.
Steg 6 Klicka på Lägg till.
Steg 7 Fyll i följande fält på skärmen Add Entry to Inputs:
- Fält för inmatningsfältnamn – Ett unikt namn för fältet. Namnet måste börja med analfabetisk tecken och får inte innehålla mellanslag eller specialtecken.
- Inmatningsfält Etikettfält – En etikett för att identifiera inmatningsfältet.
- Inmatningsfältstyp rullgardinslista—Välj datatyp för indataparametern.
- Map to Input Type (Ingen mappning)-fält – Välj en typ av indata som detta fält kan mappas till, om detta fält kan mappas från en annan uppgiftsutgång eller global arbetsflödesinput.
- Obligatorisk kryssruta— Om markerad måste användaren ange ett värde för detta fält.
- RBID-fält – Ange RBID-strängen för fältet.
- Listrutan Inmatningsfältstorlek – Välj fältstorlek för text- och tabellinmatningar.
- Hjälpfält för inmatningsfält—(Valfritt) En beskrivning som visas när du för musen över fältet.
- Inmatningsfält Anteckningsfält – (Valfritt) Tipstext för inmatningsfältet.
- Fältgruppsnamnfält – Om det anges läggs alla fält med matchande gruppnamn in i fältgruppen.
- Området TEXTFÄLTATRIBUT – Fyll i följande fält när inmatningsfältstypen är text.
- Kryssrutan för flera inmatningar – om den är markerad accepterar inmatningsfältet flera värden baserat på inmatningsfältstypen:
- För en LOV—Inmatningsfältet accepterar flera inmatningsvärden.
- För ett textfält – Inmatningsfältet blir ett textfält med flera rader.
- Maximal längd på inmatningsfält – Ange det maximala antalet tecken som du kan ange i inmatningsfältet.
- Området LOV ATTRIBUTES – Fyll i följande fält när inmatningstypen är List of Values (LOV) eller LOV med radioknappar.
- List of Values-fältet – En kommaseparerad lista med värden för inbäddade LOV:er.
  LOV Provider Name-fältet – Namnet på LOV-leverantören för icke-inbäddade LOV:er.
- TABELL ATTRIBUT-området – Fyll i följande fält när inmatningsfältstypen är kryssrutan Tabell, Popup-tabell eller Tabell med val.
- Tabellnamnsfält – Ett namn på tabellrapporten för tabellfältstyperna.
- Område för VALIDERING AV FÄLTINGÅNG—Ett eller flera av följande fält visas beroende på din valda datatyp. Fyll i fälten för att ange hur inmatningsfälten ska valideras.
- Input Validator rullgardinslista—Välj en validator för användarinmatningen.
- Fält för reguljära uttryck – Ett reguljärt uttrycksmönster att matcha inmatningsvärdet mot.
- Meddelandefält för reguljära uttryck—Ett meddelande som visas när valideringen av reguljära uttryck misslyckas.
- Minsta värde-fält – Ett minsta numeriskt värde.
- Fält för maximalt värde – Ett maximalt numeriskt värde.
- Området GÖM PÅ FÄLTKONDITION – Fyll i följande fält för att ställa in villkoret för att dölja fältet i ett formulär.
- Göm på fältnamnsfält – Ett internt namn på fältet så att programmet som hanterar formuläret kan identifiera fältet.
- Göm på fältvärdefält – Värdet som måste skickas när formuläret har skickats.
- Dölj på fältvillkor rullgardinslista—Välj ett villkor där fältet måste döljas.
- HTML-hjälpfält – hjälpinstruktionerna för det dolda fältet.

Steg 8 Klicka på Skicka.
Inmatningsposten läggs till i tabellen.
Steg 9 Klicka på Lägg till för att lägga till fler ingångar.
Steg 10 När du är klar med att lägga till ingångar, klicka på Nästa.
Skärmen Anpassade arbetsflödesuppgifter Utdata visas.

Steg 11 Klicka på Lägg till.
Steg 12 Fyll i följande fält på skärmen Lägg till post till utdata:
- Fält för utdatafältnamn — Ett unikt namn för utdatafältet. Det måste börja med ett alfabetiskt tecken och får inte innehålla mellanslag eller specialtecken.
- Beskrivningsfält för utdatafält — En beskrivning av utdatafältet.
- Fält för typ av utdatafält – Kontrollera en typ av utdata. Denna typ avgör hur utdata kan mappas till andra uppgiftsingångar.
Steg 13 Klicka på Skicka.
Utdataposten läggs till i tabellen.

Steg 14 Klicka på Lägg till för att lägga till fler poster i utgångar.
Steg 15 Klicka på Nästa
Styrskärmen visas
Steg 16 (Valfritt) Klicka på Lägg till för att lägga till en kontroller.

Steg 17 Fyll i följande fält på skärmen Add Entry to Controller:
- Rullgardinslista Metod—Välj antingen en rangerings- eller unmarshalleringsmetod för att anpassa ingångarna och/eller utgångarna för den anpassade arbetsflödesuppgiften. Metoden kan vara en av följande:
- Före Marshall—Använd den här metoden för att lägga till eller ställa in ett inmatningsfält och dynamiskt skapa och ställa in LOV på en sida (formulär).
- Efter Marshall—Använd den här metoden för att dölja eller visa ett inmatningsfält.
- Innan Unmarshall – Använd den här metoden för att konvertera ett indatavärde från en form till en annan form – till exempelample, när du vill kryptera ett lösenord innan du skickar det till databasen.
- Efter Unmarshall—Använd den här metoden för att validera en användarinmatning och ställa in felmeddelandet på sidan.
  Se exampde: Använda kontroller, på sidan 14.
- Skripttextområde – För metoden du valde från rullgardinsmenyn Metod, lägg till koden för GUI-anpassningsskriptet.
  Notera Klicka på Lägg till om du vill lägga till kod för fler metoder.
  Om det finns några valideringar av de angivna lösenorden, se till att ändra kontrollervalideringen för lösenorden så att du kan redigera de anpassade uppgifterna i arbetsflöden.
  Notera
Steg 18 Klicka på Skicka.
Styrenheten läggs till i tabellen.
Steg 19 Klicka på Nästa.
Skriptskärmen visas.

Steg 20 Välj ett språk från rullgardinsmenyn Execution Language.
Steg 21 I fältet Skript anger du CloupiaScript-koden för den anpassade arbetsflödesuppgiften.
Cloupia Script-koden valideras när du anger koden. Om det finns något fel i koden visas en felikon (rött kryss) bredvid radnumret. Håll musen över felikonen till view felmeddelandet och lösningen
Steg 22 Klicka på Spara skript.

Steg 23 Klicka på Skicka.
Den anpassade arbetsflödesuppgiften skapas och är tillgänglig för användning i arbetsflödet

Anpassade uppgifter och arkiv

När du skapar en anpassad uppgift, istället för att skriva in den anpassade uppgiftskoden i skriptfönstret eller klippa och klistra in kod från en textredigerare, kan du importera koden från en file lagras i ett GitHub- eller BitBucket-förråd. För att göra detta:

Skapa en eller flera texter files i ett GitHub- eller BitBucket-förråd, antingen i github.com eller ett privat GitHub-förråd.
Obs! Cisco UCS Director stöder endast GitHub (github.com eller en företags GitHub-instans) och eller BitBucket. Det stöder inte andra Git-värdtjänster inklusive GitLab, Perforce eller Codebase.

Registrera förvaret i Cisco UCS Director. Se Lägga till en GitHub eller BitBucket Repository i Cisco UCS Director, på sidan 7.
Välj arkivet och ange texten file som innehåller det anpassade uppgiftsskriptet. Se Ladda ner anpassad uppgiftsskriptkod från ett GitHub- eller BitBucket-förråd, på sidan 8.

Lägga till en GitHub eller BitBucket Repository i Cisco UCS Director
För att registrera en GitHub eller ett BitBucket-förråd i Cisco UCS Director, gör följande:

Innan du börjar
Skapa ett GitHub- eller BitBucket-förråd. Lagret kan finnas på vilken GitHub- eller BitBucket-server som helst, offentlig eller privat som är tillgänglig från din Cisco UCS Director.
Checka in en eller flera files som innehåller JavaScript-kod för dina anpassade uppgifter i ditt arkiv.

Steg 1 Välj Administration > Integration.
Steg 2 På sidan Integration klickar du på Hantera förråd.

Steg 3 Klicka på Lägg till.
Steg 4 Fyll i de obligatoriska fälten på sidan Lägg till arkiv, inklusive följande:
- I fältet Smeknamn för arkivet anger du ett namn för att identifiera arkivet i Cisco UCS Director.
- I förvaret URL fältet, ange URL av GitHub- eller BitBucket-förvaret.
- I fältet Filialnamn anger du namnet på den förvarsgren du vill använda. Standardnamnet är huvudgren.
- I fältet Repository User anger du användarnamnet för ditt GitHub- eller BitBucket-konto.
- För att lägga till GitHub-förvaret, i fältet Lösenord/API-token anger du den genererade API-token för din GitHub.
  För att generera API-token med GitHub, klicka på Inställningar och navigera till Developer Setting > Personal access tokens, och klicka på Generate new token.
  För att lägga till BitBucket-förrådet, i fältet Lösenord/API-token, skriv in lösenordet för din BitBucket.
- Om du vill använda det här arkivet som standard när du skapar en ny anpassad uppgift, markerar du Gör detta till mitt standardarkiv.
- För att testa om Cisco UCS Director kan komma åt arkivet, klicka på Testa anslutning.
  Tillståndet för anslutning till förvaret visas i en banner högst upp på sidan.
  Om du inte kan ansluta och kommunicera med GitHub- eller BitBucket-förrådet från Cisco UCS
  Direktör, uppdatera Cisco UCS Director för att komma åt Internet via en proxyserver. Se Cisco UCS Director Administration Guide.
  Notera

Steg 5 När du är säker på att förvarsinformationen är korrekt klickar du på Skicka.

Ladda ner anpassad uppgiftsskriptkod från ett GitHub- eller BitBucket-förråd

För att skapa en ny anpassad uppgift genom att importera text från ett GitHub- eller BitBucket-förråd, gör följande:

Innan du börjar
Skapa ett GitHub- eller BitBucket-förråd och checka in en eller flera texter files som innehåller JavaScript-koden för dina anpassade uppgifter i ditt arkiv.

Lägg till GitHub-förrådet till Cisco UCS Director. Se Lägga till ett GitHub- eller BitBucket-förråd i Cisco UCS Director, på sidan

Steg 1 Klicka på Custom Workflow Tasks på sidan Orchestration.

Steg 2 Klicka på Lägg till.
Steg 3 Fyll i de obligatoriska fälten på sidan Anpassad uppgiftsinformation. Se Skapa en anpassad uppgift, på sidan 3.
Steg 4 Fyll i de obligatoriska fälten på sidan Anpassade uppgiftsinmatningar. Se Skapa en anpassad uppgift, på sidan 3.

Steg 5 Fyll i de obligatoriska fälten på sidan Custom Task Outputs. Se Skapa en anpassad uppgift, på sidan 3.
Steg 6 Fyll i de obligatoriska fälten på sidan Controller. Se Skapa en anpassad uppgift, på sidan 3.
Steg 7 Fyll i de obligatoriska fälten på skriptsidan:
- Välj JavaScript i rullgardinsmenyn Execution Language.
- Markera Använd arkiv för skript för att aktivera den anpassade uppgiften att använda ett skript file från ett förvar. Detta gör att du kan välja arkivet och ange skriptet file att använda.
- Från rullgardinsmenyn Välj arkiv, välj GitHub- eller BitBucket-förvaret som innehåller skriptet files. För detaljer om hur du lägger till arkiv, se Lägga till ett GitHub- eller BitBucket-arkiv i Cisco UCS Director, på sidan 7.
- Ange hela sökvägen till skriptet file i manuset filenamntextfält.
- För att ladda ner skriptet, klicka på Ladda skript.
  Texten från file kopieras i textredigeringsområdet för skript.
- Alternativt kan du göra ändringar i det nedladdade skriptet i textredigeringsområdet för skript.
- För att spara skriptet som det visas i textredigeringsområdet för skriptet, klicka på Spara skript.
  När du trycker på Spara skript sparas skriptet i din nuvarande arbetssession. Du måste klicka på Skicka för att spara skriptet till den anpassade uppgift som du redigerar.
  Notera
Steg 8 För att spara den anpassade uppgiften, klicka på Skicka.
Om du gjorde ändringar i det nedladdade skriptet i textredigeringsområdet för skript, sparas ändringarna i den anpassade uppgiften. Inga ändringar sparas i GitHub- eller BitBucket-förrådet. Om du vill kassera det inlästa skriptet och ange ditt eget skript, klicka på Kasta skript för att rensa skriptfönstret.

Vad du ska göra härnäst
Du kan använda den nya anpassade uppgiften i ett arbetsflöde.

Importera arbetsflöden, anpassade uppgifter, skriptmoduler och aktiviteter

För att importera artefakter till Cisco UCS Director, gör följande:

Notera Globala variabler associerade med ett arbetsflöde kommer att importeras under import av ett arbetsflöde om den globala variabeln inte är tillgänglig i verktyget.

Steg 1 Välj Orchestration.

Steg 2 Klicka på Workflows på sidan Orchestration.
Steg 3 Klicka på Importera.
Steg 4 På importskärmen klickar du på Välj a File.

Steg 5 På Välj File för att ladda upp skärmen, välj file ska importeras. Cisco UCS Director import och export files har en .wfdx file förlängning.
Steg 6 Klicka på Öppna.
När file laddas upp, den File Skärmen för uppladdning/validering visas File redo för användning och nyckel.
Steg 7 Ange nyckeln som angavs när du exporterade file.

Steg 8 Klicka på Nästa.
Skärmen Importprinciper visar en lista över Cisco UCS Director-objekt som finns i det uppladdade file.
Steg 9 (Valfritt) På skärmen Importera principer anger du hur objekt ska hanteras om de duplicerar namn som redan finns i arbetsflödesmappen. Fyll i följande fält på importskärmen

Namn	Beskrivning
Arbetsflöden	Välj bland följande alternativ för att ange hur identiskt namngivna arbetsflöden ska hanteras: Ersätta— Ersätt det befintliga arbetsflödet med det importerade arbetsflödet. Behåll båda—Importera arbetsflödet som en ny version. Hoppa— Importera inte arbetsflödet.
Anpassade uppgifter	Välj bland följande alternativ för att ange hur identiskt namngivna anpassade uppgifter ska hanteras: Ersätta Behåll båda Hoppa

Namn	Beskrivning
Skriptmoduler	Välj bland följande alternativ för att ange hur identiskt namngivna skriptmoduler ska hanteras: Ersätta Behåll båda Hoppa
Aktiviteter	Välj bland följande alternativ för att ange hur identiskt namngivna aktiviteter ska hanteras: Ersätta Behåll båda Hoppa
Importera arbetsflöden till mapp	ChMarkera Importera arbetsflöden till mapp för att importera arbetsflödena. Om du inte markerar Importera arbetsflöden till mapp och om ingen befintlig version av ett arbetsflödew finns, det arbetsflödet importeras inte.
Välj Mapp	Välj en mapp som du vill importera arbetsflödena till. Om du väljer [Ny Mapp..] i rullgardinsmenyn Ny mapp fältet visas.
Ny mapp	Ange namnet på den nya mappen som ska skapas som din importmapp.

Steg 10 Klicka på Importera.

Exportera arbetsflöden, anpassade uppgifter, skriptmoduler och aktiviteter

För att exportera artefakter från Cisco UCS Director gör du följande:

Obs Globala variabler som är associerade med ett arbetsflöde kommer att exporteras automatiskt när ett arbetsflöde exporteras.

Steg 1 Klicka på Exportera.
Steg 2 På skärmen Välj arbetsflöden väljer du de arbetsflöden som du vill exportera.
Anpassade arbetsflöden, uppgifter och skript som skapats i Cisco UCS Director före version 6.6 kan inte importeras om de innehåller XML-data.
Notera
Steg 3 Klicka på Nästa.
Steg 4 På skärmen Välj anpassade uppgifter väljer du de anpassade uppgifter som du vill exponera
Obs! Den exporterade anpassade uppgiften innehåller alla anpassade indata som används av den anpassade uppgiften.
Steg 5 Klicka på Nästa.
Steg 6 På skärmen Exportera: Välj skriptmoduler väljer du de skriptmoduler som du vill exportera.
Steg 7 Klicka på Nästa.
Steg 8 På skärmen Exportera: Välj aktiviteter väljer du de aktiviteter som du vill exportera.
Steg 9 Klicka på Nästa.
Steg 10 På skärmen Exportera: Välj Öppna API:er väljer du de API:er som du vill exportera.
Steg 11 Fyll i följande fält på skärmen Export: Bekräftelse:

Namn	Beskrivning
Exporterad av	Ditt namn eller en anteckning om vem som ansvarar för exporten.
Kommentarer	Kommentarer om denna export.
Kryptera det exporterade file	Markera Kryptera det exporterade file kryssrutan för att kryptera file som ska exporteras. Som standard är kryssrutan markerad.
Nyckel	Ange nyckeln för att kryptera file. Detta fält visas endast när Kryptera den exporterade file kryssrutan är markerad. Bevara nyckeln när den behövs när du importerar arbetsflödet för dekryptering.
Bekräfta nyckel	Ange nyckeln igen för att bekräfta. Detta fält visas endast när Kryptera den exporterade file kryssrutan är markerad.
Exporterad File Namn	Namnet på file på ditt lokala system. Skriv bara basen filenamn; de file typtillägget (.wfdx) läggs till automatiskt.

Steg 12 Klicka på Exportera.
Du uppmanas att spara file.

Klona en anpassad arbetsflödesuppgift från uppgiftsbiblioteket

Du kan klona uppgifter i uppgiftsbiblioteket för att använda när du skapar anpassade uppgifter. Du kan också klona en anpassad uppgift för att skapa en anpassad uppgift.

Den klonade uppgiften är ett ramverk med samma uppgiftsingångar och utdata som den ursprungliga uppgiften. Den klonade uppgiften är dock bara ett ramverk. Det betyder att du måste skriva all funktionalitet för den nya uppgiften i CloupiaScript.

Observera också att urvalsvärden för listinmatningar, såsom rullgardinslistor och värdelistor, endast överförs till den klonade uppgiften om listvärdena inte är systemberoende. Sådana saker som namn och IP-adresser för befintliga system är systemberoende; sådant som konfigurationsalternativ som stöds av Cisco UCS Director är det inte. Till exempelample, användargrupper, molnnamn och portgrupper är systemberoende; användarroller, molntyper och portgrupptyper är det inte.

Steg 1 Välj Orchestration.
Steg 2 Klicka på Anpassade arbetsflödesuppgifter.
Steg 3 Klicka på Klona från uppgiftsbibliotek.
Steg 4 På skärmen Clone from Task Library, markera raden med uppgiften som du vill klona.
Steg 5 Klicka på Välj.
En anpassad arbetsflödesuppgift skapas från aktivitetsbiblioteket. Den nya anpassade uppgiften är den sista anpassade uppgiften i rapporten Anpassade arbetsflödesuppgifter. Den nya anpassade uppgiften är döpt efter den klonade uppgiften, med datumet tillagt.
Steg 6 Klicka på Skicka

Vad du ska göra härnäst
Redigera den anpassade arbetsflödesuppgiften för att säkerställa att rätt namn och beskrivning finns på plats för den klonade uppgiften.

Klona en anpassad arbetsflödesuppgift

Du kan använda en befintlig anpassad arbetsflödesuppgift i Cisco UCS Director för att skapa en anpassad arbetsflödesuppgift.

Innan du börjar
En anpassad arbetsflödesuppgift måste vara tillgänglig i Cisco UCS Director.

Steg 1 Välj Orchestration.
Steg 2 Klicka på Anpassade arbetsflödesuppgifter.
Steg 3 Klicka på raden med den anpassade arbetsflödesuppgift som du vill klona.
Klonikonen visas överst i tabellen med anpassade arbetsflödesuppgifter.
Steg 4 Klicka på Klona.
Steg 5 På skärmen Clone Custom Workflow Task uppdaterar du de obligatoriska fälten.
Steg 6 Klicka på Nästa.
Ingångarna som definierats för de anpassade arbetsflödesuppgifterna visas.
Steg 7 Klicka på raden med uppgiftsinmatningen som du vill redigera och klicka på Redigera för att redigera uppgiftsinmatningarna.
Steg 8 Klicka på Lägg till för att lägga till en uppgiftsinmatningspost.
Steg 9 Klicka på Nästa.
Redigera uppgiftsutgångarna.
Steg 10 Klicka på Lägg till för att lägga till en ny utdatapost.
Steg 11 Klicka på Nästa.
Steg 12 Redigera kontrollerns skript. Se Styra ingångar för anpassade arbetsflödesuppgifter, på sidan 13.
Steg 13 Klicka på Nästa.
Steg 14 För att anpassa den anpassade uppgiften, redigera uppgiftsskriptet.
Steg 15 Klicka på Skicka

Styra anpassade arbetsflödesuppgifter

Använda kontroller
Du kan ändra utseendet och beteendet för anpassade uppgiftsinmatningar med hjälp av styrenhetsgränssnittet i Cisco UCS Director.

När ska man använda styrenheter
Använd styrenheter i följande scenarier:

För att implementera komplext visa och dölja GUI-beteende inklusive finare kontroll av värdelistor, värdelistor i tabellform och andra inmatningskontroller som visas för användaren.
För att implementera komplex användarinmatningsvalideringslogik.

Med ingångskontroller kan du göra följande:

Visa eller dölj GUI-kontroller: Du kan dynamiskt visa eller dölja olika GUI-fält såsom kryssrutor, textrutor, rullgardinslistor och knappar, baserat på villkor. Till exempelampOm en användare väljer UCSM från en rullgardinslista kan du be om användaruppgifter för Cisco UCS Manager eller ändra listan med värden (LOVs) i rullgardinsmenyn till att endast visa tillgängliga portar på en server.
Validering av formulärfält: Du kan validera data som angetts av en användare när du skapar eller redigerar arbetsflöden i arbetsflödesdesignern. För ogiltiga data som angetts av användaren kan fel visas. Användarens indata kan ändras innan den finns kvar i databasen eller innan den sparas till en enhet.
Hämta en lista med värden dynamiskt: Du kan dynamiskt hämta en värdelista från Cisco UCS Director-objekt och använda dem för att fylla i GUI-formulärobjekt.

Marshalling och Unmarshalling GUI Form Objects
Styrenheter är alltid kopplade till ett formulär i Workflow Designers gränssnitt för uppgiftsinmatning. Det finns en en-till-en-mappning mellan ett formulär och en kontroller. Styrenheter fungerar i två stages, rangering och unmarshalling. Båda stages har två substages, före och efter. För att använda en kontroller måste du sortera (kontrollera UI-formulärfält) och/eller unmarshall (validera användarinmatningar) de relaterade GUI-formulärobjekten med hjälp av kontrollenhetens skript.

Följande tabell sammanfattar dessa stages.

Stage	Sub-stage
Marshalling — Används för att dölja och visa formulärfält och för avancerad kontroll av LOV:er och tabellformade LOV:er.	före Marshall — Används för att lägga till eller ställa in ett inmatningsfält och dynamiskt skapa och ställa in LOV på en sida (formulär). efter Marshall — Används för att dölja eller visa ett inmatningsfält.

Stage	Sub-stage
Unmarshalling – Används för validering av formuläranvändare.	före Unmarshall — Används för att konvertera ett indatavärde från en form till en annan form, t.example, för att kryptera lösenordet innan det skickas till databasen. efter Unmarshall — Används för att validera en användarinmatning och ställa in felmeddelandet på sidan.

Byggkontrollskript
Kontroller kräver inga ytterligare paket för att importeras.
Du skickar inga parametrar till regulatormetoderna. Istället gör Cisco UCS Director-ramverket följande parametrar tillgängliga för användning vid rangering och avmarshalling:

Parameter	Beskrivning	Example
Sida	Sidan eller formuläret som innehåller alla uppgiftsindata. Du kan använda den här parametern för att göra följande: Hämta eller ställ in ingångsvärdena i ett GUI-formulär. Visa eller dölj indata i ett GUI-formulär.	page.setHidden(id + ".portList", true); page.setValue(id + ".status", "Ingen port finns tillgänglig. Portlistan är dold");
id	Den unika identifieraren för formulärinmatningsfältet. Ett id genereras av ramverket och kan användas med namnet på formulärinmatningsfältet.	page.setValue(id + ".status", "Ingen port finns tillgänglig. Portlistan är dold");// här är 'status' namnet på inmatningsfältet.
Pojo	POJO (vanligt gammalt Java-objekt) är en Java-böna som representerar en inmatningsform. Varje GUI-sida måste ha en motsvarande POJO som innehåller värdena från formuläret. POJO används för att bevara värdena till databasen eller för att skicka värdena till en extern enhet.	pojo.setLunSize(asciiValue); //ställ in värdet för inmatningsfältet 'lunSize'

Se exampde: Använda styrenheter, på sidan 14 för en fungerande kod sampfil som demonstrerar styrenhetens funktionalitet.

Example: Använda styrenheter

Följande kod example demonstrerar hur man implementerar kontrollfunktionaliteten i anpassade arbetsflödesuppgifter med de olika metoderna — före Marshall, efter Marshall, före Unmarshall och efter Unmarshall.
/*

Metodbeskrivningar:
Före Marshall: Använd den här metoden för att lägga till eller ställa in ett inmatningsfält och dynamiskt skapa och ställa in LOV på en sida(formulär).
Efter Marshall: Använd den här metoden för att dölja eller visa ett inmatningsfält.
Innan UnMarshall: Använd den här metoden för att konvertera ett indatavärde från en form till en annan form,
till exempelample, när du vill kryptera lösenordet innan du skickar det till databasen. Efter UnMarshall: Använd den här metoden för att validera en användarinmatning och ställa in felmeddelandet på
sida.
*/
//Före Marshall:
/*
Använd beforeMarshall-metoden när det finns en förändring i inmatningsfältet eller för att dynamiskt skapa LOV:er och för att ställa in det nya inmatningsfältet på formuläret innan det laddas.
I exampnedan läggs ett nytt inmatningsfält 'portList' till på sidan innan formuläret visas i en webbläsare.
*/
importPackage(com.cloupia.model.cIM);
importPackage(java.util);
importPackage(java.lang);
var portList = new ArrayList();
var lovLabel = “eth0”;
var lovValue = “eth0”;
var portListLOV = new Array();
portListLOV[0] = new FormLOVPair(lovLabel, lovValue);//skapa inmatningsfältet lov
//parametern 'page' används för att ställa in inmatningsfältet på formuläret
page.setEmbeddedLOVs(id + “.portList”, portListLOV);// ställ in inmatningsfältet på formuläret =========================== ================================================== =================================
//Efter Marshall:
/*
Använd den här metoden för att dölja eller visa ett inmatningsfält.
*/
page.setHidden(id + ".portList", true); //dölj inmatningsfältet 'portList'.
page.setValue(id + ".status", "Ingen port finns tillgänglig. Portlistan är dold");
page.setEditable(id + ".status", false);
========================================================================================================================
//Innan Unmarshall :
/*
Använd beforeUnMarshall-metoden för att läsa användarinmatningen och konvertera den till en annan form innan du infogar den i databasen. Till exempelample, kan du läsa lösenordet och lagra lösenordet i databasen efter att ha konverterat det till base64-kodning, eller läsa anställds namn och konvertera till anställds ID när anställds namn skickas till databasen.
I koden example under lun-storleken läses och omvandlas till ett ASCII-värde.
*/
importPackage(org.apache.log4j);
importPackage(java.lang);
importPackage(java.util);
var size = page.getValue(id + “.lunSize”);
var logger = Logger.getLogger(“min logger”);
if(storlek != null){
logger.info(“Storleksvärde “+storlek);
if((new java.lang.String(size)).matches(“\\d+”)){ var byteValue = size.getBytes(“US-ASCII”); //konvertera lun-storleken och få ASCII-teckenmatrisen

var asciiValueBuilder = new StringBuilder();
for (var i = 0; i < byteValue.length; i++) {
asciiValueBuilder.append(byteValue[i]);
}
var asciiValue = asciiValueBuilder.toString()+” – Ascii
värde"
//id + ".lunSize" är identifieraren för inmatningsfältet
page.setValue(id + “.lunSize”, asciiValue); //parametern
'page' används för att ställa in värdet i inmatningsfältet.
pojo.setLunSize(asciiValue); //ställ in värdet på pojo.
Denna pojo kommer att skickas till DB eller extern enhet
}
========================================================================================================================
// Efter unMarshall:
/*
Använd den här metoden för att validera och ställa in ett felmeddelande.
*/
importPackage(org.apache.log4j);
importPackage(java.lang);
importPackage(java.util);
//var storlek = pojo.getLunSize();
var size = page.get Value(id + “.lunSize”);
var logger = Logger .get Logger(“min logger”);
logger.info(“Storleksvärde “+storlek);
if (storlek > 50) {//validera storleken
sida. set Error(id+".lunSize", "LUN-storlek kan inte vara mer än 50MB "); //uppsättning
felmeddelandet på sidan
page .set Page Message ("LUN-storlek kan inte vara mer än 50MB");
//sida. ställ in sidstatus(2);
}

Använda utdata från en tidigare uppgift i ett arbetsflöde

Du kan använda utdata från en tidigare uppgift som indata för en annan uppgift i ett arbetsflöde direkt från skriptet för en anpassad uppgift och en Execute Cloupia Script-uppgift i aktivitetsbiblioteket.
För att komma åt denna utgång kan du använda något av följande sätt:

Hämta variabeln från arbetsflödeskontexten med metoden get Input().
Se utgången med systemvariabelnotation.

För att hämta en utdata med hjälp av context getInput()-metoden, använd:
var name = ctxt.getInput(”PreviousTaskName.outputFieldName”);

Till exempelampde:
var name = ctxt.getInput(“custom_task1_1684.NAME”); // NAME är namnet på uppgift1-utgången
fält som du vill komma åt
För att hämta en utdata med systemvariabelnotation, använd:
var name = “${Föregående uppgiftsnamn. utdatafältnamn}”;

Till exempelampde:
var name = "${custom_task1_1684.NAME}"; // NAME är namnet på uppgift1-utdatafältet som du vill komma åt

Example: Skapa och köra en anpassad uppgift