Ricevere messaggi di polling usando istruzioni SELECT con clausola FOR XML da SQL usando BizTalk Server

È possibile configurare l'adapter SQL per ricevere messaggi periodici di modifica dei dati per SQL Server tabelle o viste usando istruzioni SELECT o stored procedure che includono una clausola FOR XML. È possibile specificare queste istruzioni come istruzione di polling eseguita dall'adapter per eseguire il polling del database. L'istruzione di polling può essere un'istruzione SELECT o una stored procedure che restituisce un set di risultati.

Per altre informazioni su come l'adapter supporta il polling, vedere Supporto per il polling. Per informazioni sulla struttura del messaggio SOAP per le operazioni di polling, vedere Schemi dei messaggi per le operazioni di polling e TypedPolling. La clausola SQL FOR XML fornisce altri dettagli.

Nota

Questo argomento illustra come usare l'operazione in ingresso XmlPolling per ricevere messaggi di polling. L'operazione XmlPolling viene usata per eseguire il polling di un database SQL Server usando istruzioni SELECT o stored procedure che includono una clausola FOR XML. Il messaggio per l'operazione XmlPolling include il messaggio xml ricevuto eseguendo l'istruzione SELECT o la stored procedure in SQL Server Management Studio.

È anche possibile usare l'adapter per ricevere diversi tipi di messaggi di polling.

• Se si vuole ottenere un messaggio di polling con tipi deboli, è necessario usare l'operazione di polling. Per altre informazioni, vedere Ricevere messaggi modificati sui dati basati sul polling da SQL Server usando BizTalk Server.
  • Se si vuole ottenere un messaggio di polling fortemente tipizzato, è necessario usare l'operazione TypedPolling . È anche necessario usare l'operazione TypedPolling per avere più operazioni di polling in un'unica applicazione BizTalk. Per istruzioni su come eseguire l'operazione TypedPolling, vedere Ricevere messaggi basati su polling fortemente tipizzato da SQL Server usando BizTalk Server.

Importante

Se si vuole avere più di un'operazione di polling in una singola applicazione BizTalk, è necessario specificare una proprietà di connessione InboundID come parte dell'URI di connessione per renderlo univoco. Con un URI di connessione univoco, è possibile creare più porte di ricezione che esegue il polling dello stesso database o anche la stessa tabella in un database. Per altre informazioni, vedere Ricevere messaggi di polling tra più porte di ricezione da SQL usando BizTalk Server.

Come viene illustrato il polling di questo argomento

In questo argomento, per illustrare come l'adapter SQL supporta la ricezione dei messaggi di modifica dei dati, viene usata un'istruzione SELECT con la clausola FOR XML per eseguire il polling del database SQL Server. Quando si richiama tale istruzione in SQL Server Management Studio, l'output è sotto forma di un messaggio xml. Per usare tali istruzioni per eseguire il polling di un database SQL Server, è necessario disporre dello schema del messaggio xml della risposta. L'adapter SQL richiede che questo schema riceva un messaggio di polling dopo l'esecuzione di un'istruzione SELECT con la clausola FOR XML. Quindi, per usare un'istruzione SELECT con la clausola FOR XML per eseguire il polling del database SQL Server, è necessario eseguire il set di attività seguente.

1. Generare lo schema per il messaggio di risposta XML per l'istruzione SELECT con la clausola FOR XML.

2. Creare un progetto BizTalk e aggiungere lo schema generato al progetto.

3. Creare un messaggio nel progetto BizTalk per ricevere messaggi di risposta XML dal database SQL Server.

4. Creare un'orchestrazione per ricevere messaggi dal database SQL Server e salvarli in una cartella.

5. Compilare e distribuire il progetto BizTalk.

6. Configurare l'applicazione BizTalk creando porte di invio e ricezione fisiche.

   Importante

   Per gli scenari di polling in ingresso è sempre necessario configurare una porta di ricezione unidirezionale WCF-Custom o WCF-SQL. Le porte di ricezione a due vie WCF-Custom o WCF-SQL non sono supportate per le operazioni in ingresso.

7. Avviare l'applicazione BizTalk.

Generazione dello schema per il messaggio di risposta per l'istruzione SELECT

È possibile generare lo schema per il messaggio di risposta per l'istruzione SELECT includendo la clausola con la xmlschemafor xml clausola . In questo argomento viene usata un'istruzione SELECT per recuperare i dettagli dei dipendenti per un ID dipendente specificato. Per recuperare lo schema eseguendo un'istruzione SELECT, l'istruzione SELECT deve essere scritta nel modo seguente:

SELECT Employee_ID ,Name ,Designation FROM Employee for xml auto, xmlschema

