Preferências - Com escopo, Global

A API Preferences obtém destinos de notificação para um usuário.

Um destino de notificação está em algum 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 meio de 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 e-mail comercial. Os tipos de destino são listados na tabela Tipo de destino de notificação [sys_notif_destination_type].

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

Esta classe usa o identificador de namespace sn_notification.

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] parahe 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 objetos PreferenceDestination. 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 ohe canal que você deseja filtrar.

Tabela 5. Retorna

Tipo	Descrição
Matriz	Matriz de objetos PreferenceDestination. Se o usuário não tiver destinos de notificação que usem 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 do Workspace. A saída mostra que Abel tem um destino que usa o canal do Workspace.

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]