Partager via

Créer l’URI de connexion Oracle E-Business Suite

  • Article

L’URI de connexion de l’adaptateur Microsoft BizTalk pour Oracle E-Business Suite contient les propriétés que l’adaptateur utilise pour établir une connexion à Oracle E-Business Suite, et essentiellement la base de données Oracle sous-jacente. L’adaptateur Oracle E-Business prend en charge deux façons de se connecter à la base de données Oracle sous-jacente : à l’aide de tnsnames.ora et sans utiliser tnsnames.ora. Selon le type d’approche de connectivité, le format de l’URI de connexion est également différent. Cette rubrique fournit des informations sur l’URI de connexion Oracle et fournit également des liens vers d’autres rubriques qui expliquent comment spécifier un URI dans différents scénarios de programmation.

Oracle E-Business Suite est une couche d’application qui s’interface avec une base de données Oracle sous-jacente, et qui est catégorisée en différentes applications telles que les services financiers et les ressources humaines, en fonction des différents besoins au sein d’un organization. Chacune de ces applications fournit différents « formulaires » qui permettent aux utilisateurs d’entrer des données dans la base de données Oracle sous-jacente. L’accès à ces formulaires est restreint en associant des utilisateurs à un contexte d’application qui comprend l’ID organization auquel appartient un utilisateur, la « responsabilité » associée à l’utilisateur et le nom de l’application Oracle E-Business Suite que l’utilisateur souhaite appeler. Même si l’adaptateur se connecte directement à la base de données sous-jacente et n’utilise pas de formulaires pour s’interfacer avec Oracle E-Business Suite, la définition du contexte d’application est obligatoire lors de l’exécution d’opérations sur les artefacts Oracle E-Business Suite. Par conséquent, pour vous connecter à la suite Oracle E-Business et à la base de données Oracle sous-jacente, à l’aide de l’adaptateur Oracle E-Business, vous devez :

  • Spécifiez un URI de connexion pour vous connecter à Oracle E-Business Suite et à la base de données Oracle sous-jacente. Lors de l’établissement d’une connexion, vous pouvez choisir de spécifier les informations d’identification pour Oracle E-Business Suite ou la base de données Oracle sous-jacente.

  • Définissez le contexte de l’application pour l’utilisateur. L’adaptateur Oracle E-Business expose certaines propriétés de liaison qui acceptent les informations d’identification et la responsabilité. Pour plus d’informations sur ces propriétés de liaison, consultez En savoir plus sur les propriétés de liaison de l’adaptateur BizTalk pour Oracle E-Business Suite. Pour plus d’informations sur la définition du contexte d’application, consultez Définir le contexte d’application.

    Cette section fournit des informations sur la façon de spécifier l’URI de connexion pour se connecter à la base de données sous-jacente à l’aide de tnsnames.ora et sans utiliser tnsnames.ora. Il fournit également des informations sur l’utilisation de l’URI de connexion pour se connecter à Oracle E-Business Suite.

Se connecter à l’aide de tnsnames.ora

Important

  • Pour cette approche, vous devez ajouter l’entrée de nom de service net dans le fichier tnsnames.ora sur l’ordinateur sur lequel le client de l’adaptateur est installé. Pour plus d’informations sur l’entrée de nom de service net, consultez Configurer le client Oracle pour l’adaptateur E-Business Suite.
    • En raison d’une limitation du client Oracle, le paramètre DataSourceName (nom du service net) dans l’URI de connexion ne peut pas contenir plus de 39 caractères si vous effectuez des opérations dans une transaction. Par conséquent, assurez-vous que la valeur spécifiée pour le paramètre DataSourceName est inférieure ou égale à 39 caractères si vous effectuez des opérations dans une transaction.

L’URI de connexion peut contenir un nom de service Net Oracle utilisé pour identifier le service Oracle E-Business Suite auquel vous souhaitez vous connecter. Le client Oracle résout le nom du service Net Oracle que vous fournissez dans l’URI de connexion aux informations de connexion d’un service Oracle E-Business Suite, selon une hiérarchie des méthodes de nommage Oracle que vous configurez pour l’utiliser. Une méthode de nommage courante est appelée nommage local. En nommage local, le client Oracle utilise un fichier appelé tnsnames.ora pour résoudre le nom du service net Oracle.

