De sjabloon Gegevens laden naar Wdata brengt gegevens naar een Wdatatabel door een bestaande dataset te vervangen of een nieuwe toe te voegen. Deze sjabloon wordt meestal gebruikt als onderdeel van een bestaande keten, maar kan aan elke workflow worden toegevoegd waarbij een dataset naar een tabel moet worden geüpload.
Vereisten
- De doel Wdata-tabel moet worden aangemaakt voordat u deze keten uitvoert.
- Deze sjabloon bestaat uit drie ketens. Elke keten moet afzonderlijk gepubliceerd worden naar uw werkruimte.
- De bestandsnaam moet een .csv- of .tsv-extensie bevatten. Bijvoorbeeld: "File_Name_Example.csv".
- De aanbevolen maximale bestandsgrootte voor een dataset is 300mb. Meer informatie over aanbevelingen voor bestandsgrootte.
De sjabloon vinden
De sjabloon Gegevens laden naar WData bevindt zich in de Workiva Chains sectie van het scherm Sjablonen.
Zo vindt u het:
- Ga in Chain Builder naar het tabblad Templates .
- Selecteer Workiva Ketens in het menu bovenaan.
- Zoek rechtsboven naar Load Data to Wdata | Primary Chain en open de sjabloon.
-
Nadat u de sjabloon hebt gevonden, klikt u op New Chain om deze op uw werkruimte te implementeren.
Opmerking: Na de configuratie moet elke keten in deze sjabloon gepubliceerd worden op de werkruimte.
De sjabloon configureren
Deze sjabloon bestaat uit drie ketens: de Primary Chain, een Replace Dataset Chain en een Add New Dataset Chain. Wanneer de Primary Chain in uw werkruimte wordt uitgerold, worden de twee kindketens (Add/Replace) automatisch mee uitgerold.
Hier wordt elke keten nader bekeken:
- Primaire keten: Deze keten bepaalt of er een dataset in uw tabel is die dezelfde naam heeft als de dataset die door de keten wordt geladen. Als er een overeenkomende dataset wordt gevonden, legt de keten informatie over de overeenkomende dataset vast en - op basis van de "Load Method" runtime-invoer die u voor de bovenliggende keten hebt geconfigureerd - stuurt de keten die gegevens door naar een van de twee onderliggende ketens.
-
Vervang dataset keten: Deze keten verwijdert de gematchte dataset uit uw tabel en vervangt deze door een nieuwe. Als er een fout optreedt tijdens de uitvoering en de terugdraai-optie is geselecteerd, zal de keten automatisch de nieuwe dataset verwijderen en terugkeren naar de dataset die vervangen moest worden.
-
Nieuwe dataset toevoegen:: Deze keten creëert een nieuwe dataset en importeert deze in uw tabel. De nieuwe dataset moet een unieke bestandsnaam hebben die momenteel niet gebruikt wordt door andere datasets in de tabel.
Als u deze set ketens aan een bestaande keten toevoegt, moeten de runtime-ingangen voor de primaire keten in het knooppunt "Run Chain" worden geconfigureerd. De kinderketens hoeven niet gewijzigd of geconfigureerd te worden.
Uw instellingen zouden er ongeveer zo uit moeten zien:
Variabelen
| type | Naam | Doel |
| Werkruimte variabele | wsv-WdataLoadWarningThreshold |
Deze variabele werkt als een zachte limiet op de bestandsgrootte van uw dataset. Datasets boven de gekozen drempel geven aanleiding tot een waarschuwing. Omdat de verwerkingstijd toeneemt met de bestandsgrootte, kunnen kleinere datasets aanzienlijk sneller verwerkt worden. De aanbevolen bestandsgrootte waarschuwt u er ruimschoots voor dat uw dataset mogelijk de limiet voor de bestandsgrootte van Wdata nadert. Wanneer er een waarschuwing wordt gegeven, kunt u overwegen om uw bestand te refactureren of andere opties te onderzoeken om rekening te houden met het grotere bestand. Aanbevolen bestandsgrootte: 150MB-200MB |
| Dynamische kettingvariabele | dcv-ketting Resultaat | Legt de status van de keten in verschillende stadia vast. Dit is vereist en mag niet worden gewijzigd. |
Runtime-ingangen
| Runtime invoer | Doel | Type veld | Vereist |
| Tabel ID |
Voer de Wdata Table ID in waarnaar de dataset geüpload zal worden. Deze ID wordt ook gebruikt om te bepalen of er dubbele datasets in de tabel zijn. Wij raden aan om werkruimtevariabelen te gebruiken om de tabel-ID op te slaan; hierdoor kan de sjabloon in meerdere processen gebruikt worden. |
Tekst | Ja |
| Bestandsnaam |
De naam van de dataset die geïmporteerd wordt naar de Wdata tabel. De bestandsnaam vertelt de keten welke gegevens vervangen moeten worden. De vereisten voor bestandsnamen variëren afhankelijk van de geselecteerde keten:
Opmerking: De bestandsnaam moet de extensie .csv of .tsv bevatten. Bijvoorbeeld: "Bestand_Naam_Voorbeeld.csv" |
Tekst | Ja |
| Gegevensbestand |
Het gegevensbestand dat in de tabel geïmporteerd wordt. De extensie moet .csv of .tsv zijn. Opmerking: Het gegevensbestand kan gebruik maken van elk van de ondersteunde Wdata tabeldefiniters. |
Bestand | Ja |
| Belastingsmethode |
Bepaalt of het bestand een bestaande dataset moet vervangen of als een nieuwe moet worden toegevoegd. Opties:
|
Dropdown menu |
Ja |
| Terugdraaien |
In geval van een fout worden alle wijzigingen teruggedraaid en wordt de oorspronkelijke dataset opnieuw geïmporteerd. Standaard ingesteld op True. Alleen van toepassing op de laadmethode Dataset vervangen. |
Booleaans (Waar/Onwaar) |
Geen |
Probleemoplossing
Om de rungeschiedenis van uw ketting te bekijken, inclusief fouten:
- Ga naar het tabblad Monitor in Chain Builder.
-
Beweeg met de muis over het vraagteken om de status van de kettingloop te bekijken.
Als uw ketting een fout heeft veroorzaakt of de juiste gegevens niet heeft bijgewerkt, voer dan de volgende controles uit:
- Controleer of alle drie de ketens op uw werkruimte zijn gepubliceerd. Elke keten moet afzonderlijk gepubliceerd worden.
- Zorg ervoor dat uw dataset een ondersteund scheidingsteken gebruikt en dat de bestandsnaam een .csv- of .tsv-extensie bevat ("File_Name_Example.csv").
- Als u de methode Dataset laden vervangen gebruikt, controleer dan of de bestandsnaam overeenkomt met de bestaande bestandsnaam in uw Wdatatabel. Als het niet overeenkomt, voegt de ketting gewoon een nieuw bestand toe aan uw tabel zonder het oude te vervangen.
- Als u daarentegen de laadmethode Add New Dataset gebruikt, controleer dan of de bestandsnaam nergens anders in de Wdata-tabel wordt gebruikt. De keten zal mislukken als er een overlappende bestandsnaam wordt gebruikt.
- Zorg ervoor dat de OAuth2 grant gekoppeld aan de Workiva verbinding de juiste toegang heeft.
- Zorg er bij het invoeren van de tabel-ID voor dat de volledige ID is ingevoerd en dat er geen spaties voor of achteraan staan.
- Controleer op runtime tijdstempelvariabelen. Deze mogen niet gebruikt worden in bestandsnamen, omdat dit een unieke bestandsnaam creëert voor elke dataset -- wat betekent dat de keten geen overeenkomende datasets in uw tabel kan identificeren.
Kolomtoewijzingen en andere ketenaanpassingen
Als u problemen ondervindt met kolomkoppen bij het importeren van gegevens, kunt u data prep of andere opdrachten gebruiken.
Optioneel: Geïmporteerde datasets taggen
Het taggen van wordt ondersteund bij het importeren van datasets, maar we raden aan om een extra set ketens te implementeren vanuit de sjabloon voordat u wijzigingen aanbrengt in het origineel. Eenmaal gewijzigd, zal de ketting waarschijnlijk moeilijk te hergebruiken zijn voor andere tabellen, tenzij de gegevenssets in die tabellen dezelfde tags gebruiken.
Om tagging aan een ketting toe te voegen:
- Voeg de volgende runtime-inputs toe aan voor elk van de drie ketens die vanuit deze sjabloon zijn ingezet:
- Tag-sleutel (tekstveld)
- Tag-waarde (tekstveld)
- Bewerk de Primary Chain om de runtime-inputs door te geven aan elke "Run Chain"-gebeurtenis:
- In zowel de Datasetketen vervangen als de Nieuwe datasetketen toevoegen, bewerkt u het opdrachtknooppunt "Nieuwe dataset importeren" om de tag runtime invoer te accepteren.
Na voltooiing worden uw geïmporteerde datasets getagd met de opgegeven tag key en tag value.