Používateľská príručka cisco Vytváranie vlastných úloh pracovného toku

Cisco UCS Director Orchestrator ponúka zoznam dobre definovaných typov vstupu pre vlastné úlohy. Cisco UCS Director vám tiež umožňuje vytvoriť prispôsobený vstup pracovného toku pre úlohu vlastného pracovného toku. Nový typ vstupu môžete vytvoriť klonovaním a úpravou existujúceho typu vstupu.

Predpoklady

Pred písaním vlastných úloh musíte splniť nasledujúce predpoklady:

Cisco UCS Director je nainštalovaný a spustený vo vašom systéme. Ďalšie informácie o tom, ako nainštalovať Cisco UCS Director, nájdete v Inštalačnej a konfiguračnej príručke Cisco UCS Director.
Máte prihlásenie s oprávneniami správcu. Toto prihlásenie musíte použiť pri vytváraní a úprave vlastných úloh.

Ak chcete napísať vlastnú úlohu pomocou skriptu CloupiaScript, musíte mať povolenie na zápis do jazyka CloupiaScript.
Ak chcete vykonať vlastnú úlohu vytvorenú pomocou skriptu CloupiaScript, musíte mať povolenie na spustenie skriptu CloupiaScript.

Vytvorenie vlastného vstupu pracovného toku

Môžete vytvoriť vlastný vstup pre úlohu vlastného pracovného toku. Vstup sa zobrazí v zozname typov vstupov, ktoré môžete namapovať na vstupy vlastnej úlohy, keď vytvoríte vlastnú úlohu pracovného toku.

Krok 1 Vyberte možnosť Orchestra.

Krok 2 Kliknite na položku Custom Workflow Inputs.
Krok 3 Kliknite na položku Pridať.

Krok 4 Na obrazovke Add CustomWorkflow Input vyplňte nasledujúce polia:
- Custom Input Type Name — Jedinečný názov pre vlastný typ vstupu.
- Typ vstupu – skontrolujte typ vstupu a kliknite na položku Vybrať. Na základe zvoleného vstupu sa zobrazia ďalšie polia. NapríkladampAk ako typ vstupu vyberiete e-mailovú adresu, zobrazí sa zoznam hodnôt (LOV). Pomocou nových polí obmedzte hodnoty vlastného vstupu.
Krok 5 Kliknite na tlačidlo Odoslať.

Vstup vlastného pracovného toku sa pridá do Cisco UCS Director a je dostupný v zozname typov vstupu.

Vlastné overenie vstupu

Zákazníci môžu potrebovať overiť vstupy pracovného toku pomocou externých zdrojov. Cisco UCS Director po vybalení nemôže splniť požiadavky každého zákazníka na overenie. Na vyplnenie tejto medzery poskytuje Cisco UCS Director možnosť overiť akýkoľvek vstup za behu pomocou skriptu poskytnutého zákazníkom. Skript môže označiť chyby vo vstupe a môže vyžadovať platný vstup pred spustením servisnej požiadavky. Skript môže byť napísaný v akomkoľvek jazyku, má prístup k akémukoľvek externému zdroju a má prístup ku všetkým vstupným hodnotám pracovného toku.
Vlastné overovacie skripty môžete písať pomocou JavaScriptu, Pythonu, skriptu bash shell alebo akéhokoľvek iného skriptovacieho jazyka.

Nasledujúce exampOverovacie skripty nájdete v Cisco UCS Director v Orchestration > Custom Workflow Inputs:

Example-bash-script-validator

Example-javascript-validator
Example-python-validator

Môžete skopírovať alebo naklonovať example skriptované vstupy pracovného toku na vytvorenie nového overeného vstupu. Môžete tiež použiť example skriptované vstupy pracovného toku ako návod na vývoj vlastných skriptov.

Bez ohľadu na skriptovací jazyk sa na overenie vlastného vstupu pomocou skriptu vzťahujú nasledujúce funkcie a pravidlá:

Všetky skriptované overenia sa spúšťajú v samostatnom procese, takže neúspešný proces overenia neovplyvní proces Cisco UCS Director.
Pomocou skriptov možno overiť iba všeobecné textové vstupy.

Overovacie skripty sa spúšťajú jeden po druhom, v poradí, v rovnakom poradí, v akom sa vstupy zobrazujú na stránke vstupov pracovného toku. Pre každý overený vstup sa spustí samostatný proces.
Nenulová návratová hodnota zo skriptu označuje neúspešné overenie. Voliteľne môžete vrátiť chybové hlásenie späť do vstupného formulára pracovného toku.

Všetky vstupy pracovného toku sa prenášajú do overovacieho skriptu dvoma spôsobmi:
- Ako argumenty skriptu v tvare “key”=”value”.
- Ako premenné prostredia pre proces skriptu. Názvy premenných sú menovky vstupu.
  Napríkladample, ak má pracovný tok vstup označený ako Product-Code a vstupná hodnota je AbC123, premenná sa odovzdá skriptu validátora ako „Product-Code“=“AbC123“.
  Tieto vstupné premenné môže skript použiť v prípade potreby na implementáciu overenia. Výnimka: Hodnoty tabuľky obsahujú iba číslo riadku výberu tabuľky, a preto sú pravdepodobne zbytočné.
