Workiva supportcenter

Du kan effektivisera din datahantering ytterligare genom att kombinera olika steg i samma kedja. I denna Connected Learning Path kommer vi att gå igenom det bästa sättet att ersätta data i en Wdata-tabell, vilket är en tvåstegsprocess med en kedja.

Steg 1: Kör kedjan

1. Navigera till CLP | Ladda upp data till en tabell Chain.
2. Klicka på Execute och välj sedan Run With Inputs.
3. Ange värden för dina Runtime Inputs:
   • Tabell-ID - ID för CLP Employee Detail Table
     Kolla in det här dokumentet för att få hjälp med att hitta ID.
   • Filnamn - vilket namn du vill kalla filen, i det här exemplet kallar vi filen "Employee Detail".
   • Filplats - https://cs-sftp-training-bucket.s3.amazonaws.com/cs-training/transformation-qs/employee_detail.csv.
4. Klicka på Starta.
5. När kedjan har slutförts klickar du på noden Import File into Table för att verifiera att den har lyckats.
   Det finns nu data tillgängliga i CLP Employee Detail Table, som vi nu kommer att ersätta med det uppdaterade datasetet, med hjälp av en enda kedja för att radera de gamla uppgifterna och ladda upp de nya uppgifterna.

Steg 2: Skapa en kedja

1. Lägg till en ny Kedja.
2. Namnge kedjan: CLP | Byt ut data i en tabell.
3. Rädda kedjan.

Steg 3: Inmatningar vid exekvering

Vi använder kommandot Exekvering av ingångar för att starta kedjan. Detta gör att vi kan ange filnamnet och ID:t för den tabell som filen ska importeras till när vi kör kedjan.

1. Lägg till en Runtime Inputs Command from Chain Trigger Events i Start-området.
2. Redigera Runtime Inputs Chain Event genom att dubbelklicka på kommandot.
   Lägg till de tre ingångarna nedan:
   • Ingång 1:
     • Typ av fält: Textfält
     • Visa namn: Tabell-ID
     • Krävs: Kontrollerad
   • Ingång 2:
     • Typ av fält: Textfält
     • Visa namn: Filnamn
     • Krävs: Kontrollerad
   • Ingång 3:
     • Typ av fält: Textfält
     • Visa namn: Plats för arkivering
     • Krävs: Kontrollerad
3. Spara kommandot.

Steg 4: Lista arkivering

För att kunna ta bort den gamla filen i tabellen behöver vi File ID. För att programmatiskt hitta FileID använder vi kommandot List Files. Detta kommando använder tabell-ID:t för att söka efter alla filer i tabellen och ger oss en utskrift av filerna samt information om dessa filer, inklusive fil-ID:t.

1. Lägg till en List Files Command till Chain canvas
2. Koppla Runtime Inputs Chain Event till List Files Command.
3. Dubbelklicka på kommandot för att konfigurera det. och klicka på fältet Table ID .
4. I den vänstra panelen Variables klickar du på nedåtpilen för att expandera Trigger.
   1. Klicka på nedåtpilen för att expandera Runtime Inputs.
   2. Välj TableID.
5. Spara kommandot.

Steg 5: Ta bort importfilen från tabellen

På samma sätt som när du laddar upp data till en tabell är borttagning av data från en tabell en process i två steg. Filen måste först flyttas till staged-status innan den kan raderas. För att ställa in arkiveringen som staged måste den avimporteras. Vi kommer att använda kommandot Un-Import File from Table för att förbereda den datauppsättning som ska raderas.

