Runbook de Exemplo: Monitorizar uma pasta com um runbook

Importante

Esta versão do Orchestrator chegou ao fim do suporte. Recomendamos que atualize para o Orchestrator 2022.

Este artigo mostra-lhe como criar um runbook simples que monitoriza uma pasta para novos ficheiros de texto. Quando um ficheiro é detetado, o runbook envia uma mensagem de registo de eventos e, em seguida, inicia outro runbook.

Criar e testar um runbook de monitorização

Os procedimentos para criar, configurar e testar um runbook simples que monitoriza uma pasta são descritos abaixo.

Criar o fluxo de trabalho

Siga estes passos para criar um fluxo de trabalho:

1. No painel runbook Designer Connections, clique com o botão direito do rato na pasta Runbooks para selecionar Novo e, em seguida, selecione Runbook.

2. Clique com o botão direito do rato no separador Novo Runbook para selecionar Mudar o Nome.

3. Na caixa de diálogo Confirmar Saída , selecione Sim.

4. Introduza um nome para o runbook, como Monitor Runbook e, em seguida, prima Enter.

5. No painel Atividades, selecione Gestão de Ficheiros para expandir a categoria e, em seguida, arraste a atividade Pasta do Monitor para a área de trabalho Estrutura do Runbook Designer.

6. No painel Atividades, selecione Notificação para expandir a categoria e, em seguida, arraste a atividade Enviar Mensagem de Registo de Eventos para a área de trabalho Estrutura do Runbook Designer, à direita da atividade Monitorizar Pasta.

7. Na área de trabalho Estrutura do Runbook Designer, mova o ponteiro sobre o lado direito da atividade Monitorizar Pasta para apresentar a seta de ligação inteligente.

8. Selecione a seta de ligação inteligente e, em seguida, arraste-a para a atividade Enviar Mensagem de Registo de Eventos .

9. No painel Atividades, selecione Controlo de Runbook para expandir a categoria e, em seguida, arraste a atividade Invocar Runbook para a área de trabalho Estrutura do Runbook Designer, à direita da atividade Enviar Mensagem de Registo de Eventos.

10. Na área de trabalho Estrutura Designer Runbook, mova o ponteiro sobre o lado direito da atividade Enviar Mensagem de Registo de Eventos para apresentar a seta de ligação inteligente.

11. Selecione a seta de ligação inteligente e, em seguida, arraste-a para a atividade Invocar Runbook .

Para configurar o fluxo de trabalho

Siga estes passos para configurar o fluxo de trabalho:

1. Na área de trabalho Estrutura do Runbook Designer, faça duplo clique na atividade Monitorizar Pasta.

2. Na caixa de diálogo Propriedades da Pasta do Monitor , selecione o separador Geral .

3. Na caixa Nome , altere o nome da atividade para algo informativo. Por exemplo, Monitorizar Pasta C:\Monitor.

4. Selecione o separador Detalhes.

5. No separador Detalhes , na caixa Caminho , introduza o caminho da pasta que pretende monitorizar. Por exemplo, C:\Monitor.

6. Abaixo da lista Filtros de Ficheiros , selecione Adicionar.

7. Na caixa de diálogo Definições de Filtro , defina o seguinte:

   1. Na caixa de lista Nome , selecione Nome do Ficheiro.

   2. Na caixa de lista Relação , selecione Padrão correspondências.

   3. Na caixa Valor , introduza *.txt.

      Esta definição direciona o monitor para procurar ficheiros com a extensão txt . Este campo aceita sintaxe de expressão regular.

8. Selecione OK.

9. Selecione o separador Acionadores .

10. Selecione a opção Número de ficheiros, defina o valor na lista como maior do que e, em seguida, introduza 0 na caixa de edição.

11. Selecione Concluir.

12. Na área de trabalho Estrutura do Runbook Designer, faça duplo clique na mensagem Enviar Registo de Eventos.

