Automatizar as atualizações de conexão é essencial para simplificar a centralização e a movimentação de dados para a plataforma Workiva, especialmente quando existem várias conexões. Nesta trilha de aprendizagem conectada, aprenderemos a criar uma cadeia que atualiza uma lista de conexões entre o Wdata e a plataforma Workiva usando um ID de planilha. Essa cadeia gerará uma lista de conexões em uma única planilha e, em seguida, nos fornecerá a lista de IDs dessas conexões, para que possamos atualizar automaticamente cada conexão na planilha.
| Caso de uso principal de negócios | Conectividade de dados entre a Workiva e o Wdata |
| Objetivo principal de aprendizado | Aprender a atualizar uma lista de conexões usando cadeias |
| Objetivos secundários de aprendizado | Aprender os fundamentos dos Iteradores de Grupo |
| Pré-requisitos |
Configurar o Workiva Connector Preencha o formulário CLP | Refresh Connections with a Parameter (Atualizar conexões com um parâmetro) Fornecer permissões à planilha para o usuário de concessão de OAuth associado |
| Modelo de suporte | CLP | Atualizar lista de conexões |
Etapa 1: Criar uma corrente
- Adicionar uma nova corrente
- Nomeie a cadeia: CLP | Atualizar lista de conexões
- Salvar a corrente
Etapa 2: Entradas em tempo de execução
Usamos o comando Runtime Inputs para iniciar a cadeia. Isso nos permite especificar para qual planilha queremos atualizar todas as conexões.
- Adicione um evento em cadeia de entradas de tempo de execução a partir dos eventos de disparo em cadeia do nó inicial
- Edite o evento de cadeia de entradas de tempo de execução clicando duas vezes no comando
- Type: TextField
- Nome de exibição: Spreadsheet ID
- Obrigatório: Verificado
- Salvar o comando
Etapa 3: Listar conexões
Usaremos o comando List Connections para recuperar a lista de IDs de conexão associados ao ID da planilha. A saída do comando List Connections será um arquivo JSON que consiste em cada conexão na planilha com detalhes relacionados à conexão, inclusive o ID da conexão.
- Adicione um comando List Connections do Workiva Connector à tela Chain
- Conecte o comando Runtime Inputs ao comando List Connections
- Clique duas vezes no comando para configurá-lo
- Tipo de destino: Planilha
- Destination ID (ID de destino): Use a variável Spreadsheet ID de Runtime Inputs - isso nos permite enviar o valor especificado no tempo de execução da cadeia para o comando Refresh Connections (Atualizar conexões)
- Clique no campo Destination ID (ID de destino)
- No painel esquerdo, expanda o menu suspenso Trigger
- Expanda o menu suspenso Runtime Inputs
- Selecione a variável Spreadsheet ID
- Salvar o comando
Etapa 4: Grupo de comandos
Usaremos um grupo de comandos para ativar a iteração em cada conexão. O Iterador de grupos fará com que cada conexão na planilha passe pelas etapas a seguir, uma a uma.
- Adicione um grupo de comandos à tela Chain
- Conecte o comando List Connections à seção In do grupo de comandos
- Clique duas vezes no comando para configurá-lo
- Nomeie o grupo: Connections Iteration (Iteração de conexões)
- Navegue até a guia Iterators (Iteradores)
- Ative o botão de alternância Iterations e clique no campo Iterations
- No painel Select a Variable, clique na seta para baixo para expandir List Connections
- Selecione a saída Connections
- Ative o botão de alternância Iterations e clique no campo Iterations
- Salvar o grupo de comandos
Etapa 5: Atualizar conexão
Usaremos o comando Refresh Connection para atualizar nossas conexões usando o ID de conexão da iteração.
- Adicione um comando Refresh Connection do Workiva Connector à tela Chain
- Conecte a seção Start do Group Iterator ao comando Refresh Connection
- Clique duas vezes no comando para configurá-lo
- ID da conexão: use o ID da conexão do iterador Group - Connections Iteration. Isso nos permite enviar o ID da iteração atual para o comando Atualizar conexões
- Clique no campo ID da conexão
- No painel esquerdo, expanda o menu suspenso Group Iterator
- Expanda o menu suspenso Connections Iteration
- Selecione a variável ConnectionId
- Use Previous Source Parameters: Verificado
- Isso nos permite atualizar uma conexão usando os valores de parâmetro anteriores da fonte - no nosso caso, a consulta com o parâmetro Country ainda será atualizada com o Brasil como valor de filtro
- ID da conexão: use o ID da conexão do iterador Group - Connections Iteration. Isso nos permite enviar o ID da iteração atual para o comando Atualizar conexões
Etapa 6: Teste o exercício
Agora que a cadeia está concluída, teste o resultado.
- Publicar a cadeia
- Clique em Execute e, em seguida, selecione Run With Inputs
- Encontre o ID da planilha
- Navegue até a planilha CLP Employee Overview Spreadsheet
- No URL, selecione o ID da planilha, que se encontra após "spreadsheet/" e antes de "/sheet".
- Por exemplo, o ID da planilha está em negrito aqui: app.wdesk.com/a/QWNjb3VudB8yMDkwNzExMDQ0/spreadsheet/de9a4ab1374f4d438c9585a94dd9acf4/-1/sheet/3161ee0402ec4b9fa4e937e6f0f63b13
- Navegue de volta ao Construtor de cadeias e cole o ID da planilha no campo ID da planilha
- Clique em Iniciar.
- Após a conclusão da cadeia, volte para a planilha e veja que as duas conexões foram atualizadas com sucesso!
Execução bem-sucedida da cadeia com duas iterações:
Atualização bem-sucedida da conexão:
Para saber mais sobre o uso de cadeias para simplificar a coleta de dados, confira o restante dos caminhos de centralização de dados em !