Comparaison de pages

Version minimum	Date de mise à jour
5.4

/ 5.5 / 5.6 / 5.7 / 6.0

(selon le besoin)

4 mai

8 déc. 2023

Fonctionnalité

Sur le même principe que les webhooks qui permettent à un logiciel externe de mettre à jour des données dans Divalto weavy, on veut cette fois que Divalto weavy mette à jour des données dans un logiciel externe par l’intermédiaire notamment de webservices.

...

Info
Les champs suivis sont ceux dont « DataTracking » est coché dans le dictionnaire pour la table que l’on veut gérer

Exemple :

...

sw_data_externaldataupdateasync.baseuser_ID : Utilisateur qui est à l’origine de la demande

Variables

ExternalDataUpdateAsync.Retries : Nombre maximum de tentatives autorisées en cas d'erreur lors du traitement d'une ligne de sw_data_externaldataupdateasync
- Valeur par défaut : 10
ExternalDataUpdateAsync.BatchRecords : Nombre de lignes de sw_data_externaldataupdateasync à traiter dans un lot afin d'éviter le timeout de 30 s sur les notifications et events
- Valeur par défaut : 5
Portal.Administrator.Email : Email de l'administrateur utilisé pour l'envoi d'alertes (ex : nombre de tentatives de connexions API dépassé)
MasterInfinity : Le projet utilise le master infinity. Permet d’activer certains automatismes comme par exemple la création de devis travaux dans Divalto infinity depuis le web Divalto weavy
- Valeur par défaut : 0 (master) / 1 (master infinity)

...

Bloc de code

// ManageExtDataUpdateAsyncOverload_Equipment
// @description                 => Manage equipment data to transmit on external software.
//
// @rowCode                     => codeequipemnt
// @rowID                       => equipment_ID
// @action                      => INSERT, UPDATE, DELETE
// @status                      => status in the fifo table : TO_BE_TREATED, ERROR
// @dataEntity                  => data from sw_data_equipment in json format
// @manualPreemptive            => user wait of infos (0/1)
// @origin                      => to identify the origin of the data
// @externaldataupdateasync_ID  => current fifo ID
// @entityBeforeValues          => json of values before change (depends if property DataTracking of the column is set in dictionary)
// @entityAfterValues           => json of values after change (depends if property DataTracking of the column is set in dictionary)
// //@codebaseuser @returns               => codebaseuser of the origin
//
=>// 0@returns : error / 1 :                 => 0 : error / 1 : ok / 2 : ignored
//

rowCode                     = TRANSLATE( "<varscript>arg1</varscript>" )
rowID                       = TRANSLATE( "<varscript>arg2</varscript>" )
action                      = TRANSLATE( "<varscript>arg3</varscript>" )
status                      = TRANSLATE( "<varscript>arg4</varscript>" )
dataEntity                  = TRANSLATE( "<varscript>arg5</varscript>" )
manualPreemptive            = TRANSLATE( "<varscript>arg6</varscript>" )
origin                      = TRANSLATE( "<varscript>arg7</varscript>" )
externaldataupdateasync_ID  = TRANSLATE( "<varscript>arg8</varscript>" )
entityBeforeValues          = TRANSLATE( "<varscript>arg9</varscript>" )
entityAfterValues           = TRANSLATE( "<varscript>arg10</varscript>" )
codebaseuser                = TRANSLATE( "<varscript>arg11</varscript>" )

dataSent              = VARGET_SHELL( "dataSent", "ManageExtDataUpdateAsync" )
lastError             = VARGET_SHELL( "lastError", "ManageExtDataUpdateAsync" )
jsonDocReturnedInfos  = VARGET_SHELL( "jsonDocReturnedInfos", "ManageExtDataUpdateAsync" )


// To complete in overload


lastError = "Not supported in standard. You must manage the equipment data to sent in overload." // comment in overload

IF ( manualPreemptive == "1" ) THEN
  //if manualPreemptive we can return infos to user in json format
  //resultOk : 1=Ok, 0=Error
  //errorMessage : error message
  //returnedCode : code
  //returnedDetails : object of details
  //DOCUMENT_SET_PROPERTY_TO_OBJECT( jsonDocReturnedInfos, "resultOk", ... )
  //DOCUMENT_SET_PROPERTY_TO_OBJECT( jsonDocReturnedInfos, "errorMessage", ... )
  //DOCUMENT_SET_PROPERTY_TO_OBJECT( jsonDocReturnedInfos, "returnedCode", ... )
  //DOCUMENT_SET_PROPERTY_TO_OBJECT( jsonDocReturnedInfos, "returnedDetails", "property1", ... )
  //DOCUMENT_SET_PROPERTY_TO_OBJECT( jsonDocReturnedInfos, "returnedDetails", property2 ... )