Un URI d’adresse de point de terminaison classique dans WCF est représenté comme suit : scheme://userauthparams@hostinfoparams, où :

  • scheme est le nom du schéma.

  • userauthparams est une collection nom-valeur des paramètres requis pour l’authentification de l’utilisateur par le point de terminaison.

  • hostinfoparams est des informations nécessaires pour établir la connexion à l’hôte ; par exemple, un nom de service net.

    L’URI de connexion de l’adaptateur Oracle E-Business respecte ce format de base et est implémenté comme suit :

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

Le tableau suivant décrit les propriétés contenues dans l’URI de connexion.

Propriété URI de connexion Category Description
[USER_NAME] userauthparams Nom d’utilisateur à utiliser pour l’authentification. L’adaptateur Oracle E-Business expose une propriété de liaison ClientCredentialType qui spécifie le type d’informations d’identification du client Oracle que le client spécifie pour établir une connexion. Les valeurs possibles pour la propriété de liaison ClientCredentialType sont Database et EBusiness. En fonction de la valeur de cette propriété de liaison, vous devez spécifier les informations d’identification appropriées. Pour plus d’informations, consultez Informations d’identification Oracle et URI de connexion. Note: Vous devez définir la propriété de liaison AcceptCredentialsInUri sur true pour spécifier le nom d’utilisateur et le mot de passe dans l’URI de connexion. Note: L’adaptateur Oracle E-Business ne conserve pas la casse de la valeur que vous entrez pour le nom d’utilisateur lorsqu’il se connecte à Oracle E-Business Suite. Le nom d’utilisateur est transmis à Oracle E-Business Suite à l’aide des règles standard de SQL*Plus. Toutefois, si vous souhaitez conserver la casse du nom d’utilisateur ou si vous souhaitez entrer un nom d’utilisateur contenant des caractères spéciaux, vous devez spécifier la valeur entre guillemets doubles.
[MOT DE PASSE] userauthparams Mot de passe à utiliser pour l’authentification. L’adaptateur Oracle E-Business expose une propriété de liaison ClientCredentialType qui spécifie le type d’informations d’identification du client Oracle que le client spécifie pour établir une connexion. Si la propriété ClientCredentialType a la valeur Database, les clients doivent spécifier le mot de passe d’un utilisateur de base de données Oracle. Si la propriété ClientCredentialType a la valeur EBusiness, les clients doivent spécifier le mot de passe d’un utilisateur Oracle E-Business Suite. Note: L’adaptateur Oracle E-Business ne conserve pas la casse de la valeur que vous entrez pour le mot de passe lorsqu’il se connecte à Oracle E-Business Suite. Le nom d’utilisateur est transmis à Oracle E-Business Suite à l’aide des règles standard de SQL*Plus. Toutefois, si vous souhaitez conserver la casse du mot de passe ou si vous souhaitez entrer un mot de passe contenant des caractères spéciaux, vous devez spécifier la valeur entre guillemets doubles.
[NET_SERVICE_NAME] hostinfoparams Nom de service net spécifié dans le fichier tnsnames.ora sur l’ordinateur sur lequel l’adaptateur Oracle E-Business est installé. Pour plus d’informations sur les noms de service net et tnsnames.ora, consultez Configurer le client Oracle pour l’adaptateur E-Business Suite.

Se connecter sans utiliser tnsnames.ora

Important

  • Pour cette approche, vous n’avez pas besoin d’avoir l’entrée de nom de service net dans tnsnames.ora. En outre, vous n’avez même pas besoin d’avoir le fichier tnsnames.ora sur l’ordinateur sur lequel le client de l’adaptateur est installé.
    • Ce mode de connectivité n’est pas pris en charge si vous effectuez des opérations dans une transaction. Cela est dû à une limitation du client Oracle.

