Cómo documentar el flujo de control de paquetes SSIS

El flujo de control es el motor de flujo de trabajo de SQL Server que contiene elementos de flujo de control. Un paquete SSIS consiste en al menos una tarea de flujo de control, y opcionalmente uno o más flujos de datos.

Hay tres tipos de elementos de flujo de control:

Contenedores – proveen estructura a tareas de paquetes y servicios. Ellos soportan la repetición de tareas de flujo de control, y la agrupación en unidades significativas. Un solo contenedor puede ser creado dentro de otro contenedor, junto con las tareas adicionales. Dependiendo del tipo, podría ser usado para repetir tareas para cada elemento en una colección, repetir tareas hasta que se cumple una condición especificada, o el contenedor puede agrupar tareas y otros contenedores en unidades que deben ser exitosas o fallar cuando finalice.

Tareas de flujo de control – los objetos de flujo de trabajo que realizan una gran cantidad de operaciones, como enviar un mensaje de correo electrónico ejecutando una sentencia SQL o copiar un archivo desde un servidor FTP. Si el paquete contiene más de una tarea de flujo de control, ellos son conectados y secuenciados con una restricción de precedencia. Cuando la tarea de flujo de control finaliza, dicha tarea es exitosa o falla

Restricciones de precedencia – conecte tareas, ejecutables y contenedores dentro del flujo de control y especifique una condición que determine si la tarea se ejecutará o no. Las restricciones de precedencia pueden ser configuradas por expresiones lógicas AND o OR, y tener éxito o fallar. Una tarea puede ser conectada a otra con múltiples restricciones de precedencia, y para cada restricción una condición separada puede ser especificada.

De manera similar a documentar el flujo de datos, documentar una tarea de flujo de control significa definir un nombre descriptivo para la tarea, añadir más acerca de la tarea en el campo Description, o para añadir una anotación. Cuando esta información necesita ser accedida, el paquete SSIS necesita ser abierto. Esto podría ser un problema si el paquete contiene numerosas tareas de flujo de control con múltiples tareas de flujo de datos.

ApexSQL Doc es una herramienta de documentación para paquetes SSIS, cubos SSAS y bases de datos SQL que genera documentación amigable para el usuario en varios formatos: CHM, HTML, DOC, DOCX y PDF.

Documentar paquetes SSIS incluye las propiedades para cada tarea SSIS, los diagramas tanto del flujo de control como del flujo de datos. Las fuentes de paquetes SSIS soportadas por ApexSQL Doc son SQL Server, el sistema de archivos y el Almacén de Paquetes SSIS. El proceso de documentación puede ser especificado usando la interfaz de Línea de Comandos y programado para ejecutarse sin intervención del usuario.

Para documentar un diagrama de flujo de control SSIS:

Inicie ApexSQL Doc como administrador.
Haga clic en el botón New de la pestaña Home para iniciar un nuevo proyecto.
Inicie la documentación del paquete SSIS haciendo clic en el botón Add debajo de la pestaña Integration services:
Seleccione la fuente de paquetes apropiada desde el diálogo Add integration services packages, navegue al paquete que desea documentar y haga clic en el botón Connect:
Cuando el paquete es incluido, aparece en la sección Package selection:
La sección Package details ofrece atributos de filtrado de paquetes que serán incluidos en el proceso de documentación:
Cuando todo esto está configurado, haga clic en el botón Generate de la pestaña Home para iniciar el proceso de documentación:
En el documento de salida, navegue al nodo del paquete SSIS y desplácese hacia abajo para ver el diagrama de flujo de Control: