Utiliser l'API Collection : Importer un fichier dans Workiva

Introduction

Cet article vous guide dans le processus d'importation d'un fichier dans Workiva à l'aide des collections de l'API Workiva.

Vous devez avoir terminé avec succès toutes les étapes du guide Importing Workiva API Collections into Postman.

Ouvrez votre espace de travail postman et assurez-vous de choisir l'environnement correct.
Développez le dossier oauth2, puis le dossier oauth2 et ouvrez la requête Retrieve a token.
Cliquez sur Send pour exécuter cette demande et générer votre jeton d'authentification. Ce jeton est automatiquement stocké dans la variable d'environnement {{access_token}} et sera rempli automatiquement dans toutes les demandes de points d'extrémité que vous exécutez.

Note : Le jeton expirera après 600 secondes (10 minutes) et vous devrez alors répéter cette étape pour en générer un nouveau.

Développez la collection Workiva API, puis les dossiers Files et Import .
Ouvrez la demande Initier une importation de fichiers.
Modifiez le corps de la demande avec les détails suivants.
- Nom du fichier: Le nom du fichier à importer. Les extensions prises en charge sont les suivantes : (.XLSX, .CSV, .DOCX, .PPTX, .VSDX, .TAR.GZ)
- Type: Le type de fichier Workiva à télécharger (Document, feuille de calcul, présentation).
Envoyez la requête POST .
Copiez l'adresse UploadUrl renvoyée par le corps du message.
Créez une nouvelle demande PUT et saisissez le UploadURL de la demande précédente.
Sélectionnez l'onglet corps et choisissez l'option binaire .
Dans la liste déroulante Select file, sélectionnez le fichier que vous souhaitez télécharger depuis votre machine locale.
Assurez-vous que le type de fichier correspond au type spécifié dans la demande précédente. Par exemple, si kind = Document, le fichier que vous téléchargez doit être un fichier .docx.
Cliquez sur envoyer
Vous devriez obtenir une réponse de 200
Vérifiez ensuite Workiva et le fichier devrait s'y trouver. Dans cet exemple, il s'agit d'un format de document Workiva.