Runbook de exemplo: monitorar uma pasta com um runbookExample Runbook: Monitor a folder with a runbook

Importante

Esta versão do Orchestrator atingiu o fim do suporte, recomendamos que você atualize para o orchestrator 2019.This version of Orchestrator has reached the end of support, we recommend you to upgrade to Orchestrator 2019.

Este exemplo mostra como criar um runbook simples que monitora uma pasta em busca de novos arquivos de texto.This sample shows you how to create a simple runbook that monitors a folder for new text files. Quando um arquivo é detectado, o runbook envia uma mensagem de log de evento e inicia outro runbook.When a file is detected, the runbook sends an event log message, and then starts another runbook.

Monitorar Pasta

Criar e testar um runbook de monitoramentoCreate and test a monitor runbook

Os procedimentos para criar, configurar e testar um runbook de exemplo que monitora uma pasta são descritos abaixo.The procedures to create, configure, and test a sample runbook that monitors a folder are described below.

Para criar o fluxo de trabalhoTo create the workflow

  1. No painel Conexões do Runbook Designer, clique com o botão direito na pasta Runbooks para selecionar Novoe clique em Runbook.In the Runbook Designer Connections pane, right-click the Runbooks folder to select New, and then click Runbook.

  2. Clique com o botão direito na guia Novo Runbook para selecionar Renomear.Right-click the New Runbook tab to select Rename.

  3. Na caixa de diálogo Confirmar Check-out , clique em Sim.In the Confirm Check out dialog box, click Yes.

  4. Digite um nome para o runbook, como Runbook de Monitoramento, e pressione Enter.Type a name for the runbook, such as Monitor Runbook, and then press Enter.

  5. No painel Atividades, clique em Gerenciamento de Arquivo para expandir a categoria e arraste a atividade Monitorar Pasta para o workspace de design do Runbook Designer.In the Activities pane, click File Management to expand the category, and then drag the Monitor Folder activity into the Runbook Designer Design workspace.

  6. No painel Atividades, clique em Notificações para expandir a categoria e arraste a atividade Enviar Mensagem de Log de Evento para o workspace de design do Runbook Designer, à direita da atividade Monitorar Pasta.In the Activities pane, click Notification to expand the category, and then drag the Send Event Log Message activity into the Runbook Designer Design workspace, to the right of the Monitor Folder activity.

  7. No workspace de design do Runbook Designer, passe seu cursor sobre o lado direito da atividade Monitorar Pasta para exibir a seta de smart link.In the Runbook Designer Design workspace, move your pointer over the right side of the Monitor Folder activity to display the smart link arrow.

  8. Clique na seta do smart link e arraste-a para a atividade Enviar Mensagem de Log de Evento .Click the smart link arrow, and then drag it to the Send Event Log Message activity.

  9. No painel Atividades, clique em Controle de Runbook para expandir a categoria e arraste a atividade Invocar Runbook para o workspace de design do Runbook Designer, à direita da atividade Enviar Mensagem de Log de Evento.In the Activities pane, click Runbook Control to expand the category, and then drag the Invoke Runbook activity into the Runbook Designer Design workspace, to the right of the Send Event Log Message activity.

  10. No workspace de design do Runbook Designer, passe seu cursor sobre o lado direito da atividade Enviar Mensagem de Log de Evento para exibir a seta de smart link.In the Runbook Designer Design workspace, move your pointer over the right side of the Send Event Log Message activity to display the smart link arrow.

  11. Clique na seta do smart link e arraste-a para a atividade Invocar Runbook .Click the smart link arrow, and then drag it to the Invoke Runbook activity.

