Ir para o conteúdo

Notificações no App Builder Jitterbit

Visão geral

Notificações são mensagens que o App Builder envia aos usuários da sua aplicação quando um evento ocorre, como um clique de botão ou uma verificação programada. Uma notificação pode ser entregue como um email, uma mensagem de texto, um alerta na aplicação ou uma notificação push, e pode opcionalmente permitir que o destinatário responda navegando até uma página ou acionando um evento.

Esta página descreve as três etapas necessárias para configurar notificações em suas aplicações:

  1. Configurar um servidor de notificação
    Configure o servidor usado para entregar notificações.

  2. Criar uma notificação
    Defina o conteúdo da mensagem e o objeto usado para enviá-la.

  3. Adicionar opções de resposta
    Opcionalmente, permita que os destinatários respondam navegando até uma página ou acionando um evento.

Esta página também inclui passo a passo completo de todo o processo, com dois exemplos: uma notificação na aplicação e uma mensagem SMS.

Para mensagens enviadas por administradores para múltiplos usuários de uma vez, em vez de acionadas por um evento da aplicação, consulte Notificações do sistema.

Etapa 1: Configurar um servidor de notificação

Antes de poder enviar uma notificação, é necessário configurar pelo menos um servidor de notificação para o método de entrega que pretende utilizar. O App Builder suporta os seguintes métodos de entrega:

  • Email, enviado através de um servidor SMTP.

  • SMS (mensagem de texto), enviado através do Twilio.

  • Na aplicação (alerta do App Builder), um popup exibido ao destinatário enquanto conectado à aplicação.

  • Push, enviado através do Jitterbit Blabber, para aplicações usando o Jitterbit Wrapper ou um wrapper personalizado, ou através do OneSignal, para aplicações móveis nativas usando sua própria conta OneSignal.

Para visualizar e gerenciar servidores de notificação, selecione IDE > Notification Servers:

Notification Servers

A lista de servidores é composta pelas seguintes colunas:

  • Name: O nome do servidor.

  • Type: O tipo de notificação que pode ser configurado com aquele servidor.

  • Description: Uma breve descrição.

  • URI: A URI (se aplicável).

  • Status: O status atual do servidor.

Clique duas vezes em qualquer linha ou clique no ícone no final para visualizar e editar detalhes de um servidor específico. Todos os servidores, exceto In-app, requerem configuração antes do uso:

  • SMTP (Email) requer que o endereço de origem, URI e seções de Segurança sejam preenchidos.
  • Blabber, OneSignal e SMS requerem que a seção de Segurança seja preenchida.

Nota

Servidores de notificação eram anteriormente conhecidos como endpoints de notificação.

Etapa 2: Criar uma notificação

Criar uma notificação significa criar uma regra de negócio com sua Purpose definida como Notification, na aba Notifications do App Workbench. A regra define o conteúdo da mensagem de notificação e seleciona o objeto de dados público (Método de Entrega) usado para enviá-la, como Email, Text Message, App Builder Alert ou Push Notification.

Para criar uma notificação:

  1. Navegue até App Workbench > Notifications.
  2. Clique em + Notification.
  3. Atribua um Name.
  4. Confirme que Purpose é Notification.
  5. Selecione o Delivery Method que deseja usar. Cada método de entrega envia uma notificação através de um objeto de dados público específico, que determina os detalhes da notificação. Se o objeto de dados necessário não estiver disponível, talvez seja necessário criar uma conexão de fonte de dados para App Builder (Sealed) na aplicação em que está trabalhando.
  6. Clique em Create.

Clicar em Create abre o Rule Builder em modo de edição, onde você define as colunas que a notificação usa, da mesma forma que faria ao editar qualquer outra regra de negócio. Para as colunas disponíveis para cada método de entrega, consulte Objetos de dados públicos por método de entrega abaixo.

Nota

A tabela File de uma fonte de dados do Amazon S3 não pode ser usada como fonte de dados de uma notificação.

Objetos de dados públicos por método de entrega

Cada método de entrega envia uma notificação através de um objeto de dados público específico — um conjunto predefinido de colunas que determina detalhes como o destinatário, remetente e comportamento de entrega. O Método de Entrega selecionado ao criar uma notificação determina qual objeto de dados público as colunas da notificação devem mapear, na definição mvSQL do Rule Builder.

