Centro de suporte da Workiva

O que acontece se a cadeia falhar? É essencial que os usuários finais estejam totalmente informados sobre os possíveis resultados. Neste Connected Learning Path, aprimoraremos nossa cadeia primária incorporando ramificações adicionais que se comunicarão com nossa planilha de controle, indicando especificamente quaisquer falhas. Essa cadeia expandida oferecerá uma camada extra de transparência, permitindo que os usuários identifiquem facilmente a data da última execução bem-sucedida do comando. Além disso, você terá uma visibilidade clara se a cadeia foi operada com sucesso ou se encontrou algum problema. Esse aprimoramento garante que os usuários estejam bem equipados com as informações necessárias para monitorar e solucionar prontamente quaisquer possíveis falhas.

Etapa 1: Editar a cadeia existente

• Navegue até o Construtor de cadeias e localize a cadeia CLP | Execução de processos e registro de resultados em uma planilha de controle
• Clique no botão de lápis para editar a cadeia
• Clique em Chain Settings no canto superior direito 
  • Renomeie a cadeia: CLP | Registrar falhas em uma planilha de controle
• Salvar a corrente

Etapa 2: adicionar ramificação de falha para o processo de upload de dados

Agora, adicionaremos os comandos que serão usados para gerar e preencher os valores que serão retornados à planilha de controle para indicar que o processo de upload de dados falhou. A primeira etapa para fazer isso é criar o arquivo com o status e a hora.

• Adicione um comando Create File do conector de utilitários de arquivo à tela Cadeia
• Conecte a cadeia Run Chain - Upload Data Chain Event ao comando Create File
• Clique duas vezes no link para editar as condições do link
  • Clique na opção de falha
    
    Depois que a opção de falha for selecionada, o link ficará vermelho, indicando que a cadeia continuará com essa ramificação somente se o evento da cadeia "Run Chain - Upload Data" falhar
    
• Clique duas vezes no comando Create File para configurá-lo
  • Nomeie o comando: Populate Data Upload Failure & Time Stamp (Preencher falha de upload de dados e carimbo de data/hora)
  • No campo Text, digite as informações a seguir: 

Falha no upload de dados,(*<System.DateTime>*)

• • • Substitua o espaço reservado (*System.DateTime*) pela variável de tempo de execução apropriada, isso extrairá programaticamente a data e a hora das cadeias
      • No painel Select a Variable à esquerda, expanda Runtime
      • Selecione o valor System.DateTime
• Salvar o comando

Etapa 3: Gravar falha no upload de dados de volta na planilha de controle

Agora usaremos o comando Write Sheet Data para gravar as informações preenchidas no comando anterior de volta na planilha de controle. Isso dará aos usuários finais a visibilidade das falhas de upload de dados e a data em que elas ocorreram.

• Adicione um comando Write Sheet Data do Workiva Connector à tela Chain 
• Vincule o comando Populate Data Upload Failure & Time Stamp ao comando Write Sheet Data
• Clique duas vezes no comando para configurá-lo
  • Dê um nome ao comando: Write Sheet Data - Data Upload Failure (Gravar dados da planilha - falha no upload de dados)
  • Clique no campo Spreadsheet ID (ID da planilha)
    • No painel Select a Variable (Selecionar uma variável), clique na seta para baixo para expandir Chain (Cadeia)
    • Selecione a variável cv-Control Spreadsheet ID Chain Variable 
  • Clique no campo Sheet ID/Name (ID/nome da planilha)
    • No painel Select a Variable (Selecionar uma variável), clique na seta para baixo para expandir Chain (Cadeia)
    • Selecione a variável de cadeia cv-Control Sheet Name  
  • Clique no campo Data File (Arquivo de dados)
    • No painel Select a Variable (Selecionar uma variável), clique na seta para baixo para expandir Populate Data Upload Failure & Time Stamp (Preencher falha de upload de dados e carimbo de data/hora)
    • Selecione a saída Created File
  • O campo Região será preenchido com uma combinação de Variáveis de Cadeia e saída JSON para informar à Cadeia a célula específica na planilha de controle na qual escrever para a iteração atual:
    • Clique no campo Region (Região) e preencha com o seguinte:
      
    • cv-Status Column Letter - variável encontrada no painel Variables (Variáveis) em Chain Variables (Variáveis em cadeia)
    • Iteração do arquivo JSON - estamos usando o número de linha da iteração mais um para especificar a região na qual gravar os dados. Adicionamos um para levar em conta a linha de cabeçalho.
      • No painel Select a Variable (Selecionar uma variável), clique na seta para baixo para expandir Group Iterator (Iterador de grupo) 
      • Selecione <> JSON File Iteration
      • Clique na pílula verde JSON File Iteration para transformar a variável
        • Clique em Select a Transformation (Selecionar uma transformação) e escolha Get Value from JSON (Obter valor de JSON)
        • Pressione o sinal verde +
        • No campo de valor, digite Row Number e pressione Enter
        • Selecione outra transformação e escolha Parse Number
        • Clique no sinal verde +
        • Selecione outra transformação e escolha Adicionar
        • Clique no sinal verde +
        • No campo de valor, digite 1
        • Clique em Aceitar
          .
    • Insira dois pontos após a primeira iteração do arquivo JSON:
    • cv-Time Stamp Column Letter - variável encontrada no painel Variables (Variáveis) em Chain Variables (Variáveis em cadeia)
    • Iteração do arquivo JSON - estamos usando o número da linha da iteração mais um para especificar a região na qual gravar os dados. Adicionamos um para levar em conta a linha do cabeçalho.
      
      • Siga as mesmas etapas acima para a segunda iteração do arquivo JSON

