Możesz jeszcze bardziej usprawnić zarządzanie danymi, łącząc poszczególne kroki w jeden łańcuch. W tej połączonej ścieżce edukacyjnej omówimy najlepszy sposób zastępowania danych w tabeli Wdata, który jest dwuetapowym procesem przy użyciu jednego łańcucha.
| Główny biznesowy przypadek użycia | Zarządzanie tabelą |
| Podstawowy cel edukacyjny | Zastępowanie danych w tabeli Wdata przy użyciu łańcuchów |
| Wymagania wstępne | Skonfiguruj konektor Workiva Skonfiguruj konektor żądań HTTP Zakończ CLP - Przesyłanie danych do ścieżki tabeli Zidentyfikuj ID tabeli tabeli szczegółów pracowników CLP |
| Szablon pomocniczy | CLP - Zastępowanie danych w tabeli |
Krok 1: Uruchom łańcuch
- Przejdź do łańcucha CLP | Upload Data to a Table.
- Kliknij Execute, a następnie wybierz Run With Inputs.
- Wprowadź wartości dla danych wejściowych środowiska uruchomieniowego:
- ID tabeli - ID tabeli szczegółów pracowników CLP
Sprawdź ten dokument, aby uzyskać pomoc w znalezieniu ID. - File Name - dowolna nazwa, którą chcesz nazwać plik, w tym przykładzie nazywamy plik "Employee Detail".
- Lokalizacja pliku - https://cs-sftp-training-bucket.s3.amazonaws.com/cs-training/transformation-qs/employee_detail.csv.
- ID tabeli - ID tabeli szczegółów pracowników CLP
- Kliknij Start.
- Po zakończeniu łańcucha kliknij węzeł Importuj plik do tabeli, aby zweryfikować powodzenie.
W tabeli szczegółów pracowników CLP dostępne są teraz dane, które zastąpimy zaktualizowanym zestawem danych, używając jednego łańcucha do usunięcia starych danych i przesłania nowych.
Krok 2: Utwórz łańcuch
- Dodaj nowy łańcuch .
- Nazwij łańcuch: CLP | Replace Data in a Table.
- Uratuj łańcuch.
Krok 3: Dane wejściowe środowiska uruchomieniowego
Do uruchomienia łańcucha używamy polecenia Runtime Inputs. Pozwala nam to określić nazwę pliku i identyfikator tabeli, do której plik zostanie zaimportowany po uruchomieniu łańcucha.
- Dodaj polecenie Runtime Inputs Command z Chain Trigger Events w obszarze Start.
- Edytuj Runtime Inputs Chain Event, klikając dwukrotnie polecenie.
Dodaj trzy wejścia poniżej:- Wejście 1:
- Typ: TextField
- Wyświetlana nazwa: Identyfikator tabeli
- Wymagane: Zaznaczone
- Wejście 2:
- Typ: TextField
- Wyświetlana nazwa: Nazwa pliku
- Wymagane: Zaznaczone
- Wejście 3:
- Typ: TextField
- Wyświetlana nazwa: Lokalizacja pliku
- Wymagane: Zaznaczone
- Wejście 1:
- Zapisz polecenie.
Krok 4: Lista plików
Aby usunąć stary plik w tabeli, będziemy potrzebować identyfikatora pliku. Aby programowo znaleźć FileID, użyjemy polecenia List Files. To polecenie używa identyfikatora tabeli do wyszukiwania wszystkich plików w tej tabeli i zapewnia nam dane wyjściowe plików, a także informacje o tych plikach, w tym identyfikator pliku.
- Dodaj polecenie List Files do kanwy Chain
- Połącz polecenie Runtime Inputs Chain Event z poleceniem List Files.
- Kliknij dwukrotnie polecenie, aby je skonfigurować. i kliknij pole Table ID.
- W lewym panelu Variables kliknij strzałkę w dół, aby rozwinąć Trigger.
- Kliknij strzałkę w dół, aby rozwinąć Runtime Inputs.
- Wybierz TableID.
- Zapisz polecenie.
Krok 5: Usuń import pliku z tabeli
Podobnie jak w przypadku przesyłania danych do tabeli, usuwanie danych z tabeli jest procesem dwuetapowym. Plik będzie musiał najpierw zostać przeniesiony do stanu etapowego, zanim będzie można go usunąć. Aby ustawić plik jako etapowy, konieczne będzie jego odimportowanie. Użyjemy polecenia Un-Import File from Table, aby przygotować zestaw danych do usunięcia.
- Dodaj polecenie Un-import File from Table do kanwy Chain.
- Połącz polecenie List Files z poleceniem Un-import File from Table.
- Kliknij dwukrotnie polecenie, aby je skonfigurować.
- Kliknij pole Table ID.
- W lewym panelu Variables kliknij strzałkę w dół, aby rozwinąć Trigger.
- Kliknij strzałkę w dół, aby rozwinąć Runtime Inputs.
- Wybierz TableID.
- Kliknij pole File ID.
- W lewym panelu Zmienne kliknij strzałkę w dół, aby rozwinąć List Files.
- Wybierz Lista plików.
- Kliknij zmienną List Files - Files List, aby przekształcić zmienną.
- Kliknij Select Transformation, a następnie wybierz Get Value from JSON.
- Kliknij znak plus, aby dodać transformację zmiennej.
- W polu Wartość wpisz '0', a następnie naciśnij Enter.
- Po pojawieniu się
=0wpisz 'id' i naciśnij Wprowadź ponownie.
Zmienna odczyta teraz dane wyjściowe JSON z polecenia List Files i znajdzie identyfikator pierwszego pliku w tabeli.Wskazówka! Zwróć szczególną uwagę na wielkie i małe litery podczas analizowania wartości JSON.
- Kliknij Akceptuj.
- Zapisz polecenie.
Krok 6: Pobierz plik
Następnie możemy albo usunąć plik etapowy z tabeli, albo przygotować nowy plik do przesłania. Zalecamy przesłanie nowego pliku po odimportowaniu starego pliku, aby upewnić się, że proces zakończył się powodzeniem, zanim jakiekolwiek dane zostaną oficjalnie usunięte.
Aby przygotować nowy plik do przesłania, będziemy musieli najpierw pobrać plik za pomocą polecenia HTTP Request Get. Udostępniliśmy plik online do pobrania przez Chain, aby zademonstrować pobieranie plików z chmury.
- Dodaj polecenie Get z łącznika HTTP Request do kanwy Chain.
- Połącz polecenie Un-import File from Table z poleceniem Get.
- Kliknij dwukrotnie polecenie, aby je skonfigurować.
- Kliknij pole URL.
- W lewym panelu Select a Variable kliknij strzałkę w dół, aby rozwinąć Trigger.
- Kliknij strzałkę w dół, aby rozwinąć Runtime Inputs.
- Wybierz lokalizację pliku .
- Zaktualizuj pole Content type na: application/csv.
- Kliknij pole URL.
- Zapisz polecenie.
Krok 7: Utwórz plik
Podobnie jak w przypadku Upload Data to Table Connected Learning Path, będziemy postępować zgodnie z dwuetapowym procesem przesyłania danych do Wdata Tables. Plik będzie musiał najpierw zostać utworzony w stanie etapowym, zanim będzie można go zaimportować do ostatecznego użycia. Użyjemy polecenia Create File, aby utworzyć plik w tabeli Wdata w statusie Staged, wskazując, że został on utworzony, ale nie został jeszcze zaimportowany jako zestaw danych.
- Dodaj polecenie Create File z łącznika Workiva Connector do kanwy Chain.
- Połącz polecenie Get z poleceniem Create File.
- Kliknij dwukrotnie polecenie, aby je skonfigurować.
- Kliknij pole Table ID.
- W lewym panelu Select a Variable kliknij strzałkę w dół, aby rozwinąć Trigger.
- Kliknij strzałkę w dół, aby rozwinąć Runtime Inputs.
- Wybierz Table ID.
- Kliknij pole File .
- W lewym panelu Select a Variable kliknij strzałkę w dół, aby rozwinąć GET.
- Wybierz Response.
- Kliknij pole Name.
- W lewym panelu Select a Variable kliknij strzałkę w dół, aby rozwinąć Trigger.
- Kliknij strzałkę w dół, aby rozwinąć Runtime Inputs.
- Wybierz File Name.
- W lewym panelu Select a Variable kliknij strzałkę w dół, aby rozwinąć Runtime.
- Wybierz Chain.ExecutionDateTime.
- Wpisz ".csv" po dwóch zmiennych.
Zmienna Chain.ExecutionDateTime jest używana jako sposób na pokazanie, kiedy plik został wygenerowany i zapewnienie, że każdy plik ma unikalną nazwę.
- Kliknij pole Table ID.
Krok 8: Zaimportuj plik do tabeli
Następnym krokiem w procesie przesyłania plików do tabel Wdata jest zaimportowanie danych, dzięki czemu będą one użyteczne w Kwerendach. Ten krok pobiera plik etapowy i importuje go do wyznaczonej tabeli jako zestaw danych.
- Dodaj polecenie Import File into Table z Workiva Connector do kanwy Chain.
- Połącz polecenie Create File z poleceniem Import File into Table.
- Kliknij dwukrotnie polecenie, aby je skonfigurować.
- Dla pola Table ID:
- W lewym panelu Select a Variable kliknij strzałkę w dół, aby rozwinąć Trigger.
- Kliknij strzałkę w dół, aby rozwinąć Runtime Inputs.
- Wybierz Table ID.
- W polu File ID.
- W lewym panelu Select a Variable kliknij strzałkę w dół, aby rozwinąć Create File.
- Wybierz Wynik.
- Kliknij na Create File - Result, aby go przekształcić.
- Z listy rozwijanej Select Transformation wybierz Get Value from JSON.
- Kliknij przycisk + (plus).
- W polu Wartość wpisz "id" i naciśnij Enter.
- Kliknij ACCEPT.
- Dla pola Table ID:
- Zapisz polecenie
Krok 9: Usuń plik
Teraz, gdy nowe dane zostały przesłane i są gotowe do użycia, a stary zestaw danych został przeniesiony, ostatnim krokiem jest oficjalne usunięcie starych danych. Ten krok wykorzystuje polecenie Delete File do usunięcia zbioru danych z tabeli.
- Dodaj polecenie Delete File z łącznika Workiva Connector do kanwy Chain
- Połącz polecenie Importuj plik do tabeli z poleceniem Usuń plik
- Kliknij dwukrotnie polecenie, aby je skonfigurować.
Aby upewnić się, że usuwamy ten sam plik, który odimportowaliśmy, wygenerujemy identyfikator pliku w taki sam sposób, jak w przypadku polecenia Odimportuj plik z tabeli:- W polu File ID:
- W lewym panelu Variables kliknij strzałkę w dół, aby rozwinąć List Files.
- Wybierz Lista plików.
- Kliknij zmienną List Files - Files List, aby przekształcić zmienną.
- Kliknij Select Transformation, a następnie wybierz Get Value from JSON.
- Kliknij znak plus (+), aby dodać transformację zmiennej.
- W polu Value wpisz "0", a następnie naciśnij Enter.
- Po pojawieniu się
=0wpisz "id" i naciśnij Wprowadź ponownie .
Zmienna odczyta teraz dane wyjściowe JSON z polecenia List Files i znajdzie identyfikator pierwszego pliku w tabeli.Wskazówka! Zwróć szczególną uwagę na wielkie i małe litery podczas analizowania wartości JSON.
- Kliknij Akceptuj
- Zapisz the Command.xx
Krok 10: Przetestuj ćwiczenie
Teraz, gdy łańcuch jest gotowy, przetestuj wynik.
- Kliknij Execute, a następnie wybierz Run With Inputs.
- Dodaj wartości dla danych wejściowych środowiska uruchomieniowego.
- ID tabeli - ID tabeli szczegółów pracowników CLP
Sprawdź ten dokument, aby uzyskać pomoc w znalezieniu ID - File Name - dowolna nazwa, którą chcesz nazwać plik; w tym przykładzie nazywamy plik "Employee Detail".
- Lokalizacja pliku - https://cs-sftp-training-bucket.s3.amazonaws.com/cs-training/transformation-qs/employee_detail_replace.csv
- ID tabeli - ID tabeli szczegółów pracowników CLP
- Kliknij Start
- Łańcuch powinien pomyślnie usunąć stary plik i zastąpić go nowym plikiem w Twojej tabeli.
- Możesz sprawdzić, czy dane zostały zastąpione w tabeli, przechodząc do tabeli w Wdata i przeglądając zestawy danych w prawym panelu.
Aby dowiedzieć się więcej na temat korzystania z łańcuchów w celu usprawnienia gromadzenia danych, zapoznaj się z pozostałą częścią Ścieżki centralizacji danych!
- W polu File ID:
- Kliknij pole Table ID.