Runbook de ejemplo: Supervisión de una carpeta a un runbookExample Runbook: Monitor a folder with a runbook

Se aplica a: System Center 2016 - OrchestratorApplies To: System Center 2016 - Orchestrator

En este ejemplo se muestra cómo crear un runbook simple que supervisa una carpeta para los nuevos archivos de texto.This sample shows you how to create a simple runbook that monitors a folder for new text files. Cuando se detecta un archivo, el Runbook envía un mensaje de registro de eventos y, a continuación, inicia otro Runbook.When a file is detected, the runbook sends an event log message, and then starts another runbook.

Supervisar carpeta

Crear y probar un Runbook de supervisiónCreate and test a monitor runbook

A continuación se describen los procedimientos que deben realizarse para crear, configurar y probar un Runbook de ejemplo de supervisión de carpetas.The procedures to create, configure, and test a sample runbook that monitors a folder are described below.

Para crear el flujo de trabajoTo create the workflow

  1. En el panel Conexiones de Runbook Designer, haga clic con el botón secundario en Runbooks para seleccionar Nuevoy, a continuación, haga clic en Runbook.In the Runbook Designer Connections pane, right-click the Runbooks folder to select New, and then click Runbook.

  2. Haga clic con el botón secundario en la pestaña Nuevo Runbook para seleccionar Cambiar nombre.Right-click the New Runbook tab to select Rename.

  3. En el cuadro de diálogo Confirmar modificación , haga clic en .In the Confirm Check out dialog box, click Yes.

  4. Escriba un nombre para el Runbook, como, por ejemplo, Runbook de supervisióny, a continuación, presione Entrar.Type a name for the runbook, such as Monitor Runbook, and then press Enter.

  5. En el panel Actividades , haga clic en Administración de archivos para expandir la categoría y, a continuación, arrastre la actividad Supervisar carpeta al área de trabajo de diseño de 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. En el panel Actividades , haga clic en Notificación para expandir la categoría y, a continuación, arrastre la actividad Enviar mensaje de registro de eventos al área de trabajo de diseño de Runbook Designer situada a la derecha de la actividad Supervisar carpeta .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. En el área de trabajo de diseño de Runbook Designer , coloque el puntero sobre la parte derecha de la actividad Supervisar carpeta para mostrar la flecha de conexión inteligente.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. Haga clic en la flecha de conexión inteligente y, a continuación, arrástrela a la actividad Enviar mensaje de registro de eventos .Click the smart link arrow, and then drag it to the Send Event Log Message activity.

  9. En el panel Actividades , haga clic en Control de Runbook para expandir la categoría y, a continuación, arrastre la actividad Invocar Runbook al área de trabajo de diseño de Runbook Designer situada a la derecha de la actividad Enviar mensaje de registro de eventos .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. En el área de trabajo de diseño de Runbook Designer , coloque el puntero sobre la parte derecha de la actividad Enviar mensaje de registro de eventos para mostrar la flecha de conexión inteligente.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. Haga clic en la flecha de conexión inteligente y, a continuación, arrástrela a la Invocar Runbook .Click the smart link arrow, and then drag it to the Invoke Runbook activity.

Para configurar el flujo de trabajoTo configure the workflow

  1. En el Runbook Designer de trabajo de diseño, doble-haga clic en el supervisar carpeta actividad.In the Runbook Designer Design workspace, double-click the Monitor Folder activity.

  2. En el cuadro de diálogo Supervisar propiedades de carpeta , haga clic en la pestaña General .In the Monitor Folder Properties dialog box, click the General tab.

  3. En el nombre cuadro, cambie el nombre de la actividad, por ejemplo Monitor C:\supervisar carpeta.In the Name box, change the name of the activity to something informative, for example Monitor C:\Monitor Folder.

  4. Haga clic en la ficha Detalles .Click the Details tab.

  5. En el detalles ficha la ruta de acceso , escriba la ruta de acceso de la carpeta que desea supervisar como, por ejemplo 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. Debajo de la lista Filtros de archivos , haga clic en Agregar.Below the File Filters list, click Add.

  7. En el cuadro de diálogo Configuración de filtro , configure lo siguiente:In the Filter Settings dialog box, set the following:

    1. En el cuadro de lista Nombre , seleccione Nombre de archivo.In the Name list box, select File Name.

    2. En el cuadro de lista Relación , seleccione Coincide con el patrón.In the Relation list box, select Matches pattern.

    3. En el valor , escriba *.txt.In the Value box, type *.txt.

      Esta opción indica al monitor que debe buscar archivos con la extensión txt .This setting directs the monitor to look for files with the txt extension. Este campo acepta la sintaxis de las expresiones regulares.This field accepts regular expression syntax.

  8. Haga clic en Aceptar.Click OK.

  9. Seleccione la pestaña Desencadenadores .Select the Triggers tab.

  10. Seleccione la opción El número de archivos es , establezca el valor de la lista a Mayor quey, a continuación, escriba 0 en el cuadro de edición.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. Haga clic en Finalizar.Click Finish.

  12. En el Runbook Designer de trabajo de diseño, doble-haga clic en el enviar mensaje de registro de eventos.In the Runbook Designer Design workspace, double-click the Send Event Log Message.

  13. En el cuadro de diálogo Enviar propiedades del mensaje de registro de eventos , en la pestaña detalles de la sección Propiedades , configure lo siguiente:In the Send Event Log Message Properties dialog box, on the Details tab, in the Properties section, set the following:

    1. En el cuadro Equipo , escriba el nombre del equipo que recibirá el mensaje del evento.In the Computer box, type the name of the computer to receive the Event message.

      Por lo general, este suele ser el equipo en el que se ejecuta Runbook Designer.This is typically the computer where you are running Runbook Designer.

    2. En el cuadro Mensaje , escriba el mensaje que desea que se muestre en el Registro de eventos como, por ejemplo, Archivo detectado.In the Message box, type the message to display in the Event log, for example, File Detected.

    3. Deje el nivel Gravedad configurado como Information.Leave the Severity level at Information.

  14. Haga clic en Finalizar.Click Finish.

    Nota

    En este ejemplo, la actividad Invocar Runbook no se ha configurado.In this sample, the Invoke Runbook activity is not configured.

