O modelo Iniciar exportação de planilha permite exportar planilhas da Workiva nos formatos PDF, XLSX ou CSV. Esse recurso é normalmente usado para fazer backup de planilhas, permitir a edição off-line ou compartilhar apresentações da Workiva com usuários fora do espaço de trabalho.
Requisitos
- Você deve ter acesso ao ID do cliente e ao segredo do cliente por meio de sua concessão OAuth2.
- Os seguintes conectores devem ser configurados em seu espaço de trabalho:
Crie sua cadeia
O modelo Iniciar exportação de planilha está localizado na seção Cadeias Workiva da tela Modelos.
Veja como encontrá-lo:
- Em Construtor de Cadeia, vá para a guia Modelos .
- Selecione Cadeias Workiva no menu na parte superior.
- Procure por Iniciar exportação de planilha no canto superior direito e abra o modelo.
Depois de localizar seu modelo, configure-o para seu espaço de trabalho usando as variáveis e entradas de tempo de execução listadas abaixo.
Observação: Para obter instruções detalhadas sobre como criar uma cadeia a partir de um modelo, consulte o artigo Criar e gerenciar cadeias.
Variáveis
| Tipo de variável | Nome da variável | Descrição | Necessário? |
| Cadeia dinâmica | dcv-exportStatus | Usado para capturar o status de exportação da planilha. | Sim |
| Cadeia dinâmica | dcv-resourceURL | O nome da planilha ou o valor de ID. | Sim |
| Espaço de trabalho | wsv-ClientID | ID gerado a partir da concessão do OAuth2 para seu conector Workiva. | Sim |
| Espaço de trabalho | wsv-Secreto | Token secreto gerado a partir da concessão do OAuth2 para seu conector Workiva. | Sim |
| Espaço de trabalho | wsv-IAMURL | O URL de substituição de host do IAM. | Sim |
| Espaço de trabalho | wsv-PlatformURL | O URL de substituição do host da API da plataforma. | Sim |
Entradas de tempo de execução
| Entrada em tempo de execução | Descrição | Opções | Necessário? |
| ExportFormat | Indica o formato da exportação. | .pdf ou .xlsx ou .csv | Sim |
| ExportID | O ID da planilha. | Sim | |
| ExportFileName | Pode ser usado ao fazer upload ou enviar um e-mail para substituir o nome padrão do arquivo. | Não | |
| Folhas |
Os IDs das planilhas dentro da planilha a ser exportada. Se esse campo for deixado em branco, a planilha inteira será exportada como um arquivo .zip contendo arquivos .csv separados de cada planilha. |
Não | |
| Opções de exportação do CVS | Ao exportar para o formato .csv, isso fornece especificações sobre o objeto exportado. |
ExportAsFormulas |
Não |
| Opções de exportação XLSX | Ao exportar para o formato .xlsx, isso fornece especificações sobre o objeto exportado. |
|
Não |
| Opções de exportação de PDF | Ao exportar para PDF, isso fornece especificações sobre o objeto exportado. |
|
Não |
Observação: Se os campos opcionais forem deixados em branco, o objeto inteiro será exportado sem nenhuma especificação aplicada.
Coisas para saber
- Ao exportar uma planilha inteira como .csv, a solicitação HTTP deve ser renomeada com uma extensão .zip. O resultado será uma pasta contendo cada planilha individual no formato .csv.
Configuração da notificação de entrega de e-mail
Para receber o arquivo exportado, você deve configurar adicionalmente o comando Get (Final Resource) com uma notificação por e-mail:
- Enquanto estiver editando a cadeia Iniciar exportação de planilha, selecione o comando Get (Final Resource) e clique no lápis de criação Edit
- Clique no ícone do envelope para abrir a tela Notificações.
- Clique no botão + Nova notificação.
- Abra o menu suspenso "Condition" (Condição) e selecione Sucesso.
- Abra o menu suspenso "Recipients" (Destinatários) e selecione o e-mail de todos os usuários que devem receber o objeto exportado.
- Abra o menu "Attachments" (Anexos) e selecione a saída do arquivo do comando Get (Final Resource).
Esse processo enviará ao destinatário do e-mail um arquivo HTTP. O destinatário deve então renomear manualmente a extensão do arquivo para o formato desejado:
- File_name.txt. => file_name.pdf
- File_name.txt => file_name.xlsx
Solução de problemas
Se sua cadeia acionou um erro ou não conseguiu atualizar os dados corretos, verifique o seguinte:
- Todas as variáveis do espaço de trabalho estão corretas. Se estiver usando um espaço de trabalho de área restrita, use a versão de área restrita dos URLs de IAM/Plataforma.
- Você incluiu todas as entradas de tempo de execução necessárias, como a planilha e o ID de exportação.
- Você configurou uma definição de notificação por e-mail para o comando Get (Final Result).