Stránka Upraviť vlastný vstup pracovného toku sprístupňuje skript v editore vlastných úloh. Syntax je zvýraznená pre všetky jazyky. Chyby syntaxe sa kontrolujú iba pri validátoroch JavaScriptu.

Klonovanie vlastného vstupu pracovného toku

Na vytvorenie vlastného vstupu pracovného toku môžete použiť existujúci vstup vlastného pracovného toku v aplikácii Cisco UCS Director.

Skôr ako začnete
V Cisco UCS Director musí byť k dispozícii vlastný vstup pracovného toku.

Krok 1 Vyberte možnosť Orchestra.
Krok 2 Kliknite na položku Custom Workflow Inputs.
Krok 3 Kliknite na riadok s vlastným vstupom pracovného toku, ktorý chcete klonovať.
Ikona Klonovať sa zobrazí v hornej časti tabuľky vstupov vlastného pracovného toku.
Krok 4 Kliknite na položku Klonovať.
Krok 5 Zadajte názov vlastného typu vstupu.
Krok 6 Na prispôsobenie nového vstupu použite ďalšie ovládacie prvky na obrazovke Clone Custom Workflow Input.
Krok 7 Kliknite na Odoslať.
Vstup úlohy vlastného pracovného toku sa po potvrdení naklonuje a je k dispozícii na použitie v úlohe vlastného pracovného toku.

Vytvorenie vlastnej úlohy

Ak chcete vytvoriť vlastnú úlohu, postupujte takto:

Krok 1 Vyberte možnosť Orchestra.
Krok 2 Kliknite na položku Custom Workflow Tasks.
Krok 3 Kliknite na položku Pridať.
Krok 4 Na obrazovke Pridať vlastnú úlohu pracovného toku vyplňte nasledujúce polia:
- Pole Názov úlohy – jedinečný názov pre úlohu vlastného pracovného toku.
- Pole Označenie úlohy – Označenie na identifikáciu úlohy vlastného pracovného toku.
- Pole Registrovať pod kategóriu – Kategória pracovného toku, pod ktorou sa musí úloha vlastného pracovného toku zaregistrovať.
- Začiarkavacie políčko Activate Task (Aktivovať úlohu) – ak je začiarknuté, úloha vlastného pracovného toku sa zaregistruje v nástroji Orchestrator a je okamžite použiteľná v pracovných tokoch.
- Pole Stručný popis – popis úlohy vlastného pracovného toku.
- Pole s podrobným popisom – podrobný popis úlohy vlastného pracovného toku.

Krok 5 Kliknite na Ďalej.
Zobrazí sa obrazovka Custom Task Inputs.
Krok 6 Kliknite na položku Pridať.
Krok 7 Na obrazovke Pridať položku do vstupov vyplňte nasledujúce polia:
- Pole názvu vstupného poľa – jedinečný názov poľa. Názov musí začínať analfabetickým znakom a nesmie obsahovať medzery ani špeciálne znaky.
- Pole označenia vstupného poľa – označenie na identifikáciu vstupného poľa.
- Rozbaľovací zoznam Typ vstupného poľa – vyberte typ údajov vstupného parametra.
- Pole Mapovať na typ vstupu (bez mapovania) – vyberte typ vstupu, na ktorý možno toto pole namapovať, ak toto pole možno namapovať z iného výstupu úlohy alebo vstupu globálneho pracovného toku.
- Povinné začiarkavacie políčko – ak je začiarknuté, používateľ musí zadať hodnotu pre toto pole.
- Pole RBID – zadajte reťazec RBID pre pole.
- Rozbaľovací zoznam Veľkosť vstupného poľa – vyberte veľkosť poľa pre textové a tabuľkové vstupy.
- Pole Pomocníka pre vstupné pole – (voliteľné) Popis, ktorý sa zobrazí, keď umiestnite kurzor myši na pole.
- Pole anotácie vstupného poľa – (voliteľné) text rady pre vstupné pole.
- Pole názvu skupiny polí – ak je zadané, všetky polia so zodpovedajúcimi názvami skupín sa umiestnia do skupiny polí.
- Oblasť ATRIBUTY TEXTOVÉHO POLE—Ak je typ vstupného poľa text, vyplňte nasledujúce polia.
- Začiarkavacie políčko Viacnásobný vstup – ak je začiarknuté, vstupné pole akceptuje viacero hodnôt na základe typu vstupného poľa:
- Pre LOV – vstupné pole akceptuje viacero vstupných hodnôt.
- Pre textové pole – vstupné pole sa zmení na viacriadkové textové pole.
- Maximálna dĺžka vstupného poľa – zadajte maximálny počet znakov, ktoré môžete zadať do vstupného poľa.
- Oblasť LOV ATTRIBUTES—Vyplňte nasledujúce polia, ak je typ vstupu Zoznam hodnôt (LOV) alebo LOV s prepínačmi.
- Pole Zoznam hodnôt – čiarkami oddelený zoznam hodnôt pre vložené hodnoty LOV.
  Pole LOV Provider Name – názov poskytovateľa LOV pre nevložené LOV.
