Nesta etapa, você verificará como um trigger do Oracle Content Management pode ser registrado, o qual você pode selecionar usando a opção Ações do Trigger na guia Link do painel Definições do seu componente.
Os triggers fazem parte da comunicação entre componentes do Oracle Content Management. Qualquer componente pode acionar qualquer número de triggers. O componente pode fornecer um payload para um trigger, que então é transmitido a qualquer ação executada quando o trigger é acionado. Os usuários podem selecionar quais ações devem ser executadas para cada trigger. Por último, os componentes criados para funcionarem juntos podem acionar triggers automaticamente para executar ações no outro componente sem o usuário precisar definir a interação entre os componentes.
Para componentes que você adiciona, os triggers são registrados como parte dos dados de registro do componente. Para adicionar um trigger, atualize o array de propriedade "triggers"
com cada trigger que o componente suporta. Especifique também o payload que o trigger suporta para que a interface do usuário possa ser criada para permitir que o usuário mapeie valores dentro do payload para as propriedades suportadas pela ação.
Abra o arquivo appinfo.json
e verifique a entrada "triggers":[],
.
"triggers": [{ "triggerName": "imageClicked", "triggerDescription": "Image clicked", "triggerPayload": [{ "name": "payloadData", "displayName": "Trigger Payload Data" }] }],
Nessa entrada, você verá o seguinte:
Um triggerName, "imageClicked"
, que deve ser um valor exclusivo, e normalmente será associado a um namespace pelo ID do componente personalizado.
Um triggerDescription, "Image clicked"
, que é usado pela caixa de diálogo da interface do usuário para exibir o trigger.
Um único valor triggerPayload, "payloadData"
, para o trigger. Os usuários poderão selecionar entradas nesse payload e mapeá-las para os campos na ação.
Verificar os Resultados da Etapa 5
Você pode ver e selecionar seu trigger quando acessa a guia Link no painel Definições do seu componente:
Atualize sua página no site para que o Site Builder possa selecionar as alterações no componente.
Coloque a página no modo de Edição.
Arraste e solte o componente na página.
Abra o painel Definições no seu componente.
Selecione a guia Link na parte superior do painel Definições.
Clique em Ações do Trigger como Tipo de Link.
Clique no trigger Imagem clicada que você registrou.
Na caixa de diálogo, arraste a ação Mostrar Alerta de dentro da seção Ações da Página. (Ações da Página são ações incorporadas fornecidas pelo Oracle Content Management.)
No campo Mensagem, selecione o valor Dados do Payload do Trigger, que é o nome da entrada no payload visto quando o trigger foi registrado. Você pode alterá-lo para qualquer nome desejado.
Agora você poderá registrar um trigger e mapeá-lo para uma ação incorporada, transmitindo um valor. Na próxima etapa, verificaremos como o trigger é acionado para executar a ação.
Continue em Etapa 6: Acionar Triggers.