Aller au contenu
SurfaceDocs
ENCommencer
DocsTravailler avec Surface

Surfaces et objets

Écrire, structurer et adresser les objets de vos Surfaces.

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 avant de restaurer une ancienne révision et la référence des 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.

{
  "recordProfileKey": "client",
  "contentKind": "document"
}

Variante et raccordement

Fragment à placer dans documentProfiles[]. Propriétés et valeurs admises.

{
  "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
DISPOSITION ILLUSTRATIVEApp Clients / Soumissions
SurfaceClients / Atelier NordExemple
Documents et AnchorsNotes du client et document exporté
Clients
Atelier Nord · S-1042Proposition de services

Accompagner le nouveau projet du client avec une proposition précise et documentée.

Montant proposé12 500
↗ Tarifs et procédure retenus
Recherchez un concept, un champ ou une action.Esc