CLP - Gegevens vervangen in een tabel

Stap 1: Ketting uitvoeren

• Navigeer naar CLP | Gegevens uploaden naar een tabel Keten
• Klik op Uitvoeren en selecteer vervolgens Uitvoeren met invoer
• Waarden toevoegen voor uw Runtime-ingangen
  • Tabel-ID - ID van de CLP werknemer detailtabel
    • Bekijk dit document voor hulp bij het vinden van de ID
  • Bestandsnaam - elke naam die u aan het bestand wilt geven. In dit voorbeeld noemen we het bestand "Employee Detail".
  • Bestandslocatie - https://cs-sftp-training-bucket.s3.amazonaws.com/cs-training/transformation-qs/employee_detail.csv
• Klik op Start
• Zodra de ketting is voltooid, klikt u op het knooppunt Import File into Table om het succes te verifiëren
  • Er zijn nu gegevens beschikbaar in de CLP Employee Detail Table, die we nu zullen vervangen door de bijgewerkte dataset, waarbij we een enkele keten gebruiken om de oude gegevens te verwijderen en de nieuwe gegevens te uploaden.

Stap 2: Maak een ketting

• Voeg een nieuwe Ketting toe
  • Geef de Chain een naam: CLP | Gegevens vervangen in een tabel
• Red de ketting

Stap 3: Runtime-ingangen

We gebruiken het commando Runtime Inputs om de Chain te starten. Hiermee kunnen we de bestandsnaam en de ID van de tabel specificeren waarin het bestand geïmporteerd wordt als we de Chain uitvoeren.

• Voeg een Runtime Inputs commando toe van Chain Trigger Events het Start-gebied
• Bewerk de gebeurtenis Runtime Inputs Chain door te dubbelklikken op de opdracht
  
  • Voeg de drie onderstaande ingangen toe:
    • Ingang 1:
      • Type: Tekstveld
      • Naam weergeven: Tabel ID
      • Vereist: Aangevinkt
    • Input 2:
      • Type: Tekstveld
      • Naam weergeven: Bestandsnaam
      • Vereist: Aangevinkt
    • Input 3:
      • Type: Tekstveld
      • Naam weergeven: Bestandslocatie
      • Vereist: Aangevinkt
• De opdracht opslaan

Stap 4: Bestanden weergeven

Om het oude bestand in de tabel te verwijderen, hebben we het bestands-ID nodig. Om de FileID programmatisch te vinden, gebruiken we de opdracht List Files. Deze opdracht gebruikt de tabel-ID om alle bestanden in die tabel te zoeken en geeft ons een uitvoer van de bestanden en informatie over die bestanden, inclusief de bestands-ID.

• Voeg een opdracht List Files toe aan het Chain canvas
• Verbind de Runtime Inputs Chain Event met de List Files Command 
• Dubbelklik op de opdracht om deze te configureren
  
  • Klik op het veld Table ID
    • Klik in het linkerpaneel Variables op de pijl omlaag om Trigger uit te vouwen
    • Klik op de pijl omlaag om Runtime Inputs uit te vouwen
    • Selecteer TabelID
• De opdracht opslaan

Stap 5: Bestand van tabel verwijderen

Net als het uploaden van gegevens naar een Tabel, is het verwijderen van gegevens uit een Tabel een proces in twee stappen. Het bestand zal eerst naar de status staged moeten worden verplaatst voordat het kan worden verwijderd. Om het bestand als staged in te stellen, moet het gedeïmporteerd worden. We gebruiken de opdracht Bestand uit tabel importeren om de te verwijderen dataset voor te bereiden.

