Trin 6: Udløse triggere

I dette trin viser vi, hvor den trigger, som du så blive registreret, udløses.

Triggere kan udløses ved ethvert punkt af en komponent. Triggeren udløses typisk af en brugerinteraktion, for eksempel et klik på en knap eller valg af en række i en tabel. En komponent kan imidlertid udløse triggeren på basis af vilkårlige kriterier, for eksempel når data ændres på grund af et REST-API-kald.

I dette eksempel udløses triggeren, og den aktuelle værdi for egenskaben whoAreYou videregives, når du klikker på billedet.

Gennemgå filen render.js, og se på objektet SampleComponentViewModel.

Sådan udløses en trigger:

1. Gennemgå funktionen i det SampleComponentViewModel-objekt, der kalder Sites-SDK for at udløse triggeren.

   self.raiseTrigger = function (triggerName) {
     SitesSDK.publish(SitesSDK.MESSAGE_TYPES.TRIGGER_ACTIONS, {
       'triggerName': triggerName, 
       'triggerPayload': { 
           'payloadData': 'some data here'
       }
     });
   };

2. Nu har du brug for noget i brugerinterfacet, der kan kalde funktionen, som udløser triggeren. Gennemgå render.js-filen, og opdater objektet sampleComponentTemplate, så det indeholder denne post:

        '<div data-bind="attr: {style: imageStyle, \'data-layout\': alignImage()}, click: imageClicked">' +

I objektet SampleComponentViewModel kan du se den JavaScript-funktion, der kaldes, når der klikkes på billedet. Denne funktion kalder Sites-SDK for at anmode den om at udløse alle handlinger, der er defineret for triggeren "imageClicked", hvilket er den værdi, der er videregivet gennem click-tilknytningen i trin 2. Den videregiver også et triggerPayload, der indeholder et enkelt felt: payloadData og videregiver en statisk værdi, 'some data here'. Disse værdier, imageClicked og whoAreYou, matcher værdierne i appinfo.json-filen, hvor triggeren er registreret (i det foregående trin).

I eksempelkoden udløses triggeren af en datatilknytning i click-tilknytningen og videregiver triggernavnet imageClicked. Der er i øjeblikket tre gengivelser af komponenten <scs-image>, afhængigt af hvilket layout brugeren vælger. For at sikre, at triggeren udløses for alle layouts, skal du redigere render.js-filen og foretage følgende ændringer.

• Udløs triggere fra forskellige layouts. Find de to steder med denne kode:

  '<div data-bind="attr: {style: imageStyle, \'data-layout\': alignImage()}">' +

  Ændr koden til dette:

  '<div data-bind="attr: {style: imageStyle, \'data-layout\': alignImage()}, click: imageClicked">' +

• Angiv det payload, som skal videregives til triggerne. Ændr denne kode:

      self.raiseTrigger = function (triggerName) {
        SitesSDK.publish(SitesSDK.MESSAGE_TYPES.TRIGGER_ACTIONS, {
          'triggerName': triggerName,
          'triggerPayload': {
            'payloadData': 'some data here'
          }
        });
      };

  Brug denne kode i stedet:

      self.raiseTrigger = function (triggerName) {
        SitesSDK.publish(SitesSDK.MESSAGE_TYPES.TRIGGER_ACTIONS, {
          'triggerName': triggerName,
          'triggerPayload': {
            'payloadData': self.imageBannerText() // pass banner text as payload
          }
        });
      };

• Synkroniser eller upload filen render.js til Oracle Content Management-instansserveren.

Nu hvor du har gennemgået den påkrævede kode, kan du tilkoble triggeren, så din tilpassede komponent udløser den, når der klikkes på knappen.