Temps de lecture : 2 minutes.

Pour pouvoir importer un fichier Excel, il est nécessaire de créer un mapping décrivant les correspondances entre les colonnes de votre fichier et les attributs / associations modélisées dans l'espace Ontologie.

Configurer un import

Avant de démarrer, connectez-vous à l'espace de travail instance dans lequel les données doivent être importées. Puis :

1. Cliquez sur Import dans la barre de menu pour faire apparaître l'écran d'import.
2. Cliquez sur Parcourir... pour sélectionner votre fichier local à importer.
3. Saisissez les paramètres spécifiques (optionnel).
4. Cliquez sur Envoyer pour lancer l'assistant de mapping.

Bonne pratique : pour pouvoir tester vos données avant l'import, simulez un import en saisissant le paramètre spécifique noCreation. Utilisez-le avant chaque import. Si à l'issue de ce test aucune erreur est signalée, vous pouvez procéder à l'import.

Initialiser l'assistant de mapping

Lorsque l'assistant de mapping démarre, cette interface apparaît :

Initialisation de l'assistant de mapping.

Cet écran permet de sélectionner une feuille de calcul du fichier Excel fourni. 

Pour une feuille de calcul sélectionnée, vous pouvez :

• Choisir une classe issue du modèle de données défini dans l'espace Ontologie (obligatoire).
• Choisir un modèle qui définit le mapping que vous aurez sauvegardé à l'issue de l'étape de mapping (optionnel, voir la section Sauvegarder et réutiliser un mapping dans cet article). 

Note : l'import web ne permet d'importer qu'une seule feuille de calcul à la fois. Chaque ligne d'un fichier, à l'exception de la première, est considérée comme une instance de la classe sélectionnée.

Effectuer un mapping

Une fois la classe choisie, le mapping débute.

Assistant de mapping : mise en correspondance entre le modèle de données (colonne de gauche) et le fichier Excel à importer.

 Pour créer un nouveau mapping : 

1. Sélectionnez un attribut ou un rôle depuis la colonne de gauche.
2. Sélectionnez le ou les entêtes correspondantes, depuis la colonne de droite.
3. Cliquez sur le bouton Nouveau mapping pour sauvegarder le mapping.

Pour les attributs ayant une valeur littérale (tels que nom et texte), une information de langue doit être sélectionnée dans la zone de récapitulation.

Zone de récapitulation d'un mapping.

Attention  : par défaut aucune langue n'est mise. Il faut donc toujours vérifié avant l'import si les attributs mappés en ont besoin. 

Sauvegarder et réutiliser un mapping

Avant de procéder à l'import, vous pouvez sauvegarder votre mapping en tant que modèle d'import. De cette façon, vous pourrez réutilisé le mapping lors d'un import ultérieur.

Pour ce faire, renseigner le champ Nom du modèle en bas de la zone de récapitulation, puis cliquez sur Enregistrer le modèle.

Au prochain import, si vous sélectionnez un modèle d'import au lieu d'une classe, la table des mappings sera pré-remplie avec les mappings sauvegardés.

À savoir : pour pouvoir réutiliser un mapping il est nécessaire que le nouveau fichier à importer contienne au moins les mêmes colonnes sauvegardées dans le modèle de mapping. Il est donc conseillé de ne pas modifier le nom des colonnes concernées par le mapping.