- Oblasť ATRIBÚTY TABUĽKY – vyplňte nasledujúce polia, ak je typ vstupného poľa začiarkavacie políčko Tabuľka, Kontextová tabuľka alebo Tabuľka s výberom.
- Pole názvu tabuľky – názov tabuľkovej zostavy pre typy polí tabuľky.
- Oblasť VALIDÁCIE VSTUPU POLE—Zobrazí sa jedno alebo viacero z nasledujúcich polí v závislosti od zvoleného typu údajov. Vyplňte polia, aby ste určili spôsob overovania vstupných polí.
- Rozbaľovací zoznam Validátor vstupu – vyberte validátor pre vstup používateľa.
- Pole regulárneho výrazu – vzor regulárneho výrazu, s ktorým sa zhoduje vstupná hodnota.
- Pole správy regulárneho výrazu – správa, ktorá sa zobrazí, keď zlyhá overenie regulárneho výrazu.
- Pole Minimálna hodnota – minimálna číselná hodnota.
- Pole Maximálna hodnota – maximálna číselná hodnota.
- Oblasť SKRYŤ NA POLE – vyplňte nasledujúce polia a nastavte podmienku na skrytie poľa vo formulári.
- Pole Skryť v názve poľa – interný názov poľa, aby program, ktorý spracováva formulár, mohol pole identifikovať.
- Pole Skryť v poli – hodnota, ktorá sa musí odoslať po odoslaní formulára.
- Rozbaľovací zoznam Skryť na poli Stav – vyberte podmienku, pri ktorej má byť pole skryté.
- Pole HTML Help – Pokyny pomoci pre skryté pole.

Krok 8 Kliknite na Odoslať.
Vstupný záznam sa pridá do tabuľky.
Krok 9 Kliknutím na Pridať pridáte k vstupom ďalšie položky.
Krok 10 Po dokončení pridávania vstupov kliknite na Ďalej.
Zobrazí sa obrazovka Custom Workflow Tasks Outputs.

Krok 11 Kliknite na položku Pridať.
Krok 12 Na obrazovke Pridať položku do výstupov vyplňte nasledujúce polia:
- Pole Názov výstupného poľa — Jedinečný názov výstupného poľa. Musí začínať abecedným znakom a nesmie obsahovať medzery ani špeciálne znaky.
- Pole popisu výstupného poľa — Popis výstupného poľa.
- Pole Typ výstupného poľa – skontrolujte typ výstupu. Tento typ určuje, ako môže byť výstup mapovaný na iné vstupy úlohy.
Krok 13 Kliknite na Odoslať.
Výstupný záznam sa pridá do tabuľky.

Krok 14 Kliknite na Pridať, ak chcete pridať ďalšie položky k výstupom.
Krok 15 Kliknite na tlačidlo Ďalej
Zobrazí sa obrazovka Controller
Krok 16 (Voliteľné) Kliknutím na Pridať pridajte ovládač.

Krok 17 Na obrazovke Pridať položku do ovládača vyplňte nasledujúce polia:
- Rozbaľovací zoznam Metóda – vyberte si metódu zaraďovania alebo rozbaľovania na prispôsobenie vstupov a/alebo výstupov pre úlohu vlastného pracovného toku. Metóda môže byť jedna z nasledujúcich:
- Before Marshall – Túto metódu použite na pridanie alebo nastavenie vstupného poľa a dynamické vytvorenie a nastavenie LOV na stránke (formulári).
- After Marshall – túto metódu použite na skrytie alebo odkrytie vstupného poľa.
- Before Unmarshall—Túto metódu použite na prevod vstupnej hodnoty z jedného formulára do druhého – naprample, keď chcete zašifrovať heslo pred jeho odoslaním do databázy.
- After Unmarshall – túto metódu použite na overenie používateľského vstupu a nastavenie chybového hlásenia na stránke.
  Pozri naprample: Používanie ovládačov, na strane 14.
- Oblasť textu skriptu – pre metódu, ktorú ste si vybrali z rozbaľovacieho zoznamu Method, pridajte kód pre skript prispôsobenia GUI.
  Poznámka Kliknite na Pridať, ak chcete pridať kód pre ďalšie metódy.
  Ak existujú nejaké overenia zadaných hesiel, uistite sa, že ste zmenili overenie hesiel radiča, aby ste mohli upravovať vlastné úlohy v pracovných tokoch.
  Poznámka
Krok 18 Kliknite na Odoslať.
Do tabuľky sa pridá ovládač.
Krok 19 Kliknite na Ďalej.
Zobrazí sa obrazovka Script.

Krok 20 Z rozbaľovacieho zoznamu Execution Language zvoľte jazyk.
Krok 21 Do poľa Skript zadajte kód CloupiaScript pre úlohu vlastného pracovného toku.
Kód skriptu Cloupia sa overí, keď zadáte kód. Ak je v kóde chyba, vedľa čísla riadku sa zobrazí ikona chyby (červený krížik). Ukážte myšou na ikonu chyby view chybové hlásenie a riešenie
Krok 22 Kliknite na Uložiť skript.

Krok 23 Kliknite na Odoslať.
Úloha vlastného pracovného toku je vytvorená a je k dispozícii na použitie v pracovnom toku

Vlastné úlohy a úložiská

Keď vytvoríte vlastnú úlohu, namiesto zadávania kódu vlastnej úlohy do okna skriptu alebo vystrihovania a prilepovania kódu z textového editora môžete kód importovať z file uložené v úložisku GitHub alebo BitBucket. Ak to chcete urobiť, postupujte takto:

