Modificações de mensagens de notificação de atividade

Este artigo contém os seguintes tópicos:
casm173
Este artigo contém os seguintes tópicos:
As mensagens de notificação podem ser enviadas automaticamente quando ocorrem atividades de solicitação.
Dois dos campos que devem ser definidos na janela Detalhes de notificação de atividade são Título da mensagem de notificação e Corpo da mensagem de notificação. Ambos os campos podem conter atributos do objeto de log de atividades (alg para Solicitações/Incidentes/Problemas, chgalg para Requisições de mudança e issalg para Ocorrências; esses três objetos de log de atividades são quase idênticos) e podem identificar a solicitação específica relacionada à atividade.
Formatando atributos para notificações de atividade
A formatação e o escape opcionais de atributos individuais podem ser obtidos usando-se as propriedades listadas a seguir. Isso pode ser útil especialmente ao formatar notificações em HTML, em que os dados do atributo talvez precisem ser precedidos por caracteres de escape para adequação aos padrões de HTML.
Para incluir a formatação, use a seguinte sintaxe:
@{property=value property=value:attribute_name}
Os pares de valores da propriedade são separados por pelo menos um espaço e não diferenciam maiúsculas de minúsculas. Um sinal de dois pontos separa as propriedades de formatação do nome de atributo. Se não houver nenhuma propriedade listada, não será aplicada nenhuma formatação ou carácter de escape ao atributo.
A tabela a seguir apresenta as propriedades de formatação disponíveis:
Propriedade
Descrição
DATE_FMT
Especifica o formato de data do atributo. Os valores válidos são:
MM/DD/YYYY
MM-DD-YYYY
DD/MM/AAAA
DD-MM-YYYY
AAAA/MM/DD
YYYY-MM-DD
Válidos somente para atributos de data. As datas incorporadas a seqüências de caracteres não são afetadas.
ESC_STYLE=NONE |
HTML |
URL
Especifica o tipo de escape do texto formatado. Os valores válidos são:
NONE
Configuração padrão. Especifica que nenhum tratamento especial seja dado a qualquer caractere do corpo do conteúdo.
HTML
Dar tratamento especial aos seguintes caracteres, que são significativos em texto HTML:
& torna-se &
”_ torna-se "
< torna-se <
> torna-se %gt;
URL
Converta todos os caracteres que não sejam letras, dígitos e '@*-_.#' a ' % xx', onde xx é a codificação hexadecimal do caractere convertido.
JUSTIFY=LEFT |
CENTER |
RIGHT |
TRUNCATE|
WRAP |
LINE
Especifica a justificação do texto formatado. Os valores válidos são:
TRUNCATE
(padrão em formatação) Trunca o texto de acordo com o valor da propriedade WIDTH se for um número inteiro positivo. Se ESC_STYLE=HTML, elimina a formatação HTML substituindo '<' e '>' por < e > (consulte KEEPLINKS e KEEPTAGS).
LEFT|CENTER|RIGHT
Produz o número exato de caracteres de WIDTH, truncados ou preenchidos com espaços, conforme necessário.As novas linhas incorporadas são substituídas por um único espaço. Se ESC_STYLE = HTML, o texto de saída é delimitado por [defina a pré-variável de seu registro] e marcas </pre>. O argumento WIDTH (largura) deve ser especificado como um número inteiro positivo.
WRAP
Mesmo que LEFT, exceto que a quebra de texto respeita os limites das palavras (as quebras de linha não são colocadas dentro de palavras).
LINE
Igual a TRUNCATE, exceto que também substitui todas as quebras de linha incorporadas por marcas <BR>, se ESC_STYLE=HTML.
A sintaxe deve ser usada no seguinte formato:
@{justify=truncate width=30:call_req_id.summary}
É possível alterar o parâmetro de largura adequadamente.
KEEPLINKS=YES|NO
Se KEEPLINKS=YES for especificado, a ação de JUSTIFY=LINE ou JUSTIFY=TRUNCATE será modificada para preservar as marcas de âncora de HTML ( ) durante a conversão de todos os outros caracteres '<' e '>'. Mutuamente exclusivo com KEEPTAGS. Somente válido se ESC_STYLE=HTML.
KEEPNL=YES|NO
A ação normal do PDM_FMT é converter todas as novas linhas integradas e quaisquer espaços que se seguem em um único espaço. Se KEEPNL=YES for especificado, as novas linhas integradas serão preservadas. Esse argumento é ignorado para JUSTIFY=LINE.
KEEPTAGS=YES|NO
Se KEEPTAGS=YES é especificado, a ação de JUSTIFY=LINE ou JUSTIFY=TRUNCATE é modificada para preservar todas as marcas HTML. Mutuamente exclusivo com KEEPLINKS. Somente válido se ESC_STYLE=HTML.
PAD=YES|NO
Se PAD=NO é especificado, PDM_FMT não converte sequências vazias em um único espaço. Esta é a ação normal quando WIDTH é diferente de zero ou JUSTIFY é TRUNCATE ou WRAP.
WIDTH=
nn
Quando diferente de zero, especifica que o texto deve ser formatado com o número exato de caracteres de WIDTH.
Por exemplo, para formatar a descrição da solicitação de uma notificação em HTML inserindo caracteres de escape específicos de HTML, adicionando marcas <BR> para quebras de linha e mantendo todos os links HTML como links, digite o seguinte:
@{ESC_STYLE=HTML JUSTIFY=LINE KEEPLINKS=YES:call_req_id.description}
Para mudar o formato de open_date de uma solicitação para o formato europeu, digite o seguinte:
@{DATE_FMT=DD-MM-YYYY:call_req_id.open_date}
Atributos do objeto de log de atividades
Para incluir um atributo do objeto de log de atividades, inclua o seguinte no campo Título da mensagem de notificação ou Corpo da mensagem de notificação:
@{att_name}
O nome do objeto (alg, chgalg ou issalg) é o padrão e não precisa ser especificado. Por exemplo, para incluir o tipo de atividade no título da mensagem, digite o seguinte no campo Título da mensagem de notificação (juntamente com a parte restante que deseja incluir no título):
@{type}
Para incluir a descrição da atividade no corpo da mensagem, digite o seguinte no campo Corpo da mensagem de notificação (juntamente com a parte restante que deseja incluir no corpo):
@{description}
Informações sobre requisições de mudança específicas
Para que as mensagens forneçam informações sobre a requisição de mudança específica que acionou a notificação, os campos Título da mensagem de notificação ou Corpo da mensagem de notificação devem conter um atributo no objeto de log de atividades que faça referência ao objeto de requisição de mudança. Insira a referência neste formato:
@{change_id.chg_att_name}
Nesta referência, as informações a seguir se aplicam:
  • @
    Indica substituir essa expressão.
  • change_id
    O atributo no objeto de log de atividades que o vincula a uma instância específica do objeto de requisição de mudança (chg).
  • nome_do_atributo_chg
    Qualquer atributo do objeto chg.
