Configurare un'associazione di porte fisiche usando un file di associazione di porte per usare l'adapter SQL
Quando si usa il componente aggiuntivo Di progetto BizTalk del servizio adapter per generare metadati per un artefatto SQL Server, oltre ai file di schema, il componente aggiuntivo Use Adapter Service genera anche un file di associazione delle porte. È possibile importare questo file di associazione nell'applicazione BizTalk per creare una porta di invio o ricezione fisica. Per istruzioni sull'importazione di file di associazione, vedere Riutilizzare le associazioni dell'adattatore. Se si importa questo file di associazione, non è necessario creare manualmente una porta di invio o ricezione fisica.
Importante
Durante l'uso del componente aggiuntivo Del servizio adapter di utilizzo, se non si specifica un valore per una proprietà di associazione di tipo stringa e il cui valore predefinito è Null, tale proprietà di associazione non sarà disponibile nel file di associazione. È necessario aggiungere manualmente la proprietà di associazione e il relativo valore nel file di associazione, se necessario.
La creazione di una porta usando il file di associazione porta 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 usando la procedura descritta in Configurare manualmente un'associazione di porte fisiche alla scheda SQL. In alternativa, è possibile seguire le soluzioni alternative documentate in questo argomento per modificare il file di associazione delle porte per creare porte di invio unidirezionale.
Nota
Per le operazioni in ingresso, il file di associazione porta creerà sempre una porta di ricezione unidirezionale. Questo perché l'adapter SQL supporta solo la porta di ricezione unidirezionale per le operazioni in ingresso.
Importante
L'uso della Procedura guidata Aggiungi metadati dell'adattatore non crea un file di associazione di porte usando la quale è possibile creare una porta WCF-SQL. Tuttavia, è possibile apportare alcune modifiche al file di associazione delle porte generato dal componente aggiuntivo Utilizzo servizio adapter e usarlo per creare una porta WCF-SQL. Per altre informazioni, vedere Configurazione di una porta WCF-SQL usando il file di associazione di porte generato usando il componente aggiuntivo del servizio adapter di utilizzo.
Di seguito sono riportati alcuni punti chiave che è necessario comprendere rispetto al file di associazione generato dal componente aggiuntivo Del servizio adapter:
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, il tipo di associazione, l'URI dell'endpoint e l'azione di 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 invio viene mappata al nome dell'operazione per cui sono stati generati metadati. Ad esempio, se si generano metadati per l'operazione Inserisci nella tabella Customer, l'azione sulla porta è impostata su
<Operation Name="Insert" Action="TableOp/Insert/dbo/CustomerTable" />. Tuttavia, il nome dell'operazione sulla porta di trasmissione logica creata nell'orchestrazione 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 (in BizTalk Server console di amministrazione) siano uguali. In caso contrario, verrà visualizzato un errore durante l'invio di messaggi a SQL Server tramite la porta di invio.È necessario specificare solo le credenziali per la porta da connettere 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.
Considerazioni chiave 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 in modo sicuro questo messaggio e continuare.
Il file di associazione contiene anche nomi di porte e percorsi di ricezione. Se l'applicazione BizTalk a 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 le posizioni 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 invio bidirezionale. Quando si importa questo file in un'applicazione BizTalk, viene creata una porta di invio bidirezionale. Tuttavia, potrebbe essere disponibile un'orchestrazione con una porta di invio unidirezionale. Quindi, quando si configura tale orchestrazione e si usa la porta creata importando il file di associazione, la porta non è disponibile nell'elenco. Ciò avviene 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 Procedere nel modo seguente Per modificare il file di associazione delle porte per configurare una porta di invio unidirezionale 1. Nell'estratto seguente modificare il valore della proprietà IsTwoWay su false. Originariamente, questo è impostato su true.
<SendPort Name="port_name" IsStatic="true" IsTwoWay="false" BindingOption="0">
2. Commenta 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 porta creerà sempre una porta di ricezione unidirezionale. Questo perché l'adapter SQL supporta solo la porta di ricezione unidirezionale per le operazioni in ingresso.
Configurare una porta WCF-SQL usando il file di associazione porta generato usando il componente aggiuntivo del servizio adapter
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 WCF-SQL BizTalk nella console di amministrazione di BizTalk Server. Prima di creare una porta WCF-SQL, tuttavia, è necessario eseguire le attività seguenti per modificare il file di associazione delle porte.
Aprire il file di associazione delle porte in un editor di testo.
Cercare e sostituire "WCF-Custom" con il nome con cui è stata aggiunta l'adapter WCF-SQL nella console di amministrazione BizTalk Server. Ad esempio, se è stato aggiunto l'adapter WCF-SQL come "SQLAdapter", sostituire "WCF-Custom" con "SQLAdapter".
Cercare l'attributo "ConfigurationClsid" e sostituire il valore esistente dell'attributo con "59B35D03-6A06-4734-A249-EF561254ECF7".
Salvare e chiudere il file di associazione.
Importare il file di associazione nella console di amministrazione BizTalk Server. Per istruzioni su come importare il file di associazione, vedere Riutilizzare le associazioni dell'adattatore.
Vedere anche
Blocchi predefiniti per sviluppare applicazioni BizTalk con l'adapter SQL