Transfert de fichier transfer-file
Description description
L’activité Transfert de fichier permet de recevoir ou d’envoyer des fichiers, de tester la présence de fichiers ou de lister les fichiers dans Adobe Campaign.
Contexte d'utilisation context-of-use
La façon dont les données seront extraites est définie lors du paramétrage de l’activité. Le fichier à charger peut par exemple être une liste de contacts.
Vous pouvez utiliser cette activité pour récupérer des données qui seront ensuite structurées avec l’activité Chargement de fichier.
Rubriques connexes :
Configuration configuration
-
Placez une activité Transfert de fichier dans votre workflow.
-
Sélectionnez l’activité puis ouvrez-la à l’aide du bouton
-
Utilisez la liste déroulante du champ Action pour sélectionner l’action de l’activité, à savoir :
- Réception de fichier : vous permet de télécharger un fichier.
- Chargement de fichier : vous permet de charger un fichier. Le téléchargement d'un fichier depuis Adobe Campaign génère une entrée de journal dans le menu Audits des exports. Pour plus d’informations sur les audits des exports, consultez la section Audits des exports.
- Test d’existence de fichier : vous permet de vérifier l’existence d’un fichier.
- Listage de fichiers : vous permet de lister les fichiers présents sur le serveur défini dans l’onglet Protocole. Cette action est principalement utilisée à des fins de débogage, afin de vérifier si l’activité est configurée en fonction de vos besoins avant de télécharger les fichiers à partir du serveur distant.
-
Sélectionnez le protocole que vous souhaitez utiliser :
-
La section Options supplémentaires, disponible en fonction du protocole choisi, vous permet d’ajouter des paramètres à votre protocole.
Vous pouvez ainsi effectuer les actions suivantes :
-
Supprimer les fichiers source après leur transfert : supprime les fichiers sur le serveur distant. Si vous ne cochez pas cette option, veillez à surveiller manuellement la taille du contenu archivé dans le répertoire SFTP.
-
Tri des fichiers : permet de trier les fichiers par ordre alphanumérique. Par défaut, cette option est désactivée.
-
Lister tous les fichiers : cette option est disponible lors de la sélection de l’action Listage des fichiers dans l’onglet Général. Elle permet de répertorier tous les fichiers présents sur le serveur dans la variable d’événement vars.filenames. Les noms des fichiers y sont séparés par les caractères 'n'.
-
-
La section En cas d’absence de fichier de l’onglet Options avancées vous permet d’agir sur les erreurs ou les fichiers inexistants détectés lors du lancement de l’activité.
Vous pouvez également définir de nouvelles tentatives. Les différentes tentatives apparaissent dans le journal d’exécution du workflow.
-
Validez le paramétrage de l’activité et enregistrez le workflow.
Configuration avec HTTP HTTP-configuration-wf
Le protocole HTTP permet de lancer le téléchargement d’un fichier depuis un compte externe ou une URL.
Avec ce protocole, vous pouvez choisir l'option Utiliser des paramètres de connexion définis dans un compte externe. Dans ce cas, sélectionnez le compte de votre choix et indiquez le chemin d’accès au fichier à télécharger.
Vous pouvez également choisir l’option Configuration rapide. Il suffit de saisir l’URL dans le champ URL.
Suivre les redirections, Ignorer le code de retour HTTP et Ajouter les en-têtes HTTP reçus au fichier sont les options supplémentaires disponibles lorsque vous sélectionnez le protocole HTTP.
Configuration avec SFTP SFTP-configuration-wf
Le protocole SFTP permet de lancer le téléchargement d’un fichier depuis une URL ou un compte externe.
Avec ce protocole, vous pouvez choisir l'option Utiliser des paramètres de connexion définis dans un compte externe, puis sélectionner le compte désiré et indiquer le chemin d'accès au fichier à télécharger.
Vous pouvez également choisir l'option Configuration rapide. Il suffit de saisir l’URL dans le champ URL.
Configuration avec Amazon S3 S3-configuration-wf
Le protocole Amazon S3 permet de lancer le téléchargement d’un fichier depuis une URL ou un compte externe via Amazon Simple Storage Service (S3).
-
Sélectionnez un compte externe Amazon S3. Pour plus d'informations à ce propos, consultez cette page.
-
Choisissez si vous souhaitez Définir un chemin d’accès au fichier ou Utiliser un chemin d’accès au fichier dynamique.
-
Indiquez le chemin d’accès au fichier à télécharger.
note caution CAUTION Les caractères génériques ne sont pas pris en charge par Amazon S3. Pour cibler plusieurs fichiers tels que my_file_02etmy _file_3433, vous pouvez utiliser la syntaxe suivante :acs-myawsbucket.s3.amazonaws.com/object-path/my_file_. -
Si vous souhaitez supprimer les fichiers source une fois le transfert terminé, cochez la case Effacer les fichiers source après leur transfert.
Configuration avec le stockage Blob Microsoft Azure azure-blob-configuration-wf
Le protocole Blob Microsoft Azure permet d’accéder à l’objet Blob situé sur un compte de stockage Blob Microsoft Azure.
-
Sélectionnez un compte externe Blob Microsoft Azure. Pour plus d'informations à ce propos, consultez cette page.
-
Choisissez si vous souhaitez Définir un chemin d'accès au fichier ou Utiliser un chemin d'accès au fichier dynamique.
-
Indiquez le chemin d’accès au fichier à télécharger ; il peut correspondre à plusieurs objets Blob. Dans ce cas, l’activité Transfert de fichier activera la transition sortante une fois par objet Blob trouvé. Ils seront ensuite traités par ordre alphabétique.
note caution CAUTION Les caractères génériques ne sont pas pris en charge pour faire correspondre plusieurs noms du fichier. Vous devez saisir un préfixe. Tous les noms d’objets Blob correspondant à ce préfixe seront éligibles. Voici une liste d’exemples de chemins de fichier :
- "campaign/" : correspond à tous les objets Blob dans le dossier Campaign situé à la racine du conteneur.
- "campaign/new-" : correspond à tous les objets Blob avec un nom de fichier commençant par « new- » et se trouvant dans le dossier Campaign.
- "" : l’ajout d’un chemin d’accès vide permet de faire correspondre tous les objets Blob disponibles dans le conteneur.
Configuration avec des fichiers présents sur le serveur Adobe Campaign files-server-configuration-wf
Le protocole Fichier(s) présent(s) sur le serveur Adobe Campaign correspond au référentiel contenant le ou les fichiers à récupérer.
Les métacaractères ou caractères génériques (par exemple * ou ?) peuvent être utilisés pour filtrer les fichiers.
Choisissez si vous souhaitez Définir un chemin d’accès au fichier ou Utiliser un chemin d’accès au fichier dynamique. L’option Utiliser un chemin d’accès au fichier dynamique permet d’utiliser une expression standard et des variables d’événements pour personnaliser le nom du fichier à transférer. Voir à ce propos cette page.
Veuillez noter que le chemin doit être relatif au répertoire d’espace de stockage du serveur Adobe Campaign. Les fichiers se trouvent dans le répertoire sftp<nomdevotreinstance>/. Il est également impossible de parcourir les niveaux de répertoires supérieurs à l’espace de stockage.
par exemple :
user<yourinstancename>/my_recipients.csv est correct.
../hello/my_recipients.csv est incorrect.
//myserver/hello/myrecipients.csv est incorrect.
Paramètres d’historisation historization-settings
À chacune de ses exécutions, l’activité Transfert de fichier stocke les fichiers transférés ou téléchargés dans un dossier dédié. Un dossier est créé pour chaque activité Transfert de fichier d’un workflow. Par conséquent, il est important de pouvoir limiter la taille de ce dossier de façon à préserver l’espace physique sur le serveur.
Pour cela, vous pouvez définir les Paramètres d’historisation dans les Options avancées de l’activité Transfert de fichier.
Les Paramètres d’historisation permettent de définir un nombre maximum de fichiers ou la taille totale du dossier de l’activité. Par défaut, 100 fichiers et 50 Mo sont autorisés.
À chaque exécution de l’activité, le dossier est vérifié comme suit :
- Seuls les fichiers créés plus de 24 heures avant l’exécution de l’activité sont pris en compte.
- Si le nombre de fichiers pris en compte est supérieur à la valeur du paramètre Nombre maximum de fichiers, les fichiers les plus anciens sont supprimés jusqu’à ce que le Nombre maximum de fichiers soit atteint.
- Si la taille totale des fichiers pris en compte est supérieure à la valeur du paramètre Taille maximale (en Mo), les fichiers les plus anciens sont supprimés jusqu’à ce que la Taille maximale (en Mo) soit atteinte.
Variables de sortie output-variables
L'activité Transfert de fichier génère des variables d'événement en tant que sortie, que vous pouvez exploiter dans d'autres activités, par exemple pour vérifier le nombre de fichiers téléchargés à l'aide d'une activité Test.
Notez que les variables d’événement peuvent également être transmises à un autre workflow à l’aide d’un signal externe (voir Personnaliser un workflow avec des paramètres externes).
Les variables de sortie disponibles sont les suivantes :
- fileName : nom des fichiers transférés.
- filesCount : nombre de fichiers transférés.