• Voeg een Un-import File from Table commando toe aan het Chain canvas
• Verbind het commando Lijst van bestanden met het commando Bestand uit tabel verwijderen 
• Dubbelklik op de opdracht om deze te configureren
  
  • Klik op het veld Table ID
    • Klik in het linkerpaneel Variables op de pijl omlaag om Trigger uit te vouwen
    • Klik op de pijl omlaag om Runtime Inputs uit te vouwen
    • Selecteer TabelID
  • Klik op het veld Bestands-ID
    • Klik in het linkerpaneel Variabelen op de pijl omlaag om Lijstbestanden uit te vouwen
    • Selecteer Bestandenlijst
    • Klik op de variabele Lijst bestanden - Lijst bestanden om de variabele te transformeren
      • Klik op Selecteer transformatie en selecteer dan Waarde uit JSON halen
      • Klik op het plusteken om de variabele transformatie toe te voegen
        • Typ in het veld Waarde '0' en druk op enter. Typ na het verschijnen van =0 'id' en druk nogmaals op enter. De variabele leest nu de JSON uitvoer van het List Files commando en vindt het id van het eerste bestand in de tabel.

Tip! Besteed speciale aandacht aan hoofdletters versus kleine letters bij het parsen van JSON-waarden

• • • • Klik op Accepteren
        
• De opdracht opslaan

Stap 6: Bestand downloaden

Vervolgens kunnen we het opgevoerde bestand verwijderen uit de Tabel of we kunnen het nieuwe bestand voorbereiden om te uploaden. Het wordt aanbevolen om een nieuw bestand te uploaden nadat het oude bestand is gedeïmporteerd om er zeker van te zijn dat het proces succesvol is voordat gegevens officieel worden verwijderd. Om het nieuwe bestand voor te bereiden voor het uploaden, moeten we het bestand eerst downloaden met het HTTP Request Get commando. We hebben een bestand online gehost dat de Chain kan downloaden om het downloaden van bestanden uit de cloud aan te tonen.

• Voeg een Get commando van de HTTP Request connector toe aan het Chain canvas
• Verbind de opdracht Bestand uit tabel verwijderen met de opdracht  ophalen
• Dubbelklik op de opdracht om deze te configureren
  
  • Klik op het veld URL
    • Klik in het linkerpaneel Een variabele selecteren op de pijl omlaag om Trigger uit te vouwen
    • Klik op de pijl omlaag om Runtime Inputs uit te vouwen
    • Selecteer Bestandslocatie
  • Werk het veld Inhoudstype bij naar: toepassing/csv
• De opdracht opslaan

Stap 7: Bestand maken

Net zoals we deden in het leerpad Gegevens uploaden naar tabel, volgen we het tweestappenproces voor het uploaden van gegevens naar Wdatatabellen. Het bestand moet eerst worden aangemaakt in de status Staged voordat het kan worden geïmporteerd voor definitief gebruik. We gebruiken de opdracht Bestand maken om het bestand te maken binnen de tabel Wdata in de status Staged, wat aangeeft dat het bestand is gemaakt maar nog niet is geïmporteerd als een dataset.

• Voeg een Bestand maken commando van de Workiva Connector toe aan het Chain canvas
• Verbind de opdracht Get met de opdracht Bestand maken
• Dubbelklik op de opdracht om deze te configureren
  
  • Klik op het veld Table ID
    • Klik in het linkerpaneel Een variabele selecteren op de pijl omlaag om Trigger uit te vouwen
    • Klik op de pijl omlaag om Runtime Inputs uit te vouwen
    • Selecteer Tabel-ID
  • Klik op het veld Bestand
    • Klik in het linkerpaneel Selecteer een variabele op de pijl omlaag om GET uit te vouwen
    • Selecteer Reactie
  • Klik op het veld Naam
    • Klik in het linkerpaneel Een variabele selecteren op de pijl omlaag om Trigger uit te vouwen
    • Klik op de pijl omlaag om Runtime Inputs uit te vouwen
    • Selecteer Bestandsnaam
    • Klik in het linkerpaneel Select a Variable op de pijl omlaag om Runtime uit te vouwen
    • Selecteer Keten.UitvoeringsDatumTijd
    • Typ ".csv" na je twee variabelen
      • We gebruiken de variabele Chain.ExecutionDateTime om aan te geven wanneer het bestand gegenereerd is en om ervoor te zorgen dat elk bestand een unieke naam heeft

Stap 8: Importeer bestand naar tabel