ENDIF

VARSET_SHELL( "lastError", lastError , "ManageExtDataUpdateAsync" )
VARSET_SHELL( "dataSent", dataSent , "ManageExtDataUpdateAsync" )

RETURN( "0" ) // to be changed in overload (0 : error / 1 : ok)

...

Gestion des équipements :
- Versions : Divalto weavy 5.4 / Divalto infinity 10.6
- Entité : Equipement
- Origine : Notification (NOTIFICATION)
- Code notification : ExtDataUpdateAsync_Equipment
- Fonction surchargée : ManageExtDataUpdateAsyncOverload_Equipment
- Webservice infinity : integration_equipement
- Remarques Retours :
  - En création d’un nouvel équipement, recodification de sw_data_equipment.codeequipment avec GMMAT.RMCOD
- Remarques :
  - A partir de Divalto weavy 6.0 / Divalto infinity 10.10, on gère la mise à jour des caractéristiques froid des équipements
Création d’un devis travaux suite à intervention :
- Versions : Divalto weavy 5.4 / Divalto infinity 10.6
- Entité : Intervention
- Origine : Manuelle (WORKSQUOTE)
- Fonction surchargée : ManageExtDataUpdateAsyncOverload_Intervention
- Webservice infinity : integration_dtr
- Retours :
  - Mise à jour de sw_data_intervention.additionalExternalID avec PREFPINO + PINO + TICOD + PITYP
Création d’un devis travaux sur demande d’intervention :
- Versions : Divalto weavy 5.4 / Divalto infinity 10.6
- Entité : Demande d’intervention
- Origine : Manuelle (WORKSQUOTE)
- Fonction surchargée : ManageExtDataUpdateAsyncOverload_Intervention
- Webservice infinity : integration_dtr
Contrôle de réception bon de transfert :
- Versions : Divalto weavy 5Retours :
  - Mise à jour de sw_data_intervention.externalID avec PREFPINO + PINO + TICOD + PITYP
Contrôle de réception bon de transfert :
- Versions : Divalto weavy 5.5 / Divalto infinity 10.7
- Entité : Entête de réception de bon de transfert
- Origine : Notification (NOTIFICATION)
- Code notification : ExtDataUpdateAsync_Productstocktransferreceivedheader
- Fonction surchargée : ManageExtDataUpdateAsyncOverload_Productstocktransferreceivedheader
- Webservice infinity : integration_bontransfert
- Retours : /
Avancement d’une intervention :
- Versions : Divalto weavy 5.6 / Divalto infinity 10.8
- Entité : Intervention / Planning
- Origine : Notification (NOTIFICATION)
- Code notification : ExtDataUpdateAsync_Intervention / ExtDataUpdateAsync_Planning
- Fonction surchargée : ManageExtDataUpdateAsyncOverload_Intervention / ManageExtDataUpdateAsyncOverload_Planning → DIVINF_ManageExtDataUpdateAsync_InterventionAdvancement
- Webservice infinity : integration_intervention
- Retours : /
Gestion des adresses d’un tiers :
- Versions : Divalto weavy 5.7 / Divalto infinity 10.9
- Entité : Tiers / Adresse
- Origine : Notification (NOTIFICATION)
- Code notification : ExtDataUpdateAsync_Customeraddress
- Fonction surchargée : ManageExtDataUpdateAsyncOverload_Customeraddress
- Webservice infinity : integration_adresse
- Remarques :
  Utilisation de la variable ExternalDataUpdateAsync.Customeraddress.SyncType pour connaitre
  Retours :
  - En création d’une nouvelle adresse
    - Recodification de sw_data_customeraddress.codecustomeraddress avec T1.TIERS + T1.ADRCOD
    - Mise à jour de sw_data_customeraddress.erpAddressID avec T1.ADRCOD
- Remarques :
  - Utilisation de la variable ExternalDataUpdateAsync.Customeraddress.SyncType pour connaitre le type de synchronisation à effectuer :
    - 0 : Toutes les adresses
    - 1 : Uniquement les sites (valeur par défaut)
