Objets personnalisés
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 | Identifiant technique unique (ex : customer, invoice) |
| Nom | Nom d'affichage de l'objet (ex : "Facture", "Client") |
| Discriminant | Champ servant d'identifiant principal (ex : le numéro de facture) |
| Champs de recherche | Champs utilisés pour la recherche textuelle dans les listes |
| Libellé de création | Texte du bouton "Créer un nouveau..." (ex : "Nouvelle facture") |
| Module | Module auquel appartient l'objet (Système ou Projet) |
| Exportable | Indique si l'objet peut être exporté en PDF |
| Dashboard de détail | Tableau de bord affiché sur la page de détail de l'objet |
| Dashboard de formulaire | Tableau de bord affiché dans le formulaire de création/édition |
Créer un objet
Pour créer un nouvel objet, rendez-vous dans le module de Configuration, puis cliquez sur "Créer un objet". Vous devrez renseigner les informations suivantes :
Type
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
Le nom affiché 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"
Module
Le module auquel rattacher l'objet : Système (objets globaux) ou Projet (objets liés à un projet).
Exportable
Optionnel, désactivé par défaut. Activez cette option si vous souhaitez pouvoir générer des PDF à partir de cet objet.
Bon à savoir
Le type d'un objet ne peut plus être modifié après sa création. Choisissez-le avec soin. Le nom et les autres propriétés, en revanche, peuvent être modifiés à tout moment.
Le discriminant
Le discriminant est le champ qui sert d'identifiant principal pour les instances de votre objet. 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
Vous pouvez configurer le discriminant et les champs de recherche une fois que l'objet a été créé et que ses champs ont été 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 et type technique |
| Module | Module d'appartenance |
| Propriétés | Nombre de champs configurés |
| Statuts | Nombre de statuts dans le flux |
| Règles métiers | Nombre de règles d'automatisation |
| Exports | Nombre de modèles d'export PDF |
| Tableaux de bord | Présence d'un dashboard Objet, Formulaire, ou Aucun |
Depuis ce tableau, vous pouvez créer de nouveaux objets, ou modifier et supprimer des objets existants via le menu déroulant 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.