cisco Tworzenie niestandardowych zadań przepływu pracy Podręcznik użytkownika

Cisco UCS Director Orchestrator oferuje listę dobrze zdefiniowanych typów danych wejściowych dla zadań niestandardowych. Cisco UCS Director umożliwia także utworzenie dostosowanych danych wejściowych przepływu pracy dla niestandardowego zadania przepływu pracy. Można utworzyć nowy typ danych wejściowych, klonując i modyfikując istniejący typ danych wejściowych.

Wymagania wstępne

Przed napisaniem zadań niestandardowych musisz spełnić następujące wymagania wstępne:

Cisco UCS Director jest zainstalowany i działa w Twoim systemie. Więcej informacji na temat instalacji programu Cisco UCS Director można znaleźć w Podręczniku instalacji i konfiguracji programu Cisco UCS Director.
Posiadasz login z uprawnieniami administratora. Musisz używać tego loginu podczas tworzenia i modyfikowania zadań niestandardowych.

Aby napisać zadanie niestandardowe przy użyciu CloupiaScript, musisz mieć uprawnienia do zapisu CloupiaScript.
Aby wykonać zadanie niestandardowe utworzone przy użyciu CloupiaScript, musisz mieć uprawnienia do wykonywania CloupiaScript.

Tworzenie niestandardowych danych wejściowych przepływu pracy

Można utworzyć niestandardowe dane wejściowe dla niestandardowego zadania przepływu pracy. Dane wejściowe są wyświetlane na liście typów danych wejściowych, które można zamapować na niestandardowe dane wejściowe zadań podczas tworzenia niestandardowego zadania przepływu pracy.

Krok 1 Wybierz opcję Orkiestracja.

Krok 2 Kliknij opcję Niestandardowe dane wejściowe przepływu pracy.
Krok 3 Kliknij Dodaj.

Krok 4 Na ekranie Dodaj dane wejściowe CustomWorkflow wypełnij następujące pola:
- Nazwa niestandardowego typu wprowadzania — unikalna nazwa niestandardowego typu wprowadzania.
- Typ wejścia — sprawdź typ wejścia i kliknij Wybierz. W zależności od wybranych danych wejściowych pojawiają się inne pola. Na przykładample, jeśli jako typ danych wejściowych wybierzesz Adres e-mail, pojawi się lista wartości (LOV). Użyj nowych pól, aby ograniczyć wartości niestandardowych danych wejściowych.
Krok 5 Kliknij Prześlij.

Niestandardowe dane wejściowe przepływu pracy zostały dodane do Cisco UCS Director i są dostępne na liście typów danych wejściowych.

Niestandardowa weryfikacja danych wejściowych

Klienci mogą potrzebować zweryfikować dane wejściowe przepływu pracy przy użyciu zasobów zewnętrznych. Po wyjęciu z pudełka Cisco UCS Director nie jest w stanie spełnić potrzeb każdego klienta w zakresie walidacji. Aby wypełnić tę lukę, Cisco UCS Director udostępnia opcję sprawdzania poprawności wszelkich danych wejściowych w czasie wykonywania za pomocą skryptu dostarczonego przez klienta. Skrypt może oznaczać błędy na danych wejściowych i może wymagać poprawnych danych wejściowych przed uruchomieniem żądania usługi. Skrypt może być napisany w dowolnym języku, może uzyskać dostęp do dowolnych zasobów zewnętrznych i ma dostęp do wszystkich wartości wejściowych przepływu pracy.
Możesz pisać niestandardowe skrypty sprawdzające przy użyciu JavaScript, Python, skryptu powłoki bash lub dowolnego innego języka skryptowego.

Następujący exampskrypty sprawdzające pliki można znaleźć w Cisco UCS Director w opcji Orkiestracja > Niestandardowe dane wejściowe przepływu pracy:

Exampwalidator skryptów le-bash

ExampWalidator le-javascript
Exampwalidator le-python

Możesz skopiować lub sklonować plik example skryptowe dane wejściowe przepływu pracy, aby utworzyć nowe zweryfikowane dane wejściowe. Możesz także użyć example skryptowe dane wejściowe przepływu pracy jako przewodnik do tworzenia własnych skryptów.

Niezależnie od języka skryptowego, do sprawdzania poprawności niestandardowych danych wejściowych za pomocą skryptu mają zastosowanie następujące funkcje i reguły:

Cała weryfikacja skryptowa jest uruchamiana w oddzielnym procesie, więc niepowodzenie procesu sprawdzania poprawności nie ma wpływu na proces Cisco UCS Director.
Za pomocą skryptów można sprawdzać tylko ogólne wprowadzone dane tekstowe.

Skrypty sprawdzające są uruchamiane pojedynczo, w tej samej kolejności, w jakiej dane wejściowe pojawiają się na stronie danych wejściowych przepływu pracy. Dla każdego zweryfikowanego wejścia uruchamiany jest oddzielny proces.
Niezerowa wartość zwrócona przez skrypt wskazuje na nieudaną weryfikację. Opcjonalnie możesz przekazać komunikat o błędzie z powrotem do formularza wejściowego przepływu pracy.

Wszystkie dane wejściowe przepływu pracy są przekazywane do skryptu sprawdzającego na dwa sposoby:
- Jako argumenty skryptu w postaci „klucz”=”wartość”.
- Jako zmienne środowiskowe procesu skryptowego. Nazwy zmiennych są etykietami wejściowymi.
  Na przykładample, jeśli przepływ pracy ma dane wejściowe oznaczone jako Kod produktu, a wartość wejściowa to AbC123, zmienna jest przekazywana do skryptu walidatora jako „Kod produktu” = „AbC123”.
  Te zmienne wejściowe mogą zostać wykorzystane przez skrypt, jeśli jest to konieczne do wdrożenia walidacji. Wyjątek: wartości tabeli zawierają tylko numer wiersza wybranej tabeli i dlatego prawdopodobnie są bezużyteczne.
