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 étant 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
> Noifications managment
à partir du studio.
Créer une nouvelle notification en cliquant sur New notification
et remplir tous les champs.
Voici un exemple avec le détail :
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
La section ci-dessous est importante.
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_
ouDatatracking_
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 de créer un nom explicite s’éloignant légèrement du standard.
Exemple : Pour
SysNotification_Customer
nous proposons la surchargeSysNotificationOverload_Customer
Actions
Les actions à cocher qui déclencherons 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é. Ce 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.
Il 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.
Ce 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.