Push notifications

 

Contenu dans cette page

Définitions

Principes techniques

Évènements concernés

Tiers concernés

Fonctions

 

 

 

Définitions

Cegid Orli permet de restituer des informations à la demande, filtrées par dates :

• soit via la fonction générique d’édition (CHOPE) ; les documents générés (PDF) peuvent ensuite être transmis à des tiers (exemple : clients) via le routage fonctionnel par entité.
• soit via la fonction générique de consultation (MUL) ; les exports générés (XLSX ou TXT) peuvent ensuite être transmis à des tiers (exemple : clients), de façon manuelle

Les principes décrits ci-dessus correspondent à un fonctionnement de type « PULL » :
‎un tiers demande à recevoir un document (ponctuellement ou régulièrement).

A contrario, le fonctionnement de type « PUSH » consiste à pousser en masse un flux d’informations définies pour une liste de tiers (ce qui peut déjà être réalisé par Cegid Orli pour chaque fonction de consultation/édition, à des jours et fréquences définies dans le planificateur JP532).

 

Les PUSH Notifications permettent de généraliser ce principe, en paramétrant :

• QUOI ?
   une liste d’évènements
• QUAND ? 
   à transmettre régulièrement
• COMMENT ?
   par mail et/ou par fichier plat
• (pour) QUI ?
   pour une liste de clients

 

Chaque évènement notifiable est répertorié au moment même où il survient, et sera notifié ultérieurement, au moment voulu.

‎ 

Principes techniques

Les PUSH Notifications s’appuient sur le moteur d’export générique XC300 :

• Activation de triggers sur les tables concernées
• Paramétrage du routage (par mail et/ou par fichier plat), pour les clients concernés
• Paramétrage des évènements concernés, et de leur fréquence de notification
• Chaque trigger va se déclencher précisément pour chaque évènement concerné, ‎afin de stocker ces évènements (sans limitation de durée)
• Une planification quotidienne de XC300 déclenchera l’envoi des notifications vers les clients concernés, pour les évènements répertoriés non encore envoyés
• Possibilité de recyclage des demandes en cas de problème technique, via XC301
• Désactivation possible des triggers (exemple : phase pilotage sur base de test)

 

Les PUSH Notifications NE permettent PAS :

• La génération de fichier aux formats XML / JSON
• Le pilotage par Web Service
• Les périodes glissantes de plus d’une semaine
  ‎(car on travaille sur 7 jours calendaires)

‎ 

Évènements concernés

Les PUSH Notifications concernent les évènements suivants :

• Imp. CD : 1^ère impression de la confirmation d’une commande client PF (pas les autres)
  ‎ via CD005
• Cré. BP : création d’un Bon de Préparation
  ‎ via LI004 / LI005
• Val. BP : validation d’un Bon de Livraison (rappel : BL = BP validé)
  ‎ via LI011 / LI007
• Cré. BE : création d’un Bon d’Expédition
  ‎ via LI011 / LI014
• Imp. BE : impression d’un BE
  via LI016
• Tracking : suivi du Tracking Number (URL internet)
  via LI019 / FA002

 

 

Format type d’une notification

Le paramètre TYPENV pour la provenance PUSH et l’origine PNO (TA450) définit la génération d’un mail (avec pièce jointe) et/ou d’un fichier plat (avec les data de la pièce jointe du mail).

La mise en page d’un mail peut être réalisée par des templates HTML, à partir de la source de données du fichier plat.

 

exemple :

« Texte introduction »

Liste évènements :

« Texte conclusion »

‎ 

Format du fichier plat (JP562 pour la fonction XC070W01 et le format _PUSH) :

 

Code évènement; Libellé évènement; Clé évènement; Date évènement;

No commande; Référence commande; Date commande;

No BP; No BE; No colis;

Code client; Code société client;
‎Raison sociale client; E-mail du client (liste éventuelle); No téléphone; No téléphone mobile; Contact chez le client;

(données de la fiche client, sauf si option CD005W01/CONF_EGAL_FAC=1)

Code client de livraison;
‎1^ère rue; 2^ème rue; 3^ème rue; Code postal; Ville; Code pays; Libellé pays; Code pays ISO sur 2 alphanumériques; Code pays ISO sur 3 numériques; Code pays ISO sur 3 alphanumériques; Enseigne; District; Boite postale; Code subdivision administrative;

Code client de facturation;
‎1^ère rue; 2^ème rue; 3^ème rue; Code postal; Ville; Code pays; Libellé pays; Code pays ISO sur 2 alphanumériques; Code pays ISO sur 3 numériques; Code pays ISO sur 3 alphanumériques; Enseigne; District; Boite postale; Code subdivision administrative;

Numéro de tracking du colis; URL définie par le transporteur pour suivi de l'avancement de la livraison; Code transporteur; Libellé transporteur;
‎Saison article; Code article; Libellé article; Code coloris; Libellé coloris; Code finition spéciale; Libellé finition spéciale; Quantité 1; …; Quantité 20; Taille 1; …; Taille 20

‎ 

