Aller au contenu principal

Importer des données via l'interface

Une fois votre table personnalisée créée, vous avez la possibilité d'importer des données pour populer celle-ci.

Pour ce faire, rendez vous dans l'application "Imports" (Apps > Données > Imports) et cliquez sur "Créer un import".

À noter qu'un raccourci est également présent via le bouton "Plus" dans le module Profils (Profils > Profils de la table X)

alt text

A savoir

L'import de données est également possible via les API dédiés aux tables personnalisées.

Choisissez le type de table personnalisée dans laquelle vous voulez importer des données.

Ensuite, choisissez si vous voulez démarrer votre import d'une page vierge ou si vous voulez utiliser une configuration sauvegardée avec des paramètres prédéfinis.

alt text

astuce

Cliquez sur la petite icône d'info pour voir les détails de la configuration (type de fichier, mapping, paramètres de chargement,...).

Vous serez ensuite redirigé vers le wizard d'import.

astuce

Il est également possible de lancer un import depuis l'app "Tables de données" en sélectionnant une table et en cliquant sur "Plus" puis "Import de données". alt text

Créer un import

Données générales

Tout d’abord, donnez un nom à l’import. Il vous aidera à retrouver l'exécution de l'import dans les onglets "En cours" et "Terminés". Ce nom doit donc être unique.

Sélectionnez ensuite l'entité de la table personnalisée dans laquelle vous importerez les données. Ce sera également l'entité de l'import.

Enfin, sélectionnez la table dans laquelle vous souhaitez importer des données. Seules les tables stockées sur l'entité précédemment sélectionnée sont affichées dans la liste déroulante.

alt text

Paramètres de chargement

Vous devrez ensuite spécifier les paramètres de l'import, ce qui équivaut à définir le traitement des correspondances des enregistrements déjà existants.

  • Modification/Création : Toutes les lignes du fichier sont prises en compte. Si une ligne correspondante de la table est trouvée, elle est mise à jour. Si aucune correspondance n'est trouvée, une nouvelle ligne est créée dans la table.
  • Création uniquement : Seules les lignes du fichier qui entraînent la création d'une nouvelle ligne de la table sont prises en compte. Vous obtenez ainsi uniquement l'ajout de nouveaux enregistrement dans la base de données.
  • Modification uniquement : Seules les lignes du fichier qui entraînent la mise à jour d'une ligne existante de la table sont prises en compte. Ce mode peut être utilisé pour les tables pour lesquelles une mise à jour des données est pertinente.
  • Suppression uniquement : Seules les lignes du fichier qui entraînent la suppression d’une ligne existante de la table seront prises en compte

alt text

Chargement de fichier

Vous devrez télécharger un fichier d'import contenant les données que vous souhaitez importer dans votre table.

Le fichier peut être un fichier .csv ou Excel de maximum 100 Mo. Il peut être chargé depuis votre ordinateur ou depuis un emplacement cloud configuré dans votre licence, comme la transferbox ou un FTP. Différents séparateurs et formats sont disponibles, mais doivent être précisés :

  • Compression : ZIP, GZIP ou Aucune
astuce

La compression du fichier n'est pas obligatoire mais permet de contenir plus de données. Veuillez essayer de compresser votre fichier si votre CSV dépasse la limite de 100 Mo.

  • Format : Sélectionnez si vous importez un fichier Excel ou CSV avec un séparateur par point-virgule, virgule ou tabulation.
  • Encodage : les encodages pris en charge sont UTF-8, UTF 16 Little Endian, ISO-8859-1 et CP1252.
  • Fichier avec en-tête : ce bouton (coché par défaut) indique si la première ligne du fichier correspond aux en-têtes des colonnes. Un fichier avec des en-têtes facilite le mapping des données. S'il n'en contient pas, l'étape suivante tiendra compte de l'ordre des colonnes.

alt text

Spécifications du fichier

Votre fichier devra répondre à des contraintes spécifiques pour être accepté.

  • Le fichier doit faire maximum 100 Mo (en cas de fichier zippé, seule la taille du ZIP compte).
  • L’ordre des colonnes n’a pas d’importance.
  • Les colonnes obligatoires doivent impérativement être présentes. Les colonnes non-obligatoires peuvent être omises.
  • Une même colonne ne peut pas se retrouver deux fois dans le fichier.
