CLP - Gegevens in een tabel vervangen – Centrum wsparcia

U kunt uw gegevensbeheer nog verder stroomlijnen door stappen in dezelfde keten te combineren. In dit Aangesloten Leerpad doorlopen we de beste manier om gegevens in een Wdatatabel te vervangen, wat een proces in twee stappen is met behulp van één Chain.

Primaire zakelijke gebruikssituatie	Tabel Beheer
Primair leerdoel	Gegevens vervangen in een Wdatatabel met behulp van Chains
Vereisten	Configureer Workiva Connector Configureer HTTP Request Connector Voltooien CLP - Gegevens uploaden naar een tabelpad Identificeer de Tabel-ID van de CLP-tabel met werknemergegevens
Ondersteunende sjabloon	CLP - Gegevens in een tabel vervangen

Stap 1: Ketting uitvoeren

Navigeer naar CLP | Gegevens uploaden naar een tabel Chain.
Klik op Execute en selecteer vervolgens Run With Inputs.
Voer waarden in voor uw Runtime Inputs:
- Tabel ID - ID van de CLP Werknemer Detail Tabel
  Raadpleeg 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 Chain voltooid is, 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 één 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 in een tabel vervangen.
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 zal worden wanneer we de Chain uitvoeren.

Voeg een Runtime Inputs opdracht toe vanuit Chain Trigger Events het Start-gebied.
Bewerk de Runtime Inputs Chain Event door te dubbelklikken op de opdracht.
Voeg de drie onderstaande ingangen toe:
- Ingang 1:
  - Type: Tekstveld
  - Naam weergeven: Tabel ID
  - Vereist: Aangevinkt
- Ingang 2:
  - Type: Tekstveld
  - Naam weergeven: Bestandsnaam
  - Vereist: Aangevinkt
- Input 3:
  - Type: Tekstveld
  - Naam weergeven: Bestandslocatie
  - Vereist: Aangevinkt
Sla de opdracht op.

Stap 4: Bestanden weergeven

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

Een opdracht List Files toevoegen aan het Chain canvas
Verbind de Runtime Inputs Chain Event met de List Files opdracht.
Dubbelklik op de opdracht om deze te configureren. en klik op het veld Table ID.
Klik in het linkerpaneel Variables op de pijl omlaag om Trigger uit te vouwen.
1. Klik op de pijl omlaag om Runtime Inputs uit te vouwen.
2. Selecteer TableID.
Sla de opdracht op.

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 moet eerst naar de staged status verplaatst worden voordat het verwijderd kan worden. Om het bestand als staged in te stellen, moet het gedeïmporteerd worden. We zullen de opdracht Un-Import File from Table gebruiken om de te verwijderen dataset voor te bereiden.

Voeg een Un-import File from Table commando toe aan het Chain canvas.
Verbind de opdracht Lijst van bestanden met de opdracht Bestand uit tabel verwijderen.
Dubbelklik op de opdracht om deze te configureren.
1. Klik op het veld Table ID.
  1. Klik in het linkerpaneel Variables op de pijl omlaag om Trigger uit te vouwen.
  2. Klik op de pijl omlaag om Runtime Inputs uit te vouwen.
  3. Selecteer TableID.
2. Klik op het veld File ID.
  1. Klik in het linker paneel Variabelen op de pijl omlaag om List Files uit te vouwen.
  2. Selecteer Bestandenlijst.
  3. Klik op List Files - Files List variabele om de variabele te transformeren.
    1. Klik op Selecteer Transformatie en selecteer vervolgens Waarde uit JSON halen.
    2. Klik op het plusteken om de variabele transformatie toe te voegen.
    3. Typ in het veld Waarde '0' en druk vervolgens op Enter.
    4. Nadat =0 verschijnt, typt u 'id' en drukt u nogmaals op Enter.
      De variabele leest nu de JSON-uitvoer van de opdracht List Files en vindt het id van het eerste bestand in de tabel.
      Tip! Let vooral op hoofdletters en kleine letters bij het parsen van JSON-waarden.
    5. Klik op accepteren .
3. Opslaan de opdracht.
Stap 6: Bestand downloaden

Vervolgens kunnen we het opgevoerde bestand uit de Tabel verwijderen, of we kunnen het nieuwe bestand voorbereiden om te uploaden. Wij raden u aan een nieuw bestand te uploaden nadat u het oude bestand hebt gedeïmporteerd, om er zeker van te zijn dat het proces succesvol verloopt 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 zodat de Chain het kan downloaden om het downloaden van bestanden uit de cloud aan te tonen.
1. Voeg een Get opdracht van de HTTP Request connector toe aan het Chain canvas.
2. Verbind de opdracht Bestand uit tabel verwijderen met de opdracht ophalen.
3. Dubbelklik op de opdracht om deze te configureren.
  1. Klik op het veld URL.
    1. Klik in het linkerpaneel Select a Variable op de pijl omlaag om Trigger uit te vouwen.
    2. Klik op de pijl omlaag om Runtime Inputs uit te vouwen.
    3. Selecteer Bestandslocatie.
  2. Werk het veld Inhoudstype bij tot: toepassing/csv.
4. Opslaan de opdracht.
Stap 7: Bestand maken

