Condividi tramite

Creare l'URI di connessione Oracle E-Business Suite

  • Articolo

L'URI di connessione di Microsoft BizTalk per Oracle E-Business Suite contiene proprietà usate dall'adapter per stabilire una connessione a Oracle E-Business Suite e essenzialmente il database Oracle sottostante. L'adapter Oracle E-Business supporta due modi per connettersi al database Oracle sottostante: usando tnsnames.ora e senza usare tnsnames.ora. In base al tipo di approccio di connettività, anche il formato dell'URI di connessione è diverso. Questo argomento fornisce informazioni sull'URI di connessione Oracle e fornisce anche collegamenti ad altri argomenti che illustrano come specificare un URI in scenari di programmazione diversi.

Oracle E-Business Suite è un livello applicazione che si interfaccia con un database Oracle sottostante e viene classificato in applicazioni diverse, ad esempio Financials e HR, in base alle diverse esigenze all'interno di un'organizzazione. Ognuna di queste applicazioni fornisce vari "moduli" che consentono agli utenti di immettere i dati nel database Oracle sottostante. L'accesso a questi moduli è limitato associando gli utenti a un contesto di applicazione che comprende l'ID organizzazione a cui appartiene un utente, la "responsabilità" associata all'utente e il nome dell'applicazione Oracle E-Business Suite che l'utente vuole richiamare. Anche se l'adapter si connette direttamente al database sottostante e non usa moduli per interfacciarsi con Oracle E-Business Suite, l'impostazione del contesto dell'applicazione è obbligatoria quando si eseguono operazioni sugli artefatti di Oracle E-Business Suite. Quindi, per connettersi alla suite Oracle E-Business e al database Oracle sottostante, usando l'adattatore Oracle E-Business, è necessario:

  • Specificare un URI di connessione per connettersi a Oracle E-Business Suite e al database Oracle sottostante. Durante la creazione di una connessione, è possibile scegliere di specificare le credenziali per Oracle E-Business Suite o il database Oracle sottostante.

  • Impostare il contesto dell'applicazione per l'utente. L'adapter Oracle E-Business espone determinate proprietà di associazione che accettano le credenziali e la responsabilità. Per altre informazioni su queste proprietà di associazione, vedere Informazioni sulle proprietà di associazione BizTalk Adapter per Oracle E-Business Suite. Per altre informazioni sull'impostazione del contesto dell'applicazione, vedere Impostare il contesto dell'applicazione.

    Questa sezione fornisce informazioni su come specificare l'URI di connessione per connettersi al database sottostante usando tnsnames.ora e senza usare tnsnames.ora. Fornisce anche informazioni sull'uso dell'URI di connessione per connettersi a Oracle E-Business Suite.

Connettersi con tnsnames.ora

Importante

  • Per questo approccio, è necessario aggiungere la voce del nome del servizio net nel file tnsnames.ora nel computer con il client dell'adapter installato. Per informazioni sulla voce nome servizio net, vedere Configurare il client Oracle per l'adapter E-Business Suite.
    • A causa di una limitazione di Oracle Client, il parametro DataSourceName (nome servizio net) nell'URI di connessione non può contenere più di 39 caratteri se si eseguono operazioni in una transazione. Assicurarsi pertanto che il valore specificato per il parametro DataSourceName sia minore o uguale a 39 caratteri se si eseguiranno operazioni in una transazione.

L'URI di connessione può contenere un nome del servizio Oracle net usato per identificare il servizio Oracle E-Business Suite con cui si vuole connettersi. Il client Oracle risolve il nome del servizio Oracle net fornito nell'URI di connessione alle informazioni di connessione per un servizio Oracle E-Business Suite, in base a una gerarchia di metodi di denominazione Oracle configurati per l'uso. Un metodo di denominazione comune è denominato denominazione locale. Nella denominazione locale, il client Oracle usa un file denominato tnsnames.ora per risolvere il nome del servizio Oracle net.

Un URI di indirizzo endpoint tipico in WCF è rappresentato come: , dove: scheme://userauthparams@hostinfoparams

  • schema è il nome dello schema.

  • userauthparams è una raccolta nome-valore dei parametri necessari per l'autenticazione utente dall'endpoint.

  • hostinfoparams è informazioni necessarie per stabilire la connessione all'host; ad esempio, un nome di servizio net.

    L'URI di connessione della scheda Oracle E-Business rispetta questo formato di base e viene implementato come segue:

oracleebs://User=[USER_NAME];Password=[PASSWORD]@[NET_SERVICE_NAME]

Nella tabella seguente vengono illustrate le proprietà contenute nell'URI di connessione.

