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 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 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.

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.

{
  "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.

{
  "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

SurfaceClients / Atelier NordExemple

Workspaces et navigationOrganiser les destinations

Clients

01Clients · Data

Fiches et informations de référence

02Références · Knowledge

Tarifs, procédure et sources

03Préparation · Work

Étapes, décisions et résultats

04Soumissions · Product

Livrable durable et ses révisions