Runbook de ejemplo: supervisión de una carpeta con un runbook
En este artículo se muestra cómo crear un runbook sencillo que supervisa una carpeta para nuevos archivos de texto. Cuando se detecta un archivo, el runbook envía un mensaje de registro de eventos y luego inicia otro runbook.
Creación y prueba de un runbook de supervisión
Los procedimientos para crear, configurar y probar un runbook sencillo que supervisa una carpeta se describen a continuación.
Crear el flujo de trabajo
Para crear un flujo de trabajo, sigue estos pasos:
En el panel Conexiones de Runbook Designer, haz clic con el botón derecho en la carpeta Runbooks para seleccionar Nuevo y luego selecciona Runbook.
Haz clic con el botón derecho en la pestaña Nuevo runbook para seleccionar Cambiar nombre.
En el cuadro de diálogo Confirmar modificación, selecciona Sí.
Escribe un nombre para el runbook, como Runbook de supervisión y presiona Entrar.
En el panel Actividades, selecciona Administración de archivos para expandir la categoría y luego arrastra la actividad Supervisar carpeta al área de trabajo de diseño de Runbook Designer.
En el panel Actividades, selecciona Notificación para expandir la categoría y luego arrastra la actividad Enviar mensaje de registro de eventos al área de trabajo de diseño de Runbook Designer, a la derecha de la actividad Supervisar carpeta.
En el área de trabajo de diseño de Runbook Designer, mueve el puntero sobre el lado derecho de la actividad Supervisar carpeta para mostrar la flecha del vínculo inteligente.
Selecciona la flecha del vínculo inteligente y arrástrala a la actividad Enviar mensaje del registro de eventos.
En el panel Actividades, selecciona Control de Runbook para expandir la categoría y luego arrastra la actividad Invocar Runbook al área de trabajo de diseño de Runbook Designer, a la derecha de la actividad Enviar mensaje de registro de eventos.
En el área de trabajo de diseño de Runbook Designer, mueve el puntero sobre el lado derecho de la actividad Enviar mensaje de registro de eventos para mostrar la flecha del vínculo inteligente.
Selecciona la flecha del vínculo inteligente y arrástrala a la actividad Invocar Runbook .
Configurar flujos de trabajo
Para configurar el flujo de trabajo, sigue estos pasos:
En el área de trabajo de diseño de Runbook Designer, haz doble clic en la actividad Supervisar carpeta.
En el cuadro de diálogo Supervisar propiedades de carpeta, selecciona la pestaña General.
En el cuadro Nombre, cambia el nombre de la actividad por algo informativo. Por ejemplo, Supervisar la carpeta C:\Monitor.
Seleccione la pestaña Details (Detalles).
En la pestaña Detalles, en el cuadro Ruta, introduce la ruta de la carpeta que deseas supervisar. Por ejemplo, C:\Monitor.
Debajo de la lista Filtros de archivos, selecciona Agregar.
En el cuadro de diálogo Configuración de filtro, establece las opciones siguientes:
En el cuadro de lista Nombre, selecciona Nombre de archivo.
En el cuadro de lista Relación, selecciona Coincide con el patrón.
En el cuadro Valor, introduce *.txt.
Esta opción hace que el monitor busque archivos con la extensión txt. Este campo acepta sintaxis de expresión regular.
Seleccione Aceptar.
Seleccione la pestaña Desencadenadores.
Selecciona la opción El número de archivos es, establece el valor de la lista en Mayor que y luego introduce 0 en el cuadro de edición.
Seleccione Finalizar.
En el área de trabajo de diseño de Runbook Designer, haz doble clic en Enviar mensaje de registro de eventos.
En el cuadro de diálogo Propiedades de Enviar mensaje de registro de eventos, en la pestaña Detalles, en la sección Propiedades, establece lo siguiente:
En el cuadro Equipo, introduce el nombre del equipo que recibirá el mensaje de Evento.
Normalmente, este es el equipo en el que se ejecuta Runbook Designer.
En el cuadro Mensaje, introduce el mensaje que se mostrará en el Registro de eventos. Por ejemplo, Archivo detectado.
Deja el nivel de Gravedad en Información.
Seleccione Finalizar.
Nota:
En este ejemplo, la actividad Invocar runbook no está configurada.
Modificación de la configuración del runbook
Sigue estos pasos para modificar la configuración del runbook:
Sobre el espacio de trabajo de diseño Runbook Designer, haz clic con el botón derecho en la pestaña Supervisar runbook para seleccionar Propiedades.
En el cuadro de diálogo Propiedades de Supervisar runbook, selecciona la pestaña Registro y después selecciona tanto Almacenar datos devueltos específicos de la actividad como Almacenar datos devueltos comunes.
Seleccione Finalizar.
Haz clic con el botón derecho en la pestaña Supervisar runbook para seleccionar Actualizar.
Probar el runbook
En Runbook Tester, puedes probar runbooks en un entorno de ejecución simulado y depuración. Puedes ejecutar un runbook completo, recorrerlo una actividad a la vez o agregar puntos de interrupción para detener la simulación en cualquier actividad que selecciones.
Sigue estos pasos para probar el runbook en Runbook Tester.
Preparación del equipo
Sigue estos pasos para preparar tu equipo:
Haz clic con el botón derecho en Inicio para seleccionar Abrir el Explorador de Windows.
Crea una carpeta C:Monitor en tu equipo.
Crea una carpeta C:\Source en tu ordenador.
En la carpeta C:\Source, crea un archivo con extensión txt. Por ejemplo, text.txt.
Probar el runbook
Sigue estos pasos para probar el runbook:
En el área de trabajo de diseño Runbook Designer, selecciona la pestaña Supervisar runbook.
En la barra de herramientas situada encima del área de trabajo de diseño Runbook Designer, selecciona Runbook Tester.
En el cuadro de diálogo Confirmar modificación, selecciona Sí.
En Runbook Tester, en la barra de herramientas, selecciona Paso a paso para empezar a recorrer el runbook.
Sugerencia
Para aumentar el tamaño del panel Registro, quita el panel Explorador de recursos al seleccionar Ver en el menú y después desactivar la opción Explorador de recursos.
En el Explorador de Windows, ve a la carpeta C:\Source.
Copia test.txt en C:\Monitor.
Cierre el Explorador de Windows.
En la barra de herramientas Runbook Tester, selecciona Siguiente.
Después de unos instantes, la entrada del panel Registro se actualiza y muestra un evento para la actividad Supervisar carpeta.
En el panel Registro, selecciona el vínculo Mostrar detalles para ver el contenido del bus de datos de ese runbook.
Desplázate por la lista de propiedades. Si el estado de la actividad es correcto, indica que la actividad Supervisar carpeta ha detectado el cambio en la carpeta.
En la barra de herramientas Runbook Tester, selecciona Siguiente.
Observa que el panel Registro cambia y muestra un evento para la actividad Enviar mensaje de registro de eventos.
Selecciona el vínculo Mostrar detalles . Si el estado de la actividad es correcto, indica que la actividad Enviar mensaje del registro de eventos ha detectado el cambio en la carpeta.
Cierra Runbook Tester.
En la barra de herramientas Runbook Designer, selecciona Actualizar.
Pasos siguientes
- Lee Diseño y compilación de runbooks para obtener más información sobre la creación de runbooks y obtener instrucciones de procedimientos recomendados para diseñar runbooks.
- Lee Control de actividades de runbook para obtener más información sobre las opciones para controlar la ejecución de runbook.