对并发程序的操作

Oracle E-Business Suite 中的并发程序在 Microsoft BizTalk Adapter for Oracle E-Business Suite 中显示为操作。 除了特定于 Oracle 应用程序的并发程序,Oracle 电子商务适配器还显示以下三个标准操作:Get_Status、Wait_For_Request和Submit_Request。 这意味着,如果 Oracle 应用程序有两个并发程序,则会公开五个操作:每个并发程序一个,三个用于标准操作。

有关以下方面的信息:

重要

必须先在 Oracle 电子商务适配器中为并发程序设置应用程序上下文,然后才能对并发程序执行任何操作。 这是因为设置应用程序上下文可以通过设置用户首选项 ((例如责任、组织和语言设置) 和项目的访问控制)来促进 Oracle 电子商务套件中的安全事务。 有关应用程序上下文以及如何设置它的信息,请参阅设置应用程序上下文集应用程序上下文

以下部分提供有关 Oracle E-Business 适配器为并发程序公开的操作的信息。

<> Concurrent_Program_Name操作

如前所述,Concurrent_Program_Name>操作的数量与 <Oracle 应用程序中的并发程序数相同。 Concurrent_Program_Name<>操作采用五个标准参数:三个是复杂类型,两个是简单类型。

注意

对于不公开其元数据的并发程序,Oracle 电子商务适配器会为每个并发程序公开 100 个可选参数。 若要成功调用这些并发程序,用户必须查阅 Oracle 电子商务套件文档,找出需要值的并发程序的参数,然后指定这些参数。 此类并发程序的一个示例是日记导入 (实际名称:总帐应用程序中的 GLLEZL) 。

复杂类型参数

  • SetOptions:用于在提交请求之前为并发程序设置选项。 SetOptions 采用以下选项作为参数:

    • 隐式:指示是否在 Oracle E-Business Suite 中用户的“并发请求”窗体中显示并发请求。 可以指定以下四个值中的任何一个: “否”、“ ”、“ 错误”“警告”。 指定 “否”会导致请求显示在 Oracle E-Business Suite 中用户的“并发请求”窗体中。 指定 “是 ”意味着只能从系统管理员的特权并发请求窗体中查看请求。 指定 Error 会导致请求仅当请求失败时才会显示在用户的“并发请求”窗体中。 仅当存在警告或错误时,指定 “警告 ”会使请求显示在用户的“并发请求”窗体中。

    • 受保护:指示并发请求是否受到保护,防止使用 Oracle E-Business Suite 中的“并发请求”表单进行更新。 可以指定 “是 (受保护的) ”或“ ” (未受保护的) 。

    • 语言:指示国家/地区语言支持 (NLS) 语言。 如果未指定值,则默认为当前语言。

    • 区域:指示语言区域。 如果未指定值,则默认为当前语言区域。

    • ContinueOnFail:指示并发请求提交是应继续,还是在 SetOptions 失败时引发异常。 可以指定 True (继续) 或 False (引发异常) 。

  • SetPrintOptions:用于在提交请求之前设置并发程序的打印选项。 SetPrintOptions 采用以下选项作为参数:

    • 打印机:指示应将并发请求输出发送到的打印机名称。 如果已在 Oracle E-Business Suite 的“并发计划”窗体中设置此打印选项,则无法替代它。

    • 样式:指示用于打印并发请求输出的打印样式。 例如,可以指定方向 (横向纵向) 。 如果已在 Oracle 电子商务套件的“并发程序”窗体中设置打印样式,并且选中了“需要样式检查框,则无法替代此打印选项。

    • 副本数:指示并发请求输出要打印的副本数。

    • SaveOutput:指示是否保存输出文件。 可以指定“是”或“否”。

    • PrintTogether:仅适用于包含子请求的请求。 指示如何打印子请求的输出。 如果指定 Y,则只有在完成所有子请求后,才会打印子请求的输出。 如果指定 N,则每个子请求的输出将在完成时打印出来。

    • ContinueOnFail:指示在 SetPrintOptions 失败时并发请求提交是继续还是引发异常。 可以指定 True (继续) 或 False (引发异常) 。

  • SetRepeatOptions:用于在提交请求之前为并发程序设置重复选项。 SetRepeatOptions 采用以下选项作为参数:

    • RepeatTime:指示一天中重复并发请求的时间。

    • RepeatInterval:此参数仅在 RepeatTime 为 NULL 时适用。 指示请求重新提交之间的间隔。 将此选项与 RepeatUnit 一起使用,以指定重新提交之间的时间。

    • RepeatUnit:此参数仅在 RepeatTime 为 NULL 时适用。 与 RepeatInterval 一起用于指定请求重新提交之间的时间单位。 可以指定 “分钟”、“ 小时”、“ 天”“月”。

    • RepeatType:仅当 RepeatTime 为 NULL 时,此参数才适用。 指示重复间隔是在并发请求执行的“开始”之后应用,还是在并发请求执行的“结束”之后应用。

    • RepeatEndTime:指示停止重新提交并发请求的日期和时间。

    • ContinueOnFail:指示并发请求提交是在 SetRepeatOptions 的情况下继续提交还是引发异常。 可以指定 True (继续) 或 False (引发异常) 。

    简单类型参数

  • 说明:并发请求的说明。

  • StartTime:指示并发请求应开始运行的时间。

Get_Status操作

标准操作Get_Status返回并发程序的请求阶段/状态和完成消息。 此操作将并发程序的请求 ID (RequestID) 作为输入,然后返回以下信息:

  • 阶段:FND_LOOKUPS的用户友好请求阶段。

  • 状态:来自FND_LOOKUPS的用户友好请求状态。

  • DevPhase:请求阶段,作为可用于程序逻辑比较的字符串。

  • DevStatus:请求状态为字符串,可用于程序逻辑比较。

  • 消息:如果请求已完成,则为完成消息。

Wait_For_Request操作

标准操作Wait_For_Request,等待请求完成,然后返回请求阶段/状态和完成消息。 此操作采用并发程序的请求 ID (RequestID) 、检查 (间隔) 之间等待的秒数,以及等待请求完成的最长时间(以秒为单位), (MaxWait) 作为输入参数,然后返回与Get_Status操作中相同的信息。

Submit_Request操作

标准操作(Submit_Request)提交并发请求,供并发管理器处理。 如果请求成功完成,此操作将返回并发请求 ID。 否则,它将返回“0”。

Submit_Request操作采用六个标准参数:三个是复杂类型简单类型。 除了这些参数之外,它还将并发程序的参数作为字符串数组。

复杂类型参数

Submit_Request操作采用 SetOptionsSetPrintOptionsSetRepeatOptions 作为输入参数。 有关这些参数的信息,请参阅 <本节前面的Concurrent_Program_Name> 操作

简单类型参数

  • Program:应为其提交请求的并发程序的短名称。

  • 说明:并发请求的说明。

  • StartTime:并发请求应开始运行的时间。

另请参阅

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