Workiva kundestøttesenter

I denne Connected Learning Path skal vi lage en kjede som illustrerer hvordan du konverterer en XML-fil til CSV. Vi vil også utforske hvordan man kan sammenligne datasett for å isolere forskjeller.

Trinn 1: Opprett en kjede

1. Legg til en ny Chain, og gi kjeden et navn: CLP | Accessing XML Data.
2. Opprett to Chain-variabler på følgende måte:
   1. Under Kjedevariabler klikker du på plusstegnet (+) to ganger.
   2. Bruk følgende navn og verdier for variablene:
      • XML-variabel
        • Navn: cv-XML-Employee
        • Verdi: https://cs-sftp-training-bucket.s3.amazonaws.com/cs-training/transformation-qs/employees.xml
      • CSV-variabel
        • Navn: cv-CSV-Employee
        • 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 Connector til å hente data om antall ansatte i CSV-format. I senere trinn vil vi hente inn lignende informasjon om antall ansatte i XML-format og deretter sammenligne datasettene for å identifisere forskjeller.

1. Legg til en GET -kommando fra HTTP Connector til Start-noden.

2. Konfigurer kommandoen ved hjelp av følgende verdier:

   Navn	GET - Antall ansatte i CSV-format
   Brukernavn	<la stå tomt&gt
   Passord	<la stå tomt&gt
   CA-sertifikat	<la stå tomt&gt
   Sertifikat	<la stå tomt&gt
   Sertifikatets private nøkkel	<la stå tomt&gt
   Vis svar	Kontrollert
   URL	cv-CSV-Employee Kjedevariabel
   Forespørselsstreng	<la stå tomt&gt
   Innholdstype	tekst/csv
   Svar	<la stå tomt&gt

3. Lagre kommandoen.
   

Trinn 3: Hent data i XML-format

Bruk HTTP Connector til å hente inn data om antall ansatte i XML-format. Som nevnt i trinn 2 vil vi i et senere trinn sammenligne XML-datasettet med CSV-datasettet for å identifisere forskjeller.

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

3. Konfigurer kommandoen ved hjelp av følgende verdier:

   Navn	GET - Antall ansatte i XML-format
   Brukernavn	<la stå tomt&gt
   Passord	<la stå tomt&gt
   CA-sertifikat	<la stå tomt&gt
   Sertifikat	<la stå tomt&gt
   Sertifikatets private nøkkel	<la stå tomt&gt
   Vis svar	Kontrollert
   URL	cv-XML-Employee Kjedevariabel
   Forespørselsstreng	<la stå tomt&gt
   Innholdstype	application/xml
   Svar	<la stå tomt&gt

4. Lagre kommandoen.
   

Trinn 4: Konverter XML-filen til avgrenset

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

1. Legg til en Element List to CSV Kommando fra XML Connector til kjeden.
2. Koble kommandoen GET - Headcount in XML Format til kommandoen Element List to CSV.
3. Konfigurer kommandoen ved hjelp av 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 Path to root skriver du inn følgende konvoluttinformasjon:
     /employee_data/employee
   • Merk av for parameteren Preview Result.

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

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

   • For parameteren Flerverdiskilletegn angir du en pipe (|).
4. Lagre kommandoen.
   
5. Publiser, utfør og kjør kjeden.

6. Se gjennom fanen Log i Element List to CSV - All Employees Kommandonode, og bekreft at det vises en liste over ansatte.

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

   

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

Bruk Tabular Transformation Connector til å konvertere utdataene som genereres fra XML-konverteringen fra et tabulatoravgrenset format til et kommaseparert format.

1. Legg til en Change Delimiter Command fra Tabular Transformation Connector til kjeden.
2. Koble kommandoen Element List to CSV - All Employees til kommandoen Change Delimiter.
3. Konfigurer kommandoen ved hjelp av følgende verdier:
   • Navn: Endre skilletegn - Alle ansatte
   • Inndatafil: Konvertert fil Utdata fra Element List til CSV - Alle ansatte Kommando
   • Skilletegn for inndata: \t
   • Skilletegn for utdata:, (komma)
4. Lagre kommandoen.
   

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

Bruk Advanced Query til å systematisk identifisere forskjeller mellom XML- og opprinnelige CSV-datasett. I dette eksemplet identifiserer du alle poster i XML-datasettet som er forskjellige fra eller mangler i CSV-datasettet. Eventuelle ekstra poster som finnes i CSV-datasettet, men som ikke finnes i XML-datasettet, vil ikke bli identifisert ved hjelp av denne øvelsen.

