Configurare un'associazione di porte fisiche usando un file di associazione di porte per l'uso dell'adapter SQL

Quando si usa il componente aggiuntivo Consume Adapter Service BizTalk Project per generare metadati per un artefatto di SQL Server, oltre ai file di schema, il componente aggiuntivo Consume Adapter Service genera anche un file di associazione di porte. È possibile importare questo file di associazione nell'applicazione BizTalk per creare una porta di trasmissione o ricezione fisica. Per istruzioni sull'importazione dei file di associazione, vedere Riutilizzare le associazioni degli adattatori. Se si importa questo file di associazione, non è necessario creare manualmente una porta di trasmissione o ricezione fisica.

Importante

Se si usa il componente aggiuntivo Consume Adapter Service , se non si specifica un valore per una proprietà di associazione di tipo string e il cui valore predefinito è Null, tale proprietà di associazione non sarà disponibile nel file di associazione. Se necessario, è necessario aggiungere manualmente la proprietà di associazione e il relativo valore nel file di associazione.

La creazione di una porta tramite il file di associazione di porte crea sempre una porta di trasmissione bidirezionale o una porta di ricezione unidirezionale. Se si vuole creare una porta di trasmissione unidirezionale, è possibile crearla manualmente seguendo la procedura descritta in Configurare manualmente un'associazione di porte fisiche all'adattatore SQL. In alternativa, è possibile seguire le soluzioni alternative descritte in questo argomento per modificare il file di associazione delle porte per creare porte di trasmissione unidirezionale.

Annotazioni

Per le operazioni in ingresso, il file di associazione delle porte creerà sempre una porta di ricezione unidirezionale. Ciò è dovuto al fatto che l'adapter SQL supporta solo la porta di ricezione unidirezionale per le operazioni in ingresso.

Importante

La procedura guidata per l'aggiunta di metadati dell'adattatore non crea un file di associazione di porte che consente di creare una porta WCF-SQL. Tuttavia, è possibile apportare alcune modifiche al file di associazione delle porte generato dal componente aggiuntivo Consume Adapter Service e usarlo per creare una porta WCF-SQL. Per ulteriori informazioni, vedere Configurazione di una porta WCF-SQL usando il file di binding della porta generato utilizzando il componente aggiuntivo Consume Adapter Service.

Di seguito sono riportati alcuni punti chiave che è necessario comprendere riguardo il file di associazione generato dal componente aggiuntivo del servizio di adattatore di consumo.

• I file vengono creati con una convenzione di denominazione specifica. Se sono stati generati metadati per le operazioni in uscita, ovvero per inviare messaggi a SQL Server, il nome del file è WcfSendPort_SqlAdapterBinding_Custom.bindinginfo.xml.

  Se sono stati generati metadati per le operazioni in ingresso, ovvero per ricevere messaggi da SQL Server, il nome del file è WcfReceivePort_SqlAdapterBinding_Custom.bindinginfo.xml.

• Il file contiene informazioni sulla configurazione dell'associazione, sul tipo di associazione, sull'URI dell'endpoint e sull'azione della porta in base alle operazioni per cui sono stati generati i metadati. Quando si importa questo file di associazione nell'applicazione BizTalk per creare una porta, tutte le informazioni pertinenti necessarie per configurare una porta fisica vengono impostate automaticamente sulla porta.

  Importante

  Per impostazione predefinita, l'azione sulla porta di trasmissione viene mappata al nome dell'operazione per cui sono stati generati i metadati. Ad esempio, se si generano metadati per l'operazione di inserimento nella tabella Cliente, l'azione sulla porta è impostata su <Operation Name="Insert" Action="TableOp/Insert/dbo/CustomerTable" />. Tuttavia, il nome dell'operazione sulla porta di trasmissione logica che crei nell'orchestrazione di BizTalk potrebbe non essere lo stesso. È necessario assicurarsi che il nome dell'operazione nella porta di trasmissione logica (nell'orchestrazione BizTalk) e la porta di trasmissione fisica (nella console di amministrazione di BizTalk Server) siano uguali. In caso contrario, verrà visualizzato un errore durante l'invio di messaggi a SQL Server tramite la porta di trasmissione.

• È sufficiente specificare le credenziali per la porta per la connessione a SQL Server. Anche se il file di associazione mantiene il nome utente con cui connettersi, per motivi di sicurezza il file di associazione non contiene la password.