Vytvorte jeden alebo viac textov fileje v úložisku GitHub alebo BitBucket, buď na github.com alebo v súkromnom podnikovom úložisku GitHub.
Poznámka Cisco UCS Director podporuje iba GitHub (github.com alebo podniková inštancia GitHub) alebo BitBucket. Nepodporuje iné hostingové služby Git vrátane GitLab, Perforce alebo Codebase.

Zaregistrujte úložisko v Cisco UCS Director. Pozrite si časť Pridanie úložiska GitHub alebo BitBucket v Cisco UCS Director, na strane 7.
Vyberte úložisko a zadajte text file ktorý obsahuje skript vlastnej úlohy. Pozrite si časť Sťahovanie kódu skriptu vlastnej úlohy z úložiska GitHub alebo BitBucket, na strane 8.

Pridanie úložiska GitHub alebo BitBucket v Cisco UCS Director
Ak chcete zaregistrovať úložisko GitHub alebo BitBucket v Cisco UCS Director, postupujte takto:

Skôr ako začnete
Vytvorte úložisko GitHub alebo BitBucket. Úložisko môže byť na akomkoľvek serveri GitHub alebo BitBucket, verejnom alebo súkromnom, ktorý je prístupný z vášho Cisco UCS Director.
Prihláste jednu alebo viac fileobsahuje kód JavaScript pre vaše vlastné úlohy do vášho úložiska.

Krok 1 Vyberte Administrácia > Integrácia.
Krok 2 Na stránke Integrácia kliknite na Spravovať archívy.

Krok 3 Kliknite na položku Pridať.
Krok 4 Na stránke Add Repository vyplňte povinné polia vrátane nasledujúcich:
- Do poľa Prezývka úložiska zadajte názov na identifikáciu úložiska v rámci Cisco UCS Director.
- V úložisku URL do poľa zadajte URL z úložiska GitHub alebo BitBucket.
- Do poľa Názov pobočky zadajte názov pobočky úložiska, ktorú chcete použiť. Predvolený názov je hlavná pobočka.
- Do poľa Používateľ úložiska zadajte používateľské meno svojho účtu GitHub alebo BitBucket.
- Ak chcete pridať úložisko GitHub, do poľa Password/API Token zadajte vygenerovaný token API pre váš GitHub.
  Ak chcete vygenerovať token API pomocou GitHub, kliknite na položku Nastavenia, prejdite na položku Nastavenia vývojára > Osobné prístupové tokeny a kliknite na položku Generovať nový token.
  Ak chcete pridať úložisko BitBucket, do poľa Password/API Token zadajte heslo pre váš BitBucket.
- Ak chcete pri vytváraní novej vlastnej úlohy použiť tento archív ako predvolený, začiarknite políčko Nastaviť ako predvolený archív.
- Ak chcete otestovať, či má Cisco UCS Director prístup k úložisku, kliknite na položku Testovať pripojenie.
  Stav pripojenia k úložisku sa zobrazuje v banneri v hornej časti stránky.
  Ak sa nemôžete pripojiť a komunikovať s úložiskom GitHub alebo BitBucket od Cisco UCS
  Riaditeľ, aktualizujte Cisco UCS Director na prístup na internet cez proxy server. Pozrite si príručku Cisco UCS Director Administration Guide.
  Poznámka

Krok 5 Keď ste spokojní so správnosťou informácií o úložisku, kliknite na Odoslať.

Sťahovanie vlastného kódu skriptu úlohy z úložiska GitHub alebo BitBucket

Ak chcete vytvoriť novú vlastnú úlohu importovaním textu z úložiska GitHub alebo BitBucket, postupujte takto:

Skôr ako začnete
Vytvorte úložisko GitHub alebo BitBucket a zadajte jeden alebo viacero textov files obsahujúcimi kód JavaScript pre vaše vlastné úlohy do vášho úložiska.

Pridajte úložisko GitHub do Cisco UCS Director. Pozrite si časť Pridanie úložiska GitHub alebo BitBucket v Cisco UCS Director na strane

Krok 1 Na stránke Orchestration kliknite na položku Custom Workflow Tasks.

Krok 2 Kliknite na položku Pridať.
Krok 3 Vyplňte požadované polia na stránke Custom Task Information. Pozrite si časť Vytvorenie vlastnej úlohy na strane 3.
Krok 4 Vyplňte požadované polia na stránke Custom Task Inputs. Pozrite si časť Vytvorenie vlastnej úlohy na strane 3.

Krok 5 Vyplňte požadované polia na stránke Custom Task Outputs. Pozrite si časť Vytvorenie vlastnej úlohy na strane 3.
Krok 6 Vyplňte požadované polia na stránke Controller. Pozrite si časť Vytvorenie vlastnej úlohy na strane 3.
Krok 7 Na stránke Skript vyplňte povinné polia:
- V rozbaľovacom zozname Jazyk vykonávania vyberte možnosť JavaScript.
- Ak chcete, aby vlastná úloha používala skript, začiarknite políčko Použiť úložisko pre skripty file z úložiska. To vám umožní vybrať úložisko a špecifikovať skript file používať.
- Z rozbaľovacieho zoznamu Vybrať úložisko vyberte úložisko GitHub alebo BitBucket obsahujúce skript files. Podrobnosti o pridávaní archívov nájdete v časti Pridanie úložiska GitHub alebo BitBucket v Cisco UCS Director, na strane 7.
- Zadajte úplnú cestu k skriptu file v Písme filetextové pole názvu.
- Ak chcete skript stiahnuť, kliknite na položku Načítať skript.
  Text z file sa skopíruje do oblasti úprav textu skriptu.
