Aller au contenu principal

Aide aux développeurs

Destinée aux développeurs qui écrivent des applications React personnalisées et des contrôles personnalisés sur le Runtime SDK de Parsware, et qui intègrent des systèmes externes au moyen d’API personnalisées. Il s’agit de la référence d’API publique, distincte de la documentation interne du code qui accompagne les sources de la plateforme.

Ce profil publie également les schémas d’artefacts lisibles par machine — les définitions canoniques et versionnées (JSON Schema et grammaire BS Lang) de chaque artefact produit par un concepteur (processus, rapports, formulaires et vues, métadonnées de table, flux, API personnalisées, etc.). Ce sont eux qui permettent de valider une définition écrite à la main ou générée par une IA exactement comme l’est la sortie de l’interface du concepteur.

Par où commencer : créer une application personnalisée ou un contrôle personnalisé​

Si vous écrivez du code qui s’exécute dans le Shell de la plateforme Parsware, lisez ces pages dans l’ordre. Chacune se suffit à elle-même, mais elles forment ensemble le chemin qui mène d’un dossier vide à une application livrée.

  1. Créer une application React personnalisée — un écran entier écrit à la main : la mise en place du projet, la configuration Module Federation qui le rend hébergeable, le composant d’application, son exécution autonome, ses tests et sa livraison.
  2. Créer un contrôle personnalisé — un éditeur de champ de type PCF qui remplace un contrôle intégré sur un formulaire Model-Driven : le contrat de props fixe, les types de champ qu’un contrôle peut remplacer, et les états de valeur qu’il doit gérer.
  3. Utiliser le Runtime SDK — l’unique interface par laquelle les deux précédents accèdent à la plateforme : identité, portées (scopes), métadonnées de table, enregistrements, recherches et journalisation.

L’enregistrement de ce que vous avez créé — la partie qu’un créateur effectue dans le Centre de contrôle d’administration — est traité dans Enregistrer une application React personnalisée et Enregistrer un contrôle personnalisé.

Rapports​

  • Interroger les données d’une table pour les rapports — lire les données d’une table Model-Driven Apps au moyen de la source de données de rapport, en lecture seule et autorisée par portée.