cisco Oprettelse af brugerdefinerede arbejdsgange

Om brugerdefinerede workflow-input

Cisco UCS Director Orchestrator tilbyder en liste over veldefinerede inputtyper til tilpassede opgaver. Cisco UCS Director giver dig også mulighed for at oprette et tilpasset workflow-input til en tilpasset workflow-opgave. Du kan oprette en ny inputtype ved at klone og ændre en eksisterende inputtype.

Forudsætninger

Før du skriver tilpassede opgaver, skal du opfylde følgende forudsætninger:

• Cisco UCS Director er installeret og kører på dit system. For mere information om, hvordan du installerer Cisco UCS Director, henvises til Cisco UCS Director Installation and Configuration Guide.
• Du har et login med administratorrettigheder. Du skal bruge dette login, når du opretter og ændrer brugerdefinerede opgaver.
• Du skal have tilladelse til at skrive CloupiaScript for at skrive en brugerdefineret opgave ved hjælp af CloupiaScript.
• Du skal have tilladelsen til at udføre CloupiaScript for at udføre en brugerdefineret opgave, der er oprettet ved hjælp af CloupiaScript.

Oprettelse af et brugerdefineret workflow-input

Du kan oprette et brugerdefineret input til en brugerdefineret arbejdsprocesopgave. Inputtet vises på listen over inputtyper, som du kan knytte til brugerdefinerede opgaveinput, når du opretter en brugerdefineret arbejdsgangsopgave.

• Trin 1 Vælg Orkestrering.
• Trin 2 Klik på Custom Workflow-input.
• Trin 3 Klik på Tilføj.
• Trin 4 På skærmen Tilføj CustomWorkflow Input skal du udfylde følgende felter:
  • Brugerdefineret inputtypenavn – Et unikt navn for den brugerdefinerede inputtype.
  • Inputtype—Tjek en type input, og klik på Vælg. Baseret på det valgte input vises andre felter. F.eksampNår du vælger e-mail-adresse som inputtype, vises en liste over værdier (LOV). Brug de nye felter til at begrænse værdierne for det brugerdefinerede input.
• Trin 5 Klik på Send.
• Det brugerdefinerede workflow-input føjes til Cisco UCS Director og er tilgængeligt på listen over inputtyper.

Validering af brugerdefineret input

Kunder skal muligvis validere workflow-input ved hjælp af eksterne ressourcer. Ud af boksen kan Cisco UCS Director ikke opfylde enhver kundes valideringsbehov. For at udfylde dette hul giver Cisco UCS Director en mulighed for at validere ethvert input under kørsel ved hjælp af et kundeleveret script. Scriptet kan markere fejl i inputtet og kan kræve gyldigt input, før en serviceanmodning køres. Scriptet kan skrives på ethvert sprog, har adgang til enhver ekstern ressource og har adgang til alle inputværdier for arbejdsgangen.
Du kan skrive brugerdefinerede valideringsscripts ved hjælp af JavaScript, Python, et bash-shell-script eller et hvilket som helst andet scriptsprog.

Følgende exampLe valideringsscripts kan findes i Cisco UCS Director i Orchestration > Custom Workflow Input:

• Example-bash-script-validator
• Example-javascript-validator
• Example-python-validator

Du kan kopiere eller klone eksample scripted workflow-input for at skabe et nyt valideret input. Du kan også bruge example scripted workflow-input som en guide til at udvikle dine egne scripts.

Uanset scriptsproget gælder følgende funktioner og regler for scriptet tilpasset inputvalidering:

• Al scriptet validering køres i en separat proces, så en mislykket valideringsproces ikke påvirker Cisco UCS Director-processen.
• Kun generiske tekstinput kan valideres ved hjælp af scripts.
• Valideringsscripts køres et ad gangen i rækkefølge i samme rækkefølge, som inputs vises på siden med workflow-input. En separat proces lanceres for hvert valideret input.
• En returværdi, der ikke er nul fra scriptet, indikerer en mislykket validering. Du kan valgfrit sende en fejlmeddelelse tilbage til workflow-inputformularen.
• Alle workflow-input sendes til valideringsscriptet på to måder:
  • Som argumenter til scriptet i formen "nøgle" = "værdi".
  • Som miljøvariabler til scriptprocessen. Variablenavnene er inputetiketterne.
    F.eksample, hvis arbejdsgangen har et input mærket som Product-Code og inputværdien er AbC123, overføres variablen til validatorscriptet som "Product-Code"="AbC123".
    Disse inputvariabler kan bruges af scriptet, hvis det er nødvendigt for at implementere valideringen. Undtagelse: Tabelværdier indeholder kun rækkenummeret for tabeludvalget og er derfor sandsynligvis ubrugelige.
