Você quer se conectar a um aplicativo de terceiros além dos Premium Connectors pré-construídos da Workiva? Você pode fazer isso usando os comandos do conector de solicitação HTTP para interagir com as APIs REST.
Nota: Embora isso esteja etiquetado como solicitação HTTP, HTTPS (HTTP seguro) é suportado (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 Configurar o conector de solicitação HTTP Complete CLP | HTTP Request List Spreadsheets |
| Modelo de suporte | CLP | Solicitação HTTP Obter uma planilha individual |
Etapa 1: Copiar e Alterar uma Cadeia
- Navegue até o Construtor de cadeias e localize a cadeia CLP | Planilhas de 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 Definições de Cadeias no canto superior direito e renomeie a cadeia: CLP | HTTP Request Get a Single Spreadsheet.
- (Opção) Insira um Descrição: "Essa cadeia gera um novo token de acesso à API da 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 - Retrieve a Token para fora do nó inicial.
- Adicione um evento de cadeia Runtime Inputs de Chain Trigger Events ao nó inicial.
- Clique duas vezes no link que combina Runtime Inputs com o comando Get - List Spreadsheets e exclua o link.
- Conecte as entradas de tempo de execução ao comando POST - Retrieve a Token.
-
Conecte o comando POST - Retrieve a Token ao comando GET - List Spreadsheets.
- Clique duas vezes no evento em cadeia Runtime Inputs para configurá-lo.
- Clique em Add Input e configure os seguintes campos:
- Type (Tipo): Campo de texto
- Nome de exibição: Spreadsheet ID - consulte neste documento para obter ajuda para localizar o ID
- Obrigatório: Marque esta caixa de seleção
- (Opção) Insira uma Descrição: "Este comando permite que o usuário especifique os valores das entradas de tempo de execução necessárias."
- 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.
- Dê um clique duplo no comando Get - List of Spreadsheets para configurá-lo. Você pode usar o nome do comando: Get - Retrieve a Single Spreadsheet .
- Você pode nomear o comando: Get - Retrieve a Single Spreadsheet.
-
Use a variável Spreadsheet ID de Runtime Inputs no campo URL para especificar qual planilha você deve recuperar.
Para fazer isso, clique no campo URL e, depois de /spreadsheets, adicione "/<>",
substituindo <Spreadsheet> pela variável de Runtime Inputs da seguinte forma:- No painel esquerdo, expanda a lista suspensa Trigger.
- Expanda a lista suspensa Runtime Inputs.
- Selecione a variável Spreadsheet ID.
- (Opção) Insira uma Descrição: "Esse comando retorna uma única planilha. Para obter mais informações, consulte a documentação do desenvolvedor em https://developers.workiva.com/platform-v1/platform-getspreadsheetbyid/"
- Salve o comando.
Etapa 4: testar o exercício
Agora que a cadeia está concluída, podemos testar o resultado.
- Publicar a cadeia
- Clique em Execute e, em seguida, em Run with Inputs.
- Localize a planilha Spreadsheet ID, navegando até uma planilha na Workiva Platform. Certifique-se de que o usuário que concedeu o comando tenha permissão para essa planilha.
- Clique em Iniciar.
- Quando a Cadeias for executada, você poderá ver que os detalhes da planilha foram gerados na guia Outputs - Response Body do comando Get.
To continue to challenge yourself and learn more about using the HTTP Request Connector to connect to a third party API, check out the next exercise CLP Copy a Spreadsheet (add link when document created).
-->