CLP - Erstatning av data i en tabell – Support Center

Du kan effektivisere datahåndteringen ytterligere ved å kombinere trinnene i samme kjede. I denne Connected Learning Path går vi gjennom den beste måten å erstatte data i en Wdata-tabell på, som er en totrinnsprosess ved hjelp av én Chain.

Primært bruksområde for virksomheten	Bordadministrasjon
Primært læringsmål	Erstatning av data i en Wdata-tabell ved hjelp av kjeder
Forutsetninger	Konfigurer Workiva Connector Konfigurer HTTP Request Connector Fullfør CLP - Laste opp data til en tabellbane Identifiser Tabell-ID for CLP Employee Detail Table
Støttemal	CLP - Erstatt data i en tabell

Trinn 1: Kjør kjeden

Gå til CLP | Last opp data til en tabell Chain.
Klikk på Execute og velg deretter Run With Inputs.
Angi verdier for Runtime Inputs:
- Tabell-ID - ID for CLP Employee Detail Table
  Se dette dokumentet for å få hjelp til å finne ID.
- Filnavn - hvilket som helst navn du ønsker å kalle filen, i dette eksempelet kaller vi filen "Employee Detail".
- Filplassering - https://cs-sftp-training-bucket.s3.amazonaws.com/cs-training/transformation-qs/employee_detail.csv.
Klikk på Start.
Når kjeden er fullført, klikker du på noden Import File into Table for å bekrefte at den er vellykket.
Det finnes nå data i CLP Employee Detail Table, som vi nå vil erstatte med det oppdaterte datasettet ved hjelp av en enkelt kjede for å slette de gamle dataene og laste opp de nye dataene.

Trinn 2: Opprett en kjede

Legg til en ny Kjede.
Gi kjeden et navn: CLP | Erstatt data i en tabell.
Redd kjeden.

Trinn 3: Inndata ved kjøretid

Vi bruker Runtime Inputs-kommandoen til å starte kjeden. Her kan vi angi filnavnet og ID-en til tabellen som filen skal importeres til når vi kjører kjeden.

Legg til en Runtime Inputs Kommando fra Chain Trigger Events i Start-området.
Rediger Runtime Inputs Chain Event ved å dobbeltklikke på kommandoen.
Legg til de tre inngangene nedenfor:
- Inngang 1:
  - Type: TextField
  - Vis navn: Tabell-ID
  - Påkrevd: Krysset av
- Inngang 2:
  - Type: TextField
  - Vis navn: Filnavn
  - Påkrevd: Krysset av
- Inngang 3:
  - Type: TextField
  - Vis navn: Filplassering
  - Påkrevd: Krysset av
Lagre kommandoen.

Trinn 4: Liste opp filer

For å slette den gamle filen i tabellen trenger vi fil-ID-en. For å finne FileID på en programmatisk måte bruker vi kommandoen List Files. Denne kommandoen bruker tabell-ID-en til å søke etter alle filene i den aktuelle tabellen, og gir oss en liste over filene samt informasjon om filene, inkludert fil-ID-en.

Legg til en List Files -kommando i Chain-lerretet
Koble Runtime Inputs Chain Event til List Files Command.
Dobbeltklikk på kommandoen for å konfigurere den, og klikk på feltet Table ID.
Klikk på nedoverpilen i venstre Variabler -panel for å utvide Utløser.
1. Klikk på nedoverpilen for å utvide Runtime Inputs.
2. Velg TableID.
Lagre kommandoen.

Trinn 5: Fjern importfilen fra tabellen

På samme måte som opplasting av data til en tabell, er sletting av data fra en tabell en totrinnsprosess. Filen må først flyttes til statusen Staged før den kan slettes. For å angi filen som iscenesatt, må den avimporteres. Vi vil bruke kommandoen Un-Import File from Table til å forberede datasettet som skal slettes.

