URLs externes

Fonctionnalité

Pouvoir appeler des URLs d'un logiciel externe depuis Divalto weavy web.

Tables

• sw_data_externalurl : Table des urls externes.

Critères d'activation

Des codes standards ont été définis dans la table sw_data_externalurl pour définir les urls externes disponibles.

Ces codes ont été implémentés dans Divalto weavy web afin d'ouvrir l'écran du logiciel externe correspondant (généralement depuis le bouton « Action »).

Ci-dessous le tableau résumant les pages Divalto weavy web où les urls externes sont disponibles ainsi que la clé utilisée pour identifier l’enregistrement externe.

Fonctionnement

Une fonction de script standard FuncServer_GetExternalUrl est appelée pour récupérer l'URL.

// FuncServer_GetExternalUrl
// @description     => return external url
//
// @codeexternalurl => code of the sw_data_externalurl table (ie : CustomerWorksQuote, CustomerOrder, CustomerContract, Deal, ....)
// @key             => key of the record for interpretation by the external software (ie : keyCustomerWorksQuote, keyCustomerOrder, keyCustomerContract, keyDeal, ...)
//
// @returns         => interpreted url
//

codeexternalurl = TRANSLATE( "<varscript>arg1</varscript>" )
key             = TRANSLATE( "<varscript>arg2</varscript>" )

returnedUrl = ""

url = VARGET_DBSQL( "select url from sw_data_externalurl where codeexternalurl='<varscript>codeexternalurl</varscript>'" )
url = TRIM( url )

returnedUrl = CALL_SCRIPT( "FuncServerOverload_GetExternalUrl", codeexternalurl, key, url )

IF ( LEN( returnedUrl ) == 0) THEN
  returnedUrl = url
ENDIF

RETURN( returnedUrl )

S'il y a besoin une fonction de surcharge FuncServerOverload_GetExternalUrl est disponible pour retravailler l'url : remplacement de clé d'enregistrement, encodage, ...

// FuncServerOverload_GetExternalUrl
// @description     => return external url
//
// @codeexternalurl => code of the sw_data_externalurl table (ie : CustomerWorksQuote, CustomerOrder, CustomerContract, Deal, ....)
// @key             => key of the record for interpretation by the external software (ie : keyCustomerWorksQuote, keyCustomerOrder, keyCustomerContract, keyDeal, ...)
// @url             => not interpreted url
//
// @returns         => interpreted url
//

codeexternalurl = TRANSLATE( "<varscript>arg1</varscript>" )
key             = TRANSLATE( "<varscript>arg2</varscript>" )
url             = TRANSLATE( "<varscript>arg3</varscript>" )

returnedUrl = ""

// To complete in overload

RETURN( returnedUrl )

Particularités

Une liaison avec Divalto infinity est implémentée en standard.

La table sw_data_externalurl est alimentée par (les informations proviennent du zoom des abstractions et des chemins de Divalto infinity qui devront être provisionnés) :

• ControlCenter/Backend

  • ControlCenter : External URL vX.6

  • Backend : 20. Base Info - External Url

• Agent/Backend

  • Agent : 01.29. External URL v10.6

  • Backend : A20.25. Base Info - External Url

La fonction FuncServerOverload_GetExternalUrl a été surchargée afin de faire du remplacement de clé et de l'encodage en BASE 64, propres aux appels Divalto infinity.

Exemple pour l'appel d'un devis travaux en expérience classique (HTML5) :

• URL de base telle que enregistrée dans sw_data_externalurl pour le code CustomerWorksCode :

  http://xx.xx.xx.xx:yyyy/lcweb/default.aspx?urlDivaMode=1&urlDivaParamc=BASE64[urlDivaProgram=ia.dhop&urlDivaParams=[RunProgram]{_Entity}CustomerWorksQuote{_Key}%1]

• URL après interprétation par la fonction de surcharge :

  http://xx.xx.xx.xx:yyyy/lcweb/default.aspx?urlDivaMode=1&urlDivaParamc=dXJsRGl2YVByb2dyYW09aWEuZGhvcCZ1cmxEaXZhUGFyYW1zPVtSdW5Qcm9ncmFtXXtfRW50aXR5fVdvcmtzUXVvdGV7X0tleX1EVFIgICAgICAgMzEgICAgICAgIEMxMiAgICAgICAgICAgNDQw

C’est donc cette URL interprétée qui permettra d’ouvrir l'écran des devis travaux de Divalto infinity sur le bon n° de devis travaux en HTM5 depuis Divalto weavy web.

Exemple pour l'appel d'un devis travaux en expérience Divalto One :

• URL de base telle que enregistrée dans sw_data_externalurl pour le code One_CustomerWorksCode :

  https://monurlone/redirect/BASE64[[RunProgram]{_Entity}CustomerWorksQuote{_Key}%1]

• URL après interprétation par la fonction de surcharge :

  https://monurlone/redirect/dXJsRGl2YVByb2dyYW09aWEuZGhvcCZ1cmxEaXZhUGFyYW1zPVtSdW5Qcm9ncmFtXXtfRW50aXR5fVdvcmtzUXVvdGV7X0tleX1EVFIgICAgICAgMzEgICAgICAgIEMxMiAgICAgICAgICAgNDQw

C’est donc cette URL interprétée qui permettra d’ouvrir l'écran des devis travaux de Divalto infinity sur le bon n° de devis travaux dans D.One depuis Divalto weavy web.