Centrum wsparcia Workiva

W tej połączonej ścieżce edukacyjnej utworzymy łańcuch ilustrujący sposób konwersji pliku XML do formatu CSV. Przyjrzymy się również sposobom porównywania zestawów danych w celu wyizolowania różnic.

Krok 1: Utwórz łańcuch

1. Dodaj nowy Łańcuch i nazwij go: CLP | Dostęp do danych XML .
2. Utwórz dwie zmienne łańcuchowe w następujący sposób:
   1. W obszarze Zmienne łańcuchowe kliknij dwukrotnie znak plus (+).
   2. Użyj następujących nazw i wartości dla zmiennych:
      • Zmienna XML
        • Imię: cv-XML-Pracownik
        • Wartość: https://cs-sftp-training-bucket.s3.amazonaws.com/cs-training/transformation-qs/employees.xml
      • Zmienna CSV
        • Imię: cv-CSV-Pracownik
        • Wartość: https://cs-sftp-training-bucket.s3.amazonaws.com/cs-training/transformation-qs/employee_detail.csv
3. Ratujmy Łańcuch.
   

Krok 2: Pobierz dane w formacie CSV

Użyj łącznika HTTP, aby pobrać dane dotyczące liczby pracowników w formacie CSV. W kolejnych krokach pobierzemy podobne informacje o liczbie pracowników w formacie XML i porównamy zestawy danych, aby zidentyfikować różnice.

1. Dodaj polecenie GET z łącznika HTTP do węzła startowego.

2. Skonfiguruj polecenie, używając następujących wartości:

   Nazwa	GET - Liczba pracowników w formacie CSV
   Nazwa użytkownika	<leave blank>
   Hasło	<leave blank>
   Certyfikat CA	<leave blank>
   Certyfikat	<leave blank>
   Klucz prywatny certyfikatu	<leave blank>
   Pokaż odpowiedź	Sprawdzone
   Adres URL	cv-CSV-Pracownik Zmienna łańcuchowa
   Ciąg zapytania	<leave blank>
   Typ zawartości	tekst/csv
   Odpowiedź	<leave blank>

3. Zapisz polecenie.
   

Krok 3: Pobierz dane w formacie XML

Użyj łącznika HTTP, aby pobrać dane dotyczące liczby pracowników w formacie XML. Jak wspomniano w kroku 2, w kolejnym kroku porównamy zbiór danych XML ze zbiorem danych CSV, aby zidentyfikować różnice.

1. Dodaj polecenie GET z łącznika HTTP do łańcucha.
2. Połącz węzeł początkowy (GET - liczba pracowników w formacie CSV) z poleceniem GET .

3. Skonfiguruj polecenie, używając następujących wartości:

   Nazwa	GET - Stan osobowy w formacie XML
   Nazwa użytkownika	<leave blank>
   Hasło	<leave blank>
   Certyfikat CA	<leave blank>
   Certyfikat	<leave blank>
   Klucz prywatny certyfikatu	<leave blank>
   Pokaż odpowiedź	Sprawdzone
   Adres URL	cv-XML-Pracownik Zmienna łańcuchowa
   Ciąg zapytania	<leave blank>
   Typ zawartości	aplikacja/xml
   Odpowiedź	<leave blank>

4. Zapisz polecenie.
   

Krok 4: Konwertuj plik XML do formatu rozdzielonego

Użyj łącznika XML do konwersji danych XML do formatu CSV, co umożliwi nam późniejsze wykorzystanie poleceń w łańcuchu, które oczekują danych w formacie rozdzielonym.

1. Dodaj listę elementów do polecenia CSV z łącznika XML do łańcucha.
2. Połącz polecenie GET - Liczba głów w formacie XML z poleceniem Lista elementów w formacie CSV .
3. Skonfiguruj polecenie, używając następujących wartości:
   • W przypadku parametru Plik wejściowy wybierz Dane wyjściowe odpowiedzi z polecenia GET - Liczba pracowników w formacie XML .
   • Pozostaw parametr Tekst wejściowy pusty.
   • W przypadku parametru Ścieżka do katalogu głównego wprowadź następujące informacje dotyczące koperty:
     /employee_data/employee
   • Zaznacz pole wyboru parametru Podgląd wyniku .

   • W sekcji Kolumny kliknij przycisk Dodaj 12 razy.
     W przypadku każdej dodanej kolumny wprowadź nazwę pola z rekordu danych podglądniętego w poprzednim kroku w polach Nazwa kolumny i XPath . Przykład
     : emp_id

     ⚠️ Pole XPath rozróżnia wielkość liter i musi być zgodne z wielkością liter w kopercie.

   • W przypadku parametru Rozdzielacz wielowartościowy wprowadź pionową kreskę (|).
