📥 Importer des Objets personnalisés dans Webmecanik Automation

L'import par fichier CSV est la méthode la plus efficace pour intégrer en masse des données métiers complexes (produits, commandes, contrats, parc matériel) sous la forme d'Éléments personnalisés. Chaque Objet personnalisé dispose de son propre bouton d'import au sein de sa liste d'éléments, ainsi que de son propre historique de traitement dédié, s'appuyant sur le moteur d'import natif de Webmecanik Automation.

📋 1. Préparer votre fichier CSV d'import

Pour importer des données sans erreur, structurez votre tableau sous forme de fichier CSV (encodé en UTF-8, avec virgule ou point-virgule comme délimiteur). Vous pouvez nommer vos en-têtes de colonnes librement, car l'association avec les champs Webmecanik s'effectue manuellement lors de l'étape de mappage.

Voici les différents types de colonnes que vous pouvez renseigner :

• Identifiant de l'élément (customItemId ou ID) : Renseignez cette colonne uniquement si vous souhaitez mettre à jour un élément existant. S'il correspond à un identifiant Webmecanik existant, les valeurs du fichier viendront fusionner avec la fiche actuelle. Si la cellule est vide ou si la colonne est absente, Webmecanik créera automatiquement un nouvel élément.

• Nom de l'élément (name ou Nom) : C'est le seul champ natif commun et obligatoire pour chaque Objet personnalisé. Il définit l'appellation principale de l'élément affichée dans l'interface.

• Champs personnalisés métiers : Insérez autant de colonnes que vous avez de champs personnalisés créés dans l'objet (par exemple SKU, product_id, date, catégorie, etc.).

• Liaison avec des contacts (linked_contact ou linkedContactIds) : Vous pouvez relier directement l'élément personnalisé à un ou plusieurs contacts existants en renseignant leur adresse e-mail ou leur identifiant de contact Webmecanik. Si vous renseignez plusieurs identifiants de contacts pour un même élément, séparez-les par des virgules et entourez l'ensemble de guillemets doubles (exemple : "5319, 2, 5").

• Liaison avec d'autres Objets personnalisés (linked_order) : Vous pouvez interconnecter des objets entre eux en indiquant l'identifiant d'un autre élément personnalisé (par exemple lier un produit à un numéro de commande).

📄 2. Structure type d'un fichier d'import

Vous pouvez télécharger et utiliser directement le modèle CSV joint en haut de cet article. Voici à quoi ressemble la structure des colonnes et des données attendues :

📏 3. Limites techniques et formats de données

Lors de la saisie de vos données, veillez à respecter les limites techniques des différents formats :

• Texte : Jusqu'à 4 294 977 295 octets (adapté aux descriptions détaillées et contenus longs).

• Option de sélection multiple : 255 octets maximum par option.

• Nombre entier (Int) : Valeurs autorisées comprises entre -2 147 483 648 et 2 147 483 647.

🔀 4. Lancer l'import et mapper les champs

Une fois votre fichier CSV prêt :

1. Dans le menu latéral gauche, déroulez Objets personnalisés et sélectionnez l'objet concerné (ex. Produits).

2. Cliquez sur la flèche située à droite du bouton Nouveau en haut à droite de l'écran, puis choisissez Importer.

3. Téléversez votre fichier CSV et confirmez les séparateurs de colonnes.

4. Sur la page de configuration du mappage, associez chaque colonne de votre fichier au champ Webmecanik correspondant.

⚠️ Validation obligatoire du formulaire de mapping :

L'écran de configuration vous empêchera de valider l'import tant que vous n'avez pas mappé au moins un champ personnalisé. De plus, tous les champs configurés comme obligatoires dans les paramètres de votre Objet personnalisé (par exemple le champ Nom et la référence SKU) doivent impérativement être associés à une colonne de votre CSV. Un message d'alerte rouge vous indiquera précisément les champs requis manquants si nécessaire.

🔍 5. Suivre l'historique et corriger les erreurs de saisie

Après validation du traitement, vous pouvez suivre son bon déroulement depuis l'historique d'import propre à cet objet :

• Contrôle de validité des champs : Si une ligne contient une donnée non conforme au type attendu (adresse e-mail invalide, numéro de téléphone erroné ou valeur inconnue pour une liste de sélection fermée), la ligne concernée est automatiquement ignorée par le système afin de préserver la qualité de votre base.

• Identification des rejets : Ouvrez le détail de l'import pour consulter le journal des événements. Chaque erreur y est détaillée avec le numéro de la ligne CSV concernée, ce qui vous permet de corriger le fichier d'origine et de réimporter uniquement les lignes rejetées.

Retrouvez ici un fichier type pour vous aider à créer votre import.