Creación y prueba de Runbooks de ejemploCreating and Testing a Sample Runbook

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

El siguiente tema describe cómo crear y probar un Runbook simple.The following topic describes how to create and test a simple runbook. El propósito de este Runbook es detectar cuándo se agrega un determinado tipo de archivo a una carpeta específica, copiar dicho archivo en otra carpeta, leer los contenidos del archivo, anexar una línea del archivo copiado a otro archivo y, a continuación, eliminar el archivo original.The purpose of this runbook is to detect when a text file is added to a particular folder, copy that file to another folder, read the contents of the file, append a line from the copied file to another file, and then delete the original file.

El Runbook se inicia con la actividad con Supervisar archivo para esperar a que se cree el archivo de texto.The runbook starts with a Monitor File activity to wait for the text file to be created. A continuación, utiliza las actividades Copiar archivo, Leer línea, Anexar líneay Eliminar archivo para realizar el resto de funciones.It then uses the Copy File, Read Line, Append Line, and Delete File activities to perform the other functions. La actividad Unión se utiliza para coordinar las actividades de manera que las actividades Copiar archivo y Anexar línea se completen antes de que se elimine el archivo original.A Junction activity is used to coordinate the activities so that the Copy File and Append Line activities are both completed before the source file is deleted.

Creación del RunbookCreating the runbook

Utilice los procedimientos siguientes para crear el Runbook mediante las actividades necesarias.Use the following procedures to create the runbook by using the required activities.

Crear un RunbookTo create a runbook

  1. Haga clic en iniciar, seleccione todos los programas, haga clic en Microsoft System Center 2016, haga clic en Orchestratory, a continuación, haga clic en Runbook Designer.Click Start, point to All Programs, click Microsoft System Center 2016, click Orchestrator, and then click Runbook Designer.

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

    Aparecerá la pestaña Nuevo Runbook en la parte superior del área de trabajo de diseño Runbook Designer con el nombre Nuevo Runbook.A New Runbook tab appears at the top of the Runbook Designer Design workspace with the name New Runbook.

  3. 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.

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

  4. Escriba Anexar y copiar flujo de trabajo en el cuadro Entrada y, a continuación, presione Entrar.Type Append and Copy Workflow in the Input box, and then press Enter.

Ha creado un nuevo Runbook y está listo para comenzar a agregar y configurar actividades.You have created a new runbook and are ready to begin adding and configuring activities.

Agregar y configurar una actividad Supervisar archivoTo add and configure a Monitor File activity

  1. Abra el Runbook Anexar y copiar flujo de trabajo que acaba de crear, en el panel Actividades , expanda la categoría Administración de archivos .With the newly created Append and Copy Workflow runbook open, in the Activities pane, expand the File Management category.

  2. Haga clic y arrastre la actividad Supervisar archivo al área de trabajo de diseño de Runbook Designer .Click and drag the Monitor File activity to the Runbook Designer Design workspace.

  3. Doble-haga clic en el supervisar archivo actividad para abrir su propiedades cuadro de diálogo.Double-click the Monitor File activity to open its Properties dialog box.

  4. En el en la carpeta , escriba C:\quitar.In the In folder box, type C:\Drop.

  5. En la sección Filtros , haga clic en el botón Agregar .In the Filters section, click the Add button.

  6. En el cuadro de diálogo Configuración de filtro , en la lista Nombre , seleccione Nombre de archivo.In the Filter Settings dialog box, in the Name list, select File Name.

  7. En la lista Relación , seleccione Coincide con el patrón.In the Relation list, select Matches Pattern.

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

  9. Haga clic en Aceptar.Click OK.

  10. Haga clic en la pestaña Desencadenadores .Click the Triggers tab.

  11. En la sección Desencadenar si uno de los archivos , seleccione la casilla Creado y, a continuación, haga clic en Finalizar.In the Trigger if one of the files was section, select the Created check box, and then click Finish.

El supervisar archivo actividad creada y configurada para inspeccionar los nuevos archivos de texto que se crean en la unidad C:\carpeta de entrega.The Monitor File activity is created and configured to watch for any new text files that are created in the C:\Drop folder.

