Vous pouvez charger vos données en optant pour l'une ou l'autre des options suivantes :

• API: L'API Emarsys fournit aux clients un accès pour charger leurs données sur les serveurs Emarsys. Pour une performance et un transfert de données optimaux, nous recommandons d'utiliser l'API Emarsys - cela vous oblige néanmoins à avoir certaines ressources techniques pour l'intégrer à vos applications. Pour plus de détails, voir Transférer des données via l'API.
• SFTP: Vous pouvez téléverser vos fichiers de données dans le serveur SFTP (Protocole de transfert de fichier sécurisé - "Secure File Transfer Protocol") hébergé par Emarsys Par ce moyen plus fréquemment utilisé, vous pouvez traiter plus de données (un gros volume de données) plus vite.

Nommer vos fichiers de données .csv est crucial, car le mode de chargement de vos fichiers .csv peut être contrôlé par le suffixe du nom de fichier. Les noms de fichier sont sensibles à la casse. N'utilisez que des lettres minuscules. Par ex. : filename.[loadingmode].csv

Modes d'importation :

• Remplacer: Sauf indication contraire, le Mode d'importation remplacer remplace le contenu existant du tableau cible par les lignes dans le fichier. Par ex. : filename.csv Dans le cas d'un remplacement, le mécanisme de chargement charge d'abord vos données dans un tableau temporaire. Quand le chargement des données s'est achevé avec succès, le vieux tableau est abandonné et remplacé par un nouveau.
• Annexer : Toutes les lignes sont insérées en tant que nouveaux enregistrements du fichier .csv vers le tableau. Par ex. : tablename.append.csv
• Insérer en haut : Insère toutes les nouvelles lignes du fichier .csv vers le tableau. Les lignes existantes sont mises à jour. S'il y a une clé principale dans le fichier .csv ayant une correspondance exacte dans le tableau, l'enregistrement dans le tableau sera mis à jour avec les données du fichier .csv.

Pour importer vos fichiers de données, elle doit remplir les critères suivants :

• Le format est fichier .csv (valeurs séparées par une virgule).
• Crypté avec UTF-8 Unicode.
• Avoir une fin de fichier Windows (\r\n) ou UNIX (\n). Les vieilles terminaisons de ligne utilisées par MacOS (\r) ne sont pas supportées.

La structure du fichier de données .csv doit être comme suit :

En-tête

• Au cas où votre fichier .csv contient un en-tête, dans la boîte de dialogue Charger les paramètres cochez que la Première ligne est un entête pour éviter que l'en-tête soit importé comme données.
  Attention, nous n'associons pas les colonnes dans le fichier .csv aux champs du tableau cible. L'ordre des colonnes dans le .csv doit correspondre à l'ordre des champs dans le tableau de données.

Champ(s) clé(s) principal/aux

• Veuillez à ne pas utiliser une clé principale deux fois, car une seule est importée. Dans le cas où vous utilisez plusieurs clés principales, Emarsys ne peut pas garantir quelle clé principale sera la clé finale, car le traitement des lignes n'est pas séquentiel.
• Ordonner les données par clé(s) principale(s) augmente le processus d'importation de manière significative.

Champs

