Centro de suporte da Workiva

Depois de publicar uma cadeia, você pode executá-la para realizar seus comandos:

• Para executar uma cadeia sem uma programação definida, execute-a manualmente.
• Para que uma cadeia seja executada automaticamente, defina sua programação.
• Para executar automaticamente uma cadeia com base em um evento em uma solução conectada, use um evento de acionamento.
• Para iniciar uma cadeia após a conclusão de outra cadeia, use o evento Executar cadeia para encadeá-las.

Treinamento adicional disponível

Libere o poder das cadeias com nosso curso individualizado no Centro de Aprendizagem Workiva! Este curso abrangente o orienta no processo de criação de uma cadeia do início ao fim, proporcionando experiência prática e um profundo conhecimento da plataforma Construtor de Cadeia.

Visite o centro de aprendizagem da Workiva

Executar manualmente uma corrente

Para executar manualmente uma cadeia, selecione-a em seu espaço de trabalho e clique em Executar flight_takeoff e Executar cadeia.

Observação: Para interromper a execução de uma cadeia, clique em Parar. Quando você interrompe uma cadeia que inclui eventos Executar cadeia, você também interrompe as execuções de qualquer cadeia iniciadas por esses eventos.

Programar quando executar automaticamente uma cadeia

As programações de cadeias permitem que você execute automaticamente uma cadeia em uma base rotineira, em um horário específico ou durante um intervalo de datas específico. Todas as suas cadeias programadas podem ser visualizadas por ambiente na guia Programações no Construtor de Cadeia.

Para agendar uma cadeia:

1. Abra a cadeia e clique em Configurações.
   
    
2. Em Schedules alarm, clique em Add. 
   

3. Em Frequência, selecione a frequência de execução da corrente, como, por exemplo, a cada poucas horas ou uma vez por mês.

   Nota: As opções de agendamento subsequentes variam de acordo com a frequência escolhida. A seleção de uma programação semanal, por exemplo, lhe dará a opção de especificar um dia da semana para a execução da corrente.

4. Em Duração, escolha o horário específico em que sua corrente funcionará. 

   Observação: Dependendo da frequência escolhida, você poderá ser solicitado a escolher um dia ou período específico para a execução da corrente.

5. Em Duration, escolha o tempo de duração dessa programação.
   

   Nota: As programações da cadeia devem ser inseridas em números inteiros. Por exemplo, você não pode programar uma cadeia para ser executada a cada 1,5 dia.

6. Clique em Salvar para criar sua programação.
7. Salve e Publique sua cadeia para que a programação entre em vigor.

Uma vez programada, uma cadeia continuará a ser executada até que a programação seja editada ou removida. Elas não são desativadas automaticamente quando o usuário de agendamento é removido da Workiva.

Você pode exibir todas as cadeias agendadas na tela Schedules.

Editar e remover cadeias programadas

Depois de adicionar uma agenda, você pode personalizar ainda mais suas configurações:

• Selecione Cor para escolher como a programação será exibida na guia "Programações" (Programações).
• Para impedir temporariamente que uma cadeia comece em seu tempo definido, clique em Disable Schedule visibility para a agenda.
• Para atualizar uma frequência definida, clique em Editar criar para a agenda.
• Para remover uma programação, clique em Excluir excluir.
  

Coisas para saber

• Você está limitado a um máximo de 80 programações por cadeia.
• Na exibição de programação, você pode mostrar no máximo 100 iterações de programação para qualquer programação. 
  Portanto, no exemplo mostrado em seguida, a exibição da programação de testes A (em bege) está programada para ser executada a cada 15 minutos durante toda a semana após 6 de março, mas o gráfico mostra apenas as primeiras 100 execuções, ou 25 horas nesse caso (4 execuções por hora x 25 horas = 100 iterações). 
  

Iniciar uma cadeia com base em um evento de acionamento

