Liaisons

Comment une instance d'objet typé est projetée depuis une source réelle — table gérée, page de base de connaissances, tâche de flux de processus ou saisie manuelle.

Une liaison est la règle qui indique à l'ontologie comment matérialiser une instance d'objet typé à partir d'une source réelle. Les liaisons constituent le pont entre L2 (schéma) et la couche de données sous-jacente.

Projection à la lecture

Une liaison ne copie pas de lignes dans une nouvelle table :

   regulated_entities (managed table)
   ┌─────────────────────────────────────────┐
   │ EntityID │ LegalName    │ RiskClass    │
   ├─────────────────────────────────────────┤
   │ e1...01  │ Acme Holdings│ medium       │
   │ e1...02  │ Neptune Cap. │ high         │
   └─────────────────────────────────────────┘
                 │
                 │   binding (silver_table)
                 │   columnMap:
                 │     id              ← EntityID
                 │     legalName       ← LegalName
                 │     riskClass…      ← RiskClass
                 ▼
   RegulatedEntity (typed Object — projected on demand)
   { id: "e1...01", legalName: "Acme…", riskClassification: "medium" }

Lorsqu'un appelant lit une RegulatedEntity, la projection de la liaison s'exécute sur la table source et retourne des instances typées. La réimportation du CSV source est répercutée à la prochaine lecture.

Types de liaisons

Type	Source	Statut
`silver_table`	Une table gérée — vos imports CSV / JSON	disponible
`memex_page`	Une page de base de connaissances	disponible
`process_flow_task`	Une instance de tâche de flux de processus	disponible
`manual`	Écritures via SDK / workbench — pas de source en amont	disponible
`process_flow_action`, `extraction`, `stream`	Actions de lien d'entité, pipelines d'extraction, topics pub/sub	préversion

Un pack peut distribuer des liaisons de tout type. Les liaisons peuvent également être créées directement depuis l'onglet Liaisons du workbench sans toucher au SDK.

Carte de colonnes

Pour une liaison silver_table, la carte de colonnes déclare quelle colonne source alimente chaque propriété d'objet :

Object property      Source column
─────────────────    ─────────────────
id              ←    EntityID
legalName       ←    LegalName
riskClass…      ←    RiskClass

La carte de colonnes est modifiable depuis l'onglet Liaisons. Le sélecteur accepte à la fois le nom de colonne physique (fius_fiu_id) et le nom d'affichage (fius.fiu_id) — voir Noms de colonnes pour leur synchronisation.

Prêt vs. non prêt

Une liaison affiche l'un des trois badges de statut dans le workbench :

Badge	Signification	Que faire
Prêt	Source résolue, chaque valeur de la carte de colonnes correspond à une colonne de la table liée.	Utilisez-la.
Non prêt — table non enregistrée	Le pack distribue un nom de source logique ; aucune table correspondante n'existe encore dans cet espace de travail.	Cliquez sur Choisir une table, sélectionnez la bonne table gérée — le sélecteur met en évidence les correspondances exactes de nom.
Non prêt — colonnes manquantes	La table liée ne possède pas toutes les colonnes référencées dans la carte de colonnes.	Modifiez la carte de colonnes — choisissez la bonne colonne pour chaque propriété.

La vérification Prêt est une sonde en direct, pas un cache. Elle s'exécute à chaque listage, donc une liaison qui passe de Prêt à Non prêt signifie qu'un changement a eu lieu en amont (table archivée, colonnes renommées).

Étiquettes DLP et masquage

Chaque instance projetée porte les étiquettes DLP de sa source :

Une propriété liée à une colonne classée confidential hérite de cette classification.
Une stratégie de masquage appliquée à la colonne source s'applique également à la propriété projetée.
Un appelant sans habilitation sur la colonne voit la valeur masquée dans l'objet projeté, pas la valeur brute.

C'est ce qui rend l'ontologie exposable en toute sécurité aux agents — il n'existe aucun moyen pour un agent de lire un objet typé en contournant la gouvernance au niveau de la colonne de sa source.

Provenance

Chaque instance projetée porte une provenance :

Champ	Valeur
`bindingId`	Quelle liaison a produit cette instance
`bindingVersion`	Quelle version de cette liaison
`sourceRef`	Une référence à la ligne source (ex. `EntityID="e1...01"`)
`materializedAt`	L'horodatage de la projection
`dlpLabels`	Les étiquettes DLP propagées

Les outils de workflow et la surface analytique exposent cette provenance à côté des données, afin que l'utilisateur puisse toujours répondre à la question « d'où vient ceci ? ».

La provenance est en lecture seule au niveau de la couche de liaison — elle est émise par la projection, jamais créée par l'utilisateur. Les liaisons créées manuellement dans le workbench portent toujours une provenance indiquant le workbench lui-même comme source.

Ressources associées

Types d'objets — ce que les liaisons produisent comme instances.
Analytics → Noms de colonnes — fonctionnement de la recherche de colonnes source.
Branches et propositions — les liaisons sont versionnées avec le schéma.