Tâche de service Web

La tâche de service Web exécute une méthode de service Web. Vous pouvez utiliser la tâche de service Web pour :

  • Écrire dans une variable les valeurs renvoyées par une méthode de service Web. Vous pouvez par exemple obtenir la température la plus élevée de la journée à partir d'une méthode de service Web, puis utiliser cette valeur pour mettre à jour une variable utilisée dans une expression qui définit une valeur de colonne.

  • Écrire dans un fichier les valeurs renvoyées par une méthode de service Web. Une liste de clients potentiels peut par exemple être enregistrée dans un fichier qui est ensuite utilisé comme source de données dans un package qui nettoie les données avant de les écrire dans une base de données.

La tâche de service Web utilise un gestionnaire de connexions HTTP pour se connecter au service Web. Ce gestionnaire est configuré séparément de la tâche de service Web et est référencé dans la tâche. Le gestionnaire de connexions HTTP spécifie les paramètres proxy du serveur comme l'URL du serveur, les informations d'identification permettant d'accéder au serveur de services Web et la durée du délai d'attente. Pour plus d'informations, consultez Gestionnaire de connexions HTTP.

Important

Le gestionnaire de connexions HTTP prend en charge uniquement l'authentification anonyme et l'authentification de base. Il ne prend pas en charge l'authentification Windows.

Le gestionnaire de connexions HTTP peut pointer vers un site Web ou un fichier WSDL (Web Service Description Language). L'URL du gestionnaire de connexions HTTP qui pointe vers un fichier WSDL contient le paramètre ?WSDL, par exemple http://MyServer/MyWebService/MyPage.asmx?WSDL.

Le fichier WSDL doit être disponible localement pour pouvoir configurer la tâche de service Web à l'aide de la boîte de dialogue Éditeur de tâche de service Web du concepteur SSIS.

  • Si le gestionnaire de connexions HTTP pointe vers un site Web, le fichier WSDL doit être copié manuellement sur un ordinateur local.

  • Si le gestionnaire de connexions HTTP pointe vers un fichier WSDL, ce fichier peut être téléchargé à partir du site Web vers un fichier local par la tâche de service Web.

Le fichier WSDL énumère les méthodes offertes par le service Web, les paramètres d'entrée requis par les méthodes, les réponses renvoyées par les méthodes et la manière de communiquer avec le service Web.

Si la méthode utilise des paramètres d'entrée, la tâche de service Web requiert des valeurs de paramètres. Par exemple, une méthode de service Web qui recommande la longueur des skis que vous devez acheter en fonction de votre taille exige que votre taille soit soumise dans un paramètre d'entrée. Les valeurs de paramètres peuvent être fournies par des chaînes définies dans la tâche ou par des variables définies dans l'étendue de la tâche ou un conteneur parent. L'avantage d'utiliser des variables est de vous permettre de mettre à jour dynamiquement les valeurs de paramètres en utilisant des scripts ou des configurations de package. Pour plus d'informations, consultez Variables Integration Services et Configurations de package.

[!REMARQUE]

La tâche de service Web prend en charge les paramètres des types de données suivants uniquement : les types primitifs tels que les entiers et les chaînes, les tableaux et les séquences de types primitifs, ainsi que les énumérations.

De nombreuses méthodes de service Web n'utilisent pas de paramètres d'entrée. Par exemple, une méthode de service Web qui obtient le nom des présidents dont le mois de naissance correspond au mois en cours ne requiert pas de paramètre d'entrée car le service Web peut déterminer le mois en cours localement.

Les résultats de la méthode de service Web peuvent être écrits dans une variable ou dans un fichier. Vous pouvez utiliser le gestionnaire de connexions de fichiers pour spécifier le fichier ou indiquer le nom de la variable dans laquelle écrire les résultats. Pour plus d'informations, consultez Gestionnaire de connexions de fichiers et Variables Integration Services.

Messages de journalisation personnalisés disponibles dans la tâche de service Web

Le tableau suivant répertorie les entrées de journal personnalisées de la tâche de service Web. Pour plus d'informations, consultez Implémentation de la journalisation dans les packages et Messages personnalisés pour la journalisation.

Entrée du journal

Description

WSTaskBegin

La tâche a commencé à accéder à un service Web.

WSTaskEnd

La tâche a terminé une méthode de service Web.

WSTaskInfo

Fournit des informations détaillées relatives à la tâche.

Configuration de la tâche de service Web

Vous pouvez définir les propriétés par le biais du concepteur SSIS ou par programme.

Pour plus d'informations sur les propriétés définissables dans le concepteur SSIS, cliquez sur l'une des rubriques suivantes :

Pour plus d'informations sur la définition de ces propriétés dans le concepteur SSIS, cliquez sur la rubrique suivante :

Configuration de la tâche de service Web par programme

Pour plus d'informations sur la définition par programme de ces propriétés, cliquez sur l'une des rubriques suivantes :

Icône Integration Services (petite) Rester à jour avec Integration Services

Pour obtenir les derniers téléchargements, articles, exemples et vidéos de Microsoft, ainsi que des solutions sélectionnées par la communauté, visitez la page Integration Services sur MSDN ou TechNet :

Pour recevoir une notification automatique de ces mises à jour, abonnez-vous aux flux RSS disponibles sur la page.