Démarrage rapide

Créer votre compte

Ouvrez le portail de compte Surface, indiquez votre nom, votre adresse courriel et un mot de passe d’au moins 12 caractères, puis confirmez votre adresse avec le lien reçu par courriel. Connectez-vous ensuite pour vérifier que votre espace est prêt. Le compte commence avec le forfait Free, sans carte de paiement. La clé technique de votre tenant reste interne aux services Surface; vous n’avez aucune clé à copier ou à configurer.

1. Créer votre espace de travail

Connectez-vous à Surface et choisissez le compte à ouvrir, même si un seul compte est proposé. Créez ensuite un Workspace à partir d’un Model. Sélectionnez une app de gestion de clients ou décrivez votre besoin à l’AI : « Je veux suivre mes clients, leurs coordonnées et les prochaines actions commerciales. » Examinez la structure proposée avant de l’utiliser.

Lorsque l’entrée Décrire un besoin avec l’AI est proposée par votre interface, choisissez si vous voulez trouver une app, adapter un Model autorisé ou en créer un. Précisez votre objectif et le résultat attendu. Cette demande ouvre la conversation, sans sélectionner de version ni créer de Workspace. Vérifiez les choix et les conséquences dans la revue native avant de confirmer une création ou un lancement.

Comparez les versions exactes, les entrées, les livrables et les conditions d’accès des choix disponibles. Une inspection de déclaration ou une preview n’est pas un Flow exécuté; après modification de la proposition, relisez une nouvelle preview avant de confirmer.

Nommez le Workspace Clients et rattachez-le au Portfolio de votre entreprise. Le Portfolio rassemble vos Workspaces et leur contexte commun. À l’intérieur de Clients, le Space Data contient les fiches; un Space Knowledge accueille vos procédures et un Space Work les suivis qui demandent plusieurs étapes.

2. Ajouter votre premier client

Choisissez Nouveau client. Le formulaire de création demande les informations nécessaires pour créer une fiche valide. Les notes de contexte et les informations complémentaires restent accessibles dans la fiche après sa création.

Information	Valeur pour cet exemple	Utilisation
Entreprise	Atelier Nord	Titre de la fiche et résultat de recherche
Courriel	contact@example.com	Coordonnée du contact
État	Actif	Filtre et indicateur visuel
Notes	Besoin d’une proposition pour l’entretien annuel	Contexte éditable dans la Surface

Ouvrez la fiche créée. Modifiez les notes directement sous leur titre. Utilisez Paramètres pour les Fields destinés à la configuration plutôt qu’au contenu principal de la fiche.

3. Organiser la collection

Dans la vue tableau, affichez Entreprise, Courriel, État et Dernière mise à jour. Ajoutez le filtre État = Actif et choisissez le tri par entreprise. La Query définit la collection recherchée; les colonnes déterminent les informations que le tableau présente.

Clients
  Data → Clients actifs → Atelier Nord
  Knowledge → Procédure de qualification
  Work → Préparer le suivi d’Atelier Nord

4. Relier les soumissions

Ajoutez ensuite un Workspace Soumissions. Dans sa configuration d’intégration, liez le Field clientId à l’identifiant de la fiche Client. Une soumission peut maintenant sélectionner Atelier Nord avec une recherche. La fiche Atelier Nord présente les soumissions associées dans un panneau latéral.

Continuez avec les Fields pour adapter la fiche, les intégrations pour les liens et les Flows pour préparer une proposition avec l’AI.

Exemples appliqués : Créer le premier client

Reliez la Form de création à son Action, puis ouvrez la fiche Atelier Nord après confirmation.

Configuration

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

{
  "contract": "WorkspaceForm@2",
  "key": "new-client",
  "label": "Nouveau client",
  "actionKey": "create-client",
  "targetDefinitionPath": "workspace/clients/surface/client",
  "mode": "create",
  "fields": [
    {
      "contract": "WorkspaceFormControl@2",
      "repeatable": false,
      "key": "company",
      "label": "Entreprise",
      "input": "text",
      "binding": {
        "kind": "field",
        "fieldKey": "company"
      },
      "required": true,
      "ruleKeys": [],
      "options": []
    },
    {
      "contract": "WorkspaceFormControl@2",
      "repeatable": false,
      "key": "status",
      "label": "État",
      "input": "choice",
      "binding": {
        "kind": "field",
        "fieldKey": "status"
      },
      "required": true,
      "ruleKeys": [],
      "options": [
        "prospect",
        "active"
      ]
    }
  ],
  "ruleKeys": []
}

Variante et raccordement

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

{
  "key": "create-client",
  "label": "Créer un client",
  "targetDefinitionPaths": [],
  "kind": "semantic-command",
  "operationKey": "create-client",
  "formKey": "new-client",
  "ruleKeys": [],
  "contextPolicyKey": null,
  "minimumRole": "member",
  "confirmation": true
}

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. Entreprise *
2. État *
3. Notes
4. Créer le client

SurfaceClients / Atelier NordExemple

Démarrage rapideCréer le premier client

Clients

Nouveau client

Entreprise *Atelier Nord

État *Prospect ⌄

Les notes s’enrichissent dans la fiche après création.

AnnulerCréer le client