Para modificar la configuración del RunbookTo modify runbook settings

  1. Sobre el área de trabajo de diseño de Runbook Designer , haga clic con el botón secundario en la pestaña Supervisar Runbook para seleccionar Propiedades.Above the Runbook Designer Design workspace, right-click the Monitor Runbook tab to select Properties.

  2. En el supervisar propiedades del Runbook cuadro de diálogo, haga clic en el registro ficha y, a continuación, seleccione actividad del almacén de-datos específicos devueltos y almacenar datos devueltos comunes.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. Haga clic en Finalizar.Click Finish.

  4. Haga clic con el botón secundario en la pestaña Supervisar Runbook para seleccionar Registrar.Right-click the Monitor Runbook tab to select Check In.

Probar el RunbookTest the runbook

En Runbook Tester puede probar Runbooks en entornos de tiempo de ejecución simulado y de depuración.In the Runbook Tester, you can test runbooks in a simulated runtime and debugging environment. Puede ejecutar un Runbook completo, ejecutar las actividades de una en una o agregar puntos de interrupción para detener la simulación en cualquier actividad que seleccione.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.

Siga los pasos siguientes para probar su Runbook en Runbook Tester.Use the following steps to test your runbook in the Runbook Tester.

Para preparar el equipoTo prepare your computer

  1. Haga clic con el botón secundario en Inicio para seleccionar Abrir el Explorador de Windows.Right-click Start to select Open Windows Explorer.

  2. Crear un C:\Monitor carpeta en el equipo.Create a C:\Monitor folder on your computer.

  3. Crear un C:\origen carpeta en el equipo.Create a C:\Source folder on your computer.

  4. En el C:\origen carpeta, cree un archivo con un txt extensión, por ejemplo text.txt.In the C:\Source folder, create a file with a txt extension, for example text.txt.

Para probar el RunbookTo test the runbook

  1. En el área de trabajo de diseño Runbook Designer , seleccione la pestaña Supervisar Runbook .In the Runbook Designer Design workspace, select the Monitor Runbook tab.

  2. En la barra de herramientas que se encuentra sobre el área de trabajo de diseño de Runbook Designer , haga clic en Runbook Tester.On the toolbar above the Runbook Designer Design workspace, click Runbook Tester.

  3. En el cuadro de diálogo Confirmar modificación , haga clic en .In the Confirm Check out dialog box, click Yes.

  4. En Runbook Tester, en la barra de herramientas, haga clic en Siguiente paso para iniciar la ejecución del Runbook paso a paso.In Runbook Tester, on the toolbar, click Step Over to start stepping through the runbook.

    Sugerencia

    Para aumentar el tamaño del panel Registro , quite el panel Explorador de recursos . Para ello, seleccione la opción Ver en el menú y, a continuación, desactive la opción Explorador 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. En el Explorador de Windows, vaya a la C:\origen carpeta.In Windows Explorer, browse to the C:\Source folder.

  6. Copia test.txt a C:\Monitor.Copy test.txt to C:\Monitor.

  7. Cierre el Explorador de Windows.Close Windows Explorer.

  8. En la barra de herramientas de Runbook Tester, haga clic en Siguiente.On the Runbook Tester toolbar, click Next.

    Transcurridos unos instantes, la entrada del panel Registro se actualizará y mostrará un evento para la actividad Supervisar carpeta .After a few moments, note that the Log pane entry updates and shows an event for the Monitor Folder activity.

  9. En el panel Registro , haga clic en el vínculo Mostrar detalles para ver los contenidos del bus de datos de dicho Runbook.On the Log pane Click the Show Details link to see the contents of the data bus for that runbook.

  10. Desplácese hacia abajo en la lista de propiedades.Scroll down the list of properties. Tenga en cuenta que el estado de la actividad es success , lo que indica que la actividad Supervisar carpeta ha detectado el cambio en la carpeta.Note that the activity status is success indicating that the Monitor Folder activity detected the change in the folder.

  11. En la barra de herramientas de Runbook Tester, haga clic en Siguiente.On the Runbook Tester toolbar, click Next.

    Tenga en cuenta que el panel Registro ha cambiado y muestra un evento para la actividad Enviar mensaje de registro de eventos .Notice that the Log pane changes and shows an event for the Send Event Log Message activity.

  12. Haga clic en el vínculo Mostrar detalles . Se mostrará el estado de la actividad success , lo que indica que la actividad Enviar mensaje de registro de eventos ha detectado un cambio en la carpeta.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. Cierre Runbook Tester.Close Runbook Tester.

  14. En la barra de herramientas de Runbook Designer , haga clic en Registrar.On the Runbook Designer toolbar, click Check In.

Pasos siguientesNext steps

Lectura runbooks diseñan y crean para obtener más información sobre la creación de runbooks y obtener una guía de prácticas recomendadas para diseñar runbooks.Read Design and build runbooks to learn more about building runbooks and get best practice guidance for designing runbooks. Lectura controlan las actividades de runbook para obtener más información sobre las opciones para controlar la ejecución de runbook.Read Control runbook activities to learn more about the options for controlling runbook execution.