- Voliteľne vykonajte zmeny v prevzatom skripte v oblasti úprav textu skriptu.
- Ak chcete skript uložiť tak, ako sa zobrazuje v oblasti úprav textu skriptu, kliknite na položku Uložiť skript.
  Keď stlačíte Uložiť skript, skript sa uloží do vašej aktuálnej pracovnej relácie. Ak chcete skript uložiť do vlastnej úlohy, ktorú upravujete, musíte kliknúť na tlačidlo Odoslať.
  Poznámka
Krok 8 Ak chcete uložiť vlastnú úlohu, kliknite na tlačidlo Odoslať.
Ak ste vykonali zmeny v stiahnutom skripte v oblasti úprav textu skriptu, zmeny sa uložia do vlastnej úlohy. Žiadne zmeny sa neuložia do úložiska GitHub alebo BitBucket. Ak chcete zahodiť načítaný skript a zadať vlastný skript, kliknite na tlačidlo Zahodiť skript, čím vymažete okno skriptu.

Čo robiť ďalej
Novú vlastnú úlohu môžete použiť v pracovnom toku.

Importovanie pracovných tokov, vlastných úloh, modulov skriptov a aktivít

Ak chcete importovať artefakty do Cisco UCS Director, postupujte takto:

Poznámka Globálne premenné priradené k pracovnému postupu budú importované počas importovania pracovného postupu, ak globálna premenná nie je v zariadení k dispozícii.

Krok 1 Vyberte možnosť Orchestra.

Krok 2 Na stránke Orchestration kliknite na Workflows.
Krok 3 Kliknite na Importovať.
Krok 4 Na obrazovke Importovať kliknite na Vybrať a File.

Krok 5 Na obrazovke Vybrať File na obrazovke Nahrať vyberte file na dovoz. Riaditeľ Cisco UCS import a export files majú .wfdx file rozšírenie.
Krok 6 Kliknite na Otvoriť.
Keď file je nahraný, File Zobrazí sa obrazovka Upload/Validation File pripravený na použitie a kľúč.
Krok 7 Zadajte kľúč, ktorý ste zadali pri exporte súboru file.

Krok 8 Kliknite na Ďalej.
Na obrazovke Import Policy sa zobrazí zoznam objektov Cisco UCS Director obsiahnutých v odovzdanom súbore file.
Krok 9 (Voliteľné) Na obrazovke Import Policies (Zásady importu) zadajte, ako sa bude zaobchádzať s objektmi, ak duplikujú názvy už v priečinku pracovného toku. Na obrazovke Importovať vyplňte nasledujúce polia

Meno	Popis
Pracovné postupy	Vyberte si z nasledujúcich možností na určenie spôsobu spracovania identicky pomenovaných pracovných tokov: Nahradiť—Nahradiť existujúci pracovný postup importovaným pracovným postupom. Nechať si oboje—Importujte pracovný postup ako novú verziu. Preskočiť– Neimportujte pracovný postup.
Vlastné úlohy	Vyberte si z nasledujúcich možností na určenie spôsobu spracovania identicky pomenovaných vlastných úloh: Nahradiť Nechať si oboje Preskočiť

Meno	Popis
Moduly skriptov	Vyberte si z nasledujúcich možností, aby ste určili, ako sa bude pracovať s identicky pomenovanými modulmi skriptov: Nahradiť Nechať si oboje Preskočiť
Aktivity	Vyberte si z nasledujúcich možností na určenie spôsobu spracovania identicky pomenovaných aktivít: Nahradiť Nechať si oboje Preskočiť
Importovať pracovné postupy do priečinka	Check Importovať pracovné toky do priečinka na importovanie pracovných tokov. Ak nezačiarknete možnosť Importovať pracovné toky do priečinka a ak neexistuje žiadna existujúca verzia pracovného tokuw existuje, tento pracovný postup sa neimportuje.
Vyberte položku Priečinok	Vyberte priečinok, do ktorého chcete importovať pracovné postupy. Ak ste si vybrali [Nové Priečinok..] v rozbaľovacom zozname Nový priečinok zobrazí sa pole.
Nový priečinok	Zadajte názov nového priečinka, ktorý sa má vytvoriť ako priečinok na import.

Krok 10 Kliknite na Importovať.

Exportovanie pracovných tokov, vlastných úloh, modulov skriptov a aktivít

Ak chcete exportovať artefakty z Cisco UCS Director, postupujte takto:

Poznámka Globálne premenné priradené k pracovnému toku budú automaticky exportované počas exportu pracovného toku.

Krok 1 Kliknite na Exportovať.
Krok 2 Na obrazovke Select Workflows zvoľte pracovné toky, ktoré chcete exportovať.
Import vlastných pracovných tokov, úloh a skriptov vytvorených v Cisco UCS Director pred verziou 6.6 môže zlyhať, ak obsahujú údaje XML.
Poznámka
Krok 3 Kliknite na Ďalej.
Krok 4 Na obrazovke Select Custom Tasks zvoľte vlastné úlohy, ktoré chcete zobraziť
Poznámka Exportovaná vlastná úloha obsahuje všetky vlastné vstupy, ktoré používa táto vlastná úloha.
Krok 5 Kliknite na Ďalej.
Krok 6 Na obrazovke Export: Select Script Modules vyberte moduly skriptu, ktoré chcete exportovať.
Krok 7 Kliknite na Ďalej.
Krok 8 Na obrazovke Export: Select Activities vyberte aktivity, ktoré chcete exportovať.
Krok 9 Kliknite na Ďalej.
Krok 10 Na obrazovke Export: Select Open APIs zvoľte API, ktoré chcete exportovať.
Krok 11 Na obrazovke Export: Confirmation vyplňte nasledujúce polia:

