Application de démonstration pour l'arrimage d'un système autorisé à l'API FRW.
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é!
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.
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.
Cliquez ensuite sur "OK", puis démarrez l'application!
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
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.