• Siden Rediger brugerdefineret arbejdsgangsinput gør scriptet tilgængeligt i editoren til tilpasset opgave. Syntaks er fremhævet for alle sprog. Syntaksfejl kontrolleres kun for JavaScript-validatorer.

Kloning af et brugerdefineret workflow-input

Du kan bruge et eksisterende brugerdefineret workflow-input i Cisco UCS Director til at oprette et brugerdefineret workflow-input.

Før du begynder
Et brugerdefineret workflow-input skal være tilgængeligt i Cisco UCS Director.

• Trin 1 Vælg Orkestrering.
• Trin 2 Klik på Custom Workflow-input.
• Trin 3 Klik på rækken med det brugerdefinerede workflow-input, der skal klones.
  Klon-ikonet vises øverst i tabellen med brugerdefinerede arbejdsgange.
• Trin 4 Klik på Klon.
• Trin 5 Indtast navnet på den brugerdefinerede inputtype.
• Trin 6 Brug de andre kontroller på skærmbilledet Clone Custom Workflow Input til at tilpasse det nye input.
• Trin 7 Klik på Send.
  Indtastningen af ​​den tilpassede arbejdsgangsopgave klones efter bekræftelse og er tilgængelig til brug i den tilpassede arbejdsgangsopgave.

Oprettelse af en brugerdefineret opgave

For at oprette en tilpasset opgave skal du gøre følgende:

• Trin 1 Vælg Orkestrering.
• Trin 2 Klik på Custom Workflow Tasks.
• Trin 3 Klik på Tilføj.
• Trin 4 På skærmbilledet Tilføj tilpasset arbejdsprocesopgave skal du udfylde følgende felter:
  • Felt Opgavenavn – Et unikt navn til den tilpassede arbejdsgangsopgave.
  • Felt for opgaveetiket – En etiket til at identificere den tilpassede arbejdsprocesopgave.
  • Feltet Registrer under kategori—Den arbejdsgangkategori, som den tilpassede arbejdsgangsopgave skal registreres under.
  • Afkrydsningsfeltet Aktiver opgave – Hvis det er markeret, registreres den brugerdefinerede arbejdsprocesopgave hos Orchestrator og kan straks bruges i arbejdsgange.
  • Feltet Kort beskrivelse – En beskrivelse af den tilpassede arbejdsgangsopgave.
  • Feltet Detaljeret beskrivelse – en detaljeret beskrivelse af den tilpassede arbejdsgangsopgave.
• Trin 5 Klik på Næste.
  Skærmen Custom Task Input vises.
• Trin 6 Klik på Tilføj.
• Trin 7 På skærmen Tilføj indgang til input skal du udfylde følgende felter:
  • Felt for inputfeltnavn – Et unikt navn til feltet. Navnet skal starte med analfabetisk tegn og må ikke indeholde mellemrum eller specialtegn.
  • Input Field Label field – En etiket til at identificere inputfeltet.
  • Rulleliste for inputfelttype—Vælg datatypen for inputparameteren.
  • Felt Map to Input Type (Ingen Mapping)—Vælg en type input, som dette felt kan tilknyttes til, hvis dette felt kan tilknyttes fra et andet opgaveoutput eller globalt workflow-input.
  • Obligatorisk afkrydsningsfelt—Hvis markeret, skal brugeren angive en værdi for dette felt.
  • RBID-felt – Indtast RBID-strengen for feltet.
  • Rulleliste for inputfeltstørrelse—Vælg feltstørrelsen for tekst- og tabelindtastninger.
  • Indtastningsfelt Hjælp-felt—(Valgfrit) En beskrivelse, der vises, når du holder musen over feltet.
  • Indtastningsfelt Annotationsfelt - (Valgfrit) Tiptekst til inputfeltet.
  • Feltgruppenavn – hvis det er angivet, lægges alle felter med matchende gruppenavne i feltgruppen.
  • TEKSTFELT-ATRIBUTTER-området – Udfyld følgende felter, når inputfelttypen er tekst.
  • Afkrydsningsfeltet Multiple Input—Hvis markeret, accepterer inputfeltet flere værdier baseret på inputfelttypen:
  • For en LOV—Inputfeltet accepterer flere inputværdier.
  • For et tekstfelt – Indtastningsfeltet bliver et tekstfelt med flere linjer.
  • Maksimal længde på input-feltet – Angiv det maksimale antal tegn, du kan indtaste i inputfeltet.
  • LOV ATTRIBUTES-området – Udfyld følgende felter, når inputtypen er List of Values ​​(LOV) eller LOV med radioknapper.
  • Feltet List of Values ​​– En kommasepareret liste over værdier for indlejrede LOV'er.
    LOV Provider Name-feltet – Navnet på LOV-udbyderen for ikke-indlejrede LOV'er.
  • TABLE ATRIBUTES-området – Udfyld følgende felter, når inputfelttypen er Tabel, Popup-tabel eller Tabel med valg afkrydsningsfeltet.
  • Tabelnavnfelt – Et navn på tabelrapporten for tabelfelttyperne.
  • Område for VALIDERING AF FELTINDGANG—Et eller flere af følgende felter vises afhængigt af din valgte datatype. Udfyld felterne for at angive, hvordan inputfelterne valideres.
  • Input Validator-rulleliste—Vælg en validator til brugerinput.
  • Regulært udtryksfelt – Et regulært udtryksmønster, der matcher inputværdien.
  • Meddelelsesfelt for regulært udtryk – En meddelelse, der vises, når valideringen af ​​regulære udtryk mislykkes.
  • Minimumværdifelt - En minimumsværdi.
  • Feltet Maksimal værdi – En maksimal numerisk værdi.
  • SKJUL PÅ FELT TILSTAND område – Udfyld følgende felter for at indstille betingelsen for at skjule feltet i en formular.
  • Skjul på feltnavn-feltet – Et internt navn til feltet, så det program, der håndterer formularen, kan identificere feltet.
  • Skjul på feltværdifelt - den værdi, der skal sendes, når formularen er indsendt.
  • Rulleliste Skjul på felttilstand – vælg en betingelse, hvor feltet skal skjules.
  • HTML-hjælpefelt – hjælpeinstruktionerne til det skjulte felt.
