Skip to content

MTESSDev/FRW-Demo

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 

Repository files navigation

DemoArrimageFRW

Application de démonstration pour l'arrimage d'un système autorisé à l'API FRW.

Qu'est ce que c'est?

L'application de démonstration permet d'offir une base pour les développeurs de système autorisés souhaitant s'arrimer à FRW.
Dans un premier temps, nous vous invitons à poser des breakpoints dans le code, et de passer l'application en débug afin de comprendre comment les appels sont fait.

Nous avons ajouté des commentaires au maximum d'endroit afin que votre session de débug soit semblable à lire une documentation.

Ensuite, il vous suffit de copier coller le code nécessaire dans votre projet en l'adaptant selon vos besoin et le tour est joué!

Comment lancer le projet?

Sélection des projets de démarrage

Avant de lancer l'application, il est important de bien configurer ses projets de démarrage. La démo est constituée de 2 projets :

  • DemoFRW.API
  • DemoFRW.PR

DemoFRW.API doit toujours être lancé lors du lancement de la démo puisque c'est ce projet qui va s'occuper de faire les appels à FRW.
C'est d'ailleurs ici que nous vous conseillons d'insérer vos breakpoint afin d'observer la structure nécessaire pour les appels à FRW.

DemoFRW.PR est optionnel. Sélectionner ce projet vous ouvrira une page HTML de démonstration sur laquelle vous pourrez tester les appels au cas par cas depuis une interface utilisateur utilisant les librairies VueFormulate et UTD, que vous nous recommandons pour vos applications ministérielles.

guide1

Dans la fenêtre qui s'ouvre suite aux instructions au dessus, choisissez "Démarrer" pour DemoFRW.API (puisque c'est ce que vous voulez debug) et ensuite vous pouvez choisir l'option que vous voulez pour DemoFRW.PR, selon ce que vous voulez tester.

guide2

Cliquez ensuite sur "OK", puis démarrez l'application!

Naviguer dans le code avec le débogueur

S'il y a une chose importante que vous devez savoir, c'est que par défaut, l'application de démonstration simule ses communications à FRW. Le code pour communiquer avec FRW est donc présent, mais on ne passe pas par là! La raison est simple : il n'y a pas de clé d'API et de numéro publique de système autorisé de configuré!

Afin de passer par la communication avec FRW, voici les étapes à réaliser :

  • Ouvrir le appsettings.json du projet DemoFRW.API
  • Remplacer le champ "VotreCleApi" par votre clé d'API FRW (si vous n'en avez pas, vous ne pourrez pas utiliser cette fonctionnalité de l'application de démonstration)
  • Remplacer le champ "VotreNoPublicSystemAutorise" par votre numéro publique de système autorisé lié à votre clé d'API
  • Dans le constructeur de la classe ApiFRW, mettez le booléen demo à false

guide3

guide4

Et voilà! Vous passez désormais par les appels à FRW!

Veuillez noter que nous stockons ici la clé d'API et le numéro publique de système autorisé dans le fichier appsettings.json par soucis de simplicité du programme de démonstration, mais il est extrêmement déconseillé de les mettre ici dans une application étant déstinée à la production. Déplacez ces informations dans des endroits sécurisés, inaccessibles aux utilisateurs. Ces informations ne devrait pas être communiquées à n'importe qui.

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published