Configurare un'associazione di porte fisiche usando un file di associazione di porte a Oracle Database

Quando si usa il componente aggiuntivo Consume Adapter Service BizTalk Project per generare metadati per un artefatto del database Oracle, diverso dai 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 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 trasmissione o ricezione fisica.

Importante

Quando si utilizza il componente aggiuntivo del progetto BizTalk del servizio Consume Adapter, 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 un file di associazione di porte crea sempre porte di trasmissione o ricezione bidirezionali. Se si desidera creare porte di trasmissione 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 descritte in questo argomento per modificare il file di associazione delle porte per creare porte di trasmissione o ricezione unidirezionale.

Di seguito sono riportati alcuni punti chiave che è necessario comprendere per quanto riguarda il file di associazione generato dal componente aggiuntivo Consume Adapter Service:

• 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, 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 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 si generano i metadati. Ad esempio, se vengono generati metadati per un'operazione Seleziona nella tabella ACCOUNTACTIVITY, l'azione sulla porta viene 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 che crei nell'orchestrazione di BizTalk potrebbe non essere lo stesso. È necessario assicurarsi che il nome dell'operazione nella porta logica (nell'orchestrazione BizTalk) e la porta di trasmissione fisica (nella console di amministrazione di BizTalk Server) siano uguali. In caso contrario, si riceverà un errore durante l'invio di messaggi al database Oracle tramite la porta di trasmissione.

• È sufficiente fornire le credenziali per la porta per connettersi al database Oracle. Mentre 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 delle associazioni 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. È possibile specificare un URI univoco includendo un ID di polling.

• Per impostazione predefinita, il file di associazione delle porte contiene sempre definizioni per porte bidirezionali (invio o ricezione). Quando si importa questo file in un'applicazione BizTalk, viene creata una porta di trasmissione o ricezione bidirezionale. Tuttavia, potresti avere un'orchestrazione con una porta di trasmissione o ricezione 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 delle associazioni per apportare le modifiche seguenti:

  Per questo	Fai questo
  Per modificare il file delle associazioni di porte per configurare una porta di trasmissione unidirezionale	- 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"> 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" />
  Per modificare il file delle associazioni di porte per configurare una porta di ricezione unidirezionale	- Nell'estratto seguente modificare il valore della proprietà IsTwoWay in false. Originariamente, questa proprietà è impostata su true. <ReceivePort Name="port_name" IsTwoWay="false" BindingOption="1"> Commentare 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 tramite il file di associazione generato utilizzando il componente aggiuntivo Consume Adapter Service

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. Tuttavia, prima di creare WCF-OracleDB 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-OracleDB nella console di amministrazione di BizTalk Server. Ad esempio, se è stato aggiunto l'adattatore WCF-OracleDB come "OracleDBAdapter", sostituire "WCF-Custom" con "OracleDBAdapter".

3. Cercare l'attributo "ConfigurationClsid" e sostituire il valore esistente dell'attributo con "D7127586-E851-412e-8A8A-2428AEDDC219".

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 dell'adapter di database Oracle.

Vedere anche

Blocchi predefiniti per sviluppare applicazioni BizTalk con Oracle Database