Strona Edytuj dane wejściowe niestandardowego przepływu pracy udostępnia skrypt w edytorze zadań niestandardowych. Składnia jest podświetlona dla wszystkich języków. Błędy składniowe są sprawdzane tylko w przypadku walidatorów JavaScript.

Klonowanie danych wejściowych niestandardowego przepływu pracy

Możesz użyć istniejących niestandardowych danych wejściowych przepływu pracy w programie Cisco UCS Director, aby utworzyć niestandardowe dane wejściowe przepływu pracy.

Zanim zaczniesz
W programie Cisco UCS Director muszą być dostępne niestandardowe dane wejściowe przepływu pracy.

Krok 1 Wybierz opcję Orkiestracja.
Krok 2 Kliknij opcję Niestandardowe dane wejściowe przepływu pracy.
Krok 3 Kliknij wiersz zawierający niestandardowe dane wejściowe przepływu pracy, które chcesz sklonować.
Ikona klonowania pojawi się u góry tabeli niestandardowych danych wejściowych przepływu pracy.
Krok 4 Kliknij opcję Klonuj.
Krok 5 Wprowadź nazwę niestandardowego typu wprowadzania.
Krok 6 Użyj innych elementów sterujących na ekranie Klonuj niestandardowe dane wejściowe przepływu pracy, aby dostosować nowe dane wejściowe.
Krok 7 Kliknij opcję Prześlij.
Dane wejściowe niestandardowego zadania przepływu pracy są klonowane po potwierdzeniu i można je wykorzystać w niestandardowym zadaniu przepływu pracy.

Tworzenie zadania niestandardowego

Aby utworzyć zadanie niestandardowe, wykonaj następujące czynności:

Krok 1 Wybierz opcję Orkiestracja.
Krok 2 Kliknij opcję Niestandardowe zadania przepływu pracy.
Krok 3 Kliknij Dodaj.
Krok 4 Na ekranie Dodaj niestandardowe zadanie przepływu pracy wypełnij następujące pola:
- Pole Nazwa zadania — unikalna nazwa niestandardowego zadania przepływu pracy.
- Pole Etykieta zadania — etykieta identyfikująca niestandardowe zadanie przepływu pracy.
- Pole Zarejestruj w kategorii — kategoria przepływu pracy, w której ma zostać zarejestrowane niestandardowe zadanie przepływu pracy.
- Pole wyboru Aktywuj zadanie — jeśli jest zaznaczone, niestandardowe zadanie przepływu pracy jest rejestrowane w programie Orchestrator i można go natychmiast używać w przepływach pracy.
- Pole Krótki opis — opis niestandardowego zadania przepływu pracy.
- Pole Opis szczegółowy — szczegółowy opis niestandardowego zadania przepływu pracy.

Krok 5 Kliknij Dalej.
Pojawi się ekran Niestandardowe dane wejściowe zadania.
Krok 6 Kliknij Dodaj.
Krok 7 Na ekranie Dodaj wpis do wejść wypełnij następujące pola:
- Pole Nazwa pola wejściowego — unikalna nazwa pola. Nazwa musi zaczynać się od znaku analfabetycznego i nie może zawierać spacji ani znaków specjalnych.
- Pole etykiety pola wejściowego — etykieta identyfikująca pole wejściowe.
- Lista rozwijana Typ pola wejściowego — wybierz typ danych parametru wejściowego.
- Pole Mapuj na typ danych wejściowych (bez mapowania) — wybierz typ danych wejściowych, na które można zamapować to pole, jeśli to pole można zamapować z danych wyjściowych innego zadania lub danych wejściowych globalnego przepływu pracy.
- Pole wyboru obowiązkowe — jeśli jest zaznaczone, użytkownik musi podać wartość w tym polu.
- Pole RBID — wprowadź ciąg RBID dla pola.
- Lista rozwijana Rozmiar pola wejściowego — wybierz rozmiar pola dla danych tekstowych i tabelarycznych.
- Pole wejściowe Pole pomocy — (opcjonalnie) opis wyświetlany po najechaniu myszką na pole.
- Pole wejściowe Pole adnotacji — (opcjonalnie) Tekst podpowiedzi dotyczącej pola wejściowego.
- Pole Nazwa grupy pól — jeśli jest określone, wszystkie pola o pasujących nazwach grup zostaną umieszczone w grupie pól.
- Obszar ATRYBUTY POLA TEKSTOWEGO — wypełnij poniższe pola, jeśli typem pola wejściowego jest tekst.
- Pole wyboru Wiele danych wejściowych — jeśli jest zaznaczone, pole wejściowe akceptuje wiele wartości w zależności od typu pola wejściowego:
- Dla LOV — pole wejściowe akceptuje wiele wartości wejściowych.
- W przypadku pola tekstowego — pole wejściowe staje się wielowierszowym polem tekstowym.
- Maksymalna długość pola wejściowego — określ maksymalną liczbę znaków, które można wprowadzić w polu wejściowym.
- Obszar ATRYBUTY LOV — wypełnij poniższe pola, jeśli typem danych wejściowych jest Lista wartości (LOV) lub LOV z przyciskami opcji.
- Pole Lista wartości — lista wartości oddzielonych przecinkami dla osadzonych obiektów LOV.
  Pole Nazwa dostawcy LOV — nazwa dostawcy LOV dla niewbudowanych LOV.