Demande de réapprovisionnement :
Création d’une affaire depuis une intervention
- Versions : Divalto weavy 5.7 / Divalto infinity 10.9
- Entité : Entête de demande de réapprovisionnement
- Origine : Notification (NOTIFICATION)
- Code notification : ExtDataUpdateAsync_ProductstockReplenishmentrequestheader
- Fonction surchargée : ManageExtDataUpdateAsyncOverload_Productstockreplenishmentrequestheader
- Webservice infinity : integration_piece
- Remarques Retours :
  - La demande de réapprovisionnement dans Divalto weavy va créer une commande de transfert dans Divalto infinity d’un dépôt non véhicule (par défaut dépôt principal) vers le dépôt du technicien
Relevé de compteur d’un équipement :
- Versions : Divalto weavy 5.7 / Divalto infinity 10.9
- Entité : Mesure
- Origine : Event (EVENT MEASURECOUNTER)
- Code automate event : Manage ExtDataUpdateAsync - MeasureCounter
- Fonction surchargée : ManageExtDataUpdateAsyncOverload_Measure
- Webservice infinity : maj_cpt_equipement
- Remarques :
  - On utilise un événement pour transmettre tous les derniers relevés de compteurs pour les équipements non exportés (sw_data_measure.srvExport=1) selon la fréquence paramétrée
- - Mise à jour de :
    - sw_data_productstockreplenishmentrequestheader.externalID avec PREFPINO + PINO
    - sw_data_productstockreplenishmentrequestheader.processingDate à la date du jour
    - sw_data_productstockreplenishmentrequestheader.generictype_ID_status au statut Envoyé (dataType = 'PRODUCTSTOCK_REPLENISHMENTREQUEST_STATUS' et originalCode='SENT')
- Remarques :
  - Ne sont transmises que les demandes de réapprovisionnement en statut Validé
  - Un réapprovisionnement peut être créé depuis une planification en prenant les pièces utilisées. Si la variable ReplenishmentAutoValidate (auto-validation du réapprovisionnement) est à 1 alors la demande de réapprovisionnement sera transmise automatiquement.
  - La demande de réapprovisionnement dans Divalto weavy va créer une commande de transfert dans Divalto infinity d’un dépôt non véhicule (par défaut dépôt principal) vers le dépôt du technicien
Relevé de compteur d’un équipement :
- Versions : Divalto weavy 65.0 7 / Divalto infinity 10.109
- Entité : Intervention Mesure
- Origine : Manuelle Event (DEALEVENT MEASURECOUNTER)
- Code automate event : Manage ExtDataUpdateAsync - MeasureCounter
- Fonction surchargée : ManageExtDataUpdateAsyncOverload_Intervention → DIVINF_ManageExtDataUpdateAsync_InterventionDealMeasure
- Webservice infinity : integration maj_cpt_affaireequipement
- Remarques Retours :
  - Après la création de l’affaire dans Divalto infinity, on enchaine automatiquement sur les traitements suivants à travers l’ICP :
    - Appel du Webhook “Deal” pour créer l’affaire dans Divalto weavy
    - Appel du Webhook “Intervention” pour lier l’affaire, l'élément d’affaire et l’activité à l’intervention dans Divalto weavy

Info

Il existe une fonction de script DIVINF_Func_GetInfinityWebServiceInfo qui retourne les informations nécessaires au lancement des webservices infinity.
Elle permet de retourner :

URL du webservice : Cette url est enregistrée dans la table sw_data_externalurl avec le code "WSDIVA". Elle est paramétrée lors du provisioning dans infinity (zoom des chemins). Elle est importée dans weavy par ControlCenter External URL vX.6 puis backend 20. Base Info - ExternalUrl.
Action du webservice : cette action est définie en dur avec WEB_SERVICE_INFINITY. S'il faut la modifier il faudra surcharger cette fonction.

- - Mise à jour de sw_data_measure.srvExport à 0
- Remarques :
  - On utilise un événement pour transmettre tous les derniers relevés de compteurs pour les équipements non exportés (sw_data_measure.srvExport=1) selon la fréquence paramétrée
Création d’une affaire depuis une intervention :
- Versions : Divalto weavy 6.0 / Divalto infinity 10.10
- Entité : Intervention
- Origine : Manuelle (DEAL)
- Fonction surchargée : ManageExtDataUpdateAsyncOverload_Intervention → DIVINF_ManageExtDataUpdateAsync_InterventionDeal
- Webservice infinity : integration_affaire
- Retours :
  - Création d’une trace dans sw_data_interventionhistoryheader et sw_data_interventionhistorydetail pour l’intervention concernée en cas de réussite ou d'échec du webservice