Astuce

Cliquez sur le bouton "Télécharger un exemple" pour télécharger un fichier illustratif reprenant la structure de votre table et le typage des valeurs de chacune des colonnes.

Vous aurez ainsi un exemple concret du format que doit prendre ce fichier.

A savoir

Les colonnes correspondant aux attributs techniques "creationMoment", "updateMoment" et "id" seront ignorées au moment de l'import.

Cela signifie que, si vous voulez effectuer une migration de données d'une table à une autre, vous pouvez exporter les données de la table et les importer à nouveau sans devoir modifier le fichier.

Mapping d'attributs

Cette étape vous permet d'établir la correspondance entre les colonnes de votre fichier (à gauche) et les attributs de la table (à droite).

alt text

astuce

Si votre fichier contient des en-têtes, l'intelligence artificielle d'Actito fera automatiquement le mapping entre la colonne et le champ correspond.

Le logo AIO indique les champs mappés automatiquement. Ceux-ci restent modifiables manuellement.

  • Si l'en-tête d'une colonne ne correspond pas à un attribut de la table, vous devrez effectuer le mapping manuellement en sélectionnant le champ correspondant dans le menu déroulant.
    Un échantillon de valeurs est affiché sous l'intitulé de la colonne.
  • Si votre fichier ne contient pas d'en-tête, il faudra effectuer le mapping sur base de l'ordre des colonnes et l'échantillon de valeurs servant d'exemple.
  • Si une colonne de votre fichier ne doit pas être importée, gardez l'option "Ignorer la colonne".
    L'encart en haut à droite indique tous les champs obligatoires (et uniques) qui n'ont pas encore été mappés.

Tous les attributs obligatoires doivent être mappés pour permettre la création de nouvelles lignes, tandis que les clés permettent d'identifier les lignes existantes en modes "Modification/création" et "Modification uniquement".

Préparation de données

Lors de cette étape vous avez plusieurs options :

  • Transformer : vous permet d’appliquer des règles de transformations aux valeurs présentes dans le fichier afin de les nettoyer ou de les reformater pour qu’elles correspondent aux valeurs attendues dans Actito.
  • Explorer les options avancées : vous permet de définir la méthode de chargement de chaque champ.
  • Simuler : vous permet de simuler l’import du fichier et d’identifier d’éventuelles erreurs.

alt text

Transformer

alt text

Cet écran vous permet de :

  • Visualiser les colonnes du fichier et le mapping avec les attributs d’Actito réalisé à l’étape précédente.
  • Consulter quelques valeurs présentes dans le fichier pour chaque champ
  • Définir des règles de transformations à éventuellement appliquer sur vos champs.
  • Prévisualiser le résultat de ces transformations, appliquées aux valeurs du fichier déjà affichées.
  • Ignorer les valeurs invalides :
    • Si la case est décochée alors en cas de valeur invalide pour ce champ la ligne du fichier sera complètement rejetée, même si les autres champs contiennent des valeurs valides.
    • Si la case est cochée, une valeur invalide sera simplement ignorée et laissée vide dans Actito tandis que le reste de la ligne sera importé. À noter qu’ici dans le cas d’un champ obligatoire, le reste de la ligne sera quand même rejeté.

Les règles de transformations à disposition dépendent du format du champ. Pour tous les champs :

  • Possibilité de définir un mapping entre les valeurs dans le fichier et celles à insérer dans Actito. Pour les champs de type String (texte) :
  • Nettoyage de texte
    • Échapper les caractères spéciaux
    • Annuler l’échappement des caractères spéciaux
    • Supprimer les accents (va par exemple convertir “é” en “e”)
    • Supprimer des caractères
    • Remplacer du texte
  • Formatage de texte
    • Convertir en minuscules
    • Convertir en majuscules aux initiales
    • Convertir en majuscules pour tous les caractères
    • Mettre en majuscule la première lettre uniquement
  • Rognage de texte
    • Supprimer les espaces en début et fin de chaîne de caractères
    • Conserver les N premiers caractères
    • Conserver les N derniers caractères
    • Supprimer les N premiers caractères
    • Supprimer les N derniers caractères