- Obszar ATRYBUTY TABELI — wypełnij poniższe pola, jeśli typem pola wejściowego jest Tabela, Tabela podręczna lub Pole wyboru Tabela z wyborem.
- Pole Nazwa tabeli — nazwa raportu tabelarycznego dla typów pól tabeli.
- Obszar WALIDACJA WPROWADZONYCH POLÓW — w zależności od wybranego typu danych wyświetlane jest jedno lub więcej z poniższych pól. Wypełnij pola, aby określić sposób sprawdzania poprawności pól wejściowych.
- Lista rozwijana Walidator danych wejściowych — wybierz moduł sprawdzający dane wejściowe użytkownika.
- Pole Wyrażenie regularne — wzorzec wyrażenia regularnego, do którego należy dopasować wartość wejściową.
- Pole komunikatu wyrażenia regularnego — komunikat wyświetlany w przypadku niepowodzenia sprawdzania wyrażenia regularnego.
- Pole Wartość minimalna — minimalna wartość liczbowa.
- Pole Wartość maksymalna — maksymalna wartość liczbowa.
- Obszar UKRYJ W WARUNKU POLA — wypełnij poniższe pola, aby ustawić warunek ukrywania pola w formularzu.
- Pole Ukryj w nazwie pola — wewnętrzna nazwa pola, dzięki której program obsługujący formularz może zidentyfikować pole.
- Ukryj w polu Wartość pola — wartość, która ma zostać wysłana po przesłaniu formularza.
- Lista rozwijana Ukryj w warunku pola — wybierz warunek, w którym pole ma zostać ukryte.
- Pole pomocy HTML — instrukcje pomocy dotyczące ukrytego pola.

Krok 8 Kliknij opcję Prześlij.
Wpis wejściowy zostanie dodany do tabeli.
Krok 9 Kliknij przycisk Dodaj, aby dodać więcej wpisów do danych wejściowych.
Krok 10 Po zakończeniu dodawania danych wejściowych kliknij przycisk Dalej.
Zostanie wyświetlony ekran Wyniki niestandardowych zadań przepływu pracy.

Krok 11 Kliknij Dodaj.
Krok 12 Na ekranie Dodaj wpis do wyników wypełnij następujące pola:
- Pole nazwy pola wyjściowego — unikalna nazwa pola wyjściowego. Musi zaczynać się od znaku alfabetu i nie może zawierać spacji ani znaków specjalnych.
- Pole opisu pola wyjściowego — opis pola wyjściowego.
- Pole typu pola wyjściowego — sprawdź typ wyniku. Ten typ określa, w jaki sposób dane wyjściowe mogą być mapowane na dane wejściowe innych zadań.
Krok 13 Kliknij opcję Prześlij.
Wpis wyjściowy zostanie dodany do tabeli.

Krok 14 Kliknij przycisk Dodaj, aby dodać więcej wpisów do wyników.
Krok 15 Kliknij Dalej
Pojawi się ekran Kontrolera
Krok 16 (Opcjonalnie) Kliknij Dodaj, aby dodać kontroler.

Krok 17 Na ekranie Dodaj wpis do kontrolera wypełnij następujące pola:
- Lista rozwijana Metoda — wybierz metodę zestawiania lub usuwania zestawiania, aby dostosować dane wejściowe i/lub wyjściowe dla niestandardowego zadania przepływu pracy. Metoda może być jedną z następujących:
- Przed Marshallem — użyj tej metody, aby dodać lub ustawić pole wejściowe oraz dynamicznie utworzyć i ustawić wartość LOV na stronie (formularzu).
- After Marshall — użyj tej metody, aby ukryć lub odkryć pole wejściowe.
- Przed Unmarshall — użyj tej metody, aby przekonwertować wartość wejściową z jednej formy na inną — npample, jeśli chcesz zaszyfrować hasło przed wysłaniem go do bazy danych.
- Po Unmarshall — użyj tej metody, aby zweryfikować dane wprowadzone przez użytkownika i ustawić komunikat o błędzie na stronie.
  Zobacz przykładampna: Korzystanie z kontrolerów, na stronie 14.
- Obszar tekstu skryptu — w przypadku metody wybranej z listy rozwijanej Metoda dodaj kod skryptu dostosowywania interfejsu GUI.
  Notatka Kliknij Dodaj, jeśli chcesz dodać kod dla większej liczby metod.
  Jeśli wprowadzone hasła są sprawdzane, pamiętaj o zmianie sprawdzania poprawności haseł przez kontroler, aby móc edytować zadania niestandardowe w przepływach pracy.
  Notatka
Krok 18 Kliknij opcję Prześlij.
Kontroler zostanie dodany do tabeli.
Krok 19 Kliknij Dalej.
Pojawi się ekran Skrypt.

Krok 20 Z listy rozwijanej Język wykonania wybierz język.
Krok 21 W polu Skrypt wprowadź kod CloupiaScript dla niestandardowego zadania przepływu pracy.
Kod skryptu Cloupia jest sprawdzany po jego wprowadzeniu. Jeśli w kodzie wystąpi błąd, obok numeru wiersza wyświetlana jest ikona błędu (czerwony krzyżyk). Najedź myszką na ikonę błędu, aby view komunikat o błędzie i rozwiązanie
Krok 22 Kliknij opcję Zapisz skrypt.

Krok 23 Kliknij opcję Prześlij.
Niestandardowe zadanie przepływu pracy zostanie utworzone i będzie dostępne do użycia w przepływie pracy

Niestandardowe zadania i repozytoria

Kiedy tworzysz zadanie niestandardowe, zamiast wpisywać niestandardowy kod zadania w oknie skryptu lub wycinać i wklejać kod z edytora tekstu, możesz zaimportować kod z file przechowywane w repozytorium GitHub lub BitBucket. Aby to zrobić:

