Runbook de ejemplo: Supervisión de una carpeta con un runbook

Importante

Esta versión de Orchestrator ha llegado al final del soporte técnico. Se recomienda actualizar a Orchestrator 2022.

En este artículo se muestra cómo crear un runbook simple que supervisa una carpeta para los nuevos archivos de texto. Cuando se detecta un archivo, el Runbook envía un mensaje de registro de eventos y, a continuación, inicia otro Runbook.

Captura de pantalla de la carpeta Monitor.

Crear y probar un Runbook de supervisión

Los procedimientos para crear, configurar y probar un runbook simple que supervisa una carpeta se describen a continuación.

Crear el flujo de trabajo

Siga estos pasos para crear un flujo de trabajo:

  1. En el panel Runbook Designer Connections, haga clic con el botón derecho en la carpeta Runbooks para seleccionar Nuevo y, a continuación, seleccione Runbook.

  2. Haga clic con el botón secundario en la pestaña Nuevo Runbook para seleccionar Cambiar nombre.

  3. En el cuadro de diálogo Confirmar des check out , seleccione .

  4. Escriba un nombre para el runbook, como Monitor Runbook y presione Entrar.

  5. En el panel Actividades, seleccione Administración de archivos para expandir la categoría y, a continuación, arrastre la actividad Supervisar carpeta al área de trabajo Runbook Designer Diseño.

  6. En el panel Actividades, seleccione Notificación para expandir la categoría y, a continuación, arrastre la actividad Enviar mensaje de registro de eventos al área de trabajo Runbook Designer Diseño, a la derecha de la actividad Supervisar carpeta.

  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.

  8. Seleccione la flecha del vínculo inteligente y arrástrela a la actividad Enviar mensaje de registro de eventos .

  9. En el panel Actividades, seleccione Control de runbook para expandir la categoría y, a continuación, arrastre la actividad Invocar runbook al área de trabajo Runbook Designer Diseño, a la derecha de la actividad Enviar mensaje de registro de eventos.

  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.

  11. Seleccione la flecha del vínculo inteligente y arrástrela a la actividad Invocar runbook .

Para configurar el flujo de trabajo

Siga estos pasos para configurar el flujo de trabajo:

  1. En el área de trabajo de diseño de Runbook Designer , haga doble clic en la actividad Supervisar carpeta .

  2. En el cuadro de diálogo Supervisar propiedades de carpeta , seleccione la pestaña General .

  3. En el cuadro Nombre , cambie el nombre de la actividad por algo informativo. Por ejemplo, supervise la carpeta C:\Monitor.

  4. Seleccione la pestaña Details (Detalles).

  5. En la pestaña Detalles , en el cuadro Ruta de acceso, escriba la ruta de acceso de la carpeta que desea supervisar. Por ejemplo, C:\Monitor.

  6. Debajo de la lista Filtros de archivo , seleccione Agregar.

  7. En el cuadro de diálogo Configuración de filtro , establezca lo siguiente:

    1. En el cuadro de lista Nombre , seleccione Nombre de archivo.

    2. En el cuadro de lista Relación , seleccione Coincide con el patrón.

    3. En el cuadro Valor , escriba *.txt.

      Esta opción indica al monitor que debe buscar archivos con la extensión txt . Este campo acepta la sintaxis de las expresiones regulares.

  8. Seleccione Aceptar.

  9. Seleccione la pestaña Desencadenadores.

  10. Seleccione la opción Número de archivos, establezca el valor de la lista en mayor que y, a continuación, escriba 0 en el cuadro de edición.

  11. Seleccione Finalizar.

  12. En el área de trabajo de diseño de Runbook Designer , haga doble clic en Enviar mensaje de registro de eventos.

  13. En el cuadro de diálogo Enviar propiedades del mensaje del registro de eventos, en la pestaña Detalles , en la sección Propiedades , establezca lo siguiente:

    1. En el cuadro Equipo , escriba el nombre del equipo para recibir el mensaje Evento.

      Normalmente, este es el equipo en el que se ejecuta Runbook Designer.

    2. En el cuadro Mensaje , escriba el mensaje que se va a mostrar en el registro de eventos. Por ejemplo, Archivo detectado.

    3. Deje el nivel Gravedad configurado como Information.

  14. Seleccione Finalizar.

    Nota

    En este ejemplo, la actividad Invocar runbook no está configurada.

Modificación de la configuración del runbook

Siga estos pasos para modificar la configuración del runbook:

  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.

  2. En el cuadro de diálogo Supervisar propiedades del runbook , seleccione la pestaña Registro y, a continuación, seleccione Datos devueltos específicos de la actividad del almacén y Almacenar datos devueltos comunes.

  3. Seleccione Finalizar.

  4. Haga clic con el botón secundario en la pestaña Supervisar Runbook para seleccionar Registrar.

Probar el runbook

En Runbook Tester puede probar Runbooks en entornos de tiempo de ejecución simulado y de depuración. 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.

Siga los pasos siguientes para probar su Runbook en Runbook Tester.

Preparación del equipo

Siga estos pasos para preparar el equipo:

  1. Haga clic con el botón secundario en Inicio para seleccionar Abrir el Explorador de Windows.

  2. Cree la carpeta C:\Monitor en su equipo.

  3. Cree la carpeta C:\Source en su equipo.

  4. En la carpeta C:\Source , cree un archivo con una extensión txt . Por ejemplo, text.txt.

Probar el runbook

Siga estos pasos para probar el runbook:

  1. En el área de trabajo de diseño Runbook Designer , seleccione la pestaña Supervisar Runbook .

  2. En la barra de herramientas situada encima del área de trabajo de Runbook Designer Diseño, seleccione Runbook Tester.

  3. En el cuadro de diálogo Confirmar des check out , seleccione .

  4. En Runbook Tester, en la barra de herramientas, seleccione Depurar paso a paso para empezar a recorrer el 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 .

  5. En el Explorador de Windows, vaya a la carpeta C:\Source .

  6. Copie el archivo test.txt a C:\Monitor.

  7. Cierre el Explorador de Windows.

  8. En la barra de herramientas Runbook Tester, seleccione Siguiente.

    Después de unos instantes, la entrada del panel Registro se actualiza y muestra un evento para la actividad Supervisar carpeta .

  9. En el panel Registro , seleccione el vínculo Mostrar detalles para ver el contenido del bus de datos de ese runbook.

  10. Desplácese hacia abajo en la lista de propiedades. Si el estado de la actividad es correcto, indica que la actividad Supervisar carpeta detectó el cambio en la carpeta.

  11. En la barra de herramientas Runbook Tester, seleccione Siguiente.

    Tenga en cuenta que el panel Registro ha cambiado y muestra un evento para la actividad Enviar mensaje de registro de eventos .

  12. Seleccione el vínculo Mostrar detalles . Si el estado de la actividad es correcto, indica que la actividad Enviar mensaje del registro de eventos detectó el cambio en la carpeta .

  13. Cierre Runbook Tester.

  14. En la barra de herramientas de Runbook Designer, seleccione Check In.

Pasos siguientes