Centro de suporte da Workiva

Com essa cadeia, você pode recuperar o valor do parâmetro de uma consulta de uma planilha - por exemplo, para se concentrar em uma entidade ou período de tempo específico - e, em seguida, executar a consulta e exportar seus resultados para outra planilha.

Ingredientes

Para criar esta corrente, você precisará de:

• Um núcleo Workiva conector
• Um núcleo Tabular Transformation conector

Etapa 1. Criar a cadeia

1. Em Chain Builder, na guia Chains device_hub, clique em Create chain.
2. Em Setup, digite um nome e uma descrição exclusivos para ajudar a identificar a cadeia e sua intenção.
3. Em Variables, adicione variáveis para as planilhas e a consulta com as quais você trabalhará.

   Nome	Valor
   ID da consulta	Digite o ID da consulta a ser executada. Dica: No URL da consulta, o ID aparece após queries/.
   ID da planilha	Digite o ID da planilha com o valor a ser recuperado para o parâmetro da consulta. Dica: No URL da planilha, seu ID aparece depois de spreadsheet/.
   Sheet ID	Insira o ID da planilha com o valor a ser recuperado para o parâmetro da consulta. Dica: No URL da planilha, o ID da planilha aparece depois de sheet/.
   URL da planilha	Para exportar os resultados da consulta para uma planilha existente, digite o URL completo. Observação: Se a cadeia sempre criar novas planilhas com base nos resultados da consulta, essa variável será desnecessária.

4. Clique em Salvar.

Etapa 2. Comece com o comando Get sheet data (Obter dados da planilha)

Para recuperar o valor do parâmetro de consulta da célula de uma planilha, inicie a cadeia com um comando Get sheet data.

1. Em Available Connectors, selecione Workiva e mova Get sheet data para Start.
2. Clique em Edit para o comando e digite o nome e a descrição em Basic info.
3. Em Command properties, selecione o conector Workiva para executar o comando.
   
4. Para Spreadsheet ID, selecione a variável de cadeia com o ID da planilha para o valor do parâmetro.
5. Para Sheet Name/ID, selecione a variável de cadeia com o ID da planilha para o valor do parâmetro.
6. Para Region, digite a célula da qual você deseja recuperar o valor, na representação A1 de [coluna][linha].
7. Para Value Style, selecione se você deseja recuperar o valor bruto ou calculado da célula. Por exemplo, se a célula contiver 1 + 1, selecione Raw value (Valor bruto) para a fórmula explícita ou Calculated (Calculado) para a soma de 2.
8. Para Revisão, digite a revisão da planilha da qual você deseja recuperar o valor. Para a versão atual, digite -1.
9. Clique em Salvar.

Etapa 3. Adicionar um comando Extract value

Para usar o valor recuperado da planilha com o parâmetro de consulta, adicione um comando Extract value.

1. Em Available Connectors, selecione Tabular Transformation e mova Extract value para a tela.
2. Arraste um link de Start para Extract value e clique em Edit para o comando.
3. Em Informações básicas, digite um nome e uma descrição para ajudar a identificar o comando.
4. Em Propriedades do comando, selecione o conector Tabular Transformation para executar o comando.
5. Para Input file, selecione a saída Data do comando Get sheet data.
   
6. Como o comando Get sheet data recupera apenas o valor de uma célula, deixe Column index, Delimiter, e Row index com seus respectivos valores padrão de 0, Vírgula e 1.
7. Clique em Salvar.

Etapa 4. Adicionar um comando Run query

Para aplicar o valor recuperado como parâmetro e depois executar a consulta, adicione um comando Run query.

1. Em Available Connectors, selecione Workiva e mova Run query para a tela.
2. Arraste um link de Extrair valor para Executar consulta e clique em Editar para este último.
3. Em Informações básicas, digite um nome e uma descrição para ajudar a identificar o comando.
4. Em Propriedades de comando, selecione o mesmo conector Workiva que Get sheet data.
5. Para Query ID, selecione a variável de cadeia para o ID da consulta.
6. Em Parâmetros, clique em Adicionar e aplique o valor da planilha ao parâmetro da consulta:
   • Em Key, digite o nome do parâmetro para usar o valor.
   • Em Value, selecione a saída Value do comando Extract value.
7. Clique em Salvar.

Etapa 5. Adicionar um comando Exportar resultado da consulta

Para exportar os resultados da consulta para o Spreadsheets, adicione um comando Exportar resultado da consulta.

1. Em Available Connectors, selecione Workiva e mova Run query para a tela.
2. Arraste um link de Run query para Export query result e clique em Edit para este último.
3. Em Informações básicas, digite um nome e uma descrição para ajudar a identificar o comando.
4. Em Propriedades de comando, selecione o mesmo conector Workiva que Get sheet data.
   
5. Para ID do resultado da consulta, selecione ID na saída Resultado da consulta do comando Executar consulta.
6. Para Spreadsheet URL, especifique se você deseja exportar os resultados para uma planilha nova ou existente:
   • Para exportar para uma nova planilha, deixe em branco Spreadsheet URL.
   • Para exportar para uma planilha existente, selecione a variável de cadeia para o URL da planilha.
7. Clique em Salvar e Publicar.