Preferências - Com escopo, Global

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 1 min. de leitura
  • . Preferências A API obtém destinos de notificação para um usuário.

    Um destino de notificação é um lugar para o qual uma notificação pode ser entregue, como um endereço de e-mail ou número de telefone específico. Esta API é baseada em notificações da tabela Notificação [sys_notification]. As notificações são enviadas por canais como e-mail ou Espaço. Um canal pode ser usado para enviar notificações para vários tipos de destinos. Por exemplo, um canal de e-mail pode enviar notificações para destinos de e-mail pessoal e trabalho. Os tipos de destino são listados na tabela Tipo de destino de notificação [sys_notif_destination_type].

    Use esta API com PreferenceDestination API para atualizar as preferências de notificação do usuário.

    Esta classe usa sn_notification identificador de namespace.

    Preferências - Preferências (destinatário do GlideRecord)

    Instancia um objeto Preferências para um usuário especificado.

    Tabela 1. Parâmetros
    Nome Tipo Descrição
    destinatário GlideRecord GlideRecord da tabela Usuário [sys_user] para t ele usuário para o qual você deseja obter destinos de notificação.

    Este exemplo instancia um objeto Preferências para o usuário Abel Tuter.

    var recipient = new GlideRecord('sys_user'); 
    recipient.get('last_name', 'Tuter'); 
    var prefs = new sn_notification.Preferences(recipient);

    Preferências - getDestinations()

    Retorna os destinos de notificação de um usuário.

    Tabela 2. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 3. Retorna
    Tipo Descrição
    Matriz Matriz de PreferenceDestination objetos. Se o usuário não tiver destinos, a matriz estará vazia.

    Este exemplo obtém todos os destinos de notificação de Abel Tuter. A saída mostra que Abel tem um destino.

    var recipient = new GlideRecord('sys_user'); 
    recipient.get('last_name', 'Tuter'); 
    var prefs = new sn_notification.Preferences(recipient);
    var dests = prefs.getDestinations();
    gs.print(dests);

    Saída:

    [object PreferenceDestination]

    Preferências - getDestinationsByChannel (canal GlideRecord)

    Retorna os destinos de notificação de um usuário que usam um canal especificado.

    Tabela 4. Parâmetros
    Nome Tipo Descrição
    canal GlideRecord GlideRecord da tabela Canal de notificação [sys_notification_channel] para t ele canal que você deseja filtrar.
    Tabela 5. Retornos
    Tipo Descrição
    Matriz Matriz de PreferenceDestination objetos. Se o usuário não tiver destinos de notificação que usam o canal ou se o canal não existir, a matriz estará vazia.

    Este exemplo obtém todos os destinos de Abel Tuter que usam o canal Espaço. A saída mostra que Abel tem um destino que usa o canal Espaço.

    var recipient = new GlideRecord('sys_user'); 
    recipient.get('last_name', 'Tuter'); 
    var prefs = new sn_notification.Preferences(recipient);
    var channel = new GlideRecord('sys_notification_channel');
    channel.get('name', 'Workspace'); 
    var dests = prefs.getDestinationsByChannel(channel);
    gs.print(dests);

    Saída:

    [object PreferenceDestination]