Wijzigingen in de opdrachten 'Rapport uitvoeren' en 'Gebruikers weergeven'

Workiva Connector-opdrachten maken gebruik van de Workiva Platform API. De huidige versie dateert van 2022-01-01, maar deze zal worden uitgefaseerd. Om ervoor te zorgen dat uw kettingen blijven werken, zetten we alle Workiva-connectorcommando's over naar versie 2026-01-01.

De meeste Workiva Connector-opdrachten worden op 30 november 2026 automatisch overgezet naar 2026-01-01, en u hoeft hiervoor niets te doen. Zie Workiva Connector: Commando's verplaatst naar Platform API 2026-01-01 voor de volledige lijst. De commando's Run Report en List Users bevatten wijzigingen die actie van uw kant vereisen, dus u moet kiezen wanneer u ze wilt wijzigen. Je hebt tot 31 oktober 2027 de tijd om deze wijzigingen door te voeren. Op die dag zullen deze commando's worden aangepast aan de nieuwe API en zullen ze niet werken totdat ze correct zijn geconfigureerd.

API-versie selecteren

Beide commando's hebben nu een veld API-versie waarmee je 2022 of 2026 kunt specificeren. De standaardwaarde is 2022, dus een commando zonder waarde gebruikt 2022.

Andere wijzigingen

Opmerking: De uitvoernamen blijven hetzelfde, zodat de rest van uw keten gewoon blijft werken.

Run Report exporteert nu het rapport voordat het wordt gedownload. Dit kan langer duren en mislukt als de export langer dan ongeveer 5 minuten duurt. Het mag niet langer dan 10 minuten draaien.
List Users vereist dat de organization:read scope is opgenomen in uw OAuth2-grant.

Voor meer informatie over de API-wijzigingen, inclusief wijzigingen in spreadsheetopdrachten, raadpleegt u de Workiva-ondersteuningspagina Workiva Connector: Opdrachten verplaatst naar Platform API 2026-01-01 .

Rapport uitvoeren

Wat blijft hetzelfde?

Invoer: Rapport-ID , Voorbeeldinhoud .
Uitvoer: het Rapport CSV-bestand.
Het commando wordt pas voltooid als het bestand gereed is.

Wat verandert er op 1 januari 2026?

Het commando start een export van het rapport, controleert de status ervan ongeveer elke seconde en downloadt vervolgens het CSV-bestand.
Het ketenlogboek zal "Controleren van de operationele status...", een status van bevestigd , in de wachtrij of gestart weergeven, en "Bewerking succesvol voltooid." als de opdracht correct is voltooid. Als de opdracht niet correct wordt voltooid, wordt het bericht "Bewerking mislukt" in het logboek vastgelegd.
Deze opdracht kan langer duren dan in de versie van 2022-01-01, omdat de connector de export tot 300 keer of maximaal 10 minuten controleert, afhankelijk van wat zich het eerst voordoet. Bij één controle per seconde duurt dat ongeveer 5 minuten. Als de export dan nog niet is voltooid, mislukt de opdracht.
Tip: Als de time-out van het ketencommando korter is dan de exporttijd, verhoog deze dan zodat het bestand kan aankomen.
Een onjuist rapport-ID leidt meestal tot de foutmelding "bewerking mislukt".
Er is geen nieuwe toestemming nodig. De OAuth2-grant heeft nog steeds graph:read nodig.

Wijzig een commando naar 2026

Open de keten en selecteer de opdracht Rapport uitvoeren .
Stel API-versie in op 2026 .
Sla de keten op en voer deze uit.
Controleer of de Rapport uitvoer de gegevens bevat die u verwacht.

Probleemoplossing

Bericht	Wat te doen
`pogingslimiet van 300 overschreden of tijdslimiet van 10m0s overschreden`	Het exporteren van het rapport is niet op tijd voltooid. Verklein het rapport of de filters, of zet de opdracht terug naar "2022" en neem contact op met de ondersteuning.
`bewerking mislukt` of `bewerking is geannuleerd`	Controleer het rapport-ID. Als dit klopt, neem dan contact op met de supportafdeling en vermeld de ID's uit het logboek.
`FOUT: Gebruikersrapport kan niet worden uitgevoerd.`	Controleer de rapport-ID en of de toekenning `graph:read bevat.` Het volgende bericht bevat de API-gegevens.

Lijst gebruikers

