Modifications des messages de notification d’activité

Cet article contient les rubriques suivantes :
casm173
Cet article contient les rubriques suivantes :
Des messages de notification peuvent être envoyés automatiquement lorsque des activités de demande interviennent.
Deux des champs à définir dans la fenêtre Détail des notifications d’activité sont Titre du message de la notification et Corps du message de la notification. Ces deux champs peuvent contenir des attributs de l'objet journal d'activité (alg pour Demandes/Incidents/Problèmes, chgalg pour Demandes de changement et issalg pour Demandes client). Ces trois objets journal d'activité sont pratiquement identiques et permettent d'identifier la demande spécifique associée à l'activité.
Mise en forme d’attributs pour les notifications d’activité
Vous pouvez utiliser les propriétés répertoriées ci-après pour éventuellement mettre en forme et remplacer certains attributs. Ceci peut être particulièrement utile lors de la mise en forme de notifications HTML dans lesquelles les données de l'attribut doivent être remplacées pour être en conformité avec les normes HTML.
Pour inclure une mise en forme, utilisez la syntaxe suivante :
@{property=value property=value:attribute_name}
Les paires de valeurs de propriétés sont séparées au moins par un espace et ne distinguent pas les majuscules et les minuscules. Le signe deux-points sépare les propriétés de mise en forme du nom de l’attribut. Si aucune propriété n’est répertoriée, aucune mise en forme et aucun remplacement ne sera effectué sur l’attribut.
Le tableau suivant présente les propriétés de mise en forme disponibles :
Propriété
Description
DATE_FMT
Spécifie le format de date de l’attribut. Les valeurs valides sont :
MM/DD/YYYY
MM-DD-YYYY
DD/MM/YYYY
DD-MM-YYYY
YYYY/MM/DD
YYYY-MM-DD
Valide uniquement pour les attributs Date. Les dates incorporées dans des chaînes ne sont pas concernées.
ESC_STYLE=NONE |
HTML |
URL
Spécifie le type de « traitement » appliqué au texte formaté. Les valeurs valides sont :
NONE
Paramètre par défaut. Aucun traitement spécial n'est appliqué à aucun caractère du corps du contenu.
HTML
Un traitement spécial est appliqué aux caractères suivants, qui ont une signification dans le texte HTML :
& devient &amp ;
"_ devient &quot ;
< devient &lt ;
> devient %gt;
URL
Convertit tous les caractères autres que les lettres, les chiffres et « @*-_.#' en '%xx », où xx est le codage hexadécimal du caractère converti.
JUSTIFY=LEFT |
CENTER |
RIGHT |
TRUNCATE|
WRAP |
LINE
Spécifie l'alignement du texte formaté. Les valeurs valides sont les suivantes :
TRUNCATE
(mise en forme par défaut) Tronque le texte à la valeur de la propriété WIDTH s’il s’agit d’un entier positif. Si ESC_STYLE=HTML, élimine la mise en forme HTML en remplaçant « < » et « > » par < et > (voir KEEPLINKS et KEEPTAGS).
LEFT|CENTER|RIGHT
Génère des caractères dont la largeur est exactement égale à WIDTH, en ajoutant ou en supprimant des espaces si nécessaire et en remplaçant les nouvelles lignes incorporées par un espace. Si ESC_STYLE=HTML, le texte de sortie est délimité par les balises [variable_pre_définie_pour_votre_livre] et . L'argument WIDTH doit être spécifié sous la forme d'un entier positif.
WRAP
Identique à LEFT, à la différence près que le renvoi automatique à la ligne respecte les limites des mots (un saut de ligne n'est pas placé au sein d'un mot).
LINE
Identique à TRUNCATE, à la différence près que tous les sauts de ligne incorporés sont également remplacés par des balises si ESC_STYLE=HTML.
La syntaxe doit respecter le format suivant :
@{justify=truncate width=30:call_req_id.summary}
Vous pouvez modifier le paramètre de largeur en conséquence.
KEEPLINKS=YES|NO
Si KEEPLINKS=YES est spécifié, l'action de JUSTIFY=LINE ou JUSTIFY=TRUNCATE est modifiée pour conserver les balises d'ancrage HTML (Action:) tout en convertissant tous les autres caractères « < » et « > ». Exclusion mutuelle avec KEEPTAGS. Valide uniquement si ESC_STYLE=HTML.
KEEPNL=YES|NO
L'action normale de PDM_FMT consiste à convertir toutes les nouvelles lignes incorporées et les espaces qui suivent en un espace unique. Si KEEPNL=YES est spécifié, les nouvelles lignes incorporées sont conservées. Cet argument est ignoré pour JUSTIFY=LINE.
KEEPTAGS=YES|NO
Si KEEPTAGS=YES est spécifié, l'action de JUSTIFY=LINE ou JUSTIFY=TRUNCATE est modifiée pour conserver toutes les balises HTML. Exclusion mutuelle avec KEEPLINKS. Valide uniquement si ESC_STYLE=HTML.
PAD=YES|NO
Si PAD=NO est spécifié, PDM_FMT ne convertit pas les chaînes vides en un espace unique. Il s'agit de l'action normale lorsque WIDTH est différent de zéro, ou JUSTIFY est TRUNCATE ou WRAP.
WIDTH=
nn
Lorsque la valeur est différente de zéro, spécifie que les caractères doivent avoir une largeur exactement égale à WIDTH pour la mise en forme du texte.
Par exemple, pour mettre en forme la description de la demande d'une notification HTML en remplaçant des caractères propres au HTML, en ajoutant des balises pour les sauts de lignes et en conservant tous les liens HTML en tant que liens, saisissez la commande suivante :
@{ESC_STYLE=HTML JUSTIFY=LINE KEEPLINKS=YES:call_req_id.description}
Pour mettre en forme la valeur open_date d'une demande au format européen, saisissez la commande suivante :
@{DATE_FMT=DD-MM-YYYY:call_req_id.open_date}
Attributs de l’objet journal d’activité
Pour inclure un attribut de l'objet journal d'activité, entrez ce qui suit dans le champ Titre du message de la notification ou Corps du message de la notification :
@{att_name}
Notez que le nom de l'objet (alg, chgalg ou issalg) est la valeur par défaut, et qu'il n'est donc pas nécessaire de le préciser. Par exemple, pour inclure le type de l'activité dans le titre du message, entrez ce qui suit dans le champ Titre du message de la notification (ainsi que le reste du texte que vous souhaitez voir figurer dans le titre) :
@{type}
Pour inclure la description de l'activité dans le corps du message, entrez ce qui suit dans le champ Corps du message de la notification (ainsi que le reste du texte que vous souhaitez voir figurer dans le corps du message) :
@{description}
Informations sur des demandes de changement spécifiques
Pour que les messages puissent fournir des informations sur la demande de changement spécifique ayant déclenché la notification, le champ Titre du message de la notification ou Corps du message de la notification doit contenir un attribut dans l'objet journal d'activité qui fait référence à l'objet demande de changement. Entrez la référence dans ce format :
@{change_id.chg_att_name}
Dans cette référence, les informations suivantes s'appliquent :
  • @
    Indique que cette expression doit être remplacée.
  • change_id
    Attribut de l'objet journal d'activité qui le lie à une instanciation spécifique de l'objet demande de changement (chg).
  • chg_att_name
    Tout attribut de l’objet chg.