Legg til en Un-import File from Table -kommando på Chain-lerretet.
Koble kommandoen List Files til kommandoen Un-import File from Table.
Dobbeltklikk på kommandoen for å konfigurere den.
1. Klikk på feltet Table ID.
  1. Klikk på nedoverpilen i venstre Variabler -panel for å utvide Utløser.
  2. Klikk på nedoverpilen for å utvide Runtime Inputs.
  3. Velg TableID.
2. Klikk på feltet File ID.
  1. Klikk på nedoverpilen i venstre Variabler-panel for å utvide List Files.
  2. Velg Files List.
  3. Klikk på List Files - Files List-variabelen for å transformere variabelen.
    1. Klikk på Velg transformasjon og velg deretter Hent verdi fra JSON.
    2. Klikk på plusstegnet for å legge til variabeltransformasjonen.
    3. Skriv inn '0' i Verdi-feltet, og trykk deretter Enter.
    4. Etter at =0 vises, skriver du inn 'id' og trykker på Enter igjen.
      Variabelen vil nå lese JSON-utdataene fra List Files-kommandoen og finne id-en til den første filen i tabellen.
      Tips! Vær spesielt oppmerksom på store og små bokstaver når du analyserer JSON-verdier.
    5. Klikk på Godta.
3. Lagre kommandoen.
Trinn 6: Last ned fil

Deretter kan vi enten slette den iscenesatte filen fra tabellen, eller vi kan forberede den nye filen som skal lastes opp. Vi anbefaler at du laster opp en ny fil etter at du har avimportert den gamle filen, for å sikre at prosessen er vellykket før data slettes offisielt.

For å klargjøre den nye filen for opplasting, må vi først laste ned filen ved hjelp av HTTP Request Get Command. Vi har lagt ut en fil på nettet som Chain kan laste ned for å demonstrere nedlasting av filer fra skyen.
1. Legg til en Get -kommando fra HTTP Request -kontakten i Chain-lerretet.
2. Koble kommandoen Un-import File from Table til kommandoen Get.
3. Dobbeltklikk på kommandoen for å konfigurere den.
  1. Klikk på feltet URL.
    1. Klikk på nedoverpilen i panelet til venstre Select a Variable for å utvide Trigger.
    2. Klikk på nedoverpilen for å utvide Runtime Inputs.
    3. Velg Filplassering.
  2. Oppdater feltet Content type til: application/csv.
4. Lagre kommandoen.
Trinn 7: Opprett fil

Akkurat som vi gjorde i Last opp data til tabelltilkoblet læringssti, vil vi følge totrinnsprosessen for opplasting av data til Wdata-tabeller. Filen må først opprettes i statusen Staged før den kan importeres for endelig bruk. Vi bruker kommandoen Create File til å opprette filen i Wdata-tabellen i statusen Staged, noe som indikerer at den er opprettet, men ennå ikke importert som et datasett.
1. Legg til en Create File -kommando fra Workiva Connector i Chain-lerretet.
2. Koble kommandoen Get til kommandoen Create File.
3. Dobbeltklikk på kommandoen for å konfigurere den.
  1. Klikk på feltet Table ID.
    1. Klikk på nedoverpilen i panelet til venstre Select a Variable for å utvide Trigger.
    2. Klikk på nedoverpilen for å utvide Runtime Inputs.
    3. Velg Table ID.
  2. Klikk på feltet File .
    1. Klikk på nedoverpilen i panelet til venstre Velg en variabel for å utvide GET.
    2. Velg Response.
  3. Klikk på feltet Navn.
    1. Klikk på nedoverpilen i panelet til venstre Select a Variable for å utvide Trigger.
    2. Klikk på nedoverpilen for å utvide Runtime Inputs.
    3. Velg Filnavn.
    4. Klikk på nedoverpilen i panelet til venstre Select a Variable for å utvide Runtime.
    5. Velg Chain.ExecutionDateTime.
    6. Skriv ".csv" etter de to variablene dine.
      Variabelen Chain.ExecutionDateTime brukes for å vise når filen ble generert, og for å sikre at hver fil har et unikt navn.