1. Lägg till en Avimportera fil från tabell Kommando till kedjans canvas.
2. Anslut kommandot List Files till kommandot Un-import File from Table . 
3. Dubbelklicka på kommandot för att konfigurera det.
   1. Klicka på fältet Table ID .
      1. I den vänstra panelen Variables klickar du på nedåtpilen för att expandera Trigger.
      2. Klicka på nedåtpilen för att expandera Runtime Inputs.
      3. Välj TableID.
   2. Klicka på fältet File ID .
      1. I den vänstra panelen Variabler klickar du på nedåtpilen för att expandera Lista filer.
      2. Välj Filer Lista.
      3. Klicka på Lista Filer - Lista Filer variabeln för att transformera variabeln.
         1. Klicka på Select Transformation och välj sedan Get Value from JSON.
         2. Klicka på plustecknet för att lägga till variabelomvandlingen.
         3. Skriv in '0' i fältet Value och tryck sedan på Enter.
         4. När =0 visas skriver du 'id' och trycker på Ange igen.
            Variabeln kommer nu att läsa JSON-utdata från kommandot List Files och hitta id:t för den första arkiveringen i tabellen.

            Tips! Var särskilt uppmärksam på stora och små bokstäver när JSON-värden analyseras.

         5. Klicka på Godkänn.
            
   3. Spara kommandot.
      

    

   Steg 6: Ladda ner arkivering

   Därefter kan vi antingen ta bort den upplagda filen från tabellen eller förbereda den nya filen för uppladdning. Vi rekommenderar att du laddar upp en ny fil efter att du har avimporterat den gamla filen för att säkerställa att processen är framgångsrik innan några data raderas officiellt.

   För att förbereda den nya filen för uppladdning måste vi först hämta filen med hjälp av HTTP Request Get Command. Vi har lagt upp en fil online som Chain kan ladda ner för att demonstrera nedladdning av filer från molnet.

   1. Lägg till ett Get -kommando från HTTP Request -anslutningen i Chain-kanvasen.
   2. Anslut kommandot Un-import File from Table till kommandot Get .
   3. Dubbelklicka på kommandot för att konfigurera det.
      
      1. Klicka på fältet URL .
         1. I den vänstra panelen Select a Variable klickar du på nedåtpilen för att expandera Trigger.
         2. Klicka på nedåtpilen för att expandera Runtime Inputs.
         3. Välj File Location.
      2. Uppdatera fältet Content type till: application/csv.
   4. Spara kommandot.

   

   Steg 7: Skapa arkivering

   Precis som vi gjorde i Upload Data to Table Connected Learning Path, kommer vi att följa tvåstegsprocessen för att ladda upp data till Wdata-tabeller. Filen måste först skapas i statusen Staged innan den kan importeras för slutlig användning. Vi kommer att använda kommandot Create File för att skapa filen i Wdata Table i statusen Staged, vilket indikerar att den har skapats men ännu inte importerats som ett dataset.

   1. Lägg till ett Create File Command från Workiva Connector till Chain canvas.
   2. Anslut kommandot Get till kommandot Create File .
   3. Dubbelklicka på kommandot för att konfigurera det.
      
      1. Klicka på fältet Table ID .
         1. I den vänstra panelen Select a Variable klickar du på nedåtpilen för att expandera Trigger.
         2. Klicka på nedåtpilen för att expandera Runtime Inputs.
         3. Välj Tabell-ID.
      2. Klicka på fältet File .
         1. I den vänstra panelen Select a Variable klickar du på nedåtpilen för att expandera GET.
         2. Välj Svar.
      3. Klicka på fältet Namn .
         1. I den vänstra panelen Select a Variable klickar du på nedåtpilen för att expandera Trigger.
         2. Klicka på nedåtpilen för att expandera Runtime Inputs.
         3. Välj Filnamn.
         4. I den vänstra panelen Select a Variable klickar du på nedåtpilen för att expandera Runtime.
         5. Välj Chain.ExecutionDateTime.
         6. Skriv ".csv" efter dina två variabler.
            Variabeln Chain.ExecutionDateTime används för att visa när filen genererades och för att säkerställa att varje fil har ett unikt namn.

   

   Steg 8: Importera arkivering till tabell

   Nästa steg i processen med att ladda upp filer till Wdata-tabeller är att importera data så att de kan användas i Queries. Detta steg tar den arrangerade filen och importerar den till den angivna tabellen som en dataset.

   1. Lägg till en importfil i tabell Kommando från Workiva Connector till Chain canvas.
   2. Anslut kommandot Create File till kommandot Import File into Table .
   3. Dubbelklicka på kommandot för att konfigurera det.
      
      • För fältet Table ID :
        1. I den vänstra panelen Select a Variable klickar du på nedåtpilen för att expandera Trigger.
        2. Klicka på nedåtpilen för att expandera Runtime Inputs.
        3. Välj Tabell-ID.
      • För fältet File ID .
        1. I den vänstra panelen Select a Variable klickar du på nedåtpilen för att expandera Create File.
        2. Välj Resultat.
        3. Klicka på Create File - Result för att omvandla den.
           1. I rullgardinsmenyn Select Transformation väljer du Get Value from JSON.
           2. Klicka på + (plus)-knappen.
           3. Skriv "id" i fältet Value och tryck på Enter.
           4. Klicka på ACCEPT.
   4. Spara kommandot

   

   Steg 9: Ta bort arkivering

   Nu när de nya uppgifterna har laddats upp och är klara att användas och det gamla datasetet har stationerats, är det sista steget att officiellt radera de gamla uppgifterna. I detta steg används kommandot Delete File för att ta bort datasetet från tabellen.

   1. Lägga till en Ta bort arkivering Kommando från Workiva Connector till Chain canvas
   2. Koppla Import File into Table Command till Delete File Command
   3. Dubbelklicka på kommandot för att konfigurera det.
      För att säkerställa att vi tar bort samma fil som vi avimporterade, genererar vi fil-ID på samma sätt som vi gjorde för kommandot Avimportera fil från tabell:
      • I fältet File ID :
        1. I den vänstra panelen Variables klickar du på nedåtpilen för att expandera List Files.
        2. Välj Filer Lista.
        3. Klicka på variabeln Lista filer - Lista filer för att omvandla variabeln.
           1. Klicka på Select Transformation och välj sedan Get Value from JSON.
           2. Klicka på plustecknet (+) för att lägga till variabelomvandlingen.
              1. I fältet Value skriver du "0" och trycker sedan på Enter.
              2. När =0 visas skriver du "id" och trycker på Skriv in igen.
                 Variabeln kommer nu att läsa JSON-utdata från kommandot List Files och hitta id:t för den första arkiveringen i tabellen.

                 Tips! Var särskilt uppmärksam på stora och små bokstäver när JSON-värden analyseras.

              3. Klicka på Godkänn
                 
              4. Spara kommandot.xx
                 

               

              Steg 10: Testa övningen

              Nu när kedjan är klar kan du testa resultatet.

              1. Klicka på Execute och välj sedan Run With Inputs.
              2. Lägg till värden för dina Runtime Inputs.
                 • Tabell-ID - ID för CLP-medarbetarens detaljtabell
                   Kolla in det här dokumentet för hjälp med att hitta ID
                 • Filnamn - vilket namn du vill ge filen; i det här exemplet kallar vi filen "Employee Detail".
                 • Filplats - https://cs-sftp-training-bucket.s3.amazonaws.com/cs-training/transformation-qs/employee_detail_replace.csv
              3. Klicka på Start
                 • Chain bör ha lyckats ta bort den gamla filen och ersatt den med den nya filen i din tabell.
                 • Du kan verifiera att data ersattes i din tabell genom att navigera till tabellen i Wdata och granska datauppsättningarna i den högra panelen.

              

              

              Om du vill veta mer om hur du använder kedjor för att effektivisera datainsamlingen kan du kolla in resten av Data Centralization Paths!