Par exemple, pour inclure la priorité la demande de changement dans le titre du message, entrez ce qui suit dans le champ Titre du message de la notification (ainsi que le reste du texte que vous voulez voir figurer dans le titre) :
@{change_id.priority.sym}
Pour identifier la personne ayant rapporté l'odre de changement (Utilisateur final affecté) dans le corps du message, entrez ce qui suit dans le champ Corps du message de la notification (ainsi que le reste du texte que vous voulez voir figurer dans le corps du message) :
@{change_id.requestor.combo_name}
Si vous voulez rouvrir une demande de changement spécifique par numéro et que vous voulez que le message apparaisse comme suit, utilisez la syntaxe suivante :
Reopen Change Order @{change_id.chg_ref_num}
Pour que les messages puissent fournir des informations sur une demande client ayant déclenché une notification, le champ Titre du message de la notification ou Corps du message de la notification doit contenir un attribut dans l'objet journal d'activité qui fait référence à l'objet demande client, iss. Pour plus d'informations sur les objets et les attributs, reportez-vous à la section Commandes de référence de CA Service Desk Manager.
Par exemple, pour inclure la priorité de la demande client dans le titre du message, entrez ce qui suit dans le champ Titre du message de la notification (ainsi que le reste du texte que vous voulez voir figurer dans le titre) :
@{issue_id.priority.sym}
Informations sur des demandes spécifiques
Pour que les messages puissent fournir des informations sur la demande spécifique ayant déclenché la notification, le champ Titre du message de la notification ou Corps du message de la notification doit contenir un attribut dans l'objet journal d'activité qui fait référence à l'objet demande. Saisissez cette référence sous la forme suivante :
@{call_req_id.cr_att_name}
  • @
    Indique que cette expression doit être remplacée.
  • call_req_id
    Attribut de l'objet journal d'activité qui le lie à une instanciation spécifique de l'objet demande (cr).
  • cr_att_name
    Tout attribut de l’objet cr.
Par exemple, pour inclure l'impact de la demande dans le titre du message, saisissez ce qui suit dans le champ Titre du message de la notification (ainsi que le reste du texte que vous souhaitez voir figurer dans le titre) :
@{call_req_id.impact.sym}
Pour identifier le composant concerné dans le corps du message, entrez ce qui suit dans le champ Corps du message de la notification (ainsi que le reste du texte que vous souhaitez voir figurer dans le corps du message) :
@{call_req_id.affected_resource.name}
Si vous voulez rouvrir une demande spécifique par numéro et que vous voulez que le message apparaisse comme suit, utilisez syntaxe suivante :
Reopen Request @{call_req_id.ref_num}
Il existe d'autres mécanismes grâce auxquels des messages peuvent être envoyés, qui sont dans le contexte de la demande proprement dite (ou de la demande de changement ou de la demande client). Lorsque le contexte est la demande proprement dite, la partie "call_req_id" de la référence ne doit pas (et ne peut pas) être utilisée. Aussi, dans ces cas de figure, vous devez utiliser :
"@{ref_num}" rather than "@{call_req_id.ref_num}"