为 Web 服务提示定义字段
添加、更新或删除将在 Web 服务提示上可用的每个 Web 服务的字段。
可用的字段即与在 “Web 服务提示”表单的 “Web 服务”页上定义的 Web 服务相关的字段。
此表单没有为显示的字段标签定义语言翻译的功能。执行提示时,字段标签将显示为在“字段”表单中为选定 Web 服务提示所输入的字段标签。若要以多种语言显示提示,必须为每一种语言创建单独的 Web 服务提示。
用户自定义字段可用于 Web 服务提示。对于插入/更新 Web 服务的所有操作类型,这些字段在对应 Web 服务下显示所有字段的列表。这些用户自定义字段继承关联参考表单的属性。在“屏幕设计器”模式下用鼠标右键单击以定义用户定义字段的选项。在网格中突出显示用户定义字段时,系统将保护“字段类型”和“查询代码”。此信息在与 Web 服务关联的基本屏幕上定义。
当控制组织不可用时,查找实体用户定义字段会显示用户组织列表中的所有组织的记录。如果控制组织和用户定义字段发生冲突,则无法提交记录。
- 选择“管理”>“Web 服务提示引擎”>“Web 服务提示”。
- 选择要为 Web 服务定义字段的 Web 服务提示,然后单击“字段”标签页。
- 单击“添加字段”。
-
指定以下信息:
- 处理组 - Web 服务
- 指定要为其添加 Web 服务字段的处理组。系统将自动填充“屏幕”和“标签页”。
- 字段
- 指定要添加到处理组的字段。可用字段基于选定的 Web 服务。
- 字段标签
- 指定此字段的名称。此信息将被显示为 Web 服务提示引擎中的字段显示文本。默认“字段标签”相当于“字段”。
- 字段类型
- 基于选定的字段和 Web 服务指定字段类型。默认“字段类型”是选定“字段”的系统附带的类型。但是,您可以更改此值。系统在 Web 服务提示引擎上显示用户定义的“字段类型”。您可以将默认值更改为以下选项之一:
- “字母”
- “计算”
- “日期”
- “固定”
- “自由格式文本”
- “关键域”
- “数字”
- “已检索的字段”
注意“关键域”仅在选定“更新”或“删除”Web 服务时可用。当设置使用了更新或删除 Web 服务的 Web 服务提示时,系统管理员必须为 Web 服务所需的每个关键域创建一个“字段”,以唯一描述记录。“字段类型”应为关键域。Web 服务提示引擎首先提示您为要处理的记录输入关键域值,例如“设备”和“设备组织”。如果是更新 Web 服务,系统将查询该记录以显示结果。用户可以更新,然后提交记录。如果是删除 Web 服务,在输入所有关键域值后,系统将删除记录。
“已检索的字段”仅在选择“插入”Web 服务时可用。设置使用了插入 Web 服务的 Web 服务提示时,必须在当前提示记录中之前处理的 Web 服务内检索一个或多个关键域值。管理员需要为每个关键域创建“已检索的字段”类型的“字段”。例如,创建的 Web 服务提示使您可以同时创建工单和为工单创建活动。要使活动与在前一个处理组中创建的工单相关联;但是,数据将被输入到 Web 服务提示引擎并同时对其进行处理。若要确保活动与正确的工单相关联,系统必须首先处理“插入”工单 Web 服务,然后将工单号和工单组织传(检索)回以创建活动 Web 服务。该关键域信息与其他所需的活动数据用于创建活动并将其与正确的工单相关联。由于工单号和组织需要与活动相关联,因此为活动工单号和活动工单组织创建已检索的字段(“字段类型”=“已检索的字段”)记录。
“检索源组 - Web 服务”应使用其关键域值被检索的 Web 服务填充。在本例中,可以从“插入”工单 Web 服务中进行检索。“检索字段”将是从中检索数据的检索 Web 服务中的关键域。在本例中,“工单号”是已检索的字段之一。应以相同的方法创建另一个“字段”以定义如何在创建活动时检索工单组织。字段值只可使用较小的处理组号从 Web 服务检索。例如,不能在当前 Web 服务中检索要使用的值,除非上一个 Web 服务经过处理以提供此信息。
“已检索的字段”和“关键域”在“未映射”为空白时不可用。
“已检索的字段类型”未与“检索值”页上的可用功能关联。
如果字段定义为复选框,将在“Web 服务提示引擎”页上显示为复选框。
- 显示类型
- 指定使用 Web 服务提示引擎时字段将如何显示。默认值将是选定字段的系统默认值。用户可以将默认值更改为以下选项之一:
- “可选”
- “必需”
- “隐藏”
- “受保护”
注意如果“字段类型”为“固定”或“计算”,则仅“受保护”和“隐藏”可用于“显示类型”。如果“字段类型”是“已检索的字段”,则仅“隐藏”可用于“显示类型”。
- 顺序
- 为顺序指定数字值。使用 Web 服务提示引擎时字段按照其顺序的升序进行显示。系统提供的默认值基于 INCRLIND 参数。
注意
确保使用 Web 服务提示引擎时 Web 服务提示字段按“处理组 - Web 服务”以组的形式一起显示至关重要。系统为选定的“处理组 - Web 服务”控制字段的可用“顺序”范围。“顺序”不得覆盖与上一个或下一个处理组关联的“顺序”。例如,Web 服务提示字段在 Web 服务提示引擎上按“处理组 - Web 服务”分组,然后按“顺序”分组。
- 最小长度
- 指定字段的最小字符数。
- 最大长度
- 指定字段的最大字符数。
- 下一个序号
- 指定要开始下一个序号的号码。
- 查询代码
- 指定查询代码。“查询代码”定义有服务器连接时可用于在值字段列表进行选择的值。例如,查询和可用值列表将基于 Infor EAM 表。
- Mobile 查询代码
- 指定定义该字段可用值列表的 Mobile 查询代码。
注意
如果存在应用程序服务器连接,则 Mobile 设备将使用“查询代码”值列表;否则将使用“Mobile 查询代码”值列表。例如,本地数据填充值列表。
- 检索字段
- 指定要从中检索数据的字段名称。系统将自动填充“检索源组 - Web 服务”和“检索字段 X 路径”。
- 查询 Web 服务
- 指定查询 Web 服务。仅在为“更新”Web 服务定义关键域时应用“查询 Web 服务”。“查询 Web 服务”用于在记录中查询数据以向用户显示可能的更新。
- 未映射字段
- 如果指定的字段未映射到 Web 服务中的任何字段,请选中此选项。然后,字段值可以作为计算或检索值的一部分按提示进一步处理。
- 使用上一个值
- 选中此选项,以使用上一个字段值。
- 如果数据是
- 指定“转到”条件。此字段用于描述一种条件,在这种条件下,系统不访问由“下一个序号”定义的字段,而是将重点放在“转到序号”上。
- 模式
- 指定应满足“转到”条件的模式。
- 转到
- 指定系统要遵循的字段序号,如果满足条件,此序号与“下一个序号”相反。
- 清除“从转到目标开始的先前值”字段
- 选择此选项,提示顺序小于 (<) “转到”目标字段顺序时,系统将继承字段值和选中的“使用上一个值”。例如,提示字段的上一个值 >= 将清除“转到”目标字段顺序。否则,提示顺序小于 (<) “转到”源字段顺序时,系统将继承字段值和选中的“使用上一个值”。例如,提示字段的上一个值 <= 将清除“转到”源字段顺序。
- 检索源组 - Web 服务
- 指定其关键域值将返回并用于后继处理组的 Web 服务。
- 计算数据
- 当“字段类型”是“计算”时,为字段指定计算数据。
- 模式匹配
- 指定“字段类型”的“字母”模式,输入的数据必须匹配且有效。 注意
系统在定义“模式匹配”时支持以下“通配符”:
- .(句点):A 到 Z 之间的任何一个字母字符
- #(井字号):0 到 9 之间的任何一个数字
- _(下划线):A 到 Z 以及 0 到 9 之间的任何一个字母数字字符
- %(百分号):一个字母数字字符串
- , (逗号):OR 条件
- :(冒号):THROUGHOUT 条件
- !任何字符或数字:输入的数据不应与“!”之后的数据匹配NOT 条件。
请参阅为 Web 服务提示定义检索值。
-
单击“提交”。
注意
要删除字段,请选择要删除的字段,然后单击“删除字段”。不能从本页中删除与 Web 服务的“控制组织”一致的字段,因为它们对处理 Web 服务至关重要。但是,如果 Web 服务自身已从“Web 服务”页上删除,则系统将自动删除包含“控制组织”的所有相关字段。
注意如果所有需要是必需的、关键的,或没有使用 Web 服务提示引擎为 Web 服务提示定义已检索的字段以使其正常发挥作用,则该页将不会显示错误。Web 服务提示引擎在处理具有不充分提示字段的记录时将会显示错误。如果定义的下一个序号不存在于提示定义内,则 Web 服务提示引擎也将显示错误。