• Trin 8 Klik på Send.
  Indtastningen tilføjes til tabellen.
• Trin 9 Klik på Tilføj for at tilføje flere indgange til input.
• Trin 10 Når du er færdig med at tilføje input, skal du klikke på Næste.
  Skærmen Uddata for brugerdefinerede arbejdsprocesopgaver vises.
• Trin 11 Klik på Tilføj.
• Trin 12 På skærmbilledet Tilføj post til output skal du udfylde følgende felter:
  • Felt for outputfeltnavn — Et unikt navn til outputfeltet. Det skal starte med et alfabetisk tegn og må ikke indeholde mellemrum eller specialtegn.
  • Output Field Description field — En beskrivelse af outputfeltet.
  • Felt for outputfelttype – Kontroller en type output. Denne type bestemmer, hvordan outputtet kan tilknyttes andre opgaveinput.
• Trin 13 Klik på Send.
  Outputposten føjes til tabellen.
• Trin 14 Klik på Tilføj for at tilføje flere indgange til output.
• Trin 15 Klik på Næste
  Controller-skærmen vises
• Trin 16 (Valgfrit) Klik på Tilføj for at tilføje en controller.
• Trin 17 På skærmbilledet Tilføj post til controller skal du udfylde følgende felter:
  • Metode-rulleliste—Vælg enten en rangerings- eller unmarshalling-metode for at tilpasse input og/eller output til den brugerdefinerede workflow-opgave. Metoden kan være en af ​​følgende:
  • Før Marshall—Brug denne metode til at tilføje eller indstille et inputfelt og dynamisk oprette og indstille LOV på en side (formular).
  • Efter Marshall—Brug denne metode til at skjule eller vise et inputfelt.
  • Før Unmarshall—Brug denne metode til at konvertere en inputværdi fra én formular til en anden form—f.eksample, når du vil kryptere en adgangskode, før du sender den til databasen.
  • Efter Unmarshall—Brug denne metode til at validere et brugerinput og indstille fejlmeddelelsen på siden.
    Se Exampdet: Brug af controllere, på side 14.
  • Scripttekstområde – For den metode, du valgte fra rullelisten Metode, skal du tilføje koden til GUI-tilpasningsscriptet.
    Note Klik på Tilføj, hvis du vil tilføje kode for flere metoder.
    Hvis der er nogen valideringer af de indtastede adgangskoder, skal du sørge for at ændre controllervalideringen for adgangskoderne, så du kan redigere de tilpassede opgaver i arbejdsgange.
    Note
• Trin 18 Klik på Send.
  Regulatoren tilføjes til tabellen.
• Trin 19 Klik på Næste.
  Script-skærmen vises.
• Trin 20 Vælg et sprog fra rullelisten Execution Language.
• Trin 21 Indtast CloupiaScript-koden for den tilpassede arbejdsgangsopgave i Script-feltet.
  Cloupia Script-koden valideres, når du indtaster koden. Hvis der er en fejl i koden, vises et fejlikon (rødt kryds) ud for linjenummeret. Hold musen over fejlikonet til view fejlmeddelelsen og løsningen
• Trin 22 Klik på Gem script.
• Trin 23 Klik på Send.
  Den tilpassede arbejdsprocesopgave oprettes og er tilgængelig til brug i arbejdsgangen