Eseguire questa istruzione SELECT per ottenere lo schema per il messaggio di risposta. Salvare lo schema. È ora necessario creare un progetto BizTalk in Visual Studio e aggiungere questo schema al progetto. Per questo esempio, è possibile assegnare un nome a questo schema come PollingResponse.xsd.

Importante

Assicurarsi di rimuovere la clausola dopo aver eseguito l'istruzione xmlschema SELECT per generare lo schema. Se non si esegue questa operazione, quando si esegue finalmente l'istruzione SELECT tramite BizTalk come parte dell'operazione XmlPolling, verrà generato nuovamente lo schema nel messaggio di risposta. Quindi, per ottenere il messaggio di risposta come xml, è necessario rimuovere la xmlschema clausola.

Per aggiungere lo schema a un progetto BizTalk

1. Creare un progetto BizTalk in Visual Studio.

2. Aggiungere lo schema di risposta generato per la stored procedure al progetto BizTalk. Fare clic con il pulsante destro del mouse sul progetto BizTalk nella Esplora soluzioni, scegliere Aggiungi e quindi fare clic su Elemento esistente. Nella finestra di dialogo Aggiungi elemento esistente passare alla posizione in cui è stato salvato lo schema e fare clic su Aggiungi.

3. Aprire lo schema in Visual Studio e apportare le modifiche seguenti.

   1. Aggiungere un nodo allo schema e spostare il nodo radice esistente in questo nodo appena aggiunto. Assegnare un nome al nodo radice. Per questo argomento, rinominare il nodo radice in Root.

   2. Lo schema di risposta generato per l'istruzione SELECT fa riferimento a un sqltypes.xsd. È possibile ottenere lo schema sqltypes.xsd da https://go.microsoft.com/fwlink/?linkid=31850. Aggiungere lo schema sqltypes.xsd al progetto BizTalk. Per altre informazioni su questo schema, passare a:

      • 2.2.5.2 sqlTypes
      • Fare riferimento alla raccolta XML Schema predefinita (sys)

   3. Nello schema generato per l'istruzione SELECT modificare il valore di import schemaLocation nel codice seguente.

      import schemaLocation=”sqltypes.xsd”
      

      Questa operazione viene eseguita perché è già stato aggiunto lo schema sqltypes.xsd al progetto BizTalk.

   4. Specificare uno spazio dei nomi di destinazione per lo schema. Fare clic sul <nodo Schema> e nel riquadro delle proprietà specificare uno spazio dei nomi nella proprietà Spazio dei nomi di destinazione . Per questo argomento, assegnare lo spazio dei nomi come http://ForXmlPolling/namespace.

Definizione di messaggi e tipi di messaggio

Lo schema generato in precedenza descrive i "tipi" necessari per i messaggi nell'orchestrazione. Un messaggio è in genere una variabile, il tipo per cui è definito dallo schema corrispondente. Dopo aver generato lo schema, è necessario collegarlo ai messaggi dalla visualizzazione Orchestrazione del progetto BizTalk.

Per questo argomento, è necessario creare un messaggio per ricevere messaggi dal database SQL Server.

Seguire questa procedura per creare messaggi e collegarli allo schema.

Per creare messaggi e collegare allo schema

1. Aggiungere un'orchestrazione al progetto BizTalk. Nella Esplora soluzioni fare clic con il pulsante destro del mouse sul nome del progetto BizTalk, scegliere Aggiungi e quindi fare clic su Nuovo elemento. Digitare un nome per l'orchestrazione BizTalk e quindi fare clic su Aggiungi.

2. Aprire la finestra della visualizzazione orchestrazione del progetto BizTalk, se non è già aperta. Fare clic su Visualizza, scegliere Altre finestre e quindi fare clic su Visualizzazione orchestrazione.

3. Nella visualizzazione orchestrazione fare clic con il pulsante destro del mouse su Messaggi, quindi scegliere Nuovo messaggio.

4. Fare clic con il pulsante destro del mouse sul messaggio appena creato e quindi selezionare Finestra proprietà.

5. Nel riquadro Proprietà per Message_1 eseguire le operazioni seguenti:

   Usare	Per
   Identificatore	Digitare PollingMessage.
   Tipo di messaggio	Nell'elenco a discesa espandere Schemi e selezionare ForXMLPolling.PollingResponse, dove ForXMLPolling è il nome del progetto BizTalk. PollingResponse è il nome dello schema di risposta generato eseguendo l'istruzione SELECT come descritto in Ricevere messaggi di polling usando istruzioni SELECT con clausola FOR XML da SQL usando BizTalk Server.

Configurazione dell'orchestrazione

