Korzystanie ze skonwertowanych aplikacji Alteryx

PlaidCloud konwertuje pytania aplikacji analitycznych Alteryx na kontrolowane zmienne przepływu pracy. Użytkownicy mogą ustawić te zmienne przed uruchomieniem, a następnie PlaidCloud stosuje wartości do formuł, filtrów, ścieżek plików, warunków, parametrów makr i ustawień kolejnych kroków.

Interfejs App Runner

Konwersja aplikacji analitycznej Alteryx (.yxwz) materializuje też jej interfejs jako opublikowany „App Runner” w Panel — działający formularz wejściowy, który zbiera te same wartości co pytania w Alteryx i uruchamia z nimi skonwertowany przepływ pracy. Ten interfejs otrzymujesz automatycznie w ramach konwersji; aplikacja bez widżetów wejściowych jest pomijana.

Pytania aplikacji stają się kontrolkami App Runner: tekst, liczba, data, pole wyboru, przycisk opcji, lista rozwijana, pole listy, drzewo, przeglądanie plików i przeglądanie folderów. Każda kontrolka zapisuje do zmiennej przepływu pracy, którą odczytuje skonwertowany krok, więc uruchomienie z App Runner napędza tę samą logikę co ręczne ustawienie zmiennych. Kontrolka, która nie wiąże się z prawdziwą zmienną przepływu pracy, jest pokazywana z widoczną uwagą, zamiast po cichu zbierać wartość, która trafia donikąd — przejrzyj ją i wskaż zamierzoną zmienną.

Formularz jest ułożony według własnego grupowania autora aplikacji — kart i opisanych ramek, w których autor zbudował aplikację — a tekst objaśniający autora (narzędzia Label z Alteryx) jest wyświetlany na formularzu obok pytań, które opisuje. Pytanie ustalone przez aplikację w czasie projektowania, takie jak Detour bez sterującego nim pytania interfejsu, nie jest w ogóle pokazywane jako pytanie.

Formularz otwiera się z wartościami zapisanymi w zmiennych przepływu pracy — domyślnymi wartościami autora, chyba że ktoś zapisał inne — a pytanie bez zapisanej wartości jest puste. Jeśli zapisana wartość nie pasuje już do żadnego z wyborów pytania, jest ignorowana, a nie pokazywana jako nieaktualny wybór. Pytanie liczbowe wymusza minimum, maksimum i krok ustawione przez autora, więc pytania ograniczonego do małego zakresu nie można odpowiedzieć poza nim.

Gdy skonwertowany przepływ pracy się rozgałęzia, App Runner pokazuje gałąź jako opisany wybór, więc ścieżkę uruchomienia wybiera się w czasie uruchamiania tak, jak wybierała ją aplikacja Alteryx.

Pytania o pliki i foldery

Każde pytanie o plik lub folder ma przycisk Przeglądaj, który otwiera przeglądarkę dokumentów, dzięki czemu wybierasz ścieżkę zamiast wpisywać ją z pamięci.

Przeglądanie oferuje konta dokumentów, do których masz dostęp, domyślnie konto własne aplikacji, i pozwala przełączać się między nimi.
Otwiera się w folderze wskazanym przez bieżącą odpowiedź na pytanie; jeśli pytanie nie ma jeszcze odpowiedzi, otwiera się na szczycie konta.
Ścieżka okruszkowa u góry pozwala wrócić wyżej. Wybranie folderu na liście otwiera go; wybranie pliku zaznacza go.
Wybierz pokazuje ścieżkę, którą wypełni, zanim ją naciśniesz. Gdy nic nie jest zaznaczone, Wybierz bierze folder, który oglądasz — w ten sposób wybierasz najwyższy poziom konta.
Jeśli nie można wyświetlić listy folderu, lista to mówi i podaje przyczynę, a Wybierz nie wypełni ścieżki, której nie widziałeś. Lista, która nie otrzyma odpowiedzi w ciągu 20 sekund, informuje, że konto nie odpowiedziało.

Uruchamianie aplikacji

Wypełnij formularz i naciśnij Uruchom.

Twoje odpowiedzi idą wraz z uruchomieniem i obowiązują tylko dla tego uruchomienia. Nigdy nie są zapisywane w przepływie pracy, więc odpowiedzi jednej osoby nigdy nie trafiają do uruchomienia innej osoby, a uruchomienie aplikacji nie wymaga prawa do zmiany przepływu pracy — co ma znaczenie w projekcie, który ogranicza wiersze, gdzie tylko jego Architekci mogą go zmieniać. Aby zmienić wartości, z którymi formularz się otwiera, zapisz je w przepływie pracy, jak poniżej.

Odpowiedzi są sprawdzane przed rozpoczęciem uruchomienia. Pytania z wyborem, na które nigdy nie odpowiedziano, zatrzymują uruchomienie przed jego rozpoczęciem i są wymieniane z nazwy, zamiast być odkrywane w połowie uruchomienia, które może trwać prawie godzinę.

Gdy uruchomienie trwa, formularz pokazuje pasek postępu, N of M steps liczone względem łącznej liczby kroków przepływu pracy, czas, który upłynął, oraz krok lub kroki uruchomione w tej chwili. Wstrzymaj i Zatrzymaj pojawiają się obok Uruchom tylko podczas trwania uruchomienia; Wstrzymaj zmienia się we Wznów, gdy uruchomienie jest wstrzymane.

Krok, który kończy się niepowodzeniem, jest wskazywany na formularzu od razu po niepowodzeniu, a gdy uruchomienie się kończy, formularz cytuje to, co zgłosił każdy nieudany krok. Nie musisz otwierać przepływu pracy, aby dowiedzieć się, dlaczego się zatrzymał. Kroki, które nie mogły się uruchomić, ponieważ krok przed nimi zakończył się niepowodzeniem, są pokazywane osobno jako nieuruchomione, a nie jako niepowodzenia, i nadal liczą się do paska postępu, więc dociera on do końca.