Meno	Popis
Exportované používateľom	Vaše meno alebo poznámka o tom, kto je zodpovedný za export.
Komentáre	Komentáre k tomuto exportu.
Zašifrujte exportované file	Začiarknite políčko Šifrovať exportované file začiarknite políčko na šifrovanie file na export. Štandardne je začiarkavacie políčko začiarknuté.
kľúč	Zadajte kľúč na šifrovanie file. Toto pole sa zobrazí iba pri zašifrovaní exportovaného súboru file zaškrtávacie políčko je začiarknuté. Pri importovaní pracovného postupu na dešifrovanie si kľúč uchovajte podľa potreby.
Potvrdiť kľúč	Pre potvrdenie zadajte kľúč znova. Toto pole sa zobrazí iba pri zašifrovaní exportovaného súboru file zaškrtávacie políčko je začiarknuté.
Exportované File Meno	Názov file vo vašom lokálnom systéme. Zadajte iba základňu filenázov; a file prípona typu (.wfdx) sa pripojí automaticky.

Krok 12 Kliknite na Exportovať.
Zobrazí sa výzva na uloženie file.

Klonovanie vlastnej úlohy pracovného toku z knižnice úloh

Úlohy môžete klonovať v knižnici úloh a použiť ich pri vytváraní vlastných úloh. Môžete tiež naklonovať vlastnú úlohu a vytvoriť tak vlastnú úlohu.

Klonovaná úloha je rámec s rovnakými vstupmi a výstupmi úlohy ako pôvodná úloha. Klonovaná úloha je však iba rámcová. To znamená, že musíte napísať všetky funkcie pre novú úlohu v jazyku CloupiaScript.

Všimnite si tiež, že hodnoty výberu pre vstupy do zoznamu, ako sú rozbaľovacie zoznamy a zoznamy hodnôt, sa prenesú do klonovanej úlohy iba vtedy, ak hodnoty zoznamu nie sú závislé od systému. Názvy a IP adresy existujúcich systémov závisia od systému; také veci ako možnosti konfigurácie podporované Cisco UCS Director nie sú. Naprample, skupiny používateľov, názvy cloudov a skupiny portov sú závislé od systému; používateľské roly, typy cloudu a typy skupín portov nie sú.

Krok 1 Vyberte možnosť Orchestra.
Krok 2 Kliknite na položku Custom Workflow Tasks.
Krok 3 Kliknite na Klonovať z knižnice úloh.
Krok 4 Na obrazovke Klonovať z knižnice úloh začiarknite riadok s úlohou, ktorú chcete klonovať.
Krok 5 Kliknite na Vybrať.
Vlastná úloha pracovného toku sa vytvorí z knižnice úloh. Nová vlastná úloha je poslednou vlastnou úlohou v prehľade Úlohy vlastného pracovného toku. Nová vlastná úloha je pomenovaná podľa klonovanej úlohy s pripojeným dátumom.
Krok 6 Kliknite na Submit

Čo robiť ďalej
Upravte úlohu vlastného pracovného toku, aby ste sa uistili, že pre klonovanú úlohu je na mieste správny názov a popis.

Klonovanie vlastnej úlohy pracovného toku

Na vytvorenie vlastnej úlohy pracovného toku môžete použiť existujúcu úlohu vlastného pracovného toku v aplikácii Cisco UCS Director.

Skôr ako začnete
Vlastná úloha pracovného toku musí byť dostupná v Cisco UCS Director.

Krok 1 Vyberte možnosť Orchestra.
Krok 2 Kliknite na položku Custom Workflow Tasks.
Krok 3 Kliknite na riadok s úlohou vlastného pracovného toku, ktorý chcete klonovať.
Ikona Klonovať sa zobrazí v hornej časti tabuľky úloh vlastného pracovného toku.
Krok 4 Kliknite na položku Klonovať.
Krok 5 Na obrazovke Clone Custom Workflow Task aktualizujte požadované polia.
Krok 6 Kliknite na Ďalej.
Zobrazia sa vstupy definované pre úlohy vlastného pracovného toku.
Krok 7 Kliknite na riadok so vstupom úlohy, ktorý chcete upraviť, a kliknutím na Upraviť upravte vstupy úlohy.
Krok 8 Kliknutím na Pridať pridajte vstupnú položku úlohy.
Krok 9 Kliknite na Ďalej.
Upravte výstupy úloh.
Krok 10 Kliknutím na Pridať pridajte novú výstupnú položku.
Krok 11 Kliknite na Ďalej.
Krok 12 Upravte skripty ovládača. Pozrite si časť Ovládanie vstupov úloh vlastného pracovného toku, na strane 13.
Krok 13 Kliknite na Ďalej.
Krok 14 Ak chcete prispôsobiť vlastnú úlohu, upravte skript úlohy.
Krok 15 Kliknite na Submit