È necessario creare un'orchestrazione BizTalk per usare BizTalk Server per ricevere messaggi di modifica dei dati basati sul polling dal database SQL Server. In questa orchestrazione l'adapter riceve la risposta dell'istruzione select specificata per la proprietà di associazione PollingStatement . La risposta per l'istruzione SELECT viene salvata in un percorso FILE. Un'orchestrazione tipica per il polling di un database SQL Server contiene:

• Ricevere e inviare forme per ricevere messaggi da SQL Server e inviare rispettivamente a una porta FILE.

• Porta di ricezione unidirezionale per ricevere messaggi da SQL Server.

  Importante

  Per gli scenari di polling in ingresso è necessario configurare sempre una porta di ricezione unidirezionale. Le porte di ricezione bidirezionale non sono supportate per le operazioni in ingresso.

• Una porta di invio unidirezionale per inviare risposte di polling da un database SQL Server a una cartella.

  Un'orchestrazione di esempio è simile alla seguente.

  

Aggiunta di forme di messaggio

Assicurarsi di specificare le proprietà seguenti per ognuna delle forme del messaggio. I nomi elencati nella colonna Shape sono i nomi delle forme del messaggio visualizzate nell'orchestrazione appena menzionata.

Forma	Tipo di forma	Proprietà
ReceiveMessage	Ricevere	- Impostare nome su ReceiveMessage - Impostare Attiva su True
SaveMessage	Send	- Impostare nome su SaveMessage

Aggiunta di porte

Assicurarsi di specificare le proprietà seguenti per ognuna delle porte logiche. I nomi elencati nella colonna Porta sono i nomi delle porte visualizzate nell'orchestrazione.

Porta	Proprietà
SQLReceivePort	- Impostare identificatore su SQLReceivePort - Impostare tipo su SQLReceivePortType - Impostare il modello di comunicazionesu unidirezionale - Impostare la direzione di comunicazione su Ricezione
SaveMessagePort	- Impostare identificatore su SaveMessagePort - Impostare tipo su SaveMessagePortType - Impostare il modello di comunicazionesu unidirezionale - Impostare la direzione di comunicazione su Invia

Specificare i messaggi per le forme di azione e connettersi alle porte

La tabella seguente specifica le proprietà e i relativi valori che è necessario impostare per specificare i messaggi per le forme di azione e collegare i messaggi alle porte. I nomi elencati nella colonna Shape sono i nomi delle forme del messaggio visualizzate nella orchestrazione menzionata in precedenza.

Forma	Proprietà
ReceiveMessage	- Impostare il messaggio su Ricezione - Impostare l'operazione su SQLReceivePort.XmlPolling.Request
SaveMessage	- Impostare il messaggio su Ricezione - Impostare l'operazione su SaveMessagePort.XmlPolling.Request

Dopo aver specificato queste proprietà, le forme e le porte del messaggio sono connesse e la orchestrazione è stata completata.

È ora necessario compilare la soluzione BizTalk e distribuirla in un BizTalk Server. Per altre informazioni, vedere Creazione e esecuzione di orchestrazioni.

Configurazione dell'applicazione BizTalk

Dopo aver distribuito il progetto BizTalk, l'orchestrazione creata in precedenza è elencata nel riquadro Orchestrazioni nella console di amministrazione di BizTalk Server. È necessario usare la console di amministrazione BizTalk Server per configurare l'applicazione. Per una procedura dettagliata, vedere Procedura dettagliata: Distribuzione di un'applicazione BizTalk di base.

La configurazione di un'applicazione comporta:

• Selezione di un host per l'applicazione.