Un URI d’adresse de point de terminaison classique dans WCF est représenté comme suit : scheme://userauthparams@hostinfoparams, où :

  • scheme est le nom du schéma.

  • userauthparams est une collection nom-valeur des paramètres requis pour l’authentification de l’utilisateur par le point de terminaison.

  • hostinfoparams est des informations nécessaires pour établir la connexion à l’hôte ; par exemple, nom du serveur, numéro de port, etc.

    L’URI de connexion de l’adaptateur Oracle E-Business respecte ce format de base et est implémenté comme suit :

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

Le tableau suivant décrit les propriétés contenues dans l’URI de connexion.

Propriété URI de connexion Category Description
[USER_NAME] userauthparams Nom d’utilisateur à utiliser pour l’authentification. L’adaptateur Oracle E-Business expose une propriété de liaison ClientCredentialType qui spécifie le type d’informations d’identification du client Oracle que le client spécifie pour établir une connexion. Les valeurs possibles pour la propriété de liaison ClientCredentialType sont Database et EBusiness. En fonction de la valeur de cette propriété de liaison, vous devez spécifier les informations d’identification appropriées. Pour plus d’informations, consultez Informations d’identification Oracle et URI de connexion. Note: Vous devez définir la propriété de liaison AcceptCredentialsInUri sur true pour spécifier le nom d’utilisateur et le mot de passe dans l’URI de connexion. Note: L’adaptateur Oracle E-Business ne conserve pas la casse de la valeur que vous entrez pour le nom d’utilisateur lorsqu’il se connecte à Oracle E-Business Suite. Le nom d’utilisateur est transmis à Oracle E-Business Suite à l’aide des règles standard de SQL*Plus. Toutefois, si vous souhaitez conserver la casse du nom d’utilisateur ou si vous souhaitez entrer un nom d’utilisateur contenant des caractères spéciaux, vous devez spécifier la valeur entre guillemets doubles.
[MOT DE PASSE] userauthparams Mot de passe à utiliser pour l’authentification. L’adaptateur Oracle E-Business expose une propriété de liaison ClientCredentialType qui spécifie le type d’informations d’identification du client Oracle que le client spécifie pour établir une connexion. Si la propriété ClientCredentialType a la valeur Database, les clients doivent spécifier le mot de passe d’un utilisateur de base de données Oracle. Si la propriété ClientCredentialType a la valeur EBusiness, les clients doivent spécifier le mot de passe d’un utilisateur Oracle E-Business Suite. Note: L’adaptateur Oracle E-Business ne conserve pas la casse de la valeur que vous entrez pour le mot de passe lorsqu’il se connecte à Oracle E-Business Suite. Le nom d’utilisateur est transmis à Oracle E-Business Suite à l’aide des règles standard de SQL*Plus. Toutefois, si vous souhaitez conserver la casse du mot de passe ou si vous souhaitez entrer un mot de passe contenant des caractères spéciaux, vous devez spécifier la valeur entre guillemets doubles.
[SERVER_NAME] hostinfoparams Nom du serveur sur lequel Oracle E-Business Suite s’exécute. Cette donnée est obligatoire.
[PORT_NUMBER] hostinfoparams Port Oracle Net Listener. Valeur par défaut 1521.
[SERVICE_NAME] hostinfoparams Nom du service de base de données Oracle. Cette donnée est obligatoire.
[SERVICE_TYPE] hostinfoparams Type de service Oracle. Les valeurs possibles sont Dedicated ou Shared. Un service dédié utilise un processus serveur dédié pour servir un seul processus utilisateur. Un service partagé utilise un processus serveur partagé qui peut servir plusieurs processus utilisateur. La valeur par défaut est Dédié.

Informations d’identification Oracle et URI de connexion

Par défaut, l’adaptateur Oracle E-Business lève une exception lorsque les informations d’identification Oracle sont spécifiées dans l’URI de connexion. Cela est dû au fait que ces informations d’identification sont représentées sous forme de texte brut dans l’URI de connexion, ce qui pose un risque pour la sécurité. Vous pouvez définir la propriété de liaison AcceptCredentialsInUri pour contrôler si l’URI de connexion peut contenir des informations d’identification pour la base de données Oracle. Si la propriété AcceptCredentialsInUri a la valeur false, ce qui est la valeur par défaut, l’adaptateur Oracle E-Business lève une exception si l’URI de connexion contient des informations d’identification Oracle ; si la propriété a la valeur true, aucune exception n’est levée.