Proprietà URI connessione Category Descrizione
[USER_NAME] userauthparams Nome utente da usare per l'autenticazione. L'adapter Oracle E-Business espone una proprietà di associazione ClientCredentialType che specifica il tipo di credenziali client Oracle specificate dal client per stabilire una connessione. I valori possibili per la proprietà di associazione ClientCredentialType sono Database e EBusiness. A seconda del valore per questa proprietà di associazione, è necessario specificare le credenziali pertinenti. Per altre informazioni, vedere Credenziali Oracle e URI di connessione. Nota: È necessario impostare la proprietà di associazione AcceptCredentialsInUri su true per specificare il nome utente e la password nell'URI di connessione. Nota: L'adapter Oracle E-Business non mantiene il caso del valore immesso per il nome utente quando si connette a Oracle E-Business Suite. Il nome utente viene passato a Oracle E-Business Suite usando le regole standard di SQL*Plus. Tuttavia, se si vuole che il caso del nome utente venga mantenuto o se si vuole immettere un nome utente contenente caratteri speciali, è necessario specificare il valore all'interno di virgolette doppie.
[PASSWORD] userauthparams Password da usare per l'autenticazione. L'adapter Oracle E-Business espone una proprietà di associazione ClientCredentialType che specifica il tipo di credenziali client Oracle specificate dal client per stabilire una connessione. Se la proprietà ClientCredentialType è impostata su Database, i client devono specificare la password per un utente del database Oracle. Se la proprietà ClientCredentialType è impostata su EBusiness, i client devono specificare la password per un utente di Oracle E-Business Suite. Nota: L'adapter Oracle E-Business non mantiene il caso del valore immesso per la password quando si connette a Oracle E-Business Suite. Il nome utente viene passato a Oracle E-Business Suite usando le regole standard di SQL*Plus. Tuttavia, se si vuole che la password venga mantenuta o se si vuole immettere una password contenente caratteri speciali, è necessario specificare il valore all'interno di virgolette doppie.
[NET_SERVICE_NAME] hostinfoparams Nome del servizio net specificato nel file tnsnames.ora nel computer in cui è installata la scheda Oracle E-Business. Per informazioni sui nomi di servizio net e tnsnames.ora, vedere Configurare il client Oracle per l'adapter E-Business Suite.

Connettersi senza usare tnsnames.ora

Importante

  • Per questo approccio, non è necessario avere la voce del nome del servizio net nel tnsnames.ora. Inoltre, non è nemmeno necessario avere il file tnsnames.ora nel computer con il client dell'adapter installato.
    • Questa modalità di connettività non è supportata se si eseguono operazioni in una transazione. Questo è dovuto a una limitazione di Oracle Client.

Un URI di indirizzo endpoint tipico in WCF è rappresentato come: , dove: scheme://userauthparams@hostinfoparams

  • schema è il nome dello schema.

  • userauthparams è una raccolta nome-valore dei parametri necessari per l'autenticazione utente dall'endpoint.

  • hostinfoparams è informazioni necessarie per stabilire la connessione all'host; ad esempio, nome del server, numero di porta e così via.

    L'URI di connessione della scheda Oracle E-Business rispetta questo formato di base e viene implementato come segue:

oracleebs://User=[USER_NAME];Password=[PASSWORD]@[SERVER_NAME]:[PORT_NUMBER]/[SERVICE_NAME]/[SERVICE_TYPE]

Nella tabella seguente vengono illustrate le proprietà contenute nell'URI di connessione.

Proprietà URI connessione Category Descrizione
[USER_NAME] userauthparams Nome utente da usare per l'autenticazione. L'adapter Oracle E-Business espone una proprietà di associazione ClientCredentialType che specifica il tipo di credenziali client Oracle specificate dal client per stabilire una connessione. I valori possibili per la proprietà di associazione ClientCredentialType sono Database e EBusiness. A seconda del valore per questa proprietà di associazione, è necessario specificare le credenziali pertinenti. Per altre informazioni, vedere Credenziali Oracle e URI di connessione. Nota: È necessario impostare la proprietà di associazione AcceptCredentialsInUri su true per specificare il nome utente e la password nell'URI di connessione. Nota: L'adapter Oracle E-Business non mantiene il caso del valore immesso per il nome utente quando si connette a Oracle E-Business Suite. Il nome utente viene passato a Oracle E-Business Suite usando le regole standard di SQL*Plus. Tuttavia, se si vuole che il caso del nome utente venga mantenuto o se si vuole immettere un nome utente contenente caratteri speciali, è necessario specificare il valore all'interno di virgolette doppie.
[PASSWORD] userauthparams Password da usare per l'autenticazione. L'adapter Oracle E-Business espone una proprietà di associazione ClientCredentialType che specifica il tipo di credenziali client Oracle specificate dal client per stabilire una connessione. Se la proprietà ClientCredentialType è impostata su Database, i client devono specificare la password per un utente del database Oracle. Se la proprietà ClientCredentialType è impostata su EBusiness, i client devono specificare la password per un utente di Oracle E-Business Suite. Nota: L'adapter Oracle E-Business non mantiene il caso del valore immesso per la password quando si connette a Oracle E-Business Suite. Il nome utente viene passato a Oracle E-Business Suite usando le regole standard di SQL*Plus. Tuttavia, se si vuole che la password venga mantenuta o se si vuole immettere una password contenente caratteri speciali, è necessario specificare il valore all'interno di virgolette doppie.
[SERVER_NAME] hostinfoparams Nome del server in cui è in esecuzione Oracle E-Business Suite. Tale informazione è obbligatoria.
[PORT_NUMBER] hostinfoparams Porta del listener Oracle Net. Valore predefinito 1521.
[SERVICE_NAME] hostinfoparams Nome del servizio di database Oracle. Tale informazione è obbligatoria.
[SERVICE_TYPE] hostinfoparams Tipo di servizio Oracle. I valori possibili sono Dedicated o Shared. Un servizio dedicato usa un processo server dedicato per gestire un solo processo utente. Un servizio condiviso usa un processo server condiviso in grado di gestire più processi utente. L'impostazione predefinita è Dedicated.