• Mapping delle porte create nell'orchestrazione alle porte fisiche nella console di amministrazione di BizTalk Server. Per questa orchestrazione è necessario:

  • Definire un percorso sul disco rigido e una porta file corrispondente in cui l'orchestrazione BizTalk rilascia i messaggi dal database SQL Server. Questi messaggi saranno in risposta all'istruzione di polling specificata per la porta di ricezione.

  • Definire una porta di ricezione un WCF-Custom fisico o WCF-SQL unidirezionale. Questa porta esegue il polling del database SQL Server con l'istruzione di polling specificata per la porta. Per informazioni su come creare porte, vedere Configurare manualmente un'associazione di porte fisiche all'adapter SQL. Assicurarsi di specificare le proprietà di associazione seguenti per la porta di ricezione.

    Importante

    Non è necessario eseguire questo passaggio se sono state specificate le proprietà di associazione in fase di progettazione. In tal caso, è possibile creare una porta di ricezione WCF-custom o WCF-SQL, con le proprietà di associazione necessarie impostate, importando il file di associazione creato dal componente aggiuntivo Del servizio adapter di utilizzo. Per altre informazioni, vedere Configurare un'associazione di porte fisiche usando un file di associazione di porte per usare l'adapter SQL.

    Binding, proprietà	Valore
    InboundOperationType	Assicurarsi di impostare questa opzione su XmlPolling.
    PolledDataAvailableStatement	Assicurarsi di specificare un'istruzione SQL. Per questo argomento specificare: SELECT COUNT(*) FROM Employee
    PollingStatement	Assicurarsi di fornire la stessa istruzione, senza la clausola, specificata durante la xmlschema generazione dello schema come descritto in Ricevere messaggi di polling usando istruzioni SELECT con clausola FOR XML da SQL usando BizTalk Server. SELECT Employee_ID ,Name ,Designation FROM Employee for xml auto Nota: Si noti che l'istruzione SELECT non contiene la xmlschema clausola .
    XmlStoredProcedureRootNodeName	Specificare il nome del nodo radice aggiunto allo schema di risposta generato per l'istruzione SELECT, come descritto in Generazione dello schema per l'istruzione SELECT. Per questo argomento impostare questa opzione su Radice.
    XmlStoredProcedureRootNodeNamespace	Specificare lo spazio dei nomi di destinazione per lo schema di risposta generato per l'istruzione SELECT, come descritto in Generazione dello schema per il messaggio di risposta per l'istruzione SELECT. Per questo argomento, impostare questa opzione su http://ForXmlPolling/namespace.

    Per altre informazioni sulle diverse proprietà di associazione, vedere Informazioni sull'adapter BizTalk per SQL Server proprietà di associazione dell'adapter.

    Nota

    È consigliabile configurare il livello di isolamento delle transazioni e il timeout delle transazioni durante l'esecuzione di operazioni in ingresso usando l'adapter SQL. È possibile farlo aggiungendo il comportamento del servizio durante la configurazione della porta di ricezione WCF-Custom o WCF-SQL. Per istruzioni su come aggiungere il comportamento del servizio, vedere Configurare il livello di isolamento delle transazioni e il timeout delle transazioni con SQL.

Avvio dell'applicazione

È necessario avviare l'applicazione BizTalk per ricevere messaggi dal database di SQL Server. Per istruzioni sull'avvio di un'applicazione BizTalk, vedere Come avviare un'orchestrazione.

In questa fase assicurarsi di:

• La porta di ricezione unidirezionale WCF-Custom o WCF-SQL, che esegue il polling del database SQL Server usando le istruzioni specificate per la proprietà di associazione PollingStatement, è in esecuzione.

• La porta di invio FILE, che riceve messaggi da SQL Server, è in esecuzione.

• L'orchestrazione BizTalk per l'operazione è in esecuzione.

Esecuzione dell'operazione

Dopo aver eseguito l'applicazione, il set di azioni seguente viene eseguito nella stessa sequenza:

• L'adapter esegue PolledDataAvailableStatement nella tabella Employee e determina che la tabella contiene record per il polling.

• L'adapter esegue l'istruzione di polling e riceve un messaggio di polling dal database SQL Server. Poiché l'istruzione polling è costituita da un'istruzione SELECT con una clausola FOR XML, il messaggio di polling ricevuto dall'adapter è simile al seguente:

  <?xml version="1.0" encoding="utf-8" ?>
  <Root xmlns="http://ForXmlPolling/namespace">
    <Employee Employee_ID="10765" Name="John" Designation="Tester" xmlns="" />
    <Employee Employee_ID="10766" Name="Sam" Designation="Manager" xmlns="" />
    .....
    .....
  </Root>
  

  Si noti che il messaggio di polling viene ricevuto nello stesso schema generato eseguendo l'istruzione SELECT con la clausola xmlschema . Si noti anche che il nodo radice e lo spazio dei nomi sono gli stessi specificati come valori per le proprietà di associazione XmlStoredProcedureRootNodeNameName e XmlStoredProcedureRootNodeNamespace .

Nota

L'adapter SQL continuerà a eseguire il polling fino a quando non si disabilita in modo esplicito la porta di ricezione dalla console di amministrazione di BizTalk Server.

Procedure consigliate

Dopo aver distribuito e configurato il progetto BizTalk, è possibile esportare le impostazioni di configurazione in un file XML denominato file di associazione. Dopo aver generato un file di associazione, è possibile importare le impostazioni di configurazione dal file, in modo che non sia necessario creare le porte di trasmissione e le porte di ricezione per la stessa orchestrazione. Per altre informazioni sui file di associazione, vedere Riutilizzare le associazioni degli adattatori.

Vedere anche

Eseguire il polling di SQL Server usando l'adapter SQL con BizTalk Server