Workiva kundestøttesenter

I denne tilkoblede læringsstien skal vi lage en kjede som illustrerer hvordan man konverterer en XML-fil til CSV. Vi vil også utforske hvordan man kan sammenligne datasett for å isolere forskjeller.

Trinn 1: Lag en kjede

1. Legg til en ny Chain , og gi kjeden følgende navn: CLP | Tilgang til XML-data .
2. Opprett to kjedevariabler som følger:
   1. Under Kjedevariabler klikker du to ganger på plusstegnet (+).
   2. Bruk følgende navn og verdier for variablene:
      • XML-variabel
        • Navn: cv-XML-Ansatt
        • Verdi: https://cs-sftp-training-bucket.s3.amazonaws.com/cs-training/transformation-qs/employees.xml
      • CSV-variabel
        • Navn: cv-CSV-Ansatt
        • Verdi: https://cs-sftp-training-bucket.s3.amazonaws.com/cs-training/transformation-qs/employee_detail.csv
3. Redd kjeden.
   

Trinn 2: Hent data i CSV-format

Bruk HTTP-koblingen til å hente data om antall ansatte i CSV-format. I senere trinn vil vi hente lignende informasjon om antall ansatte i XML-format og deretter sammenligne datasettene for å identifisere forskjeller.

1. Legg til en GET -kommando fra HTTP-koblingen til startnoden.

2. Konfigurer kommandoen ved å bruke følgende verdier:

   Navn	GET - Antall ansatte i CSV-format
   Brukernavn	<leave blank>
   Passord	<leave blank>
   CA-sertifikat	<leave blank>
   Sertifikat	<leave blank>
   Privat nøkkel for sertifikat	<leave blank>
   Vis svar	Kontrollert
   URL	cv-CSV-Ansatt Kjedevariabel
   Spørrestreng	<leave blank>
   Innholdstype	tekst/csv
   Svar	<leave blank>

3. Lagre kommandoen.
   

Trinn 3: Hent data i XML-format

Bruk HTTP-koblingen til å hente data om antall ansatte i XML-format. Som nevnt i trinn 2, vil vi i et påfølgende trinn sammenligne XML-datasettet med CSV-datasettet for å identifisere forskjeller.

1. Legg til en GET -kommando fra HTTP-koblingen til kjeden.
2. Koble startnoden (GET - Headcount i CSV-format) til GET -kommandoen.

3. Konfigurer kommandoen ved å bruke følgende verdier:

   Navn	GET - Antall ansatte i XML-format
   Brukernavn	<leave blank>
   Passord	<leave blank>
   CA-sertifikat	<leave blank>
   Sertifikat	<leave blank>
   Privat nøkkel for sertifikat	<leave blank>
   Vis svar	Kontrollert
   URL	cv-XML-Ansatt Kjedevariabel
   Spørrestreng	<leave blank>
   Innholdstype	applikasjon/xml
   Svar	<leave blank>

4. Lagre kommandoen.
   

Trinn 4: Konverter XML-filen til avgrenset

Bruk XML-koblingen til å konvertere XML-dataene til et CSV-format, slik at vi kan bruke kommandoer senere i kjeden som forventer data i et avgrenset format.

1. Legg til en Elementliste til CSV -kommando fra XML-koblingen til kjeden.
2. Koble GET - Headcount in XML Format -kommandoen til Element List to CSV -kommandoen.
3. Konfigurer kommandoen ved å bruke følgende verdier:
   • For parameteren Input File velger du Response Output fra kommandoen GET - Headcount in XML Format .
   • La parameteren Input Text stå tom.
   • For parameteren Sti til rot skriver du inn følgende konvoluttinformasjon:
     /employee_data/employee
   • Merk av for parameteren Forhåndsvisningsresultat .

   • For seksjonen Kolonner klikker du på knappen Legg til 12 ganger.
     For hver av de tillagte kolonnene skriver du inn navnet på feltet fra dataposten som ble forhåndsvist i forrige trinn, i både feltet Kolonnenavn og XPath . Eksempel
     : emp_id

     ⚠️ XPath-feltet skiller mellom store og små bokstaver og må samsvare med store og små bokstaver i konvolutten.

   • For parameteren Flerverdiskilletegn skriver du inn et linjetegn (|).