Pour les champs de type Date ou Timestamp :

  • Formatage du format de la date (et éventuellement de l’heure pour un timestamp)
  • Supprimer les N derniers caractères Pour les champs de type Date ou Timestamp :
  • Formatage du format de la date (et éventuellement de l’heure pour un timestamp)

Explorer les options avancées

alt text

Vous êtes ici en mesure de définir deux comportement principaux :

  • La gestion des valeurs vides : la case à cocher ici permet de définir comment sont traitées les éventuelles valeurs vides dans le fichier
    • Si elle est cochée, une valeur vide dans le fichier sera importée et pourra éventuellement écraser une valeur non vide précédemment présente dans Actito.
    • Si elle est décochée, une valeur vide dans le fichier sera ignorée pour éviter d’écraser la valeur déjà existante dans Actito.
  • Le traitement des valeurs actuellement en base : permet de définir le comportement de l’import si des valeurs si des valeurs sont déjà en base.
    • Remplacer les valeurs par celle du fichier écrasera les valeurs déjà existantes en base.
    • Conserver les valeurs existantes ne permettra que l’ajout de valeur s à la place de valeur actuellement vide, mais pas la mise à jour d’une valeur existante.

Vous pouvez choisir champ par champ le comportement souhaité ou appliquer la même règle pour tous les champs via la première ligne.

Simuler

alt text

Cette option permet de faire une simulation du chargement du fichier (sans réellement importer les données dans la table concernée donc) et d’identifier en amont les éventuels problèmes.

L’ensemble des lignes du fichier sont affichées, avec leur statut. Si pas d’alerte sur le champ alors il n’y pas d’erreur identifiée, et il est d’ailleurs possible de filtrer via le bouton “Afficher uniquement les avertissements” pour n’afficher que les champs problématiques.

alt text

Vous avez accès à l’ensemble des possibilités de l’option “Transformer” précédemment décrite, avec l’utilisation de règles de transformations et le choix d’ignorer les valeurs invalides si besoin.

Vous pouvez à tout moment relancer une simulation qui prendra en compte les éventuelles règles de transformation adaptées, et/ou télécharger le fichier corrigé.

Si une simulation est relancée alors l’écran se mettra à jour avec le résultat de cette nouvelle simulation, avec la possibilité de définir un nouveau round de transformations. Il est ainsi possible d’appliquer plusieurs règles de transformations à la suite sur le même champ si c’est nécessaire pour que celui-ci soit au bon format dans Actito.

Les options avancées sont également disponibles, avec les mêmes possibilités que précédemment expliqué.

Résumé

Cette dernière étape vous donne un résumé des étapes précédentes. Vous pouvez ainsi vérifier où les données seront chargées, dans quel mode d’import, les paramètres du fichiers ainsi que le mapping des champs avec les attributs d’Actito. Si des règles de transformation et des options avancées de chargement sont utilisées l’interface l’indique par une croix verte.

alt text

Attention

Les règles de transformation ne sont pas conservées dans cette configuration sauvegardée d’import.

Enregistrer une configuration d'import

Si vous voulez réutiliser vos paramètres d'import pour vos imports manuels futurs, vous pouvez aussi enregistrer une configuration d'import avant de le lancer.

Une configuration d'import garde en mémoire tous les détails importants :

  • le nom de l'import (un suffixe incrémental sera ajouté quand vous créez de nouveaux imports basés sur la config)
  • la table visée et l'entité
  • le type de fichier et sa compression
  • le mapping des attributs
  • les paramètres de chargement.

Pour en créer une, cliquez sur "Enregistrer comme configuration".

alt text

Vous devez ensuite donner un nom à la configuration, pour vous permettre de la retrouver quand vous sélectionnez un type de table à l'étape 0.

alt text

info

Pour supprimer une config enregistrée, choisissez "Créer un import" pour accéder à l'écran de sélection des configurations et basculez en "Mode édition" dans le coin supérieur droit.

Vérifier des résultats de votre import

Après avoir lancé votre import, celui-ci apparaîtra dans l'onglet 'En cours' jusqu'à ce qu'il soit terminé. Cela peut prendre entre quelques secondes et quelques minutes, selon le volume de données importées.

Pour vérifier les résultats de l'import et analyser les fichiers d'erreur possibles, veuillez consulter la sections Exécution terminées dans la section "Import de données".