---
title: "Workspaces et navigation"
url: https://developers.dagio.ai/fr/workspaces/
---

# Workspaces et navigation

   
                                 
                                                                          
                  
             
         
   

## Spaces personnels hors applications

Le chevron à droite de chaque élément du fil d’Ariane permet de parcourir son contenu sans revenir
à la collection. La liste se charge à l’ouverture et propose **Load more** si nécessaire. Choisissez
un élément pour naviguer; Échap ou un clic extérieur ferme la liste. Les boutons des applications
actives se trouvent après **Commands** dans le bandeau compact, avant **Settings**.

**Communication** s'ajoute depuis **Portfolio → New application → Communication**. Cette application
optionnelle fournit l'annuaire, les invitations d'appel et les actions de partage dans Surface.
Sans installation active, ses boutons sont absents. Son menu **⋯ → Uninstall** la désactive;
**Organizations** et **Members** restent administrés dans **Settings**. Le chat AI est indépendant.
Une application système est fournie par Surface et n'ouvre pas de Model dans le Builder.

Les Spaces Data, Knowledge, Content et Worker peuvent être créés sans application. Chacun conserve
ses paramètres, son namespace et ses contenus versionnés dans le tenant connecté. Les Fields et
vues Data, les labels Knowledge/Content, les instructions et les Actions appartiennent à sa
configuration. L’interface de configuration du Builder partagé sera raccordée séparément; elle
n’est pas encore disponible pour les Spaces personnels. Les éditeurs de Surface, l’historique et
les contrôles d’accès restent partagés.

Dans **Data**, **Knowledges**, **Contents** ou **Workers**, ouvrez le menu **⋯** d'une carte.
**Archive** retire le Space des actifs; **Archived → ⋯ → Unarchive** permet de le rouvrir.
**Move to trash** demande confirmation. Dans **Trash**, choisissez **⋯ → Restore**; un Space déjà
archivé revient dans Archived. Ces opérations conservent contenus et historique. Les Spaces archivés
ou dans la corbeille ne peuvent pas être ouverts avant restauration. Ce menu ne propose aucun
effacement définitif.

## Choisir le layout d’une Surface

À la création d’une Surface, choisissez **Page**, **Slide** ou **Board** dans les cartes proposées.
Ce choix ne peut plus changer après création. Page grandit verticalement; Slide utilise des slides
à dimensions fixes; Board fournit une planche infinie libre. Les mêmes objets et conteneurs de
layout admis restent réutilisables.

Le rail compact de Board et Slide affiche les outils par icônes; **+** ouvre Checklist et les autres
outils. Les tooltips identifient les icônes. Le menu inférieur **Board** règle le fond; largeur et
hauteur ne sont disponibles qu’en Slide. **Slides** ouvre la sidebar droite avec les petites miniatures et les opérations de gestion. Glissez une miniature avant ou après une autre pour réordonner les slides; la slide active reste sélectionnée. Modifiez
**x** directement dans le compteur **x / y**, puis validez avec Entrée ou en quittant le champ. Page n’a pas de toolbar inférieure. La lecture
masque les toolbars du Canvas; **History** se trouve dans le menu **⋯** de la Surface.

Page ouvre un document blanc continu. Son rail contient **Rich text**, **Table**, **Board**,
**Kanban**, **Calendar**, **Timeline**, **Gantt** et **Layout**. Les blocs s'empilent à la largeur
de leur parent. Layout propose **2 columns**, **3 columns** et **Main + right column**. Board permet
le placement libre dans un bloc distinct; son handle inférieur règle sa hauteur.

L'en-tête Page propose **View**, **Edit** et **Layout**. View affiche le contenu sans bordures ni
outils d'édition. Edit montre les toolbars des composants sans bordure de bloc et permet d'écrire sans déplacer la pile. Layout permet
d'insérer et déplacer les mêmes composants en aperçu réduit, avec leurs bordures grises. View/Edit
utilisent toute la largeur disponible et la hauteur naturelle du contenu. Un Board propose une seule
poignée de hauteur en bas; les Documents et vues Data grandissent automatiquement. Les actions de
Surface sont au-dessus du sélecteur de modes et les tags suivent le dernier bloc. La saisie en cours est
préparée avant de changer de mode. Un record Data conserve son bouton de sauvegarde habituel.

