Data injection

Prérequis (auto-hébergé)

Installation du plugin

• Aller sur la marketplace. Télécharger et installer le plugin Data Injection

Gestion des droits

Une fois le plugin installé via la marketplace, vous pouvez configurer les droits selon le profil :

• Depuis Administration > Profils, sélectionner le profil concerné

• Aller sur Data injection

Pour chaque profil utilisateur, vous pouvez accorder les droits suivants :

• Gestion des modèles : Lecture / Mise à jour / Création / Suppression

• Fichier d'import : Lecture

Configuration

Vous retrouverez la configuration du plugin à l'adresse Outils > Data injection. L'extension se présente sous forme d'un assistant, chaque opération est décomposée en étapes et il est possible de revenir à l'étape précédente pour corriger un choix.

Gestion ou utilisation d'un modèle

La première étape permet de choisir l'opération qui sera effectuée, en fonction de vos droits.

• Utiliser un modèle existant dans le menu déroulant

• Gérer les modèles pour :

  • Créer un nouveau modèle

  • Modifier un modèle existant

  • Supprimer un modèle existant

  • Utiliser un modèle existant

Création d'un modèle

La première étape consiste à créer un modèle si aucun n'existe.

• Depuis Outils > Data injection

• Cliquer sur Modèle

• Cliquer sur Ajouter

Définition du modèle

Cette étape permet de définir les options principales de l'extension :

• Nom : le nom qui sera visible depuis la liste déroulante

• Visibilité : définit s'il sera visible ou non par les autres utilisateurs

• Entité et sous-entité : le modèle peut être visible dans l'entité de création uniquement (sous-entité mise sur non) ou dans l'entité et toutes les sous-entités (sous-entité mise sur oui).

• Commentaire : un commentaire pour le modèle.

• Type de données à importer : le type de données présentes dans le fichier à importer. Un fichier est composé uniquement de données du même type.

• Autoriser la création de lignes : indique au plugin de créer des objets si la ligne ne correspond pas à un élément existant dans la base de données.

• Autoriser la mise à jour des lignes : indique au plugin de modifier les objets existants à l'aide des données du fichier.

• Présence d'en-têtes : indique au plugin si les en-têtes présents dans le fichier (localisation, type d'équipement, modèles, etc.) doivent être créés. La création sera également limitée par les droits de l'utilisateur du modèle.

• Mise à jour des champs existants : l'extension si les données du fichier peuvent remplacer des champs déjà renseignés.

• Format de date : le format de date contenu dans le fichier CSV. Si le format est incorrect, la date ne pourra pas être importée.

• Format nombre décimal : le format utilisé pour les nombres dans le fichier CSV. Si le format est incorrect, les nombres ne pourront pas être importés.

Après validation du modèle, les champs suivants sont ajoutés :

• Présence d'un en-tête : indique si la première ligne du fichier CSV est une ligne d'en-tête, afin de pouvoir voir le contenu des colonnes pour identifier le contenu des colonnes

• Délimiteur de fichier : séparateur de champ (par défaut un point-virgule)

Fichier à injecter

• Depuis l'onglet Fichier à injecter, il faut choisir un fichier sur votre ordinateur ayant exactement la même structure que les données déjà importées.

• Définir ensuite l'encodage (ISO8859-1 pour les fichiers Windows, UTF-8 pour les fichiers Linux. La détection automatique peut être utilisée pour déterminer l'encodage, mais ralentira le traitement du fichier. Nous vous recommandons fortement de toujours travailler en UTF-8.)

Une fois le fichier validé, vous serez redirigé vers l'onglet Mappings.

Mappings

Cette étape est essentielle. Elle permet de définir, pour chaque colonne du fichier, le champ correspondant dans la base de données. Les colonnes sont identifiées par le contenu de la ligne d'en-tête (présence définie à l'étape précédente) ou par leur position (en commençant par 0). Une erreur de séparateur (à l'étape précédente) entraînera un découpage incorrect. Le bouton Voir le fichier permet de prévisualiser les premières lignes du fichier et de vérifier leur contenu et l'interprétation faite par le plugin.

Pour chaque colonne, vous pouvez choisir

• Ne pas récupérer de données de cette colonne (laisser l'option Choisir une table)

• Choisir une table : le type de données défini à l'étape 2 ou les informations financières

• Choisir un champ : qui sera renseigné par l'import

• Champ de liaison : pour indiquer que cette colonne servira à vérifier l'existence des données dans la base de données et à choisir entre créer un nouvel objet ou mettre à jour. Les champs candidats sont par exemple le Numéro de série, le Nom ou le Numéro d'inventaire

Informations complémentaires

Cette étape permet de définir les champs qui peuvent/doivent être renseignés par l'utilisateur lors d'une injection de fichier. Pour chaque champ, la même valeur sera utilisée pour chaque ligne du fichier et prendra le pas sur le contenu du fichier.

• Table : le type de données défini à l'étape Matching

• Champ : sera renseigné par l'import

• Information obligatoire : si la saisie utilisateur du modèle est obligatoire ou optionnelle

Exemple d'utilisation :

• Date d'achat lors de l'import d'un bon de livraison

• Commentaires pour définir un critère qui pourra être utilisé dans le moteur de recherche (ex : IMPORT AU 31/10)

Validation du modèle

Depuis l'onglet Validation, vous pouvez confirmer l'enregistrement. Il est toujours possible de revenir aux étapes précédentes pour vérifier et corriger certaines options.

Utilisation d'un modèle

Choix d'un modèle

• Depuis Outils > Data injection, sélectionner le modèle requis dans la liste déroulante

• Puis entrez le chemin d'accès au fichier CSV à injecter

• Spécifiez l'Encodage du fichier si vous le connaissez. Sinon, laissez sur Détection automatique

• Cliquez sur Procéder à l'importation

Confirmation avant l'importation

Une fenêtre popup vous demandera de confirmer ou non l'importation du fichier sélectionné.

Résultat de l'importation

À partir de cette dernière étape, en cliquant sur le cercle coloré, vous pouvez consulter un rapport sur l'importation et, notamment, localiser les éventuelles erreurs

Finaliser l'opération

Une fenêtre popup vous demandera si vous souhaitez confirmer ou non l'importation du fichier sélectionné. Une fois la barre de progression remplie, cliquez sur Terminer

FAQ

Si vous avez des questions concernant l'utilisation du plugin, veuillez consulter notre FAQ