Aller au contenu
SurfaceDocs
ENCommencer
DocsTravailler avec Surface

Historique et reprise

Comprendre une modification et reprendre sans perdre votre travail.

Examiner les modifications

Les révisions permettent de retrouver le contenu et le contexte d’une modification. Avant de restaurer, comparez la version choisie à la version courante. Restaurer un texte ne doit pas effacer silencieusement les modifications plus récentes d’un autre membre.

Information Valeur attendue Utilité
Objet Identité de la Surface ou du travail Vérifier le périmètre
Révision Version précise Comparer les contenus
Origine Usager, AI ou opération identifiée Comprendre la modification
Résultat Réception, refus ou conflit Décider de la prochaine action

Reprendre après une interruption

Le brouillon local, la version enregistrée et le texte AI en cours sont distincts. Après une interruption, retrouvez la dernière version confirmée et vérifiez l’état de l’opération. Quand la réponse d’une Action est incertaine, consultez son résultat avant de relancer.

Si la restauration est confirmée mais que la réouverture échoue, reprenez l’ouverture de la Surface sans la restaurer une nouvelle fois. L’ouverture vérifie toujours vos accès courants. Si la réponse à la restauration reste inconnue, reprenez la même demande en attente plutôt que de confirmer une nouvelle restauration.

Les références historiques retenues indiquent les versions de sources utilisées, sans recopier leur contenu ni accorder de nouveaux accès. Consultez leurs détails et parcourez les sources par pages. Changer la langue ne change ni la sélection ni la page. L’export, lorsqu’il est proposé, conserve ces mêmes références; il ne déclenche aucune nouvelle exécution.

Examiner les références d’origine d’un Work

Sélectionnez la révision historique exacte avant de consulter ses captures de références. Surface découvre uniquement les familles de captures réellement conservées sur cette révision. Si aucune n’est disponible, aucune capture n’est reconstruite à partir du Model ou de la Query actuels. Si des captures ordinaires et Work coexistent, choisissez explicitement la famille, sans les fusionner ni essayer l’une après l’autre.

Pour un client MCP, surface_reference_capture_history_discover retourne ces métadonnées de famille sans lire les corps des sources, les politiques ou le manifeste d’une capture. La famille Work utilise surface_work_reference_capture_list et surface_work_reference_capture_get ; une capture ordinaire n’est pas réétiquetée comme capture Work. Ces lectures exigent surface:read et les autorisations courantes, dont la divulgation à l’AI lorsqu’elle est demandée.

Le Work d’origine, son étape et le programme de sa politique restent distincts de l’application courante. Lire une capture retenue vérifie les accès actuels à ses sources ; son certificat historique ne donne aucun droit supplémentaire. Les exports documentaires gardent la même capture sélectionnée et ses références d’origine, sans réexécuter le Work ni les remplacer par les versions courantes.

Exemple

Vous avez complété les contraintes d’Atelier Nord pendant que l’AI préparait une reformulation. Votre texte reste présent. Examinez la proposition et les différences avant de l’appliquer à la section. Si le tarif de référence a changé entre-temps, le travail signale ce contexte à revoir.

L’historique explique les changements; il ne remplace ni les droits de modification ni la validation d’un résultat. Pour les mises à jour en temps réel, consultez synchronisation et collaboration.

Exemples appliqués : Conserver la référence et revoir l’impact

Une soumission garde la référence retenue, puis signale les changements qui nécessitent une revue.

Configuration

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

{
  "key": "retained-pricing",
  "sourceDefinitionPaths": [
    "workspace/knowledge/surface/pricing"
  ],
  "linkTypePaths": [
    "application/based-on"
  ],
  "mode": "pin-revision",
  "actionKey": null,
  "queryKey": null,
  "maximumTargets": 50
}

Variante et raccordement

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

{
  "key": "pricing-review",
  "sourceDefinitionPaths": [
    "workspace/knowledge/surface/pricing"
  ],
  "linkTypePaths": [
    "application/based-on"
  ],
  "mode": "mark-needs-review",
  "actionKey": null,
  "queryKey": "affected-quotes",
  "maximumTargets": 50
}

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. Objet concerné
  2. Changement proposé
  3. Vérifications
  4. Confirmer
DISPOSITION ILLUSTRATIVEApp Clients / Soumissions
SurfaceClients / Atelier NordExemple
Historique et repriseConserver la référence et revoir l’impact
Clients
AN
Atelier NordSoumission S-1042
À revoir
Changement proposé
Une soumission garde la référence retenue, puis signale les changements qui nécessitent une revue.
Données et références
Client · Besoin · Tarifs
RevenirExaminer puis confirmer
Recherchez un concept, un champ ou une action.Esc