Para configurar o fluxo de trabalhoTo configure the workflow

  1. No espaço de trabalho runbook designer design, - clique duas vezes na atividade monitorar pasta .In the Runbook Designer Design workspace, double-click the Monitor Folder activity.

  2. Na caixa de diálogo Monitorar Propriedades da Pasta , clique na guia Geral .In the Monitor Folder Properties dialog box, click the General tab.

  3. Na caixa nome , altere o nome da atividade para algo informativo, por exemplo, Monitor C: \ monitorar pasta.In the Name box, change the name of the activity to something informative, for example Monitor C:\Monitor Folder.

  4. Clique na aba Detalhes.Click the Details tab.

  5. Na guia detalhes , na caixa caminho , digite o caminho da pasta que você deseja monitorar, por exemplo C: \ Monitor.On the Details tab, in the Path box, type the path of the folder you want to monitor, for example C:\Monitor.

  6. Abaixo da seção Filtros de Arquivo , clique em Adicionar.Below the File Filters list, click Add.

  7. Na caixa de diálogo Configurações de Filtro , defina o seguinte:In the Filter Settings dialog box, set the following:

    1. Na caixa da lista Nome , selecione Nome do Arquivo.In the Name list box, select File Name.

    2. Na caixa da lista Relação , selecione Corresponde ao Padrão.In the Relation list box, select Matches pattern.

    3. Na caixa valor , digite ** * . txt**.In the Value box, type *.txt.

      Essa configuração orienta o monitor para que procure por arquivos com a extensão txt .This setting directs the monitor to look for files with the txt extension. Esse campo aceita a sintaxe de expressão regular.This field accepts regular expression syntax.

  8. Clique em OK.Click OK.

  9. Selecione a guia Gatilhos.Select the Triggers tab.

  10. Selecione a opção O número de arquivos é , defina o valor na lista para maior quee digite 0 na caixa de edição.Select the Number of files is option, set the value in the list to greater than, and then type 0 in the edit box.

  11. Clique em Concluir.Click Finish.

  12. No espaço de trabalho runbook designer design, - clique duas vezes na mensagem enviar log de eventos.In the Runbook Designer Design workspace, double-click the Send Event Log Message.

  13. Na caixa de diálogo Propriedades de Enviar Mensagem de Log de Evento , na guia Detalhes , na seção Propriedades , defina o seguinte:In the Send Event Log Message Properties dialog box, on the Details tab, in the Properties section, set the following:

    1. Na caixa Computador , digite o nome do computador que receberá a mensagem de Evento.In the Computer box, type the name of the computer to receive the Event message.

      Geralmente, esse é o computador em que você está executando o Runbook Designer.This is typically the computer where you are running Runbook Designer.

    2. Na caixa Mensagem , digite a mensagem a ser exibida no log de eventos, como por exemplo Arquivo Detectado.In the Message box, type the message to display in the Event log, for example, File Detected.

    3. Deixe o nível de Severidade como Informações.Leave the Severity level at Information.

  14. Clique em Concluir.Click Finish.

    Observação

    Neste exemplo, a atividade Invocar Runbook não é configurada.In this sample, the Invoke Runbook activity is not configured.

Para modificar as configurações de runbookTo modify runbook settings

  1. Acima d workspace de design do Runbook Designer, clique com o botão direito na guia Monitorar Runbook para selecionar Propriedades.Above the Runbook Designer Design workspace, right-click the Monitor Runbook tab to select Properties.

  2. Na caixa de diálogo monitorar Propriedades do runbook , clique na guia log e selecione os ** - dados retornados específicos da atividade de armazenamento** e armazene os dados retornados comuns.In the Monitor Runbook Properties dialog, click the Logging tab, and then select both Store Activity-specific Returned Data and Store Common Returned Data.

  3. Clique em Concluir.Click Finish.

  4. Clique com o botão direito na guia Monitorar Runbook para selecionar Check-in.Right-click the Monitor Runbook tab to select Check In.

Testar o runbookTest the runbook

No Runbook Tester, você pode testar runbooks em um ambiente de depuração e runtime simulado.In the Runbook Tester, you can test runbooks in a simulated runtime and debugging environment. Você pode executar um runbook inteiro, passar por uma atividade de cada vez ou adicionar pontos de interrupção para parar a simulação em qualquer atividade que selecionar.You can run an entire runbook, step through it one activity at a time, or add breakpoints to stop the simulation at any activity that you select.