De tweede stap in het proces om bestanden te uploaden naar Wdata-tabellen is het importeren van de gegevens, zodat ze bruikbaar worden in Queries. Deze stap neemt het opgevoerde bestand en importeert het in de aangewezen tabel als een dataset.

• Voeg een Bestand importeren in tabel commando toe vanuit de Workiva Connector aan het Chain canvas
• Verbind de opdracht Bestand maken met de opdracht Bestand importeren in tabel
• Dubbelklik op de opdracht om deze te configureren
  
  • Klik op het veld Table ID
    • Klik in het linkerpaneel Een variabele selecteren op de pijl omlaag om Trigger uit te vouwen
    • Klik op de pijl omlaag om Runtime Inputs uit te vouwen
    • Selecteer Tabel-ID
  • Klik op het veld Bestands-ID
    • Klik in het linkerpaneel Een variabele selecteren op de pijl omlaag om Bestand maken uit te vouwen
    • Selecteer Resultaat
    • Klik op Bestand maken - Resultaat om het te transformeren
      • Selecteer in de vervolgkeuzelijst Selecteer transformatie , Haal waarde uit JSON
      • Klik op de knop +
      • Typ in het veld Waarde id en druk op Enter
      • Klik op ACCEPTEREN
• De opdracht opslaan

Stap 9: Bestand verwijderen

Nu de nieuwe gegevens zijn geüpload en klaar zijn voor gebruik en de oude dataset is opgevoerd, is de laatste stap het officieel verwijderen van de oude gegevens. Deze stap gebruikt het commando Bestand verwijderen om de dataset uit de Tabel te verwijderen.

• Een commando toevoegen Bestand verwijderen van de Workiva Connector aan het Chain canvas
• Verbind de opdracht Bestand importeren in tabel met de opdracht Bestand verwijderen 
• Dubbelklik op de opdracht om deze te configureren
  
  • Om er zeker van te zijn dat we hetzelfde bestand verwijderen dat we hebben gede-importeerd, genereren we het bestands-ID op dezelfde manier als we hebben gedaan voor de opdracht Bestand de-importeren uit tabel, zoals hieronder beschreven:
  • Klik op het veld Bestands-ID
    • Klik in het linkerpaneel Variabelen op de pijl omlaag om Lijstbestanden uit te vouwen
    • Selecteer Bestandenlijst
    • Klik op de variabele Lijst bestanden - Lijst bestanden om de variabele te transformeren
      • Klik op Selecteer transformatie en selecteer dan Waarde uit JSON halen
      • Klik op het plusteken om de variabele transformatie toe te voegen
        • Typ in het veld Waarde '0' en druk op enter. Typ na het verschijnen van =0 'id' en druk opnieuw op enter. De variabele leest nu de JSON uitvoer van het List Files commando en vindt het id van het eerste bestand in de tabel.

Tip! Besteed speciale aandacht aan hoofdletters versus kleine letters bij het parsen van JSON-waarden

• • • • Klik op Accepteren
        
• De opdracht opslaan

Stap 10: De oefening testen

Test het resultaat nu de Chain compleet is.

• Klik op Uitvoeren en selecteer vervolgens Uitvoeren met invoer
• Waarden toevoegen voor uw Runtime-ingangen
  • Tabel-ID - ID van de CLP werknemer detailtabel
    • Bekijk dit document voor hulp bij het vinden van de ID
  • Bestandsnaam - elke naam die u aan het bestand wilt geven. In dit voorbeeld noemen we het bestand "Employee Detail".
  • Bestandslocatie - https://cs-sftp-training-bucket.s3.amazonaws.com/cs-training/transformation-qs/employee_detail_replace.csv
• Klik op Start
  • De Chain zou het oude bestand succesvol moeten hebben verwijderd en vervangen door het nieuwe bestand in je Tabel
  • Je kunt controleren of de gegevens in je tabel zijn vervangen door naar de tabel in Wdata te navigeren en de datasets in het rechterpaneel te bekijken

Voor meer informatie over het gebruik van Chains om dataverzameling te stroomlijnen, bekijk de rest van de Data Centralization Paths!