13. Na caixa de diálogo Enviar Propriedades da Mensagem de Registo de Eventos , no separador Detalhes , na secção Propriedades , defina o seguinte:

    1. Na caixa Computador , introduza o nome do computador para receber a mensagem Evento.

       Normalmente, este é o computador onde está a executar o Runbook Designer.

    2. Na caixa Mensagem , introduza a mensagem a apresentar no Registo de eventos. Por exemplo, Ficheiro Detetado.

    3. Deixe o nível de Gravidade em Informações.

14. Selecione Concluir.

    Nota

    Neste exemplo, a atividade Invocar Runbook não está configurada.

Modificar as definições do runbook

Siga estes passos para modificar as definições do runbook:

1. Acima da área de trabalho Estrutura do Runbook Designer, clique com o botão direito do rato no separador Monitorizar Runbook para selecionar Propriedades.

2. Na caixa de diálogo Monitorizar Propriedades do Runbook , selecione o separador Registo e, em seguida, selecione Armazenar Dados Devolvidos específicos da atividade e Armazenar Dados Devolvidos Comuns.

3. Selecione Concluir.

4. Clique com o botão direito do rato no separador Monitorizar Runbook para selecionar Check In.

Testar o runbook

No Runbook Tester, pode testar runbooks num ambiente simulado de tempo de execução e de depuração. Pode executar um runbook completo, percorrê-lo uma atividade de cada vez ou adicionar pontos de interrupção para parar a simulação em qualquer atividade que selecionar.

Utilize os seguintes passos para testar o runbook no Runbook Tester.

Preparar o computador

Siga estes passos para preparar o computador:

1. Clique com o botão direito do rato em Iniciar para selecionar Abrir o Explorador do Windows.

2. Crie uma pasta C:\Monitor no seu computador.

3. Crie uma pasta C:\Source no seu computador.

4. Na pasta C:\Source , crie um ficheiro com uma extensão txt . Por exemplo, text.txt.

Testar o runbook

Siga estes passos para testar o runbook:

1. Na área de trabalho Estrutura Designer Runbook, selecione o separador Monitorizar Runbook.

2. Na barra de ferramentas acima da área de trabalho Estrutura do Runbook Designer, selecione Runbook Tester.

3. Na caixa de diálogo Confirmar Saída , selecione Sim.

4. No Runbook Tester, na barra de ferramentas, selecione Passo a Passo para começar a percorrer o runbook.

   Dica

   Para aumentar o tamanho do painel Registo , remova o painel Browser de Recursos ao selecionar Ver no menu e, em seguida, desmarcar a opção Browser de Recursos .

5. No Explorador do Windows, navegue para a pasta C:\Source .

6. Copie test.txt para C:\Monitor.

7. Feche o Explorador do Windows.

8. Na barra de ferramentas Runbook Tester, selecione Seguinte.

   Após alguns momentos, a entrada do painel Registo é atualizada e mostra um evento para a atividade Monitorizar Pastas .

9. No painel Registo , selecione a ligação Mostrar Detalhes para ver o conteúdo do barramento de dados desse runbook.

10. Desloque a lista de propriedades. Se o estado da atividade for bem-sucedido, indica que a atividade Pasta do Monitor detetou a alteração na pasta.

11. Na barra de ferramentas Runbook Tester, selecione Seguinte.

    Repare que o painel Registo é alterado e mostra um evento para a atividade Enviar Mensagem de Registo de Eventos .

12. Selecione a ligação Mostrar Detalhes . Se o estado da atividade for bem-sucedido, indica que a atividade Enviar Mensagem de Registo de Eventos detetou a alteração na pasta.

13. Feche o Runbook Tester.

14. Na barra de ferramentas runbook Designer, selecione Check In.

Passos seguintes

• Leia Estruturar e criar runbooks para saber mais sobre a criação de runbooks e obter orientações de melhores práticas para conceber runbooks.
• Leia Controlar atividades do runbook para saber mais sobre as opções para controlar a execução do runbook.