Med en Workiva-ansluten lösning finns det ett antal sätt att uppdatera data i ett Workiva kalkylark. När du använder Wdata kan en inkommande anslutning skapas för att uppdatera data i en kalkylark från en Wdata Query. I den här artikeln utforskar vi användningen av kedjor för att uppdatera data i ett kalkylark med hjälp av kommandona Write Sheet Data och Overwrite Sheet Data.
Inmatning av vanliga kommandon
Kommandona Write Sheet Data och Overwrite Sheet Data har flera ingångar som är desamma för båda kommandona.
| Ingång | Syfte |
| ID för kalkylark | ID för den Workiva kalkylark till vilken data kommer att skrivas. |
| Ark ID/Namn |
Namnet eller ID på det ark i kalkylarket som data skrivs till. Namnen är CASE-SENSITIVE. |
| Datafil |
Filen som innehåller avgränsade data som ska skrivas till arket. CSV är det vanligaste filformatet men andra avgränsare stöds. JSON-data måste konverteras till ett avgränsat format för att detta kommando ska kunna användas. |
| Skiljetecken |
Avgränsaren för filen. Komma (,) är det vanligaste men alla avgränsare stöds, inklusive semikolon ( Se till att fält vars data innehåller den angivna avgränsaren omsluts av dubbla citattecken. Till exempel i en kommaseparerad arkivering: Workiva,"Ames, IA, USA",WK |
| Region (Write Sheet Data) / Start Cell (Overwrite Sheet Data) |
Startcelladressen där data kommer att skrivas. Mer information om giltiga värden finns i varje kommandos specifika avsnitt nedan. |
| Använd Async |
När den är markerad kommer kommandot att utföra en asynkron uppdatering av arket. Detta innebär att kedjan kommer att fortsätta till nästa operation medan uppdateringen av arket fortfarande utförs inom plattformen. Detta alternativ rekommenderas för stora dataset, men endast om efterföljande kedjeoperationer inte är beroende av uppdateringen av arket. |
| Använd plattforms-API |
När den är markerad använder kommandot Platform API för att utföra uppdateringen i stället för det äldre API:et för kalkylark. Platform API är rekommenderas eftersom detta är det nyaste av API:erna och fortsätter att förbättras med ytterligare funktioner. |
Skriva ark data
Kommandot Write Sheet Data används bäst när man behöver uppdatera specifika regioner i ett ark samtidigt som man bevarar data i andra regioner på arket. Följande tabell ger en översikt över clearingbeteendet för varje specificerat regionformat.
| Format | Exempel | Effekt |
| Adress för en enda cell | B2 |
Uppdatera en enda cell i arket, inga andra cellvärden påverkas. Detta format är inte rekommenderas om du inte skriver ett värde för en enda cell. Om datafilen innehåller mer än en enda datapunkt kommer kommandot att misslyckas när detta format används. |
| Startcellens adress, ingen slutcell eller kolumn | B2: |
Uppdatera arket med början vid startcellens adress. Värden för ark till vänster (kolumn) och ovanför (rad) startcelladressen bevaras |
| Startcelladress, slutkolumn utan slutrad | B2:D |
Uppdatera arket med början vid startcellens adress. Värden för ark till vänster (kolumn) och ovanför (rad) startcelladressen bevaras |
| Startcellens adress, slutcellens adress | B2:D5 |
Ersätter alla celler inom det angivna intervallet. Anm.: Om det intervall som anges i kommandot är mindre (färre rader eller kolumner) än den datafil som laddas, kommer kommandot att misslyckas. |
Data för överskrivningsark
Kommandot Overwrite Sheet Data används bäst när man behöver rensa ett helt block inom en ark. Följande tabell ger en översikt över clearingbeteendet för varje specificerat Starting Cell-format.
| Format | Exempel | Effekt |
| Adress för en enda cell | B2 |
Värden för ark till vänster (kolumn) och ovanför (rad) startcelladressen bevaras |
| Startcellens adress, ingen slutcell eller kolumn | B2: |
Värden för ark till vänster (kolumn) och ovanför (rad) startcelladressen bevaras |
| Startcelladress, slutkolumn utan slutrad | B2:D |
Detta format är inte supportas och kommer att resultera i ett fel i kommandot. |
| Startcellens adress, slutcellens adress | B2:D5 |
Värden för ark till vänster (kolumn) och ovanför (rad) startcelladressen bevaras Datafilens bredd (kolumner) och höjd (rader) är irrelevanta. |
Prova på
En Chain Template och en kalkylark för testning har skapats som gör att du kan se resultaten av vart och ett av ovanstående format Start Cell/Region. För att testa:
- Ladda ner kalkylarket för testning från den här länken (25 KB) och importera det till din arbetsyta.
- Skapa en testkedja med hjälp av Använd kedjor för att uppdatera en Workiva kalkylark Mall finns inom 4. Snabbstartsguider -> Exempel på aktivering och användning Mallmapp.
- Det rekommenderas att mappa ID för kalkylark Mallvariabel som en Kedjevariabel.
- Uppdatera ID för kalkylark Kedjevariabel innan du kör kedjan i arbetsytan.
- Se till att användaren i Workiva Chains connection har file:write scope och att användaren har tilldelats det importerade kalkylarket.
- Kör kedjan och granska resultaten. Förväntade resultat finns översiktligt beskrivna på arket Förväntade resultat i den importerade kalkylarken.