Para executar automaticamente uma cadeia com base em um evento em uma solução de conexão, inicie-a com um evento de acionamento:

• Para iniciar uma cadeia com base em um evento do BlackLine® Journal Service, como um novo lançamento de diário certificado, use o evento de acionamento BlackLine Journal Service.
• Para iniciar uma cadeia quando um conector do Arquivo Utils detectar um evento - como Criar, Modificar ou Excluir - em um diretório de arquivos, use o evento de acionamento Eventos de arquivo.
• Para iniciar uma cadeia quando um conector de solicitação HTTP detectar um evento POST com uma carga útil JSON, use o evento de acionamento HTTP Webhooks.

Ao usar eventos de acionamento, tenha em mente o seguinte:

• As cadeias não podem ser programadas quando um evento de acionamento é usado.
• Somente um evento de acionamento pode ser usado por cadeia.

Visualizar o histórico de uma cadeia

Para visualizar versões publicadas anteriormente de uma cadeia no Construtor de Cadeia, acesse a guia Cadeias device_hub e selecione Versões no menu da cadeia individual. Para cada versão anterior, você pode ver quando ela foi criada e por quem.

Para visualizar o histórico de execução de uma cadeia, por exemplo, para solucionar um erro:

1. Em Construtor de Cadeia, clique em Monitorar flight_takeoff.
2. Pesquise uma cadeia por nome ou use os filtros na parte superior da tela para restringir seus resultados:
   
   • Status
   • Tempo
   • Data
   • Espaço/ambiente de trabalho
   • Conexões
   • Etiquetas
3. Para cada execução, você pode visualizar os detalhes das cadeias, incluindo o status, quem a executou e os horários de início e término.
4. Para obter mais detalhes sobre a execução, clique em sua linha e inspecione cada comando durante a execução. Para cada comando, é possível visualizar suas saídas, entradas e registro de erros durante a execução.
5. Para visualizar todas as execuções da cadeia, clique em Executar Histórico.

Visualizar uma cadeia executada em outra cadeia

Quando um evento de cadeia de execução está incluído em uma cadeia principal, você pode acessar rapidamente a subcadeia por meio da tela Monitor.

Veja como.

1. Em Construtor de Cadeia, clique em Monitorar flight_takeoff.
2. Selecione a execução da cadeia que você deseja visualizar.
   
3. Clique no nó Run Chain em seu gráfico de cadeia. A cadeia executada por esse nó aparecerá no painel de resultados do lado direito.
   
4. No painel de resultados à direita, use o teclado e o mouse para ajustar a visualização da subcadeia:
   • Arraste a tela: Clique e mantenha o mouse pressionado em qualquer espaço em branco para arrastar a tela.
   • Aumentar e diminuir o zoom: Mantenha pressionada a tecla CTRL e role com a roda do mouse para aumentar e diminuir o zoom.
     
5. Clique duas vezes em qualquer nó da subcadeia para abri-lo em uma nova guia do navegador. Você pode então editar, executar e visualizar a cadeia secundária separadamente da cadeia de origem.
   

Analisar o uso da cadeia

Para rastrear e analisar o uso e o sucesso de suas cadeias em Construtor de Cadeia, de Página inicial home, selecione o período de tempo a ser analisado.

Observação: Para se concentrar em cadeias dentro de ambientes específicos em seu espaço de trabalho, clique em Filtrar e selecione os ambientes a serem analisados.

Em Página inicial, você pode monitorar:

• Resultados da cadeia, para saber quantas cadeias foram bem-sucedidas, falharam ou resultaram em um aviso durante o período de tempo definido.
• Feed de atividades, para um registro de auditoria das atualizações das cadeias durante o período de tempo definido, incluindo quem fez a alteração e quando.
• Estatísticas de comando, para rastrear quantos comandos foram executados durante o período de tempo definido.

Para atualizar uma métrica com a atividade mais recente, clique em Atualizar atualizar.