Establecer el contexto de aplicación
En el adaptador de Microsoft BizTalk para Oracle E-Business Suite, el establecimiento del contexto de la aplicación es obligatorio para algunos artefactos de Oracle E-Business Suite (tablas de interfaz, vistas de interfaz, programas simultáneos y conjuntos de solicitudes) antes de poder realizar operaciones en ellos. El adaptador de Oracle E-Business no permite realizar operaciones en estos artefactos hasta que haya establecido el contexto de la aplicación. Sin embargo, en el caso de los artefactos de la base de datos de Oracle subyacente, es el usuario si desea establecer o no el contexto de la aplicación.
¿Qué es el contexto de la aplicación?
El contexto de la aplicación es un conjunto de elementos asociados a un artefacto de Oracle E-Business Suite que implementa preferencias de usuario y control de acceso en el artefacto. El contexto de la aplicación consta de los siguientes elementos:
Nombre de usuario: usuario que puede conectarse a Oracle E-Business Suite.
Responsabilidad: una responsabilidad es un nivel de acceso en Oracle E-Business Suite que permite a los usuarios acceder solo a esos datos y funciones que son adecuados para sus roles en una organización. Las responsabilidades pueden permitir el acceso a una aplicación específica, unidades operativas, conjunto de libros y una lista restringida de ventanas, funciones y otras responsabilidades. En virtud de asignar responsabilidades a un usuario, puede conceder o restringir el acceso del usuario en Oracle E-Business Suite.
Id. de organización: Oracle E-Business Suite admite la configuración de varias organizaciones. Estas diferentes organizaciones se identifican de forma única mediante un valor, Id. de organización, en la columna Org_ID de la tabla de Oracle E-Business Suite que almacena información sobre estas organizaciones. En virtud de asignar una responsabilidad a una organización o seleccionar una organización explícitamente, puede conceder o restringir el acceso de un usuario a una organización.
Para obtener más información sobre la responsabilidad, varias organizaciones y el identificador de organización en Oracle E-Business Suite, busque el Centro de ayuda de Oracle.
Configuración del contexto de la aplicación
A medida que el adaptador de Oracle E-Business se conecta a la base de datos subyacente de Oracle E-Business Suite, el contexto de la aplicación para los artefactos de Oracle E-Business Suite no se establece ni se inicializa en el adaptador. Puede inicializar o establecer el contexto de la aplicación para estos artefactos en el adaptador de Oracle E-Business mediante cualquiera de las siguientes opciones:
Propiedades de enlace: el adaptador de Oracle E-Business expone las siguientes propiedades de enlace para establecer el contexto de la aplicación: OracleEBSOrganizationId, OracleUserName, OraclePassword, OracleEBSResponsibilityKey, OracleEBSResponsibilityName y ApplicationShortName. No es necesario especificar valores para todas estas propiedades de enlace para establecer el contexto de la aplicación para varios artefactos. Para obtener información sobre las propiedades de enlace necesarias para establecer el contexto de la aplicación para un artefacto, vea Propiedades de enlace para establecer contexto de aplicación para varios artefactos más adelante en este tema.
Propiedades de contexto de mensaje: el adaptador de Oracle E-Business expone las siguientes propiedades de contexto de mensaje para establecer el contexto de la aplicación: ApplicationShortName, OrganizationID, ResponsibilityKey y ResponsibilityName. Para especificar el nombre de usuario y la contraseña, debe usar las propiedades de enlace. Para obtener información sobre cómo establecer el contexto de la aplicación mediante propiedades de contexto de mensaje, vea Configurar el contexto de la aplicación mediante propiedades de contexto de mensaje.
Importante
El valor especificado para la propiedad de enlace OracleEBSResponsibilityKey invalida el valor de la propiedad de enlace OracleEBSResponsibilityName . Del mismo modo, el valor especificado para la propiedad de contexto del mensaje ResponsibilityKey invalida el valor especificado para la propiedad de contexto del mensaje ResponsibilityName .
Orden de precedencia (propiedades de enlace frente a propiedades de contexto de mensaje)
Si establece el contexto de la aplicación mediante las propiedades de enlace y las propiedades de contexto de mensaje, los valores especificados para las propiedades de contexto del mensaje tienen prioridad e invalidan los valores especificados para las propiedades de enlace. Pero, por ejemplo, si especifica el nombre corto de la aplicación como una propiedad de contexto de mensaje y los demás como propiedades de enlace, solo se toma el valor del nombre corto de la aplicación de la propiedad de contexto del mensaje y el resto se seleccionan de las propiedades de enlace pertinentes.
Orden de precedencia para el nombre corto de la aplicación
Al establecer el contexto de la aplicación, el nombre corto de la aplicación se usa en el siguiente orden de precedencia (más alto a menor):
Nombre corto de la aplicación especificado en la propiedad de contexto del mensaje ApplicationShortName .
Nombre corto de la aplicación especificado en la acción SOAP (solo para tablas de interfaz, vistas de interfaz, programas simultáneos y conjuntos de solicitudes).
Nombre corto de la aplicación especificado en la propiedad de enlace ApplicationShortName .
Sin embargo, para las tablas de interfaz, las vistas de interfaz, los programas simultáneos y los conjuntos de solicitudes, este orden de precedencia solo se aplica al establecer el contexto de la aplicación. Para identificar las tablas de interfaz, las vistas de interfaz, los programas simultáneos y los conjuntos de solicitudes, se usa el nombre corto de la aplicación en la acción SOAP.
Orden de precedencia para nombre de responsabilidad y clave de responsabilidad
Al establecer el contexto de la aplicación, la clave de responsabilidad y el nombre de responsabilidad se usan en el siguiente orden de precedencia (más alto a menor):
Clave de responsabilidad especificada en la propiedad de contexto del mensaje ResponsibilityKey .
Nombre de responsabilidad especificado en la propiedad de contexto del mensaje ResponsibilityName .
Clave de responsabilidad especificada en la propiedad de enlace OracleEBSResponsibilityKey .
Nombre de responsabilidad especificado en la propiedad de enlace OracleEBSResponsibilityName .
Sugerencia
¿Por qué usar propiedades de contexto de mensaje sobre propiedades de enlace para establecer el contexto de la aplicación? Si establece el contexto de la aplicación mediante propiedades de enlace, el WCF-Custom puerto de envío para el adaptador de Oracle E-Business solo se puede usar para el identificador de organización, la responsabilidad y la aplicación específicos que especificó para las propiedades de enlace. Por el contrario, si usa la propiedad de contexto del mensaje, puede configurar un puerto de envío "genérico" WCF-Custom y establecer el contexto de la aplicación en el nivel de mensaje.
Establecer el contexto de la aplicación para tablas de interfaz, vistas de interfaz, programas simultáneos y conjuntos de solicitudes (obligatorio)
Debe establecer el contexto de la aplicación antes de realizar operaciones en tablas de interfaz, vistas de interfaz, programas simultáneos y conjuntos de solicitudes en el adaptador de Oracle E-Business. Para ello, debe proporcionar los valores adecuados para las propiedades de enlace o las propiedades de contexto del mensaje como se especificó anteriormente.
Importante
No puede realizar operaciones en tablas de interfaz, vistas de interfaz, programas simultáneos y conjuntos de solicitudes a menos que haya establecido los valores adecuados para las propiedades de enlace necesarias o las propiedades de contexto del mensaje.
Establecer el contexto de la aplicación para las API de PL/SQL, procedimientos, funciones, tablas y vistas
API de PL/SQL: el adaptador de Oracle E-Business expone las API de PL/SQL asociadas a la base de datos de Oracle, así como a la aplicación Oracle E-Business Suite. Aunque es opcional establecer el contexto de la aplicación para las API de PL/SQL asociadas a la base de datos de Oracle, es obligatorio establecer el contexto de la aplicación para las API de PL/SQL asociadas a la aplicación Oracle E-Business Suite.
Procedimientos y funciones: no es obligatorio establecer el contexto de la aplicación para realizar operaciones en procedimientos y funciones de la base de datos de Oracle.
Tablas y vistas: no es obligatorio establecer el contexto de la aplicación para realizar operaciones en tablas y vistas de la base de datos de Oracle. Sin embargo, para la aplicación de Oracle E-Business Suite personalizada, los usuarios pueden o no registrar las tablas de base de datos como tablas de interfaz. Si una tabla de base de datos no está registrada como una tabla de interfaz, se mostrará junto con las tablas de base de datos en el adaptador de Oracle E-Business. Dado que estas tablas están asociadas a una aplicación de Oracle E-Business, para cualquier operación de estas tablas debe establecer el contexto de la aplicación.
Para establecer el contexto de la aplicación para estos artefactos, debe proporcionar los valores adecuados para las propiedades de enlace o las propiedades de contexto del mensaje como se especificó anteriormente.
Establecer el contexto de la aplicación para las operaciones poll, ExecuteNonQuery, ExecuteReader, ExecuteScalar y Composite
Además de los artefactos, también puede establecer el contexto de la aplicación para varias operaciones que se realizan en estos artefactos.
Para establecer el contexto de la aplicación para la operación de sondeo, solo puede usar las propiedades de enlace como se especificó anteriormente. Para establecer el contexto de la aplicación, debe proporcionar los valores adecuados para las propiedades de enlace aplicables al artefacto en el que se realiza la operación de sondeo. Por ejemplo, si la operación de sondeo se realiza en una tabla de interfaz, debe especificar valores para las propiedades de enlace de la tabla de interfaz.
Para establecer el contexto de la aplicación para las operaciones ExecuteNonQuery, ExecuteReader y ExecuteScalar, debe proporcionar los valores adecuados para las propiedades de enlace o las propiedades de contexto del mensaje como se especificó anteriormente. Para establecer el contexto de la aplicación para estas operaciones, debe proporcionar los valores adecuados para las propiedades de enlace o las propiedades de contexto del mensaje que son aplicables para el artefacto en el que se realizan las operaciones.
Para establecer el contexto de la aplicación para las operaciones compuestas, debe proporcionar los valores adecuados para las propiedades de enlace o las propiedades de contexto del mensaje como se especificó anteriormente. Para establecer el contexto de la aplicación para las operaciones compuestas, debe proporcionar los valores adecuados para las propiedades de enlace o las propiedades de contexto del mensaje aplicables a las operaciones individuales. Por ejemplo, si una operación compuesta contiene dos operaciones: una en la tabla de interfaz y la otra de la tabla de base de datos, debe especificar valores para las propiedades de enlace o las propiedades de contexto del mensaje para la tabla de interfaz, así como las propiedades de enlace o las propiedades de contexto del mensaje para la tabla de base de datos.
Importante
Para todas estas operaciones, es obligatorio establecer el contexto de la aplicación si la operación se realiza en un artefacto de Oracle E-Business Suite (tabla de interfaz, vista de interfaz, programas simultáneos o conjuntos de solicitudes). Si la operación se realiza en un artefacto de la base de datos subyacente, no es obligatorio establecer el contexto de la aplicación. Por ejemplo, si va a realizar la operación de sondeo en una tabla de interfaz, es obligatorio establecer el contexto de la aplicación, mientras que si la operación de sondeo se realiza en una tabla, no es obligatorio establecer el contexto de la aplicación.
Establecer el idioma para realizar operaciones
El adaptador de Oracle E-Business admite la característica Compatibilidad con varios idiomas (MLS) de Oracle E-Business Suite y permite especificar un idioma mientras realiza operaciones. El adaptador expone la propiedad de enlace Language en la propiedad de enlace MlsSettings y la propiedad de contexto del mensaje language para especificar un idioma para realizar operaciones.
El valor especificado para la propiedad de contexto del mensaje language invalida el valor de la propiedad de enlace Language en la propiedad de enlace MlsSettings . Para obtener más información sobre la propiedad de enlace MlsSettings , vea Read about BizTalk Adapter for Oracle E-Business Suite Binding Properties.
Propiedades de enlace para establecer el contexto de la aplicación para varios artefactos
En la tabla siguiente se proporciona información sobre las propiedades de enlace para las que debe especificar los valores adecuados para establecer el contexto de la aplicación para varios artefactos:
| Artifacts | OracleEBSOrganizationId | OracleUserName | OraclePassword | OracleEBSResponsibilityKey o OracleEBSResponsibilityName |
ApplicationShortName |
|---|---|---|---|---|---|
| Tablas de interfaz y vistas de interfaz | √* | √ | √ | √ | |
| Programas simultáneos | √* | √ | √ | √ | |
| Conjuntos de solicitudes | √* | √ | √ | √ | |
| API de PL/SQL | √* | √ | √ | √ | √ |
| Procedimientos y funciones | √* | √ | √ | √ | √ |
| Tablas y vistas | √* | √ | √ | √ | √ |
√* = Opcional
Importante
- El valor predeterminado de la propiedad de enlace OracleEBSOrganizationId (opcional) es NULL. Si especifica un valor para la propiedad de enlace OracleEBSOrganizationId , el adaptador de Oracle E-Business establece el ORG_ID de la sesión en este valor al establecer el contexto de la aplicación.
- El valor especificado para la propiedad de enlace OracleEBSResponsibilityKey invalida el valor especificado para la propiedad de enlace OracleEBSResponsibilityName .
Para obtener información detallada sobre cada una de estas propiedades de enlace, vea Leer sobre el adaptador de BizTalk para las propiedades de enlace de Oracle E-Business Suite.