Por exemplo, para incluir a prioridade da requisição de mudança no título da mensagem, digite o que segue no campo Título da mensagem de notificação, junto com o restante a ser incluído no título:
@{change_id.priority.sym}
Para identificar quem informou a requisição de mudança (Usuário final afetado) no corpo da mensagem, insira o seguinte no campo Corpo da mensagem de notificação (junto com o que mais você quiser incluir no corpo):
@{change_id.requestor.combo_name}
Se você desejar reabrir uma requisição de mudança específica por número e quiser que a mensagem apareça como segue, use a sintaxe a seguir:
Reopen Change Order @{change_id.chg_ref_num}
Para que as mensagens forneçam informações sobre uma ocorrência que disparou uma notificação, os campos Título da mensagem de notificação ou Corpo da mensagem de notificação devem conter um atributo no objeto de log de atividades que faça referência ao objeto de ocorrência, iss. Para obter mais informações sobre objetos e atributos, consulte a seção Comandos de referência do CA Service Desk Manager.
Por exemplo, para incluir a prioridade da ocorrência no título da mensagem, digite o que segue no campo Título da mensagem de notificação, junto com as informações adicionais que você deseja no título:
@{issue_id.priority.sym}
Informações sobre solicitações específicas
Para que as mensagens forneçam informações sobre a solicitação específica que acionou a notificação, os campos Título da mensagem de notificação ou Corpo da mensagem de notificação devem conter um atributo no objeto de log de atividades que faça referência ao objeto de solicitação. Digite esta referência neste formato:
@{call_req_id.cr_att_name}
  • @
    Indica substituir essa expressão.
  • call_req_id
    O atributo no objeto de log de atividades que o vincula a uma instância específica do objeto de solicitação (cr).
  • nome_do_atributo_cr
    Qualquer atributo do objeto cr.
Por exemplo, para incluir o impacto da solicitação no título da mensagem, digite o seguinte no campo Título da mensagem de notificação (juntamente com a parte restante que deseja incluir no título):
@{call_req_id.impact.sym}
Para identificar o recurso afetado no corpo da mensagem, digite o seguinte no campo Corpo da mensagem de notificação (juntamente com a parte restante que deseja incluir no corpo):
@{call_req_id.affected_resource.name}
Se desejar reabrir uma requisição de mudança específica por número e quiser que a mensagem apareça como segue, use a sintaxe a seguir:
Reopen Request @{call_req_id.ref_num}
Há vários outros mecanismos pelos quais as mensagens podem ser enviadas e que estão no contexto da solicitação (ou requisição de mudança ou ocorrência) em si. Quando o contexto é a própria solicitação, não é necessário (nem possível) usar a parte "call_req_id" da referência. Nesses casos, é necessário usar:
"@{ref_num}" rather than "@{call_req_id.ref_num}"