Compartir a través de

Creación del URI de conexión de Oracle E-Business Suite

  • Artículo

El adaptador de Microsoft BizTalk para el URI de conexión de Oracle E-Business Suite contiene propiedades que el adaptador usa para establecer una conexión con Oracle E-Business Suite y básicamente la base de datos de Oracle subyacente. El adaptador de Oracle E-Business admite dos formas de conectarse a la base de datos de Oracle subyacente: mediante tnsnames.ora y sin usar tnsnames.ora. En función del tipo de enfoque de conectividad, el formato del URI de conexión también es diferente. En este tema se proporciona información sobre el URI de conexión de Oracle y también se proporcionan vínculos a otros temas que explican cómo especificar un URI en diferentes escenarios de programación.

Oracle E-Business Suite es una capa de aplicación que interactúa con una base de datos de Oracle subyacente y se clasifica en diferentes aplicaciones, como Finanzas y RR. HH., en función de las diferentes necesidades dentro de una organización. Cada una de estas aplicaciones proporciona varios "formularios" que permiten a los usuarios escribir datos en la base de datos de Oracle subyacente. El acceso a estos formularios está restringido asociando usuarios a un contexto de aplicación que comprende el identificador de organización al que pertenece un usuario, la "responsabilidad" asociada al usuario y el nombre de la aplicación oracle E-Business Suite que el usuario quiere invocar. Aunque el adaptador se conecta directamente a la base de datos subyacente y no usa formularios para interactuar con Oracle E-Business Suite, el establecimiento del contexto de la aplicación es obligatorio al realizar operaciones en los artefactos de Oracle E-Business Suite. Por lo tanto, para conectarse al conjunto de aplicaciones de Oracle E-Business y a la base de datos de Oracle subyacente, mediante el adaptador de Oracle E-Business, debe:

  • Especifique un URI de conexión para conectarse a Oracle E-Business Suite y a la base de datos de Oracle subyacente. Al establecer una conexión, puede elegir especificar las credenciales de Oracle E-Business Suite o la base de datos de Oracle subyacente.

  • Establezca el contexto de la aplicación para el usuario. El adaptador de Oracle E-Business expone ciertas propiedades de enlace que aceptan las credenciales y la responsabilidad. Para obtener más información sobre estas propiedades de enlace, vea Leer sobre las propiedades de enlace del adaptador de BizTalk para Oracle E-Business Suite. Para obtener más información sobre cómo establecer el contexto de la aplicación, consulte Establecimiento del contexto de la aplicación.

    En esta sección se proporciona información sobre cómo especificar el URI de conexión para conectarse a la base de datos subyacente mediante tnsnames.ora y sin usar tnsnames.ora. También proporciona información sobre el uso del URI de conexión para conectarse a Oracle E-Business Suite.

Conexión mediante tnsnames.ora

Importante

  • Para este enfoque, debe agregar la entrada del nombre del servicio net en el archivo tnsnames.ora del equipo con el cliente del adaptador instalado. Para obtener información sobre la entrada de nombre del servicio net, consulte Configuración del cliente de Oracle para el adaptador de E-Business Suite.
    • Debido a una limitación de cliente de Oracle, el parámetro DataSourceName (net service name) en el URI de conexión no puede contener más de 39 caracteres si está realizando operaciones en una transacción. Por lo tanto, asegúrese de que el valor especificado para el parámetro DataSourceName sea menor o igual que 39 caracteres si va a realizar operaciones en una transacción.

El URI de conexión puede contener un nombre de servicio net de Oracle que se usa para identificar el servicio Oracle E-Business Suite con el que desea conectarse. El cliente de Oracle resuelve el nombre del servicio net de Oracle que se proporciona en el URI de conexión para la información de conexión de un servicio oracle E-Business Suite, según una jerarquía de métodos de nomenclatura de Oracle que configure para su uso. Un método de nomenclatura común se denomina nomenclatura local. En la nomenclatura local, el cliente de Oracle usa un archivo denominado tnsnames.ora para resolver el nombre del servicio net de Oracle.

Un URI de dirección de punto de conexión típico en WCF se representa como: scheme://userauthparams@hostinfoparams, donde:

  • scheme es el nombre del esquema.

  • userauthparams es una colección de valores de nombre de los parámetros necesarios para la autenticación de usuario por el punto de conexión.

  • hostinfoparams es información necesaria para establecer la conexión con el host; por ejemplo, un nombre de servicio de red.

    El URI de conexión del adaptador de Oracle E-Business se adhiere a este formato básico y se implementa de la siguiente manera:

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

En la tabla siguiente se explican las propiedades contenidas en el URI de conexión.