Trinn 8: Importer fil til tabell

Neste trinn i prosessen med å laste opp filer til Wdata-tabeller er å importere dataene, slik at de kan brukes i spørringer. Dette trinnet tar den iscenesatte filen og importerer den til den angitte tabellen som et datasett.
1. Legg til en Import File into Table Kommando fra Workiva Connector til Chain canvas.
2. Koble kommandoen Create File til kommandoen Import File into Table.
3. Dobbeltklikk på kommandoen for å konfigurere den.
  - For feltet Table ID:
    1. Klikk på nedoverpilen i det venstre Velg en variabel -panelet for å utvide Utløser.
    2. Klikk på nedoverpilen for å utvide Runtime Inputs.
    3. Velg Tabell-ID.
  - For feltet File ID.
    1. Klikk på nedoverpilen i det venstre Velg en variabel -panelet for å utvide Opprett fil.
    2. Velg Resultat.
    3. Klikk på Create File - Result for å transformere den.
      1. I rullegardinmenyen Select Transformation velger du Get Value from JSON.
      2. Klikk på + (pluss)-knappen.
      3. Skriv inn "id" i Verdi-feltet, og trykk Enter.
      4. Klikk på ACCEPT.
4. Lagre kommandoen
Trinn 9: Slett fil

Nå som de nye dataene er lastet opp og klare til bruk, og det gamle datasettet er staged, er det siste steget å offisielt slette de gamle dataene. I dette trinnet brukes kommandoen Delete File til å slette datasettet fra tabellen.
1. Legg til en Delete File -kommando fra Workiva Connector til Chain-lerretet
2. Koble kommandoen Importer fil til tabell til kommandoen Slett fil
3. Dobbeltklikk på kommandoen for å konfigurere den.
  For å sikre at vi sletter den samme filen som vi avimporterte, genererer vi fil-ID-en på samme måte som vi gjorde for Un-import File from Table-kommandoen:
  - I feltet File ID:
    1. Klikk på nedoverpilen i det venstre Variabler -panelet for å utvide Listefiler.
    2. Velg Files List.
    3. Klikk på variabelen List Files - Files List for å transformere variabelen.
      1. Klikk på Velg transformasjon og velg deretter Hent verdi fra JSON.
      2. Klikk på plusstegnet (+) for å legge til variabeltransformasjonen.
        
        I feltet Value skriver du inn "0" og trykker deretter Enter.
        
        Etter at =0 vises, skriver du inn "id" og trykker på Enter igjen.
        Variabelen vil nå lese JSON-utdataene fra List Files-kommandoen og finne id-en til den første filen i tabellen.
        Tips! Vær spesielt oppmerksom på store og små bokstaver når du analyserer JSON-verdier.
        
        Klikk på Godta
        
        Lagre the Command.xx
        
        Trinn 10: Test øvelsen
        
        Nå som kjeden er ferdig, kan du teste resultatet.
        
        Klikk på Execute og velg deretter Run With Inputs.
        
        Legg til verdier for Runtime Inputs.
        
        Tabell-ID - ID for CLP Employee Detail Table
        Se dette dokumentet for å få hjelp til å finne ID-en
        
        Filnavn - hvilket som helst navn du ønsker å kalle filen; i dette eksemplet kaller vi filen "Employee Detail".
        
        Filplassering - https://cs-sftp-training-bucket.s3.amazonaws.com/cs-training/transformation-qs/employee_detail_replace.csv
        
        Klikk på Start
        
        Kjeden skal ha fjernet den gamle filen og erstattet den med den nye filen i tabellen din.
        
        Du kan bekrefte at dataene ble erstattet i tabellen ved å navigere til tabellen i Wdata og se på datasettene i panelet til høyre.
        
        Hvis du vil vite mer om hvordan du kan bruke kjeder til å effektivisere datainnsamlingen, kan du lese resten av Data Centralization Paths!

Støtte

Fellesskap

Workiva kundestøttesenter