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".
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. Vous serez redirigé vers le wizard d'import.
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".
Créer un import
1. 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.
2. Télécharger le 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. Différents séparateurs et formats sont disponibles, mais doivent être précisés.
- Compression : ZIP, GZIP ou Aucune
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.
Spécifications du fichier
Votre fichier devra répondre à des contraintes spécifiques pour être accepté.
- Le nom de la colonne dans le fichier doit impérativement être identique au nom technique du champ connu par Actito (sensible à la casse).
- 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.
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.
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.
Messages dans l'interface
Si les colonnes de votre fichier ne correspondent pas aux attributs de votre table, l'import ne sera pas accepté et un message d'erreur sera affiché.
3. 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.
- Mode mixte "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.
4. Résumé
La dernière étape vous donne un résumé des étapes précédentes. Il vous donne notamment toutes les informations du fichier déposé à l'étape 2, comme son format, le nombre de lignes et les en-têtes des colonnes.
Cela vous permet de vérifier que vous avez téléchargé le bon fichier avant de lancer l'import.
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".