Centro de suporte da Workiva

Você assistiu ao webinar Chains Foundations? Você quer acompanhar no seu próprio ritmo? Nesta trilha de aprendizagem conectada, criaremos uma cadeia que baixa dados de uma fonte, faz upload para uma tabela Wdata e atualiza conexões, seguindo as etapas realizadas durante o webinar Chains Foundations.

Etapa 1: Criar uma corrente

Para automatizar a movimentação dos nossos dados de origem para os relatórios finais, primeiro precisamos criar uma cadeia que orquestrará o processo do início ao fim. Como sempre usaremos a mesma planilha e a mesma tabela, configuraremos variáveis de cadeia para armazenar esses detalhes para acesso consistente.

1. Crie uma nova cadeia e nomeie a cadeia: CLP | Fundamentos de cadeias.

2. Em Chain Variables, clique duas vezes no sinal de mais para criar duas Chain Variables e configurá-las conforme descrito abaixo:

   Variável 1:

   • Tipo: Cadeias variáveis (cv)
   • Nome: cv-Spreadsheet ID
   • Valor:O ID da planilha CLP Company Spend by Department que foi criada no CLP Wdata Foundations.
   • Para localizar o ID da planilha:
     1. Navegue até a planilha CLP Company Spend by Department Spreadsheet.
     2. No URL, selecione o ID da planilha, que se encontra após "spreadsheet/" e antes de "/sheet". 
        Por exemplo, a ID da planilha é mostrada em negrito aqui: app.wdesk.com/a/QWNjb3VudB8yMDkwNzExMDQ0/spreadsheet/6c4a23966c3c4a10a3178ae5791db7fd/-1/sheet/3161ee0402ec4b9fa4e937e6f0f63b13

   Variável 2:

   • Tipo: Cadeias variáveis (cv)
   • Nome: cv-Table ID
   • Valor: insira o ID da tabela de despesas da empresa CLP.
   • Para localizar o ID da tabela:
     1. Navegue até a tabela CLP Company Spend.
     2. No URL, selecione o ID da tabela, que se encontra após "table/". 
        Por exemplo, o ID da tabela é mostrado em negrito aqui: app.wdesk.com/s/wdata/a/QWNjb3VudB8yMDkwNzExMDQ0/tables/16aba1634ead43a29df8f839422582f0
3. Salve a Cadeia.

Etapa 2: Download do arquivo

O comando HTTP Request Get será usado para fazer o download do arquivo que será carregado na tabela. Hospedamos arquivos on-line para que a Cadeia faça o download para demonstrar o download de arquivos da nuvem. Para tornar esse processo dinâmico, adicionaremos o período atual ao URL, que corresponde ao mês em que estamos e garantirá que estamos extraindo o conjunto de dados atual.

1. Adicione um comando Get do conector HTTP Request à área inicial.
2. Clique duas vezes no comando para configurá-lo.
   1. Preencha o campo URL com o conteúdo abaixo, usando uma variável para gerar o mês atual, que corresponde ao período:
      https://cs-sftp-training-bucket.s3.amazonaws.com/cs-training/Webinars/ERP-P <System.DateTime>.csv.
   2. Substitua <System.DateTime> pela variável de tempo de execução da data e hora do sistema.
   3. No painel Select a Variable, clique na seta para baixo para expandir Runtime.
   4. Selecione System.DateTime.
   5. Clique na variável System.DateTime para transformá-la. Use os seguintes valores:
      1. Para Selecione a transformação:, selecione Parse Date/Time.
      2. Clique no botão +.
      3. Para Lista suspensa de formatos:, selecione ISO Extended (Platform Standard).
      4. Para Formato da data de saída:, selecione %m.
         Essa saída significa que você receberá apenas o mês de dois dígitos da data e hora do sistema.
         Saiba mais sobre as transformações comuns de data e hora aqui.
      5. No campo Input date timezone e no campo Output date timezone, selecione o fuso horário atual.
      6. Clique em Aceitar.
         
3. Atualize o campo Content type para: application/csv.
4. Salvar o comando

Etapa 3: Criar arquivo

O upload de um arquivo para uma tabela Wdata é um processo de duas etapas. O arquivo precisará primeiro ser criado no status Staged antes de ser importado para uso final. Usaremos o comando Create File para criar o arquivo dentro da tabela Wdata no status Staged, indicando que ele foi criado, mas ainda não foi importado como um conjunto de dados.

