Tarea Ejecutar proceso

Se aplica a: SQL Server SSIS Integration Runtime en Azure Data Factory

La tarea Ejecutar proceso ejecuta una aplicación o un archivo por lotes como parte de un flujo de trabajo de paquete de SQL Server Integration Services. Aunque puede utilizar la tarea Ejecutar proceso para abrir cualquier aplicación estándar, como Microsoft Excel o Microsoft Word, normalmente la utilizará para ejecutar aplicaciones empresariales o archivos por lotes que trabajen con un origen de datos. Por ejemplo, puede utilizar la tarea Ejecutar proceso para expandir un archivo de texto comprimido. Una vez hecho esto, el paquete puede usar el archivo de texto como origen de datos para el flujo de datos. Otro ejemplo sería utilizar la tarea Ejecutar proceso para ejecutar una aplicación de Visual Basic personalizada que genera un informe de ventas diario. Se puede adjuntar este informe a una tarea Enviar correo para reenviarlo a una lista de distribución.

Integration Services incluye otras tareas que realizan operaciones de flujo de trabajo, como ejecutar paquetes. Para más información, consulte Execute Package Task.

Entradas del registro personalizadas disponibles en la tarea Ejecutar proceso

La siguiente tabla contiene las entradas del registro personalizadas para la tarea Ejecutar proceso. Para más información, consulte Registro de Integration Services (SSIS).

Configuración de la tarea Ejecutar proceso

Puede establecer propiedades a través del Diseñador de SSIS o mediante programación.

Para obtener más información sobre cómo configurar estas propiedades en el Diseñador SSIS, consulta Agregar o eliminar tareas o contenedores en un flujo de control.

Configuración de propiedades

Cuando la tarea Ejecutar proceso ejecuta una aplicación personalizada, la tarea proporciona la entrada para la aplicación por medio de los métodos siguientes:

• Una variable que se especifica en la configuración de la propiedad StandardInputVariable . Para obtener más información sobre las variables, consulta Variables de Integration Services (SSIS) y Variables de Integration Services (SSIS).

• Un argumento que se especifica en la configuración de la propiedad Arguments . Por ejemplo, si la tarea abre un documento en Word, el argumento puede asignar un nombre al archivo .doc.

Cuando se pasan varios argumentos a una aplicación personalizada en una tarea Ejecutar proceso, se usan espacios para separarlos. Los argumentos no pueden incluir espacios; de lo contrario, la tarea no se ejecutará. Puede usar una expresión para pasar un valor de variable como argumento. En el ejemplo siguiente, la expresión pasa dos valores de variable como argumentos y usa un espacio para delimitar los argumentos:

@variable1 + " " + @variable2

Puede usar una expresión para establecer diversas propiedades de la tarea Ejecutar proceso.

Cuando use la propiedad StandardInputVariable para configurar la tarea Ejecutar proceso para proporcionar la entrada, llame al método Console.ReadLine desde la aplicación para leer la entrada. Para obtener más información, consulta Método Console.ReadLine.

Cuando use la propiedad Argumentos para configurar la tarea Ejecutar proceso con el fin de proporcionar la entrada, realice uno de los pasos siguientes para obtener los argumentos:

• Si usa Microsoft Visual Basic para escribir la aplicación, establezca la propiedad My.Application.CommandLineArgs . En el ejemplo siguiente se establece la propiedad My.Application.CommandLineArgs para recuperar dos argumentos:

  Dim variable1 As String = My.Application.CommandLineArgs.Item(0)
  Dim variable2 As String = My.Application.CommandLineArgs.Item(1)
  

  Para obtener más información, consulta Propiedad ConsoleApplicationBase.CommandLineArgs.

• Si escribe la aplicación en Microsoft Visual C#, use el método Main.

  Para más información, consulta Argumentos de la línea de comandos (Guía de programación de C#).

La tarea Ejecutar proceso también incluye las propiedades StandardOutputVariable y StandardErrorVariable para especificar las variables que usan la salida estándar y la salida de errores de la aplicación, respectivamente.

Además, puede configurar la tarea Ejecutar proceso para especificar un directorio de trabajo, un período de tiempo de espera o un valor que indique que el ejecutable se ejecutó correctamente. La tarea también se puede configurar para que no se complete su ejecución si el código de retorno del ejecutable no coincide con el valor que indica que se ejecutó correctamente o si el ejecutable no se encuentra en la ubicación especificada.

Configuración mediante programación de la tarea Ejecutar proceso

Para obtener más información sobre la configuración mediante programación de estas propiedades, vea ExecuteProcess.

Editor de la tarea Ejecutar proceso (página General)

Usa la página General del cuadro de diálogo Editor de la tarea Ejecutar proceso para asignar un nombre a la tarea Ejecutar proceso y describirla.

Opciones

Nombre
Proporcione un nombre único para la tarea Ejecutar proceso. Este nombre se utiliza como etiqueta en el icono de tarea.

Descripción
Escriba una descripción de la tarea Ejecutar proceso.

Editor de la tarea Ejecutar proceso (página Procesar)

Utilice la página Proceso del cuadro de diálogo Editor de la tarea Ejecutar proceso para configurar las opciones que permitirán ejecutar el proceso. Estas opciones incluyen el ejecutable que se debe instalar, su ubicación, los argumentos de línea de comandos y las variables que proporcionan información de entrada y capturan información de salida.

Opciones

RequireFullFileName
Indica si la tarea debe generar un error en caso de que no se encuentre el ejecutable en la ubicación específica.

Executable
Escriba el nombre del ejecutable que desea instalar.

Argumentos
Proporcione los argumentos de línea de comandos.

WorkingDirectory
Escribe la ruta de acceso de la carpeta que contiene el ejecutable o haz clic en el botón Examinar (…) y busca la carpeta.

StandardInputVariable
Selecciona una variable para proporcionar la entrada al proceso o haz clic en <Nueva variable…> para crear una:

Temas relacionados: Variables de Integration Services (SSIS)

StandardOutputVariable
Selecciona una variable para capturar la salida del proceso o haz clic en <Nueva variable…> para crear una.

StandardErrorVariable
Selecciona una variable para capturar la salida de error del procesador o haz clic en <Nueva variable…> para crear una.

FailTaskIfReturnCodeIsNotSuccessValue
Esta opción indica si la tarea genera un error porque el código de salida del proceso es diferente del valor especificado en SuccessValue.

SuccessValue
Especifique el valor que devuelve el ejecutable para indicar su instalación correcta. De forma predeterminada, este valor está establecido en 0.

TimeOut
Especifique el número de segundos que el proceso puede ejecutarse. El valor 0 indica que no se usará ningún valor de tiempo de espera y que el proceso se ejecutará hasta que se complete o se produzca un error.

TerminateProcessAfterTimeOut
Esta opción indica si el proceso está obligado a finalizar después del período de tiempo de espera especificado con la opción TimeOut . Esta opción solo está disponible si el valor de TimeOut es distinto de 0.

WindowStyle
Especifique el estilo de ventana en el que ejecutará el proceso.

Contenido relacionado

• Tareas de Integration Services
• Flujo de control