Propiedad URI de conexión Category Descripción
[USER_NAME] userauthparams Nombre de usuario que se va a usar para la autenticación. El adaptador de Oracle E-Business expone una propiedad de enlace ClientCredentialType que especifica el tipo de credencial de cliente de Oracle que el cliente especifica para establecer una conexión. Los valores posibles para la propiedad de enlace ClientCredentialType son Database y EBusiness. En función del valor de esta propiedad de enlace, debe especificar las credenciales pertinentes. Para más información, consulte Credenciales de Oracle y el URI de conexión. Nota: Debe establecer la propiedad de enlace AcceptCredentialsInUri en true para especificar el nombre de usuario y la contraseña en el URI de conexión. Nota: El adaptador de Oracle E-Business no conserva el caso del valor especificado para el nombre de usuario cuando se conecta a Oracle E-Business Suite. El nombre de usuario se pasa a Oracle E-Business Suite mediante las reglas estándar de SQL*Plus. Sin embargo, si desea conservar el caso del nombre de usuario o si desea escribir un nombre de usuario que contenga caracteres especiales, debe especificar el valor entre comillas dobles.
[CONTRASEÑA] userauthparams Contraseña que se va a usar para la autenticación. El adaptador de Oracle E-Business expone una propiedad de enlace ClientCredentialType que especifica el tipo de credencial de cliente de Oracle que el cliente especifica para establecer una conexión. Si la propiedad ClientCredentialType está establecida en Database, los clientes deben especificar la contraseña de un usuario de base de datos de Oracle. Si la propiedad ClientCredentialType está establecida en EBusiness, los clientes deben especificar la contraseña de un usuario de Oracle E-Business Suite. Nota: El adaptador de Oracle E-Business no conserva el caso del valor especificado para la contraseña cuando se conecta a Oracle E-Business Suite. El nombre de usuario se pasa a Oracle E-Business Suite mediante las reglas estándar de SQL*Plus. Sin embargo, si desea conservar el caso de la contraseña o si desea escribir una contraseña que contenga caracteres especiales, debe especificar el valor entre comillas dobles.
[NET_SERVICE_NAME] hostinfoparams Nombre de servicio de red que se especifica en el archivo tnsnames.ora en el equipo donde está instalado el adaptador de Oracle E-Business. Para obtener información sobre los nombres de servicio net y tnsnames.ora, consulte Configuración del cliente de Oracle para el adaptador de E-Business Suite.

Conexión sin usar tnsnames.ora

Importante

  • Para este enfoque, no necesita tener la entrada de nombre del servicio net en tnsnames.ora. Además, ni siquiera necesita tener el archivo tnsnames.ora en el equipo con el cliente de adaptador instalado.
    • Este modo de conectividad no se admite si está realizando operaciones en una transacción. Esto se debe a una limitación del cliente de Oracle.

Un URI de dirección de punto de conexión típico en WCF se representa como: scheme://userauthparams@hostinfoparams, donde:

  • scheme es el nombre del esquema.

  • userauthparams es una colección de valores de nombre de los parámetros necesarios para la autenticación de usuario por el punto de conexión.

  • hostinfoparams es información necesaria para establecer la conexión con el host; por ejemplo, nombre del servidor, número de puerto, etc.

    El URI de conexión del adaptador de Oracle E-Business se adhiere a este formato básico y se implementa de la siguiente manera:

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

En la tabla siguiente se explican las propiedades contenidas en el URI de conexión.

Propiedad URI de conexión Category Descripción
[USER_NAME] userauthparams Nombre de usuario que se va a usar para la autenticación. El adaptador de Oracle E-Business expone una propiedad de enlace ClientCredentialType que especifica el tipo de credencial de cliente de Oracle que el cliente especifica para establecer una conexión. Los valores posibles para la propiedad de enlace ClientCredentialType son Database y EBusiness. En función del valor de esta propiedad de enlace, debe especificar las credenciales pertinentes. Para más información, consulte Credenciales de Oracle y el URI de conexión. Nota: Debe establecer la propiedad de enlace AcceptCredentialsInUri en true para especificar el nombre de usuario y la contraseña en el URI de conexión. Nota: El adaptador de Oracle E-Business no conserva el caso del valor especificado para el nombre de usuario cuando se conecta a Oracle E-Business Suite. El nombre de usuario se pasa a Oracle E-Business Suite mediante las reglas estándar de SQL*Plus. Sin embargo, si desea conservar el caso del nombre de usuario o si desea escribir un nombre de usuario que contenga caracteres especiales, debe especificar el valor entre comillas dobles.
[CONTRASEÑA] userauthparams Contraseña que se va a usar para la autenticación. El adaptador de Oracle E-Business expone una propiedad de enlace ClientCredentialType que especifica el tipo de credencial de cliente de Oracle que el cliente especifica para establecer una conexión. Si la propiedad ClientCredentialType está establecida en Database, los clientes deben especificar la contraseña de un usuario de base de datos de Oracle. Si la propiedad ClientCredentialType está establecida en EBusiness, los clientes deben especificar la contraseña de un usuario de Oracle E-Business Suite. Nota: El adaptador de Oracle E-Business no conserva el caso del valor especificado para la contraseña cuando se conecta a Oracle E-Business Suite. El nombre de usuario se pasa a Oracle E-Business Suite mediante las reglas estándar de SQL*Plus. Sin embargo, si desea conservar el caso de la contraseña o si desea escribir una contraseña que contenga caracteres especiales, debe especificar el valor entre comillas dobles.
[SERVER_NAME] hostinfoparams Nombre del servidor en el que se ejecuta Oracle E-Business Suite. Esto es necesario.
[PORT_NUMBER] hostinfoparams Puerto del agente de escucha de Oracle Net. Valor predeterminado 1521.
[SERVICE_NAME] hostinfoparams Nombre del servicio de base de datos de Oracle. Esto es necesario.
[SERVICE_TYPE] hostinfoparams Tipo de servicio de Oracle. Los valores posibles son Dedicado o Compartido. Un servicio dedicado usa un proceso de servidor dedicado para atender solo un proceso de usuario. Un servicio compartido usa un proceso de servidor compartido que puede atender varios procesos de usuario. De manera predeterminada es Dedicado.

