Met een Workiva connected oplossing zijn er een aantal manieren om gegevens in een Workiva Spreadsheet bij te werken. Bij gebruik van Wdata kan een inkomende verbinding worden gemaakt om gegevens in een spreadsheet te verversen vanuit een Wdata Query. In dit artikel verkennen we het gebruik van Chains om gegevens in een werkblad bij te werken met behulp van de opdrachten Write Sheet Data en Overwrite Sheet Data.
Gemeenschappelijke commando-ingangen
De commando's Bladgegevens schrijven en Bladgegevens overschrijven hebben verschillende ingangen die voor beide commando's hetzelfde zijn.
| Ingang | Doel |
| Spreadsheet-ID | De ID van de Workiva Spreadsheet waarnaar de gegevens worden geschreven. |
| Blad ID/Naam |
De naam of ID van het blad binnen het Spreadsheet waarnaar gegevens worden geschreven. Namen zijn CASE-SENSITIVE. |
| Gegevensbestand |
Het bestand met afgebakende gegevens dat naar het blad moet worden geschreven. CSV is de meest voorkomende bestandsindeling, maar andere scheidingstekens worden ondersteund. JSON-gegevens moeten worden geconverteerd naar een afgebakende indeling om deze opdracht te kunnen gebruiken. |
| Scheidingsteken |
Het scheidingsteken tussen bestanden. Komma (,) is het meest gebruikelijke, maar elk scheidingsteken wordt ondersteund, inclusief puntkomma (;), pijp (|) of tab (\t). Zorg ervoor dat velden waarvan de gegevens het opgegeven scheidingsteken bevatten, tussen dubbele aanhalingstekens staan. Bijvoorbeeld in een door komma's gescheiden bestand: Workiva,"Ames, IA, USA",WK |
| Regio (bladgegevens schrijven) / Startcel (bladgegevens overschrijven) |
Het beginceladres waar de gegevens worden geschreven. Aanvullende informatie over geldige waarden vindt u in de specifieke sectie van elk commando hieronder. |
| Async gebruiken |
Als deze optie is aangevinkt, zal de opdracht een asynchrone bijwerking van het blad uitvoeren. Dit betekent dat de ketting doorgaat met de volgende bewerking terwijl de velbijwerking nog binnen het platform wordt uitgevoerd. Deze optie wordt aanbevolen voor grote datasets, maar alleen als latere Ketenbewerkingen niet afhankelijk zijn van de bladupdate. |
| Platform-API gebruiken |
Als deze optie is aangevinkt, gebruikt de opdracht de Platform-API om de update uit te voeren in plaats van de oude Spreadsheet-API. De Platform API is aanbevolen omdat dit de nieuwere van de API's is en nog steeds uitgebreid wordt met extra functies. |
Gegevens schrijfblad
De opdracht Schrijf velgegevens kunt u het beste gebruiken wanneer u specifieke regio's in een vel moet bijwerken terwijl de gegevens in andere regio's van het vel behouden blijven. De volgende tabel geeft een overzicht van het wisgedrag voor elk opgegeven Regioformaat.
| Formaat | Voorbeeld | Effect |
| Adres van één cel | B2 |
Een enkele cel in het blad bijwerken, geen andere celwaarden worden beïnvloed. Dit formaat is niet aan te raden, tenzij u een waarde voor een enkele cel schrijft. Als het gegevensbestand meer dan één gegevenspunt bevat, zal de opdracht mislukken bij gebruik van deze indeling. |
| Beginceladres, geen eindcel of -kolom | B2: |
Werk het blad bij vanaf het beginceladres. Bladwaarden links (kolom) en boven (rij) het startceladres blijven bewaard; alle andere waarden worden gewist, zelfs als het gegevensbestand geen celwaarden in de rij of kolom bevat. |
| Adres van startcel, eindkolom zonder eindrij | B2:D |
Werk het blad bij vanaf het beginceladres. Bladwaarden links (kolom) en boven (rij) het startceladres blijven bewaard; alle andere waarden worden gewist, zelfs als het gegevensbestand geen celwaarden in de rij of kolom bevat. |
| Beginnend celadres, eindigend celadres | B2:D5 |
Vervangt alle cellen binnen het opgegeven bereik. Opmerking: Als het in de opdracht opgegeven bereik kleiner is (minder rijen of kolommen) dan het gegevensbestand dat wordt geladen, mislukt de opdracht. |
Gegevens overschrijven
Het commando Bladgegevens overschrijven kunt u het beste gebruiken als u een heel blok binnen een blad moet wissen. De volgende tabel beschrijft het clearinggedrag voor elk gespecificeerd Starting Cell-formaat.
| Formaat | Voorbeeld | Effect |
| Adres van één cel | B2 |
Bladwaarden links (kolom) en boven (rij) het startende celadres blijven behouden; alle andere waarden in het blad worden gewist en de gegevens in het gegevensbestand worden geschreven vanaf het opgegeven celadres. |
| Beginceladres, geen eindcel of -kolom | B2: |
Bladwaarden links (kolom) en boven (rij) het startende celadres blijven behouden; alle andere waarden in het blad worden gewist en de gegevens in het gegevensbestand worden geschreven vanaf het opgegeven celadres. |
| Adres van startcel, eindkolom zonder eindrij | B2:D |
Deze indeling wordt niet ondersteund en resulteert in een fout bij het uitvoeren van opdrachten. |
| Beginnend celadres, eindigend celadres | B2:D5 |
Bladwaarden links (kolom) en boven (rij) het startende celadres blijven behouden; alle andere waarden in het blad worden gewist en de gegevens in het gegevensbestand worden geschreven vanaf het opgegeven celadres. De breedte (kolommen) en hoogte (rijen) van het gegevensbestand zijn irrelevant. |
Uitproberen
Er is een ketensjabloon en een testspreadsheet gemaakt waarmee u de resultaten van elk van de bovenstaande indelingen Start Cell/Region kunt bekijken. Om te testen:
- Download de testspreadsheet van deze link (25 KB) en importeer in uw Workspace.
- Maak een testketen met behulp van de Gebruik ketens om een Workiva-spreadsheet bij te werken Sjabloon dat u kunt vinden op 4. Klik op Ketting. Snelstartgidsen -> Inschakelings- en gebruiksvoorbeelden Map Sjabloon.
- U kunt het beste de Spreadsheet ID Sjabloonvariabele toewijzen aan Ketenvariabele.
- Werk de Spreadsheet ID Kettingvariabele bij voordat u de ketting in uw werkruimte uitvoert.
- Zorg ervoor dat de gebruiker in de Workiva Chains connectie de file:write scope heeft en dat de gebruiker is toegewezen aan de geïmporteerde spreadsheet.
- Voer de Chain uit en bekijk de resultaten. De verwachte resultaten staan op het blad Verwachte resultaten van het geïmporteerde spreadsheet.