Aller au contenu principal

Utiliser 2020 Ideal Spaces

Objectif du document​

L'objectif du document est de décrire le fonctionnement du planner web 2020 Ideal Spaces en liaison avec Gesteos.

Fonctionnement​

Configuration dans Gesteos​

Prérequis ​

Pour pouvoir utiliser Ideal Spaces au sein de Gesteos, l'utilisateur doit posséder le droit « Créer des scènes avec 2020 Ideal Spaces ». Sans ce droit, les options d'interaction avec Ideal Spaces n'apparaitront pas dans les différents écrans Gesteos (configuration service externe, création de variante, ...).

Toutes les interactions suivantes nécessitent une affaire à minima à l'étape Devis. Avant toute chose l'utilisateur doit donc créer un contact dans Gesteos, le transformer en Découverte, puis créer un Devis.

Les interactions avec Ideal Spaces peuvent s'effectuer depuis Gesteos en mode « Web » (au sein d'un navigateur internet) ou en mode « Socle » (au sein de l'application bureau).

Création d'un nouveau projet ​

Pour créer un nouveau projet, l'utilisateur doit être positionné sur une affaire en devis. Il doit cliquer sur le bouton « Créer une scène » (dans le cas où il possède les droits sur plusieurs logiciels de dessin, il devra choisir l'option « Avec 2020 Ideal Spaces »). L'utilisateur doit ensuite choisir un nom pour sa variante (ceci n'impactera pas le nom de son projet dans Ideal Spaces, il est propre à Gesteos), puis cliquer sur « Créer ».

Ideal Spaces va alors s'ouvrir dans une nouvelle fenêtre de navigateur internet. De là, l'utilisateur peut créer son projet, le nommer, et l'enregistrer.

A ce moment précis, le nouveau projet Ideal Spaces n'est pas encore lié à la variante créée dans Gesteos. Pour ce faire, il faut revenir dans Gesteos, et cliquer sur le bouton « Enregistrer le chiffrage ». Gesteos va alors récupérer le projet nouvellement créé et le lier à la variante. Il va dans le même temps récupérer l'ensemble des informations du projet (informations produits, tarification, image principale).

Ouverture d'un projet existant ​

Pour ouvrir un projet existant, l'affaire dans Gesteos doit être à l'étape Devis, Vente ou Facture. Sur la ligne de la variante correspondante, cliquer sur le bouton « Ouvrir la scène ».

Ideal Spaces va alors s'ouvrir dans une nouvelle fenêtre de navigateur internet. De là, l'utilisateur peut modifier son projet, le renommer, et l'enregistrer.

