Vue d’ensemble
Qwoty applique des contraintes d’unicité sur certains champs afin d’éviter les enregistrements en double et de garantir l’intégrité des données. Comprendre ces contraintes est essentiel pour réussir vos importations — en particulier lorsque vous souhaitez mettre à jour des enregistrements existants plutôt qu’en créer de nouveaux.Champs uniques par défaut
Le champ
product_id, id (selon l’objet) est l’identifiant interne de Qwoty, généré automatiquement pour chaque enregistrement. Il utilise le format UUID (par exemple, c776ee49-f608-4a77-8cc8-6fe96ae1e43f).
Les champs *_api_name sont des identifiants stables et lisibles par l’humain que vous contrôlez. Ils sont utiles lors de migrations entre environnements ou lorsque vous souhaitez une référence permanente qui survive aux réinitialisations de données.
Champs uniques personnalisés
Pour les objets gérables comme Client et Modèle de contrat, vous pouvez définir des champs uniques supplémentaires sous Paramètres → Données → Modèle de données :1
Ouvrir l'objet
Accédez à Paramètres → Données → Modèle de données et cliquez sur l’objet gérable.
2
Ouvrir le champ
Cliquez sur le champ que vous souhaitez rendre unique.
3
Marquer comme unique
Activez le bouton Unique dans les paramètres du champ.
Cas d’usage pour les champs uniques personnalisés
- Identifiants externes — stocker les identifiants provenant d’autres systèmes (ID Salesforce, ID HubSpot, code client ERP)
- Identifiants métier — numéros d’employé, codes client, références produit internes
- Informations de contact alternatives — numéros de TVA, numéros d’enregistrement
Le nom de champ
id est réservé à l’UUID interne de Qwoty. Utilisez un nom différent comme external_id, legacy_id ou erp_id pour les identifiants provenant d’autres systèmes.Comportement lors de l’importation
Création de nouveaux enregistrements
Si la valeur d’un champ unique n’existe pas dans Qwoty, un nouvel enregistrement est créé. Laissez la colonne ID vide dans votre CSV — Qwoty génère automatiquement un nouvel UUID.Mise à jour des enregistrements existants
Si la valeur d’un champ unique correspond à un enregistrement existant, cet enregistrement est mis à jour avec les nouvelles données. Seules les colonnes présentes dans votre CSV sont modifiées — les autres champs restent inchangés.Détection des doublons lors de l’importation
Lors de l’étape Confirmer, Qwoty valide votre fichier :- Les doublons présents dans votre fichier sont signalés comme erreurs de validation
- Les enregistrements dont les valeurs uniques entrent en conflit avec des enregistrements Qwoty existants sont signalés
- Vous pouvez revenir à l’étape de Mappage ou corriger votre CSV source avant de continuer
Bonnes pratiques
- Supprimez les doublons de votre fichier avant d’importer — triez par le champ unique dans votre tableur pour les repérer rapidement
- Vérifiez les enregistrements existants en exportant d’abord, en comparant avec votre fichier, puis en choisissant de mettre à jour ou de créer
- Utilisez des identifiants externes lors de migrations depuis d’autres systèmes — ils simplifient les importations aller-retour
- Incluez la colonne ID lorsque vous souhaitez mettre à jour des enregistrements existants, et laissez-la vide lorsque vous souhaitez en créer de nouveaux
Voir aussi
Mappage des champs
Comment les champs sont mis en correspondance entre votre CSV et Qwoty.
Relations d'importation
Comment lier des enregistrements à leurs parents lors de l’importation.
Modèle de données
Ajouter des champs personnalisés et les marquer comme uniques.
Gestion des erreurs
Ce que signifient les erreurs de validation et comment les corriger.