Para agregar actividades adicionales al RunbookTo add additional activities to the runbook

  1. En el panel Actividades , expanda la categoría Administración de archivos .In the Activities pane, expand the File Management category.

  2. Haga clic y arrastre la actividad Copiar archivo al área de trabajo de diseño de Runbook Designer .Click and drag the Copy File activity to the Runbook Designer Design workspace.

  3. Expanda la categoría Administración de archivo de texto .Expand the Text File Management category.

  4. Haga clic y arrastre la actividad Leer línea al área de trabajo de diseño de Runbook Designer .Click and drag the Read Line activity to the Runbook Designer Design workspace.

  5. Para crear un vínculo entre la actividad Supervisar archivo y la actividad Copiar archivo , haga clic y arrastre la flecha derecha de la actividad Supervisar archivo a la actividad Copiar archivo .To create a link between the Monitor File activity and the Copy File activity, click and drag the right arrow of the Monitor File activity to the Copy File activity.

  6. Para crear un vínculo entre la actividad Supervisar archivo a la actividad Leer línea , haga clic y arrastre la flecha derecha de la actividad Supervisar archivo a la actividad Leer línea .To create a link between the Monitor File activity and the Read Line activity, click and drag the right arrow of the Monitor File activity to the Read Line activity.

Al agregar las actividades Leer línea y Copiar archivo , se creará un flujo de trabajo.By adding both the Read Line activity and the Copy File activity, you have created a workflow.

Para configurar la actividad Copiar archivoTo configure the Copy File activity

  1. En el Runbook Anexar y copiar flujo de trabajo , haga clic con el botón secundario en la actividad Copiar archivo para seleccionar Propiedades.In the Append and Copy Workflow runbook, right-click the Copy File activity to select Properties.

  2. En la pestaña Detalles , haga clic con el botón secundario en el cuadro Archivo para seleccionar Suscribiry, a continuación, haga clic en Datos publicados para abrir el cuadro de diálogo Datos publicados .On the Details tab, right-click the File box to select Subscribe, and then click Published Data to open the Published Data dialog box.

    La actividad Supervisar archivo se mostrará en la parte superior del cuadro de diálogo Datos publicados , ya que es la actividad inmediatamente anterior a la actividad seleccionada.The Monitor File activity is listed at the top of the Published Data dialog box because this is the activity just before to the selected activity.

  3. En la columna Nombre , seleccione Nombre y ruta del archivoy, a continuación, haga clic en Aceptar.In the Name column, select Name and path of the file, and then click OK. De este modo se rellenará la propiedad Archivo de la actividad Copiar archivo con el nombre y la ruta de acceso del archivo de la actividad Supervisar archivo .This populates the File property of the Copy File activity with the name of and path to the file from the Monitor File activity.

  4. En el destino carpeta , escriba C:\copia.In the destination Folder box, type C:\Copy.

  5. Haga clic en Finalizar.Click Finish.

La actividad Copiar archivo está configurada para copiar archivos desde la carpeta de origen a la carpeta de destino.The Copy File activity is now configured to copy files from the source folder to the destination folder.

Para configurar la actividad Leer líneaTo configure the Read Line activity

  1. En el Runbook Anexar y copiar flujo de trabajo , haga clic con el botón secundario en la actividad Leer línea para seleccionar Propiedades.In the Append and Copy Workflow runbook, right-click the Read Line activity to select Properties.

  2. En la pestaña Detalles , haga clic con el botón secundario en el cuadro Archivo para seleccionar Suscribiry, a continuación, haga clic en Datos publicados para abrir el cuadro de diálogo Datos publicados .On the Details tab, right-click the File box to select Subscribe, and then click Published Data to open the Published Data dialog box.

  3. En la lista Actividades , seleccione Supervisar archivo.In the Activities list, select Monitor File.

  4. En la columna Nombre , seleccione Nombre y ruta del archivoy, a continuación, haga clic en Aceptar.In the Name column, select Name and path of the file, and then click OK.

  5. Haga clic en la elipse ( ... ) situado a la derecha de la codificación del archivo cuadro y, a continuación, seleccione automática.Click the ellipse (...) button to the right of the File encoding box, and then select auto.

  6. En el números de línea , escriba 1-finaly, a continuación, haga clic en Aceptar.In the Line numbers box, type 1-END, and then click OK.

  7. Haga clic en Finalizar.Click Finish.

