3 Demande d'action - cas SW métier

La demande d'action métier au service web REST se fait au format JSON dans le corps du message.

Paramètre

Balise

Description

Action

"action"

Nom de l'action du service attendue par le service web.

Paramètres

"param"

Paramètres d'entrée attendus par l'action du service.

Dépend de chaque action.

Token

"access_token"

Valeur du TOKEN obtenu durant la phase d'authentification

Header

Un HEADER est uniquement utilisé pour indiqué le Content-Type : application/json , mais pas de header d'authentification puisqu'elle passe par le champ "access_token" du corps

Rappel

Il ne faut pas confondre "l'action de service web" et "l'action métier"

L'action du service web est celle configurée dans Harmony dans "Actions des services". Elle fait le lien entre un NOM D'ACTION SERVICE et un PROGRAMME DIVA.

Ensuite le PROGRAMME DIVA est en général un traitement de routage, qui va utiliser les paramètres afin de déterminer L'ACTION METIER a traiter et les données pour ce traitement

Exemple :

Divalto fournit un NOM D'ACTION SERVICE en mode rest : WEB_SERVICE_INFINITY qui fait appel a A5PPSWINFINITY.DHOP
A5PPSWINFINITY.DHOP est un programme avec routage
1. Il va chercher dans les paramètres reçus le NOM D'ACTION METIER
2. Il traite l'action métier a partir des données de la zone paramètres

L'URL a utiliser pour les demandes d'action métier est sous la forme : base commune de l'URL + '/api/v1/WebService/Execute'

Exemple d'URL sur un poste local:

http://localhost:8080/DhsDivaltoServiceDivaApiRest/api/v1/WebService/Execute

Exemple d'URL en Divalto cloud:

https://api.divaltocloud.com/123456/TEST1/api/v1/WebService/Execute

Exemple de paramétrage d'action des services Harmony:

Exemple de demande d'action de service :

{
"action":"ACADEMY_REST",

"access_token":"eyJhbGciOiJodHRwOi8vd3d3LnczLm9yZy8yMDAxLzA0L3htbGRzaWctbW9yZSNobWFjLNoYTI1NiIsInR5cCI6IkpXVCJ9.eyJpZGVudCI6IkRpdmFsdG9BcGlSZXN0IiwidXNlciI6mJsaXR0ZWwiLCJwYXNzd29yZCI6ImxrajEyMzIxQSIsImVudiI6IkVSUDIxNSIsImRvbWFpbiI6ImRpdmFsdG8iLCJleHAiOiI0DI4MSw0NjYzMTY4NjM0In0.Vx_Qe_WbRhA0qjMOP4tiB-hUnC2lBwsy68GDzzryLhk"
"param":"{ 'items': { 'dos': '998', 'ref': 'BLO0001', 'srefList': { 'srefElem': [ {'sref1': 'XL', 'sref2': 'BLEU'}, {'sref1': 'L' , 'sref2': 'BLANC'}, {'sref1': 'XL', 'sref2': 'BLANC'} ] } }}",

}

=> Fait appel a l'action métier ACADEMY_REST en donnant des paramètres pour effectuer la demande

Le traitement Diva appelé ne reçoit que la zone 'param' transmise par l'appelant. L'enveloppe JSON ainsi que les informations d'authentification sont inconnues du traitement métier

Pour des exemples de demandes et de réponses, il faut se reporter aux chapitres concernant les différents services web métier