Tilpassede opgaver og arkiver

Når du opretter en tilpasset opgave, i stedet for at indtaste den tilpassede opgavekode i scriptvinduet eller klippe og indsætte kode fra en teksteditor, kan du importere koden fra en file gemt i et GitHub- eller BitBucket-lager. For at gøre dette skal du:

1. Opret en eller flere tekster files i et GitHub- eller BitBucket-depot, enten i github.com eller et privat GitHub-lager.
   Bemærk Cisco UCS Director understøtter kun GitHub (github.com eller en Enterprise GitHub-instans) og eller BitBucket. Det understøtter ikke andre Git-hostingtjenester inklusive GitLab, Perforce eller Codebase.
2. Registrer lageret i Cisco UCS Director. Se Tilføjelse af et GitHub- eller BitBucket-lager i Cisco UCS Director, på side 7.
3. Vælg lageret, og angiv teksten file der indeholder det brugerdefinerede opgavescript. Se Download af brugerdefineret opgavescriptkode fra et GitHub- eller BitBucket-lager på side 8.

Tilføjelse af et GitHub eller BitBucket Repository i Cisco UCS Director
For at registrere en GitHub eller et BitBucket-lager i Cisco UCS Director skal du gøre følgende:

Før du begynder
Opret et GitHub- eller BitBucket-depot. Lagret kan være på enhver GitHub- eller BitBucket-server, offentlig eller privat, som er tilgængelig fra din Cisco UCS Director.
Tjek en eller flere ind files, der indeholder JavaScript-kode til dine tilpassede opgaver i dit lager.

• Trin 1 Vælg Administration > Integration.
• Trin 2 Klik på Administrer lagre på siden Integration.
• Trin 3 Klik på Tilføj.
• Trin 4 På siden Tilføj lager skal du udfylde de påkrævede felter, herunder følgende:
  • Indtast et navn i feltet Lagernavn for at identificere lageret i Cisco UCS Director.
  • I depotet URL indtast feltet URL af GitHub- eller BitBucket-depotet.
  • I feltet Filialnavn skal du indtaste navnet på den lagerafdeling, du vil bruge. Standardnavnet er hovedgren.
  • Indtast brugernavnet til din GitHub- eller BitBucket-konto i feltet Repository User.
  • For at tilføje GitHub-lageret skal du i feltet Password/API Token indtaste det genererede API-token til din GitHub.
    For at generere API-tokenet ved hjælp af GitHub skal du klikke på Indstillinger og navigere til Udviklerindstilling > Personlige adgangstokens og klikke på Generer nyt token.
    For at tilføje BitBucket-lageret, skal du i feltet Adgangskode/API-token indtaste adgangskoden til din BitBucket.
  • For at bruge dette lager som standard, når du opretter en ny brugerdefineret opgave, skal du markere Gør dette til mit standardlager.
  • For at teste, om Cisco UCS Director kan få adgang til lageret, skal du klikke på Test forbindelse.
    Tilslutningstilstanden til lageret vises i et banner øverst på siden.
    Hvis du ikke er i stand til at oprette forbindelse og kommunikere med GitHub- eller BitBucket-lageret fra Cisco UCS
    Direktør, opdater Cisco UCS Director for at få adgang til internettet via en proxyserver. Se Cisco UCS Director Administration Guide.
    Note
• Trin 5 Når du er sikker på, at lageroplysningerne er korrekte, skal du klikke på Send.

Download af brugerdefineret opgavescriptkode fra et GitHub- eller BitBucket-lager

For at oprette en ny brugerdefineret opgave ved at importere tekst fra et GitHub- eller BitBucket-lager skal du gøre følgende:

Før du begynder
Opret et GitHub- eller BitBucket-lager og tjek en eller flere tekster ind files, der indeholder JavaScript-koden til dine tilpassede opgaver i dit lager.

Tilføj GitHub-lageret til Cisco UCS Director. Se Tilføjelse af et GitHub- eller BitBucket-lager i Cisco UCS Director, på side