As seções a seguir descrevem as colunas disponíveis para cada objeto de dados público, além das colunas comuns a todos eles.

Colunas comuns

Estas colunas são comuns a todos os objetos de dados públicos descritos abaixo:

Nome Obrigatório Multi-Destino Exemplo Descrição
Binding() Não Sim CustomerID Se fornecido, identificará o registro correspondido à opção para esta notificação. Múltiplas vinculações podem ser definidas.

Email

As colunas do objeto de dados público Email são as seguintes:

Notificações enviadas por email podem incluir anexos de muitos tipos de arquivo, como .pdf, .docx, .txt ou .xlsx, usando as colunas Attachment() e FileDataSourceId descritas abaixo. O App Builder anexa arquivos do diretório data/pdf por padrão, ou do diretório especificado por FileDataSourceId.

Se a notificação contiver opções, a coluna AppBuilderUrl especifica a URL usada ao gerar links para essas opções. Se AppBuilderUrl não for fornecida, o App Builder recorrerá à URL padrão do site do servidor, configurada em IDE > Provedores de Segurança > Mais (no painel Configuração) > Sites. Para mais informações, consulte Sites e aliases.

Nota

Se estiver usando mais de um endereço de email nas colunas To() ou Cc(), separe os valores com uma vírgula.

Nome Obrigatório Multi-Destino Exemplo Descrição
AppBuilderUrl Depende Não 'https://example.com/MyAppBuilder' AppBuilderUrl é obrigatório se a notificação contiver opções. Esta URL é usada ao gerar links para as várias opções de notificação. Esta é a URL para acessar o App Builder do ponto de vista do receptor da mensagem. Não requer uma barra invertida no final.
Attachment() Não Não 'somepath/files/*' Se fornecido, anexará arquivo(s) ao email. Se a string Attachment() terminar com um asterisco (*), a string é considerada como um caminho de diretório, e todos os anexos de arquivo no diretório serão anexados ao email.
Cc() Não Sim 'user1@zudy.com,user2@zudy.com' Lista delimitada por vírgula de endereços de email para cópia. Semelhante a To(), múltiplos destinos podem ser especificados para concatenação automática.
FileDataSourceId Não Não UUID Identificador único que se refere à fonte de dados que deve ser consultada para localizar o(s) anexo(s) de arquivo.
From Não Não 'noreply@zudy.com' Define o endereço de origem do email. Se From não for fornecido, o endereço de origem definido no registro Be_NotificationEndpoint será usado.
Language Não Não 'es' Se fornecido, serão feitas tentativas de tradução tanto para os campos Template quanto Subject da notificação associada. Da mesma forma, os nomes das opções de notificação serão traduzidos.
To() Sim Sim 'user1@zudy.com,user2@zudy.com' Lista delimitada por vírgula de endereços de email para enviar. Múltiplos campos To() podem ser direcionados para enviar a múltiplos destinatários (além de usar valores delimitados por vírgula). Uma exceção é lançada se este campo não for fornecido ou for nulo.

Mensagem de Texto

O objeto de dados público Mensagem de Texto é usado para enviar mensagens SMS. As colunas do objeto de dados público Mensagem de Texto são as seguintes:

Nome Obrigatório Multi-Destino Exemplo Descrição
Language Não Não 'es' Se fornecido, tentativas de tradução serão feitas para o campo Template da notificação associada. Da mesma forma, os nomes das opções de notificação serão traduzidos em um lançamento futuro.
To() Sim Sim '+15559990000' Um único número de telefone no formato esperado pelo Twilio. Vários campos To() podem ser direcionados para enviar para múltiplos destinatários. Uma exceção é lançada se este campo não for fornecido ou for nulo.

Alerta do App Builder

As colunas do objeto de dados público Alerta do App Builder são as seguintes. Este objeto é semelhante, mas não idêntico, ao objeto de dados público Notification_Create.