• Les champs doivent être séparés par un caractère configuré dans les paramètres de chargement.
• Les données doivent être encadrées par des guillemets (").
• Si vos données contiennent un guillemet simple, vous devez utiliser les données entre guillemets (") et vous devez utiliser alors une barre oblique inversée (\) comme caractère d'échappement. Par ex. : "bonjour \" tout le monde" est importé comme bonjour " tout le monde
• Dans le cas de l'importation d'un caractère de barre oblique inversée (\), vous devez utiliser un caractère d'échappement. Par ex. : "bonjour \\tout le monde est importé comme bonjour\tout le monde.
• Pour importer un caractère séparateur, vous devez mettre la valeur de champ entre guillemets (").
• Assurez-vous d'utiliser le type de données correct défini par la colonne du tableau pertinente, sinon l'importation entraînera une perte de données. Faites attention à la longueur des données, car les champs de texte sont tronqués s'ils sont plus longs que définis. Si l'installation Relation Data a été réalisée par Emarsys (Entièrement gérée) vous pouvez consulter la structure des tableaux dans vos accords antérieurs. Veillez à conserver la structure validée des colonnes, ou bien vos données deviennent incohérentes et l'importation peut échouer.
  • DATE, utilisez le format 'AAAA-MM-JJ' format, par ex. : '1970-01-01'
  • HEURE DE DATE or HORODATAGE, utilisez 'AAAA-MM-JJ hh:mm:ss' par ex. : '1970-01-01 00:00:01'

Après avoir donné l'accès avec succès et vous être connecté au serveur SFTP hébergé par Emarsys, vous pouvez commencer à téléverser vos fichiers de données. Seuls les fichiers en provenance du répertoire racine SFTP sont importés, tous les autres sous-répertoires sont ignorés.

1. Une fois que vous êtes prêt au niveau du chargement, vous devez notifier le système de passer au mécanisme d'importation en chargeant un fichier de contrôle nommé upload.finished. Veillez à charger le fichier de contrôle après les fichiers .csv. Le fichier de contrôle peut être vide. Il empêche le traitement partiel des fichiers chargés.
2. Le processus d'importation commence aussitôt que le fichier de contrôle est chargé (et que vous avez correctement configuré le chargement SFTP).
3. Attendez jusqu'à ce que upload.finished disparaisse avant de commencer à charger les nouveaux fichiers, sinon vous recevrez le message d'erreur L'importation a échoué parce qu'une autre importation était déjà en cours.
4. Relational Data recherche de nouveaux fichiers de données à intervalles réguliers. Les fichiers traités avec succès et les fichiers restants longtemps sur SFTP sont supprimés du serveur.

Deux options existent pour surveiller l'état d'une importation :

• Dans l'onglet Historique SFTP vous pouvez suivre votre processus d'importation. Vous pouvez voir les résultats de l'importation et consulter le nombre de lignes affectées. Si un chargement échoue, passez au-dessus de l'état pour voir une courte explication dans l'infobulle qui apparaît.

• Vous pouvez aussi consulter le fichier upload_result.json. Ce fichier a été créé à la racine de votre dossier SFTP quand le chargement s'est terminé. Le fichier liste le résultat de l'importation pour tous les tableaux affectés dans un tableau JSON .

Exemple Résultats
Importation réussie :

[{   "tableName": "activities", "status": "finished", "operation": "append", "affectedRows": 2228 }]   Unsuccessful import: [{ "tableName": "sale", "status": "finished", "operation": "append", "error": "failure:query_timeout" }]

Le processus d'importation ne démarre pas

Vérifiez les choses suivantes à la recherche d'une explication :

• Le format de fichier et d'extension est bien .csv.
• Autoriser le chargement SFTP est activé pour le tableau sur l'onglet Tableaux & Vues dans Relational Data.
• Le nom de fichier obéit aux conventions configurées dans les paramètres de chargement SFTP.
• Le fichier de données est chargé à la racine de votre registre SFTP.
• Vous avez chargé le fichier de contrôle. Par ex : upload.finished

Le processus d'importation a échoué

Cherchez la raison de l'erreur sur l'onglet Historique SFTP ou dans le fichier upload_result.json.

Vérifiez erreurs possibles suivantes :

• wrong_encoding - "L'importation a échoué à cause d'une erreur de codage. Veuillez vérifier que le codage de caractère du fichier CSV est bien UTF-8, puis ré-essayez de charger."
• non_existent_target_table - "L'importation a échoué parce que le tableau que vous essayez de charger est introuvable. Veuillez vous assurer que le tableau existe puis ré-essayez.",
• conflicting_files - "L'importation a échoué parce que plusieurs fichiers ciblaient le même tableau dans la base de données. Essayez d'importer les fichiers séparément.",
• foreign_key_constraint_failed - "L'importation a échoué à cause d'une violation de clé étrangère. Veuillez vous assurer que le fichier CSV chargé est bien à jour et ré-essayez.",
• overlapping_load - "L'importation a échoué parce qu'une autre importation était déjà en cours. Veuillez ré-essayer quand l'importation précédente est terminée."

Les lignes affectées ne sont pas celles attendues

Vérifiez les choses suivantes à la recherche d'une explication :

• Le mode d'importation n'a pas été inséré en haut :
  • En cas d'insertion vers le haut le nombre de lignes affectées peut être plus important que le nombre de lignes originel. Dans certains cas la mise à jour compte comme 2 lignes mises à jour.
  • Une ligne peut être mise à jour plusieurs fois par les lignes d'input. Cela peut avoir pour résultat un compte de mise à jour "plus-bas-qu'attendu".
• Il n'y avait pas de clés principales identiques ou de contraintes uniques.
• Les types de données sont corrects. Par ex. : Les chaînes ne peuvent pas être importées en champs numériques, sinon elles seront représentées par 0.