GAS: Ativadores (Triggers)

Publicado a 24/01/2018, 15:33 por Luis Pitta -org-   [ atualizado a 08/03/2018, 10:34 ]

Exemplo de utilização de um Trigger de Reação

Neste exemplo foi ativado um Trigger de Reação que executa o Script "sendEmails" sempre que se abrir (A abrir) a folha de cálculo "Trigger de Reação - Exemplo"



Vamos agora abrir e editar este Trigger de Reação


Procedimento:

1. Abrir a seguinte Google Folha de Cálculo com o nome "Trigger de Reação - Exemplo":

docs.google.com/spreadsheets/d/1CAJIolYdVHssHnYdo5xMijXTrw9QyPAFs5hWUJ_d-k0/edit?usp=sharing

2. Dentro da Folha de Cálculo abrir o Editor de Scripts 

Procedimento: Menu Ferramentas > Editor de Scripts...

3. Dentro do Editor de scripts abrir a caixa dos Ativadores do Projeto Ativo

Procedimento:  Menu Editar  > Ativadores do Projeto Ativo

Vai surgir a seguinte caixa de diálogo:


Explicação das opções:

Caixa Executar: Escolhemos a função que pretendemos executar. Neste caso só temos a função sendEmails.

Caixa Eventos: Permite permite o tipo de Trigger:

Opção A: Trigger de reação. Neste caso "A partir da folha de cálculo"
Ao escolher a opção A vamos ter disponível uma caixa com 4 sub-opções: "A abrir", "A editar", "A alterar" e "No envio de formulários".
Neste caso escolhemos a primeira: "A abrir".

Opção B: Trigger Temporal. Influenciado pelo tempo.
Ao escolher a Opção B vamos ter disponíveis mais duas caixas:
    • A primeira para definirmos a periodicidade temporal (minutos, horas, dias, semanal e mensal) 
    • A segunda para definirmos a cadencia temporal (de hora a hora, duas em duas horas, etc.)
Botão "Notificações": Permite ativarmos notificações em caso de erro, para um endereço de email que nos pertença.

O envio pode ser imediato, de hora a hora, diário ou semanlmente.

Botão "Adicionar um ativador novo"

Permite adicionarmos um novo ativador (Trigger) temporal ou de Reação.

Botão de Guardar

Depois de alterar, criar ou eliminar os triggers deve clique em Guardar.



4. Editar as diferentes caixas para alterar ou mesmo eliminar o Trigger em questão (de Reação ou Temporal).


Procedimento:  No final clicar em Guardar