Objets
Les objets personnalisés sont la pierre angulaire de votre configuration. Ils représentent les types de données que vous manipulez au quotidien : clients, factures, projets, commandes, devis...
Qu'est-ce qu'un objet ?
Un objet personnalisé représente un type d'entité métier dans Miel. Pensez-y comme un modèle : il décrit la structure d'une catégorie de données.
Par exemple, si vous créez un objet Facture, chaque facture que vous enregistrez sera une instance de cet objet, avec ses propres valeurs (numéro, montant, client...).
Analogie
Si vous êtes familier avec les tableurs, un objet équivaut à un onglet de votre feuille de calcul. Ses champs sont les colonnes, et chaque instance est une ligne.
Caractéristiques d'un objet
Chaque objet personnalisé dispose des propriétés suivantes :
| Caractéristique | Description |
|---|---|
| « Type technique » | Identifiant unique, commençant par une minuscule (ex : customer, clientInvoice) |
| « Nom affiché » | Nom visible dans l'interface (ex : "Facture", "Client") |
| « Champ discriminant » | Champ qui identifie une fiche de manière unique (ex : le numéro de facture) |
| « Champs de recherche » | Champs interrogés lors d'une recherche textuelle dans les listes |
| « Libellé de création » | Texte du bouton de création (ex : "Nouvelle facture") |
| « Espaces » | Le ou les espaces de l'organisation dans lesquels l'objet est disponible |
| « Objet exportable » | Autorise l'export des fiches de cet objet en PDF |
Fiche, formulaire et traits
La fiche qui s'ouvre sur un objet et son formulaire de création ne se règlent pas dans cette fenêtre : ils ont chacun leur écran, Fiche objet et Formulaire objet, décrits dans la pageFiche, formulaire et tableaux de bord.
De même, les traits qu'un objet porte, ces ensembles de champs dont une fonctionnalité de Miel a besoin, s'assignent dans l'écran Traits(voir Traits).
Créer un objet
Pour créer un nouvel objet, ouvrez l'écran Objets de la Configuration, puis cliquez sur « Créer un objet ». Vous devrez renseigner les informations suivantes :
« Type technique »
L'identifiant technique de votre objet. Il doit :
- Contenir au minimum 2 caractères
- Commencer par une lettre minuscule
- Ne contenir que des lettres et des chiffres (pas d'espaces ni de caractères spéciaux)
Exemple : invoice, customer, project
« Nom affiché »
Le nom visible dans l'interface. Minimum 2 caractères.
Exemple : "Facture", "Client", "Bon de commande"
« Libellé de création »
Le texte qui apparaît sur le bouton de création. Minimum 2 caractères.
Exemple : "Nouvelle facture", "Nouveau client"
« Espaces »
Dans la section « Disponibilité », sélectionnez un ou plusieurs espaces de votre organisation : l'objet n'apparaît que dans ceux-là (voir Espaces et navigation).
« Objet exportable »
Optionnel, désactivé par défaut. Activez cette option si vous souhaitez pouvoir générer des PDF à partir des fiches de cet objet.
Bon à savoir
Le type technique d'un objet ne peut plus être modifié après sa création. Choisissez-le avec soin. Le nom affiché et les autres propriétés, en revanche, peuvent être modifiés à tout moment.
Le discriminant
Le « Champ discriminant » est le champ qui identifie une fiche de manière unique. C'est la valeur que les utilisateurs verront en premier pour distinguer un objet d'un autre.
Par exemple :
- Pour une Facture : le numéro de facture (
FAC-2024-001) - Pour un Client : le nom de l'entreprise
- Pour un Projet : le nom du projet
Conseil
Choisissez un discriminant qui est unique et facilement reconnaissable par vos utilisateurs. C'est ce champ qui apparaît dans les listes, les recherches et les références vers cet objet.
Champs de recherche
Les champs de recherche définissent quels champs sont utilisés lorsqu'un utilisateur effectue une recherche textuelle dans une liste d'objets.
Par exemple, pour un objet Client, vous pourriez inclure dans les champs de recherche : le nom de l'entreprise, le numéro SIRET et l'email de contact. Ainsi, l'utilisateur retrouvera un client en tapant n'importe laquelle de ces informations.
Bon à savoir
Dans la section « Identification et recherche » de la fenêtre, le champ discriminant et les champs de recherche ne se choisissent qu'une fois l'objet créé et ses champs définis.
Tableau récapitulatif
La vue d'ensemble des objets affiche un tableau récapitulatif de tous vos objets configurés. Pour chaque objet, vous pouvez consulter :
| Colonne | Contenu |
|---|---|
| Nom de l'objet | Nom affiché et type technique |
| Espaces | Espaces dans lesquels l'objet est disponible |
| Propriétés | Nombre de champs configurés |
| Statuts | Nombre de statuts dans le flux |
| Automatisations | Nombre d'automatisations d'objet |
| Exports | Nombre de modèles d'export PDF |
| Étiquettes | Étiquettes portées par l'objet |
| Tableaux de bord | Présence d'un dashboard Objet, Form, ou Aucun |
| Actions | Menu d'actions de la ligne (modifier, supprimer) |
Depuis ce tableau, vous pouvez créer de nouveaux objets, ou modifier et supprimer (« Suppression définitive ») des objets existants via le menu d'actions de chaque ligne.
Prochaine étape
Maintenant que vous savez créer des objets, il est temps de leur donner de la substance en ajoutant des champs.