4. Zapisz polecenie.
   
5. Opublikuj, wykonaj i uruchom łańcuch.

6. Przejrzyj kartę Dziennik węzła polecenia Lista elementów do CSV - Wszyscy pracownicy i potwierdź, że wyświetlana jest lista pracowników.

   ⚠️ Nie pomijaj wykonania ani przeglądu wyników tego kroku, ponieważ kopia tego polecenia zostanie utworzona w łańcuchu, a wszelkie błędy będzie trzeba później poprawić w wielu wystąpieniach polecenia.

   

Krok 5: Zmień przekonwertowany kod XML z rozdzielonego tabulatorami na rozdzielony przecinkami

Użyj łącznika Tabular Transformation Connector, aby przekonwertować dane wyjściowe wygenerowane w wyniku konwersji XML z formatu rozdzielonego tabulatorami na format rozdzielony przecinkami.

1. Dodaj polecenie Zmień ogranicznik z łącznika Transformacja tabelaryczna do łańcucha.
2. Połącz listę elementów z plikiem CSV - polecenie Wszyscy pracownicy z poleceniem Zmień ogranicznik .
3. Skonfiguruj polecenie, używając następujących wartości:
   • Nazwa: Zmień rozdzielacz - Wszyscy pracownicy
   • Plik wejściowy : Plik wyjściowy przekonwertowany z listy elementów do pliku CSV — polecenie Wszyscy pracownicy
   • Ogranicznik wejściowy: \t
   • Ogranicznik wyjściowy: , (przecinek)
4. Zapisz polecenie.
   

Krok 6: Porównaj zestawy danych CSV i XML, aby zidentyfikować różnice

Użyj Zaawansowanego zapytania , aby systematycznie identyfikować różnice między zestawami danych XML i natywnymi zestawami danych CSV. W tym przykładzie zidentyfikuj wszystkie rekordy w zestawie danych XML, które różnią się od zestawu danych CSV lub których brakuje. Wszelkie dodatkowe rekordy znalezione w zestawie danych CSV, których nie ma w zestawie danych XML, nie zostaną zidentyfikowane w ramach tego ćwiczenia.

1. Dodaj polecenie Advanced Query z łącznika Tabular Transformation do łańcucha.
2. Połącz polecenie Change Delimiter - All Employees z poleceniem Advanced Query .
3. Nazwij polecenie: Zapytanie zaawansowane - Wszyscy pracownicy .
4. W sekcji Tabele kliknij przycisk Dodaj , aby dodać drugą kartę.
   • Dla pierwszej tabeli:
     • Określ wynik CSV z
   polecenia Zmień ogranicznik - Wszyscy pracownicy .
5. Podaj XML jako Nazwę tabeli .
6. W przypadku drugiej tabeli:
   • Określ Dane wyjściowe odpowiedzi z polecenia GET - Liczba osób w formacie CSV .
     Podaj CSV jako Nazwę tabeli .
   • W parametrze zapytania wprowadź następujące dane:
     Wybierz * z XML, z wyjątkiem Wybierz * z CSV
   • W polach Ogranicznik wejściowy i Ogranicznik wyjściowy określ Przecinek .
   • Zaznacz opcję Podgląd wyników .
7. Zapisz polecenie.
   
8. Opublikuj, wykonaj i uruchom łańcuch. 
   

9. Przejrzyj kartę Dziennik węzła polecenia Zaawansowane zapytanie - Wszyscy pracownicy i potwierdź, że identyfikatory pracowników odpowiadają poniższym w przypadku rekordów zwróconych przez zapytanie.

   Identyfikator pracownika 01-6875791 10-4199621 38-3932553 63-0417180 78-3600453 85-6818050 97-2828467

