De API-collectie gebruiken: een bestand importeren in Workiva

Invoering

Dit artikel beschrijft het proces van het importeren van een bestand in Workiva met behulp van de Workiva API-collecties.

Je moet alle stappen uit de handleiding Workiva API-collecties importeren in Postman succesvol hebben voltooid.

Open je Postman-werkruimte en zorg ervoor dat je de juiste omgeving selecteert.
Vouw de map oauth2 uit, vervolgens de map oauth2 en open het verzoek Een token ophalen.
Klik op Verzenden om dit verzoek uit te voeren en uw authenticatietoken te genereren. Dit token wordt automatisch opgeslagen in de omgevingsvariabele {{access_token}} en wordt automatisch ingevuld bij alle endpoint-verzoeken die u uitvoert.

Opmerking: Het token verloopt na 600 seconden (10 minuten). U moet deze stap vervolgens herhalen om een nieuw token te genereren.

Vouw de Workiva API -collectie uit, gevolgd door de Files -mappen en vervolgens de Import -mappen.
Open de Start een verzoek om een bestand te importeren
Bewerk de aanvraagbody met de volgende details.
- Bestandsnaam: De naam van het te importeren bestand. Ondersteunde extensies zijn onder andere (.XLSX, .CSV, .DOCX, .PPTX, .VSDX, .TAR.GZ)
- Soort: Het Workiva-bestandstype waarnaar u wilt uploaden (Document, Spreadsheet, Presentatie).
Verzend het POST verzoek.
Kopieer de UploadUrl die wordt geretourneerd vanuit de Body.
Maak een nieuw PUT verzoek aan en voer de UploadURL van het vorige verzoek in.
Selecteer het tabblad 'body' en kies de binaire optie .
Selecteer in het dropdownmenu [ Bestand selecteren het bestand dat u vanaf uw lokale computer wilt uploaden.
Zorg ervoor dat het bestandstype overeenkomt met het type dat in het vorige verzoek is opgegeven. Als bijvoorbeeld kind = Document, moet het bestand dat je uploadt een .docx bestand zijn.
Klik op verzenden
Je zou een 200-reactie moeten zien.
Controleer vervolgens Workiva; het bestand zou daar moeten staan. In dit voorbeeld is het een Workiva-document.