1. Legg til en Advanced Query Command fra Tabular Transformation Connector til kjeden.
2. Koble kommandoen Change Delimiter - All Employees til kommandoen Advanced Query.
3. Gi kommandoen et navn: Avansert spørring - Alle ansatte.
4. I delen Tables klikker du på knappen Add for å legge til en ny fane.
   • For det første bordet:
     • Angi CSV-resultat Utdata fra Endre skilletegn - alle ansatte Kommando.
     • Angi XML som Tabellnavn.
   • For den andre tabellen:
     • Angi Response Output fra kommandoen GET - Headcount in CSV Format.
       Angi CSV som Tabellnavn.
     • Skriv inn følgende i Query-parameteren:
       Velg * fra XML Unntatt Velg * fra CSV
     • I feltene Input Delimiter og Output Delimiter angir du Comma.
     • Merk av for Forhåndsvisning av resultater.
5. Lagre kommandoen.
   
6. Publiser, utfør og kjør kjeden. 
   

7. Se gjennom fanen Log i Advanced Query - All Employees Command node, og bekreft at medarbeider-ID-ene stemmer overens med postene som returneres av spørringen.

   Ansattes 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 på en bedre måte. Selv om dette trinnet er påkrevd i forbindelse med denne øvelsen, er det ikke et teknisk krav for kjeden. Dette trinnet er kun for å illustrere muligheten til å organisere noder i en kjede.

1. Legg til en Command Group i kjeden.
2. Koble kommandoen GET - Headcount in XML Format til In-seksjonen i kommandogruppen.
3. Klikk på Kommandogruppen, og velg deretter dråpeikonet for å endre kommandofargen til red.
4. Gi gruppen et navn: Aktive ansatte. 
   

Trinn 8: Filtrer CSV-data kun for aktive ansatte

Bruk et smartfilter for å beholde bare de medarbeideroppføringene der medarbeideren er aktiv. Når vi definerer filteret, antar vi at det at feltet avsluttet (terminert) er tomt, betyr at den ansatte er aktiv.

1. Legg til en Smart Filter Rows -kommando fra Tabular Transformation Connector til kjeden.
2. Koble Group Start fra kommandogruppen til Smart Filter Command.
3. Konfigurer kommandoen ved hjelp av følgende verdier:
   • Gi kommandoen et navn: Smartfilterrader - CSV-data - Aktive ansatte.
   • For parameteren Input file velger du Response Output fra kommandoen GET - Headcount in CSV Format.
   • La filparameteren Output stå tom.
   • Angi Komma som Skilletegn.
   • I delen Filters utfører du følgende trinn:
     1. Klikk på knappen Add på Text filtre.
     2. I parameteren Kolonnenavn skriver du inn med betegnelsen.
     3. Merk av for Case Insensitive.
     4. Velg Equals fra rullegardinmenyen Condition.
     5. I parameteren Compare Text skriver du inn true.
     6. Merk av for alternativet Not.
     7. La avkrysningsruten Trim være avmerket.
        Dette filteret vil nå identifisere alle poster der feltet "termed" ikke inneholder en verdi på true (det vil si at det inneholder "false" eller er tomt).
4. La alternativet Forhåndsvisning av resultat være avmerket.
5. Alternativet Inverse gjør at Smartfilteret enten beholder (avkrysset) eller fjerner (ikke avkrysset) alle rader som samsvarer med filterkriteriene. I denne øvelsen ønsker vi å beholde alle radene der feltet "termed" har verdien true eller blank.
   For å oppnå dette merker du av for Inverse.
6. Lagre kommandoen.
   

Trinn 8: Filtrer CSV-data kun for aktive ansatte

Bruk et smartfilter for å beholde bare de medarbeideroppføringene der medarbeideren er aktiv. Når vi definerer filteret, antar vi at det at feltet avsluttet ("termined") er tomt, betyr at den ansatte er aktiv.

