Configurer l’action SOAP pour l’adaptateur SQL

Article
07/21/2023

Pour effectuer une opération sur SQL Server à l’aide de l’adaptateur SQL wcf, vous devez spécifier une action SOAP. L’action SOAP indique à l’adaptateur quelle action doit être effectuée. Vous pouvez spécifier l’action SOAP à partir de Visual Studio ou de la console d’administration BizTalk Server. Toutefois, si vous spécifiez l’action SOAP à partir des deux emplacements, l’action que vous avez spécifiée à partir de Visual Studio sera remplacée.

Pour plus d’informations sur la spécification d’une action SOAP, consultez Spécification d’actions SOAP pour les adaptateurs d’envoi WCF.

Entrez l’action SOAP dans Visual Studio

À partir de Visual Studio, vous devez spécifier l’action SOAP dans le cadre de l’orchestration à l’aide d’une forme Expression .

Dans l’orchestration BizTalk, incluez une forme Expression en la faisant glisser à partir de la boîte à outils Orchestration BizTalk .
Double-cliquez sur la forme Expression pour ouvrir l’Éditeur d’expressions BizTalk.
Spécifiez l’action dans l’éditeur d’expressions BizTalk. Par exemple :
```
OutboundMessage(WCF.Action)="TableOp/Insert/dbo/Employee"  
```
Pour plus d’informations sur la forme Expression et l’Éditeur d’expression BizTalk, consultez How to Create Expressions.

Entrez l’action SOAP à partir de la console Administration BizTalk Server

À partir de la console Administration BizTalk Server, vous pouvez spécifier l’action SOAP dans le cadre de la configuration du port WCF-Custom ou WCF-SQL.

Entrez une action SOAP pour le port WCF-Custom

Démarrez la console Administration BizTalk Server.
Dans l’arborescence de la console, développez BizTalk Group, puis Applications, puis cliquez sur Envoyer des ports. Dans le volet droit, vous pouvez choisir de créer un port ou de sélectionner un port existant.
Dans la boîte de dialogue Propriétés du port, dans la liste déroulante Type , sélectionnez WCF-Custom, puis cliquez sur Configurer.
Dans la boîte de dialogue Propriétés de transport personnalisées WCF , cliquez sur l’onglet Général .
Dans la zone de texte Action , spécifiez l’action SOAP pour l’opération. Vous pouvez spécifier l’action des manières suivantes :
- En utilisant le format d’action unique. Utilisez ce format si le port WCF-Custom envoie et reçoit des messages pour une seule opération. Par exemple :
```
TableOp/Insert/dbo/Employee  
```
- En utilisant le format de mappage d’actions. Utilisez ce format si un port WCF-Custom unique envoie et reçoit des messages pour plusieurs opérations. Par exemple, si un seul port WCF-Custom envoie et reçoit des messages pour Op1 (pour insérer des enregistrements dans la table Employee) et Op2 (pour mettre à jour les enregistrements dans la table Employee), l’action SOAP peut être spécifiée de la manière suivante :
```
<BtsActionMapping>  
  <Operation Name="Op1" Action="TableOp/Insert/dbo/Employee" />  
  <Operation Name="Op2" Action="TableOp/Update/dbo/Employee" />  
</BtsActionMapping>  
```
  L’approche de mappage d’actions offre une plus grande flexibilité en termes de spécification d’un ensemble d’actions, ce qui permet aux messages appartenant à différents types d’actions de passer par le même port.
  
  Le format de l’action SOAP est différent pour chaque opération. Pour plus d’informations sur le format d’action pour chaque opération, consultez Messages et schémas de message.

Entrez une action SOAP pour le port WCF-SQL

Démarrez la console Administration BizTalk Server.
Ajoutez l’adaptateur WCF-SQL à la console Administration BizTalk Server. Pour obtenir des instructions, consultez Ajout de l’adaptateur SQL à BizTalk Server console d’administration.
Dans l’arborescence de la console, développez BizTalk Group, puis Applications, puis cliquez sur Envoyer des ports. Dans le volet droit, vous pouvez choisir de créer un port ou de sélectionner un port existant.
Dans la boîte de dialogue Propriétés du port, dans la liste déroulante Type , sélectionnez l’adaptateur WCF-SQL que vous avez ajouté précédemment, puis cliquez sur Configurer.
Dans la boîte de dialogue Propriétés de transport, cliquez sur l’onglet Général .
Dans la zone de texte Action , spécifiez l’action SOAP pour l’opération. Vous pouvez spécifier l’action des manières suivantes :
- En utilisant le format d’action unique. Utilisez ce format si le port WCF-SQL envoie et reçoit des messages pour une seule opération. Par exemple :
```
TableOp/Insert/dbo/Employee  
```
- En utilisant le format de mappage d’actions. Utilisez ce format si un seul port WCF-SQL envoie et reçoit des messages pour plusieurs opérations. Par exemple, si un seul port WCF-SQL envoie et reçoit des messages pour Op1 (pour insérer des enregistrements dans la table Employee) et Op2 (pour mettre à jour les enregistrements dans la table Employee), l’action SOAP peut être spécifiée de la manière suivante :
```
<BtsActionMapping>  
  <Operation Name="Op1" Action="TableOp/Insert/dbo/Employee" />  
  <Operation Name="Op2" Action="TableOp/Update/dbo/Employee" />  
</BtsActionMapping>  
```
  L’approche de mappage d’actions offre une plus grande flexibilité en termes de spécification d’un ensemble d’actions, ce qui permet aux messages appartenant à différents types d’actions de passer par le même port.
  
  Le format de l’action SOAP est différent pour chaque opération. Pour plus d’informations sur le format d’action pour chaque opération, consultez Messages et schémas de message.

Voir aussi

Blocs de construction pour développer des applications BizTalk avec l’adaptateur SQL

Partage via