Configuración de la acción SOAP para el adaptador de SQL

Artículo
07/21/2023

Para realizar cualquier operación en SQL Server mediante el adaptador sql basado en WCF, debe especificar una acción SOAP. La acción SOAP se comunica con el adaptador qué acción se debe realizar. Puede especificar la acción SOAP desde Visual Studio o desde la consola de administración de BizTalk Server. Sin embargo, si especifica la acción SOAP desde ambas ubicaciones, se invalidará la acción que especificó desde Visual Studio.

Para obtener más información sobre cómo especificar la acción SOAP, vea Especificar acciones SOAP para adaptadores de envío de WCF.

Escriba la acción SOAP en Visual Studio.

En Visual Studio, debe especificar la acción SOAP como parte de la orquestación mediante una forma expresión .

En la orquestación de BizTalk, incluya una forma expresión arrastrándola desde el cuadro de herramientas orquestación de BizTalk .
Haga doble clic en la forma Expresión para abrir el Editor de expresiones de BizTalk.
Especifique la acción en el Editor de expresiones de BizTalk. Por ejemplo:
```
OutboundMessage(WCF.Action)="TableOp/Insert/dbo/Employee"  
```
Para obtener más información sobre la forma expresión y el Editor de expresiones de BizTalk, vea Cómo crear expresiones.

Escriba la acción SOAP desde la consola de administración de BizTalk Server

En la consola de administración de BizTalk Server, puede especificar la acción SOAP como parte de la configuración del puerto de WCF-Custom o WCF-SQL.

Escriba una acción SOAP para el puerto de WCF-Custom

Inicie la consola de administración de BizTalk Server.
En el árbol de consola, expanda Grupo de BizTalk y, a continuación, expanda Aplicacionesy, a continuación, haga clic en Enviar puertos. En el panel derecho, puede elegir crear un puerto o seleccionar un puerto existente.
En el cuadro de diálogo propiedades del puerto, en la lista desplegable Tipo , seleccione WCF-Custom y, a continuación, haga clic en Configurar.
En el cuadro de diálogo Propiedades de transporte personalizadas de WCF , haga clic en la pestaña General .
En el cuadro de texto Acción , especifique la acción SOAP para la operación. Puede especificar la acción de las siguientes maneras:
- Mediante el formato de acción única. Use este formato si el puerto WCF-Custom envía y recibe mensajes para una sola operación. Por ejemplo:
```
TableOp/Insert/dbo/Employee  
```
- Mediante el formato de asignación de acciones. Use este formato si un único puerto de WCF-Custom envía y recibe mensajes para más de una operación. Por ejemplo, si un único puerto de WCF-Custom envía y recibe mensajes para Op1 (para insertar registros en la tabla Employee) y Op2 (para actualizar registros en la tabla Employee), la acción SOAP se puede especificar de la siguiente manera:
```
<BtsActionMapping>  
  <Operation Name="Op1" Action="TableOp/Insert/dbo/Employee" />  
  <Operation Name="Op2" Action="TableOp/Update/dbo/Employee" />  
</BtsActionMapping>  
```
  El enfoque de asignación de acciones proporciona mayor flexibilidad en cuanto a especificar un conjunto de acciones y, por tanto, permitir que los mensajes que pertenecen a diferentes tipos de acción fluyan a través del mismo puerto.
  
  El formato de la acción SOAP es diferente para cada operación. Para obtener más información sobre el formato de acción para cada operación, vea Mensajes y esquemas de mensajes.

Escriba una acción SOAP para el puerto WCF-SQL.

Inicie la consola de administración de BizTalk Server.
Agregue el adaptador WCF-SQL a la consola de administración de BizTalk Server. Para obtener instrucciones, consulte Adición del adaptador de SQL a BizTalk Server Consola de administración.
En el árbol de consola, expanda Grupo de BizTalk y, a continuación, expanda Aplicacionesy, a continuación, haga clic en Enviar puertos. En el panel derecho, puede elegir crear un puerto o seleccionar un puerto existente.
En el cuadro de diálogo propiedades del puerto, en la lista desplegable Tipo , seleccione el adaptador WCF-SQL que agregó anteriormente y, a continuación, haga clic en Configurar.
En el cuadro de diálogo propiedades de transporte, haga clic en la pestaña General .
En el cuadro de texto Acción , especifique la acción SOAP para la operación. Puede especificar la acción de las siguientes maneras:
- Mediante el formato de acción única. Use este formato si el puerto WCF-SQL envía y recibe mensajes para una sola operación. Por ejemplo:
```
TableOp/Insert/dbo/Employee  
```
- Mediante el formato de asignación de acciones. Use este formato si un único puerto WCF-SQL envía y recibe mensajes para más de una operación. Por ejemplo, si un único puerto WCF-SQL envía y recibe mensajes para Op1 (para insertar registros en la tabla Employee) y Op2 (para actualizar registros en la tabla Employee), la acción SOAP se puede especificar de la siguiente manera:
```
<BtsActionMapping>  
  <Operation Name="Op1" Action="TableOp/Insert/dbo/Employee" />  
  <Operation Name="Op2" Action="TableOp/Update/dbo/Employee" />  
</BtsActionMapping>  
```
  El enfoque de asignación de acciones proporciona mayor flexibilidad en cuanto a especificar un conjunto de acciones y, por tanto, permitir que los mensajes que pertenecen a diferentes tipos de acción fluyan a través del mismo puerto.
  
  El formato de la acción SOAP es diferente para cada operación. Para obtener más información sobre el formato de acción para cada operación, vea Mensajes y esquemas de mensajes.

Consulte también

Bloques de creación para desarrollar aplicaciones de BizTalk con el adaptador de SQL

Compartir a través de