Kalkylbladskommandon för Workiva Connector använder Workiva Platform API. Den nuvarande versionen är 2022-01-01, men den kommer att tas bort. För att hålla era kedjor igång flyttar vi alla Workiva Connector-kommandon till version 2026-01-01.
De flesta Workiva-kopplingskommandon flyttas automatiskt till 2026-01-01 den 30 november 2026, och du behöver inte redigera dina kedjor. Ingångar och utgångar ändras inte.
Kalkylbladskommandon
Med introduktionen av API-version 2026-01-01 har kalkylbladskommandona i Workiva-anslutningen nu ett fält API-version som kräver att du väljer antingen 2022 eller 2026. Standardvärdet är 2022, och ett kommando utan värde använder 2022. Det här innebär att kedjekommandon som sparades innan fältet fanns fortsätter att köras 2022.
Den 31 oktober 2027 kommer vi att flytta dessa kommandon till 2026-01-01. Byt innan dess så att du kan testa dina kedjor 2026.
Vad som förändras år 2026
Den här tabellen identifierar ändringarna av kommandona:
| Kommando | Ändra |
|---|---|
| Skriva arkdata, Skriva över arkdata, Rensa arkdata, Uppdatera arkmetadata, Publicera kalkylblad, Ta bort kalkylblad |
|
| Ta bort kalkylark |
Flyttar kalkylbladet till papperskorgen, där det kan återställas. Ett kommando Hämta kalkylbladsmetadata senare i kedjan kommer att misslyckas med meddelandet "Det valda kalkylarket är i papperskorgen". |
| Hämta uppgifter om ark | Revision ignoreras. Kommandot returnerar de senaste data och poster Varning: --revision stöds inte av Platform API 2026. De senaste arkdata returnerades. i loggen. Om din kedja behöver en tidigare revision, låt kommandot vara inställt på 2022. |
| Skapa kalkylark | Ett fel skriver inte längre ut den detaljerade listan "Fel:". |
| Ta bort ark | Ett ark som innehåller XBRL avvisas med API-meddelandet. |
| Hämta arkmetadata, Uppdatera arkmetadata och andra kommandon som tar ett arknamn | Ett arknamn efter den första sidan av ark löses nu upp. |
Andra ändringar
- Vissa feltexter för "hittades inte" skiljer sig mellan versioner, så om ett senare kommando kontrollerar feltexten kan det bete sig olika mellan versioner.
- Om API-tillståndet saknar värden för
file:readellerfile:write kommer 2026-kommandona att misslyckas, vilket kan orsaka att hela kedjan misslyckas. - Medan konfigurationsdialogrutorna för Hämta arkdata , Skriv arkdata och Skriv över arkdata har en kryssruta Använd plattforms-API , kommer dessa kommandon att använda 2026-API:et om API-versionen är 2026, även om kryssrutan är tom.
Det som förblir detsamma
- Namn på inmatningar och utmatningar på varje kommando, så att senare kommandon fortsätter att fungera.
- Meddelanden om framgång: "Borttagning lyckades", "Uppdatering lyckades", "Publicering lyckades".
- Värdöverskrider anslutningen. Du varken lägger till eller ändrar en.
Förkunskapskrav: file:read och file:write
I 2026 API kontrollerar dessa kommandon andra omfång än i 2022. Om inte dessa behörigheter uppdateras kommer ett kommando som fungerar med 2022 API att misslyckas när 2026 API används.
- Kommandon som läser ett kalkylblad behöver
file:read . - Kommandon som ändrar ett kalkylblad behöver
file:write .
Lägga till omfattningsvärden
Att lägga till dessa omfång kräver att en Workiva Org-säkerhetsadministratör lägger till omfången i API-tilldelningen vars klient-ID är sparat på din Workiva-anslutning:
- Klicka på användarikonen längst upp till höger, välj Admin och sedan Organisationsadministratör .
- I vänstermenyn väljer du Säkerhet och sedan fliken Provisionering .
- Hitta det bidraget och öppna det från menyn Åtgärder .
- I Scopes väljer du
file:readochfile:writeoch sparar beviljandet. Klienthemligheten förblir densamma.
För mer information, se Skapa och hantera API-tilldelningar i Organisationsadministration .
Steg för att byta kedja till 2026
- Se till att bidraget har
file:readochfile:write .Se Förkunskapskrav . - Öppna kedjan. Ställ in API-version till 2026 i varje kommandosteg i kalkylbladet.
- Spara och kör kedjan.
- (Valfritt, men rekommenderat) Jämför följande utdata med en tidigare körning från 2022: Skrivna
rader, Skrivna celler, Data-CSV och Antal ark.
Om något är fel, återställ stegen till 2022 och kontakta Workiva Support .
Använd endast en API-version i en kedja Workiva rekommenderar att man använder en enda API-version för alla kalkylbladskommandon i en kedja; vi garanterar inte att det fungerar som förväntat eller önskvärt att blanda och matcha flera API-versioner.
Felsökning
| Meddelande | Vad du ska göra |
|---|---|
Autentiseringsuppgifterna har inte det/de erforderliga omfånget/omfången: file:read eller file:write , med HTML-felkod 401 |
API-tilldelningen saknar det omfång som anges i meddelandet. Lägg till det enligt beskrivningen i Förutsättningar och kör sedan kedjan igen. Tills dess, sätt kommandot till 2022. |
|
Kommandot avslutades inte i tid. Minska datastorleken, eller sätt kommandot till 2022 och kontakta Workiva Support . |
Åtgärden misslyckades eller Åtgärden avbröts |
Kontrollera kalkylbladets och ark-ID:na. Om de är korrekta, kontakta supporten med det operations-ID som visas i loggen. |
Det valda kalkylarket är papperskorgen. |
Ett tidigare steg Ta bort kalkylblad med 2026 flyttade det till papperskorgen. Återställ det eller använd ett annat kalkylblad. |
API-versionen måste vara 2022 eller 2026. |
Fältet har ett annat värde. Ställ in den på 2022 eller 2026. |
Vad händer om jag inte gör någonting?
Kommandon inställda på 2022 är tillgängliga till och med 31 oktober 2027 . Det datumet flyttar vi dem till 2026-01-01. Byt kommandon i god tid innan dess så att du har tid att testa dina kedjor.
Behöver du hjälp?
Kontakta Workiva Support .