Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  • Installer sur le serveur le contenue du patch

    View file
    nameHelios ERP (GatewayExternal).V2023.4.24.06211016.(PATCH).exe
    (Disponible sur le site) dans le même dossier que pour le Serveur et la Gateway dans le dossier GatewayExternal.

  • Ouvrir le port du serveur 19898 19894 (équivalent au port du fichier appseting.json)

  • Ajouter le Fichier *DataBasesj.son” configurer pour votre BDD ici HeliosERP ( Chapitre 4 : Configuration Gateway Externe)

...

  1. Lancer un invite de commande en mode administrateur

    image-20240701-150219.png
  2. Se positionner dans le répertoire d’installation de la GatewayExternal

  3. Exécuter le fichier IUninstall_Service.bat

    image-20240701-150433.png

2.1.3. Lancement du Service GatewayEternal

Lancer l’application “Service” et démarrer le Service Helios ERP Gateway External Service aprés avoir lancer le Service Helios ERP application de préférence.

image-20240701-153717.pngImage Added

3. Droit Designer return.pngImage Modified

Paramétrer dans Hélios un opérateur dédié à la consommation des api.

...

4. Configuration Gateway Externe return.pngImage Modified

Les fichiers suivants sont à paramétrer à l’installation de la gateway externe.

 C:\Program Files (x86)\CLIP Industrie\HeliosERP \GatewayExternal\appsettings.json :

{

  "ServerPort": "1989819894",

  "MaxItemsForSearch": 50

}

...

seront à transmettre au développeur du consommateur de l’API afin qu’il puisse paramétrer le client HTTP.

5. Accès Swagger return.pngImage Modified

Un swagger est disponible avec la gateway externe.

...

Il fournit une documentation des routes disponibles. http://[GATEWAY_HOST]:[PORT]/swagger/ui/index#/

image-20240701-151141.png

6. Exemple de code return.pngImage Modified

6.1. Paramétrage / Authentification return.pngImage Modified

// Configuration client HTTP

...

6.2 Définition des models return.pngImage Modified

Si besoin, définir des modèles en respectant le formalisme (noms, types, enum…) décrit par la documentation Swagger. Ils permettront de servir de type de référence pour la sérialisation / désérialisation du Json retourné par / envoyé à l’API.

public class ApiArticleModel

{

public int Ident { get; set; }

public decimal PrixUnit { get; set; }

...     

}

 public class ApiCommandeClientModel

{

public string Monnaie { get; set; }

public string IdentClient { get; set; }

...

}

6.3. Appels return.pngImage Modified

// Appel de type "liste d'objets"

...

var responseS = await response.Content.ReadAsStringAsync();

 6.4. Logout return.pngImage Modified

 response = await client.PostAsync("api/Session/Logout", null);