Chaque bloc Page possède un titre optionnel et des tags. Son menu propose l'ordre dans
la pile plutôt que l'alignement libre. Rich text ouvre l'éditeur Document complet et sa toolbar.
Un Board actif dispose de ses outils contextuels dans la Page.

Une vue Data sans source ouvre ses contrôles existants de choix du Data Space et de mapping des
Fields. Les vues configurées conservent leur source et les contrôles partagés de filtre, tri et
regroupement. Le bloc conserve sa Query; les records restent dans leur Space source avec ses droits.
Les [Data Views enregistrées](https://developers.dagio.ai/fr/queries/#data-sources-data-views-et-layouts) se gèrent séparément
depuis les actions de collection; leur binding aux blocs Surface reste à raccorder. L'export des
vues Data intégrées reste indisponible tant que leur projection complète n'est pas prise en charge.

Dans **Portfolio**, utilisez le menu **⋯** d’une application. Une application privée propose
**Archive** et **Move to trash**, avec **Unarchive** et **Restore** dans les onglets correspondants.
Une application installée propose **Update** et **Uninstall**. Une mise à jour prépare un draft dans
le Builder à revoir avant publication; elle ne remplace pas silencieusement l’application active.
La désinstallation concerne l’instance sélectionnée et conserve ses données et son historique.
L’onglet **Marketplace** ouvre le catalogue partagé des applications acceptées.

## Paramètres partagés

Ouvrez **Settings** à côté de Commands, ou utilisez **Ctrl+,**. **Surface** contient **Profile**,
**Plan** et **Graph**. Profile et Plan affichent votre compte et votre abonnement actuels; le menu
de l'avatar y donne aussi accès. Les préférences Graph sont enregistrées automatiquement dans votre
compte et rechargées sur vos autres appareils à l'ouverture de Surface ou au retour sur sa fenêtre.
Un conflit reste visible; **Reload saved settings** recharge les valeurs du serveur. **Applications** regroupe les pages
déclarées par vos applications actives, privées ou installées, même lorsqu'une autre application est ouverte. Une
application sans page déclarée n'ajoute pas d'entrée vide. **More applications** charge la suite.

La fenêtre partagée **Upgrade plan** est accessible depuis le menu du compte et **Settings → Plan**.
**Continue to account** ouvre le site de compte configuré; ouvrir cette fenêtre ne modifie ni
l'abonnement ni les permissions.

Le rail Workspace à gauche possède sa propre icône de réglages. Elle ouvre **Workspace → Settings**
pour renommer le Workspace sélectionné et choisir son icône dans la bibliothèque Surface ou importer
une image privée PNG, JPEG, GIF ou WebP de 5 Mo maximum. **Use initial** restaure sa première lettre.
L'icône enregistrée apparaît dans le rail. Les préférences du compte et de l'appareil restent dans
les Settings globaux. En Free, **Add Workspace** explique la limite d'un Workspace et ouvre la
fenêtre Upgrade partagée. Ces réglages ne déplacent pas les applications ou Spaces entre Workspaces.

**Workspace → Members** affiche les noms, adresses e-mail, offres de compte, rôles et statuts.

Avec le cache activé, les Workspaces, leurs membres et leurs icônes déjà chargés s’affichent depuis
le cache de votre compte sur cet appareil, puis s’actualisent en arrière-plan. Les modifications
restent soumises aux droits courants vérifiés par le serveur.
Filtrez la liste ou triez-la depuis ses en-têtes. Le menu près du nom permet de modifier le nom
d’affichage dans ce Workspace, changer le rôle ou retirer l’accès. Les rôles sont **Guest** (lecture
seule), **Member** (collaboration) et **Owner** (administration). Plusieurs Owners sont possibles;
le dernier ne peut pas être retiré ou rétrogradé : **Change role** et **Remove from Workspace**
sont désactivés pour cet Owner. Free et Plus invitent des Guests; les rôles Member
et Owner exigent Teams ou supérieur sur les comptes concernés. Le choix d’un rôle indisponible ouvre Upgrade.

Le nom complet et l’adresse e-mail appartiennent au compte et restent désactivés dans le profil
du membre. **Display Name (optional)** est un alias du Workspace; s’il est vide, les libellés du
Workspace utilisent le nom complet.

**Invite member → E-mail** propose une invitation nominative Guest ou Member. **Invitation link**
crée un lien Guest réutilisable, avec un bouton Copy et sans adresse e-mail. Les invitations expirent
après sept jours et peuvent être révoquées. Un Workspace dispose de cinq places Guest, en comptant
les invitations nominatives en attente; un lien vérifie la capacité à chaque acceptation. Le retrait
déclenche un courriel; si l’envoi échoue, **Retry notification** permet de le réessayer. Ces rôles ne
modifient pas les abonnements et ne partagent pas automatiquement des applications ou Spaces.

Fermer Settings ou changer de page avec des modifications non enregistrées ouvre **Discard changes**.
Cancel conserve le brouillon; Discard changes rétablit les valeurs enregistrées avant de quitter.
Une sauvegarde en cours doit d’abord se terminer.

Les pages d'application utilisent **Save changes** et conservent leurs valeurs dans cette instance.
Enregistrez ou abandonnez les changements avant de changer de page ou de fermer Settings. Ces valeurs
ne modifient pas la définition publiée. Commands peut aussi ouvrir directement une page découverte.

## Composer votre environnement

Un Workspace applique un Model à un domaine de travail. Vous pouvez installer Clients puis ajouter Soumissions lorsqu’un nouveau besoin apparaît. Les deux apps conservent leurs vues et leurs données; leur relation se configure après installation.

Dans **Marketplace**, **Installer l'application** installe la version publiée exacte dans votre profil. Aucun nom de Workspace n'est demandé; aucun Workspace, Space ou contenu d'instance n'est créé. **Nouveau Workspace** est une action distincte pour créer une instance à partir d'une application installée.

Vous pouvez quitter le Marketplace ou fermer une fiche d’application en cours de chargement; cela
n’active pas l’application et ne crée aucun Workspace.

Dans le champ **Commands** de la topbar, saisissez **Marketplace**, puis choisissez **Open Marketplace**.
Vous pouvez saisir directement dans le champ ou y accéder avec **Ctrl+P**. Les paramètres et l'avatar
du compte restent à sa droite; l'avatar ouvre votre identité connectée et **Sign out**.

Les commandes suivent votre contexte : le Space ouvert, sa vue et votre sélection. Une ligne
sélectionnée peut proposer d'autres opérations qu'un document ouvert. Les commandes indisponibles
indiquent pourquoi elles ne peuvent pas s'exécuter. Lorsque Builder est ouvert, Commands propose
ses opérations; sa fermeture rétablit celles de la vue courante. Une commande utilise la même
opération et les mêmes confirmations que son bouton.

**Applications**
et **Flows** séparent la découverte. **Gérer** affiche les éléments installés dans le profil courant
dans un tableau : nom, description, éditeur, version et état. La version installée peut différer de
la dernière publication; le tableau liste les définitions, pas les instances de Workspace.

Dans **Gérer**, ouvrez le menu **⋯** de l'application et choisissez **Désinstaller**. La confirmation désactive les nouvelles créations; les Workspaces existants et leurs données sont conservés. La liste active est actualisée après confirmation. Seul un propriétaire autorisé du profil peut retirer une application non système.

**Installer l'application** active uniquement l'application dans votre profil et actualise son état d'installation;
un Flow conserve son choix explicite. Les Models système gardent leur rôle de plateforme, sans
commande de création applicative. Consultez la publication et ses prérequis : une fiche de catalogue
ne donne aucun accès aux données d'un autre utilisateur.

L’activation d’une version dans le compte exige un propriétaire de ce compte. Si votre accès
permet de créer un Workspace mais pas d’activer l’application, demandez à ce propriétaire de
l’activer. Consulter sa fiche n’élargit pas vos droits.

Si la définition ne peut pas être chargée, **Réessayer** reprend sa lecture exacte. Lorsque
l’activation est déjà confirmée mais que son actualisation échoue, cette reprise relit la
définition sans répéter l’activation. Avant d’envoyer la confirmation de création, **Modifier mes
choix** permet de revenir au nom et aux contenus conservés; un nouvel examen est ensuite nécessaire.
Cette modification n’est plus proposée pour une création envoyée dont le résultat reste inconnu.

Après une création confirmée, Surface termine l’ouverture du Workspace et l’actualisation du compte.
Si cette étape échoue, **Ouvrir le Workspace** reprend cette ouverture sans créer une seconde
instance. Attendez la fin d’une ouverture en cours avant de reprendre une autre action.

Si le Marketplace ou le sélecteur d’application ne peut pas charger le catalogue, **Réessayer**
reprend la même recherche et la page demandée. Cette lecture n’active aucun Model et ne crée aucun
Workspace. Un catalogue indisponible n’est pas un catalogue vide.

Pour préparer les connaissances d’un Flow dans une nouvelle application, choisissez explicitement
une définition de Flow activée et un nouveau Space Work compatible proposé par cette application.
Surface propose les références Knowledge actuelles du Flow : sélectionnez celles à conserver, ou
n’en retenez aucune explicitement. Examinez la destination, les versions des sources et la
confirmation avant de créer le Workspace. Ce sont des liens de référence, pas des copies des notes
ni de nouveaux droits d’accès. Un Space existant réutilisé n’est pas modifié implicitement, et les
changements ultérieurs des références du Flow ne réécrivent pas cette sélection confirmée.

Dans **Réglages → Models**, l’installation d’un Model publié le rend disponible dans le compte avec son guide. Elle ne crée pas un Workspace et ne met pas à jour ceux qui existent déjà. Si Surface vous propose plusieurs comptes, choisissez d’abord celui dans lequel travailler; ses rôles et ses accès continuent de s’appliquer.

| Réglage    | Valeurs attendues                                  | Description                             |
| ---------- | -------------------------------------------------- | --------------------------------------- |
| Nom        | Libellé lisible, par exemple Clients               | Nom présenté dans la navigation         |
| Portfolio  | Un Portfolio auquel vous avez accès                | Contexte commun aux Workspaces          |
| Model      | Définition choisie dans le catalogue ou vos Models | Structure initiale de l’app             |
| Accès      | Membres et rôles autorisés                         | Personnes pouvant consulter ou modifier |
| Navigation | Destinations déclarées par le Model                | Accueil, listes, travail et contenus    |

## Retrouver un objet

L’accueil présente les points d’entrée utiles : ouvrir une collection, créer un objet ou reprendre un travail. La navigation d’un Workspace suit son vocabulaire métier. Dans Clients, **Clients actifs** ouvre une collection; choisir Atelier Nord ouvre sa fiche; **Préparer une proposition** ouvre le travail associé.

Les cartes de démarrage portent le nom et la description de leur Action. Choisir une carte ouvre
sa préparation; cela ne confirme pas automatiquement son exécution. Une carte sans accès à cette
préparation reste consultable, sans commande de lancement.

Le fil de navigation conserve le contexte pour revenir à la collection. Ouvrir une soumission liée change d’objet sans transformer la fiche client en une copie de la soumission.

Si une saisie ou un commentaire empêche de fermer une fiche ouverte depuis un tableau, Surface
conserve le panneau et son travail. Terminez ou corrigez cette saisie avant de réessayer la
fermeture; celle-ci ne sauvegarde pas automatiquement le contenu et ne renvoie pas un commentaire.

Lorsque vous ouvrez une ligne d'une liste dans une fiche, le retour porte le nom de cette fiche
parente. Par exemple, ouvrez une catégorie Knowledge, choisissez une entrée, puis revenez à la
même catégorie. Surface relit ses contenus actuellement accessibles avec votre recherche et vos
filtres soumis; enregistrer l'entrée ne vous impose pas de repartir de l'index des catégories.
Si l'accès change, le retour indique que la destination est indisponible au lieu de réafficher
une ancienne copie.

Le **Portfolio** réunit vos Workspaces applicatifs. L'accès secondaire **Mes contenus**, au pied de la navigation sur les écrans larges, ouvre les Spaces auxquels vous avez accès : rattachés à une app, partagés ou sans Workspace lié visible. Vous pouvez ouvrir un Space ou retrouver les Workspaces visibles qui l'utilisent; ce n'est ni une liste générale de documents, ni un second Portfolio. Un lien absent ne révèle rien sur les Workspaces auxquels vous n'avez pas accès. Ces deux entrées conservent les mêmes titres métier et droits.

## Adapter un Workspace

Les commandes produit Surface utilisent la langue anglaise ou française prise en charge choisie par votre hôte. Si aucune langue prise en charge n’est fournie, le défaut produit est le français. Les libellés métier du Model, vos contenus et les valeurs enregistrées restent inchangés; changer la langue de l’interface ne les traduit pas et ne modifie pas les droits d’accès.

Les valeurs de vos fiches se modifient dans l’app. La configuration de l’app se modifie dans le Studio : Fields, vues, Actions et intégrations. Examinez les effets d’un changement de structure sur les données existantes avant de l’activer. Le [guide des migrations](https://developers.dagio.ai/fr/migrations/) explique cette étape.

Exemple : installer Soumissions ne vous impose pas de recréer Clients. Vous ajoutez le lien **Soumission → Client**, puis utilisez le panneau de relations des fiches existantes.

## Archiver et reprendre un Workspace

Avant de confirmer un archivage, examinez ses conséquences : accès conservés aux contenus et
automatisations suspendues. Les contenus et leur historique restent conservés. Une nouvelle revue
demande une nouvelle confirmation; changer la langue ne modifie pas votre choix.

Si le résultat d'une confirmation reste inconnu, utilisez **Vérifier le résultat** pour reprendre
la même demande, sans créer un doublon. Lorsque Surface indique que le changement est enregistré
mais que le retour aux Workspaces échoue, réessayez ce retour : il ne répète pas l'archivage. Les
Workspaces archivés accessibles proposent séparément l'examen d'une restauration ou d'une
suppression et la gestion de leurs accès.

## Extensions d’application

Une application peut inclure des extensions approuvées pour proposer des vues Data spécialisées,
des boutons exécutables et des formulaires de fiche dans la barre latérale droite. Leur configuration
apparaît sous cette application dans Settings. Un bouton et une demande AI utilisent la même commande
déclarée et les mêmes contrôles d’accès. Les commandes soumises à une revue humaine conservent leur
confirmation. Les commandes automatiques admissibles suivent une fréquence configurée sans laisser
l’application ouverte.

Les extensions conservent fiches, liens et tags dans Surface et complètent Actions, Chat Views et
Workmaps. Le courriel ou un autre service externe nécessite un module prenant en charge ce fournisseur;
ajouter une extension ne connecte pas automatiquement un compte.

### Application Emails

La capacité Email est distribuée comme extension. Sa version exacte doit être installée ou
déclarée comme dépendance du Model Emails; l’installation d’un Model publié installe cette
dépendance par le Marketplace. L’application Emails conserve messages et brouillons dans son Space Data. Mailbox ajoute un aperçu
sous chaque ligne, une lecture à droite ou en bas, et la rédaction/réponse/transfert à droite. La vue
Table conserve ses filtres habituels, dont le compte courriel. Dans Settings → Mail accounts, ajoutez
vos comptes IMAP/SMTP, configurez chaque expéditeur et choisissez le compte par défaut. Testez les
connexions enregistrées puis lancez Sync. Une réponse utilise le compte destinataire; le compositeur
permet de choisir un autre expéditeur. Désactiver un compte conserve ses messages. La synchronisation
périodique admissible parcourt les comptes actifs sans garder l’application ouverte et rapporte les
échecs séparément pour chaque compte.

Send présente les destinataires, le contenu et les pièces jointes avant confirmation humaine. Un
résultat SMTP incertain reste à examiner et ne provoque pas de nouvel envoi automatique. Cette
première application utilise des brouillons texte et des pièces jointes ; classement et service
d’adresses hébergées sont distincts. La connexion à une vraie boîte reste nécessaire pour recevoir
ou envoyer vos courriels.

## Publication Marketplace et validation

Le Marketplace public se consulte sans compte sur la page `/marketplace` du host Surface.
Connectez-vous pour installer une application acceptée, puis créez séparément son instance
indépendante. Free, Plus et Teams utilisent le catalogue public. Pro ajoute un catalogue privé
personnel; Business ajoute celui d’une organisation, accessible à ses membres actifs et publiable
par ses owners/admins.

Explorez les applications dans **Portfolio → Marketplace → Discover**, puis ouvrez une fiche pour
consulter **Overview**, **What’s included** et **Details**. Le breadcrumb et le retour de la topbar
ramènent au catalogue. La fiche présente la structure publiée et la licence; **Install application**
et **Create application** sont des actions distinctes. La progression et les corrections demandées se
consultent dans **My publications**. Les rapports techniques ne sont pas affichés dans l’interface
applicative.

Dans le Builder, choisissez **Publish Model to catalogue**, sélectionnez le Marketplace, indiquez
titre, version, description et licence, puis **Submit for validation**. Publiez des définitions que
vous avez le droit de distribuer; records, documents privés, identifiants et accès d’instance sont
exclus. La version exacte reste **Under review** pendant les contrôles du Model et les revues IBM
Granite : confidentialité, sécurité, permissions/dépendances et cohérence fonctionnelle. Cette
revue sémantique ne prouve pas qu’une intégration externe ou un parcours utilisateur a été exécuté.

Dans **Marketplace presentation**, renseignez le nom d’éditeur affiché, choisissez une catégorie et
une icône Surface, puis rédigez la présentation. Vous pouvez ajouter jusqu’à six liens de captures
publiques HTTPS avec leur légende. Publiez uniquement des images que vous avez le droit de distribuer,
sans records privés ni données personnelles. Ces informations sont revues avec l’application et
appartiennent à sa version exacte. Le nom d’éditeur fourni est un libellé d’affichage, pas un badge de
marque vérifiée. Les lecteurs filtrent le catalogue par catégorie et consultent cette présentation
sur la fiche applicative.

**Portfolio → Marketplace → My publications** présente la progression et les motifs. Une version
acceptée devient visible et installable. Un rejet exige une nouvelle version corrigée. Une revue
bloquée techniquement peut être relancée explicitement; une AI indisponible n’accepte rien par
défaut. Le retrait supprime découverte et nouvelles installations, tout en conservant les instances
existantes et leur historique. La validation locale d’un build reste distincte du déploiement distant.

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

## Exemples appliqués : Organiser les destinations

Choisissez la collection Clients dans la navigation et proposez les prochaines actions dans l’accueil.

### Configuration

Fragment à placer dans `composition.navigation[]`. [Propriétés et valeurs admises](https://developers.dagio.ai/fr/reference/workspace-model-foundation/).

```json
{
  "key": "clients",
  "label": "Clients",
  "icon": "users",
  "kind": "collection",
  "spaceKey": "clients",
  "definitionPaths": [
    "workspace/clients/surface/client"
  ],
  "queryKey": "clients",
  "formKey": null
}
```

### Variante et raccordement

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

```json
{
  "contract": "WorkspaceHomePresentation@1",
  "header": {
    "intro": "Clients et soumissions",
    "primaryNavigation": {
      "destinationKey": "clients",
      "label": "Ouvrir les clients"
    }
  },
  "launchers": {
    "title": "Faire avancer le travail",
    "description": "Choisissez une action",
    "icons": [
      {
        "actionKey": "create-client",
        "icon": "users"
      },
      {
        "actionKey": "prepare-quote",
        "icon": "document"
      }
    ]
  },
  "blocks": [
    {
      "kind": "section",
      "sectionKey": "recent-quotes",
      "variant": "collection",
      "placement": "main",
      "maximumVisible": 4,
      "viewAll": {
        "destinationKey": "quotes",
        "label": "Toutes les soumissions"
      }
    }
  ]
}
```

### 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. Clients · Data
2. Références · Knowledge
3. Préparation · Work
4. Soumissions · Product

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