Com o Chains, você pode automatizar tarefas rotineiras, com fácil integração para recuperar ou enviar dados em vários sistemas de registro. Por exemplo, você pode criar uma cadeia para extrair automaticamente informações financeiras de uma fonte de dados para uma tabela e, em seguida, enviar esses dados para outro sistema a fim de gerar um relatório. Em Chain Builder, você organiza e vincula as tarefas - ou comandos- que uma cadeia deve executar.
Nota: Somente os proprietários do espaço de trabalho ou os proprietários de cadeias podem acessar Chain Builder. Em Wdata, clique em Chains e, em seguida, clique em Open Chain Builder.
Com os exercícios em Get started with tables e Get started with queries, você cria tabelas e consultas como as usadas para relatórios financeiros. Neste exercício, vamos criar uma cadeia para executar essa consulta e exportar seus resultados para o Spreadsheets.
Etapa 1. Obtenha o ID e os parâmetros da consulta
Se você ainda não o fez, faça o download dos dados de amostra e execute os exercícios Get started with tables e Get started with queries, pois você usará a consulta na cadeia. Observe o ID da consulta, que é como você identificará a consulta na cadeia.
Observação: Quando você abre uma consulta no Wdata, seu ID aparece depois de /queries/ em seu URL.
Se você criou os filtros da consulta com parâmetros em vez de valores estáticos, observe também os nomes dos parâmetros. Por exemplo:
- PY ou Previous_Year (Ano anterior)
- CY ou Ano_Atual
- Current_Period (período atual)
Etapa 2. Criar a planilha
Antes de você criar a cadeia, crie uma planilha para exportar os resultados da consulta.
Para evitar o uso indevido da planilha, identifique claramente sua intenção educacional em seu nome.
Depois de criar a planilha, anote o URL; você o usará para identificar para onde exportar os resultados da consulta.
Etapa 3. Criar a cadeia
Agora é hora de você criar a cadeia! No final, ele incluirá comandos para executar a consulta e exportar os resultados mais recentes para o Spreadsheets.
Antes de criar uma cadeia, verifique se você configurou o conector do núcleo Workiva usado para executar seus comandos. Embora essa cadeia exija apenas um conector, as cadeias podem usar vários conectores para preparar e transferir dados entre os vários sistemas de registro.
Com o conector configurado, você pode adicionar a cadeia em Chain Builder:
- Em Wdata, clique em Chains , Chain Builder.
- Clique em Build, Chains e, em seguida, clique em Add, Create Chain no canto inferior direito.
-
Você pode inserir um nome e uma descrição exclusivos para ajudar a identificar a cadeia.
Observação: as cadeias aparecem no Chain Builder para todos no espaço de trabalho; nomeie-as para que os membros entendam claramente sua intenção. Consulte Leading practice: Naming conventions for Chains and their objects (Convenções de nomenclatura para cadeias e seus objetos) para obter mais informações sobre nomenclatura.
- Clique em Salvar.
Etapa 4. Comece com um evento de acionamento de entradas de tempo de execução
Para que a cadeia inicie solicitando as variáveis necessárias para seus comandos, adicione um evento de acionamento Runtime Inputs .
Dica: Além das entradas de tempo de execução, você pode adicionar variáveis à cadeia ou ao espaço de trabalho. Com variáveis, você pode estender o uso de uma cadeia, como qualquer consulta ou planilha em vez de apenas uma consulta ou planilha específica.
- Clique em Trigger events , mova Runtime inputs para Start, e clique em Edit .
- Em Informações básicas, insira um nome e uma descrição exclusivos para ajudar a identificar o evento.
-
Em Variables, adicione variáveis para:
- O ID da consulta
- Qualquer valor de parâmetro de consulta
- O URL da planilha
Dica: Para cada variável, clique em Add Input, selecione TextField e digite o nome, a descrição e o valor padrão.
- Clique em Salvar.
Etapa 5. Adicione um comando para executar a consulta
Em seguida, adicione um comando Run query para que a cadeia obtenha os resultados mais recentes sempre que for executada. Você usará as entradas de tempo de execução para identificar o ID da consulta e os valores dos parâmetros.
- Em Available Connectors, selecione Workiva e arraste Run query para a tela.
-
Arraste um link de Inicie para Execute a consulta e clique no link do comando Edite.
Observação: Certifique-se de vincular o comando a Inicie para que ele possa usar as entradas de tempo de execução.
- Em Basic info, digite um nome e uma descrição exclusivos para identificar o comando.
- Em Command properties, selecione o conector Workiva para executar o comando.
- Para Query ID, selecione a entrada de tempo de execução do ID da consulta em Trigger.
-
Se os filtros da consulta usarem valores de parâmetro, clique em Adicionar (+) em Parâmetros e insira seus pares de chave/valor:
Chave Valor PY ou Previous_Year Em Trigger, selecione a entrada de tempo de execução para o ano anterior. CY ou Current_Year Em Trigger, selecione a entrada de tempo de execução para o ano atual. Current_Period Em Trigger, selecione a entrada de tempo de execução para o período atual. - Clique em Salvar.
Etapa 6. Adicione um comando para exportar os resultados
Agora, adicione um comando para exportar os resultados da consulta para o Spreadsheets:
- Em Available Connectors, selecione Workiva e arraste Export query result para a tela.
- Arraste um link de Executar consulta para Exportar resultado da consulta e clique em Editar para este último.
- Em Basic info, digite um nome e uma descrição exclusivos para identificar o comando.
- Em Propriedades de comando, selecione o mesmo conector Workiva que Execute a consulta.
- Para ID do resultado da consulta, selecione ID para a saída Resultado da consulta em Execute a consulta.
- Para Spreadsheet URL, selecione a entrada de tempo de execução para o URL da planilha em Trigger.
- Clique em Salvar.
Etapa 7. Execute a cadeia
Para executar a corrente:
- Clique em Publish e, em seguida, em Publish novamente.
- Clique em Execute e, em seguida, em Run with inputs.
- Digite os valores dos inputs de tempo de execução e clique em Start.
- Para verificar se a cadeia foi bem-sucedida, verifique os resultados da consulta na planilha.
Se a cadeia falhar, clique nos comandos no histórico de execução para analisar seus registros e encontrar mensagens que ajudem a solucionar o erro.