1. Legg til en Smart Filter Rows -kommando fra Tabular Transformation Connector til kjeden.
2. Koble Group Start fra kommandogruppen til Smart Filter Command.
3. Konfigurer kommandoen ved hjelp av følgende verdier:
   • Gi kommandoen et navn: Smartfilterrader - CSV-data - Aktive ansatte.
   • For Input file, velg Response Output fra kommandoen GET - Headcount in CSV Format.
   • La filparameteren Output stå tom.
   • Angi Komma som Skilletegn.
   • I delen Filters,
     1. Klikk på knappen Add på Text filtre.
     2. I parameteren Kolonnenavn skriver du inn med betegnelsen.
     3. Merk av for Case Insensitive.
     4. Velg Equals fra rullegardinmenyen Condition.
     5. I parameteren Compare Text skriver du inn true.
     6. Merk av for alternativet Not.
     7. La avkrysningsruten Trim være avmerket.
        Dette filteret vil nå identifisere alle poster der feltet "termed" ikke inneholder en verdi på true (det vil si at det inneholder "false" eller er tomt).
   • La avmerkingsboksen Preview Result være merket av (avkrysset).
   • Alternativet Inverse gjør at Smartfilteret enten beholder (avkrysset) eller fjerner (ikke avkrysset) alle rader som samsvarer med filterkriteriene. I denne øvelsen ønsker vi å beholde alle radene der feltet termed har verdien true eller blank. For å oppnå dette merker du av for Inverse.
4. Lagre kommandoen.
   

Trinn 9: Filtrer XML-data mens du konverterer 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 Element List til CSV - Alle ansatte Kommando.
2. Koble Group Start fra Command Group til Element List to CSV - All Employees (Copy) Kommando.
3. Rediger kommandoen, og gi den et navn: Element List to CSV - Active Employees.
4. I parameteren "Path to root" skriver du inn følgende.
   /employee_data/employee[termed!='true']
   Dette vil nå identifisere alle poster der feltet "termed" ikke inneholder en verdi på true (det vil si at det inneholder "false" eller er tomt).
5. Lagre kommandoen.
   

Trinn 10: Endre de filtrerte XML-dataene til kommaseparert

I likhet med den fullstendige ansattlisten må den filtrerte listen over aktive ansatte som er konvertert fra XML til tabulatorseparert, konverteres til kommaseparert.

1. Kopier kommandoen Change Delimiter - All Employees.
2. Koble Element List to CSV - Active Employees Command til Element Change Delimiter - All Employees (Copy) Command.
3. Konfigurer kommandoen ved hjelp av følgende verdier.
   • Navn: Endre skilletegn - Aktive ansatte.
   • Endre parameteren Input file til å bruke Converted File Output fra kommandoen Element List to CSV - Active Employees.
4. Lagre kommandoen.
   

Trinn 11: Se etter forskjeller med aktive medarbeidere

I likhet med den fullstendige ansattlisten må den filtrerte listen over aktive ansatte som er konvertert fra XML til tabulatorseparert, konverteres til kommaseparert.

1. Kopier kommandoen Advanced Query - All Employees.
2. Koble Out i kommandogruppen til kommandoen Advanced Query - All Employees (Copy). Ved å koble kommandoen Avansert spørring - Alle ansatte til Gruppe ut sikrer du at alt som er koblet til Gruppestart, avsluttes før kjeden går videre til kommandoene i Gruppe ut.
3. Konfigurer kommandoen ved hjelp av følgende verdier:
   • Navn: Avansert spørring - aktive ansatte.

   • I delen Tables endrer du parameteren File for begge tabellene ved å bruke følgende verdier:

     Tabell	Fil
     XML	CSV-resultatutdata fra kommandoen Endre avgrensning - aktive ansatte
     CSV-fil	Smartfilterradutdata fra Smartfilterrader - Kun aktiv, CSV-datakommando

4. Lagre kommandoen.
   

Trinn 12: Test øvelsen

Nå som kjeden er ferdig, kan du teste resultatet.

1. Publiser the Chain.
2. Klikk på Execute og velg deretter Run Chain. 
   
3. Når kjeden er ferdig kjørt, klikker du på noden Advanced Query - Active Employees.
   1. På Utdata -fanen kan du bekrefte at 4 poster ble sendt ut.

   2. Klikk på fanen Logger, og bekreft at medarbeider-ID-ene stemmer overens med postene som spørringen returnerer.

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

      
      

Hvis du vil lære mer om datatransformasjon ved hjelp av kjeder, kan du sjekke ut Connected Learning Paths - Transformation Introduction!