---
title: "Référence du Model"
url: https://developers.dagio.ai/fr/reference/
---

# Référence du Model

   
                           
                                                                                
                 
                  
           
   

Le Model décrit la structure, les données, les comportements et les interfaces d’une app Surface. Cette référence sert à vérifier une propriété précise, explorer une variante ou produire des sources avec un outil. Pour apprendre à composer une app, commencez par le [guide des Models](https://developers.dagio.ai/fr/models/).

## Comment lire la référence

Les tableaux distinguent le nom exact du champ, ses valeurs admises et son rôle. Les versions sont des discriminants de contrats : elles ne sont pas des paramètres métier à demander à l’usager. Le Studio et les outils d’auteur prennent en charge la structure technique; les intégrateurs utilisent cette référence pour les sources et les artefacts.

## Structures validées

- [flowComposition](https://developers.dagio.ai/fr/reference/flow-composition/)
- [knowledgeCurationReviewProfile](https://developers.dagio.ai/fr/reference/knowledge-curation-review-profile/)
- [knowledgeCurationSuggestionKind](https://developers.dagio.ai/fr/reference/knowledge-curation-suggestion-kind/)
- [managedExactDataUnit](https://developers.dagio.ai/fr/reference/managed-exact-data-unit/)
- [managedExactDecimalFormat](https://developers.dagio.ai/fr/reference/managed-exact-decimal-format/)
- [managedExactDecimalRounding](https://developers.dagio.ai/fr/reference/managed-exact-decimal-rounding/)
- [managedNumericFieldV2](https://developers.dagio.ai/fr/reference/managed-numeric-field-v2/)
- [managedModelSourcePackage](https://developers.dagio.ai/fr/reference/managed-model-source-package/)
- [managedModelAuthorFlow](https://developers.dagio.ai/fr/reference/managed-model-author-flow/)
- [managedModelAuthorTask](https://developers.dagio.ai/fr/reference/managed-model-author-task/)
- [managedApproximateRealValue](https://developers.dagio.ai/fr/reference/managed-approximate-real-value/)
- [managedIntegerValue](https://developers.dagio.ai/fr/reference/managed-integer-value/)
- [managedChoiceValue](https://developers.dagio.ai/fr/reference/managed-choice-value/)
- [managedTypedFieldV2](https://developers.dagio.ai/fr/reference/managed-typed-field-v2/)
- [managedTypedValue](https://developers.dagio.ai/fr/reference/managed-typed-value/)
- [modelGanttSchedule](https://developers.dagio.ai/fr/reference/model-gantt-schedule/)
- [surfaceRelationPolicy](https://developers.dagio.ai/fr/reference/surface-relation-policy/)
- [surfaceTriggerDeadline](https://developers.dagio.ai/fr/reference/surface-trigger-deadline/)
- [surfaceWorkBinding](https://developers.dagio.ai/fr/reference/surface-work-binding/)
- [surfaceWorkExperience](https://developers.dagio.ai/fr/reference/surface-work-experience/)
- [surfaceWorkHeaderFact](https://developers.dagio.ai/fr/reference/surface-work-header-fact/)
- [surfaceWorkHeader](https://developers.dagio.ai/fr/reference/surface-work-header/)
- [surfaceWorkHeaderValue](https://developers.dagio.ai/fr/reference/surface-work-header-value/)
- [surfaceWorkQueryBinding](https://developers.dagio.ai/fr/reference/surface-work-query-binding/)
- [surfaceWorkScope](https://developers.dagio.ai/fr/reference/surface-work-scope/)
- [workspaceActionContextSelection](https://developers.dagio.ai/fr/reference/workspace-action-context-selection/)
- [workspaceCompositionPresentation](https://developers.dagio.ai/fr/reference/workspace-composition-presentation/)
- [managedExactDataExpression](https://developers.dagio.ai/fr/reference/managed-exact-data-expression/)
- [managedExactDataValueType](https://developers.dagio.ai/fr/reference/managed-exact-data-value-type/)
- [workspaceExactData](https://developers.dagio.ai/fr/reference/workspace-exact-data/)
- [workspaceGraphLayout](https://developers.dagio.ai/fr/reference/workspace-graph-layout/)
- [workspaceGraphPresentation](https://developers.dagio.ai/fr/reference/workspace-graph-presentation/)
- [workspaceGraphProfile](https://developers.dagio.ai/fr/reference/workspace-graph-profile/)
- [workspaceHomeIcon](https://developers.dagio.ai/fr/reference/workspace-home-icon/)
- [workspaceHomePresentation](https://developers.dagio.ai/fr/reference/workspace-home-presentation/)
- [workspaceHomePresentationV2](https://developers.dagio.ai/fr/reference/workspace-home-presentation-v2/)
- [exactDataWorkspaceFormControl](https://developers.dagio.ai/fr/reference/exact-data-workspace-form-control/)
- [exactDataWorkspaceForm](https://developers.dagio.ai/fr/reference/exact-data-workspace-form/)
- [modelSourceRights](https://developers.dagio.ai/fr/reference/model-source-rights/)
- [surfaceConsolidationProfile](https://developers.dagio.ai/fr/reference/surface-consolidation-profile/)
- [surfaceContextPolicyV4](https://developers.dagio.ai/fr/reference/surface-context-policy-v4/)
- [surfaceFlowReferenceContextSource](https://developers.dagio.ai/fr/reference/surface-flow-reference-context-source/)
- [workspaceActionLaunchSelection](https://developers.dagio.ai/fr/reference/workspace-action-launch-selection/)
- [workspaceModelFoundation](https://developers.dagio.ai/fr/reference/workspace-model-foundation/)
- [contentSpaceActionPolicy](https://developers.dagio.ai/fr/reference/content-space-action-policy/)
- [workspaceNavigationMetrics](https://developers.dagio.ai/fr/reference/workspace-navigation-metrics/)
- [workspacePresentationIcon](https://developers.dagio.ai/fr/reference/workspace-presentation-icon/)
- [workspaceQuery](https://developers.dagio.ai/fr/reference/workspace-query/)
- [workspaceQueryBinding](https://developers.dagio.ai/fr/reference/workspace-query-binding/)
- [workspaceQueryParameterKey](https://developers.dagio.ai/fr/reference/workspace-query-parameter-key/)
- [workspaceQueryControls](https://developers.dagio.ai/fr/reference/workspace-query-controls/)
- [workspaceRecordCalculationSource](https://developers.dagio.ai/fr/reference/workspace-record-calculation-source/)
- [workspaceRecordDirectValueSource](https://developers.dagio.ai/fr/reference/workspace-record-direct-value-source/)
- [workspaceRecordPresentation](https://developers.dagio.ai/fr/reference/workspace-record-presentation/)
- [workspaceRecordProfile](https://developers.dagio.ai/fr/reference/workspace-record-profile/)
- [workspaceRecordQueryBinding](https://developers.dagio.ai/fr/reference/workspace-record-query-binding/)
- [workspaceRecordTableColumnSource](https://developers.dagio.ai/fr/reference/workspace-record-table-column-source/)
- [workspaceRecordValueSource](https://developers.dagio.ai/fr/reference/workspace-record-value-source/)
- [workspaceRule](https://developers.dagio.ai/fr/reference/workspace-rule/)
- [workspaceTableCellFormat](https://developers.dagio.ai/fr/reference/workspace-table-cell-format/)
- [workspaceTableGrouping](https://developers.dagio.ai/fr/reference/workspace-table-grouping/)
- [workspaceTableLayout](https://developers.dagio.ai/fr/reference/workspace-table-layout/)
- [managedFlowBlueprint](https://developers.dagio.ai/fr/reference/managed-flow-blueprint/)
- [managedDocumentProfileV1](https://developers.dagio.ai/fr/reference/managed-document-profile-v1/)
- [managedDocumentProfileV2](https://developers.dagio.ai/fr/reference/managed-document-profile-v2/)
- [managedDocumentProfileV3](https://developers.dagio.ai/fr/reference/managed-document-profile-v3/)
- [surfaceCompositionCatalogueIdentity](https://developers.dagio.ai/fr/reference/surface-composition-catalogue-identity/)
- [surfaceCompositionCatalogueVersion](https://developers.dagio.ai/fr/reference/surface-composition-catalogue-version/)
- [surfaceCompositionElement](https://developers.dagio.ai/fr/reference/surface-composition-element/)
- [surfaceCompositionPrepareActionParams](https://developers.dagio.ai/fr/reference/surface-composition-prepare-action-params/)
- [surfaceCompositionQueryBinding](https://developers.dagio.ai/fr/reference/surface-composition-query-binding/)
- [surfaceCompositionSpec](https://developers.dagio.ai/fr/reference/surface-composition-spec/)
- [surfaceCompositionWorkActionParams](https://developers.dagio.ai/fr/reference/surface-composition-work-action-params/)
- [surfaceCompositionWorkConsolidationParams](https://developers.dagio.ai/fr/reference/surface-composition-work-consolidation-params/)
- [surfaceCompositionWorkQueryBinding](https://developers.dagio.ai/fr/reference/surface-composition-work-query-binding/)
- [surfaceCompositionWorkScope](https://developers.dagio.ai/fr/reference/surface-composition-work-scope/)

## Types nommés et formats natifs

- [FlowComposition · types](https://developers.dagio.ai/fr/reference/types-flow-composition/)
- [KnowledgeCurationReviewProfile · types](https://developers.dagio.ai/fr/reference/types-knowledge-curation-review-profile/)
- [ManagedExactDecimal · types](https://developers.dagio.ai/fr/reference/types-managed-exact-decimal/)
- [ManagedModelAuthoring · types](https://developers.dagio.ai/fr/reference/types-managed-model-authoring/)
- [ManagedModelFlowAuthoring · types](https://developers.dagio.ai/fr/reference/types-managed-model-flow-authoring/)
- [ManagedModelSource · types](https://developers.dagio.ai/fr/reference/types-managed-model-source/)
- [ManagedModelSourceFile · types](https://developers.dagio.ai/fr/reference/types-managed-model-source-file/)
- [ManagedNumericField · types](https://developers.dagio.ai/fr/reference/types-managed-numeric-field/)
- [ManagedTypedValue · types](https://developers.dagio.ai/fr/reference/types-managed-typed-value/)
- [ModelApplicationProfiles · types](https://developers.dagio.ai/fr/reference/types-model-application-profiles/)
- [ModelArtifact · types](https://developers.dagio.ai/fr/reference/types-model-artifact/)
- [ModelGantt · types](https://developers.dagio.ai/fr/reference/types-model-gantt/)
- [SurfaceRelationPolicy · types](https://developers.dagio.ai/fr/reference/types-surface-relation-policy/)
- [SurfaceTriggerDeadline · types](https://developers.dagio.ai/fr/reference/types-surface-trigger-deadline/)
- [SurfaceWorkExperience · types](https://developers.dagio.ai/fr/reference/types-surface-work-experience/)
- [WorkspaceActionContextSelection · types](https://developers.dagio.ai/fr/reference/types-workspace-action-context-selection/)
- [WorkspaceCompositionPresentation · types](https://developers.dagio.ai/fr/reference/types-workspace-composition-presentation/)
- [WorkspaceCompositionReferences · types](https://developers.dagio.ai/fr/reference/types-workspace-composition-references/)
- [WorkspaceExactData · types](https://developers.dagio.ai/fr/reference/types-workspace-exact-data/)
- [WorkspaceGraphPresentation · types](https://developers.dagio.ai/fr/reference/types-workspace-graph-presentation/)
- [WorkspaceHomePresentation · types](https://developers.dagio.ai/fr/reference/types-workspace-home-presentation/)
- [WorkspaceModelFoundation · types](https://developers.dagio.ai/fr/reference/types-workspace-model-foundation/)
- [WorkspaceNavigationMetrics · types](https://developers.dagio.ai/fr/reference/types-workspace-navigation-metrics/)
- [WorkspacePresentationIcon · types](https://developers.dagio.ai/fr/reference/types-workspace-presentation-icon/)
- [WorkspaceQuery · types](https://developers.dagio.ai/fr/reference/types-workspace-query/)
- [WorkspaceQueryControls · types](https://developers.dagio.ai/fr/reference/types-workspace-query-controls/)
- [WorkspaceRecordPresentation · types](https://developers.dagio.ai/fr/reference/types-workspace-record-presentation/)
- [WorkspaceRule · types](https://developers.dagio.ai/fr/reference/types-workspace-rule/)
- [WorkspaceTableLayout · types](https://developers.dagio.ai/fr/reference/types-workspace-table-layout/)
- [types · types](https://developers.dagio.ai/fr/reference/types-types/)
- [surface-asset · types](https://developers.dagio.ai/fr/reference/types-surface-asset/)
- [SurfaceCompositionAdmission · types](https://developers.dagio.ai/fr/reference/types-surface-composition-admission/)
- [SurfaceCompositionBindings · types](https://developers.dagio.ai/fr/reference/types-surface-composition-bindings/)
- [SurfaceCompositionEvents · types](https://developers.dagio.ai/fr/reference/types-surface-composition-events/)
- [SurfaceCompositionHomeBindings · types](https://developers.dagio.ai/fr/reference/types-surface-composition-home-bindings/)
- [SurfaceCompositionIdentity · types](https://developers.dagio.ai/fr/reference/types-surface-composition-identity/)
- [SurfaceCompositionSchema · types](https://developers.dagio.ai/fr/reference/types-surface-composition/)
- [SurfaceCompositionWorkBindings · types](https://developers.dagio.ai/fr/reference/types-surface-composition-work-bindings/)

## Utilisation avec l’AI

Chaque page possède une version Markdown et un bouton Copier. Le fichier [/llms.txt](/llms.txt) répertorie les pages et leurs adresses. Fournissez à l’AI les sections concernées par votre changement, puis faites valider le Model complet avant publication.

<!-- surface-examples:start -->

## Exemples appliqués : Lire un profil et une vue complets

Comparez les propriétés aux contrats référencés avant d’insérer chaque fragment dans le Model.

### Configuration

Fragment à placer dans `presentation.recordProfiles[]`. [Propriétés et valeurs admises](https://developers.dagio.ai/fr/reference/workspace-record-profile/).

```json
{
  "key": "client",
  "definitionPaths": [
    "workspace/clients/surface/client"
  ],
  "editActionKey": "edit-client",
  "identity": {
    "title": {
      "kind": "field",
      "fieldPath": "fields/company"
    },
    "avatar": {
      "kind": "initials",
      "maximumLetters": 2
    },
    "subtitle": {
      "kind": "field",
      "fieldPath": "fields/status"
    }
  },
  "valueLabels": [
    {
      "fieldPath": "fields/status",
      "values": [
        {
          "value": "prospect",
          "label": "Prospect"
        },
        {
          "value": "active",
          "label": "Actif"
        }
      ]
    }
  ],
  "card": {
    "summary": {
      "kind": "field",
      "fieldPath": "fields/notes"
    },
    "tags": {
      "namespace": "user",
      "maximumVisible": 3
    },
    "metricKeys": [],
    "openLabel": "Ouvrir le client"
  },
  "queryBindings": [],
  "metrics": [],
  "detail": {
    "primaryActionKey": null,
    "creationActionKeys": [],
    "actionKeys": [],
    "sections": [
      {
        "kind": "fields",
        "key": "follow-up",
        "label": "Suivi du client",
        "fieldPaths": [
          "fields/notes",
          "fields/status"
        ]
      }
    ],
    "settings": {
      "fieldPaths": [
        "fields/email"
      ]
    },
    "tags": {
      "namespace": "user",
      "maximumVisible": 3
    },
    "relatedGroups": [],
    "primaryActionLabel": null
  }
}
```

### Variante et raccordement

Fragment à placer dans `presentation.tableViews[]`. [Propriétés et valeurs admises](https://developers.dagio.ai/fr/reference/workspace-record-presentation/).

```json
{
  "viewKey": "quotes-table",
  "columns": [
    {
      "key": "number",
      "label": "Numéro",
      "source": {
        "kind": "native",
        "property": "title"
      }
    },
    {
      "key": "status",
      "label": "État",
      "source": {
        "kind": "field",
        "fieldPath": "fields/status"
      }
    },
    {
      "key": "amount",
      "label": "Montant",
      "source": {
        "kind": "field",
        "fieldPath": "fields/amount"
      }
    }
  ],
  "openLabel": "Ouvrir la soumission"
}
```

### 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. Propriété
2. Valeur
3. Référence
4. Validation

<!-- surface-examples:end -->