Wat blijft hetzelfde?

Invoer: Organisatie-ID .
Uitvoer: het gebruikersrapport JSON-bestand en recordaantal .
De gebruiker die de OAuth2-machtiging verleent, moet een organisatiebeheerder zijn.

Wat verandert er op 1 januari 2026?

De OAuth2-grant die door de verbinding wordt gebruikt, moet de scope organization:read hebben.
Zonder die scope zal de opdracht mislukken met een HTML-foutmelding "Unauthorized (401)" of "Forbidden (403)" in plaats van een lijst met gebruikers terug te geven.

Wijzig een commando naar 2026

Een organisatiebeveiligingsbeheerder voegt organization:read toe aan de API-toekenning waarvan de client-ID is opgeslagen in uw Workiva-verbinding:
1. Klik rechtsboven op het gebruikerspictogram, selecteer Beheerder en vervolgens Organisatiebeheerder .
2. Selecteer in het menu aan de linkerkant Beveiliging en vervolgens het tabblad Inrichting .
3. Zoek die subsidie op en open deze via het menu Acties .
4. In Scopes , select organization:read and save. Het klantgeheim blijft hetzelfde.
Opmerking: organization:read is een organisatiebereik. Het wordt niet toegewezen vanuit de werkruimte-instellingen. Voor
meer informatie, zie de Workiva-ondersteuningspagina API-toekenningen maken en beheren in Organisatiebeheer .
Open de keten en selecteer de opdracht Gebruikers weergeven .
Stel API-versie in op 2026 .
Sla de keten op en voer deze uit.
(Optioneel, maar aanbevolen) Noteer de Record Count waarde.
1. Zet de waarde van de API-versie terug naar 2022 en voer de keten opnieuw uit.
2. Controleer of de waarde van Record Count hetzelfde is voor beide uitvoeringen.

Notities

De standaard API-versie is 2022-01-01, en dat is de versie die gebruikt wordt voor een commando zonder waarde.
Nieuwe commando's moeten worden ingesteld op 2026.
U kunt 2022 of 2026 kiezen voor elk van de volgende commando-instanties: Run Report en List Users .
De versie van 2022-01-01 zal op 30 november 2027 niet meer werken. U moet uw opdrachten vóór die datum naar 2026 verplaatsen.
De overige grafiekopdrachten van Workiva Connector worden op 30 november 2026 automatisch overgezet naar 2026-01-01 en u hoeft deze niet te wijzigen.
Hun JSON-uitvoer kan velden en items in een andere volgorde weergeven. De waarden zijn hetzelfde.

Probleemoplossing

Bericht	Wat te doen
`FOUT: Gebruikersrapport kan niet worden opgehaald.` , met status 401 of 403 in de foutentabel	Controleer of de API-toekenning `organization:read bevat` en of de gebruiker die de toekenning verleent een organisatiebeheerder is. Voer de opdracht vervolgens opnieuw uit.
`FOUT: Gebruikersrapport kan niet worden opgehaald.` , met een andere status	Controleer of het organisatie-ID correct is. De foutentabel bevat de API-details.

Wijzigingen in spreadsheetopdrachten

Deze worden ook automatisch bijgewerkt en er zijn geen ketenbewerkingen nodig. De in- en uitgangen blijven hetzelfde, maar een paar dingen werken anders:

Spreadsheet verwijderen verplaatst de spreadsheet naar de prullenbak in plaats van deze permanent te verwijderen.
Get Sheet Data negeert de revisiewaarde en retourneert de meest recente gegevens met een waarschuwing.
Schrijven , Overschrijven , Bladgegevens wissen , Bladmetagegevens bijwerken , Spreadsheet publiceren , en Spreadsheet verwijderen wachten nu tot de wijziging is voltooid en negeren de instelling Asynchroon gebruiken . Deze opdrachten zullen mislukken als de wijziging langer dan ongeveer 5 minuten duurt.
Get Sheet Data , Write Sheet Data , en Overwrite Sheet Data negeren de Use Platform API instelling.

Wat als ik niets doe?

Commando's die deze commando's gebruiken, blijven 2022-01-01 gebruiken tot 31 okt 2027 . Na die datum werken opdrachten die zijn ingesteld op 2022-01-01 niet meer.

Heeft u hulp nodig?

Neem contact op met Workiva Support .

Workiva-ondersteuningscentrum