• Trin 1 Klik på Custom Workflow Tasks på siden Orchestration.
• Trin 2 Klik på Tilføj.
• Trin 3 Udfyld de påkrævede felter på siden Custom Task Information. Se Oprettelse af en brugerdefineret opgave, på side 3.
• Trin 4 Udfyld de påkrævede felter på siden Custom Task Inputs. Se Oprettelse af en brugerdefineret opgave, på side 3.
• Trin 5 Udfyld de påkrævede felter på siden Custom Task Outputs. Se Oprettelse af en brugerdefineret opgave, på side 3.
• Trin 6 Udfyld de påkrævede felter på siden Controller. Se Oprettelse af en brugerdefineret opgave, på side 3.
• Trin 7 På scriptsiden skal du udfylde de påkrævede felter:
  • Vælg JavaScript på rullelisten Execution Language.
  • Marker Brug lager til scripts for at aktivere den tilpassede opgave til at bruge et script file fra et depot. Dette giver dig mulighed for at vælge lageret og angive scriptet file at bruge.
  • Fra rullelisten Select Repository skal du vælge GitHub- eller BitBucket-depotet, der indeholder scriptet files. For detaljer om, hvordan du tilføjer lagre, se Tilføjelse af et GitHub- eller BitBucket-lager i Cisco UCS Director, på side 7.
  • Indtast den fulde sti til scriptet file i Scriptet filenavn tekstfelt.
  • Klik på Indlæs script for at downloade scriptet.
    Teksten fra file kopieres i scripttekstredigeringsområdet.
  • Foretag eventuelt ændringer i det downloadede script i Scripttekstredigeringsområdet.
  • Klik på Gem script for at gemme scriptet, som det vises i tekstredigeringsområdet for script.
    Når du trykker på Gem script, gemmes scriptet i din aktuelle arbejdssession. Du skal klikke på Send for at gemme scriptet til den brugerdefinerede opgave, som du redigerer.
    Note
• Trin 8 Klik på Send for at gemme den tilpassede opgave.
  Hvis du har foretaget ændringer i det downloadede script i tekstredigeringsområdet for script, gemmes ændringerne i den tilpassede opgave. Ingen ændringer gemmes i GitHub- eller BitBucket-depotet. Hvis du vil kassere det indlæste script og indtaste dit eget script, skal du klikke på Kassér script for at rydde scriptvinduet.

Hvad skal man så gøre
Du kan bruge den nye tilpassede opgave i en arbejdsgang.

Import af arbejdsgange, brugerdefinerede opgaver, scriptmoduler og aktiviteter

For at importere artefakter til Cisco UCS Director skal du gøre følgende:

Note Globale variabler, der er knyttet til en arbejdsgang, vil blive importeret under import af en arbejdsgang, hvis den globale variabel ikke er tilgængelig i apparatet.

• Trin 1 Vælg Orkestrering.
• Trin 2 Klik på Workflows på siden Orkestrering.
• Trin 3 Klik på Importer.
• Trin 4 Klik på Vælg a på importskærmen File.
• Trin 5 På Vælg File for at uploade skærmen skal du vælge file skal importeres. Cisco UCS Director import og eksport files har en .wfdx file forlængelse.
• Trin 6 Klik på Åbn.
  Når file er uploadet, den File Upload/valideringsskærmen vises File klar til brug og nøgle.
• Trin 7 Indtast den nøgle, der blev indtastet ved eksport af file.
• Trin 8 Klik på Næste.
  Skærmbilledet Importpolitikker viser en liste over Cisco UCS Director-objekter indeholdt i det uploadede file.
• Trin 9 (Valgfrit) På skærmbilledet Importpolitikker skal du angive, hvordan objekter håndteres, hvis de dublerer navne, der allerede er i arbejdsgangsmappen. På importskærmen skal du udfylde følgende felter

• Trin 10 Klik på Importer.

Eksport af arbejdsgange, brugerdefinerede opgaver, scriptmoduler og aktiviteter

For at eksportere artefakter fra Cisco UCS Director skal du gøre følgende:

Bemærk Globale variabler, der er knyttet til en arbejdsgang, eksporteres automatisk, mens en arbejdsgang eksporteres.

• Trin 1 Klik på Eksporter.
• Trin 2 På skærmen Vælg arbejdsgange skal du vælge de arbejdsgange, du vil eksportere.
  Tilpassede arbejdsgange, opgaver og scripts, der er oprettet i Cisco UCS Director før version 6.6, kan ikke importeres, hvis de indeholder XML-data.
  Note
• Trin 3 Klik på Næste.
• Trin 4 På skærmen Vælg brugerdefinerede opgaver skal du vælge de brugerdefinerede opgaver, du vil udstille
  Bemærk Den eksporterede brugerdefinerede opgave indeholder alle brugerdefinerede input, der bruges af den brugerdefinerede opgave.
• Trin 5 Klik på Næste.
• Trin 6 På skærmbilledet Eksporter: Vælg scriptmoduler skal du vælge de scriptmoduler, du vil eksportere.
• Trin 7 Klik på Næste.
• Trin 8 På skærmbilledet Eksporter: Vælg aktiviteter skal du vælge de aktiviteter, du vil eksportere.
• Trin 9 Klik på Næste.
• Trin 10 På skærmen Eksporter: Vælg Åbn API'er skal du vælge de API'er, du vil eksportere.
• Trin 11 På skærmbilledet Eksport: Bekræftelse skal du udfylde følgende felter:

