--- title: "Surfaces et objets" url: https://developers.dagio.ai/fr/documents/ --- # Surfaces et objets ## Un contenu structuré Une Surface réunit des objets dans une composition universelle : texte riche, images, tableaux et vues liées. Chaque objet possède une identité stable pour les liens, la recherche et les opérations AI ciblées. Renommer ou déplacer un objet conserve cette identité. Les titres H1–H6 structurent le texte d’un objet; ils ne portent ni identité métier, ni Tags, ni protection indépendante. Une entrée de template qui doit être adressable utilise un objet Rich text avec son propre en-tête. Les templates de Work documentation composent ces entrées dans le même éditeur Surface, avec View, Edit et Layout. ## Templates de documentation du travail Dans le Builder d’application, **Work documentation → Assign template** propose des points de départ réutilisables pour chaque étape. **Task details** définit la demande, le périmètre, le résultat attendu et les critères de réussite; **Task summary** rappelle cette demande et rapporte le travail réalisé, les vérifications et ce qui reste à faire. Project brief, Action plan, Issue report, Procedure, Review, Checklist et Analysis couvrent les besoins courants, en complément des templates de réunion, recherche, spécification, décision et compte rendu. **Specification** peut décrire un produit, un service, un processus ou une solution technique. Chaque template fournit des Fields typés adaptés — dates, responsable, priorité ou résultat — et ses propres Instructions d’utilisation. Modifiez-les dans l’éditeur **Fields** partagé. Les Fields requis signalent les métadonnées attendues; un brouillon incomplet peut toujours être sauvegardé. Les personnes, dates, références et résultats obtenus ne sont pas inventés. Les descriptions longues et les preuves restent dans les objets de contenu titrés. La création copie la définition du template; une modification ultérieure du catalogue ne réécrit pas les templates enregistrés ni les travaux existants. Ces métadonnées ne pilotent pas l’état d’exécution du Workmap. Chaque étape accepte au plus un template assigné. Il définit la **Surface Home** créée par défaut pour cette étape au démarrage d’un nouveau travail. D’autres Surfaces peuvent être ajoutées à l’exécution, y compris depuis le même template; elles ne remplacent pas le Home. Celui-ci reste éditable et conserve son identité après renommage, déplacement ou modification du Model. Sa carte illustrée ouvre la Definition, les Instructions, les Fields et le Contents de la copie locale. Les modifications concernent cette étape uniquement; le catalogue source reste inchangé. Les nouvelles assignations affichent **Modified** si leur définition diffère du point de départ assigné, et **Custom** identifie un point de départ personnalisé. Retirer une assignation ou supprimer son étape présente la liste des définitions et modifications locales qui seront perdues. Les travaux existants et leurs Surfaces déjà créées sont conservés. À l’exécution, la navigation **Home** présente toujours la Surface assignée. Sa mise à la corbeille et sa fusion vers une autre Surface sont refusées, tout comme la mise à la corbeille d’un dossier qui la contient. Les Surfaces complémentaires restent supprimables normalement. Ces protections sont appliquées par le writer commun à l’application et à MCP, au-delà des boutons désactivés. Les captures des travaux existants sont conservées; le rôle Home est enregistré au démarrage des nouveaux travaux. ## Métadonnées d’une Surface Le corps du document, ses Fields stockés, sa description et ses dates appartiennent à la même révision. Lire ces valeurs n’autorise pas à modifier les attributs protégés. Les déclarations du Model et les valeurs effectives restent distinctes ; un contenu natif sans Model n’en reçoit pas de fictif. Les accès humains et AI restent soumis aux droits et aux protections de divulgation applicables. La consultation d’un contenu retenu demeure en lecture seule. Dans Clients, la Surface **Compte rendu de qualification** contient les objets Besoin, Contraintes et Prochaine action. L’AI peut travailler sur Contraintes tout en conservant les autres objets et leurs modifications. | Propriété | Options / valeurs attendues | Description | | --- | --- | --- | | Titre | Texte lisible | Présente l’objet dans la Surface | | Protection | Verrou d’objet | Protège les modifications admises sur l’objet et ses descendants | ## Éditer un objet Travaillez directement dans la Surface. Pour demander une réécriture, sélectionnez l’objet et précisez l’intention : « Reformule les contraintes sans changer les montants. » La proposition doit respecter le périmètre sélectionné et les protections. Une modification structurelle n’est pas équivalente à une simple modification de texte. ## Formats et provenance Les contenus natifs gardent leur format, leurs révisions et leurs références. Document, Markdown, Code, Canvas et Asset utilisent les éditeurs adaptés à leur contenu. La composition UI choisit l’emplacement de l’éditeur; elle ne réinterprète pas son format persistant. Un export confirmé est distinct de la lecture du fichier ou de son téléchargement par l’application hôte. Si l’export est confirmé mais que la lecture ou la livraison échoue, reprenez cet export sans générer un autre fichier; vos accès courants restent vérifiés. Si la réponse est inconnue, reprenez la même demande en attente avant de changer la source ou le format. La confirmation seule ne prouve pas que le fichier a été enregistré sur votre appareil. Lorsqu’un profil d’export historique est proposé pour les références d’un Work, sélectionnez la capture retenue. Le document utilise les révisions et l’ordre de cette capture, avec le profil du programme d’origine, même si l’application a évolué depuis. Il ne remplace pas ces références par leurs contenus actuels. Vos droits et les protections actuelles restent vérifiés : une ancienne capture ne donne aucun accès supplémentaire. Une reprise conserve le même export confirmé, sans réexécuter l’Action du Work. Pour un client MCP, utilisez `surface_work_document_composition_options_get` pour découvrir les profils de la capture Work sélectionnée, puis `surface_work_document_composition_preview` pour examiner les références d’origine et le format. Confirmez par `surface_work_document_composition_start`, en transmettant le `manifestHash` reçu comme `expectedManifestHash` et en gardant la même `idempotencyKey`. Après une réponse perdue, reprenez cette intention sans générer un autre export. `surface_document_export_get` lit l’export obtenu par le chemin de téléchargement commun. L’`applicationContext` courant reste distinct du `programModelRevisionId` d’origine ; la demande ne fournit ni ses propres corps de sources, ni droits, ni manifeste. ## Composer une copie documentaire Document Studio prépare un document depuis les occurrences et les versions exactes d’une composition examinée. Choisissez leurs titres, leurs niveaux et leur ordre, puis ajoutez ou retirez les sections proposées. La revue conserve les citations et la provenance, sans remplacer les sources par leurs versions actuelles. Confirmez explicitement l’enregistrement d’une copie autonome dans une nouvelle Surface déclarée ou une révision du document choisi. Le droit de lire une source ne suffit pas : son export doit être permis et la destination doit autoriser votre écriture sans affaiblir les protections de recherche, de divulgation AI ou de confidentialité. Une citation n’accorde aucun accès futur à la source. Après une réponse inconnue, reprenez la même demande ; après un reçu connu, rouvrir la copie ne répète pas sa sauvegarde. La copie reste un document éditable, distinct d’un export binaire. Depuis la copie enregistrée, choisissez le profil documentaire de destination et un format riche qu’il autorise. L’export conserve le document natif plutôt que de le convertir en texte simplifié. Les mises en page, polices ou ressources non prises en charge refusent le fichier entier, sans retirer une partie du contenu. Les images doivent être matérialisées : une adresse distante ne devient pas une copie autonome. Un rendu confirmé peut être téléchargé à nouveau sans recréer le fichier; une réponse incertaine reprend la même demande. Consultez l’[historique](https://developers.dagio.ai/fr/history/) avant de restaurer une ancienne révision et la [référence des formats](https://developers.dagio.ai/fr/native-formats/) pour générer un contenu avec un outil. ## Limite d’objets Dans **Settings → Surfaces**, réglez le nombre maximal d’objets par Surface entre 1 et 1 000. La valeur par défaut est 1 000. Le réglage et les limites du Model contrôlent les nouveaux ajouts; abaisser la valeur ne masque aucun objet existant et n’empêche pas une modification sans ajout. La recherche et les liens utilisent les identités d’objets, sans limiter l’index à 500 éléments. ## Exemples appliqués : Notes du client et document exporté Le contenu reste éditable dans la fiche; le profil d’export sélectionne les soumissions autorisées. ### Configuration Propriétés du composant `NativeContent.props`. [Propriétés et valeurs admises](https://developers.dagio.ai/fr/surface-components/#nativecontent). ```json { "recordProfileKey": "client", "contentKind": "document" } ``` ### Variante et raccordement Fragment à placer dans `documentProfiles[]`. [Propriétés et valeurs admises](https://developers.dagio.ai/fr/reference/managed-document-profile-v3/). ```json { "contract": "DocumentProfile@3", "key": "client-quotes-export", "source": { "kind": "record-query", "recordProfileKey": "client", "queryBindingKey": "client-quotes", "viewKey": "quotes-table" }, "exportFormats": [ "markdown" ], "budget": { "maximumRows": 100, "maximumPages": 4, "maximumOutputBytes": 1000000 } } ``` ### Exemple de disposition UI La disposition illustrative ci-dessous situe cette configuration dans l’app Clients/Soumissions. Chaque fragment s’insère à l’emplacement indiqué; ses références aux Fields, Queries et Actions correspondent aux déclarations du Model. 1. Soumission S-1042 2. Objet et besoin 3. Proposition 4. Références retenues