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 worden toegevoegd aan elke workflow waarbij een dataset moet worden geüpload naar een tabel.
Vereisten
- De doeltabel Wdata moet worden gemaakt voordat deze keten wordt uitgevoerd.
- Deze sjabloon bestaat uit drie ketens. Elke keten moet afzonderlijk worden gepubliceerd naar je 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 vind je het:
- Ga in Chain Builder naar het tabblad Templates .
- Selecteer Workiva Ketens in het menu bovenaan.
- Zoek naar Load Data to Wdata | Primary Chain rechtsboven en open de sjabloon.
-
Nadat u de sjabloon hebt gevonden, klikt u op New Chain om deze op uw werkruimte te implementeren.
Opmerking: Eenmaal geconfigureerd, moet elke keten in deze sjabloon worden gepubliceerd naar 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 Primaire Keten wordt uitgerold in uw werkruimte, worden de twee kindketens (Toevoegen/Vervangen) 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 vast over de overeenkomende dataset en - op basis van de "Load Method" runtime invoer die je hebt geconfigureerd voor de bovenliggende keten - 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.
-
Keten nieuwe dataset toevoegen: Deze keten creëert een nieuwe dataset en importeert deze in je tabel. De nieuwe dataset moet een unieke bestandsnaam hebben die momenteel niet gebruikt wordt door andere datasets in de tabel.
Als deze set ketens aan een bestaande keten wordt toegevoegd, moeten de runtime-inputs voor de primaire keten worden geconfigureerd in het knooppunt "Run Chain". De kindketens vereisen geen wijzigingen of configuratie.
Je 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 je dataset. Datasets boven de gekozen drempel geven 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. Als er een waarschuwing wordt gegeven, kunt u overwegen 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-tabel-ID in waarnaar de dataset wordt geüpload. Deze ID wordt ook gebruikt om te bepalen of er dubbele datasets in de tabel zijn. We raden aan om werkruimtevariabelen te gebruiken om de tabel-ID op te slaan, zodat de sjabloon in meerdere processen gebruikt kan worden. |
Tekst | Ja |
| Bestandsnaam |
De naam van de dataset die geïmporteerd wordt in 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: "File_Name_Example.csv" |
Tekst | Ja |
| Gegevensbestand |
Het gegevensbestand dat geïmporteerd wordt in de tabel. 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 |
Problemen oplossen
Om de rungeschiedenis van je ketting te bekijken, inclusief fouten:
- Ga naar het tabblad Monitor in Chain Builder.
-
Beweeg de muis over het vraagteken om de status van de kettingloop te bekijken.
Als je ketting een fout heeft veroorzaakt of niet de juiste gegevens heeft bijgewerkt, voer dan de volgende controles uit:
- Controleer of alle drie de ketens zijn gepubliceerd naar je werkruimte. Elke keten moet afzonderlijk worden gepubliceerd.
- Zorg ervoor dat je dataset een ondersteund scheidingsteken gebruikt en dat de bestandsnaam een .csv- of .tsv-extensie bevat ("File_Name_Example.csv").
- Als je de methode Dataset laden vervangen gebruikt, controleer dan of de bestandsnaam overeenkomt met de bestaande bestandsnaam in je Wdatatabel. Als het niet overeenkomt, voegt de keten gewoon een nieuw bestand toe aan je tabel zonder het oude te vervangen.
- Als je 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 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 hele ID is ingevoerd en dat er geen spaties voor of achteraan staan.
- Controleer op runtime tijdstempelvariabelen. Deze moeten niet worden gebruikt in bestandsnamen, omdat het een unieke bestandsnaam maakt voor elke dataset -- wat betekent dat de keten geen overeenkomende datasets in je 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
Tagging wordt ondersteund bij het importeren van datasets, maar we raden aan om een extra set ketens te implementeren vanuit de sjabloon voordat je wijzigingen aanbrengt in het origineel. Eenmaal aangepast, zal de ketting waarschijnlijk moeilijk te hergebruiken zijn voor andere tabellen, tenzij de gegevenssets in die tabellen dezelfde tags gebruiken.
Tagging toevoegen aan een ketting:
- 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:
- Bewerk in zowel de Datasetketen vervangen als de Nieuwe datasetketen toevoegen het opdrachtknooppunt "Nieuwe dataset importeren" om de tag runtime-invoer te accepteren.
Eenmaal voltooid, zullen je geïmporteerde datasets getagd worden met de opgegeven tag key en tag value.