Krok 7: Dodaj grupę poleceń

Dodaj grupę poleceń do łańcucha, aby lepiej zorganizować polecenia. Choć wykonanie tego kroku jest wymagane w ramach tego ćwiczenia, nie jest to wymóg techniczny dla Łańcucha. Ten krok ma na celu jedynie zilustrowanie możliwości organizowania węzłów Łańcucha.

1. Dodaj Grupę poleceń do łańcucha.
2. Połącz polecenie GET - Format Headcount in XML z sekcją Wejście grupy poleceń.
3. Kliknij grupę poleceń, a następnie wybierz ikonę kroplomierza, aby zmienić kolor poleceń na czerwony .
4. Nadaj grupie nazwę: Aktywni pracownicy . 
   

Krok 8: Filtruj dane CSV tylko dla aktywnych pracowników

Użyj inteligentnego filtra, aby zachować tylko te rekordy pracownika, w których jest on aktywny. Definiując filtr, zakładamy, że pole zakończone (zakończone) jest puste i oznacza, że ​​pracownik jest aktywny.

1. Dodaj polecenie Wiersze inteligentnego filtra z Łącznika transformacji tabelarycznej do łańcucha.
2. Połącz grupę Start z grupy poleceń z poleceniem Inteligentny filtr .
3. Skonfiguruj polecenie, używając następujących wartości:
   • Nazwij polecenie: Wiersze inteligentnego filtra - Dane CSV - Aktywni pracownicy .
   • W przypadku parametru Plik wejściowy wybierz Dane wyjściowe odpowiedzi z polecenia GET - Liczba pracowników w formacie CSV.
   • Pozostaw parametr pliku wyjściowego pusty .
   • Określ Przecinek jako Rozdzielacz .
   • W sekcji Filtry wykonaj następujące kroki:
     1. Kliknij
     przycisk Dodaj w filtrach Tekst .
   • W parametrze Nazwa kolumny wprowadź termin .
   • Zaznacz opcję Bez uwzględniania wielkości liter .
   • Z listy rozwijanej Warunek wybierz Równa się .
   • W parametrze Porównaj tekst wprowadź prawda .
   • Zaznacz opcję Nie .
   • Pozostaw pole wyboru Przytnij niezaznaczone.
     Ten filtr będzie teraz identyfikował każdy rekord, w którym pole „termed” nie zawiera wartości true (czyli zawiera wartość „false” lub jest puste).

Zapisz polecenie.

Krok 8: Filtruj dane CSV tylko dla aktywnych pracowników

Użyj inteligentnego filtra, aby zachować tylko te rekordy pracownika, w których jest on aktywny. Definiując filtr, zakładamy, że pole „zakończony” („termined”) jest puste i oznacza, że ​​pracownik jest aktywny.

1. Dodaj polecenie Wiersze inteligentnego filtra z Łącznika transformacji tabelarycznej do łańcucha.
2. Połącz grupę Start z grupy poleceń z poleceniem Inteligentny filtr .
3. Skonfiguruj polecenie, używając następujących wartości:
   • Nazwij polecenie: Wiersze inteligentnego filtra - Dane CSV - Aktywni pracownicy .
   • W przypadku pliku wejściowego wybierz plik wyjściowy odpowiedzi z polecenia GET - Liczba głów w formacie CSV.
   • Pozostaw parametr pliku wyjściowego pusty .
   • Określ Przecinek jako Rozdzielacz .
   • W sekcji Filtry
     1. Kliknij
     przycisk Dodaj w filtrach Tekst .
   • W parametrze Nazwa kolumny wprowadź termin .
   • Zaznacz opcję Bez uwzględniania wielkości liter .
   • Z listy rozwijanej Warunek wybierz Równa się .
   • W parametrze Porównaj tekst wprowadź prawda .
   • Zaznacz opcję Nie .
   • Pozostaw pole wyboru Przytnij niezaznaczone.
     Ten filtr będzie teraz identyfikował każdy rekord, w którym pole „termed” nie zawiera wartości true (czyli zawiera wartość „false” lub jest puste).

Zapisz polecenie.

Krok 9: Filtrowanie danych XML podczas konwersji do formatu rozdzielonego