4. Lagre kommandoen.
   
5. Publiser, utfør og kjør kjeden.

6. Se gjennom fanen Logg i kommandonoden Elementliste til CSV - Alle ansatte og bekreft at en liste over ansatte vises.

   ⚠️ Ikke hopp over gjennomgangen av utførelse og resultater i dette trinnet, da det vil bli opprettet en kopi av denne kommandoen i kjeden, og eventuelle feil må deretter korrigeres på tvers av flere forekomster av kommandoen.

   

Trinn 5: Endre den konverterte XML-filen fra tabulatoravgrenset til kommaavgrenset

Bruk koblingen for tabelltransformasjon til å konvertere utdataene som genereres fra XML-konverteringen fra et tabulatoravgrenset format til et kommaavgrenset format.

1. Legg til en Endre skilletegn -kommando fra Tabelltransformasjonskoblingen til kjeden.
2. Koble kommandoen Elementliste til CSV - Alle ansatte til kommandoen Endre skilletegn .
3. Konfigurer kommandoen ved å bruke følgende verdier:
   • Navn: Endringsskilletegn - Alle ansatte
   • Inndatafil: Konverterte filutdata fra Elementlisten til CSV - Alle ansatte Kommando
   • Inndataskilletegn: \t
   • Utdataskilletegn: , (komma)
4. Lagre kommandoen.
   

Trinn 6: Sammenlign CSV- og XML-datasettene for å identifisere forskjeller

Bruk Avansert spørring for å systematisk identifisere forskjeller mellom XML- og native CSV-datasett. I dette eksemplet identifiserer du eventuelle poster i XML-datasettet som er forskjellige fra eller mangler fra CSV-datasettet. Eventuelle tilleggsoppføringer som finnes i CSV-datasettet som ikke finnes i XML-datasettet, vil ikke bli identifisert av denne øvelsen.

1. Legg til en Avansert spørring -kommando fra Tabelltransformasjon - koblingen til kjeden.
2. Koble kommandoen Endringsskilletegn - Alle ansatte til kommandoen Avansert spørring .
3. Navngi kommandoen: Avansert spørring - Alle ansatte .
4. I delen Tabeller klikker du på knappen Legg til for å legge til en ny fane.
   • For den første tabellen:
     • Spesifiser CSV-resultatet fra kommandoen Endringsskilletegn - Alle ansatte .
     • Spesifiser XML som Tabellnavn .
   • For den andre tabellen:
     • Spesifiser Svarutdata fra GET - Headcount in CSV Format -kommandoen.
       Spesifiser CSV som Tabellnavn .
     • I spørringsparameteren skriver du inn følgende:
       Velg * fra XML UNNTAT Velg * fra CSV
     • I feltene Input Delimiter og Output Delimiter, angi Comma .
     • Kryss av for alternativet Forhåndsvis resultater .
5. Lagre kommandoen.
   
6. Publiser, utfør og kjør kjeden. 
   

7. Se gjennom fanen Logg i kommandonoden Avansert spørring - Alle ansatte og bekreft at ansatt-ID-ene samsvarer med nedenstående for postene som returneres av spørringen.

   Ansatt-ID 01-6875791 10-4199621 38-3932553 63-0417180 78-3600453 85-6818050 97-2828467

Trinn 7: Legg til en kommandogruppe

Legg til en kommandogruppe i kjeden for å organisere kommandoer bedre. Selv om dette trinnet er nødvendig i forbindelse med denne øvelsen, er det ikke et teknisk krav for kjeden. Dette trinnet er kun for å illustrere evnen til å organisere noder i en kjede.