Tiers concernés

Les PUSH Notifications concernent les clients (tels que définis dans CL001).

Les PUSH Notifications NE concernent PAS :

• Les fournisseurs (définis dans FO001)
• Les clients de portail BTOB/BTOC
  • Ils ne sont pas définis dans CL001
    ‎(n’étant connus de Cegid Orli que via leur adresse postale)
  • Ils peuvent déjà recevoir les notifications suivantes sur le portail BTOB/BTOC :
    • Les positions de commande client PF, ‎via le Web Service « CustomerOrder » :

      • getQtyOrder

      • getQtyCancelledOrder

      • getQtyAllocateOrder

      • getQtyPickedOrder

      • getQtyShippedOrder

      • getQtyBilledOrder

         

 

Fonctions

 

Installation

L’installation peut se faire à l’aide de DB398 ; elle renseignera les infos pour la provenance « PUSH » dans TA450 :

‎ 

Paramétrages

TA440

code EDI : permet de définir différents solutions de routages de notification (mail, SMS)

 

 

TA450

Une description pour la fonction XC070W01 :

code EDI : PUSH
‎provenance : PUSH
‎origine : PNO

 

paramètres

• TYPENV : 1=mail - 2=fichier - 3=Les 2
• FILTRECDE : Filtre à enchaîner pour CD005
• FILTREBP : Filtre à enchaîner pour LI007
• FILTREBE : Filtre à enchaîner pour LI016
• FILTREPN : Filtre à enchaîner pour XC070W02

 

N.B. :
si pas de filtre, on réalise une notification « interne » (à l’écran)

‎ 

 

exemple de filtre de routage :

‎

• les critères de filtre seront ignorés
  ‎(car remplacés à chaque génération par les données concernées)
• Routage haut d’écran (journal de routage)
• Objet
• Bloc-notes : peut être initialisé, et sera complété par un résumé des données envoyées
• Routage par entité : par client, sans préciser de mail
  >il sera envoyé par défaut par mail à l’adresse du client concerné
  ‎(avec Objet + Bloc-notes ci-dessus)

‎

AS450 : initialisation table export

Les exports sont conditionnés par des triggers sur table, et il faut lancer AS450 en mode création pour l'origine PNO.

 

 

Règles

TA070 / Paramétrage PUSH notifications

TA070W01
Cette fonction permet de paramétrer les triggers, les clients, et les fréquences de notifications.

 

Mode requête automatique.

Coche Activation du suivi (des triggers, avec accès sécurisé sur option GDA_ACTIV_TRIG)

>donne l’état ON/OFF en temps réel de tous les triggers utilisés par PUSH notifications
‎>possibilité de Désactivation des triggers (OFF) en décochant

 

Liste règle de gestion :

• Critères par code EDI :
  clients, commandes client PF + jours calendaires d’envoi (du lundi au dimanche)
• Critère d’exclusion

 

CL001 / Client

Circularité vers TA070.

 

 

Génération

XC300

• origine : 
  PNO
• code EDI :
  PUSH

 

XC070 / PUSH notifications

XC070W01
Cette fonction permet de générer et envoyer les notifications.

 

Liste des champs générés selon le type d'évènement PNx :

Champ	PN1 édi. cde	PN2 cré. B.P.	PN3 édi. B.P.	PN4 cré. B.E.	PN5 édi. B.E.	PN6 cré. T.N.
évènement (Code, Libellé, Clé, Date)	x	x	x	x	x	x
commande (N°, Référence, Date)	x	x	x	x	x	x
BP (N°)		x	x	x	x	x
BE (N°)				x	x	x
colis (N°)						x
client (Code, Société, Raison sociale et Contacts)	x	x	x	x	x	x
client de livraison (Code et Adresse)	x	x	x	x	x	x
client de facturation (Code et Adresse)	x	x	x	x	x	x
tracking du colis (N° et URL)						x
transporteur (Code, Libellé)	x	x	x	x	x	x
article (Saison, Code, Libellé, Coloris et F.S.)	x	x	x	x	x	x
quantité (1 à 20)	x	x	x	x	x	x
taille (1 à 20)	x	x	x	x	x	x

 

N.B. :
un évènement donné pour une clé donnée n’est notifiable qu’une seule fois.

exemple : la re-confirmation d’une commande ne sera pas traitée par XC070

 

 

XC070W02 / édition PUSH notifications

XC070W02
Cette fonction permet d’obtenir un état de chaque évènement de création/validation

 

 

Recyclage

En cas de problème d’envoi pour une demande XC300, il sera possible de recycler les éléments générés afin de les renvoyer ensuite :

‎

Récapitulatif

 

Tableau des évènements

 

 

Remarques sur PN1 (CD005) et PN5 (LI016) :

Pour ces 2 fonctions, la notification est déjà possible sans Push (planification édition pour un filtre donné) ; le Push apporte en revanche la possibilité d’envoyer les données correspondantes en fichier plat via JP562 (ce qui n’est pas disponible via JP561 pour ces états, qui sont de type « document »).