Se ha configurado la actividad Leer línea.The Read Line activity is now configured.

Agregar una actividad Anexar líneaTo add an Append Line activity

  1. En el panel Actividades , expanda la categoría Administración de archivo de texto .In the Activities pane, expand the Text File Management category.

  2. Haga clic y arrastre la actividad Anexar línea al área de trabajo de diseño de Runbook Designer situada a la derecha de la actividad Leer línea .Click and drag the Append Line activity to the Runbook Designer Design workspace to the right of the Read Line activity.

  3. Para crear un vínculo desde la actividad Leer línea a la actividad Anexar línea , haga clic y arrastre la flecha derecha de la actividad Leer línea a la actividad Anexar línea .To create a link from the Read Line activity to the Append Line activity, click and drag the right arrow of the Read Line activity to the Append Line activity.

  4. Haga clic con el botón secundario en la actividad Anexar línea para seleccionar Propiedades.Right-click the Append Line activity to select Properties.

  5. En el detalles pestaña en el archivo , escriba C:\copia\principal.txt.On the Details tab in the File box, type C:\Copy\Masterlog.txt.

  6. Haga clic en la elipse ( ... ) situado a la derecha de la codificación del archivo cuadro y, a continuación, seleccione automática.Click the ellipse (...) button to the right of the File encoding box, and then select auto.

  7. Haga clic con el botón secundario en el cuadro Texto para seleccionar Suscribiry, a continuación, haga clic en Datos publicados para abrir el cuadro de diálogo Datos publicados .Right-click the Text box to select Subscribe, and then click Published Data to open the Published Data dialog box.

  8. En la columna Nombre de la actividad Leer línea , seleccione Texto de líneay, a continuación, haga clic en Aceptar.In the Name column for the Read Line activity, select Line text, and then click OK.

  9. Haga clic en Finalizar.Click Finish.

La actividad Anexar archivo está configurada para anexar archivos al archivo Masterlog.txt .The Append File activity is now configured to append files to the Masterlog.txt file.

Sincronizar las ramas de un RunbookTo synchronize branches of a runbook

  1. En el panel Actividades , expanda la categoría Control de Runbook .In the Activities pane, expand the Runbook Control category.

  2. Haga clic y arrastre el icono Unión al área de trabajo de diseño de Runbook Designer .Click and drag the Junction icon to the Runbook Designer Design workspace.

  3. Para crear un vínculo desde la actividad Anexar línea a la actividad Unión , haga clic y arrastre la flecha derecha de la actividad Anexar línea a la actividad Unión .To create a link from the Append Line activity to the Junction activity, click and drag the right arrow of the Append Line activity to the Junction activity.

  4. Para crear un vínculo desde la actividad Copiar archivo a la actividad Unión , haga clic y arrastre la flecha derecha de la actividad Copiar archivo a la actividad Unión .To create a link from the Copy File activity to the Junction activity, click and drag the right arrow of the Copy File activity to the Junction activity.

  5. Haga clic con el botón secundario en la actividad Unión para seleccionar Propiedades.Right-click the Junction activity to select Properties.

  6. Haga clic en la elipse ( ... ) situado junto a la devuelve datos tabulares de cuadro y, a continuación, seleccione copiar archivo.Click the ellipse (...) button next to the Return data from box, and then select Copy File. Haga clic en Aceptar.Click OK. Esta acción configura la actividad para devolver los mismos datos publicados que la actividad Copiar archivo .This action configures the activity to return the same Published Data as the Copy File activity.

  7. Haga clic en Finalizar.Click Finish.

La actividad Unión está configurada para coordinar el flujo de trabajo para que ninguna actividad se ejecute hasta que finalicen las actividades Copiar archivo y Anexar línea .The Junction activity is configured to coordinate the workflow so that no further activities run until both the Copy File activity and Append Line activity finish.