Credenziali Oracle e URI di connessione

Per impostazione predefinita, l'adattatore Oracle E-Business genera un'eccezione quando le credenziali Oracle vengono specificate nell'URI di connessione. Ciò è dovuto al fatto che queste credenziali sono rappresentate come testo normale nell'URI di connessione e ciò comporta un rischio per la sicurezza. È possibile impostare la proprietà di associazione AcceptCredentialsInUri per controllare se l'URI di connessione può contenere credenziali per il database Oracle. Se la proprietà AcceptCredentialsInUri è false, ovvero l'impostazione predefinita, l'adapter Oracle E-Business genera un'eccezione se l'URI di connessione contiene credenziali Oracle; se la proprietà è true, non viene generata alcuna eccezione.

Importante

A causa dei rischi per la sicurezza derivanti dal passaggio delle credenziali nelle stringhe come testo normale, è consigliabile evitare di specificare le credenziali di connessione del database Oracle nell'URI di connessione. Per altre informazioni su come fornire in modo più sicuro le credenziali per il database Oracle, vedere Proteggere le applicazioni Oracle EBS.

È anche possibile scegliere di specificare le credenziali del database o le credenziali di Oracle E-Business Suite per stabilire una connessione a Oracle E-Business Suite. L'adapter espone tre proprietà di associazione per abilitare questo comportamento: ClientCredentialType, OracleUserName, OraclePassword.

I valori possibili per la proprietà di associazione ClientCredentialType sono Database ed EBusiness.

  • Se la proprietà ClientCredentialType è impostata su Database, i client devono specificare le credenziali del database.

  • Se la proprietà ClientCredentialType è impostata su EBusiness, i client devono specificare le credenziali di Oracle E-Business Suite. In questo caso, i client dell'adattatore devono specificare anche le credenziali del database per le proprietà di associazione OracleUserName e OraclePassword .

Importante

Negli scenari in cui i client dell'adattatore specificano le credenziali del database per la connessione a Oracle E-Business Suite impostando la proprietà di associazione ClientCredentialType su Database, ma richiamano un artefatto Oracle E-Business Suite, i valori specificati per le proprietà di associazione OracleUserName e OraclePassword vengono usati per impostare il contesto dell'applicazione. L'impostazione del contesto dell'applicazione è obbligatoria per richiamare gli artefatti in Oracle E-Business Suite. Per altre informazioni sull'impostazione del contesto dell'applicazione, vedere Impostare il contesto dell'applicazione.

Uso di caratteri riservati nell'URI di connessione

L'adattatore Oracle E-Business non supporta la specifica di un URI di connessione con caratteri speciali per uno dei valori dei parametri. Se i valori dei parametri di connessione contengono caratteri speciali, assicurarsi di eseguire una delle operazioni seguenti:

  • Se si specifica l'URI in Visual Studio tramite plug-in Add Adapter Service Reference o Consume Adapter Service Add-in , è necessario specificarli così come sono nella scheda Proprietà URI , ovvero senza usare caratteri di escape. Se si specifica l'URI direttamente nel campo Configura un URI e i parametri di connessione contengono caratteri riservati, è necessario specificare i parametri di connessione usando caratteri di escape appropriati.

  • Se si specifica l'URI durante la creazione di una porta di trasmissione o ricezione nella console di amministrazione di BizTalk Server e i parametri di connessione contengono caratteri riservati, è necessario specificare i parametri di connessione usando caratteri di escape appropriati.

Uso dell'URI di connessione per connettersi a Oracle E-Business Suite

Di seguito è riportato un esempio di URI di connessione per la scheda Oracle E-Business usando tnsnames.ora.

oracleebs://ADAPTER

In questo esempio ADAPTER è un nome di servizio net associato al nome del servizio e alle informazioni di connessione per il database Oracle di destinazione in tnsnames.ora.

Di seguito è riportato un esempio di URI di connessione per la scheda Oracle E-Business senza usare tnsnames.ora.

oracleebs://yourOracleServer:1521/yourOracleDatabaseServiceName/Dedicated

In questo esempio il nome del server è "yourOracleServer" e il nome del servizio è "yourOracleDatabaseServiceName".

Per informazioni su come stabilire una connessione a Oracle E-Business Suite quando:

Vedere anche

Configurare il client Oracle per l'adapter E-Business Suite
Connettersi a Oracle E-Business Suite usando l'autenticazione di Windows
Creare una connessione a Oracle E-Business Suite