Utwórz jeden lub więcej tekstów files w repozytorium GitHub lub BitBucket, na github.com lub w prywatnym repozytorium GitHub przedsiębiorstwa.
Uwaga Cisco UCS Director obsługuje tylko GitHub (github.com lub instancję GitHub dla przedsiębiorstw) i/lub BitBucket. Nie obsługuje innych usług hostingowych Git, w tym GitLab, Perforce lub Codebase.

Zarejestruj repozytorium w Cisco UCS Director. Zobacz Dodawanie repozytorium GitHub lub BitBucket w programie Cisco UCS Director, na stronie 7.
Wybierz repozytorium i określ tekst file który zawiera niestandardowy skrypt zadania. Zobacz Pobieranie niestandardowego kodu skryptu zadania z repozytorium GitHub lub BitBucket, na stronie 8.

Dodanie repozytorium GitHub lub BitBucket w Cisco UCS Director
Aby zarejestrować repozytorium GitHub lub BitBucket w Cisco UCS Director, wykonaj następujące czynności:

Zanim zaczniesz
Utwórz repozytorium GitHub lub BitBucket. Repozytorium może znajdować się na dowolnym serwerze GitHub lub BitBucket, publicznym lub prywatnym, do którego można uzyskać dostęp z poziomu Cisco UCS Director.
Zamelduj się w jednym lub kilku files zawierający kod JavaScript dla niestandardowych zadań do swojego repozytorium.

Krok 1 Wybierz Administracja > Integracja.
Krok 2 Na stronie Integracja kliknij Zarządzaj repozytoriami.

Krok 3 Kliknij Dodaj.
Krok 4 Na stronie Dodaj repozytorium wypełnij wymagane pola, w tym następujące:
- W polu Pseudonim repozytorium wprowadź nazwę identyfikującą repozytorium w programie Cisco UCS Director.
- W Repozytorium URL w polu wprowadź URL repozytorium GitHub lub BitBucket.
- W polu Branch Name wpisz nazwę gałęzi repozytorium, której chcesz użyć. Domyślna nazwa to gałąź główna.
- W polu Użytkownik repozytorium wprowadź nazwę użytkownika swojego konta GitHub lub BitBucket.
- Aby dodać repozytorium GitHub, w polu Hasło/API Token wpisz wygenerowany token API dla Twojego GitHuba.
  Aby wygenerować token API za pomocą GitHub, kliknij Ustawienia i przejdź do Ustawienia programisty > Osobiste tokeny dostępu, a następnie kliknij Wygeneruj nowy token.
  Aby dodać repozytorium BitBucket, w polu Hasło/API Token wpisz hasło do swojego BitBucketa.
- Aby domyślnie używać tego repozytorium podczas tworzenia nowego zadania niestandardowego, zaznacz opcję Ustaw to moje repozytorium domyślne.
- Aby sprawdzić, czy Cisco UCS Director może uzyskać dostęp do repozytorium, kliknij opcję Testuj łączność.
  Stan połączenia z repozytorium wyświetlany jest na banerze u góry strony.
  Jeśli nie możesz połączyć się i komunikować z repozytorium GitHub lub BitBucket z Cisco UCS
  Dyrektorze, zaktualizuj Cisco UCS Director, aby uzyskać dostęp do Internetu za pośrednictwem serwera proxy. Zobacz Podręcznik administratora Cisco UCS Director.
  Notatka

Krok 5 Po upewnieniu się, że informacje o repozytorium są prawidłowe, kliknij przycisk Prześlij.

Pobieranie niestandardowego kodu skryptu zadania z repozytorium GitHub lub BitBucket

Aby utworzyć nowe zadanie niestandardowe, importując tekst z repozytorium GitHub lub BitBucket, wykonaj następujące czynności:

Zanim zaczniesz
Utwórz repozytorium GitHub lub BitBucket i zaewidencjonuj jeden lub więcej tekstów files zawierający kod JavaScript dla niestandardowych zadań do swojego repozytorium.

Dodaj repozytorium GitHub do Cisco UCS Director. Zobacz Dodawanie repozytorium GitHub lub BitBucket w Cisco UCS Director, na stronie

Krok 1 Na stronie Orkiestracja kliknij opcję Niestandardowe zadania przepływu pracy.

Krok 2 Kliknij Dodaj.
Krok 3 Wypełnij wymagane pola na stronie Informacje o zadaniu niestandardowym. Zobacz Tworzenie zadania niestandardowego, na stronie 3.
Krok 4 Wypełnij wymagane pola na stronie Niestandardowe dane wejściowe zadania. Zobacz Tworzenie zadania niestandardowego, na stronie 3.

Krok 5 Wypełnij wymagane pola na stronie Wyniki zadań niestandardowych. Zobacz Tworzenie zadania niestandardowego, na stronie 3.
Krok 6 Wypełnij wymagane pola na stronie Kontroler. Zobacz Tworzenie zadania niestandardowego, na stronie 3.
Krok 7 Na stronie Skrypt wypełnij wymagane pola:
- Z listy rozwijanej Język wykonania wybierz opcję JavaScript.
- Zaznacz opcję Użyj repozytorium dla skryptów, aby umożliwić niestandardowemu zadaniu korzystanie ze skryptu file z repozytorium. Dzięki temu możesz wybrać repozytorium i określić skrypt file używać.
- Z listy rozwijanej Wybierz repozytorium wybierz repozytorium GitHub lub BitBucket zawierające skrypt fileS. Aby uzyskać szczegółowe informacje na temat dodawania repozytoriów, zobacz Dodawanie repozytorium GitHub lub BitBucket w programie Cisco UCS Director, na stronie 7.
- Wpisz pełną ścieżkę do skryptu file w Skrypcie filepole tekstowe nazwy.
- Aby pobrać skrypt, kliknij opcję Załaduj skrypt.
  Tekst z file jest kopiowany w obszarze edycji tekstu skryptu.
