Configurare l'azione SOAP per l'adapter SQL

Articolo
10/14/2023

Per eseguire qualsiasi operazione su SQL Server utilizzando l'adapter SQL basato su WCF, è necessario specificare un'azione SOAP. L'azione SOAP comunica all'adattatore quale azione deve essere eseguita. È possibile specificare l'azione SOAP da Visual Studio o dalla console di amministrazione di BizTalk Server. Tuttavia, se si specifica l'azione SOAP da entrambe le posizioni, l'azione specificata da Visual Studio verrà sostituita.

Per altre informazioni sulla specifica dell'azione SOAP, vedere Specifica di azioni SOAP per gli adapter di trasmissione WCF.

Immettere l'azione SOAP in Visual Studio

Da Visual Studio è necessario specificare l'azione SOAP come parte dell'orchestrazione usando una forma Espressione .

Nell'orchestrazione BizTalk includere una forma Espressione trascinandola dalla casella degli strumenti di Orchestrazione BizTalk .
Fare doppio clic sulla forma Espressione per aprire l'Editor espressioni BizTalk.
Specificare l'azione in Editor espressioni BizTalk. Ad esempio:
```
OutboundMessage(WCF.Action)="TableOp/Insert/dbo/Employee"  
```
Per altre informazioni sulla forma espressione e sull'editor di espressioni BizTalk, vedere How to Create Expressions.For more information about the Expression shape and BizTalk Expression Editor, see How to Create Expressions.

Immettere l'azione SOAP dalla console di amministrazione di BizTalk Server

Dalla console di amministrazione di BizTalk Server è possibile specificare l'azione SOAP come parte della configurazione della porta WCF-Custom o WCF-SQL.

Immettere un'azione SOAP per la porta WCF-Custom

Avviare la console di amministrazione di BizTalk Server.
Nell'albero della console espandere Gruppo BizTalk, quindi Applicazioni, quindi fare clic su Porte di trasmissione. Nel riquadro destro è possibile scegliere di creare una porta o selezionare una porta esistente.
Nell'elenco a discesa Tipo della finestra di dialogo Proprietà porta selezionare WCF-Custom e quindi fare clic su Configura.
Nella finestra di dialogo Proprietà trasporto personalizzato WCF fare clic sulla scheda Generale .
Nella casella di testo Azione specificare l'azione SOAP per l'operazione. È possibile specificare l'azione nei modi seguenti:
- Usando il formato di azione singola. Utilizzare questo formato se la porta WCF-Custom invia e riceve messaggi per una singola operazione. Ad esempio:
```
TableOp/Insert/dbo/Employee  
```
- Usando il formato di mapping delle azioni. Utilizzare questo formato se una singola porta WCF-Custom invia e riceve messaggi per più operazioni. Ad esempio, se una singola porta WCF-Custom invia e riceve messaggi per Op1 (per inserire record nella tabella Employee) e Op2 (per aggiornare i record nella tabella Employee), l'azione SOAP può essere specificata nel modo seguente:
```
<BtsActionMapping>  
  <Operation Name="Op1" Action="TableOp/Insert/dbo/Employee" />  
  <Operation Name="Op2" Action="TableOp/Update/dbo/Employee" />  
</BtsActionMapping>  
```
  L'approccio di mapping delle azioni offre maggiore flessibilità in termini di specificare un set di azioni e quindi consentire ai messaggi appartenenti a tipi di azioni diversi di passare attraverso la stessa porta.
  
  Il formato per l'azione SOAP è diverso per ogni operazione. Per altre informazioni sul formato di azione per ogni operazione, vedere Schemi di messaggi e messaggi.

Immettere un'azione SOAP per la porta WCF-SQL

Avviare la console di amministrazione di BizTalk Server.
Aggiungere l'adapter WCF-SQL alla console di amministrazione di BizTalk Server. Per istruzioni, vedere Aggiunta dell'adapter SQL a BizTalk Server Console di amministrazione.
Nell'albero della console espandere Gruppo BizTalk, quindi Applicazioni, quindi fare clic su Porte di trasmissione. Nel riquadro destro è possibile scegliere di creare una porta o selezionare una porta esistente.
Nell'elenco a discesa Tipo della finestra di dialogo proprietà porta selezionare l'adapter WCF-SQL aggiunto in precedenza e quindi fare clic su Configura.
Nella finestra di dialogo Proprietà trasporto fare clic sulla scheda Generale .
Nella casella di testo Azione specificare l'azione SOAP per l'operazione. È possibile specificare l'azione nei modi seguenti:
- Usando il formato di azione singola. Utilizzare questo formato se la porta WCF-SQL invia e riceve messaggi per una singola operazione. Ad esempio:
```
TableOp/Insert/dbo/Employee  
```
- Usando il formato di mapping delle azioni. Utilizzare questo formato se una singola porta WCF-SQL invia e riceve messaggi per più operazioni. Ad esempio, se una singola porta WCF-SQL invia e riceve messaggi per Op1 (per inserire record nella tabella Employee) e Op2 (per aggiornare i record nella tabella Employee), l'azione SOAP può essere specificata nel modo seguente:
```
<BtsActionMapping>  
  <Operation Name="Op1" Action="TableOp/Insert/dbo/Employee" />  
  <Operation Name="Op2" Action="TableOp/Update/dbo/Employee" />  
</BtsActionMapping>  
```
  L'approccio di mapping delle azioni offre maggiore flessibilità in termini di specificare un set di azioni e quindi consentire ai messaggi appartenenti a tipi di azioni diversi di passare attraverso la stessa porta.
  
  Il formato per l'azione SOAP è diverso per ogni operazione. Per altre informazioni sul formato di azione per ogni operazione, vedere Schemi di messaggi e messaggi.

Vedere anche

Blocchi predefiniti per sviluppare applicazioni BizTalk con l'adapter SQL

Condividi tramite