Passo 8: Executar Ações

No fim deste tópico, poderá largar componentes na página que executa ações no seu componente. Desta forma, é aproveitado o registo da ação que criou no passos anterior.

Para um componente executar uma ação, este deve monitorizar a mensagem EXECUTE_ACTION. Esta mensagem também inclui o payload transmitido à ação a partir do qual irá extrair os valores esperados.

Para monitorizar a mensagem EXECUTE_ACTION, edite o ficheiro render.js e atualize o objeto SampleComponentViewModel com a seguinte entrada:

SitesSDK.subscribe('EXECUTE_ACTION', $.proxy(self.executeActionsListener, self));

Quando a mensagem EXECUTE_ACTION for recebida, a função de callback associada é executada:

    self.executeActionsListener = function (args) {
      // get action and payload
      var payload = args.payload,
      action = args.action;

      // handle 'setImageWidth' actions
      if (action && action.actionName === 'setImageWidth') {
        $.each(payload, function(index, data) {
          if (data.name === 'imageWidth') {
            self.imageWidth(data.value);
          }
        });
      }
    }

Isto cria uma função de JavaScript para executar a ação e, em seguida, utiliza o Sites SDK para chamar a função sempre que a mensagem EXECUTE_ACTION for gerada.

O componente será chamado sempre que for gerada uma mensagem EXECUTE_ACTION e cabe ao componente processar apenas as ações cujo processamento lhe diz respeito. Para isso, deve verificar o nome da ação de modo a garantir que é a que o componente pode processar.

O payload para a ação é uma matriz de valores. Normalmente, terá de encontrar os valores do payload que lhe interessam a partir da matriz.