Med en Workiva-tilkoblet løsning finnes det en rekke måter å oppdatere data i et Workiva-regneark på. Når du bruker Wdata, kan du opprette en innkommende tilkobling for å oppdatere data i et regneark fra en Wdata Query. I denne artikkelen ser vi nærmere på bruken av kjeder for å oppdatere data i et regneark ved hjelp av kommandoene Write Sheet Data og Overwrite Sheet Data.
Felles kommandoinnganger
Kommandoene Skriv arkdata og Overskriv arkdata har flere innganger som er de samme for begge kommandoene.
| Inndata | Formål |
| Regneark-ID | ID for Workiva-regnearket som dataene skal skrives til. |
| Ark-ID/navn |
Navnet eller ID på arket i regnearket som dataene skal skrives til. Navnene er CASE-SENSITIVE. |
| Datafil |
Filen som inneholder avgrensede data som skal skrives til arket. CSV er det vanligste filformatet, men andre avgrensere støttes også. JSON-data må konverteres til et avgrenset format for å kunne bruke denne kommandoen. |
| Skilletegn |
Filens skilletegn. Komma (,) er det vanligste, men alle skilletegn støttes, inkludert semikolon (;), pipe (|) eller tabulator (\t). Sørg for at felter med data som inneholder det angitte skilletegnet, er omsluttet av anførselstegn. For eksempel i en kommaseparert fil: Workiva,"Ames, IA, USA",WK |
| Region (Skriv arkdata) / Startcelle (Overskriv arkdata) |
Startcelleadressen der data skal skrives. Du finner mer informasjon om gyldige -verdier i avsnittene om hver enkelt kommando nedenfor. |
| Bruk Async |
Når du merker av for dette, vil kommandoen utføre en asynkron oppdatering av arket. Dette betyr at kjeden går videre til neste operasjon mens oppdateringen av arket fortsatt pågår på plattformen. Dette alternativet anbefales for store datasett, men bare hvis påfølgende Chain-operasjoner ikke er avhengige av arkoppdateringen. |
| Bruk plattform-API |
Når dette alternativet er merket av, bruker kommandoen plattform-API-et til å utføre oppdateringen i stedet for det gamle regneark-API-et. Plattform-API-et anbefales, siden dette er det nyeste API-et og stadig forbedres med flere funksjoner. |
Skriv arkdata
Kommandoen Skriv arkdata brukes best når du har behov for å oppdatere bestemte områder i et ark, samtidig som data i andre områder av arket bevares. Tabellen nedenfor viser hvordan de ulike regionformatene skal tømmes.
| Format | Eksempel | Effekt |
| Enkeltcelleadresse | B2 |
Oppdater en enkelt celle i arket, og ingen andre celleverdier påvirkes. Dette formatet er ikke anbefalt med mindre du skriver en enkelt celleverdi. Hvis datafilen inneholder mer enn ett datapunkt, vil kommandoen mislykkes når du bruker dette formatet. |
| Startcelleadresse, ingen sluttcelle eller kolonne | B2: |
Oppdater arket fra og med startcelleadressen. Arkverdiene til venstre (kolonne) og over (rad) startcelleadressen bevares; alle andre verdier slettes selv om datafilen ikke inneholder celleverdier i raden eller kolonnen. |
| Startcelleadresse, sluttkolonne uten avsluttende rad | B2:D |
Oppdater arket fra og med startcelleadressen. Arkverdiene til venstre (kolonne) og over (rad) startcelleadressen bevares; alle andre verdier slettes selv om datafilen ikke inneholder celleverdier i raden eller kolonnen. |
| Startcelleadresse, sluttcelleadresse | B2:D5 |
Erstatter alle celler innenfor det angitte området. Merk: Hvis området som er angitt i kommandoen er mindre (færre rader eller kolonner) enn datafilen som lastes inn, vil kommandoen mislykkes. |
Overskriv arkdata
Kommandoen Overskriv arkdata brukes best når du har behov for å slette en hel blokk på et ark. Tabellen nedenfor viser hvordan hver av de angitte startcelleformatene skal tømmes.
| Format | Eksempel | Effekt |
| Enkeltcelleadresse | B2 |
Arkverdiene til venstre (kolonne) og over (rad) startcelleadressen bevares; alle andre verdier i arket slettes, og dataene i datafilen skrives med utgangspunkt i den angitte celleadressen. |
| Startcelleadresse, ingen sluttcelle eller kolonne | B2: |
Arkverdiene til venstre (kolonne) og over (rad) startcelleadressen bevares; alle andre verdier i arket slettes, og dataene i datafilen skrives med utgangspunkt i den angitte celleadressen. |
| Startcelleadresse, sluttkolonne uten avsluttende rad | B2:D |
Dette formatet støttes ikke av og vil resultere i en feil i kommandoutførelsen. |
| Startcelleadresse, sluttcelleadresse | B2:D5 |
Arkverdiene til venstre (kolonne) og over (rad) startcelleadressen bevares; alle andre verdier i arket slettes, og dataene i datafilen skrives med utgangspunkt i den angitte celleadressen. Bredden (kolonnene) og høyden (radene) på datafilen er irrelevant. |
Prøv det ut
Det er laget en kjedemal og et testregneark som lar deg se resultatene av hver av de ovennevnte Start Cell/Region formatene. For å teste:
- Last ned testregnearket fra denne lenken (25 KB) og importer det inn i arbeidsområdet ditt.
- Opprett en testkjede ved hjelp av Bruk kjeder til å oppdatere et Workiva-regneark Mal som finnes i 4. Hurtigstartveiledninger -> Aktiverings- og brukseksempler Malmappe.
- Det anbefales å tilordne Regneark-ID Malvariabel som en Kjedevariabel.
- Oppdater Regneark-ID Kjedevariabel før du kjører kjeden i arbeidsområdet.
- Sørg for at brukeren i Workiva Chains -tilkoblingen har file:write scope, og at brukeren er tilordnet det importerte regnearket.
- Kjør kjeden og gå gjennom resultatene. Forventede resultater er beskrevet på Forventede resultater i det importerte regnearket.