Nome Obrigatório Multi-Destino Exemplo Descrição
From Não Não who('userid') Esta coluna representa o usuário de quem é esta mensagem. Se não fornecido, o usuário que executa a ação será assumido.
Persistent Não Não 1 Valor booleano que indica se o alerta deve ser considerado persistente. Este atributo é aplicável apenas ao enviar um alerta para um UserId. Todos os alertas possuem um botão Descartar que remove o alerta do painel de notificações do usuário. O usuário pode ignorar o alerta ou fechar sua janela ou sair do App Builder. Se persistente for verdadeiro (1), o alerta será exibido repetidamente, cada vez que o usuário fizer login no App Builder, até que o usuário descarte ativamente o alerta. Use esta técnica para garantir que um alerta seja lido pelo usuário.
SendToPushNotificationEnabledUser Não Não 0 Se fornecido, o Alerta do App Builder pode ser configurado para enviar apenas para usuários que não possuem um dispositivo com notificações push habilitadas. Isso permite que um desenvolvedor envie tanto um Alerta do App Builder quanto uma Notificação Push no mesmo evento e evita que um usuário receba tanto uma notificação de desktop quanto uma notificação push.
Timeout Não Não 15 Se fornecido, Timeout representa a quantidade de tempo (em segundos) a aguardar antes de fechar automaticamente o popup de alerta.
To() Sim Não all Esta coluna representa o usuário para o qual a notificação é enviada. Uma exceção é lançada se este campo não for fornecido ou for nulo. Você pode usar as seguintes expressões especiais:
  • Use 'session' para direcionar a sessão do usuário atual.
  • Use 'all' para direcionar todos os usuários atualmente conectados.
  • Para enviar para um ou mais usuários específicos, especifique seus valores de UserId, separados por vírgulas.
  • Para enviar para um grupo, função, aplicação, fonte de dados ou uma sessão conhecida, use a função de tempo de execução Recipient().

Notificação por Push

O objeto de dados público Notificação por Push envia uma notificação por push para um usuário. As colunas do objeto de dados público Notificação por Push são as seguintes:

Nome Obrigatório Multi-Destino Exemplo Descrição
Badge Não Não 1 Se fornecido, isso definirá o número de badge no ícone da aplicação.
From Sim Não who('userid') From representa o usuário de quem a mensagem é.
To Sim Não 85cc99ff-b4a6-4a32-bfeb-537d346ee52c To é o usuário (UserId) para quem a notificação por push é enviada. Se o usuário não tiver um dispositivo com notificações por push ativadas, a regra de notificação ainda terá sucesso, mas nenhuma mensagem será enviada. Uma exceção é lançada se este campo não for fornecido ou for nulo.
ToAppUserId Não Não 100 Se o usuário for identificado por um ID de usuário da aplicação, este valor deve ser fornecido além do campo To.

Escreva a mensagem de notificação

Para escrever a mensagem da notificação, clique na aba Notifications novamente e selecione sua notificação no painel Notification Rules. Digite a mensagem no campo Body do painel Message; este campo é obrigatório e o evento de notificação falha com um erro se deixado em branco.

A mensagem oferece suporte a substituições usando a sintaxe {{fieldname}}, que o App Builder substitui pelo valor da coluna correspondente quando a notificação é enviada. Por exemplo, o corpo pode conter:

Hello {{CustomerName}},

Neste exemplo, CustomerName deve estar contido nas colunas da regra de notificação junto com os outros campos obrigatórios. As substituições podem adicionar um sinalizador url opcional para indicar que o valor é uma URL e requer codificação de URL, por exemplo {{fieldname|url}}. Um sinalizador HTML opcional trata a marcação HTML no valor como texto simples, por exemplo {{fieldname|HTML}} substitui um valor de <b>Jitterbit</b> como Jitterbit.

Para a maioria das mensagens, editar o campo Body em texto simples é suficiente. Se você precisar de formatação personalizada além de texto simples, clique em More > Edit HTML para editar o HTML subjacente da mensagem diretamente.

Para emails, um Subject também deve ser especificado, que também oferece suporte a substituições; como o campo Body, deixá-lo em branco faz com que o evento de notificação falhe com um erro.

Traduções