• Trin 12 Klik på Eksporter.
  Du bliver bedt om at gemme file.

Kloning af en brugerdefineret arbejdsgangsopgave fra opgavebiblioteket

Du kan klone opgaver i opgavebiblioteket til at bruge til at oprette brugerdefinerede opgaver. Du kan også klone en brugerdefineret opgave for at oprette en brugerdefineret opgave.

Den klonede opgave er en ramme med de samme opgaveinput og -output som den oprindelige opgave. Den klonede opgave er dog kun en ramme. Det betyder, at du skal skrive al funktionaliteten til den nye opgave i CloupiaScript.

Bemærk også, at valgværdier for listeinput, såsom dropdown-lister og værdilister, kun overføres til den klonede opgave, hvis listeværdierne ikke er systemafhængige. Sådanne ting som navne og IP-adresser på eksisterende systemer er systemafhængige; Sådanne ting som konfigurationsmuligheder understøttet af Cisco UCS Director er ikke. F.eksample, brugergrupper, skynavne og portgrupper er systemafhængige; brugerroller, skytyper og portgruppetyper er det ikke.

• Trin 1 Vælg Orkestrering.
• Trin 2 Klik på Custom Workflow Tasks.
• Trin 3 Klik på Klon fra opgavebibliotek.
• Trin 4 På skærmen Klon fra opgavebibliotek skal du markere rækken med den opgave, du vil klone.
• Trin 5 Klik på Vælg.
  En brugerdefineret arbejdsprocesopgave oprettes fra opgavebiblioteket. Den nye brugerdefinerede opgave er den sidste brugerdefinerede opgave i rapporten Custom Workflow Tasks. Den nye brugerdefinerede opgave er opkaldt efter den klonede opgave med tilføjet dato.
• Trin 6 Klik på Send

Hvad skal man så gøre
Rediger den tilpassede arbejdsgangsopgave for at sikre, at det korrekte navn og beskrivelse er på plads for den klonede opgave.

Kloning af en tilpasset arbejdsgangsopgave

Du kan bruge en eksisterende brugerdefineret arbejdsgangsopgave i Cisco UCS Director til at oprette en tilpasset arbejdsgangsopgave.

Før du begynder
En tilpasset arbejdsgangsopgave skal være tilgængelig i Cisco UCS Director.

• Trin 1 Vælg Orkestrering.
• Trin 2 Klik på Custom Workflow Tasks.
• Trin 3 Klik på rækken med den brugerdefinerede arbejdsprocesopgave, som du vil klone.
  Klonikonet vises øverst i tabellen med brugerdefinerede arbejdsprocesopgaver.
• Trin 4 Klik på Klon.
• Trin 5 På skærmen Clone Custom Workflow Task skal du opdatere de påkrævede felter.
• Trin 6 Klik på Næste.
  De input, der er defineret for de tilpassede workflow-opgaver, vises.
• Trin 7 Klik på rækken med opgaveinput, som du vil redigere, og klik på Rediger for at redigere opgaveinput.
• Trin 8 Klik på Tilføj for at tilføje en opgaveindtastning.
• Trin 9 Klik på Næste.
  Rediger opgaveoutput.
• Trin 10 Klik på Tilføj for at tilføje en ny outputpost.
• Trin 11 Klik på Næste.
• Trin 12 Rediger controller-scripts. Se Styring af brugerdefinerede arbejdsprocesopgaveinput, på side 13.
• Trin 13 Klik på Næste.
• Trin 14 For at tilpasse den tilpassede opgave skal du redigere opgavescriptet.
• Trin 15 Klik på Send

Styring af brugerdefinerede arbejdsprocesopgaveinput

Brug af controllere
Du kan ændre udseendet og adfærden af ​​brugerdefinerede opgaveinput ved hjælp af controllergrænsefladen, der er tilgængelig i Cisco UCS Director.

Hvornår skal man bruge controllere
Brug controllere i følgende scenarier:

• For at implementere kompleks vis og skjul GUI-adfærd, herunder finere kontrol over værdilister, værdilister i tabelform og andre inputkontroller, der vises til brugeren.
• At implementere kompleks brugerinputvalideringslogik.

Med inputcontrollere kan du gøre følgende:

