Workiva supportcenter

Platform API version 2022-01-01 pensioneras till förmån för version 2026-01-01. För att justera för detta har kommandona Kör rapport och Lista användare i Workiva-anslutningen nu ett fält API-version . Uppdatera dessa kommandon till 2026-01-01 så att kedjorna fortsätter att köras på ett API som stöds. 

Anteckningar

• Standardversionen är 2022-01-01.
• Ett steg utan värde använder 2022-01-01.
• Du kan välja 2022 eller 2026 för varje instans av kommandona Run Report och List Users .
• Versionen från 2022-01-01 slutar fungera den 30 november 2027 . Du måste flytta dina steg till 2026 före det datumet.
• Andra grafkommandon i Workiva Connector flyttas automatiskt till 2026-01-01 den 30 november 2026, och du behöver inte ändra dem. 
• Deras JSON-utdata kan lista fält och objekt i en annan ordning. Värdena är desamma.

Kör rapport

Det som förblir detsamma

• Indata: Rapport-ID , Förhandsgranska innehåll .
• Utdata: CSV-filen för rapporten
• Steget avslutas först när filen är klar.

Vad som ändras 2026-01-01

• Steget startar en export av rapporten, kontrollerar dess status ungefär en gång i sekunden och laddar sedan ner CSV-filen.
• Kedjeloggen visar "Kontrollerar operationsstatus...", statusen bekräftad , i kö eller startad och "Operationen slutförd" om steget slutförs korrekt. Om steget inte slutförs korrekt registreras meddelandet "Åtgärden misslyckades" i loggen.
• Steget kan ta längre tid att köra än i versionen 2022-01-01, eftersom kopplingen kontrollerar exporten upp till 300 gånger eller maximalt 10 minuter, beroende på vilket som inträffar först. Vid en kontroll per sekund är det ungefär 5 minuter. Om exporten inte är klar då misslyckas steget.
• Tips: Om kedjestegets timeout är kortare än exporten, höj den så att filen kan komma fram.
• Ett felaktigt rapport-ID misslyckas vanligtvis med "åtgärden misslyckades".
• Inget nytt tillstånd behövs. OAuth2-tillståndet behöver fortfarande graph:read .

Byt ett steg till 2026

1. Öppna kedjan och välj steget Kör rapport .
2. Ställ in API-version till 2026 .
3. Spara och kör kedjan.
4. Kontrollera att utdata från Rapport innehåller de data du förväntar dig.

Felsökning

Lista användare

Det som förblir detsamma

• Inmatning: Organisations-ID .
• Utdata: Användarrapportens JSON-fil och Antal poster .
• OAuth2-beviljandeanvändaren måste vara en organisationsadministratör.

Vad som ändras 2026-01-01

• OAuth2-tillståndet som används av anslutningen måste ha omfånget organization:read .
• Utan det omfånget kommer steget att misslyckas med HTML-felet "Obehörig (401)" eller "Förbjuden (403)" istället för att returnera en lista över användare.

Byt ett steg till 2026-01-01

1. En organisationssäkerhetsadministratör lägger till organization:read till API-tilldelningen vars klient-ID är sparat på din Workiva-anslutning:

   1. Klicka på användarikonen längst upp till höger, välj Admin och sedan Organisationsadministratör .
   2. I vänstermenyn väljer du Säkerhet och sedan fliken Provisionering .
   3. Hitta det bidraget och öppna det från menyn Åtgärder .
   4. I Omfattningar , välj organization:read och spara. Klienthemligheten förblir densamma.

   Obs: organization:read är ett organisationsomfång. Den är inte tilldelad från arbetsyteinställningar. För
   mer information, se Workivas supportsida Skapa och hantera API-tilldelningar i organisationsadministrationen .

2. Öppna kedjan och välj steget Lista användare .
3. Ställ in API-version till 2026 .
4. Spara och kör kedjan.
5. (Valfritt, men rekommenderat) Registrera värdet Antal poster . 
   1. Ändra tillbaka
   värdet för API-version till 2022 och kör kedjan igen. 
6. Bekräfta att värdet Antal poster är detsamma för båda körningarna.

Felsökning

Vad händer om jag inte gör någonting?

Steg som använder dessa kommandon kommer att fortsätta använda 2022-01-01 till och med 31 okt 2027 . Efter det datumet kommer steg som är inställda på 2022-01-01 att sluta fungera.

Behöver du hjälp?

Kontakta Workiva Support .