De spreadsheetopdrachten van Workiva Connector 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 ketens blijven werken, zetten we alle Workiva Connector-opdrachten over naar versie 2026-01-01.
De meeste Workiva-connectorcommando's worden op 30 november 2026 automatisch overgezet naar 2026-01-01, en u hoeft uw ketens niet aan te passen. De in- en uitgangen veranderen niet.
Spreadsheetopdrachten
Met de introductie van API-versie 2026-01-01 hebben de spreadsheetopdrachten in de Workiva-connector nu een veld API-versie , waarin u moet kiezen tussen 2022 of 2026. De standaardwaarde is 2022, en een commando zonder waarde gebruikt 2022. Dit betekent dat Chain-opdrachten die zijn opgeslagen voordat het veld bestond, ook in 2022 blijven werken.
Op 31 oktober 2027 zullen we deze opdrachten verplaatsen naar 2026-01-01. Schakel vóór die tijd over, zodat je je kettingen in 2026 kunt testen.
Wat verandert er in 2026?
Deze tabel geeft de wijzigingen in de commando's weer:
| Commando | Wijziging |
|---|---|
| Bladgegevens schrijven, Bladgegevens overschrijven, Bladgegevens wissen, Bladmetagegevens bijwerken, Spreadsheet publiceren, Spreadsheet verwijderen |
|
| Spreadsheet verwijderen |
Verplaatst het spreadsheet naar de prullenbak, waar het kan worden hersteld. Een Get Spreadsheet Metadata -opdracht later in de keten zal mislukken met de melding "De geselecteerde spreadsheet is verwijderd". |
| Haal de gegevens op uit het spreadsheet. | Revisie wordt genegeerd. De opdracht retourneert de meest recente gegevens en records Waarschuwing: --revision wordt niet ondersteund door Platform API 2026. De meest recente gegevens van het werkblad zijn geretourneerd. in het logboek. Als uw keten een eerdere revisie nodig heeft, laat u de opdracht ingesteld staan op 2022. |
| Maak een spreadsheet aan | Bij een fout wordt de gedetailleerde lijst "Fouten:" niet meer weergegeven. |
| Verwijder het blad | Een spreadsheet die XBRL bevat, wordt met een API-bericht afgewezen. |
| Met opdrachten zoals 'Bladmetagegevens ophalen', 'Bladmetagegevens bijwerken' en andere opdrachten die een bladnaam vereisen, worden uitgevoerd. | Een bladnaam die zich na de eerste pagina van de bladen bevindt, wordt nu correct verwerkt. |
Andere wijzigingen
- Sommige foutmeldingen zoals "niet gevonden" verschillen tussen versies, dus als een latere opdracht de foutmelding controleert, kan deze zich in verschillende versies anders gedragen.
- Als de API-toekenning geen
file:readoffile:writewaarden bevat, zullen de 2026-opdrachten mislukken, wat de hele keten kan laten mislukken. - Hoewel de configuratiedialoogvensters voor Gegevens ophalen , Gegevens schrijven en Gegevens overschrijven een selectievakje Platform-API gebruiken bevatten, zullen deze opdrachten de 2026-API gebruiken als de API-versie 2026 is, zelfs als dat selectievakje niet is aangevinkt.
Wat blijft hetzelfde?
- De namen van de invoer- en uitvoerwaarden worden bij elk commando vermeld, zodat latere commando's blijven werken.
- Succesmeldingen: "Verwijderen succesvol", "Bijwerken succesvol", "Publiceren succesvol".
- Host-overrides op de verbinding. Je voegt er niets aan toe en je wijzigt er ook niets aan.
Vereisten: bestandsrechten (file:read) en bestandsrechten (file:write).
In de API van 2026 controleren deze commando's andere bereiken dan in de API van 2022. Tenzij deze rechten worden bijgewerkt, zal een commando dat werkt met de API van 2022 niet werken met de API van 2026.
- Commando's die een spreadsheet lezen , hebben het commando `
file: read` nodig. - Opdrachten die een spreadsheet wijzigen , vereisen
file: write .
Bereikwaarden toevoegen
Om deze scopes toe te voegen, moet een Workiva Org Security Admin de scopes toevoegen aan de API-grant waarvan de client-ID is opgeslagen in uw Workiva-verbinding:
- Klik rechtsboven op het gebruikerspictogram, selecteer Beheerder en vervolgens Organisatiebeheerder .
- Selecteer in het menu aan de linkerkant Beveiliging en vervolgens het tabblad Inrichting .
- Zoek die subsidie op en open deze via het menu Acties .
- In Scopes , select
file:readenfile:writeen sla de machtiging op. Het klantgeheim blijft hetzelfde.
Zie voor meer informatie API-machtigingen maken en beheren in Organisatiebeheer .
Stappen om een ketting om te schakelen naar 2026
- Zorg ervoor dat de machtiging
file:readenfile:write bevat.Zie Vereisten . - Maak de ketting open. Bij elke stap van de spreadsheetopdracht moet u de API -versie instellen op 2026 .
- Sla de keten op en voer deze uit.
- (Optioneel, maar aanbevolen) Vergelijk de volgende uitvoer met een eerdere run uit 2022: Aantal geschreven
rijen, Aantal geschreven cellen, het gegevens-CSV-bestand en Aantal werkbladen.
Als er iets mis is, zet de stappen dan terug naar 2022 en neem contact op met Workiva Support .
Gebruik slechts één API-versie in een keten Workiva raadt aan om één enkele API-versie te gebruiken voor alle stappen van spreadsheetopdrachten binnen een keten; we kunnen niet garanderen dat het combineren van meerdere API-versies naar behoren zal werken.
Probleemoplossing
| Bericht | Wat te doen |
|---|---|
De inloggegevens hebben niet de vereiste scope(s): file:read of file:write , met HTML-foutcode 401 |
De API-toekenning mist het bereik dat in het bericht wordt genoemd. Voeg het toe zoals beschreven in Vereisten , en voer de keten vervolgens opnieuw uit. Stel de opdracht tot die tijd in op 2022. |
|
De opdracht is niet op tijd voltooid. Verklein de gegevensgrootte, of stel de opdracht in op 2022 en neem contact op met Workiva Support . |
Bewerking mislukt of Bewerking geannuleerd |
Controleer de spreadsheet- en blad-ID's. Als ze kloppen, neem dan contact op met de ondersteuning en vermeld de bewerkings-ID die in het logboek staat. |
Het geselecteerde spreadsheet is verwijderd. |
Een eerdere stap Spreadsheet verwijderen met behulp van 2026 heeft deze naar de prullenbak verplaatst. Herstel het bestand of gebruik een ander spreadsheet. |
De API-versie moet 2022 of 2026 zijn. |
Het veld bevat een andere waarde. Stel het in op 2022 of 2026. |
Wat als ik niets doe?
Opdrachten die zijn ingesteld op 2022 zijn beschikbaar tot 31 oktober 2027 . Op die datum verplaatsen we ze naar 2026-01-01. Wijzig je commando's ruim van tevoren, zodat je tijd hebt om je ketens te testen.
Heeft u hulp nodig?
Neem contact op met Workiva Support .