Inspecter — Portraits & Passports

L’JinDesk a deux surfaces « inspecter ceci », et elles répondent à des questions vraiment différentes. Savoir laquelle est laquelle, c’est tout le savoir-faire :

Un Portrait inspecte une instance — une chose dans les données. « Qui est celle-ci, et qu’a-t-elle enregistré ? »

Un Passport inspecte une définition — une colonne, un type ou un terme. « Qu’est ce champ, et que sait la plateforme à son sujet ? »

Portrait : les données (une instance) :: Passport : les métadonnées (une définition).

Le test, quand vous hésitez : est-ce que je regarde une ligne ou une colonne ? Une ligne — une station, une parcelle, un matériel, un cas — reçoit un Portrait. Une colonne, un terme marqué ou un type — reçoit un Passport.

Le Portrait — un portrait d’un sujet

Un Portrait est la surface d’inspection d’une instance d’entité focalisée. Vous l’ouvrez en focalisant une chose — en cliquant sur un objet de carte, un point de nuage, une ligne de tableau — et il montre le dossier de ce seul sujet : ses valeurs et une porte vers ses preuves.

• Son sujet est toujours un business_id précis — cette station, cette parcelle — jamais un genre de chose.
• Il est piloté par la piste Focus : zéro ou un sujet à la fois sous inspection. Focaliser ouvre le Portrait ; effacer le focus le ferme.
• Exemple canonique — le Station Portrait. Cliquez sur une station sur une carte, et ses flux de mesure co-localisés s’ouvrent sur place, chacun déployable de l’aperçu jusqu’à la preuve en un seul geste.

Mnémonique : un portrait est de quelqu’un — un portrait d’un sujet particulier.

Le Passport — les papiers d’une colonne ou d’un terme

Un Passport est la surface d’inspection d’une déclaration — tout ce que la plateforme sait d’un champ ou d’un terme, au point d’usage.

• Exemple canonique — le Column Passport. Vous l’ouvrez sur un en-tête de colonne (un clic délibéré ou une plongée clavier dans l’en-tête ; l’aperçu au survol est piloté par la configuration). Il assemble, à partir de ce que jin make a déjà cuit :
  • le type sémantique — kind, subkind
  • son unité et son standard (l’autorité Codex — nom complet, éditeur, juridiction)
  • comment il s’agrège en remontant une hiérarchie (sa politique rollup)
  • d’où il est dérivé (la chaîne de raffinement)
  • sa configuration d’affichage résolue (précision, format, unité d’affichage)
  • ou, honnêtement, un état « non raffiné » quand rien n’est déclaré — avec un chemin pour le corriger.
• Frère — le Term Passport. Un terme de glossaire marqué montre sa définition et son vocabulaire propriétaire à l’endroit où il est utilisé.
• Son sujet est un genre de chose, jamais une instance : unit_price la colonne, pas le prix de la ligne 12.

Mnémonique : un passeport est un document qui certifie ce qu’une chose est — son type, sa provenance, ses papiers.

Ils peuvent se rencontrer sur un clic

Cliquer sur une cellule peut offrir les deux — le Portrait de la ligne (« montre-moi tout ce matériel ») et le Passport de la colonne (« qu’est ce champ unit_price ? ») — car « laquelle est-ce ? » n’est pas « qu’est-ce que c’est ? ». Une surface qui essaierait d’être les deux serait lisible comme aucune, c’est pourquoi les deux restent séparées.

En un coup d’œil

	Portrait	Passport
sujet	une instance (une ligne)	une définition (une colonne / un terme / un type)
question	qui est celle-ci ? qu’a-t-elle enregistré ?	qu’est ce champ ? qu’en sait-on ?
ouvert par	focaliser un objet / point / une ligne	inspecter un en-tête de colonne / terme marqué
piloté par	la piste Focus (0..1)	la Typologie + le Codex
indexé sur	un business_id	un nom de colonne / terme
canonique	le Station Portrait	le Column Passport

Voir aussi

• Référence Typologie — les types qu’un Passport rapporte
• Sense 54 — The Typology · Sense 53 — The Codex
• Guide JinDesk — les pages où vivent ces surfaces