设置应用程序上下文

在用于 Oracle E-Business Suite 的 Microsoft BizTalk 适配器中,某些 Oracle 电子商务套件项目(接口表、接口视图、并发程序和请求集 ()必须设置应用程序上下文) 然后才能对这些项目执行的操作。 在设置应用程序上下文之前,Oracle 电子商务适配器不允许对这些项目执行操作。 但是,对于基础 Oracle 数据库中的项目,用户是否要设置应用程序上下文取决于用户。

什么是应用程序上下文

应用程序上下文是一组与 Oracle 电子商务套件中的项目关联的元素,实现项目的用户首选项和访问控制。 应用程序上下文由以下元素组成:

  • 用户名:可以连接到 Oracle 电子商务套件的用户。

  • 责任:责任是 Oracle 电子商务套件中的访问级别,允许用户仅访问适合他们在组织中角色的数据和功能。 责任可以允许访问特定应用程序、操作单元、书籍集以及窗口、函数和其他职责的受限列表。 通过向用户分配责任,可以在 Oracle 电子商务套件中授予/限制用户的访问权限。

  • 组织 ID:Oracle 电子商务套件支持设置多个组织。 这些不同的组织由 Oracle 电子商务套件中表的"Org_ID"列中的值"组织 ID"唯一标识,该列存储有关这些组织的信息。 通过向组织分配责任或显式选择组织,你可以向组织授予/限制用户的访问权限。

    有关 Oracle 电子商务套件中的责任、多个组织和组织 ID 详细信息,请搜索 Oracle 帮助中心

设置应用程序上下文

当 Oracle 电子商务适配器连接到 Oracle 电子商务套件中的基础数据库时,不会在适配器中建立或初始化 Oracle 电子商务套件项目的应用程序上下文。 可以使用以下任一方法在 Oracle 电子商务适配器中初始化或设置这些项目的应用程序上下文:

  • 绑定属性:Oracle 电子商务适配器公开以下绑定属性用于设置应用程序上下文: OracleEBSOrganizationIdOracleUserNameOraclePasswordOracleEBSResponsibilityKeyOracleEBSResponsibilityNameApplicationShortName。 无需为所有这些绑定属性指定值,以设置各种项目的应用程序上下文。 有关设置项目的应用程序上下文所需的绑定属性的信息,请参阅本主题稍后的"各种应用程序设置应用程序上下文Artifacts绑定属性" 。

  • 消息上下文属性:Oracle 电子商务适配器公开以下消息上下文属性用于设置应用程序上下文: ApplicationShortNameOrganizationIDResponsibilityKeyResponsibilityName。 要指定用户名和密码,必须使用绑定属性。 有关如何使用消息上下文属性设置应用程序上下文的信息,请参阅使用消息上下文属性 配置应用程序上下文

重要

OracleEBSResponsibilityKey 绑定属性指定的值将替代 OracleEBSResponsibilityName 绑定属性的值。 同样,为 ResponsibilityKey 消息上下文属性指定的值将替代 为 ResponsibilityName 消息上下文属性指定的值。

绑定属性 (优先级顺序与消息上下文属性)

如果同时使用绑定属性和消息上下文属性设置应用程序上下文,则为消息上下文属性指定的值优先,并重写为绑定属性指定的值。 但是,例如,如果将应用程序短名称指定为消息上下文属性,将其他名称指定为绑定属性,则仅从消息上下文属性中选取应用程序短名称的值,从相关的绑定属性中选取其余值。

应用程序短名称的优先顺序

设置应用程序上下文时,应用程序短名称按以下优先顺序使用 (从高到) :

  • ApplicationShortName 消息上下文属性 中指定的 应用程序短名称。

  • SOAP 操作中指定的应用程序短名称 (接口表、接口视图、并发程序和请求集) 。

  • ApplicationShortName 绑定属性中指定的应用程序短名称。

    但是,对于接口表、接口视图、并发程序和请求集,此优先顺序仅在设置应用程序上下文时适用。 若要标识接口表、接口视图、并发程序和请求集,则使用 SOAP 操作中的应用程序短名称。

    责任键和责任名称的优先顺序

    设置应用程序上下文时,责任键和职责名称按以下优先级顺序 (从高到) :

  • ResponsibilityKey 消息上下文属性中指定的责任键。

  • ResponsibilityName 消息上下文属性中指定的责任名称。

  • OracleEBSResponsibilityKey 绑定属性中指定的责任键。

  • OracleEBSResponsibilityName 绑定属性中指定的责任名称。

提示

为什么要对绑定属性使用消息上下文属性来设置应用程序上下文? 如果使用绑定属性设置应用程序上下文,WCF-Custom Oracle 电子商务适配器的 WCF-Custom 发送端口只能用于为绑定属性指定的特定组织 ID、责任和应用程序。 相反,如果使用消息上下文属性,可以配置"泛型"WCF-Custom发送端口,并设置消息级别的应用程序上下文。

为接口表、接口视图、并发程序和请求集设置应用程序上下文 (是必需的)