- Remarques :
  - Après la création de l’affaire dans Divalto infinity, on enchaine automatiquement sur les traitements suivants à travers l’ICP :
    - Appel du Webhook “Deal” pour créer l’affaire dans Divalto weavy
    - Appel du Webhook “Intervention” pour lier l’affaire, l'élément d’affaire et l’activité à l’intervention dans Divalto weavy

Info

La fonction de script DIVINF_Func_GetInfinityWebServiceInfo permet de retourner les informations nécessaires au lancement des webservices infinity :
URL du webservice : Cette url est enregistrée dans la table sw_data_externalurl avec le code "WSDIVA". Elle est paramétrée lors du provisioning dans infinity (zoom des chemins). Elle est importée dans weavy par ControlCenter External URL vX.6 puis backend 20. Base Info - ExternalUrl.

Action du webservice : cette action est définie en dur avec WEB_SERVICE_INFINITY. S'il faut la modifier il faudra surcharger cette fonction.

Bloc de code

// DIVINF_Func_GetInfinityWebServiceInfo
// @description => Get infos for webservice infinity
// @returns     => 0 : error / 1 : ok
// @returned variables
// InfinityWebServiceUrl : Infinity server URL for the call of the WebService
// InfinityWebServiceAction : Infinity diva action to push in the web method
// InfinityWebServiceErrorMsg : Error message if returns is 0

InfinityWebServiceUrl     = VARGET_DBSQL( "select url from sw_data_externalurl where codeexternalurl='WSDIVA'" )
InfinityWebServiceAction  = "WEB_SERVICE_INFINITY"
InfinityWebServiceErrorMsg   = ""
ret = 1

IF (EQUALS( InfinityWebServiceUrl, "" )) THEN
  InfinityWebServiceErrorMsg = "Infinity server URL for the call of the WebService //is InfinityWebServiceActionnot : Infinity diva action to push in the web method
// InfinityWebServiceErrorMsg : Error message if returns is 0

InfinityWebServiceUrl     = VARGET_DBSQL( "select url from sw_data_externalurl where codeexternalurl='WSDIVA'" )
InfinityWebServiceAction  = "WEB_SERVICE_INFINITY"
InfinityWebServiceErrorMsg   = ""
ret = 1

IF (EQUALS( InfinityWebServiceUrl, "" )) THEN
  InfinityWebServiceErrorMsg = "Infinity server URL for the call of the WebService is not informed (Table=sw_data_externalurl, Code='WSDIVA')"
  ret = 0
ENDIF

VARSET_SHELL( "InfinityWebServiceUrl", InfinityWebServiceUrl, "InfinityWSinfo" )
VARSET_SHELL( "InfinityWebServiceAction", InfinityWebServiceAction, "InfinityWSinfo" )
VARSET_SHELL( "InfinityWebServiceErrorMsg", InfinityWebServiceErrorMsg, "InfinityWSinfo" )

RETURN( ret )informed (Table=sw_data_externalurl, Code='WSDIVA')"
  ret = 0
ENDIF

VARSET_SHELL( "InfinityWebServiceUrl", InfinityWebServiceUrl, "InfinityWSinfo" )
VARSET_SHELL( "InfinityWebServiceAction", InfinityWebServiceAction, "InfinityWSinfo" )
VARSET_SHELL( "InfinityWebServiceErrorMsg", InfinityWebServiceErrorMsg, "InfinityWSinfo" )

RETURN( ret )

Info
La fonction de script DIVINF_FuncWS_JsonInitHeader permet d’initialiser l’entête transmise aux webservices infinity.

Bloc de code

language	json

"header": {
  "caller": "weavy", // Défini en dur
  "callerVersion": "1.6.20231121", // Version du Master (variable MasterVersion)
  "languageCode": "FR", // Défini en dur
  "userCode": "MD", // Code de l'utilisateur à l'origine de la demande (sw_data_baseuser.codebaseuser) ou si pas connu, nom de l'utilisateur système qui fait l'envoi (en général NotificationScriptUser)
  "callDateTime": "2023-12-08 11:23:32" // Date et heure de l'envoi
}

Comparaison des versions

Ancienne version 1

Nouvelle version Actuel

Légende

Fonctionnalité

Variables