- Opcjonalnie wprowadź zmiany w pobranym skrypcie w obszarze edycji tekstu skryptu.
- Aby zapisać skrypt w postaci, w jakiej pojawia się w obszarze edycji tekstu skryptu, kliknij Zapisz skrypt.
  Po naciśnięciu przycisku Zapisz skrypt skrypt zostanie zapisany w bieżącej sesji roboczej. Aby zapisać skrypt w edytowanym zadaniu niestandardowym, należy kliknąć przycisk Prześlij.
  Notatka
Krok 8 Aby zapisać zadanie niestandardowe, kliknij opcję Prześlij.
Jeśli dokonałeś zmian w pobranym skrypcie w obszarze edycji tekstu skryptu, zmiany zostaną zapisane w zadaniu niestandardowym. Żadne zmiany nie są zapisywane w repozytorium GitHub ani BitBucket. Jeśli chcesz odrzucić załadowany skrypt i wprowadzić własny, kliknij opcję Odrzuć skrypt, aby wyczyścić okno skryptu.

Co robić dalej
Możesz użyć nowego zadania niestandardowego w przepływie pracy.

Importowanie przepływów pracy, zadań niestandardowych, modułów skryptów i działań

Aby zaimportować artefakty do programu Cisco UCS Director, wykonaj następujące czynności:

Notatka Zmienne globalne powiązane z obiegiem zostaną zaimportowane podczas importu obiegu, jeżeli zmienna globalna nie jest dostępna w urządzeniu.

Krok 1 Wybierz opcję Orkiestracja.

Krok 2 Na stronie Orkiestracja kliknij opcję Przepływy pracy.
Krok 3 Kliknij opcję Importuj.
Krok 4 Na ekranie Importuj kliknij opcję Wybierz a File.

Krok 5 Wybierz File aby wyświetlić ekran Prześlij, wybierz file być importowane. Import i eksport Cisco UCS Director filemają plik .wfdx file rozszerzenie.
Krok 6 Kliknij Otwórz.
Kiedy file zostanie przesłany, plik File Zostanie wyświetlony ekran przesyłania/weryfikacji File gotowy do użycia i klucz.
Krok 7 Wprowadź klucz, który został wprowadzony podczas eksportowania pliku file.

Krok 8 Kliknij Dalej.
Na ekranie Importuj zasady wyświetlana jest lista obiektów Cisco UCS Director zawartych w przesłanym pliku file.
Krok 9 (Opcjonalnie) Na ekranie Zasady importu określ sposób postępowania z obiektami, jeśli ich nazwy powtarzają się już w folderze przepływu pracy. Na ekranie Importuj wypełnij poniższe pola

Nazwa	Opis
Przepływy pracy	Wybierz jedną z następujących opcji, aby określić sposób obsługi przepływów pracy o identycznych nazwach: Zastępować— Zastąp istniejący przepływ pracy zaimportowanym przepływem pracy. Zatrzymaj oba—Zaimportuj przepływ pracy jako nową wersję. Pominąć— Nie importuj przepływu pracy.
Zadania niestandardowe	Wybierz jedną z następujących opcji, aby określić sposób obsługi zadań niestandardowych o identycznych nazwach: Zastępować Zatrzymaj oba Pominąć

Nazwa	Opis
Moduły skryptów	Wybierz jedną z poniższych opcji, aby określić sposób obsługi modułów skryptów o identycznych nazwach: Zastępować Zatrzymaj oba Pominąć
Aktywności	Wybierz jedną z następujących opcji, aby określić sposób obsługi czynności o identycznych nazwach: Zastępować Zatrzymaj oba Pominąć
Importuj przepływy pracy do folderu	Check Importuj przepływy pracy do folderu, aby zaimportować przepływy pracy. Jeśli nie zaznaczysz opcji Importuj przepływy pracy do folderu i nie ma istniejącej wersji przepływu pracyw istnieje, ten przepływ pracy nie jest importowany.
Wybierz folder	Wybierz folder, do którego chcesz zaimportować przepływy pracy. Jeśli wybrałeś [Nowy Teczka..] na liście rozwijanej plik Nowy folder pojawia się pole.
Nowy folder	Wprowadź nazwę nowego folderu, który chcesz utworzyć jako folder importu.

Krok 10 Kliknij opcję Importuj.

Eksportowanie przepływów pracy, zadań niestandardowych, modułów skryptów i działań

Aby wyeksportować artefakty z programu Cisco UCS Director, wykonaj następujące czynności:

Uwaga Zmienne globalne powiązane z przepływem pracy zostaną automatycznie wyeksportowane podczas eksportowania przepływu pracy.

Krok 1 Kliknij opcję Eksportuj.
Krok 2 Na ekranie Wybierz przepływy pracy wybierz przepływy pracy, które chcesz wyeksportować.
Niestandardowe przepływy pracy, zadania i skrypty utworzone w programie Cisco UCS Director przed wersją 6.6 mogą nie zostać zaimportowane, jeśli zawierają dane XML.
Notatka
Krok 3 Kliknij Dalej.
Krok 4 Na ekranie Wybierz zadania niestandardowe wybierz zadania niestandardowe, które chcesz zaprezentować
Uwaga Wyeksportowane zadanie niestandardowe zawiera wszystkie niestandardowe dane wejściowe używane przez to zadanie niestandardowe.
Krok 5 Kliknij Dalej.
Krok 6 Na ekranie Eksportuj: Wybierz moduły skryptów wybierz moduły skryptów, które chcesz wyeksportować.
Krok 7 Kliknij Dalej.
Krok 8 Na ekranie Eksportuj: Wybierz działania wybierz działania, które chcesz wyeksportować.
Krok 9 Kliknij Dalej.
Krok 10 Na ekranie Eksportuj: Wybierz otwarte interfejsy API wybierz interfejsy API, które chcesz wyeksportować.
Krok 11 Na ekranie Eksport: Potwierdzenie wypełnij następujące pola:

