Шаг 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", которое должно быть уникальным значением и обычно связывается с пространством имен с помощью идентификатора вашего пользовательского компонента.

  • Описание триггера (triggerDescription), "Image clicked", которое используется в диалоговом окне пользовательского интерфейса для отображения триггера.

  • Однозначное свойство triggerPayload, "payloadData" для вашего триггера. Пользователи смогут выбирать записи в этих полезных данных и сопоставлять их полям в действии.

Проверка результатов для шага 5

Вы можете просматривать и выбирать свои триггеры, перейдя на вкладку Ссылка на панели "Настройки" своего компонента.

  1. Обновите страницу на своем сайте, чтобы приложение Site Builder могло отслеживать изменения в компоненте.

  2. Переключите страницу в режим редактирования.

  3. Перетащите свой компонент на страницу.

  4. Откройте панель "Настройки" для своего компонента.

  5. Выберите вкладку Ссылка в верхней части панели "Настройки".

  6. Выберите в списке Триггеры действий значение "Тип связи".

  7. Нажмите зарегистрированный вами триггер Image clicked.

  8. В диалоговом окне перетащите действие Показать оповещение из раздела "Действия на странице". (Действия на странице — это встроенные действия, предоставляемые платформой Oracle Content Management.)

  9. В поле Сообщение выберите значение Полезные данные триггера, которое представляет собой имя записи в полезных данных, которые отображались при регистрации триггера. Это имя можно заменить любым другим.

Теперь вы можете зарегистрировать триггер и сопоставить его встроенному действию, передавая посредством значения. В ходе выполнения следующего шага мы рассмотрим срабатывание триггера для выполнения действия.

Теперь выполните Шаг 6. Срабатывание триггеров.