1. Legg til en kommandogruppe i kjeden.
2. Koble kommandoen GET - Headcount in XML Format til In-delen av kommandogruppen.
3. Klikk på kommandogruppen, og velg deretter pipetteikonet for å endre kommandofargen til rød .
4. Navngi gruppen: Aktive ansatte . 
   

Trinn 8: Filtrer CSV-data kun for aktive ansatte

Bruk et smartfilter for å bare beholde ansattpostene der den ansatte er aktiv. Når vi definerer filteret, antar vi at det at feltet for avsluttet (terminert) er tomt, indikerer at en ansatt er aktiv.

1. Legg til en Smart Filter Rows -kommando fra Tabular Transformation Connector til kjeden.
2. Koble Gruppestart fra kommandogruppen til Smartfilter -kommandoen.
3. Konfigurer kommandoen ved å bruke følgende verdier:
   • Navngi kommandoen: Smartfilterrader - CSV-data - Aktive ansatte .
   • For parameteren Input file velger du Response Output fra kommandoen GET - Headcount in CSV Format.
   • La parameteren Output for fil stå tom.
   • Spesifiser Komma som Avgrensningstegn .
   • I Filtre -delen, fullfør følgende trinn:
     1. Klikk på Legg til -knappen på Tekst -filtrene.
     2. I parameteren Kolonnenavn skriver du inn kalt .
     3. Kryss av for alternativet Ufølsom for store og små bokstaver .
     4. Fra rullegardinmenyen Betingelse velger du Er lik .
     5. I parameteren Sammenlign tekst skriver du inn true .
     6. Kryss av for alternativet Ikke .
     7. La avmerkingsboksen Trim være umarkert.
        Dette filteret vil nå identifisere alle poster der feltet «termed» ikke inneholder verdien true (det vil si at det inneholder «false» eller er tomt).
4. La alternativet Forhåndsvisningsresultat være markert.
5. Alternativet Invers lar smartfilteret enten beholde (avkrysset) eller fjerne (ikke avkrysset) alle rader som samsvarer med filterkriteriene. I denne øvelsen ønsker vi å beholde alle radene der feltet «termined» har verdien sann eller blank. For å
   oppnå dette, merk av i avmerkingsboksen Invers .
6. Lagre kommandoen.
   

Trinn 8: Filtrer CSV-data kun for aktive ansatte

Bruk et smartfilter for å bare beholde ansattpostene der den ansatte er aktiv. Når vi definerer filteret, antar vi at det at feltet for avsluttet ("terminert") er tomt, indikerer at en ansatt er aktiv.

1. Legg til en Smart Filter Rows -kommando fra Tabular Transformation Connector til kjeden.
2. Koble Gruppestart fra kommandogruppen til Smartfilter -kommandoen.
3. Konfigurer kommandoen ved å bruke følgende verdier:
   • Navngi kommandoen: Smartfilterrader - CSV-data - Aktive ansatte .
   • For Input-fil velger du Response Output fra kommandoen GET - Headcount i CSV-format.
   • La parameteren Output for fil stå tom.
   • Spesifiser Komma som Avgrensningstegn .
   • I Filtre -delen,
     1. Klikk på Legg til -knappen på Tekst -filtrene.
     2. I parameteren Kolonnenavn skriver du inn kalt .
     3. Kryss av for alternativet Ufølsom for store og små bokstaver .
     4. Fra rullegardinmenyen Betingelse velger du Er lik .
     5. I parameteren Sammenlign tekst skriver du inn true .
     6. Kryss av for alternativet Ikke .
     7. La avmerkingsboksen Trim være umarkert.
        Dette filteret vil nå identifisere alle poster der feltet «termed» ikke inneholder verdien true (det vil si at det inneholder «false» eller er tomt).
   • La avmerkingsboksen Forhåndsvisningsresultat være merket (avkrysset).
   • Alternativet Invers lar smartfilteret enten beholde (avkrysset) eller fjerne (ikke avkrysset) alle rader som samsvarer med filterkriteriene. I denne øvelsen ønsker vi å beholde alle radene der det angitte feltet har verdien «true» eller «blank». For å oppnå dette, merk av for Invers .