Ovládanie vstupov úloh vlastného pracovného toku

Použitie ovládačov
Vzhľad a správanie vstupov vlastných úloh môžete upraviť pomocou rozhrania radiča dostupného v aplikácii Cisco UCS Director.

Kedy použiť ovládače
Použite ovládače v nasledujúcich scenároch:

Na implementáciu komplexného správania zobrazenia a skrytia GUI vrátane jemnejšieho ovládania zoznamov hodnôt, tabuľkových zoznamov hodnôt a iných vstupných ovládacích prvkov zobrazovaných používateľovi.
Implementovať komplexnú logiku overovania užívateľských vstupov.

Pomocou vstupných ovládačov môžete robiť nasledovné:

Zobraziť alebo skryť ovládacie prvky GUI: Môžete dynamicky zobraziť alebo skryť rôzne polia GUI, ako sú začiarkavacie políčka, textové polia, rozbaľovacie zoznamy a tlačidlá, v závislosti od podmienok. NapríkladampAk používateľ vyberie UCSM z rozbaľovacieho zoznamu, môžete požiadať o poverenia používateľa pre Cisco UCS Manager alebo zmeniť zoznam hodnôt (LOV) v rozbaľovacom zozname tak, aby zobrazoval iba dostupné porty na serveri.
Overenie poľa formulára: Údaje zadané používateľom môžete overiť pri vytváraní alebo úprave pracovných tokov v Návrhári pracovného toku. V prípade neplatných údajov zadaných používateľom sa môžu zobraziť chyby. Vstupné údaje používateľa možno zmeniť predtým, ako sa zachovajú v databáze alebo predtým, ako sa zachovajú v zariadení.
Dynamické načítanie zoznamu hodnôt: Môžete dynamicky načítať zoznam hodnôt z objektov Cisco UCS Director a použiť ich na vyplnenie objektov formulára GUI.

Zaraďovanie a rozraďovanie objektov formulára GUI
Ovládače sú vždy spojené s formulárom v rozhraní pre vstupy úloh v nástroji Workflow Designer. Medzi formulárom a kontrolórom existuje mapovanie jedna ku jednej. Ovládače pracujú v dvoch stages, zoraďovanie a vyraďovanie. Obe stages majú dve subtages, pred a po. Ak chcete použiť ovládač, musíte zaradiť (riadiť polia formulárov používateľského rozhrania) a/alebo zrušiť zaradenie (overiť používateľské vstupy) súvisiace objekty formulárov GUI pomocou skriptov kontroléra.

Nasledujúca tabuľka sumarizuje tieto stages.

Stage	Sub-stage
Marshalling — Používa sa na skrytie a odkrytie polí formulára a na pokročilú kontrolu hodnôt LOV a tabuľkových hodnôt LOV.	pred Marshallom — Používa sa na pridanie alebo nastavenie vstupného poľa a dynamické vytvorenie a nastavenie LOV na stránke (formulári). po Marshallovi — Používa sa na skrytie alebo odkrytie vstupného poľa.

Stage	Sub-stage
Vyraďovanie – Používa sa na overenie používateľského vstupu formulára.	pred Unmarshallom — Používa sa na prevod vstupnej hodnoty z jednej formy do druhej, naprample, na zašifrovanie hesla pred jeho odoslaním do databázy. po Unmarshallovi — Používa sa na overenie používateľského vstupu a nastavenie chybového hlásenia na stránke.

Skripty ovládača budov
Ovládače nevyžadujú import žiadnych dodatočných balíkov.
Neodovzdávate parametre metódam ovládača. Namiesto toho rámec Cisco UCS Director sprístupňuje nasledujúce parametre na použitie pri zoraďovaní a rozraďovaní:

Parameter	Popis	Example
Stránka	Stránka alebo formulár, ktorý obsahuje všetky zadania úlohy. Tento parameter môžete použiť na nasledovné: Získajte alebo nastavte vstupné hodnoty vo formulári GUI. Zobraziť alebo skryť vstupy vo formulári GUI.	page.setHidden(id + “.portList”, true); page.setValue(id + „.stav“, „Nie je aktívny žiadny port. Zoznam portov je skrytý“);
id	Jedinečný identifikátor vstupného poľa formulára. Identifikátor generuje rámec a možno ho použiť s názvom vstupného poľa formulára.	page.setValue(id + „.stav“, „Nie je aktívny žiadny port. Zoznam portov je skrytý“);// tu je „stav“ názov vstupného poľa.
Pojo	POJO (plain old Java object) je Java bean predstavujúci vstupný formulár. Každá stránka GUI musí mať zodpovedajúci POJO obsahujúci hodnoty z formulára. POJO sa používa na uloženie hodnôt do databázy alebo na odoslanie hodnôt do externého zariadenia.	pojo.setLunSize(asciiValue); //nastaví hodnotu vstupného poľa 'lunSize'

Pozri naprample: Pomocou ovládačov na strane 14 nájdete pracovný kód sample, ktorý demonštruje funkčnosť ovládača.

Example: Používanie ovládačov

