Extensions

Un extension est la façon dont Scrydon distribue les paramètres par défaut de l'organisation — un preset réutilisable et opinionné qu'une organisation installe une fois et que tout le monde hérite. Aujourd'hui une extension contient l'ontologie (types d'objets, types de liens, types d'actions, règles d'identité et liaisons) ; le même mécanisme transporte de plus en plus les paramètres par défaut pour les surfaces auxquelles ces objets se lient :

• Base de connaissances — l'extension knowledge-base relie les pages téléversées et les tables gérées à des objets typés.
• Process flows — l'extension process-flows distribue des objets typés pour les cycles de revue et d'audit ISO 27001 / 42001.
• Sources de données (bientôt) — liaisons par défaut contre les tables gérées qu'une organisation ingère.

Pensez à une extension comme « le monde typé dont une organisation part », distribué via la extensions de la plateforme et installable en un clic. Les extensions première partie et les extensions créés par les clients utilisent exactement le même artefact et le même chemin d'installation.

Ce que contient une extension

L'état de l'ontologie est propre à chaque environnement d'espace de travail. Une action d'extension à l'échelle de l'organisation applique donc la même extension à la révision main publiée de chaque environnement d'espace de travail existant ; elle ne crée pas une unique ontologie au niveau de l'organisation. Les liaisons distribuées avec des noms de source logiques doivent toujours être mappées aux tables gérées là où elles sont utilisées.

Extensions intégrés

Scrydon distribue un petit nombre de extensions prêts à l'emploi. Les plus courants :

• knowledge-base — relie les pages de base de connaissances et les tables gérées à des objets typés.
• process-flows — objets typés pour les tâches de process ISO 27001 / ISO 42001 (cycles de revue, cycles d'audit).

L'ontologie knowledge-base est installée automatiquement, une seule fois, lors de la création d'un nouvel environnement d'espace de travail. Elle n'attend pas la première ouverture du workbench. Les actions d'extension à l'échelle de l'organisation couvrent les environnements déjà existants.

Extensions de domaine

Les extensions de domaine sont préconstruits pour des secteurs verticaux spécifiques :

• fraude-intelligence — objets AML/détection de fraude pour les services financiers : Transaction, Customer, SuspiciousActivityReport, RegulatedEntity, Supervisor. Six liaisons préconstruites contre des tables silver typiques.
• nato-maritime — objets de défense maritime : Vessel, AISContact, Incident, Region.
• iso-quarterly-review — tâches de revue de conformité trimestrielle.
• iso-yearly-review — tâches de revue de conformité annuelle.

Voir Exemples pour des guides de bout en bout de ces extensions.

Installation d'une extension — modèle en deux étapes

L'installation d'une extension se divise en deux : un administrateur de l'organisation admet l'extension dans le catalogue de l'organisation (Étape 1), et les utilisateurs de l'espace de travail choisissent ce qu'il faut matérialiser dans leur environnement (Étape 2). À l'Étape 1, une action d'ontologie à l'échelle de l'organisation est diffusée vers tous les environnements d'espace de travail existants. À l'Étape 2, une action d'ontologie depuis la Marketplace Analytics ne cible que l'environnement actif.

Étape 1 — L'admin téléverse l'extension (à l'échelle de l'organisation)

Depuis Settings → Extensions :

1. Glissez-déposez votre archive de extension — .scrydon-extension.tar.gz / .tgz ou .zip. Les archives dont les fichiers se trouvent dans un dossier racine unique (comme celles produites par « Télécharger en ZIP » ou tar czf extension.tar.gz mon-extension/) fonctionnent telles quelles, et les fichiers de métadonnées système (.DS_Store, __MACOSX/, AppleDouble ._*) ainsi que les fichiers de documentation à la racine (README.md, LICENSE, …) sont ignorés.
2. Examinez les contributions d'ontologie + sources de données du extension.
3. Cliquez sur Publier.

La plateforme admet l'extension dans le catalogue. Les contributions d'ontologie sont appliquées à chaque environnement d'espace de travail qui appartient actuellement à l'organisation (types d'objets, types de liens et liaisons apparaissent sur le main publié de chaque environnement). Cette diffusion est déterministe et bornée ; l'action administrative ne réussit qu'après le succès de toutes les cibles. Les contributions de sources de données sont cataloguées mais pas encore matérialisées — pas de ligne data_source, pas de planification d'ingestion, pas de tick Dapr. L'application d'une source de données n'est pas répétée pour chaque cible d'ontologie.

Chaque ligne du catalogue résume ce que l'extension apporte sous forme de badges colorés — N ontologies, N workflows, N process flows, N sources de données, N domaines KB. Cliquez sur un badge pour voir le détail derrière le compte (noms de workflow et nombre de blocs, vendeurs de sources de données et colonnes, slugs de domaines KB) ; cliquez sur la ligne elle-même pour ouvrir la fiche détaillée complète du extension.

Étape 2 — L'utilisateur de l'espace de travail installe dans un environnement

La page Analytics → Marketplace est la surface unique de l'Étape 2. Elle répertorie tout ce qui est installable dans l'environnement de l'espace de travail actuel, une ligne par unité installable, avec une colonne type de contenu et un filtre (Tout / Sources de données / Ontologies) ainsi qu'une recherche en texte libre. Chaque extension apparaît une fois, dans sa dernière version, et les lignes sont regroupées par état — Mises à jour disponibles, Disponible à l'installation et Installé — pour pouvoir installer ou mettre à jour depuis un seul endroit :

• Sources de données — une ligne par entrée de source de données dans une extension catalogué. Cliquez sur Installer et la source de données se matérialise dans votre environnement immédiatement (une première synchronisation s'exécute aussitôt — vous n'avez pas à attendre le prochain sondage planifié) et continue ensuite l'ingestion selon le planning. Lorsqu'une version plus récente du extension est disponible, la ligne affiche Mettre à jour vers vX ; cliquer dessus réconcilie l'ensemble des sources de données du extension avec la nouvelle version : les sources existantes reçoivent le nouveau manifeste (et re-matérialisent leurs tables), les sources que la nouvelle version ajoute sont installées, et les sources installées que la nouvelle version supprime sont retirées (leurs tables sont conservées — supprimez-les depuis Analytics → Sources de données si elles ne sont plus nécessaires). Les nouvelles installations restent par source : cliquer sur Installer sur une ligne n'installe jamais les autres sources du extension. Gérez les sources depuis Analytics → Sources de données.
• Extensions d'ontologie — extensions distribués par Scrydon et extensions du catalogue de l'organisation qui apportent du contenu d'ontologie. Cliquez sur Installer pour activer les types d'objets, types de liens et liaisons de l'extension dans l'environnement actif uniquement. Les lignes affichent la signature du extension (Scrydon / Signé par l'organisation / Non signé) et indiquent quand une version plus récente que celle installée est disponible. (Le bouton Parcourir la Extensions dans l'Ontology Designer renvoie ici — il ouvrait auparavant un navigateur de extensions en page.)

Les extensions uniquement source de données (sans ontologie) ne font rien à l'Étape 1 au-delà de l'admission dans le catalogue — le téléversement se termine silencieusement et la source de données apparaît dans la extensions pour que les utilisateurs la sélectionnent.

Les extensions avec uniquement du contenu workflow / process-flow s'installent toujours via les pages Process Flows / Workflows agentic et ne sont pas répertoriés dans la extensions analytics.

Échecs de diffusion et nouvelles tentatives

Une action d'ontologie à l'échelle de l'organisation produit un résultat pour l'ensemble des cibles :

• Si l'organisation ne possède aucun environnement d'espace de travail, elle échoue avec no_workspace_environments ; aucune requête d'ontologie n'est envoyée.
• Si un ou plusieurs environnements échouent, l'action signale un échec partiel de diffusion. Les environnements qui ont déjà réussi ne sont pas annulés.
• Une nouvelle tentative est sûre. Le même ensemble de cibles et le même plan ont une identité de reçu stable, et réappliquer une extension déjà appliquée est idempotent.

La page Paramètres → Plateforme → Extensions ne déclare l'état d'ontologie que si tous les environnements attendus partagent la même version d'extension, la même provenance de catalogue/source et le même manifeste normalisé. Un environnement manquant ou divergent apparaît comme indisponible/incohérent au lieu de choisir silencieusement la ligne d'un environnement. Les identifiants de révision et les horodatages locaux aux environnements peuvent différer et ne servent pas à déterminer la cohérence de version de l'extension.

Mappage des liaisons à vos données

La plupart des extensions distribuent des liaisons avec des noms de source logiques — ex. "silver_table:regulated_entities". Après l'installation, vous mappez chaque source logique à une vraie table gérée dans votre espace de travail :

1. Ouvrez l'onglet Liaisons.
2. Trouvez une liaison affichant Non prête — table non enregistrée.
3. Cliquez sur Choisir la table et sélectionnez la table gérée correspondante.

La plateforme met en évidence les correspondances de nom exactes pour que le sélecteur soit quasi en un clic dans le cas courant.

Créer une extension

Les extensions sont créés avec le SDK d'authoring d'ontologie. Le SDK vous permet de :

• Définir des types d'objets / liens / actions avec TypeScript + Zod.
• Les regrouper avec des liaisons, un manifeste et des assets.
• Construire un .scrydon-extension.tar.gz téléversable via la extensions.

Le même artefact distribue les extensions première partie et les extensions créés par les clients — il n'y a pas de chemin séparé.

Cycle de vie d'une extension

De bout en bout, une extension voyage d'un projet TypeScript à des entrées typées sur main dans votre espace de travail. La plateforme valide à chaque étape ; les liaisons qui nécessitent des mappages de table spécifiques à l'espace de travail restent en attente jusqu'à ce qu'un admin les complète.

La séparation entre Apply ontology, Apply bindings et Apply workflows est réelle — chaque type a son propre appliqueur à l'intérieur de la plateforme, de sorte qu'une extension peut distribuer n'importe quel sous-ensemble (ontologie uniquement, liaisons uniquement, ou un preset vertical complet).

Connexes

• Branches & propositions — comment les installations et mises à jour de extensions atterrissent sur main.
• SDKs → Authoring → Ontologies — écrivez le vôtre.
• Exemples — exemples de extensions avec guides complets.