Présentation

Nous allons détailler très simplement comment profiter du datatracking / notification, traquer une table ou un champ et expliciter ce que cela implique.
L’intérêt est de fournir toutes les clés nécessaires à l’utilisation du système sans entrer dans des explications techniques poussées.
La partie script est détaillée sur cette page : Gérer et comprendre les scripts

Traquer une table

Pour qu’une table soit écoutée, il faut se rendre dans Tools > Notifications managment à partir du studio.

Open

Créer une nouvelle notification en cliquant sur New notification et remplir tous les champs.
Voici un exemple avec le détail :

Open

• Code

  • Choisir un code correspondant au code du script appelé fin d'éviter un nommage multiple.

• Description

  • Décrire l’intention du script appelé

• Entity

  • L’entité ou table cible

• Script

  • C’est le script d’entrée appelé dans lequel le bodyData est passé

  • Attention a bien préfixer les noms de script. SysNotification_ ou Datatracking_ pour saisir l'intérêt du script et surtout pouvoir les regrouper et les retrouver plus facilement.

    • Pour les notifications système nous préfixons par SysNotification_

      • Exemple : SysNotification_Customer

    • Pour les scripts de gestion d’une entité où toutes les manipulations doivent passer, nous préfixons par Datatracking_MainHandling_

      • Exemple : Datatracking_MainHandling_CustomerContact

  • Attention aussi à penser que si vous créez une notification n’existant pas en standard avec un code standard et qu’elle est intégrée dans une version future, vous risquez de ne pas en profiter.

    • Nous prévoyons à chaque fois une surcharge qu’il serait préférable d’utiliser ou nous vous conseillons de donner un nom explicite s’éloignant légèrement du standard à votre notification.

      • Exemple : Pour SysNotification_Customer nous proposons la surcharge SysNotificationOverload_Customer

• Actions

  • Les actions à cocher qui déclencheront l’appel du script. Cochez les actions nécessaires pour éviter des traitements inutiles.

    • Add : A l’ajout d’une ligne en base sur la table cible

    • Update : A la mise à jour d’une ligne en base sur la table cible

    • Delete : A la suppression d’une ligne en base sur la table cible

      • Les informations de la ligne supprimée ne seront pas envoyées. Se référer à la section suivante pour avoir plus d’information

• Pack size

  • Définir la taille des packets à envoyer. Il n’est pas recommandé de modifier cette valeur sans avoir un besoin précis et sans connaitre exactement l’impacte que ce changement pourrait avoir.

• Enable

  • Activer ou désactiver une notification

Traquer un champ

Lorsqu’un script de notification est appelé, il ne précise pas les valeurs des champs à l'état actuel et précédent.
C’est là que l’activation du datatracking sur un champ est intéressante.
Cette activation va permettre de connaitre la valeur avant et après Ajout/Modification/Suppression

Pour ce faire, il est nécessaire d’avoir un studio installé dans la dernière version.
Se rendre dans le Data dictionnary et constater la présence d'une colonne DataTracking au niveau des colonnes de table.

Lorsque cette case est cochée, nous demandons explicitement d’appliquer le datatracking sur la colonne avec tous les avantages définis précédemment.