Nazwa	Opis
Eksportowane przez	Twoje imię i nazwisko lub informacja o tym, kto jest odpowiedzialny za eksport.
Uwagi	Komentarze na temat tego eksportu.
Zaszyfruj wyeksportowany plik file	Zaznacz opcję Zaszyfruj wyeksportowany file pole wyboru, aby zaszyfrować plik file zostać wyeksportowany. Domyślnie pole wyboru jest zaznaczone.
Klawisz	Wprowadź klucz do szyfrowania pliku file. To pole jest wyświetlane tylko wtedy, gdy opcja Zaszyfruj eksportowany plik file pole wyboru jest zaznaczone. Zachowaj klucz, ponieważ jest potrzebny podczas importowania przepływu pracy w celu odszyfrowania.
Potwierdź klucz	Wprowadź klucz ponownie w celu potwierdzenia. To pole jest wyświetlane tylko wtedy, gdy opcja Zaszyfruj eksportowany plik file pole wyboru jest zaznaczone.
Eksportowano File Nazwa	Nazwa file w systemie lokalnym. Wpisz tylko podstawę filenazwa; the file rozszerzenie typu (.wfdx) jest dodawane automatycznie.

Krok 12 Kliknij opcję Eksportuj.
Zostanie wyświetlony monit o zapisanie pliku file.

Klonowanie niestandardowego zadania przepływu pracy z biblioteki zadań

Możesz klonować zadania w bibliotece zadań i używać ich do tworzenia niestandardowych zadań. Możesz także sklonować zadanie niestandardowe, aby utworzyć zadanie niestandardowe.

Sklonowane zadanie to struktura z tymi samymi danymi wejściowymi i wyjściowymi zadania, co zadanie oryginalne. Jednak sklonowane zadanie jest tylko strukturą. Oznacza to, że musisz napisać całą funkcjonalność nowego zadania w CloupiaScript.

Należy również pamiętać, że wartości wyboru dla danych wejściowych list, takich jak listy rozwijane i listy wartości, są przenoszone do sklonowanego zadania tylko wtedy, gdy wartości list nie są zależne od systemu. Takie rzeczy jak nazwy i adresy IP istniejących systemów zależą od systemu; takie rzeczy jak opcje konfiguracji obsługiwane przez Cisco UCS Director nie są. Na przykładampplik, grupy użytkowników, nazwy chmur i grupy portów zależą od systemu; role użytkowników, typy chmur i typy grup portów nie są.

Krok 1 Wybierz opcję Orkiestracja.
Krok 2 Kliknij opcję Niestandardowe zadania przepływu pracy.
Krok 3 Kliknij opcję Klonuj z biblioteki zadań.
Krok 4 Na ekranie Klonuj z biblioteki zadań zaznacz wiersz zawierający zadanie, które chcesz sklonować.
Krok 5 Kliknij Wybierz.
Niestandardowe zadanie przepływu pracy jest tworzone z biblioteki zadań. Nowe zadanie niestandardowe jest ostatnim zadaniem niestandardowym w raporcie Niestandardowe zadania przepływu pracy. Nowe zadanie niestandardowe nosi nazwę sklonowanego zadania z dołączoną datą.
Krok 6 Kliknij opcję Prześlij

Co robić dalej
Edytuj niestandardowe zadanie przepływu pracy, aby upewnić się, że sklonowane zadanie ma odpowiednią nazwę i opis.

Klonowanie niestandardowego zadania przepływu pracy

Możesz użyć istniejącego niestandardowego zadania przepływu pracy w programie Cisco UCS Director, aby utworzyć niestandardowe zadanie przepływu pracy.

Zanim zaczniesz
W programie Cisco UCS Director musi być dostępne niestandardowe zadanie przepływu pracy.

Krok 1 Wybierz opcję Orkiestracja.
Krok 2 Kliknij opcję Niestandardowe zadania przepływu pracy.
Krok 3 Kliknij wiersz z niestandardowym zadaniem przepływu pracy, które chcesz sklonować.
Ikona klonowania pojawi się u góry tabeli niestandardowych zadań przepływu pracy.
Krok 4 Kliknij opcję Klonuj.
Krok 5 Na ekranie Clone Custom Workflow Zadanie zaktualizuj wymagane pola.
Krok 6 Kliknij Dalej.
Pojawią się dane wejściowe zdefiniowane dla niestandardowych zadań przepływu pracy.
Krok 7 Kliknij wiersz z danymi wejściowymi zadania, które chcesz edytować, a następnie kliknij Edytuj, aby edytować dane wejściowe zadania.
Krok 8 Kliknij przycisk Dodaj, aby dodać wpis wejściowy zadania.
Krok 9 Kliknij Dalej.
Edytuj wyniki zadania.
Krok 10 Kliknij przycisk Dodaj, aby dodać nowy wpis wyjściowy.
Krok 11 Kliknij Dalej.
Krok 12 Edytuj skrypty kontrolera. Zobacz Kontrolowanie danych wejściowych zadań niestandardowego przepływu pracy, na stronie 13.
Krok 13 Kliknij Dalej.
Krok 14 Aby dostosować zadanie niestandardowe, dokonaj edycji skryptu zadania.
Krok 15 Kliknij opcję Prześlij

Kontrolowanie danych wejściowych niestandardowych zadań przepływu pracy