Aspetti fondamentali per l'uso del file di associazione delle porte

• Quando si importa il file di associazione, è possibile che venga visualizzato un messaggio di dialogo che informa che il nome dell'applicazione BizTalk nel file di associazione non corrisponde al nome dell'applicazione a cui si sta importando il file di associazione. È possibile ignorare questo messaggio e continuare in modo sicuro.

• Il file di binding contiene anche i nomi delle porte e delle posizioni di ricezione. Se l'applicazione BizTalk in cui si importa il file di associazione crea una porta o un percorso di ricezione con lo stesso nome di una porta già esistente nella stessa applicazione BizTalk, verrà visualizzato un errore. È necessario modificare manualmente il file di associazione per specificare un nome univoco per le porte o i percorsi di ricezione.

• Il file di associazione contiene anche informazioni sull'URI di connessione. Se il file di associazione crea un percorso di ricezione con lo stesso URI di ricezione di un percorso di ricezione già esistente nella stessa applicazione BizTalk, verrà visualizzato un errore. È necessario modificare manualmente il file di associazione per specificare un URI univoco.

• Per impostazione predefinita, il file di associazione delle porte per le operazioni in uscita contiene sempre definizioni per una porta di trasmissione bidirezionale. Quando si importa questo file in un'applicazione BizTalk, viene creata una porta di trasmissione bidirezionale. Tuttavia, potresti avere un'orchestrazione con una porta di trasmissione unidirezionale. Pertanto, quando si configura tale orchestrazione e si usa la porta creata importando il file di associazione, la porta non è disponibile nell'elenco. Ciò si verifica perché la porta logica creata come parte dell'orchestrazione è una porta unidirezionale mentre la porta fisica creata nell'orchestrazione è una porta bidirezionale. In questi casi, è possibile modificare il file di associazione per apportare le modifiche seguenti:

  Per questo

  Fai questo

  Per modificare il file di associazione delle porte per configurare una porta di trasmissione unidirezionale

  1. Nell'estratto seguente modificare il valore della proprietà IsTwoWay in false. Originariamente, questa proprietà è impostata su true. <SendPort Name="port_name" IsStatic="true" IsTwoWay="false" BindingOption="0"> 2. Commentare i seguenti estratti: <ReceivePipeline Name="Microsoft.BizTalk.DefaultPipelines.XMLReceive" FullyQualifiedName="Microsoft.BizTalk.DefaultPipelines.XMLReceive, Microsoft.BizTalk.DefaultPipelines, Version=3.0.1.0, Culture=neutral, PublicKeyToken=token" Type="1" TrackingOption="None" Description=""/> <ReceivePipelineData xsi:nil="true" />

  Importante

  Per le operazioni in ingresso, il file di associazione delle porte creerà sempre una porta di ricezione unidirezionale. Ciò è dovuto al fatto che l'adapter SQL supporta solo la porta di ricezione unidirezionale per le operazioni in ingresso.

Configurare una porta WCF-SQL utilizzando il file di associazione generato tramite l'add-in Consume Adapter Service

Il componente aggiuntivo Consume Adapter Service crea anche un file di associazione di porte che è possibile importare nella console di amministrazione di BizTalk Server. È possibile usare lo stesso file di associazione di porte per creare anche la porta di WCF-SQL BizTalk nella console di amministrazione di BizTalk Server. Tuttavia, prima di creare WCF-SQL porta è necessario eseguire le attività seguenti per modificare il file di associazione delle porte.

1. Aprire il file di associazione delle porte in un editor di testo.

2. Cercare e sostituire "WCF-Custom" con il nome con cui è stato aggiunto l'adattatore WCF-SQL nella console di amministrazione di BizTalk Server. Ad esempio, se è stato aggiunto l'adapter WCF-SQL come "SQLAdapter", sostituire "WCF-Custom" con "SQLAdapter".

3. Cercare l'attributo "ConfigurationClsid" e sostituire il valore esistente dell'attributo con "59B35D03-6A06-4734-A249-EF561254ECF7".

4. Salvare e chiudere il file di associazione.

5. Importare il file di associazione nella console di amministrazione di BizTalk Server. Per istruzioni su come importare il file di associazione, vedere Riutilizzare le associazioni degli adattatori.

Vedere anche

Blocchi predefiniti per sviluppare applicazioni BizTalk con l'adapter SQL