Creación y prueba de un runbook de ejemplo
En el siguiente artículo se describe cómo crear y probar un runbook de muestra. El propósito de este runbook es detectar cuándo se agrega un archivo de texto a una carpeta determinada, copiar ese archivo en otra carpeta, leer el contenido del archivo, anexar una línea del archivo copiado a otro archivo y, a continuación, eliminar el archivo original.
El runbook comienza con una actividad Supervisar archivo para esperar a que se cree el archivo de texto. A continuación, usa las actividades Copiar archivo, Leer línea, Anexar línea y Eliminar archivo para realizar las demás funciones. Se usa una actividad Unión para coordinar las actividades de manera que las actividades Copiar archivo y Anexar línea se completen antes de que se elimine el archivo de origen.
Creación del runbook
Usa los procedimientos siguientes para crear el runbook mediante las actividades necesarias.
- Selecciona Inicio, elige Todos los programas, selecciona Microsoft System Center 2016, elige Orchestrator y, después, selecciona Runbook Designer.
- Seleccione Inicio, seleccione Todos los programas, Microsoft System Center 2025, Orquestador y, a continuación , Runbook Designer.
En el panel Conexiones, haz clic con el botón derecho en Runbooks para seleccionar Nuevo y, a continuación, selecciona Runbook.
Aparece una pestaña Nuevo runbook en la parte superior del área de trabajo de diseño de Runbook Designer con el nombre Nuevo 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 extracción, selecciona Sí.
Introduce Anexar y copiar flujo de trabajo en el cuadro Entrada y, a continuación, pulsa Entrar.
Has creado un runbook y ya se puede empezar a agregar y configurar actividades.
Agregar y configurar una actividad Supervisar archivo
Sigue estos pasos para agregar y configurar una actividad Supervisar archivo:
Con el recién creado runbook Anexar y copiar flujo de trabajo abierto, en el panel Actividades, expande la categoría Administración de archivos.
Selecciona y arrastre la actividad Supervisar archivo al área de trabajo de diseño de Runbook Designer.
Haz doble clic en la actividad Supervisar archivo para abrir su cuadro de diálogo Propiedades.
En el cuadro En carpeta, escribe C:\Drop.
En la sección Filtros, selecciona el botón Agregar.
En el cuadro de diálogo Configuración de filtro, en la lista Nombre, selecciona Nombre de archivo.
En la lista Relación, selecciona Coincide con el patrón.
En el cuadro Valor, introduce *.txt.
Seleccione Aceptar.
Seleccione la pestaña Desencadenadores.
En la sección Desencadenar si uno de los archivos, activa la casilla Creado y luego selecciona Finalizar.
La actividad Supervisar archivo se crea y configura para inspeccionar los archivos de texto nuevos que se crean en la carpeta C:\Drop.
Adición de actividades adicionales al runbook
Sigue estos pasos para agregar actividades adicionales al runbook:
En el panel Actividades, expande la categoría Administración de archivos.
Selecciona y arrastra la actividad Copiar archivo al área de trabajo de diseño de Runbook Designer.
Expande la categoría Administración de archivos de texto.
Selecciona y arrastra la actividad Leer línea al área de trabajo de diseño de Runbook Designer.
Para crear un vínculo entre la actividad Supervisar archivo y la actividad Copiar archivo, selecciona y arrastra la flecha derecha de la actividad Supervisar archivo a la actividad Copiar archivo.
Para crear un vínculo entre la actividad Supervisar archivo y la actividad Leer línea, selecciona y arrastra la flecha derecha de la actividad Supervisar archivo a la actividad Leer línea.
Al agregar la actividad Leer línea y la actividad Copiar archivo, se crea un flujo de trabajo.
Configuración de la actividad Copiar archivo
Sigue estos pasos para configurar la actividad Copiar archivo:
En el runbook Anexar y copiar flujo de trabajo, haz clic con el botón derecho en la actividad Copiar archivo para seleccionar Propiedades.
En la pestaña Detalles, haz clic con el botón derecho en el cuadro Archivo para seleccionar Suscribirse y, a continuación, selecciona Datos publicados para abrir el cuadro de diálogo Datos publicados.
La actividad Supervisar archivo aparece en la parte superior del cuadro de diálogo Datos publicados porque esta es la actividad que hay justo antes de la actividad seleccionada.
En la columna Nombre, selecciona Nombre y ruta de acceso del archivo y, a continuación, selecciona Aceptar. Esto rellena la propiedad Archivo de la actividad Copiar archivo con el nombre y la ruta de acceso al archivo desde la actividad Supervisar archivo.
En el cuadro Carpeta de destino, escribe C:\Copy.
Seleccione Finalizar.
La actividad Copiar archivo ahora está configurada para copiar archivos desde la carpeta de origen a la carpeta de destino.
Configuración de la actividad Leer línea
Siga estos pasos para configurar la actividad Leer línea:
En el runbook Anexar y copiar flujo de trabajo, haz clic con el botón derecho en la actividad Leer línea para seleccionar Propiedades.
En la pestaña Detalles, haz clic con el botón derecho en el cuadro Archivo para seleccionar Suscribirse y, a continuación, selecciona Datos publicados para abrir el cuadro de diálogo Datos publicados.
En la lista Actividades, selecciona Supervisar archivo.
En la columna Nombre, selecciona Nombre y ruta de acceso del archivo y, a continuación, selecciona Aceptar.
Selecciona el botón de puntos suspensivos (...) situado a la derecha del cuadro Codificación de archivos y, a continuación, selecciona Auto.
En el cuadro Números de línea, escribe 1-END y, a continuación, selecciona Aceptar.
Seleccione Finalizar.
La actividad Leer línea ahora está configurada.
Agregar una actividad Anexar línea
Siga estos pasos para agregar una actividad Anexar línea:
En el panel Actividades, expanda la categoría Administración de archivos de texto.
Selecciona y arrastra la actividad Anexar línea al área de trabajo de diseño de Runbook Designer a la derecha de la actividad Leer línea .
Para crear un vínculo desde la actividad Leer línea a la actividad Anexar línea, selecciona y arrastra la flecha derecha de la actividad Leer línea a la actividad Anexar línea.
Haz clic con el botón derecho en la actividad Anexar línea para seleccionar Propiedades.
En la pestaña Detalles del cuadro Archivo, escribe C:\Copy\Masterlog.txt.
Selecciona el botón de puntos suspensivos (...) situado a la derecha del cuadro Codificación de archivos y, a continuación, selecciona Auto.
Haz clic con el botón derecho en el cuadro Texto para seleccionar Suscribirse y luego selecciona Datos publicados para abrir el cuadro de diálogo Datos publicados.
En la columna Nombre de la actividad Leer línea, selecciona Texto de línea y, después, Aceptar.
Seleccione Finalizar.
La actividad Append File (Anexar archivo) ahora está configurada para anexar archivos al archivo Masterlog.txt .
Sincronizar ramas de un runbook
Siga estos pasos para sincronizar las ramas de un runbook:
En el panel Actividades, expanda la categoría Control de runbook.
Selecciona y arrastra el icono Unión al área de trabajo de Diseño de Runbook Designer .
Para crear un vínculo desde la actividad Anexar línea a la actividad Unión, selecciona y arrastra la flecha derecha de la actividad Anexar línea a la actividad Unión.
Para crear un vínculo desde la actividad Copiar archivo a la actividad Unión, selecciona y arrastra la flecha derecha de la actividad Copiar archivo a la actividad Unión.
Haz clic con el botón derecho en la actividad Unión para seleccionar Propiedades.
Selecciona el botón de puntos suspensivos (...) situado junto al cuadro Devolver datos de y, a continuación, selecciona Copiar archivo. Seleccione Aceptar. Esta acción configura la actividad para devolver los mismos datos publicados que la actividad Copiar archivo.
Seleccione Finalizar.
La actividad Unión está configurada para coordinar el flujo de trabajo de modo que no se ejecuten más actividades hasta que finalice la actividad Copiar archivo y Anexar línea.
Agregar y configurar la actividad Eliminar archivo
Sigue estos pasos para agregar y configurar la actividad Eliminar archivo.
En el panel Actividades, expande la categoría Administración de archivos.
Selecciona y arrastra el icono Eliminar archivo al área de trabajo de diseño Runbook Designer.
Para crear un vínculo desde la actividad Unión a la actividad Eliminar archivo, selecciona y arrastra la flecha derecha de la actividad Unión a la actividad Eliminar archivo.
Haz clic con el botón derecho en la actividad Eliminar archivo para seleccionar Propiedades.
Haz clic con el botón derecho en el cuadro Ruta de acceso para seleccionar Suscribirse y, a continuación, seleccione Datos publicados para abrir el cuadro de diálogo Datos publicados.
En la lista Actividad, selecciona Copiar archivo.
En la columna Nombre, selecciona Nombre y ruta de acceso del archivo original y, a continuación, selecciona Aceptar.
Seleccione Finalizar.
El runbook Append and Copy Workflow (Anexar y copiar flujo de trabajo ) ya se ha completado. El aspecto deberá ser parecido al de la ilustración siguiente:
Probar el runbook
Puedes probar el runbook mediante Runbook Tester. Esta herramienta te permite ejecutar todo el runbook e inspeccionar el estado de finalización y la salida de cada actividad. Runbook Tester ejecuta las actividades, por lo que primero debes crear las carpetas especificadas para el runbook.
Para probar el runbook, sigue estos pasos:
Crea una carpeta en el servidor de runbook denominada C:\Drop.
Crea una carpeta en el servidor de runbook denominada C:\Copy.
Con el runbook Anexar y copiar flujo de trabajo seleccionado en Runbook Designer, en la barra de herramientas, selecciona Runbook Tester.
Selecciona Ejecutar para punto de interrupción. La actividad Supervisar archivo se carga y espera a que se cree un archivo de texto en la carpeta C:\Drop.
Abre el Bloc de notas y escribe algunas líneas de texto. Guarda el archivo como C:\Drop\File1.txt.
Espera unos instantes para que se ejecuten las demás actividades. Asegúrate de que cada una de las actividades se haya completado correctamente.
Para ver los detalles y los datos publicados de una actividad, selecciona Mostrar detalles en la actividad.
Abre la carpeta C:\Drop y asegúrate de que se ha eliminado el archivo.
Abre la carpeta C:\Copy y asegúrate de que se ha copiado el archivo. Comprueba también que el archivo MasterLog.txt tiene el contenido del archivo original.
Pasos siguientes
Consulta el Runbook de ejemplo: Supervisión de una carpeta con un runbook.