Tarefa Executar Processo

A tarefa Executar Processo executa um aplicativo ou arquivo de lote como parte de um fluxo de trabalho do pacote SQL Server Integration Services. Embora você possa usar a tarefa Executar Processo para abrir qualquer aplicativo padrão, como Microsoft Excel ou Microsoft Word, você geralmente o utiliza para executar aplicativos de negócios ou arquivos de lote que trabalham em uma fonte de dados. Por exemplo, você pode usar a tarefa Executar Processo para expandir um arquivo de texto compactado. Depois, o pacote pode usar o arquivo de texto como uma fonte de dados para o fluxo de dados no pacote. Como outro exemplo, você pode usar a tarefa Executar Processo para executar um aplicativo Visual Basic personalizado que gera um relatório de vendas diário. Então, você pode anexar o relatório a uma tarefa Enviar Email e encaminhar o relatório para uma lista de distribuição.

Quando a tarefa Executar Processo executa um aplicativo personalizado, a tarefa fornece entrada para o aplicativo por meio de um ou de ambos estes métodos:

• Uma variável que você especifica na configuração da propriedade StandardInputVariable. Para obter mais informações sobre variáveis, consulte Variáveis do Integration Services e Usando variáveis em pacotes.

• Um argumento que você especifica na configuração de propriedade Arguments. Por exemplo, se a tarefa abrir um documento no Word, o argumento poderá nomear o arquivo .doc.

Para passar vários argumentos a um aplicativo personalizado em uma tarefa Executar Processo, use espaços para delimitar os argumentos. Um argumento não pode incluir um espaço; caso contrário, a tarefa não será executada. Você pode usar uma expressão para passar um valor variável como argumento. No exemplo a seguir, a expressão passa dois valores variáveis como argumentos e usa um espaço para delimitar os argumentos:

@variable1 + " " + @variable2

Você pode usar uma expressão para definir várias propriedades da tarefa Executar Processo.

Quando você usar a propriedade StandardInputVariable para configurar a tarefa Executar Processo para fornecer entrada, chame o método Console.ReadLine do aplicativo para ler a entrada. Para obter mais informações, consulte o tópico Console.ReadLine na Biblioteca de Classes do Microsoft .NET Framework.

Quando você usar a propriedade Arguments para configurar a tarefa Executar Processo para fornecer entrada, execute uma destas etapas para obter os argumentos:

• Se você usar Microsoft Visual Basic 2005 para escrever o aplicativo, defina a propriedade My.Application.CommandLineArgs. O exemplo a seguir define a propriedade My.Application.CommandLineArgs para recuperar dois argumentos:

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

  Para obter mais informações, consulte o tópico My.Application.CommandLineArgs, na referência do Visual Basic.

• Se você usar o Microsoft Visual C# para escrever o aplicativo, use o método Main.

  Para obter mais informações, consulte o tópico Command-Line Arguments (C# Programming Guide), no Guia de Programação C#.

A tarefa Executar Processo também inclui as propriedades StandardOutputVariable e StandardErrorVariable para especificar as variáveis que consomem a saída padrão e a saída de erro do aplicativo, respectivamente.

Além disso, você pode configurar a tarefa Executar Processo para especificar um diretório de trabalho, um tempo-limite ou um valor para indicar que o executável foi executado com êxito. A tarefa também pode ser configurada para falhar se o código de retorno do executável não corresponder ao valor que indica êxito, ou se o executável não for encontrado no local especificado.