Tarefa Serviço da Web
A tarefa Serviço da Web executa um método de serviço da 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.
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.
.gif "Observação importante") 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 Integration Services e Configurações de pacote.
.gif "Observação") Observação |
|---|
A tarefa Serviço da Web só dá suporte a parâmetros com os seguintes tipos de dados: tipos primitivos, como inteiros e cadeia de caracteres; matrizes e seqüências de tipos primitivos e enumerações. |
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 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 Implementando logs em pacotes 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 concluiu um método de serviço da Web. |
WSTaskInfo |
Informações descritivas sobre a tarefa. |
Configurando a tarefa Serviço da Web
Você pode definir propriedades pelo Designer SSIS 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:
Para obter mais informações sobre como definir essas propriedades no Designer SSIS, clique no seguinte tópico:
Configurando programaticamente a tarefa Serviço da Web
Para obter mais informações sobre como definir programaticamente essas propriedades, clique em um dos seguintes tópicos:
|
.gif "Ícone do Integration Services (pequeno)")
Fique atualizado com o Integration Services