• Salvar o comando

Etapa 4: Adicionar ramificação de falha para o processo de atualização de conexões

Agora, adicionaremos os comandos que serão usados para gerar e preencher os valores que serão retornados à planilha de controle para indicar que o processo de atualização de conexões falhou. Desta vez, copiaremos os dois comandos que já criamos para simplificar o processo.

• Clique no comando Populate Data Upload Failure & Time Stamp e clique no botão Copy
  
• Conecte o evento em cadeia Run Chain - Refresh Connections Chain Event ao comando Populate Data Upload Failure & Time Stamp - Copy que acabou de ser copiado
• Clique duas vezes no link para editar as condições do link
  • Clique na opção de falha
    
• Clique duas vezes no comando Populate Data Upload Failure & Time Stamp - Copy para configurá-lo
  • Nomeie o comando: Populate Refresh Connection Failure & Time Stamp (Preencher atualização de falha de conexão e registro de data e hora)
  • No campo Text, atualize as informações a seguir:

    Refresh Connection Failed,(*<System.DateTime>*)

    • Você notará que a variável System Date and Time não precisa ser atualizada ou adicionada
• Salvar o comando

Etapa 5: gravar a atualização da falha de conexão de volta na planilha de controle

Agora usaremos o comando Write Sheet Data para gravar as informações preenchidas no comando anterior de volta na planilha de controle. Isso dará aos nossos usuários finais visibilidade das falhas de atualização da conexão e a data em que ela falhou. Mais uma vez, copiaremos um comando criado anteriormente para economizar tempo.

• Clique no comando Write Sheet Data - Data Upload Failure e clique no botão Copy
  
• Conecte o comando Populate Refresh Connection Failure & Time Stamp ao comando Write Sheet Data - Data Upload Failure - Copie o comando que acabou de ser copiado
• Clique duas vezes no link para editar as condições do link
  • Clique na opção de falha
    
• Clique duas vezes em Write Sheet Data - Data Upload Failure - Copie o comando para configurá-lo
  • Nomeie o comando: Write Sheet Data - Refresh Connection Falha
  • Clique no campo Data File (Arquivo de dados) e exclua a variável
    • No painel Select a Variable, clique na seta para baixo para expandir Populate Refresh Connection Failure & Time Stamp
    • Selecione a saída Created File
      • Você notará que os outros campos foram preenchidos com as mesmas informações preenchidas para o comando Write Sheet Data - Data Upload Failure Command (Gravar dados da planilha - Falha no upload de dados), todo o resto permanecerá igual
• Salvar o comando

Etapa 6: Teste o exercício

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

• Publicar a cadeia
• Para testar nossos novos comandos, forçaremos uma falha editando nossa planilha de controle
  • Navegue até a planilha CLP Control Sheet na plataforma Workiva
  • Excluir o valor TableID em uma das linhas
  • Excluir o valor SpreadsheetID em uma linha diferente
    
• Volte para a cadeia CLP | Logging Failures within a Control Sheet e clique em Execute. Selecione Run Chain (Cadeia de execução)
• Depois que a cadeia for concluída, verifique se o fluxo de trabalho foi concluído verificando o seguinte:

Falha na ramificação de falha seguida para Upload de dados Falha:

Ramo de falha seguido para a falha de atualização de conexões:

Resultados gravados na planilha de controle indicando falhas e sucessos:

Parabéns! Você terminou a série do Caminho de Aprendizagem Conectado à Centralização de Dados! Você pode se desafiar ainda mais com os Caminhos de Aprendizagem Conectados à Transformação .