Nasledujúci kód naprample ukazuje, ako implementovať funkcionalitu kontroléra v úlohách vlastného pracovného toku pomocou rôznych metód — pred Marshallom, po Marshallovi, pred Unmarshallom a po Unmarshall.
/*

Popis metód:
Pred Marshallom: Túto metódu použite na pridanie alebo nastavenie vstupného poľa a dynamické vytvorenie a nastavenie LOV na stránke (formulári).
After Marshall: Túto metódu použite na skrytie alebo odkrytie vstupného poľa.
Pred UnMarshall: Túto metódu použite na prevod vstupnej hodnoty z jedného formulára do druhého,
naprample, keď chcete heslo pred odoslaním do databázy zašifrovať. Po UnMarshall: Túto metódu použite na overenie používateľského vstupu a nastavenie chybového hlásenia na
stránku.
*/
//Pred Marshallom:
/*
Metódu beforeMarshall použite, keď dôjde k zmene vo vstupnom poli alebo na dynamické vytváranie hodnôt LOV a na nastavenie nového vstupného poľa vo formulári pred jeho načítaním.
V exampNižšie sa na stránku pred zobrazením formulára v prehliadači pridá nové vstupné pole 'portList'.
*/
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);//vytvorte vstupné pole lov
//Parameter 'page' sa používa na nastavenie vstupného poľa vo formulári
page.setEmbeddedLOVs(id + “.portList”, portListLOV);// nastavenie vstupného poľa vo formulári ============================ ==================================================== =================================
//Po Marshallovi:
/*
Túto metódu použite na skrytie alebo odkrytie vstupného poľa.
*/
page.setHidden(id + “.portList”, true); //skryje vstupné pole 'portList'.
page.setValue(id + „.stav“, „Nie je aktívny žiadny port. Zoznam portov je skrytý“);
page.setEditable(id + “.stav”, false);
================================================== ================================================== =========
//Pred Unmarshall :
/*
Pred vložením do databázy použite metódu beforeUnMarshall na prečítanie používateľského vstupu a jeho konverziu do inej formy. Napríkladample, môžete si prečítať heslo a uložiť heslo do databázy po jeho konverzii do kódovania base64, alebo prečítať meno zamestnanca a skonvertovať ho na ID zamestnanca, keď sa meno zamestnanca odošle do databázy.
V kóde naprample pod veľkosťou lun sa načíta a prevedie na hodnotu ASCII.
*/
importPackage(org.apache.log4j);
importPackage(java.lang);
importPackage(java.util);
var size = page.getValue(id + “.lunSize”);
var logger = Logger.getLogger(“môj zapisovač”);
if(veľkosť != null){
logger.info(“Hodnota veľkosti “+veľkosť);
if((new java.lang.String(size)).matches(“\\d+”)){ var byteValue = size.getBytes(“US-ASCII”); //konvertujte veľkosť lun a získajte pole znakov ASCII

var asciiValueBuilder = new StringBuilder();
for (var i = 0; i < byteValue.length; i++) {
asciiValueBuilder.append(byteValue[i]);
}
var asciiValue = asciiValueBuilder.toString()+” – Ascii
hodnota“
//id + „.lunSize“ je identifikátor vstupného poľa
page.setValue(id + “.lunSize”,asciiValue); //parameter
'page' sa používa na nastavenie hodnoty vo vstupnom poli .
pojo.setLunSize(asciiValue); //nastav hodnotu na pojo.
Toto pojo bude odoslané do DB alebo externého zariadenia
}
================================================== ================================================== =========
// Po zrušení Marshalla:
/*
Túto metódu použite na overenie a nastavenie chybového hlásenia.
*/
importPackage(org.apache.log4j);
importPackage(java.lang);
importPackage(java.util);
//veľkosť var = pojo.getLunSize();
var size = page.get Value(id + “.lunSize”);
var logger = Logger .get Logger(“môj logger”);
logger.info(“Hodnota veľkosti “+veľkosť);
if (veľkosť > 50) { //overenie veľkosti
stránku. set Error(id+).lunSize“, „Veľkosť LUN nemôže byť väčšia ako 50 MB“); //nastaviť
chybové hlásenie na stránke
page .set Page Message („Veľkosť LUN nemôže byť väčšia ako 50 MB“);
//strana. nastaviť stav stránky(2);
}

Použitie výstupu predchádzajúcej úlohy v pracovnom toku

Výstup predchádzajúcej úlohy môžete použiť ako vstup pre inú úlohu v pracovnom toku priamo zo skriptu vlastnej úlohy a úlohy Vykonať skript Cloupia knižnice úloh.
Na prístup k tomuto výstupu môžete použiť jeden z nasledujúcich spôsobov:

Získajte premennú z kontextu pracovného toku pomocou metódy get Input().
Pozrite si výstup pomocou zápisu systémových premenných.

Ak chcete získať výstup pomocou kontextovej metódy getInput(), použite:
var name = ctxt.getInput(“PreviousTaskName.outputFieldName”);

Napríkladample:
var name = ctxt.getInput(“custom_task1_1684.NAME”); // NAME je názov výstupu task1
pole, ku ktorému chcete pristupovať
Ak chcete získať výstup pomocou zápisu systémových premenných, použite:
var name = “${Názov predchádzajúcej úlohy. Názov výstupného poľa}“;

Napríkladample:
var name = “${custom_task1_1684.NAME}”; // NAME je názov výstupného poľa task1, ku ktorému chcete pristupovať

Example: Vytvorenie a spustenie vlastnej úlohy