对并发程序的操作
Oracle E-Business Suite 中的并发程序在 Microsoft BizTalk Adapter for Oracle E-Business Suite 中显示为操作。 除了特定于 Oracle 应用程序的并发程序,Oracle 电子商务适配器还显示以下三个标准操作:Get_Status、Wait_For_Request和Submit_Request。 这意味着,如果 Oracle 应用程序有两个并发程序,则会公开五个操作:每个并发程序一个,三个用于标准操作。
有关以下方面的信息:
浏览和搜索并发程序,请参阅 浏览、搜索和获取 Oracle 电子商务运营的元数据。
如何在 Oracle 电子商务适配器中调用并发程序,请参阅使用 BizTalk Server在 Oracle E-Business Suite 中调用并发程序。
重要
必须先在 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操作采用 SetOptions、 SetPrintOptions 和 SetRepeatOptions 作为输入参数。 有关这些参数的信息,请参阅 <本节前面的Concurrent_Program_Name> 操作 。
简单类型参数
Program:应为其提交请求的并发程序的短名称。
说明:并发请求的说明。
StartTime:并发请求应开始运行的时间。