為 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 查詢代碼」值清單。例如,本機資料填充值清單。
- 擷取欄位
- 指定要從中擷取資料的欄位名稱。系統將自動填充「擷取源組 - 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 服務提示引擎也將顯示錯誤。