Credenciales de Oracle y el URI de conexión

De forma predeterminada, el adaptador de Oracle E-Business produce una excepción cuando se especifican las credenciales de Oracle en el URI de conexión. Esto se debe a que estas credenciales se representan como texto sin formato en el URI de conexión y esto supone un riesgo de seguridad. Puede establecer la propiedad de enlace AcceptCredentialsInUri para controlar si el URI de conexión puede contener credenciales para la base de datos de Oracle. Si la propiedad AcceptCredentialsInUri es false, que es el valor predeterminado, el adaptador de Oracle E-Business produce una excepción si el URI de conexión contiene credenciales de Oracle; Si la propiedad es true, no se produce ninguna excepción.

Importante

Debido a los riesgos de seguridad que supone pasar credenciales en cadenas como texto sin formato, debe evitar especificar las credenciales de conexión de base de datos de Oracle en el URI de conexión. Para obtener más información sobre cómo proporcionar credenciales de forma más segura para la base de datos de Oracle, consulte Protección de las aplicaciones de Oracle EBS.

También puede especificar las credenciales de la base de datos o las credenciales de Oracle E-Business Suite para establecer una conexión a Oracle E-Business Suite. El adaptador expone tres propiedades de enlace para habilitar este comportamiento: ClientCredentialType, OracleUserName y OraclePassword.

Los valores posibles para la propiedad de enlace ClientCredentialType son Database y EBusiness.

  • Si la propiedad ClientCredentialType está establecida en Database, los clientes deben especificar las credenciales de la base de datos.

  • Si la propiedad ClientCredentialType está establecida en EBusiness, los clientes deben especificar las credenciales de Oracle E-Business Suite. En este caso, los clientes del adaptador también deben especificar las credenciales de base de datos para las propiedades de enlace OracleUserName y OraclePassword .

Importante

En escenarios en los que los clientes del adaptador especifican las credenciales de base de datos para conectarse a Oracle E-Business Suite estableciendo la propiedad de enlace ClientCredentialType en Database, pero invocan un artefacto de Oracle E-Business Suite, los valores especificados para las propiedades de enlace OracleUserName y OraclePassword se usan para establecer el contexto de la aplicación. Establecer el contexto de la aplicación es obligatorio para invocar artefactos en Oracle E-Business Suite. Para obtener más información sobre cómo establecer el contexto de la aplicación, consulte Establecimiento del contexto de la aplicación.

Uso de caracteres reservados en el URI de conexión

El adaptador de Oracle E-Business no admite la especificación de un URI de conexión que tenga caracteres especiales para ninguno de los valores de parámetro. Si los valores del parámetro de conexión contienen caracteres especiales, asegúrese de realizar una de las siguientes acciones:

  • Si va a especificar el URI en Visual Studio mediante agregar complemento de referencia de servicio de adaptador o consumir complemento de servicio de adaptador, debe especificarlos tal como está en la pestaña Propiedades del URI , es decir, sin usar caracteres de escape. Si especifica el URI directamente en el campo Configurar un URI y los parámetros de conexión contienen caracteres reservados, debe especificar los parámetros de conexión mediante caracteres de escape adecuados.

  • Si va a especificar el URI al crear un puerto de envío o recepción en BizTalk Server consola de administración y los parámetros de conexión contienen caracteres reservados, debe especificar los parámetros de conexión mediante caracteres de escape adecuados.

Uso del URI de conexión para conectarse a Oracle E-Business Suite

A continuación se muestra un ejemplo de un URI de conexión para el adaptador de Oracle E-Business mediante tnsnames.ora.

oracleebs://ADAPTER

En este ejemplo, ADAPTER es un nombre de servicio neto asociado con el NOMBRE DEL SERVICIO y la información de conexión de la base de datos de Oracle de destino en tnsnames.ora.

A continuación se muestra un ejemplo de un URI de conexión para el adaptador de Oracle E-Business sin usar tnsnames.ora.

oracleebs://yourOracleServer:1521/yourOracleDatabaseServiceName/Dedicated

En este ejemplo, el nombre del servidor es "yourOracleServer" y el nombre del servicio es "yourOracleDatabaseServiceName".

Para obtener información sobre cómo establecer una conexión a Oracle E-Business Suite cuando:

Consulte también

Configuración del cliente de Oracle para el adaptador de E-Business Suite
Conexión a Oracle E-Business Suite mediante la autenticación de Windows
Creación de una conexión a Oracle E-Business Suite