Variáveis de notificação

  • Versão de lançamento: Yokohama
  • Atualizado 30 de jan. de 2025
  • 2 min. de leitura

    • Use variáveis de notificação para exibir informações dinâmicas no corpo de uma notificação, como um valor de campo, um link para um registro ou um link para as preferências do sistema.

    Sintaxe

    Especifique uma variável de notificação usando esta sintaxe:

    ${variable-name+variable-parameters}

    A parte variable-name é sempre necessária. Nem todas as variáveis de notificação são compatíveis com a parte de parâmetros de variável. Quando disponíveis, a maioria dos parâmetros variáveis é opcional. Consulte a lista de variáveis de notificação disponíveis para nomes de variáveis e parâmetros disponíveis.

    Variáveis disponíveis

    O sistema fornece essas variáveis de notificação.

    Tabela 1. Variáveis de notificação disponíveis
    Variável Descrição Parâmetros disponíveis
    ${field-name} Exibir o valor do campo especificado. Nenhum(a)
    ${nome-do-campo-da-imagem} Exibir uma imagem associada a um registro. Esta variável é normalmente usada com HTML para especificar a origem de um elemento de imagem. Nenhum(a)
    • ${URI}
    • ${URI_REF}
    		 Exibir um link para o registro atual.
    • URI: o texto do link é a palavra LINK.
    • URI_REF: o texto do link é o valor de exibição do registro.
    Nota:
    Essas variáveis não se aplicam a registros em Espaço. Para vincular a um registro em Espaço, crie um script de e-mail que imprima um URL em uma notificação. Para obter mais informações, consulte Vinculando a um registro no Espaço.
    		 Qualquer parâmetro de URL sysparm válido. Por exemplo:
    • sysparm_scriptlet
    • sysparm_view
    • ${campo de referência.URI}
    • ${campo de referência.URI_REF}
    		 Exibir um link para o registro listado em um campo de referência.
    • URI: o texto do link é a palavra LINK
    • URI_REF: o texto do link é o valor de exibição do registro.
    		 Qualquer parâmetro de URL sysparm válido. Por exemplo:
    • sysparm_scriptlet
    • sysparm_view
    ${CMS_URI} Exibir um link para o registro especificado em uma página do CMS. <CMS-site>/<CMS-page>: o caminho relativo necessário para a página do CMS.
    ${notificação:corpo} Exibir o conteúdo do corpo de um modelo de e-mail ou notificação por e-mail. Use esta variável de notificação para especificar onde exibir o conteúdo do corpo em um layout de e-mail. Nenhum(a)
    ${mail_script:script-name} Executar o script de e-mail especificado. Nenhum(a)
    ${NOTIF_UNSUB} Exibir um link de cancelamento de assinatura desta notificação. link_text: especifique o texto a ser exibido como um link entre aspas.
    ${NOTIF_PREFS} Exibir um link para definir preferências de notificação. link_text: especifique o texto a ser exibido como um link entre aspas.
    ${comentários:n}

    Exiba os comentários mais recentes que foram feitos no registro de destino. O número de comentários a serem exibidos é n. Por exemplo, ${comments:3} exibe os últimos três comentários que foram feitos no registro.

    Para exibir todos os comentários, use a variável ${comments}.

    		 Qualquer número maior que 0.
    ${comments_and_work_notes:n}

    Exibe os comentários e anotações de trabalho mais recentes que foram feitos no registro de destino. O número de comentários e anotações de trabalho a serem exibidos é n. Por exemplo, ${comments_and_work_notes:3} exibe os últimos três comentários e anotações de trabalho que foram feitos no registro.

    Para exibir todos os comentários e anotações de trabalho, use a variável ${comments_and_work_notes}.

    		 Qualquer número maior que 0.

    Exemplos

    Consulte os exemplos a seguir para ver como cada variável de notificação é renderizada na saída:
    Variável Exemplo
    ${field-name}

    Origem: incidente ${number} - comentários adicionados

    Saída: incidente INC1000001 - comentários adicionados
    ${nome-do-campo-da-imagem}

    Origem: <img src='${picture}?t=medium'/>

    Saída: variável de imagem de notificação
    • ${URI}
    • ${URI_REF}

    ${URI} Origem: Clique aqui para exibir o incidente: ${URI}

    ${URI} Saída: exemplo que mostra como a palavra de texto do link Link serve como link para o registro atual

    ${URI_REF} Origem: Clique aqui para exibir o incidente: ${URI_REF}

    Saída ${URI_REF}: exemplo que mostra como o texto do link exibido é o valor do registro
    • ${campo de referência.URI}
    • ${campo de referência.URI_REF}
    Origem: 
    Click here to view Incident: ${URI_REF}
Click here to view Related Problem: ${problem_id.URI_REF}

    Saída: exemplo que mostra um link para um registro listado em um campo de referência
    ${CMS_URI}

    Origem: ${CMS_URI+ess/incident_detail}

    Saída: um link para uma página do CMS de destino, como https://<instance name> .service-now.com/ess/incident_detail.do?sysparm_document_key=incident,46e18c0fa9fe19810066a0083f76bd56
    ${notificação:corpo}

    Origem: como uma variável para o corpo do e-mail funciona em um layout de e-mail.

    Saída: como a variável do link para preferências de notificação funciona.
    ${mail_script:script-name}
    ${NOTIF_UNSUB}
    ${NOTIF_PREFS}