Introdução
Este artigo orienta você no processo de importação de um arquivo para a Workiva usando as coleções da API da Workiva.
Pré-requisitos
Você deve ter concluído com êxito todas as etapas do guia Importing Workiva API Collections into Postman.
Autenticação
- Abra o espaço de trabalho do postman e certifique-se de escolher o ambiente correto.
-
Expanda a pasta oauth2, seguida pela pasta oauth2 e abra a solicitação Retrieve a token.
- Clique em Send para executar essa solicitação e gerar seu token de autenticação. Esse token é armazenado automaticamente na variável de ambiente {{access_token}} e será preenchido automaticamente em todas as solicitações de endpoint que você executar.
Observação: O token expirará após 600 segundos (10 minutos) e você precisará repetir esta etapa para gerar um novo token.
Iniciar uma importação de arquivo
- Expanda a coleção Workiva API, seguida pelas pastas Files e Import .
- Abra a solicitação Iniciar uma importação de arquivo.
- Edite o corpo da solicitação com os seguintes detalhes.
- FileName: O nome do arquivo a ser importado. As extensões compatíveis incluem (.XLSX, .CSV, .DOCX, .PPTX, .VSDX, .TAR.GZ)
-
Tipo: O tipo de arquivo da Workiva para o qual fazer upload (Document, Spreadsheet, Presentation).
- Envie a solicitação POST .
- Copie o UploadUrl que é retornado do Body.
- Crie uma nova solicitação PUT e insira o UploadURL da solicitação anterior.
- Selecione a guia body (corpo) e escolha a opção binária .
- No menu suspenso Select file, selecione o arquivo que deseja carregar de seu computador local.
- Verifique se o tipo de arquivo corresponde ao tipo especificado na solicitação anterior. Por exemplo, se kind = Document, o arquivo que você carregar deverá ser um arquivo .docx.
-
Clique em enviar
- Você deverá ver uma resposta 200
-
Em seguida, verifique o Workiva e o arquivo deverá estar lá; neste exemplo, ele está em um formato de documento do Workiva.
Em seguida, veja como exportar um arquivo usando a API Collection.