您將在此步驟中複習 Oracle Content Management 觸發程式的註冊方式,亦即可以使用您元件之「設定值」面板中「連結」頁籤內的「觸發程式動作」選項選取。
觸發程式是 Oracle Content Management 元件間通訊的一部分。任何元件都可引發任意數目的觸發程式。元件可以為觸發程式提供有效負載,然後有效負載會被傳送給引發該觸發程式時所執行的任何動作。使用者可以為每個觸發程式選取應該執行的動作。最後,建立成一起運作的元件,可以在無須使用者定義元件之間的互動情況下,自動引發觸發程式,對其他元件執行動作。
就您新增的元件而言,觸發程式會註冊成為元件之註冊資料的一部分。若要新增觸發程式,請更新元件支援之各個觸發程式的 "triggers"
特性陣列。此外,還必須指定觸發程式支援的有效負載,如此才能建立使用者介面,讓使用者可以將有效負載內的值對應至動作所支援的特性。
開啟 appinfo.json
檔案並複查 "triggers":[],
項目。
"triggers": [{ "triggerName": "imageClicked", "triggerDescription": "Image clicked", "triggerPayload": [{ "name": "payloadData", "displayName": "Trigger Payload Data" }] }],
在此項目中,您會見到下列各項:
triggerName ("imageClicked"
),這應為唯一值,通常會以您的自訂元件 ID 命名。
triggerDescription ("Image clicked"
),這由使用者介面對話方塊使用以顯示您的觸發程式。
您觸發程式的單一值 triggerPayload ("payloadData"
)。使用者將可以選取此有效負載中的項目,並將其對應至此動作中的欄位。
檢查步驟 5 的結果
您可以前往元件之「設定值」面板中的連結頁籤查看並選取觸發程式:
重新整理網站中的頁面,讓網站產生器能夠取得元件的變更。
將頁面切換為「編輯」模式
將您的元件拖放到頁面中。
顯示您元件的「設定值」面板。
選取「設定值」面板頂端的連結頁籤。
按一下觸發程式動作作為「連結類型」。
按一下您註冊的已點選影像觸發程式。
在對話方塊中,從「頁面動作」區段內拖曳顯示警示動作。(頁面動作都是 Oracle Content Management 所提供的內建動作。)
在訊息欄位中,選取觸發程式有效負載資料值,此為註冊觸發程式時,您在有效負載中所看到的項目名稱。您可以將此名稱變更為任何您要的名稱。
現在您可以註冊觸發程式,並將觸發程式對應至透過值傳遞的內建動作。在下一個步驟中,我們將會複習引發觸發程式以執行動作的方式。
繼續進行步驟 6:引發觸發程式。