4. Lagre kommandoen.
   

Trinn 9: Filtrer XML-data under konvertering til avgrenset

I dette trinnet filtrerer vi XML-dataene mens vi konverterer dem til et avgrenset format for å identifisere kun aktive ansatte. Dette datasettet vil deretter bli sammenlignet med det filtrerte CSV-datasettet for å identifisere forskjeller.

1. Kopier Elementliste til CSV - Alle ansatte -kommandoen.
2. Koble Gruppestart fra kommandogruppen til Elementliste til CSV - Alle ansatte (Kopier) -kommandoen.
3. Rediger kommandoen, og gi den navnet: Elementliste til CSV - Aktive ansatte .
4. I parameteren «Sti til rot» skriver du inn følgende:
   /employee_data/employee[termed!='true']
   Dette vil nå identifisere alle poster der feltet «termed» ikke inneholder verdien true (det vil si at det inneholder «false» eller er tomt).
5. Lagre kommandoen.
   

Trinn 10: Endre de filtrerte XML-dataene til kommaseparerte

Som med den fullstendige ansattlisten, må den filtrerte aktive ansattlisten som er konvertert fra XML til tabulatoravgrenset, konverteres til kommaavgrenset.

1. Kopier kommandoen Endre skilletegn - Alle ansatte .
2. Koble kommandoen Elementliste til CSV - Aktive ansatte til kommandoen Elementendringsskilletegn - Alle ansatte (Kopier) .
3. Konfigurer kommandoen ved hjelp av følgende verdier.
   • Navn: Endringsskilletegn - Aktive ansatte.
   • Endre parameteren Input file for å bruke kommandoen Converted File Output from the Element List to CSV - Active Employees .
4. Lagre kommandoen.
   

Trinn 11: Sjekk for forskjeller med aktive ansatte

Som med den fullstendige ansattlisten, må den filtrerte aktive ansattlisten som er konvertert fra XML til tabulatoravgrenset, konverteres til kommaavgrenset.

1. Kopier kommandoen Avansert spørring - Alle ansatte .
2. Koble Ut fra kommandogruppen til kommandoen Avansert spørring - Alle ansatte (Kopier) . Å koble kommandoen Avansert spørring - Alle ansatte til Gruppeutgang sikrer at alt som er koblet til Gruppestart fullføres før kjeden går videre til kommandoene i Gruppeutgang.
3. Konfigurer kommandoen ved å bruke følgende verdier:
   • Navn: Avansert spørring - Aktive ansatte.

   • I delen Tabeller endrer du parameteren Fil for begge tabellene med følgende verdier:

     Tabell	Fil
     XML	CSV-resultatutdata fra endringsskilletegnet - kommandoen Aktive ansatte
     CSV-fil	Smart filterrad-utdata fra Smart filterrader - Kun aktive, CSV-datakommando

4. Lagre kommandoen.
   

Trinn 12: Test øvelsen

Nå som kjeden er fullført, test resultatet.

1. Publiser Kjeden.
2. Klikk på Utfør og velg deretter Kjør kjede . 
   
3. Når kjeden har fullført kjøringen, klikker du på noden Avansert spørring - Aktive ansatte .
   1. I
   fanen Utdata bekrefter du at det ble sendt ut 4 poster.

4. Klikk på Logger-fanen og bekreft at ansatt-ID-ene samsvarer med nedenstående for postene som returneres av spørringen.

   Ansatt-ID 01-6875791 63-0417180 78-3600453 85-6818050

   
   

Hvis du vil lære mer om datatransformasjon ved hjelp av kjeder, kan du se Tilkoblede læringsstier - introduksjon til transformasjon !