Regnearkkommandoer for Workiva Connector bruker Workiva Platform API. Den nåværende versjonen er 2022-01-01, men denne vil bli pensjonert. For å holde kjedene dine i gang, flytter vi alle Workiva Connector-kommandoer til versjon 2026-01-01.
De fleste Workiva-koblingskommandoer flyttes automatisk til 2026-01-01 den 30. november 2026, og du trenger ikke å redigere kjedene dine. Innganger og utganger endres ikke.
Regnearkkommandoer
Med introduksjonen av API-versjon 2026-01-01 har regnearkkommandoene i Workiva-koblingen nå et API-versjon -felt, som krever at du velger enten 2022 eller 2026. Standardinnstillingen er 2022, og en kommando uten verdi bruker 2022. Dette betyr at kjedekommandoer som ble lagret før feltet eksisterte, fortsetter å kjøre i 2022.
Den 31. oktober 2027 flytter vi disse kommandoene til 01.01.2026. Bytt før da, slik at du kan teste kjedene dine i 2026.
Hva endrer seg i 2026
Denne tabellen identifiserer endringene i kommandoene:
| Kommando | Endre |
|---|---|
| Skriv arkdata, overskriv arkdata, fjern arkdata, oppdater arkmetadata, publiser regneark, slett regneark |
|
| Slett regneark |
Flytter regnearket til papirkurven, hvor det kan gjenopprettes. En Hent regnearksmetadata -kommando senere i kjeden vil mislykkes med meldingen «Det valgte regnearket er i papirkurven». |
| Hent arkdata | Revisjon ignoreres. Kommandoen returnerer de nyeste dataene og postene Advarsel: --revision støttes ikke av Platform API 2026. De siste arkdataene ble returnert. i loggen. Hvis kjeden din trenger en tidligere revisjon, behold kommandoen satt til 2022. |
| Opprett regneark | En feil skriver ikke lenger ut den detaljerte listen «Feil:». |
| Slett ark | Et ark som inneholder XBRL blir avvist med API-meldingen. |
| Hent arkmetadata, oppdater arkmetadata og andre kommandoer som tar et arknavn | Et arknavn etter den første siden med ark løses nå opp. |
Andre endringer
- Noen feiltekster av typen «ikke funnet» varierer mellom versjoner, så hvis en senere kommando sjekker feilteksten, kan den oppføre seg forskjellig mellom versjoner.
- Hvis API-bevilgningen mangler verdier for
file:readellerfile:write , vil 2026-kommandoene mislykkes, noe som kan føre til at hele kjeden mislykkes. - Selv om konfigurasjonsdialogboksene for Hent arkdata , Skriv arkdata og Overskriv arkdata har en Bruk plattform-API -avmerkingsboks, vil disse kommandoene bruke 2026-API-et hvis API-versjonen er 2026, selv om avmerkingsboksen er tom.
Det som forblir det samme
- Navn på input og output på hver kommando, slik at senere kommandoer fortsetter å fungere.
- Vellykkede meldinger: «Sletting vellykket», «Oppdatering vellykket», «Publisering vellykket».
- Vert overstyringer på tilkoblingen. Du verken legger til eller endrer en.
Forutsetninger: fil:lesing og fil:skriving
I 2026 API-et sjekker disse kommandoene andre omfang enn i 2022. Med mindre disse tildelingene oppdateres, vil en kommando som fungerer med 2022 API-et mislykkes når 2026 API-et brukes.
- Kommandoer som leser et regneark trenger
file:read . - Kommandoer som endrer et regneark trenger
file:write .
Legge til omfangsverdier
Å legge til disse omfangene krever at en Workiva Org Security Admin legger til omfangene i API-tildelingen hvis klient-ID er lagret på Workiva-tilkoblingen din:
- Klikk på brukerikonet øverst til høyre, velg Admin og deretter Organisasjonsadministrator .
- I menyen til venstre velger du Sikkerhet og deretter fanen Klargjøring .
- Finn tilskuddet og åpne det fra Handlinger -menyen.
- I Omfang velger du
file:readogfile:writeog lagrer tildelingen. Klienthemmeligheten forblir den samme.
Hvis du vil ha mer informasjon, kan du se Opprett og administrer API-tildelinger i Organisasjonsadministrasjon .
Fremgangsmåte for å bytte en kjede til 2026
- Sørg for at bevilgningen har
file:readogfile:write .Se Forutsetninger . - Åpne kjeden. På hvert regnearkkommandotrinn, sett API-versjon til 2026 .
- Lagre og kjør kjeden.
- (Valgfritt, men anbefalt) Sammenlign følgende resultater med en tidligere kjøring fra 2022: Skrevet
rader, Skrevet celler, Data CSV og Antall ark.
Hvis noe er galt, sett trinnene tilbake til 2022 og kontakt Workiva Support .
Bruk kun én API-versjon i en kjede Workiva anbefaler å bruke én API-versjon for alle regnearkkommandotrinn i en kjede. Vi garanterer ikke at det å blande og matche flere API-versjoner vil fungere som forventet eller ønsket.
Feilsøking
| Melding | Hva du skal gjøre |
|---|---|
Legitimasjonen har ikke det/de nødvendige omfanget(ene): file:read eller file:write , med HTML-feilkode 401 |
API-bevilgningen mangler omfanget som er navngitt i meldingen. Legg den til som beskrevet i Forutsetninger , og kjør deretter kjeden på nytt. Inntil da, sett kommandoen til 2022. |
Forsøksgrensen på 300 overskredet eller Tidsgrensen på 10m0s overskredet |
Kommandoen ble ikke fullført i tide. Reduser datastørrelsen, eller sett kommandoen til 2022 og kontakt Workiva Support . |
Operasjonen mislyktes eller Operasjonen ble avbrutt |
Sjekk regnearket og ark-ID-ene. Hvis de er riktige, kontakt kundestøtte med operasjons-ID-en som vises i loggen. |
Det valgte regnearket er kastet i papirkurven. |
Et tidligere trinn Slett regneark ved bruk av 2026 flyttet det til papirkurven. Gjenopprett det, eller bruk et annet regneark. |
API-versjonen må være 2022 eller 2026. |
Feltet har en annen verdi. Sett den til 2022 eller 2026. |
Hva om jeg ikke gjør noe?
Kommandoer satt til 2022 er tilgjengelige frem til 31. oktober 2027 . På den datoen flytter vi dem til 2026-01-01. Bytt kommandoer i god tid før den tid, slik at du har tid til å teste kjedene dine.
Trenger du hjelp?
Kontakt Workiva-støtte .