SFTP - Instructions pour les champs personnalisés

TABLE DES MATIÈRES

• SFTP - Instructions pour les champs personnalisés
  • Logique de traitement du fichier de réponses des champs personnalisés
  • Format et conventions de nommage des fichiers
  • Fréquence et planification
  • Format du fichier de champs personnalisés

Ce sujet contient des informations utiles pour garantir le succès de vos transferts de fichiers.

Pour des directives et informations générales sur le SFTP, consultez SFTP - Instructions de configuration.

Logique de traitement du fichier de réponses des champs personnalisés

Spotnana autorise soit un jeu de données de réponse de champ personnalisé partiel, soit complet à chaque fois que vous téléchargez le fichier. Le nom du fichier indique le nom du champ personnalisé et la liste de réponses pour lesquels les réponses sont téléchargées. Chaque champ personnalisé et ses réponses doivent être envoyés dans un fichier séparé (pour plus de détails sur les conventions de nommage des fichiers, voir ci-dessous). La logique utilisée pour traiter le contenu de votre fichier CSV est la suivante :

• Si la colonne ACTION pour la ligne est définie sur CREATE, l'option de réponse sera créée pour la liste de réponses.

• Si la colonne ACTION pour la ligne est définie sur UPDATE et que l'option de réponse existe déjà, la description de la réponse sera mise à jour pour cette réponse.

Si la colonne ACTION pour la ligne est définie sur DELETE, l'option de réponse sera supprimée. Si aucun enregistrement dans la base de données Spotnana ne correspond à l'option de réponse, la ligne sera ignorée et aucune action ne sera effectuée.

Format et conventions de nommage des fichiers

Chaque fichier de flux personnalisé .CSV doit utiliser ce format :

CUSTOM_FIELD_V3_OPTIONS.[customFieldID].[optionGroupID].*.csv

où :

• [customFieldID] est une variable qui change pour chaque champ. Cet ID est contenu dans le nom du fichier indiqué à l' étape 2 de la boîte de dialogue Instructions d'importation SFTP qui fait partie des instructions d'importation depuis le répertoire SFTP. 

• [optionGroupID] est une variable qui change pour chaque liste de réponses. Cet ID est contenu dans le nom du fichier indiqué à l' étape 2 de la boîte de dialogue Instructions d'importation SFTP qui fait partie des instructions d'importation depuis le répertoire SFTP. 

• le * (astérisque) représente tous les caractères que vous souhaitez ajouter au nom. 

• le “.” après le [optionGroupID] et le “.” avant “csv” doivent être présents. 

Le nom du fichier n'est pas sensible à la casse. Nous vous recommandons d'inclure la date et l'heure dans le nom du fichier (pour faciliter le dépannage à l'avenir). Par exemple :

CUSTOM_FIELD_V3_OPTIONS.[customFieldID].[optionGroupID].spotnana_integration_<DateTime>.csv

Le fichier de flux .CSV doit également être dans un format spécifique. Les noms des colonnes doivent correspondre exactement au format défini (voir la section Format du champ personnalisé ci-dessous). 

Fréquence et planification

Nous vous recommandons de télécharger un fichier quotidiennement pour vous assurer de notifier Spotnana de tout ajout/mise à jour/suppression qui aurait pu survenir (si vos champs personnalisés changent souvent, des mises à jour quotidiennes peuvent être préférées). Si cette pratique est suivie : 

• les nouvelles réponses seront disponibles à sélectionner lors du paiement par les voyageurs immédiatement. 

• les réponses obsolètes seront supprimées en tant qu'option et ne seront plus disponibles pour les voyageurs. 

Les réponses obsolètes resteront visibles sur les rapports.

Format du fichier de champs personnalisés

Utilisez ces informations pour vous assurer que les données de votre téléchargement de champ personnalisé sont correctement formatées et préparées.