Se sua aplicação oferece suporte a vários idiomas, você também pode traduzir uma notificação. Três campos oferecem suporte a isso: o Body da notificação, seu Subject (para emails) e o Name de cada opção de resposta. Em vez de inserir texto literal nesses campos, insira uma chave de tradução; o App Builder procura o valor para o idioma do destinatário no pacote de traduções do app quando a notificação é enviada.

Você deve adicionar manualmente essas chaves de tradução ao pacote de tradução do aplicativo; o App Builder não as importa automaticamente.

Se editar a mensagem usando Mais > Editar HTML, adicione a chave de tradução como uma string simples em vez de HTML, ou a busca falhará.

Para mais informações sobre como configurar idiomas e pacotes de tradução, consulte Translations.

Etapa 3: Adicionar opções de resposta

Uma notificação pode, opcionalmente, incluir uma ou mais opções de resposta que permitem ao destinatário responder. Uma notificação sem opções é puramente informativa: o App Builder não rastreia uma resposta e nenhum link é adicionado à mensagem.

Quando uma notificação tem uma ou mais opções, o App Builder rastreia a resposta do destinatário automaticamente. Para emails e alertas do App Builder, cada opção é um link clicável de volta ao App Builder. Para SMS, o destinatário responde com o Nome da opção para selecioná-la.

Links de notificação expiram após 7 dias e não podem ser configurados para durarem mais.

Para adicionar uma opção de resposta a uma notificação:

  1. No painel Opções da notificação, clique no botão + Opção.
  2. Defina Índice para determinar a ordem da opção em relação a outras opções.
  3. Defina Nome para identificar a opção. Para uma opção de Resposta SMS, este é também o texto que o destinatário deve responder.
  4. Defina Tipo de Opção como Link ou Resposta SMS.
  5. Para uma opção de Link, selecione a página para vincular em Link Para Página. A página deve estar marcada como Pública nas suas configurações de Caso Extremo.
  6. Clique em Salvar.

Navegar até a página selecionada em Link Para Página completa a resposta para uma opção de Link. Se essa página também tiver um evento de lógica de negócios vinculado a ela, o evento será executado antes da página ser renderizada, e completar a resposta dependerá também da execução bem-sucedida desse evento. Consulte Vinculação de evento de objeto de dados abaixo para as restrições que se aplicam a esse evento.

Vinculação de evento de objeto de dados

Quando a página vinculada no campo Link Para Página de uma opção de resposta também tem um evento de lógica de negócios vinculado a ela, esse evento deve pertencer ao primeiro painel da página (o painel com o índice mais baixo, na posição superior esquerda) ou ao objeto de dados público da página, se um estiver definido. Eventos que pertencem a qualquer outro painel na página não podem ser vinculados a uma opção de resposta.

Por exemplo, considere uma página empilhada com dois grupos lado a lado: o primeiro, no índice 10, contém os painéis Customer e CustomerAddress, e o segundo, no índice 20, contém os painéis Employee e EmployeeAddress:

%%{init: {"themeVariables": {"lineColor": "#6b7280", "edgeLabelBackground": "#f5f5f5"}}}%% flowchart TD A["Index 10: Customer, CustomerAddress
(side by side)"] --> B["Index 20: Employee, EmployeeAddress
(side by side)"]

Customer é o primeiro painel da página, portanto seus eventos são elegíveis. CustomerAddress, Employee e EmployeeAddress não são elegíveis, pois nenhum deles é o primeiro painel da página.

O App Builder também permite apenas vincular a eventos personalizados, não a eventos do sistema. Por exemplo, você não pode vincular aos eventos Salvar, Inserir, Atualizar ou Deletar.

Quando o evento vinculado é concluído, o App Builder redireciona o destinatário para a página, mas qualquer mensagem pós-execução ou resultado de validação do evento é perdido naquele ponto, já que o App Builder não exibe esses elementos ao destinatário para eventos no nível de página. Você pode contornar isso exibindo dados nos painéis da página que mudam com base em se o evento foi executado com sucesso. Pela mesma razão, um aviso de validação simplesmente impede que o evento seja executado, porque não há mecanismos para o destinatário aceitá-lo ou rejeitá-lo.

Neste ponto, você tem tudo o que precisa para criar uma notificação: um servidor para entregá-la, uma regra que define sua mensagem e dados, e, opcionalmente, uma ou mais opções de resposta.

Passo a passo completo

Os exemplos a seguir apresentam um passo a passo completo do processo de criação de uma notificação, desde a configuração de um método de entrega até a adição de uma opção de resposta. O primeiro exemplo usa App Builder Alert como método de entrega; o segundo usa Mensagem de Texto (SMS).

Exemplo de configuração de notificação

Este exemplo adiciona uma notificação de aprovação de cliente à página Clientes de um aplicativo hipotético chamado Northwinds, usando App Builder Alert como método de entrega.

  1. Crie a notificação e defina seu método de entrega:

    1. Navegue até App Workbench.
    2. Clique em Notifications.
    3. Clique em + Notification.
    4. Atribua um Name. Por exemplo: CustomersRequestApprovalAlert.
    5. Confirme que Purpose é Notification.
    6. Selecione App Builder Alert como Delivery Method.

      Nota

      Se você não vir este objeto de dados disponível, crie uma conexão de fonte de dados para App Builder (Sealed) do aplicativo em que está trabalhando.

    7. Clique em Create.

  2. Defina o mvSQL da notificação, mapeando a tabela Customers para as colunas que o objeto App Builder Alert precisa:

    1. Clique no botão +Tables.
    2. Adicione sua tabela Select From, que neste caso é Customers.
    3. Adicione as seguintes colunas e clique na guia Columns para defini-las:

      Column Alias Target
      'all' To To
      "C".CustomerId CustomerId Binding()
      "C".CustomerName CustomerName

      Nota

      CustomerName é adicionado aqui para que possa ser usado posteriormente como parâmetro de substituição na mensagem de notificação.

  3. Escreva a mensagem da notificação:

    1. Navegue até App Workbench.
    2. Clique em Notifications.
    3. Selecione a notificação que você criou na etapa 1, que em nosso exemplo é CustomerRequestApprovalAlert.
    4. Digite a mensagem no campo Body, por exemplo:

      Please review the following customer:
      Customer: {{CustomerName}}

    5. Clique no ícone e digite qualquer Technical Help para ajudar a explicar a notificação a outros desenvolvedores.

  4. (Opcional) Adicione uma opção de resposta que se vincula a uma página:

    1. Na página App Workbench > Notifications, selecione a notificação.
    2. Clique no botão + Option.
    3. Crie uma nova opção:
      1. Defina Index como 10.
      2. Defina Name como Review.
      3. Selecione o valor Link To Page. Neste exemplo, vincule à página Customers. Se a página à qual deseja vincular não aparecer, verifique se foi marcada como Public em suas configurações Edge Case.
      4. Clique em Save.
  5. Este exemplo pressupõe que a página Customers já está marcada como Public, com um evento denominado Request Approval definido em seu primeiro painel. Vincule esse evento ao link da opção para que seja executado quando o destinatário o seguir:

    1. Navegue até o evento do objeto de dados.
    2. Clique no ícone Business Logic.
    3. Clique no botão Events.
    4. Selecione o evento. Por exemplo: Request Approval.
    5. Clique em Register Existing no painel Actions.
    6. Selecione Notification como Action Type.
    7. Selecione a notificação que criamos na etapa anterior. Por exemplo: CustomerRequestApprovalAlert.
    8. Clique em Save.
    9. Verifique se os Explicit Bindings estão corretos. Por exemplo: CustomerId - CustomerId.
  6. Teste a notificação. Navegue até sua página e clique no botão que executa o evento de notificação. Todos os usuários do App Builder conectados devem ver um popup com a mensagem de notificação.

Exemplo de configuração de notificação por SMS

Este exemplo adiciona a mesma notificação de aprovação de cliente à mesma página Customers, usando Text Message (SMS) como método de entrega.

Nota

Você precisará de uma conta Twilio para concluir a configuração.

  1. Configure a segurança do App Builder para que o App Builder possa autenticar respostas SMS recebidas do Twilio:

    1. Navegue até IDE > Security Providers.
    2. Clique em + Security Provider.
      1. Digite um Name (por exemplo, Http Basic Auth).
      2. Selecione HTTP Basic Authentication como Type.
      3. Clique em Enabled para ativar.
      4. Clique em Save.
    3. Navegue até IDE > User Management.

      1. No painel Users, localize o usuário que deseja autenticar quando uma resposta SMS chega. Clique duas vezes na linha do usuário ou clique no ícone ao final dela. A caixa de diálogo User é aberta.

        Nota

        Esse usuário deve ter acesso à aplicação App Builder e ao evento que será executado na própria notificação.

      2. Clique em More > Keys. A caixa de diálogo Keys será aberta.

      3. Clique em Create. A caixa de diálogo Generate Key será aberta.
      4. Selecione o provedor Http Basic Auth criado anteriormente.
      5. Clique em Save.

    Nota

    Esse provedor cria uma Key secreta. A combinação do User Name e da Key secreta será usada ao configurar o Twilio.

  2. Configure o Twilio para enviar e receber mensagens SMS:

    1. Crie um serviço de mensagens:

      1. Faça login na sua conta do Twilio.
      2. Navegue até Communications Cloud > Programmable SMS.
      3. Clique em Messaging Services.
      4. Crie um novo Messaging Service (Notifications, 2-way) e anexe um número de telefone do Twilio a ele.
      5. Anote o MessagingServiceSid. Ele será usado para configuração posteriormente.
      6. Ative a opção Process Inbound Message.
      7. Digite a seguinte URL de requisição, substituindo <username>, <secret_key> e <your_AppBuilder_Server> pelos seus valores: https://<username>:<secret_key>@<your_AppBuilder_Server>/webhook/v1/vinyl/bridge_inbound
    2. Reúna as credenciais do Twilio:

      1. Navegue até Console Dashboard > Settings.
      2. Anote as seguintes credenciais ativas:
        • Account Sid
        • Auth Token
  3. Conecte o App Builder ao Twilio, usando as credenciais coletadas na etapa anterior:

    1. Navegue até IDE > Notification Servers.
    2. Clique duas vezes na linha SMS.
    3. Adicione a seguinte configuração:
      • User Name: Digite seu Account Sid do Twilio.
      • Password: Digite seu Auth Token do Twilio.
      • MessagingServiceSid: Digite seu MessagingServiceSid do Twilio.
  4. Defina a URL do site que o App Builder usa ao gerar links na mensagem SMS:

    1. Navegue até IDE > Security Providers.
    2. Em Configuration, clique em More > Sites.
    3. Clique em + Site.
    4. Defina o valor da URL para a URL do seu site. Por exemplo: https://vinyl.jitterbit.com.
    5. Clique em Save.
  5. Agora, crie e configure a própria notificação por SMS, seguindo o mesmo processo geral do exemplo anterior, mas desta vez, em vez de App Builder Alert, selecione Text Message como o Delivery Method:

    1. Crie a notificação e defina seu método de entrega:

      1. Navegue até App Workbench > Notifications.
      2. Clique em + Notification.
      3. Atribua um Name a ela.
      4. Selecione Notification como o Purpose.
      5. Selecione Text Message como o Delivery Method.

        Nota

        Se você não vir esse objeto de dados disponível, crie uma conexão de fonte de dados para App Builder (Sealed) para o aplicativo em que você está trabalhando.

      6. Clique em Create.

    2. Defina o mvSQL da notificação, mapeando as colunas de número de telefone e cliente para o objeto Text Message:

      1. Clique no botão +Table e adicione a tabela que a regra requer. Por exemplo: Customers.

      2. Clique na aba Columns e adicione as seguintes colunas:

        Column Alias Target
        '+15551112222' (substitua pelo seu número de telefone) To() To()
        "C".CustomerId CustomerId Binding()
        "C".CustomerName CustomerName

        Nota

        CustomerName é adicionado aqui para que possa ser usado posteriormente como parâmetro de substituição na mensagem de notificação.

    3. Escreva a mensagem e adicione duas opções de resposta: uma que o destinatário pode responder por SMS e outra que vincula a uma página:

      1. Clique na guia Notificações.
      2. Digite a seguinte mensagem no campo Corpo:

        Reply {{1}} to approve {{CustomerName}}. Review {{Review}}
        
      3. Clique no botão + Opção do painel Opções:

        1. Defina Índice como 10.
        2. Defina Nome como Review.
        3. Selecione a página para vincular. No nosso exemplo, vamos vincular à página Customer do Northwinds. Se a página que deseja vincular não aparecer, certifique-se de que ela foi marcada como Pública nas configurações de Edge Case.
        4. Defina o Tipo de Opção como Link.
        5. Clique em Salvar.
      4. Clique no botão + Opção do painel Opções:

        1. Defina Índice como 20.
        2. Defina Nome como 1.
        3. Selecione a página para vincular. No nosso exemplo, vamos vincular à página Customer do Northwinds e executar o evento Approve.
        4. Defina o Tipo de Opção como Resposta SMS.
        5. Clique em Salvar.
    4. Este exemplo presume que a página Customers já está marcada como Pública, com um evento denominado Request Approval definido em seu primeiro painel. Vincule esse evento à opção Link para que seja executado quando o destinatário a seguir:

      1. Navegue até o evento do objeto de dados.
      2. Clique no ícone Business Logic.
      3. Clique no botão Eventos.
      4. Selecione o evento. Por exemplo: Request Approval.
      5. Clique em Registrar Existente no painel Ações.
      6. Selecione Notificação como o Tipo de Ação.
      7. Selecione a notificação que criamos na etapa anterior. Por exemplo: Customer_RequestApprovalSms.
      8. Clique em Salvar.
      9. Verifique se as Vinculações Explícitas estão corretas. Por exemplo: CustomerId - CustomerId.
    5. Teste a notificação. Navegue até sua página e clique no botão que executa o evento de notificação.

Notificações do sistema

Ao contrário das notificações descritas anteriormente nesta página, que o App Builder envia automaticamente para um destinatário específico quando ocorre um evento de negócio, notificações do sistema são mensagens transmitidas que um administrador envia manualmente ou agenda para enviar posteriormente a um grupo de usuários de uma vez, por exemplo, todos com acesso a um aplicativo, ou um grupo de segurança ou função específica. Os administradores usam notificações do sistema para coisas como janelas de manutenção planejadas ou atualizações de aplicativos, que não precisam estar vinculadas a um registro específico ou acionadas por um evento.

As notificações do sistema são mostradas aos usuários ativos e permanecem em seu Centro de Notificações (no menu hambúrguer) até serem descartadas ou expiradas. As notificações do sistema fazem parte do recurso Manutenção e oferecem suporte apenas a alertas no aplicativo. Elas também são específicas do ambiente: ao contrário das notificações de aplicativo, que são promovidas com seu código entre ambientes, uma notificação do sistema deve ser recriada em cada ambiente.

Para configurar uma notificação do sistema, selecione IDE > Manutenção, depois selecione a guia Notificações (disponível desde o App Builder 4.44) e siga estas etapas:

  1. No painel Notificações Agendadas, clique no botão Agendar ou Enviar Agora.

  2. Na caixa de diálogo Notificação, digite valores para os seguintes campos:

    • Para: Clique no campo e selecione um dos seguintes:

      • Todos
      • Um grupo de usuários com base no seguinte:

        • Seu acesso a um aplicativo ou fonte de dados concedido por seus grupos ou funções.

        • Grupos de segurança.

        • As funções da fonte de dados.

    • De: Define quem enviou a notificação (geralmente o usuário de serviço).

    • Agendar Para: (Opcional) Agende uma notificação para ser enviada posteriormente (por exemplo, uma hora antes de uma atualização planejada do aplicativo).

    • Expira Em: Uma data/hora quando a notificação expira e não será mais mostrada aos usuários. Neste momento, os usuários que viram e descartaram a mensagem terão a notificação removida de seus centros de notificações.

  3. Body: O conteúdo da mensagem exibida aos usuários.

  4. Clique no botão Enviar ou Agendar.

Um serviço de fundo envia notificações agendadas. Por padrão, o serviço é executado pela conta Service User. Para alterar qual usuário executa o serviço, siga estas etapas:

  1. Selecione IDE > Maintenance, depois selecione a guia Settings.

  2. Clique no menu Background Notification User, depois selecione o usuário para executar o serviço.