Configurare un'associazione di porte fisiche usando un file di associazione di porte a Oracle Database
Quando si usa il componente aggiuntivo Del progetto BizTalk del servizio adapter per generare metadati per un artefatto di database Oracle, oltre ai file di schema, il componente aggiuntivo Del servizio adapter di utilizzo 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'adapter di database Oracle. 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 progetto BizTalk del servizio Adapter, se non si specifica un valore per una proprietà 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 un file di associazione porta crea sempre una porta di invio o ricezione bidirezionale. Se si vuole creare porte di invio o ricezione unidirezionale, è possibile crearla manualmente seguendo la procedura descritta in Configurare manualmente un'associazione di porte fisiche all'adapter di database Oracle. In alternativa, è possibile seguire le soluzioni alternative documentate in questo argomento per modificare il file di associazione delle porte per creare porte di invio o ricezione unidirezionale.
Di seguito sono riportati alcuni punti chiave che è necessario comprendere rispetto al file di associazione generato dal componente aggiuntivo Del servizio adapter di utilizzo:
I file vengono creati con una convenzione di denominazione specifica. Se sono stati generati metadati per le operazioni in uscita, ovvero inviare messaggi al database Oracle, il nome del file è WcfSendPort_OracleDBBinding_Custom.bindinginfo.xml.
Se sono stati generati metadati per le operazioni in ingresso, ovvero per ricevere messaggi dal database Oracle, il nome del file è WcfReceivePort_OracleDBBinding_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 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 si generano metadati. Ad esempio, se si generano metadati per un'operazione Select nella tabella ACCOUNTACTIVITY, l'azione sulla porta è impostata su
<Operation Name="Select" Action="http://Microsoft.LobServices.OracleDB/2007/03/SCOTT/Table/ACCOUNTACTIVITY/Select" />. 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 logica (nell'orchestrazione BizTalk) e la porta di invio fisica (in BizTalk Server console di amministrazione) siano uguali. In caso contrario, verrà visualizzato un errore durante l'invio di messaggi al database Oracle tramite la porta di invio.È necessario specificare solo le credenziali per la porta da connettere al database Oracle. 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 associazioni 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. È possibile specificare un URI univoco includendo un ID di polling.
Per impostazione predefinita, il file di associazione porta contiene sempre definizioni per porte bidirezionali (invio o ricezione). Quando si importa questo file in un'applicazione BizTalk, crea una porta di trasmissione o ricezione bidirezionale. Tuttavia, potrebbe essere disponibile un'orchestrazione con una porta di trasmissione o ricezione 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 associazioni per apportare le modifiche seguenti:
Per questo Procedere nel modo seguente Per modificare il file di associazioni di porte per configurare una porta di invio unidirezionale - 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">
- 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" />Per modificare il file di associazioni di porte per configurare una porta di ricezione unidirezionale - Nell'estratto seguente modificare il valore della proprietà IsTwoWay su false. Originariamente, questo è impostato su true.
<ReceivePort Name="port_name" IsTwoWay="false" BindingOption="1">
- Commenta i seguenti estratti:
<SendPipeline Name="Microsoft.BizTalk.DefaultPipelines.XMLTransmit" FullyQualifiedName="Microsoft.BizTalk.DefaultPipelines.XMLTransmit, Microsoft.BizTalk.DefaultPipelines, Version=3.0.1.0, Culture=neutral, PublicKeyToken=token" Type="2" TrackingOption="None" Description="" />
<SendPipelineData xsi:nil="true" />
<SendPipelineData xsi:nil="true" />
Configurazione di una porta WCF-OracleDB usando il file di associazione porta generato usando il componente aggiuntivo del servizio adapter
Il componente aggiuntivo Consume Adapter Service crea 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-OracleDB BizTalk nella console di amministrazione di BizTalk Server. Prima di creare WCF-OracleDB porta è 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 è stato aggiunto l'adattatore WCF-OracleDB nella console di amministrazione di BizTalk Server. Ad esempio, se è stato aggiunto l'adattatore WCF-OracleDB come "OracleDBAdapter", sostituire "WCF-Custom" con "OracleDBAdapter".
Cercare l'attributo "ConfigurationClsid" e sostituire il valore esistente dell'attributo con "D7127586-E851-412e-8A8A-2428AEDDC219".
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'adapter di database Oracle.
Vedere anche
Blocchi predefiniti per sviluppare applicazioni BizTalk con il database Oracle