Korzystanie z kontrolerów
Możesz modyfikować wygląd i zachowanie niestandardowych danych wejściowych zadań za pomocą interfejsu kontrolera dostępnego w Cisco UCS Director.

Kiedy używać kontrolerów
Użyj kontrolerów w następujących scenariuszach:

Aby zaimplementować złożone zachowanie pokazywania i ukrywania GUI, w tym lepszą kontrolę list wartości, tabelarycznych list wartości i innych elementów sterujących danymi wejściowymi wyświetlanymi użytkownikowi.
Aby zaimplementować złożoną logikę sprawdzania poprawności danych wejściowych użytkownika.

Za pomocą kontrolerów wejściowych możesz wykonać następujące czynności:

Pokaż lub ukryj elementy sterujące GUI: Możesz dynamicznie pokazywać lub ukrywać różne pola GUI, takie jak pola wyboru, pola tekstowe, listy rozwijane i przyciski, w zależności od warunków. Na przykładample, jeśli użytkownik wybierze UCSM z listy rozwijanej, możesz wyświetlić monit o podanie poświadczeń użytkownika dla Cisco UCS Manager lub zmienić listę wartości (LOV) na liście rozwijanej, aby pokazywały tylko dostępne porty na serwerze.
Walidacja pola formularza: Możesz sprawdzić dane wprowadzone przez użytkownika podczas tworzenia lub edytowania przepływów pracy w Projektancie przepływu pracy. W przypadku nieprawidłowych danych wprowadzonych przez użytkownika mogą zostać pokazane błędy. Dane wejściowe użytkownika można zmienić przed ich utrwaleniem w bazie danych lub przed utrwaleniem na urządzeniu.
Dynamicznie pobieraj listę wartości: możesz dynamicznie pobierać listę wartości z obiektów Cisco UCS Director i używać ich do wypełniania obiektów formularzy GUI.

Marshallowanie i unmarshalling obiektów formularzy GUI
Kontrolery są zawsze powiązane z formularzem w interfejsie wprowadzania zadań Workflow Designer. Istnieje mapowanie jeden do jednego pomiędzy formularzem a kontrolerem. Kontrolery pracują w trybie dwóch stages, zestawianie i unmarshalling. Obydwa stagmają dwa subwooferytages, przed i po. Aby użyć kontrolera, należy zestawić (kontrolować pola formularzy interfejsu użytkownika) i/lub rozmasować (sprawdzić dane wejściowe użytkownika) powiązane obiekty formularza GUI za pomocą skryptów kontrolera.

Poniższa tabela podsumowuje te stagt.j.

Stage	Pod-stage
Przetaczanie — Służy do ukrywania i odkrywania pól formularzy oraz do zaawansowanej kontroli LOV i tabelarycznych LOV.	przed Marshallem — Służy do dodawania lub ustawiania pola wejściowego oraz dynamicznego tworzenia i ustawiania wartości LOV na stronie (formularzu). po Marshallu — Służy do ukrywania lub odkrywania pola wejściowego.

Stage	Pod-stage
Niemarszałkowy – Służy do sprawdzania poprawności danych wejściowych użytkownika.	przed Unmarshallem — Służy do konwersji wartości wejściowej z jednej formy na inną, npample, aby zaszyfrować hasło przed wysłaniem go do bazy danych. po Unmarshallu — Służy do sprawdzania danych wprowadzonych przez użytkownika i ustawiania komunikatu o błędzie na stronie.

Skrypty kontrolera budowania
Kontrolery nie wymagają importu żadnych dodatkowych pakietów.
Nie przekazujesz parametrów do metod kontrolera. Zamiast tego środowisko Cisco UCS Director udostępnia następujące parametry do wykorzystania podczas zestawiania i usuwania zestawiania:

Parametr	Opis	Example
Strona	Strona lub formularz zawierający wszystkie dane wejściowe zadania. Za pomocą tego parametru można wykonać następujące czynności: Pobierz lub ustaw wartości wejściowe w formularzu GUI. Pokaż lub ukryj dane wejściowe w formularzu GUI.	page.setHidden(id + „.portList”, true); page.setValue(id + „.status”, „Żaden port nie jest aktywny. Lista portów jest ukryta”);
id	Unikalny identyfikator pola wejściowego formularza. Identyfikator jest generowany przez platformę i może być używany z nazwą pola wejściowego formularza.	page.setValue(id + „.status”, „Żaden port nie jest aktywny. Lista portów jest ukryta”);// tutaj „status” jest nazwą pola wejściowego.
Pojo	POJO (zwykły stary obiekt Java) to komponent Java reprezentujący formularz wejściowy. Każda strona GUI musi mieć odpowiedni POJO przechowujący wartości z formularza. POJO służy do utrwalania wartości w bazie danych lub wysyłania wartości do urządzenia zewnętrznego.	pojo.setLunSize(asciiValue); //ustaw wartość pola wejściowego „lunSize”

Zobacz przykładampna: Używanie kontrolerów, na stronie 14 znajdziesz działający kod sampplik demonstrujący funkcjonalność kontrolera.

Example: Korzystanie z kontrolerów