Para agregar y configurar la actividad Eliminar archivoTo add and configure the Delete File activity

  1. En el panel Actividades , expanda la categoría Administración de archivos .In the Activities pane, expand the File Management category.

  2. Haga clic y arrastre el icono Eliminar archivo al área de trabajo de diseño de Runbook Designer .Click and drag the Delete File icon to the Runbook Designer Design workspace.

  3. Para crear un vínculo desde la actividad Unión a la actividad Eliminar archivo , haga clic y arrastre la flecha derecha de la actividad Unión a la actividad Eliminar archivo .To create a link from the Junction activity to the Delete File activity, click and drag the right arrow of the Junction activity to the Delete File activity.

  4. Haga clic con el botón secundario en la actividad Eliminar archivo para seleccionar Propiedades.Right-click the Delete File activity to select Properties.

  5. Haga clic con el botón secundario en el cuadro Ruta de acceso para seleccionar Suscribiry, a continuación, haga clic en Datos publicados para abrir el cuadro de diálogo Datos publicados .Right-click the Path box to select Subscribe, and then click Published Data to open the Published Data dialog box.

    En la lista Actividad , seleccione Copiar archivo.In the Activity list, select Copy File.

  6. En la columna Nombre , seleccione Nombre y ruta del archivo originaly, a continuación, haga clic en Aceptar.In the Name column, select Name and path of the original file, and then click OK.

  7. Haga clic en Finalizar.Click Finish.

El Runbook Flujo de trabajo para anexar y copiar se ha completado.The Append and Copy Workflow runbook is now completed. Debe tener un aspecto similar al de la ilustración siguiente.It should look similar to the following illustration.

Ejemplo de Runbook 1

Prueba de RunbooksTesting the runbook

Puede probar el Runbook mediante la herramienta Runbook Tester.You can test the runbook by using the Runbook Tester. Esta herramienta permite ejecutar el Runbook al completo y comprobar el estado de finalización, así como la salida de todas las actividades.This tool lets you run the entire runbook and inspect the completion status and output of each activity. Runbook Tester ejecuta las actividades, por lo que primero deberá crear las carpetas especificadas para el Runbook.The Runbook Tester runs the activities, so you must first create the folders specified for the runbook.

Para probar el RunbookTo test the runbook

  1. Cree una carpeta en el servidor de runbook llamada C:\Drop.Create a folder on the runbook server called C:\Drop.

  2. Cree una carpeta en el servidor de runbook llamada C:\copia.Create a folder on the runbook server called C:\Copy.

  3. Con el Runbook Anexar y copiar flujo de trabajo seleccionado en Runbook Designer, en la barra de herramientas, haga clic en Runbook Tester.With the Append and Copy Workflow runbook selected in the Runbook Designer, on the toolbar, click Runbook Tester.

  4. Haga clic en Ejecutar hasta el punto de interrupción.Click Run To Breakpoint. El supervisar archivo actividad se carga y espera a que un archivo de texto que se creará en la unidad C:\carpeta de entrega.The Monitor File activity is loaded and waits for a text file to be created in the C:\Drop folder.

  5. Abra el Notepad y escriba varias líneas de texto.Open Notepad and type a few lines of text. Guarde el archivo como C:\Drop\File1.txt.Save the file as C:\Drop\File1.txt.

  6. Espere unos instantes para que se ejecuten las demás actividades.Wait a few moments for the other activities to run. Asegúrese de que todas las actividades finalicen correctamente.Ensure that each of the activities is completed successfully.

  7. Para ver los datos publicados y los demás detalles de una actividad, haga clic en Mostrar detalles para la actividad.To view the Published Data and other details of an activity, click Show Details for the activity.

  8. Abra la unidad C:\carpeta de destino y asegúrese de que se ha quitado el archivo.Open the C:\Drop folder and ensure that the file has been removed.

  9. Abra la unidad C:\copiar la carpeta y asegúrese de que se ha copiado el archivo.Open the C:\Copy folder and ensure that the file has been copied. Compruebe también que el archivo MasterLog.txt incluye el contenido del archivo original.Also verify that the MasterLog.txt file has the contents of the original file.

Pasos siguientesNext steps

Consulte la Runbook de ejemplo: Supervisión de una carpeta a un runbook.See the Example Runbook: Monitor a folder with a runbook.