Selon l'étape de l'affaire, les modifications peuvent ensuite être récupérées au sein de Gesteos (il n'est pas possible de les récupérer à l'étape Facture, et à l'étape Vente seulement sous certaines conditions, en fonction des produits déjà commandés).

Pour ce faire, il faut cliquer sur le bouton « Enregistrer le chiffrage » apparu sur la ligne de la variante correspondante.

Changement d'étape de l'affaire ​

Lors d'un changement d'étape de l'affaire (passage de Devis à Vente, de Vente à Facture), le projet Ideal Spaces concerné restera le même, Ideal Spaces ne permettant pas la duplication de projet. Toute modification du projet lors d'une étape impactera donc le projet aux autres étapes.

Lien avec Ideal Spaces​

Ouverture d'une variante​

Comme écrit précédemment, l'ouverture d'une variante s'effectue dans une nouvelle fenêtre du navigateur web.

L'URL utilisée sera celle définie lors du paramétrage du service externe dans Gesteos. Au moment de l'accès au lien, Ideal Spaces ne sait pas quel utilisateur se connecte et va donc récupérer les informations de l'utilisateur au moment de l'ouverture de la scène.

Ce fonctionnement à l'avantage de ne pas avoir besoin d'un compte IS (Ideal Spaces) pour l'utiliser car celui-ci reconnait l'utilisateur à sa connexion. Cependant, l'utilisateur doit forcément passer par Gesteos afin de créer une scène et pouvoir la sauvegarder.

Etant donné que Gesteos ouvre une nouvelle page web, il est possible de récupérer l'URL puis de tenter de créer une scène. Dans ce cas, il est possible de modifier une scène mais étant donné qu'aucune liaison n'est initialisée avec Gesteos, l'enregistrement de celle-ci est impossible.

Enregistrement du chiffrage​

Enregistrement à la suite de la création d'une scène​

A la création d'une nouvelle scène, Gesteos va enregistrer le timestamp (date et horaire) de l'ouverture de la fenêtre Ideal Spaces. Une fois la scène prête à être enregistrer, l'utilisateur a la possibilité de faire cela de deux manières différentes. Ces deux méthodes aboutissent à l'enregistrement du chiffrage et de la scène mais elles sont différentes techniquement car elles ne font pas appel aux même API :

  • L'enregistrement de la scène avec le bouton « Enregistrer le chiffrage » depuis l'interface d'IS.

    • Ideal Spaces fait le lien entre l'ID du projet nouvellement créé et l'ID de la variante Gesteos au moment de l'enregistrement du chiffrage et la base de données est mise à jour en conséquence.

  • L'enregistrement de la scène depuis Gesteos avec le bouton « Enregistrer le chiffrage ».

    • Au moment de l'enregistrement du chiffrage, Gesteos ne sait pas quel est l'ID du projet à lier à la variante. La procédure suivante va s'appliquer pour définir le bon projet :

      • Gesteos va récupérer tous les projets de l'utilisateur et comparer leur date de création à celle du timestamp de l'ouverture de la fenêtre.

      • Si un projet a été créé après le timestamp, il y a de fortes chance que ce soit celui créé à l'ouverture de la fenêtre. Gesteos va faire le lien entre l'ID du projet et la variante.

      • Si aucun projet n'est trouvé, Gesteos va afficher un message demandant d'enregistrer le projet dans IS avant de réappuyer sur le bouton « Enregistrer le chiffrage ».

Une fois le premier enregistrement effectué. Le lien entre le projet IS et la variante est établi et Gesteos utilisera directement le lien lors des prochaines ouvertures et modifications effectuées sur la scène.

Enregistrement des données​

Comme écrit précédemment, l'enregistrement du chiffrage peut se faire de deux manières différentes. Concernant l'enregistrement des données de la scène, le fonctionnement va être le même avec seulement une différence pour l'enregistrement depuis Ideal Spaces.

  • Enregistrement depuis Gesteos :

    • Gesteos va faire appel à une API IS afin de récupérer la liste des produits du design IS (le projet et le design IS sont très fortement liés et forment la scène IS qui est récupérée par Gesteos)

    • Les données principalement utilisées sont :

      • Le SKU : Identifiant unique du produit dans IS

      • Le parent item ID : Identifiant utilisé pour recomposer un article grâce à ses sous-produits. Si le produit n'en porte pas, il s'agit d'un article parent. Sinon il s'agit d'un article enfant.

      • La quantité

      • Les dimensions

    • Avec ces données, Gesteos va interroger les catalogues du PIM (actuellement WM88 et GPDIS) afin de retrouver les articles et récupérer les informations de chiffrage, les écotaxes ainsi que les dimensions.

      • Si des informations de l'article sont manquantes dans le PIM, les informations d'IS sont utilisées.

      • Si l'article n'est pas trouvé sur le PIM, Les informations du PIM seront utilisées mais l'article sera chiffré à 0€.

    • Une fois les données récupérées, l'enregistrement du chiffrage de Gesteos s'effectue de la même manière que pour les logiciels de dessins « traditionnels ».

  • Enregistrement du chiffrage depuis IS :

    • Le PS Framework (voir définition ci-après) se base sur le visuel de la scène et ne va donc pas récupérer les mêmes informations que précédemment. Par exemple, des vues de la scène seront intégrées dans l'envoi des données.

    • Ces données sont ensuite envoyées au PIM pour suivre le même processus que celui décrit ci-dessus.

A noter : Lorsqu'une fenêtre Ideal Spaces est ouverte, celle-ci va conserver un lien avec la fenêtre de Gesteos parente même si celle-ci est actualisée. Le lien est perdu si la fenêtre Gesteos est fermée ou bien si l'utilisateur quitte l'affaire concernée.

Le PS Framework​

Le PS Framework permet d'intégrer dans la page d'Ideal Spaces des URL provenant de Gesteos afin que le logiciel puisse afficher ou faire les traitements qu'il souhaite. Les emplacements alloués à Gesteos sur IS se trouvent :

  • En haut à gauche de l'écran : Correspond actuellement le logo Gesteos est affiché.

  • En haut à droite de l'écran : Correspond actuellement au bouton « Enregistrer le chiffrage ».

  • Bas du menu de gauche IS : Actuellement cette zone n'est pas utilisée.

L'utilité de ce fonctionnement est de pouvoir exécuter du code spécifique de Gesteos à l'aide des API proposées. Actuellement, le PS Framework est utilisé essentiellement pour déclencher l'enregistrement du chiffrage depuis IS et permettre l'affichage d'erreur.

Gestion des erreurs​

Au vu des éléments décrits dans les précédentes parties, il est plus compliqué de détecter d'où peut provenir une erreur qui survient à/après l'enregistrement du chiffrage d'une scène provenant d'Ideal Spaces que des logiciels de dessin. Dans le cas des logiciels de dessins, l'erreur provient soit du logiciel ou de Gesteos.

Dans le cas d'IS, le problème peut provenir de :

  • Ideal Spaces : L'erreur devra être remontée à 2020 et n'est pas du ressort de Gesteos

  • PS Framework : La page IS peut exécuter du code Gesteos qui peut provoquer des erreurs c'est donc du ressort de Gesteos.

  • PIM : Des erreurs de chiffrages peuvent avoir lieu si les catalogues du PIM sont défaillants.

  • Gesteos

Pour identifier d'où provient une erreur, plusieurs outils sont disponibles :

  • Postman : avec l'ID du projet IS et l'ID du design, il est possible d'effectuer des tests pour interroger IS et récupérer les informations envoyées par le logiciel.

  • Le PIM : Si les informations sont récupérées dans Gesteos mais que celles-ci ne sont pas chiffrées, cela signifie qu'il y a un problème avec le PIM

  • Les fichiers JSON : A la suite à de développements effectués sur Gesteos, des fichiers JSON sont générés lors de l'enregistrement du chiffrage d'une scène. Ceux-ci sont stockés sur les serveurs dans les dossiers des affaires concernés.

    • 1^er^ fichier JSON « <nom scène>_PS_Framework » : Ce fichier est généré uniquement lors de l'enregistrement du chiffrage depuis IS. Permet de visualiser les informations envoyées par IS à Gesteos

    • 2^ème^ fichier JSON « <nom scène>_PlannerWeb » : Ce fichier contient les informations IS converties au format Gesteos avant l'envoi au PIM pour le chiffrage.

    • 3^ème^ fichier JSON « <nom scène>_PIM » : Ce fichier contient les informations de chiffrage après analyse du PIM et qui seront enregistrées par Gesteos.