Poniższy kod exampPlik demonstruje, jak zaimplementować funkcjonalność kontrolera w niestandardowych zadaniach przepływu pracy przy użyciu różnych metod — przed Marshallem, po Marshallu, przed Unmarshall i po Unmarshall.
/*

Opisy metod:
Przed Marshallem: Użyj tej metody, aby dodać lub ustawić pole wejściowe oraz dynamicznie utworzyć i ustawić LOV na stronie (formularzu).
Po Marshallu: Użyj tej metody, aby ukryć lub odkryć pole wejściowe.
Przed UnMarshall: Użyj tej metody, aby przekonwertować wartość wejściową z jednej formy na inną,
na przykładample, jeśli chcesz zaszyfrować hasło przed wysłaniem go do bazy danych. Po UnMarshall: Użyj tej metody, aby sprawdzić poprawność danych wprowadzonych przez użytkownika i ustawić komunikat o błędzie w pliku
strona.
*/
//Przed Marshallem:
/*
Użyj metody beforeMarshall, gdy nastąpi zmiana w polu wejściowym lub aby dynamicznie tworzyć LOV i ustawić nowe pole wejściowe w formularzu przed jego załadowaniem.
W byłymampPlik poniżej, przed wyświetleniem formularza w przeglądarce, na stronie dodane zostanie nowe pole wejściowe 'portList'.
*/
importPackage(com.cloupia.model.cIM);
importPakiet(java.util);
importPakiet(java.lang);
var portList = nowa ArrayList();
var lovLabel = „eth0”;
var lovValue = „eth0”;
var portListLOV = nowa tablica();
portListLOV[0] = new FormLOVPair(lovLabel, lovValue);//utwórz pole wejściowe lov
//parametr 'strona' służy do ustawienia pola wejściowego w formularzu
page.setEmbeddedLOVs(id + „.portList”, portListLOV);// ustaw pole wejściowe na formularzu =========================== ================================================== ================================
//Po Marshallu:
/*
Użyj tej metody, aby ukryć lub odkryć pole wejściowe.
*/
page.setHidden(id + „.portList”, true); //ukryj pole wejściowe „portList”.
page.setValue(id + „.status”, „Żaden port nie jest aktywny. Lista portów jest ukryta”);
page.setEditable(id + „.status”, false);
================================================== ================================================== =========
//Przed Unmarshallem:
/*
Użyj metody beforeUnMarshall, aby odczytać dane wprowadzone przez użytkownika i przekonwertować je na inną formę przed wstawieniem do bazy danych. Na przykładample, możesz odczytać hasło i zapisać je w bazie danych po konwersji na kodowanie base64 lub odczytać nazwisko pracownika i przekonwertować je na identyfikator pracownika, gdy nazwisko pracownika zostanie przesłane do bazy danych.
W kodzie npampPlik poniżej rozmiaru lun jest odczytywany i konwertowany na wartość ASCII.
*/
importPakiet(org.apache.log4j);
importPakiet(java.lang);
importPakiet(java.util);
var rozmiar = page.getValue(id + „.lunSize”);
var logger = Logger.getLogger(“mój rejestrator”);
if(rozmiar != null){
logger.info(“Wartość rozmiaru “+rozmiar);
if((new java.lang.String(size)).matches(“\\d+”)){ var byteValue = size.getBytes(“US-ASCII”); //przekonwertuj rozmiar lun i uzyskaj tablicę znaków ASCII

var asciiValueBuilder = nowy StringBuilder();
for (var i = 0; i < wartość bajtu.długość; i++) {
asciiValueBuilder.append(byteValue[i]);
}
var asciiValue = asciiValueBuilder.toString()+” – Ascii
wartość"
//id + „.lunSize” to identyfikator pola wejściowego
page.setValue(id + „.lunSize”, asciiValue); //parametr
„strona” służy do ustawiania wartości w polu wejściowym.
pojo.setLunSize(asciiValue); //ustaw wartość w pojo.
To pojo zostanie wysłane do bazy danych lub urządzenia zewnętrznego
}
================================================== ================================================== =========
// Po unMarshall:
/*
Użyj tej metody, aby sprawdzić poprawność i ustawić komunikat o błędzie.
*/
importPakiet(org.apache.log4j);
importPakiet(java.lang);
importPakiet(java.util);
//var size = pojo.getLunSize();
var rozmiar = wartość page.get (id + „.lunSize”);
var logger = Rejestrator .get Logger(„mój rejestrator”);
logger.info(“Wartość rozmiaru “+rozmiar);
if (size > 50) { //weryfikacja rozmiaru
strona. set Error(id+.lunSize”, „Rozmiar jednostki LUN nie może być większy niż 50MB”); //ustawić
komunikat o błędzie na stronie
strona .set Wiadomość strony („Rozmiar jednostki LUN nie może być większy niż 50 MB”);
//strona. ustaw Stan Strony(2);
}

Korzystanie z wyników poprzedniego zadania w przepływie pracy

Możesz użyć wyników poprzedniego zadania jako danych wejściowych dla innego zadania w przepływie pracy bezpośrednio ze skryptu zadania niestandardowego i zadania Wykonaj skrypt Cloupia z biblioteki zadań.
Aby uzyskać dostęp do tego wyniku, możesz skorzystać z jednego z następujących sposobów:

Pobierz zmienną z kontekstu przepływu pracy za pomocą metody get Input().
Odnieś się do wyników, używając notacji zmiennych systemowych.

Aby pobrać dane wyjściowe za pomocą metody kontekstowej getInput(), użyj:
nazwa var = ctxt.getInput(“NazwaPoprzedniego Zadania.NazwaPolaWyjściowego”);

Na przykładampna:
nazwa var = ctxt.getInput(“niestandardowe_zadanie1_1684.NAZWA”); // NAZWA to nazwa wyniku zadania 1
pole, do którego chcesz uzyskać dostęp
Aby pobrać dane wyjściowe przy użyciu notacji zmiennych systemowych, użyj:
var name = „${Poprzednia nazwa zadania. nazwa pola wyjściowego}”;

Na przykładampna:
nazwa var = „${custom_task1_1684.NAME}”; // NAZWA to nazwa pola wyjściowego zadania 1, do którego chcesz uzyskać dostęp

Example: Tworzenie i uruchamianie zadania niestandardowego