Etap 5: Rejestrowanie wyzwalaczy

W tej części zobaczymy, w jaki sposób można zarejestrować wyzwalacz Oracle Content Management, wybierany za pomocą opcji "Czynności wyzwalacza" z karty "Łącze" panelu "Ustawienia" składnika.

Wyzwalacze stanowią część mechanizmu komunikacji między składnikami Oracle Content Management. Każdy składnik może uaktywniać dowolną liczbę wyzwalaczy. Składnik może dostarczać do wyzwalacza ładunek, który jest przekazywany do czynności uruchamianej w chwili uaktywnienia wyzwalacza. Użytkownicy mogą wybrać czynności, które powinny być uruchamiane dla poszczególnych wyzwalaczy. Na koniec składniki, które są projektowane z myślą o ich współpracy, mogą automatycznie uaktywniać wyzwalacze w celu uruchamiania czynności w innym składniku bez potrzeby definiowania interakcji między składnikami.

W przypadku dodawanych składników wyzwalacze są rejestrowane w ramach danych rejestracyjnych. Aby dodać wyzwalacz, należy zaktualizować tablicę właściwości "triggers", dodając do niej obsługiwany wyzwalacz. Trzeba także określić ładunek obsługiwany przez wyzwalacz, aby mógł zostać utworzony interfejs użytkownika umożliwiający użytkownikowi odwzorowywanie wartości z ładunku na właściwości obsługiwane przez czynność.

Należy otworzyć plik appinfo.json do edycji i sprawdzić wpis "triggers":[],.

"triggers": [{
    "triggerName": "imageClicked",
    "triggerDescription": "Image clicked",
    "triggerPayload": [{
      "name": "payloadData",
      "displayName": "Trigger Payload Data"
   }]
}],

W tym wpisie można zobaczyć:

  • Nazwę "imageClicked" wyzwalacza (triggerName), która powinna być unikatowa i zazwyczaj jest przypisywana do przestrzeni nazw na podstawie ID składnika niestandardowego.

  • Opis "Image clicked" wyzwalacza (triggerDescription), używany w oknie dialogowym, w interfejsie użytkownika, do wyświetlenia wyzwalacza.

  • Wartość "payloadData" ładunku wyzwalacza (triggerPayload). Użytkownicy będą mogli wybierać wpisy z tego ładunku i odwzorowywać je na pola w danej czynności.

Sprawdzanie wyników dla etapu 5

Wyzwalacz można zobaczyć i wybrać na karcie Łącze w panelu "Ustawienia" składnika:

  1. Aby konstruktor serwisów mógł pobrać zmiany do składnika, odświeżyć stronę serwisu.

  2. Przełączyć stronę do trybu edycji.

  3. Przeciągnąć składnik na stronę.

  4. Wyświetlić panel "Ustawienia" składnika.

  5. Wybrać kartę Łącze znajdującą się na górze panelu "Ustawienia".

  6. Jako typ łącza wybrać opcję Czynności wyzwalacza.

  7. Kliknąć na zarejestrowanym wyzwalaczu Image clicked.

  8. W oknie dialogowym przeciągnąć czynność Pokaż alarm z sekcji "Czynności związane ze stroną". ("Czynności związane ze stroną" to wbudowane czynności dostarczane przez Oracle Content Management.)

  9. W polu Komunikat wybrać wartość Trigger Payload Data, czyli nazwę wpisu w ładunku, która była wyświetlana podczas rejestrowania wyzwalacza. Można ją zmienić na dowolną nazwę.

Teraz można zarejestrować wyzwalacz i odwzorować go na wbudowaną czynność przekazywaną przez wartość. W następnym etapie pokażemy, w jaki sposób wyzwalacz jest uaktywniany w celu wykonania czynności.

Kontynuacja: Etap 6: Uaktywnianie wyzwalaczy.