瞭解 UI 提示

結構可用於描述業務物件或任何其他 XML 文件的結構。如果適用,同一個結構也可以內嵌在執行時間解譯的使用者介面 (UI)「提示」,然後轉譯顯示或維護該文件所需的 HTML。如需詳細資訊,請參考 UI 提示語法

此技術的主要優點如下:
  • 較不易出錯。資料結構與其展示層之間的相互關聯更緊密,可使後者保持最新狀態,例如:
    • 將元素新增至結構或從結構中移除元素會導致對展示層進行相對應的變更。請注意,您可以視需要將元素明確地從展示層中排除。
    • 最適合呈現或輸入元素資料的 HTML 小工具,是由結構定義的元素資料類型所決定。例如,日期揀選器是用於輸入日期元素。如果元素的資料類型在結構中發生變更,則其呈現方式也會相應地調整。
  • 實作速度更快。不需要 HTML 技能。結構定義及其內嵌的 UI 提示指示是用來在執行時間轉譯 HTML。無需建立 HTML 並以 UI 對應方式維護,即可降低實作與維護成本。
  • 支援業務物件繼承。將展示層併入業務物件架構,可讓階層中的每個業務物件將其部分提供給顯示實體的完整 HTML。換句話說,用來顯示子類別業務物件的完整 HTML,是由其上階業務物件之內含結構所轉譯的 HTML 後面再接著子類別延伸的元素所組成。

本節主題描述與 UI 提示功能相關的概念和指引。

顯示與輸入模式

同一個結構可用來產生其 HTML 對應或輸入對應的顯示版本。在顯示版本中,元素值會以唯讀方式呈現,系統會顯示相對應的描述而非代碼,而其他成品 (例如連結) 則可用於導覽至相關頁面。在輸入版本中,可使用適當 HTML 小工具來編輯元素的資料類型。例如,外來索引鍵元素會與搜尋元件一起轉譯,而日期元素則會包含日期揀選器小工具。

產生的對應類型取決於其使用內容:
  • 當結構是用來在對應區域中呈現內容時,便會產生顯示對應。
  • 當結構是用來在業務處理助理指令檔步驟或處理流程面板中輸入資料時,則會產生輸入對應。如需詳細資訊,請參考產生編輯對應陳述式處理流程

預設會假設結構中的每個元素都同時包含在顯示和輸入呈現對應中。UI 提示可允許將元素完全排除而不呈現、僅包含在顯示對應中或僅包含在輸入對應中。

不僅僅是業務物件架構

雖然大部分用於描述業務物件的顯示與維護對應,但 UI 提示也可以內嵌在其他結構型物件中:
  • 您可以使用資料區域來描述輸入表單,並提示使用者使用業務處理助理指令檔步驟處理流程面板來填入表單。
  • 您可以將 UI 提示內嵌於業務服務或服務指令檔結構中,以便在入口區域中顯示服務所準備的內容。如需詳細資訊,請參考對應區域
  • 您可以將 UI 提示內嵌於服務指令檔結構中,以在呼叫指令檔來執行任務及呈現結果之前,先提示使用者輸入。如需詳細資訊,請參考產生編輯對應陳述式

定義順序即呈現順序

元素會依照它們在展開結構中的定義順序呈現。例如,子類別業務物件若是包含其上階業務物件且後面接著延伸元素,就會呈現為含有 HTML 的上階部分,後面接著延伸欄位。

針對複雜 HTML 使用 UI 對應片段

下列項目描述 UI 提示功能所支援的基本功能:
  • 控制顯示與輸入對應中呈現的元素。
  • 提供輸入對應的標題。
  • 藉由插入開始和結束區段指示,在元素周圍引入區段。元素在區段內的定義順序也是其呈現順序。
  • 元素與區段層級支援基本可見性規則。
如果特定元素有更複雜的需求,您可以為該元素建立必要的 HTML/JavaScript、將其擷取為 UI 對應片段、將該片段以適當的呈現順序內嵌在結構中,然後將該元素從相對應輸入或顯示對應的基本轉譯中隱藏。
備註:您也可以使用此技術在不同的呈現位置中顯示元素。例如,當業務物件的顯示指令檔需要顯示不屬於業務物件結構的其他元素時。在此情況下,指令檔結構會將元素導入為隱藏,而業務物件結構則包含內嵌的 HTML UI 對應片段,以便在適當的區段中顯示它們。請注意,這可能只有在業務物件和指令檔都由您的組織擁有時,才能夠運作。

如需詳細資訊,請參考 UI 提示語法