• Vis eller skjul GUI-kontroller: Du kan dynamisk vise eller skjule forskellige GUI-felter, såsom afkrydsningsfelter, tekstbokse, rullelister og knapper, baseret på betingelser. F.eksampHvis en bruger vælger UCSM fra en rulleliste, kan du bede om brugerlegitimationsoplysninger til Cisco UCS Manager eller ændre listen over værdier (LOV'er) i rullelisten til kun at vise tilgængelige porte på en server.
• Formularfeltvalidering: Du kan validere de data, der er indtastet af en bruger, når du opretter eller redigerer arbejdsgange i Workflow Designer. For ugyldige data indtastet af brugeren kan der vises fejl. Brugerinputdataene kan ændres, før de bevares i databasen, eller før de overføres til en enhed.
• Hent dynamisk en liste over værdier: Du kan dynamisk hente en liste over værdier fra Cisco UCS Director-objekter og bruge dem til at udfylde GUI-formobjekter.

Marshalling og Unmarshalling GUI Form Objects
Controllere er altid knyttet til en formular i Workflow Designers opgaveinput-grænseflade. Der er en en-til-en mapping mellem en formular og en controller. Controllere arbejder i to sektages, rangering og unmarshalling. Begge stages har to substages, før og efter. For at bruge en controller skal du sortere (kontrollere UI-formularfelter) og/eller unmarshall (validere brugerinput) de relaterede GUI-formularobjekter ved hjælp af controllerens scripts.

Følgende tabel opsummerer disse stages.

Bygningscontroller-scripts
Controllere kræver ikke, at der importeres yderligere pakker.
Du overfører ikke parametre til controller-metoderne. I stedet gør Cisco UCS Director-rammen følgende parametre tilgængelige til brug ved rangering og opstilling:

Se Exampdet: Brug af controllere, på side 14 for en arbejdskode sample, der demonstrerer controllerens funktionalitet.

Example: Brug af controllere

Følgende kode example demonstrerer, hvordan man implementerer controller-funktionaliteten i brugerdefinerede workflow-opgaver ved hjælp af de forskellige metoder — før Marshall, efter Marshall, før Unmarshall og efter Unmarshall.
/*

Metodebeskrivelser:
Før Marshall: Brug denne metode til at tilføje eller indstille et inputfelt og dynamisk oprette og indstille LOV på en side(form).
Efter Marshall: Brug denne metode til at skjule eller vise et inputfelt.
Før UnMarshall: Brug denne metode til at konvertere en inputværdi fra en formular til en anden form,
f.eksample, når du vil kryptere adgangskoden, før du sender den til databasen. Efter UnMarshall: Brug denne metode til at validere et brugerinput og indstille fejlmeddelelsen på
side.
*/
//Før Marshall:
/*
Brug beforeMarshall-metoden, når der er en ændring i inputfeltet eller til dynamisk at oprette LOV'er og til at indstille det nye inputfelt på formularen, før det indlæses.
I exampnedenfor, tilføjes et nyt inputfelt 'portList' på siden, før formularen vises i en browser.
*/
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);//opret lov-indtastningsfeltet
//parameteren 'page' bruges til at indstille inputfeltet på formularen
page.setEmbeddedLOVs(id + “.portList”, portListLOV);// sæt inputfeltet på formen =========================== =================================================== =================================
//Efter Marshall:
/*
Brug denne metode til at skjule eller vise et inputfelt.
*/
page.setHidden(id + ".portList", true); //skjul inputfeltet 'portList'.
page.setValue(id + ".status", "Ingen port er oppe. Portlisten er skjult");
page.setEditable(id + ".status", falsk);
=================================================== =================================================== =========
//Før Unmarshall:
/*
Brug beforeUnMarshall-metoden til at læse brugerinputtet og konvertere det til en anden form, før det indsættes i databasen. F.eksample, kan du læse adgangskoden og gemme adgangskoden i databasen efter at have konverteret den til base64-kodning, eller læse medarbejdernavnet og konvertere til medarbejder-id, når medarbejdernavnet sendes til databasen.
I koden example under lun-størrelsen aflæses og konverteres til en ASCII-værdi.
*/
importPackage(org.apache.log4j);
importPackage(java.lang);
importPackage(java.util);
var size = page.getValue(id + ".lunSize");
var logger = Logger.getLogger(“min logger”);
if(størrelse != null){
logger.info(“Størrelsesværdi “+størrelse);
if((ny java.lang.String(size)).matches(“\\d+”)){ var byteValue = size.getBytes(“US-ASCII”); //konverter lun-størrelsen og få ASCII-tegnarrayet

var asciiValueBuilder = new StringBuilder();
for (var i = 0; i < byteValue.length; i++) {
asciiValueBuilder.append(byteValue[i]);
}
var asciiValue = asciiValueBuilder.toString()+” – Ascii
værdi"
//id + ".lunSize" er identifikatoren for inputfeltet
page.setValue(id + ".lunSize",asciiValue); //parameteren
'side' bruges til at indstille værdien i indtastningsfeltet.
pojo.setLunSize(asciiValue); //indstil værdien på pojoen.
Denne pojo vil blive sendt til DB eller ekstern enhed
}
=================================================== =================================================== =========
// Efter unMarshall:
/*
Brug denne metode til at validere og indstille en fejlmeddelelse.
*/
importPackage(org.apache.log4j);
importPackage(java.lang);
importPackage(java.util);
//var størrelse = pojo.getLunSize();
var size = page.get Value(id + ".lunSize");
var logger = Logger .get Logger(“min logger”);
logger.info(“Størrelsesværdi “+størrelse);
if (størrelse > 50) {//valider størrelsen
side. set Error(id+".lunSize", "LUN Size kan ikke være mere end 50MB "); //sæt
fejlmeddelelsen på siden
side .set Sidemeddelelse(“LUN-størrelse kan ikke være mere end 50MB”);
//side. sæt sidestatus(2);
}

Brug af output fra en tidligere opgave i en arbejdsgang

Du kan bruge outputtet fra en tidligere opgave som input til en anden opgave i en arbejdsgang direkte fra scriptet til en tilpasset opgave og en Execute Cloupia Script-opgave i opgavebiblioteket.
For at få adgang til dette output kan du bruge en af ​​følgende måder:

• Hent variablen fra workflow-konteksten ved hjælp af get Input()-metoden.
• Se output ved hjælp af systemvariabelnotation.

For at hente et output ved hjælp af kontekst getInput() metoden, skal du bruge:
var name = ctxt.getInput(“ForrigeTaskName.outputFieldName”);

F.eksampdet:
var navn = ctxt.getInput(“custom_task1_1684.NAME”); // NAME er navnet på opgave1 output
felt, du vil have adgang til
For at hente et output ved hjælp af systemvariabelnotation skal du bruge:
var name = “${Forrige opgavenavn. output feltnavn}";

F.eksampdet:
var navn = "${custom_task1_1684.NAME}"; // NAME er navnet på opgave1-outputfeltet, som du vil have adgang til

Example: Oprettelse og kørsel af en brugerdefineret opgave

For at oprette en tilpasset opgave skal du gøre følgende:

• Trin 1 Vælg Orkestrering.
• Trin 2 Klik på Custom Workflow Tasks.
• Trin 3 Klik på Tilføj, og indtast de brugerdefinerede opgaveoplysninger.
• Trin 4 Klik på Næste.
• Trin 5 Klik på +, og tilføj inputoplysningerne.
• Trin 6 Klik på Send.
• Trin 7 Klik på Næste.
  Skærmen Custom Task Outputs vises.
• Trin 8 Klik på + og tilføj outputdetaljerne for den tilpassede opgave.
• Trin 9 Klik på Næste.
  Controller-skærmen vises.
• Trin 10 Klik på +, og tilføj controllerdetaljerne for den tilpassede opgave.
• Trin 11 Klik på Næste.
  Script-skærmen vises.
• Trin 12 Vælg JavaScript som udførelsessprog, og indtast følgende script for at udføre.
  logger.addInfo(“Hej verden!”);
  logger.addInfo(“Meddelelse “+input.meddelelse);
  hvor meddelelse er inputfeltets navn.
• Trin 13 Klik på Gem script.
• Trin 14 Klik på Send.
  Den tilpassede opgave defineres og føjes til listen over tilpassede opgaver.
• Trin 15 Klik på Workflows på siden Orkestrering.
• Trin 16 Klik på Tilføj for at definere en arbejdsgang og definere arbejdsgangens input og output.
  Når workflow-input og -output er defineret, skal du bruge Workflow Designer til at tilføje en workflow-opgave til workflowet.
• Trin 17 Dobbeltklik på en arbejdsgang for at åbne arbejdsgangen på skærmen Workflow Designer.
• Trin 18 Udvid mapperne i venstre side af Workflow Designer og vælg en brugerdefineret opgave (f.eksample, 'Hej verden tilpasset opgave').
• Trin 19 Træk og slip den valgte opgave til workflowdesigneren.
• Trin 20 Udfyld felterne i Tilføj opgave ( ) skærmen.
• Trin 21 Forbind opgaven med arbejdsgangen. Se Cisco UCS Director Orchstration Guide.
• Trin 22 Klik på Valider arbejdsgang.
• Trin 23 Klik på Udfør nu, og klik på Send.
• Trin 24 Se logmeddelelserne i logvinduet Serviceanmodning.

Dokumenter/ressourcer

cisco Oprettelse af brugerdefinerede arbejdsgange [pdfBrugervejledning Oprettelse af brugerdefinerede arbejdsgangsopgaver, brugerdefinerede arbejdsgangsopgaver, oprettelse af arbejdsgangsopgaver, arbejdsgangsopgaver, opgaver

Referencer

• Brugermanual