W tym kroku filtrujemy dane XML, konwertując je do formatu rozdzielonego, aby zidentyfikować tylko aktywnych pracowników. Następnie ten zestaw danych zostanie porównany z przefiltrowanym zestawem danych CSV w celu zidentyfikowania różnic.

1. Skopiuj listę elementów do pliku CSV - polecenie Wszyscy pracownicy .
2. Połącz grupę Start z grupy poleceń z listą elementów do pliku CSV - Wszyscy pracownicy (kopiuj) .
3. Edytuj polecenie, nadając mu nazwę: Lista elementów do pliku CSV - Aktywni pracownicy .
4. W parametrze „Ścieżka do katalogu głównego” wprowadź następujące polecenie.
   /employee_data/employee[termed!='true']
   Teraz zidentyfikuje to każdy rekord, w którym pole „termed” nie zawiera wartości true (czyli zawiera wartość „false” lub jest puste).
5. Zapisz polecenie.
   

Krok 10: Zmień filtrowane dane XML na rozdzielone przecinkami

Podobnie jak w przypadku pełnej listy pracowników, przefiltrowaną listę aktywnych pracowników, która została przekonwertowana z formatu XML na format rozdzielony tabulatorami, należy przekonwertować na format rozdzielony przecinkami.

1. Skopiuj polecenie Zmień ogranicznik - Wszyscy pracownicy .
2. Połącz listę elementów z plikiem CSV - Aktywni pracownicy z poleceniem Zmiana ogranicznika elementu - Wszyscy pracownicy (kopiuj) .
3. Skonfiguruj polecenie, używając następujących wartości.
   • Nazwa: Zmień separator - Aktywni pracownicy.
   • Zmodyfikuj parametr Plik wejściowy , aby użyć polecenia Przekonwertowany plik Wyjście z listy elementów do pliku CSV - Aktywni pracownicy .
4. Zapisz polecenie.
   

Krok 11: Sprawdź różnice w przypadku aktywnych pracowników

Podobnie jak w przypadku pełnej listy pracowników, przefiltrowaną listę aktywnych pracowników, która została przekonwertowana z formatu XML na format rozdzielony tabulatorami, należy przekonwertować na format rozdzielony przecinkami.

1. Skopiuj polecenie Zapytanie zaawansowane - Wszyscy pracownicy .
2. Połącz wyjście z grupy poleceń z poleceniem Zaawansowane zapytanie - Wszyscy pracownicy (kopiuj) . Połączenie polecenia Zaawansowane zapytanie - Wszyscy pracownicy z grupą Out gwarantuje, że wszystko, co jest połączone z grupą Start, zostanie zakończone przed przejściem łańcucha do poleceń w grupie Out.
3. Skonfiguruj polecenie, używając następujących wartości:
   • Nazwa: Zapytanie zaawansowane - Aktywni pracownicy.

   • W sekcji Tabele zmodyfikuj parametr Plik dla obu tabel, używając następujących wartości:

     Tabela	Plik
     XML	Wynik CSV z polecenia Change Delimiter - Aktywni pracownicy
     CSV	Dane wyjściowe wiersza inteligentnego filtra z wierszy inteligentnego filtra — tylko aktywne, polecenie danych CSV

4. Zapisz polecenie.
   

Krok 12: Przetestuj ćwiczenie

Teraz, gdy łańcuch jest gotowy, można przetestować wynik.

1. Opublikuj Łańcuch.
2. Kliknij Wykonaj , a następnie wybierz Uruchom łańcuch . 
   
3. Po zakończeniu działania łańcucha kliknij węzeł Zapytanie zaawansowane – Aktywni pracownicy .
   1. Na
   karcie Wyjścia sprawdź, czy wygenerowano 4 rekordy.

4. Kliknij kartę Dzienniki i sprawdź, czy identyfikatory pracowników odpowiadają poniższym rekordom zwróconym przez zapytanie.

   Identyfikator pracownika 01-6875791 63-0417180 78-3600453 85-6818050

   
   

Aby dowiedzieć się więcej o transformacji danych za pomocą łańcuchów, zapoznaj się z Połączonymi ścieżkami edukacyjnymi – Wprowadzenie do transformacji !