---
sourceDocument: Referência de API do Xanadu
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - pt-BR

ft:publication_title :

    - Referência de API do Xanadu

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# Preferências - Com escopo, Global

# Preferências - Com escopo, Global {#ariaid-title1}

* Versão de lançamento: Xanadu
* 
* Atualizado 1 de ago. de 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 min. de leitura

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](https://servicenow-prod.fluidtopics.net/xd3nVfN8oXASysgOFT1kNw#PreferenceDestinationBothAPI "A API PreferenceDestination atualiza as preferências de notificação do usuário.") 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) {#ariaid-title2}

Instancia um objeto Preferências para um usuário especificado.
{#Preferences-Preferences_O__table_bkn_fx3_wnb__entry__3}

| 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. |
[Tabela 1. Parâmetros]

{#Preferences-Preferences_O__table_bkn_fx3_wnb}  
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() {#ariaid-title3}

Retorna os destinos de notificação de um usuário.
{#Preferences-getDestinations__table_ept_hx3_wnb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| Nenhum |   |   |
[Tabela 2. Parâmetros]

{#Preferences-getDestinations__table_ept_hx3_wnb} {#Preferences-getDestinations__table_fpt_hx3_wnb__entry__2}

| Tipo | Descrição |
|-|-|
| Matriz | Matriz de objetos [PreferenceDestination](https://servicenow-prod.fluidtopics.net/xd3nVfN8oXASysgOFT1kNw#PreferenceDestinationBothAPI "A API PreferenceDestination atualiza as preferências de notificação do usuário."). Se o usuário não tiver destinos, a matriz estará vazia. |
[Tabela 3. Retorna]

{#Preferences-getDestinations__table_fpt_hx3_wnb}  
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) {#ariaid-title4}

Retorna os destinos de notificação de um usuário que usam um canal especificado.
{#Preferences-getDestinationsByChannel_O__table_x4m_lx3_wnb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| canal | GlideRecord | GlideRecord da tabela Canal de notificação \[sys_notification_channel\] para ohe canal que você deseja filtrar. |
[Tabela 4. Parâmetros]

{#Preferences-getDestinationsByChannel_O__table_x4m_lx3_wnb} {#Preferences-getDestinationsByChannel_O__table_y4m_lx3_wnb__entry__2}

| Tipo | Descrição |
|-|-|
| Matriz | Matriz de objetos [PreferenceDestination](https://servicenow-prod.fluidtopics.net/xd3nVfN8oXASysgOFT1kNw#PreferenceDestinationBothAPI "A API PreferenceDestination atualiza as preferências de notificação do usuário."). 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. |
[Tabela 5. Retorna]

{#Preferences-getDestinationsByChannel_O__table_y4m_lx3_wnb}  
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]