Uruchomienie trwa dalej, jeśli zamkniesz stronę lub stracisz połączenie. Ponowne otwarcie aplikacji, gdy to uruchomienie nadal trwa, pokazuje uruchomienie w toku, z przyciskami Wstrzymaj i Zatrzymaj, zamiast bezczynnego formularza.

Łącze Otwórz przepływ pracy obok Uruchom otwiera bazowy przepływ pracy w PlaidCloud w nowej karcie — na jego kanwie, gdy jest to przepływ pracy DAG. Działa nawet wtedy, gdy własny widok uruchomienia w formularzu przestał się aktualizować.

Nadal możesz uruchomić przepływ pracy bezpośrednio, ustawiając jego zmienne, jak poniżej; App Runner to dodatkowa droga w stylu aplikacji.

Utrzymywanie aktualności aplikacji

Aplikacja App Runner to aplikacja serwerowa Panel, której app.py, widget_map.py i requirements.txt generuje PlaidCloud. Gdy PlaidCloud aktualizuje App Runner, Twoje istniejące aplikacje same przejmują nową wersję: każda jest odświeżana do bieżących plików i budowana ponownie przy następnej aktualizacji PlaidCloud, a także za każdym razem, gdy użyjesz Zbuduj ponownie lub edytujesz aplikację na ekranie Moje aplikacje Panel. Ustawienia aplikacji i jej przepływ pracy nie są zmieniane.

Zablokowana aplikacja pozostaje bez zmian. Odblokuj ją i kliknij Zbuduj ponownie, aby ją zaktualizować.
Ręczne edycje wygenerowanych plików są zastępowane. Odświeżenie zapisuje bieżące app.py, widget_map.py i requirements.txt nad Twoimi zmianami. Historia Git aplikacji zachowuje wcześniejsze wersje.

Skonwertowane typy danych wejściowych

PlaidCloud konwertuje typowe kontrolki aplikacji Alteryx na typowane dane wejściowe przepływu pracy:

Pola tekstowe stają się zmiennymi tekstowymi.
Kontrolki liczbowe stają się zmiennymi liczbowymi.
Kontrolki daty stają się zmiennymi daty ISO.
Pola wyboru, przyciski opcji, listy rozwijane, pola list i drzewa stają się kontrolowanymi zmiennymi wyboru.
Kontrolki przeglądania plików stają się zmiennymi plików Document.
Kontrolki przeglądania folderów stają się zmiennymi folderów Document.

Skonwertowany przepływ pracy używa tych zmiennych wszędzie tam, gdzie aplikacja Alteryx używała pierwotnej wartości pytania.

Ustawianie wartości przed uruchomieniem

Przed uruchomieniem przepływu pracy skonwertowanej aplikacji:

Otwórz skonwertowany przepływ pracy.
Przejrzyj zmienne przepływu pracy.
Ustaw wymagane wartości tekstowe, liczbowe, daty, wyboru, pliku i folderu.
Upewnij się, że ścieżki plików i folderów Document wskazują zaimportowaną lokalizację zależności lub inną zatwierdzoną ścieżkę Document.
Uruchom przepływ pracy.

W przypadku zaplanowanych uruchomień zapisz wartości zmiennych, które mają być używane za każdym razem, gdy uruchamia się harmonogram.

Warunki, ostrzeżenia i błędy

Warunki aplikacji Alteryx i sprawdzenia błędów są konwertowane na warunki kroków PlaidCloud. Warunek może:

Pozwolić przepływowi pracy kontynuować.
Wyemitować komunikat ostrzeżenia.
Zatrzymać przepływ pracy z jasnym błędem, gdy wymaga tego reguła aplikacji.
Skierować wykonanie inną gałęzią.

Użyj tego zachowania, aby zachować walidację na poziomie aplikacji podczas uruchamiania przepływu pracy w PlaidCloud.

Pliki i foldery jako dane wejściowe

Pytania o pliki i foldery używają ścieżek Document:

Dane wejściowe typu plik wybierają plik z Document.
Dane wejściowe typu folder wybierają folder Document.
Zaimportowane zależności z pulpitu są przechowywane w ścieżce Document wybranej podczas importu.
Kroki wejścia dynamicznego mogą używać zmiennych do ustalenia ostatecznej ścieżki Document w czasie wykonywania.

Dzięki temu skonwertowane aplikacje są przenośne między użytkownikami i zaplanowanymi uruchomieniami.

Parametry makr

Gdy skonwertowana aplikacja wywołuje makro, zmienne aplikacji mogą zasilać parametry makra. PlaidCloud przekazuje te wartości do wygenerowanego przepływu pracy makra przez obsługę wejścia makra i parametrów sterujących.

Współbieżne uruchomienia makr są izolowane, więc wiele uruchomień przepływu pracy może używać tego samego skonwertowanego makra bez współdzielenia stanu pośredniego.

Lista kontrolna walidacji

Dla każdej skonwertowanej aplikacji upewnij się, że:

Każde oczekiwane pytanie pojawia się jako zmienna przepływu pracy.
Wartości domyślne odpowiadają pierwotnej aplikacji tam, gdzie je skonfigurowano.
Kontrolowane listy zawierają oczekiwane wybory.
Zmienne plików i folderów wskazują ścieżki Document.
Warunki dają oczekiwane komunikaty, ostrzeżenia lub zatrzymanie.
Zgodność wyników przechodzi dla wybranych wartości zmiennych.