Workiva-ondersteuningscentrum

Het vereenvoudigen van het uploaden van een gegevensbestand naar een Wdata-tabel is een kernvaardigheid in het stroomlijnen van tabelbeheer. In dit Aangesloten Leerpad doorlopen we hoe u gegevens kunt uploaden naar een Wdatatabel met behulp van Chains.

Stap 1: Een tabel maken

1. Navigeer naar Wdata
2. Voer de stappen uit om een Table aan te maken met de volgende eigenschappen:
   • Tabelnaam: "CLP Werknemer Detail".

   • Kolommen:

     Naam weergeven	Kolom ID	type	Formaat importeren
     emp_id	emp_id	Tekst
     gebruikersnaam	gebruikersnaam	Tekst
     voornaam	voornaam	Tekst
     achternaam	achternaam	Tekst
     functie_titel	functie_titel	Tekst
     afdeling	afdeling	Tekst
     stad	stad	Tekst
     land	land	Tekst
     valuta	valuta	Tekst
     huur_datum	huur_datum	Datum	M/d/jjj
     fte	fte	Decimaal	1,000.00
     genoemd	genoemd	Booleaanse

Opmerkingen:

• Merk op dat het importformaat van de hire_date waarden wordt gewijzigd. Dit is zodat het overeenkomt met het formaat van de gegevens die in de tabel geladen zullen worden. Informatie over datum-/tijdnotaties vindt u op deze pagina.
• Noteer het Tabel ID van de tabel, omdat dit later in deze procedure gebruikt zal worden.

Stap 2: Maak een ketting

1. Navigeer naar Chain Builder.
2. Voeg een nieuwe Ketting toe.
3. Geef de Chain een naam: CLP | Gegevens uploaden naar een tabel.
4. Red de ketting.

Stap 3: Runtime-ingangen

Gebruik de Runtime Inputs Chain Event 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. Lees meer over Runtime Inputs.

1. Voeg een Runtime Inputs Chain Event van Chain Trigger Events toe aan het Startknooppunt.
2. Bewerk de Runtime Inputs Chain Event door te dubbelklikken op de opdracht.
   • Voeg de waarden toe voor uw Runtime Inputs.
     Dit zijn tekstvelden en moeten als "Verplicht" gemarkeerd worden.
     • Table ID - ID van de tabel "CLP-werknemergegevens".
       Kijk op dit document voor hulp bij het vinden van het ID.
     • Bestandsnaam - elke naam die u aan het bestand wilt geven.
       Noem het bestand in dit voorbeeld "Employee Detail".
   • Bestandslocatie - Waar het CSV-bestand zich bevindt.
     Gebruik in dit voorbeeld: https://cs-sftp-training-bucket.s3.amazonaws.com/cs-training/transformation-qs/employee_detail.csv
3. Klik op Opslaan om de opdracht op te slaan.

Stap 4: Bestand downloaden

Het HTTP Request Get Command wordt gebruikt om het bestand te downloaden dat naar de tabel wordt geüpload. We hebben een bestand online gehost dat de Chain kan downloaden om het downloaden van bestanden uit de cloud te demonstreren.

1. Voeg een Get opdracht van de HTTP Request connector toe aan het Chain canvas.
2. Verbind de Runtime Inputs Chain Event met de Get opdracht.
3. Dubbelklik op de opdracht om deze te configureren.
   1. Klik op het veld URL.
      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 Bestandslocatie.
   2. Selecteer in het veld Type inhoud: application/csv.
4. Sla de opdracht op.

Stap 5: Bestand maken

Het uploaden van een bestand naar een Wdatatabel verloopt in twee stappen. 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 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 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.
   2. Klik op het veld Bestand .
      1. Klik in het linkerpaneel Een variabele selecteren op de pijl omlaag om GET uit te vouwen.
      2. Selecteer Response.
   3. Klik op het veld Name.
      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 Bestandsnaam.
      4. Klik in het linkerpaneel Een variabele selecteren op de pijl omlaag om Runtime uit te vouwen.
      5. Selecteer Chain.ExecutionDateTime.
      6. Typ ".csv" achter uw twee variabelen.
4. De opdracht opslaan

Stap 6: 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.

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.
   1. Klik op 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.
   2. Klik op 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 + .
         3. Typ in het veld Value "id" en klik op Enter op uw toetsenbord.
         4. Klik op ACCEPT.
4. Sla de opdracht op.

Stap 7: De oefening testen

Nu de Chain compleet is, kunnen we het resultaat testen.

1. Publiceer de keten.
2. Klik op Execute en selecteer vervolgens Run With Inputs.
3. Voer de waarden voor uw Runtime Inputs in.
   • Table ID - ID van de tabel "CLP-werknemergegevens".
     Kijk op dit document voor hulp bij het vinden van het ID.
   • Bestandsnaam - elke naam die u aan het bestand wilt geven.
     Noem het bestand in dit voorbeeld "Employee Detail".
   • Bestandslocatie - Waar het CSV-bestand zich bevindt.
     Gebruik in dit voorbeeld: https://cs-sftp-training-bucket.s3.amazonaws.com/cs-training/transformation-qs/employee_detail.csv
4. Klik op Start.

5. Zodra de Chain voltooid is, klikt u op het knooppunt Import File into Table om het succes te verifiëren.

   De keten zou met succes het bestand moeten hebben genomen, een Workiva-bestand moeten hebben gemaakt en het in uw Tabel moeten hebben geïmporteerd. U kunt controleren of de gegevens naar uw tabel zijn geüpload door naar de tabel in Wdata te navigeren en de dataset in het rechterpaneel te bekijken.

Als u meer wilt weten over het beheren van datasets in Wdatatabellen met behulp van Chains, raadpleeg dan het volgende pad: Gegevens uit een tabel verwijderen!