必须先设置应用程序上下文,然后才能对 Oracle 电子商务适配器中的接口表、接口视图、并发程序和请求集执行操作。 为此,必须提供绑定属性或消息上下文属性的适当值,如前面指定。

重要

除非为所需的绑定属性或消息上下文属性设置了适当的值,否则无法对接口表、接口视图、并发程序和请求集执行操作。

设置 PL/SQL API、过程、函数、表和视图的应用程序上下文

  • PL/SQL API:Oracle 电子商务适配器公开与 Oracle 数据库以及 Oracle 电子商务套件应用程序关联的 PL/SQL API。 尽管为与 Oracle 数据库关联的 PL/SQL API 设置应用程序上下文是可选的,但必须设置与 Oracle 电子商务套件应用程序关联的 PL/SQL API 的应用程序上下文。

  • 过程和函数:不一定必须设置应用程序上下文,以对 Oracle 数据库中的过程和函数执行操作。

  • 表和视图:不一定必须设置应用程序上下文,以对 Oracle 数据库中的表和视图执行操作。 但是,对于自定义 Oracle E-Business Suite 应用程序,用户可能会或可能不会将基本数据库表注册为接口表。 如果数据库表未注册为接口表,它将与 Oracle 电子商务适配器中的数据库表一起显示。 由于这些表与 Oracle 电子商务应用程序相关联,因此,对于这些表的任何操作,都必须设置应用程序上下文。

    若要为这些项目设置应用程序上下文,必须为绑定属性或消息上下文属性提供适当的值,如前面指定。

设置轮询、ExecuteNonQuery、ExecuteReader、ExecuteScalar 和复合操作的应用程序上下文

除了项目之外,还可以为对这些项目执行的各种操作设置应用程序上下文。

  • 若要设置 Poll 操作的应用程序上下文,只能使用前面指定的绑定属性。 要设置应用程序上下文,必须为绑定属性提供适当的值,这些值适用于执行 Poll 操作的项目。 例如,如果对接口表执行轮询操作,则必须为接口表的绑定属性指定值。

  • 若要为 ExecuteNonQuery、ExecuteReader 和 ExecuteScalar 操作设置应用程序上下文,必须为绑定属性或消息上下文属性提供适当的值,如前面指定。 要设置这些操作的应用程序上下文,必须为绑定属性或消息上下文属性提供适当的值,这些值适用于执行操作的项目。

  • 若要设置复合操作的应用程序上下文,必须为绑定属性或消息上下文属性提供适当的值,如前面指定。 要设置复合操作的应用程序上下文,必须为绑定属性或适用于各个操作的消息上下文属性提供适当的值。 例如,如果复合操作包含两个操作:一个操作针对接口表,另一个针对数据库表,则必须为接口表的绑定属性或消息上下文属性以及数据库表的绑定属性或消息上下文属性指定值。

    重要

    对于所有这些操作,如果在 Oracle 电子商务套件的接口表、接口视图、并发程序或请求集 (中的项目上执行该操作,则必须设置应用程序上下文) 。 如果对基础数据库中的项目执行该操作,则不一定必须设置应用程序上下文。 例如,如果要对接口表执行轮询操作,则必须设置应用程序上下文,而如果对表执行轮询操作,则不一定必须设置应用程序上下文。

设置用于执行操作的语言

Oracle 电子商务适配器支持 Oracle 电子商务套件的多语言支持 (MLS) 功能,并允许在执行操作时指定语言。 适配器公开 MlsSettings绑定属性下的 Language 绑定属性和 Language 消息上下文属性,以指定用于执行操作的语言。

为 Language 消息上下文属性指定的值将替代 MlsSettings 绑定属性下语言绑定属性的值。 有关 MlsSettings 绑定 属性的信息,请参阅 了解适用于 Oracle 电子商务套件的 BizTalk 适配器绑定属性。

用于为各种应用程序设置应用程序上下文的绑定Artifacts

下表提供有关绑定属性的信息,必须指定相应的值来设置各种项目的应用程序上下文:

Artifacts OracleEBSOrganizationId OracleUserName OraclePassword OracleEBSResponsibilityKey

OracleEBSResponsibilityName
ApplicationShortName
接口表和接口视图 √*
并发程序 √*
请求集 √*
PL/SQL api √*
过程和功能 √*
表和视图 √*

√ * = 可选

重要

  • OracleEBSOrganizationId绑定属性的默认值 (可选) 为 null。 如果为 OracleEBSOrganizationId 绑定属性指定一个值,则在设置应用程序上下文时,Oracle 电子商务适配器会将会话 ORG_ID 设置为此值。
    • OracleEBSResponsibilityKey 绑定属性指定的值将覆盖为 OracleEBSResponsibilityName 绑定属性指定的值。

有关这些绑定属性中每个属性的详细信息,请参阅 了解用于 Oracle 电子商务套件的 BizTalk 适配器绑定属性

另请参阅

可以使用适配器执行哪些操作?