Tarefa Serviço da Web

A tarefa Serviço Web executa um método de serviço Web. Você pode usar essa tarefa para os seguintes propósitos:

• Gravar em uma variável os valores retornados pelo método de serviço da Web. Por exemplo, você pode obter a temperatura mais alta do dia a partir do método de serviço da Web e, em seguida, pode utilizar esse valor para atualizar uma variável usada em uma expressão que define um valor de coluna.

• Gravar em um arquivo os valores retornados pelo método de serviço da Web. Por exemplo, uma lista de clientes potenciais pode ser gravada em um arquivo e o arquivo pode ser usado depois como fonte de dados em um pacote que limpa os dados antes de gravá-los em um banco de dados.

Arquivo WSDL

A tarefa Serviço da Web utiliza um gerenciador de conexões HTTP para se conectar ao serviço da Web. O gerenciador de conexões HTTP é configurado separadamente da tarefa Serviço da Web e é mencionado na tarefa. O gerenciador de conexões HTTP especifica as configurações de proxy do servidor como o URL do servidor, as credenciais para acessar o servidor de serviços da Web e a duração do tempo limite. Para obter mais informações, consulte Gerenciador de conexões HTTP.

Importante
O gerenciador de conexões HTTP dá suporte apenas para autenticação anônima e autenticação básica. Ele não suporta a Autenticação do Windows.

O gerenciador de conexões HTTP pode apontar para um site da Web ou para um arquivo WSDL (Web Service Description Language). O URL do gerenciador de conexões HTTP que aponta para um arquivo WSDL inclui o parâmetro ?WSDL: por exemplo, http://MyServer/MyWebService/MyPage.asmx?WSDL.

O arquivo WSDL deve estar disponível localmente para configurar a tarefa Serviço da Web usando a caixa de diálogo Editor da Tarefa Serviço da Web que o Designer SSIS fornece.

• Se o gerenciador de conexões HTTP apontar para um site da Web, o arquivo WSDL deve ser copiado manualmente em um computador local.

• Se o gerenciador de conexões HTTP apontar para um arquivo WSDL, o arquivo poderá ser baixado de um site para um arquivo local através da tarefa Serviço da Web.

O arquivo WSDL lista os métodos oferecidos pelo serviço da Web, os parâmetros de entrada necessários para os métodos, as respostas que os métodos retornam e como comunicar-se com o serviço da Web.

Se o método utilizar parâmetros de entrada, a tarefa Serviço da Web necessitará de valores de parâmetro. Por exemplo, um método de serviço da Web que recomenda o comprimento dos esquis que você deve comprar com base em sua altura requer que sua altura seja apresentada em um parâmetro de entrada. Os valores de parâmetro podem ser fornecidos por uma cadeia de caracteres definida na tarefa, por variáveis definidas no escopo da tarefa ou por um contêiner pai. Usar variáveis é vantajoso porque elas permitem a atualização dinâmica de valores de parâmetro por meio de configurações de pacote ou scripts. Para obter mais informações, consulte Variáveis do SSIS (Integration Services) e Configurações de pacote.

Muitos métodos de serviço da Web não utilizam parâmetros de entrada. Por exemplo, um método de serviço da Web que busca nomes de presidentes que nasceram no mês atual não exigirá um parâmetro de entrada porque o serviço da Web pode determinar o mês atual localmente.

Os resultados do método de serviço da Web podem ser gravados em uma variável ou em um arquivo. Use o gerenciador de conexões de arquivos para especificar o arquivo ou fornecer o nome da variável na qual os resultados serão gravados. Para obter mais informações, consulte Gerenciador de conexões de arquivos e Variáveis do SSIS (Integration Services).

Mensagens de log personalizadas disponíveis na tarefa Serviço da Web

A tabela a seguir relaciona as entradas de log personalizadas que podem ser habilitadas para a tarefa Serviço da Web. Para obter mais informações, consulte Log do SSIS (Integration Services) e Mensagens personalizadas para log.

Entrada de log	Descrição
WSTaskBegin	A tarefa começou a acessar um serviço da Web.
WSTaskEnd	A tarefa completou um método de serviço Web.
WSTaskInfo	Informações descritivas sobre a tarefa.

Configuração da tarefa Serviço Web

Você pode definir propriedades por meio do SSIS Designer ou programaticamente.

Para obter mais informações sobre as propriedades que podem ser definidas no Designer do SSIS, clique em um dos seguintes tópicos:

• Editor da Tarefa Serviço da Web (página Geral)

• Editor da Tarefa Serviço da Web (página Entrada)

• Editor da Tarefa Serviço da Web (página Saída)

• Página Expressões

Para obter mais informações sobre como definir essas propriedades no SSIS Designer, clique no tópico a seguir:

• Definir as propriedades de uma tarefa ou contêiner

Configuração programática da tarefa Serviço Web

Para obter mais informações sobre como definir essas propriedades de modo programático, clique em um dos tópicos a seguir:

• WebServiceTask

Conteúdo relacionado

Vídeo, Como: Chamar um serviço Web usando a tarefa Serviço da Web (vídeo do SQL Server), no technet.microsoft.com.

Resposta da curadoria, Consumir serviços Web no SSIS usando scripts, em curatedviews.cloudapp. net.

Mantenha-se atualizado com o Integration Services Para obter os downloads, artigos, exemplos e vídeos mais recentes da Microsoft, assim como soluções selecionadas pela comunidade, visite a página do Integration Services no MSDN: Visite a página do Integration Services no MSDN Para receber uma notificação automática dessas atualizações, assine os RSS feeds disponíveis na página.