1. Adicione um comando Create File do Workiva Connector à tela Chain.
2. Conecte o comando Get ao comando Create File.
3. Clique duas vezes no comando para configurá-lo.
   1. Clique no campo Table ID.
      1. No painel esquerdo Select a Variable (Selecionar uma variável), clique na seta para baixo para expandir Chain.
      2. Selecione cv-Table ID.
   2. Clique no campo File (Arquivo ).
      1. No painel esquerdo Select a Variable (Selecionar uma variável), clique na seta para baixo para expandir GET.
      2. Selecione Response.
   3. Preencha o campo Name com as informações abaixo, seguindo as mesmas etapas anteriores para preencher o campo Period in the name:
      ERPSpendData<System.DateTime>.csv
   4. Substitua <System.DateTime> pela variável de tempo de execução da data e hora do sistema.
      1. No painel esquerdo Select a Variable, clique na seta para baixo para expandir Runtime.
      2. Selecione System.DateTime.
      3. Clique na variável System.DateTime para transformá-la.
         1. Para Selecione a transformação, selecione Parse Date/Time.
         2. Clique no botão + .
         3. Para Formato, selecione ISO Extended (Platform Standard).
         4. Para Formato da data de saída, selecione %m-%d-%Y@T%H:%M.
            Essa saída significa que você só receberá a data e a hora completas de quando a cadeia for executada.
            Saiba mais sobre as transformações comuns de data e hora aqui.
         5. No campo Input date timezone e no campo Output date timezone, selecione o fuso horário atual.
         6. Clique em Aceitar.
            
4. Clique em Salvar para salvar o comando.

Etapa 4: Importar arquivo para a tabela

A segunda etapa do processo de upload de arquivos para tabelas Wdata é importar os dados, tornando-os utilizáveis em consultas. Essa etapa pega o arquivo preparado e o importa para a tabela designada como um conjunto de dados.

1. Adicione um comando Import File into Table do Workiva Connector à tela Chain.
2. Conecte o comando Create File ao comando Import File into Table.
3. Clique duas vezes no comando para configurá-lo.
4. Clique no campo Table ID.
   1. No painel esquerdo Select a Variable (Selecionar uma variável), clique na seta para baixo para expandir Chain.
   2. Selecione cv-Table ID.
5. Clique no campo File ID.
   1. No painel esquerdo Select a Variable (Selecionar uma variável), clique na seta para baixo para expandir Create File (Criar arquivo).
   2. Clique na seta para baixo para expandir Result.
   3. Selecione Id.
6. Salvar o comando

Etapa 5: 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.

1. Adicione um comando List Connections do Workiva Connector à tela Chain.
2. Conecte o comando Import File to Table ao comando List Connections.
3. Clique duas vezes no comando para configurá-lo.
   • Tipo de destino: Spreadsheet (Planilha)
   • Destination ID (ID de destino): Use a variável Spreadsheet ID Chain
     1. Clique no campo Destination ID (ID de destino).
     2. No painel de variáveis à esquerda, expanda o menu suspenso Chain.
     3. Selecione a variável Spreadsheet ID.
4. Salvar o comando

Etapa 6: Grupo de comandos

Usaremos um Command Group para ativar a iteração em cada conexão. O Iterador de grupo fará com que cada conexão na planilha passe pelas etapas a seguir, uma a uma.

1. Adicione um grupo de comandos à tela Cadeia.
2. Conecte o comando List Connections à seção In do Command Group.
3. Clique duas vezes no comando para configurá-lo.
   1. Nomeie o grupo: Connections Iteration (Iteração de conexões)
   2. Navegue até a guia Iterators.
   3. Ative o botão de alternância Iterations e clique no campo Iterations.
      1. No painel Select a Variable, clique na seta para baixo para expandir List Connections.
      2. Selecione a saída Connections.
4. Salve o grupo de comandos.

Etapa 7: Atualizar conexão

Usaremos o comando Refresh Connection para atualizar nossas conexões usando o ID de conexão da iteração.

1. Adicione um comando Refresh Connection do Workiva Connector à tela Chain.
2. Conecte a seção Start do Group Iterator ao comando Refresh Connection.
3. Clique duas vezes no comando para configurá-lo.
   • Para ID de conexão:, use a ID de conexão do iterador do grupo - Iteração de conexões. Isso nos permite enviar o ID da iteração atual para o comando Atualizar conexões
     1. Clique no campo ID da conexão.
     2. No painel esquerdo, expanda o menu suspenso Group Iterator.
     3. Expanda o menu suspenso Connections Iteration.
     4. Selecione a variável ConnectionId.
   • Marque a caixa de seleção Use Previous Source Parameters.

Etapa 8: Teste o exercício

Agora que a cadeia está concluída, teste o resultado.

1. Publicar a cadeia
2. Clique em Execute e, em seguida, em Run Chain.
3. Após a conclusão da cadeia, volte para a tabela e veja que os dados foram carregados, navegue até a planilha e veja que a conexão foi atualizada com sucesso.

Execução bem-sucedida da cadeia

Dados adicionados à tabela

Conexões atualizadas