Net zoals we deden in het leerpad Gegevens uploaden naar tabel, zullen we het tweestappenproces volgen voor het uploaden van gegevens naar Wdatatabellen. Het bestand moet eerst aangemaakt worden in de status Staged voordat het geïmporteerd kan worden voor definitief gebruik. We zullen de opdracht Bestand maken gebruiken om het bestand binnen de Wdatatabel in de status Staged te maken, wat aangeeft dat het is gemaakt maar nog niet als een dataset is geïmporteerd.
1. Voeg een Create File commando van de Workiva Connector toe aan het Chain canvas.
2. Verbind de opdracht Get met de opdracht Create File.
3. Dubbelklik op de opdracht om deze te configureren.
  1. Klik op het veld Table ID.
    1. Klik in het linkerpaneel Select a Variable op de pijl omlaag om Trigger uit te vouwen.
    2. Klik op de pijl omlaag om Runtime Inputs uit te vouwen.
    3. Selecteer Table ID.
  2. Klik op het veld Bestand .
    1. Klik in het linkerpaneel Select a Variable op de pijl omlaag om GET uit te vouwen.
    2. Selecteer Reactie.
  3. Klik op het veld Name.
    1. Klik in het linkerpaneel Select a Variable op de pijl omlaag om Trigger uit te vouwen.
    2. Klik op de pijl omlaag om Runtime Inputs uit te vouwen.
    3. Selecteer Bestandsnaam.
    4. Klik in het linkerpaneel Select a Variable op de pijl omlaag om Runtime uit te vouwen.
    5. Selecteer Chain.ExecutionDateTime.
    6. Typ ".csv" na uw twee variabelen.
      De variabele Chain.ExecutionDateTime wordt gebruikt 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 volgende stap in het proces van het uploaden van bestanden 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.
1. Voeg een Bestand importeren in tabel opdracht van de Workiva Connector toe aan het Chain canvas.
2. Verbind de opdracht Bestand maken met de opdracht Bestand importeren in tabel.
3. Dubbelklik op de opdracht om deze te configureren.
  - Voor het veld Table ID:
    1. Klik in het linkerpaneel Een variabele selecteren op de pijl omlaag om Trigger uit te vouwen.
    2. Klik op de pijl omlaag om Runtime Inputs uit te vouwen.
    3. Selecteer Tabel ID.
  - Voor het veld File ID.
    1. Klik in het linkerpaneel Een variabele selecteren op de pijl omlaag om Bestand maken uit te vouwen.
    2. Selecteer Resultaat.
    3. Klik op Bestand maken - Resultaat om het te transformeren.
      1. Selecteer in de vervolgkeuzelijst Selecteer transformatie Waarde uit JSON halen.
      2. Klik op de knop + (plus).
      3. Typ in het veld Waarde "id" en druk op Enter.
      4. Klik op ACCEPT.
4. Opslaan de opdracht
Stap 9: Bestand verwijderen

Nu de nieuwe gegevens geüpload en klaar voor gebruik zijn en de oude dataset opgevoerd is, is de laatste stap het officieel verwijderen van de oude gegevens. Deze stap gebruikt de opdracht Bestand verwijderen om de dataset uit de Tabel te verwijderen.
1. Een Bestand verwijderen opdracht toevoegen van de Workiva Connector aan het Chain canvas
2. Verbind de opdracht Bestand importeren in tabel met de opdracht Bestand verwijderen
3. Dubbelklik op de opdracht om deze te configureren.
  Om er zeker van te zijn dat we hetzelfde bestand verwijderen dat we uit de tabel hebben geïmporteerd, genereren we het bestands-ID op dezelfde manier als we hebben gedaan voor de opdracht Bestand uit tabel verwijderen:
  - In het veld File ID:
    1. Klik in het linkerpaneel Variables op de pijl omlaag om List Files uit te vouwen.
    2. Selecteer Bestandenlijst.
    3. Klik op de variabele List Files - Files List om de variabele te transformeren.
      1. Klik op Selecteer Transformatie en selecteer vervolgens Waarde uit JSON halen.
      2. Klik op het plusteken (+) om de variabele transformatie toe te voegen.
        
        Typ in het veld Value '0' en druk vervolgens op Enter.
        
        Nadat =0 verschijnt, typt u 'id' en drukt u nogmaals op Enter .
        De variabele leest nu de JSON-uitvoer van de opdracht List Files en vindt het id van het eerste bestand in de tabel.
        Tip! Let vooral op hoofdletters en kleine letters bij het parsen van JSON-waarden.
        
        Klik op Accepteren
        
        Opslaan de opdracht.xx
        
        Stap 10: De oefening testen
        
        Nu de Chain compleet is, kunt u het resultaat testen.
        
        Klik op Execute en selecteer vervolgens Run With Inputs.
        
        Voeg waarden toe voor uw Runtime Inputs.
        
        Tabel ID - ID van de CLP Werknemer Detail Tabel
        Raadpleeg 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 "Werknemersgegevens".
        
        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 uw Tabel.
        
        U kunt controleren of de gegevens in uw tabel zijn vervangen door naar de tabel in Wdata te navigeren en de datasets in het rechterpaneel te bekijken.
        
        Als u meer wilt weten over het gebruik van Chains om het verzamelen van gegevens te stroomlijnen, bekijk dan de rest van de Data Centralization Paths!

Ondersteuning

Community

Workiva-ondersteuningscentrum