Use as etapas a seguir para testar seu runbook no Runbook Tester.Use the following steps to test your runbook in the Runbook Tester.

Para preparar seu computadorTo prepare your computer

  1. Clique com o botão direito em Iniciar para selecionar Abrir o Windows Explorer.Right-click Start to select Open Windows Explorer.

  2. Crie uma pasta C: \ Monitor no seu computador.Create a C:\Monitor folder on your computer.

  3. Crie uma pasta C: \ Source no seu computador.Create a C:\Source folder on your computer.

  4. Na pasta C: \ Source , crie um arquivo com uma extensão txt , por exemplo text.txt.In the C:\Source folder, create a file with a txt extension, for example text.txt.

Para testar o runbookTo test the runbook

  1. No workspace de design do Runbook Designer, selecione a guia Monitorar Runbook.In the Runbook Designer Design workspace, select the Monitor Runbook tab.

  2. Na barra de ferramentas acima do workspace de design do Runbook Designer, clique em Runbook Tester.On the toolbar above the Runbook Designer Design workspace, click Runbook Tester.

  3. Na caixa de diálogo Confirmar Check-out , clique em Sim.In the Confirm Check out dialog box, click Yes.

  4. No Runbook Tester, na barra de ferramentas, clique em Por Etapas para iniciar o runbook passo a passo.In Runbook Tester, on the toolbar, click Step Over to start stepping through the runbook.

    Dica

    Para aumentar o tamanho do painel Log , remova o painel Navegador de Recursos selecionando Exibição no menu e desmarcando a opção Navegador de Recursos .To increase the size of the Log pane, remove the Resource Browser pane by selecting View on the menu, and then clearing the Resource Browser option.

  5. No Windows Explorer, navegue até a pasta C: \ Source .In Windows Explorer, browse to the C:\Source folder.

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

  7. Feche o Windows Explorer.Close Windows Explorer.

  8. Na barra de ferramentas do Runbook Tester, clique em Avançar.On the Runbook Tester toolbar, click Next.

    Após alguns momentos, note que a entrada do painel Log é atualizada e mostra um evento para a atividade Monitorar Pasta .After a few moments, note that the Log pane entry updates and shows an event for the Monitor Folder activity.

  9. No painel Log , clique no link Mostrar Detalhes para ver o conteúdo do barramento de dados daquele runbook.On the Log pane Click the Show Details link to see the contents of the data bus for that runbook.

  10. Role a lista de propriedades para baixo.Scroll down the list of properties. Note que o estado da atividade é success , indicando que a atividade Monitorar Pasta detectou a alteração na pasta.Note that the activity status is success indicating that the Monitor Folder activity detected the change in the folder.

  11. Na barra de ferramentas do Runbook Tester, clique em Avançar.On the Runbook Tester toolbar, click Next.

    Observe que o painel Log muda e mostra um evento para a atividade Enviar Mensagem de Log de Evento .Notice that the Log pane changes and shows an event for the Send Event Log Message activity.

  12. Clique no link Mostrar Detalhes e note que o status da atividade é success , indicando que a atividade Enviar Mensagem de Log de Evento detectou a mudança na pasta.Click the Show Details link and note that the activity status is success indicating that the Send Event Log Message activity detected the change in the folder.

  13. Feche o Runbook Tester.Close Runbook Tester.

  14. Na barra de ferramentas do Runbook Designer , clique em Check-in.On the Runbook Designer toolbar, click Check In.

Próximas etapasNext steps

Leia design e crie runbooks para saber mais sobre a criação de runbooks e obtenha orientações de práticas recomendadas para a criação de runbooks.Read Design and build runbooks to learn more about building runbooks and get best practice guidance for designing runbooks. Leia controlar atividades de runbook para saber mais sobre as opções para controlar a execução de runbook.Read Control runbook activities to learn more about the options for controlling runbook execution.