Important

En raison des risques de sécurité posés par le passage d’informations d’identification dans des chaînes en texte brut, vous devez éviter de spécifier des informations d’identification de connexion à la base de données Oracle dans l’URI de connexion. Pour plus d’informations sur la façon de fournir des informations d’identification plus sécurisées pour la base de données Oracle, consultez Sécuriser vos applications Oracle EBS.

Vous pouvez également choisir de spécifier les informations d’identification de base de données ou les informations d’identification Oracle E-Business Suite pour établir une connexion à Oracle E-Business Suite. L’adaptateur expose trois propriétés de liaison pour activer ce comportement : ClientCredentialType, OracleUserName, OraclePassword.

Les valeurs possibles pour la propriété de liaison ClientCredentialType sont Database et EBusiness.

  • Si la propriété ClientCredentialType est définie sur Base de données, les clients doivent spécifier les informations d’identification de la base de données.

  • Si la propriété ClientCredentialType est définie sur EBusiness, les clients doivent spécifier les informations d’identification Oracle E-Business Suite. Dans ce cas, les clients de l’adaptateur doivent également spécifier les informations d’identification de base de données pour les propriétés de liaison OracleUserName et OraclePassword .

Important

Dans les scénarios où les clients de l’adaptateur spécifient les informations d’identification de base de données pour se connecter à Oracle E-Business Suite en définissant la propriété de liaison ClientCredentialType sur Base de données, mais appellent un artefact Oracle E-Business Suite, les valeurs spécifiées pour les propriétés de liaison OracleUserName et OraclePassword sont utilisées pour définir le contexte de l’application. La définition du contexte d’application est obligatoire pour appeler des artefacts dans Oracle E-Business Suite. Pour plus d’informations sur la définition du contexte d’application, consultez Définir le contexte de l’application.

Utilisation de caractères réservés dans l’URI de connexion

L’adaptateur Oracle E-Business ne prend pas en charge la spécification d’un URI de connexion comportant des caractères spéciaux pour l’une des valeurs de paramètre. Si les valeurs des paramètres de connexion contiennent des caractères spéciaux, veillez à effectuer l’une des opérations suivantes :

  • Si vous spécifiez l’URI dans Visual Studio à l’aide du plug-in Add Adapter Service Reference Plug-in ou Consume Adapter Service Add-in, vous devez le spécifier tel quel sous l’onglet Propriétés de l’URI , c’est-à-dire sans utiliser de caractères d’échappement. Si vous spécifiez l’URI directement dans le champ Configurer un URI et que les paramètres de connexion contiennent des caractères réservés, vous devez spécifier les paramètres de connexion à l’aide des caractères d’échappement appropriés.

  • Si vous spécifiez l’URI lors de la création d’un port d’envoi ou de réception dans BizTalk Server console Administration et que les paramètres de connexion contiennent des caractères réservés, vous devez spécifier les paramètres de connexion à l’aide des caractères d’échappement appropriés.

Utilisation de l’URI de connexion pour se connecter à Oracle E-Business Suite

Voici un exemple d’URI de connexion pour l’adaptateur Oracle E-Business utilisant tnsnames.ora.

oracleebs://ADAPTER

Dans cet exemple, ADAPTER est un nom de service net associé au NOM DU SERVICE et aux informations de connexion pour la base de données Oracle cible dans tnsnames.ora.

Voici un exemple d’URI de connexion pour l’adaptateur Oracle E-Business sans utiliser tnsnames.ora.

oracleebs://yourOracleServer:1521/yourOracleDatabaseServiceName/Dedicated

Dans cet exemple, le nom du serveur est « yourOracleServer » et le nom du service est « yourOracleDatabaseServiceName ».

Pour plus d’informations sur l’établissement d’une connexion à Oracle E-Business Suite lorsque vous :

Voir aussi

Configurer le client Oracle pour l’adaptateur E-Business Suite
Se connecter à Oracle E-Business Suite à l’aide de l’authentification Windows
Créer une connexion à Oracle E-Business Suite