Developer Networks
Créez avec les technologies GraphicStream
Librairie GraphicStream d'articles techniques, de tutoriaux et de ressources d'apprentissage
GraphicStream est un éditeur de logiciels et l’éditeur d’Immersive. Le Developer Network accompagne les équipes qui développent à partir de ses produits et technologies.
Bien démarrer
Les ressources essentielles
Une sélection éditoriale pour comprendre l’écosystème GraphicStream et commencer à créer autour d’Immersive.
Présentation de l’interface du Beholder
Prenez rapidement vos repères dans le Beholder en découvrant comment l’écran s’organise entre vue 3D, liste d’équipements, alarmes et menus. Ce chapitre montre où agir, quoi observer et comment sélectionner un équipement aussi bien depuis le jumeau numérique que depuis les panneaux latéraux. Vous comprendrez immédiatement la signification des codes couleur et des indicateurs visuels pour repérer un défaut, une déconnexion ou un équipement en travaux sans perdre de temps. Il explique aussi le rôle des widgets 3D, des objets graphiques et des annotations pour lire le contexte terrain avec plus de précision. À la fin, vous saurez naviguer de façon fluide dans l’application et interpréter l’état global d’un parc d’équipements en un coup d’œil.
Lire la ressource
Hub : Présentation générale
Comprenez en quelques minutes comment le Hub Immersive orchestre l’accès aux données entre vos applications et des sources hétérogènes comme OPC UA, Excel, MQTT ou SQL. Cette présentation montre concrètement comment un même mécanisme unifie les requêtes, les mises à jour et les statuts de qualité, sans exposer la complexité des protocoles. Vous verrez le rôle précis des handles, des sessions et des connecteurs, et comment le Hub distribue les bonnes valeurs aux bons consommateurs au bon moment. À la lecture, vous saurez modéliser un accès à une donnée, suivre le cycle de vie d’une session et comprendre comment brancher ou concevoir un connecteur adapté à vos besoins. Vous saurez aussi interpréter les états d’erreur, les timeouts et les remontées de défauts pour fiabiliser supervision et maintenance.
Lire la ressource
Binding : Introduction
Cette introduction vous montre comment relier proprement un objet de la scène 3D à un équipement métier Immersive, pour que données, états, alarmes et interactions pointent toujours vers la bonne cible. Vous comprendrez la logique du modèle objet, des familles, des instances, des handles et des scopes, sans rester au niveau théorique. La formation s’appuie sur un cas concret, BuildingSensorSimulator, pour apprendre à identifier les équipements à créer et à structurer un contrat de données fiable. À la lecture, vous saurez préparer un binding stable entre vue 3D et DOM, éviter les mappings fragiles et concevoir une base exploitable pour le scripting, l’UI et la supervision. C’est le point de départ indispensable pour bâtir un jumeau numérique cohérent, évolutif et fidèle au terrain.
Lire la ressourceExplorer
Parcourir les domaines du GSDN
Chaque rayon regroupe les documents, guides et références d’un même domaine fonctionnel ou technique.
Forge
Forge est l’environnement de **création intégré** de la plateforme Immersive. Conçu pour les développeurs, intégrateurs, comemrciaux et formateurs, Forge permet de créer, personnaliser et déployer des expériences pour Immersive adaptées à une multitude de cas d’usage.
14 documentsBinding
Binding concepts and guides.
1 documentArticles
Technical articles and transversal topics.
1 documentCommons
Common setup and shared fundamentals.
0 documentsConnaissances de base
Explorez les guides, références et exemples de ce domaine.
1 documentHub
Le Hub Immersive est le cœur de l’infrastructure de données de la solution Immersive. C’est l’intermédiaire universel entre : * Les sources de données : capteurs IoT, automates (OPC UA, Modbus, MQTT…), fichiers Excel, bases SQL, API REST… * Les consommateurs : applications Beholder 3D, superviseurs, synoptiques web, ou tout autre service métier. Le Hub agit comme un **chef d’orchestre** : Il centralise les données hétérogènes provenant de multiples protocoles, il synchronise en temps réel les valeurs utiles avec les applications clientes et assure la cohérence et la fiabilité des informations pour la supervision et la maintenance.
4 documents
Rest Frontage
Le RestFrontage, l’Enhancer de la solution Immersive, transforme un socle riche de données, de services et de règles de sécurité en une expérience claire, accessible et exploitable. Interfaces web, API, administration et intégration s’y rejoignent pour offrir aux utilisateurs comme aux applications une façade cohérente sur tout l’écosystème Immersive. **Une porte d’entrée unique, du socle technique jusqu’aux usages métier.**
19 documents
Scripting
Apprenez à donner vie à vos plan en réagissant aux données recçus et en offrant une interface adaptée aux besoins de vos utilisateurs.
16 documentsÀ découvrir
Poursuivez votre exploration
Des ressources choisies aléatoirement dans la bibliothèque pour découvrir d’autres possibilités offertes par Immersive et les technologies GraphicStream.
Modèles 3D.
Ce module vous montre comment transformer une carte Forge en environnement lisible, crédible et immédiatement compréhensible grâce aux modèles 3D. Vous apprendrez à placer rapidement vos objets, puis à les déplacer, orienter et redimensionner avec précision via le gizmo et les raccourcis clavier. La formation explique aussi comment éviter les rendus répétitifs, notamment pour la végétation ou les objets dupliqués, en variant formes, rotations et échelles. Vous saurez enfin importer de nouveaux modèles dans la bibliothèque et les conserver proprement pour enrichir vos projets. À la clé : des cartes plus réalistes, plus parlantes et mieux adaptées aux usages terrain.
Découvrir
Customisation Cartouche / Widget 3D
Cette formation montre comment piloter finement le cartouche et la bulle d’un équipement dans la carte 3D grâce à JavaScript. Vous verrez quels champs du Widget3D peuvent être modifiés, du titre à l’icône, jusqu’au bouton QuickAction. Le document s’appuie sur des cas concrets faciles à réutiliser : afficher une température, changer une icône selon un état, ouvrir un flux caméra ou visualiser un niveau de remplissage. À la lecture, vous saurez implémenter la fonction Customize, exploiter les variables d’un équipement et adapter l’affichage 3D à votre logique métier. Un bon point d’entrée pour rendre la carte plus lisible, plus actionnable et plus utile au quotidien.
Découvrir
Intégrer l’authentification Immersive
Cette formation vous guide pas à pas pour intégrer l’authentification Immersive dans votre environnement, sans rester au niveau théorique. Vous comprendrez son rôle dans l’architecture, les prérequis à réunir et les points de vigilance à anticiper avant toute mise en œuvre. Le document détaille la préparation, la configuration et un premier cas concret pour passer rapidement d’un cadre fonctionnel à une intégration opérationnelle. À la lecture, vous saurez identifier les paramètres essentiels, vérifier le résultat attendu et résoudre les problèmes les plus fréquents. Vous repartirez aussi avec des bonnes pratiques et des pistes d’adaptation pour répondre à des besoins métier plus spécifiques.
Découvrir
Configurer plusieurs instances de RestFrontage derrière IIS ARR
Déployez plusieurs instances de RestFrontage derrière IIS ARR sans casser vos redirections, vos URLs publiques ni la détection du HTTPS d’origine. Ce guide montre concrètement comment faire transiter correctement `X-Forwarded-Proto`, déclarer les proxys de confiance et configurer deux nœuds sur une même machine avant d’étendre le principe à d’autres architectures. Vous saurez quelles adresses autoriser dans `KnownProxies`, comment éviter les boucles de redirection et pourquoi le nom d’hôte public doit être préservé par le proxy. La documentation détaille aussi les vérifications à effectuer côté application, côté ARR et côté accès public pour valider la mise en service. En le parcourant, vous gagnerez du temps sur les erreurs les plus fréquentes et disposerez d’une méthode fiable pour diagnostiquer un comportement incorrect en multi-instance.
Découvrir
Forge : Ajout d'un plan.
Avant de dessiner dans Forge, il faut poser un fond fiable : ce module montre comment ajouter un plan qui servira de repère à toute la modélisation. Vous apprendrez à exploiter le fond satellite par défaut, à importer une image ou un PDF géoréférencé, puis à le positionner correctement sur la carte avec des points de contrôle. Le document explique aussi comment choisir entre un plan global ou limité à un étage, selon votre besoin. Vous saurez enfin ajuster son affichage pour continuer à le lire malgré les zones, structures et modèles 3D déjà présents. Résultat : un dessin mieux aligné, plus rapide à construire et plus fidèle au terrain.
Découvrir