Você quer se conectar a um aplicativo de terceiros além dos Premium Connectors pré-construídos da Workiva? É possível fazer isso utilizando os comandos do Conector de Solicitação HTTP para interagir com APIs REST.
Observação: Embora isso seja identificado como “Solicitação HTTP”, o HTTPS (HTTP seguro) é compatível (e recomendado).
Neste Connected Learning Path, atualizaremos nossa Cadeia para usar Runtime Inputs, em que podemos especificar a planilha que queremos recuperar.
| Caso de uso primário de negócios | Conectando-se a sistemas de terceiros |
| Objetivo principal de aprendizado | Utilize os comandos do conector de solicitação HTTP da Workiva para interagir com as APIs REST de aplicativos de terceiros além dos conectores pré-construídos. Atualizar Cadeias para usar Entradas de Tempo de Execução para especificar qual planilha você deve usar. |
| Objetivo de aprendizado secundário | Uso de entradas de tempo de execução |
| Pré-requisitos |
Configuração da concessão da API da Workiva |
| Modelo de suporte | CLP | Solicitação HTTP Obter uma planilha individual |
Etapa 1: Copiar e Alterar uma Cadeia
- Acesse o Chain Builder e localize as planilhas “Chain CLP | Lista de solicitações HTTP ”.
- Clique na elipse vertical para copiar a cadeia.
- Clique no ícone de lápis para editar a cadeia.
- Clique em “Configurações da cadeia” , no canto superior direito, e renomeie a cadeia: CLP | Solicitação HTTP para obter uma única planilha .
- ( Opcional ) Insira uma descrição : “Esta sequência gera um novo token de acesso à API do Workiva.” Você deve fornecer um Client ID e um Client Secret válidos de um API Grant gerado anteriormente nos valores da variável abaixo. Quando a cadeia for executada, ela solicitará que o usuário insira um ID de planilha. A Cadeia recuperará a planilha."
- Salve a cadeia.
Etapa 2: Entradas em tempo de execução
Use o evento “Runtime Inputs Chain ” para iniciar a cadeia.
Com isso, você pode especificar o ID da planilha que deseja obter. Leia mais sobre Runtime Inputs.
- Mova o comando POST – Recuperar um token para fora do nó inicial.
- Adicione um evento “Cadeia de entradas em tempo de execução ” da seção “Eventos de acionamento de cadeia” ao nó inicial.
- Clique duas vezes no link que vincula as Entradas de Tempo de Execução ao comando “Obter – Lista de planilhas” e exclua o link.
- Conecte as entradas de tempo de execução ao comando POST — Recuperar um token .
-
Conecte o comando POST — Obter um token ao comando GET — Listar planilhas .
- Clique duas vezes no evento “Cadeia de entradas de tempo de execução ” para configurá-lo.
- Clique em “Adicionar entrada ” e configure os seguintes campos:
- Tipo: Campo de texto
- Nome de exibição: ID da planilha — consulte este documento para obter ajuda para localizar o ID
- Obrigatório: Marque esta caixa de seleção
- ( Opcional ) Insira uma descrição : “Este comando permite que o usuário especifique os valores das entradas necessárias em tempo de execução.”
- Salve o comando.
Etapa 3: Atualizar o comando Get
Atualizaremos o comando HTTP Request Get para que você receba detalhes sobre uma única planilha em vez de listar todas as planilhas no espaço de trabalho|workspace.
- Clique duas vezes no comando “Get - Lista de planilhas ” para configurá-lo.
- Nome do comando: Get — Recuperar uma única planilha .
-
Utilize a variável “ID da planilha” , disponível em “Entradas de tempo de execução”, no campo “URL” para especificar qual planilha deve ser recuperada.
Para fazer isso, clique no campo URL e, após /spreadsheets , adicione “/ < ID da planilha > ”,
substituindo por <Spreadsheet ID> com a variável proveniente das entradas de tempo de execução , da seguinte forma:- No painel à esquerda, expanda o menu suspenso “Trigger ”.
- Expanda o menu suspenso “Entradas de tempo de execução ”.
- Selecione a variável “ID da planilha ”.
- ( Opcional ) Insira uma descrição : “Este comando retorna uma única planilha.” Para obter mais informações, consulte a documentação para desenvolvedores em https://developers.workiva.com/2026-01-01/getspreadsheetbyid.html"
- Salve o comando.
Etapa 4: testar o exercício
Agora que a cadeia está concluída, podemos testar o resultado.
- Publique a cadeia.
- Clique em “Executar ” e, em seguida, em “Executar com entradas ”.
- Encontre um ID da planilha, acessando uma planilha na Plataforma Workiva. Certifique-se de que o usuário que concedeu o comando tenha permissão para essa planilha.
- Clique em Iniciar .
- Assim que a cadeia concluir sua execução, você poderá verificar que os detalhes da planilha foram gerados na guia “Saídas” — no corpo da respostado comando GET .