步驟 5:註冊觸發程式

您將在此步驟中複習 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 的結果

您可以前往元件之「設定值」面板中的連結頁籤查看並選取觸發程式:

  1. 重新整理網站中的頁面,讓網站產生器能夠取得元件的變更。

  2. 將頁面切換為「編輯」模式

  3. 將您的元件拖放到頁面中。

  4. 顯示您元件的「設定值」面板。

  5. 選取「設定值」面板頂端的連結頁籤。

  6. 按一下觸發程式動作作為「連結類型」。

  7. 按一下您註冊的已點選影像觸發程式。

  8. 在對話方塊中,從「頁面動作」區段內拖曳顯示警示動作。(頁面動作都是 Oracle Content Management 所提供的內建動作。)

  9. 訊息欄位中,選取觸發程式有效負載資料值,此為註冊觸發程式時,您在有效負載中所看到的項目名稱。您可以將此名稱變更為任何您要的名稱。

現在您可以註冊觸發程式,並將觸發程式對應至透過值傳遞的內建動作。在下一個步驟中,我們將會複習引發觸發程式以執行動作的方式。

繼續進行步驟 6:引發觸發程式