Passer au contenu principal
Administrator Guide
Dernière mise à jour : 2023-06-23
Référence : propriétés de transport FTP-Out

Référence : propriétés de transport FTP-Out

Onglet Common

Propriété
Nom de l’attribut de la version XML
Description
Identifiant
id
L'identifiant unique de la composante de
ftp-out
au sein de l'ensemble.
Achemine la réponse à
routes-response-to
La destination du message de réponse pour le transport
ftp-out
.
Exécuter quand
execute-when
Condition qui détermine si le transport est exécuté.
Point de terminaison
endpoint
Indique l'hôte (et, éventuellement, le port) et le répertoire FTP pour l'écriture des fichiers.
Respecte le format
ftp://FTP-directory
, où
FTP-directory
est l'emplacement cible.
Exemple :
ftp://ftpserver.example.org/outputDir
L'emplacement du répertoire que vous précisez doit déjà exister sur le serveur FTP.
Fichier binaire
binary-file
Précise si les fichiers de sortie sont transférés en format binaire.
Modèle de fichier d'entrée
input-file-pattern
Modèle de nom de fichiers pour les fichiers correspondants d’un type particulier.
Exemple : préciser
*.xls
pour récupérer uniquement des fichiers Excel.
Type de contenu d'entrée
input-content-type
Type de média inclus dans l'exécution pour le
content-type
valeur dans l'en-tête du message. Un type de média comprend au moins deux parties : un type, un sous-type et un ou plusieurs paramètres facultatifs. La
text
le sous-type a une valeur facultative
charset
paramètre, qui définit l'encodage des caractères.
Exemple :
text/html; charset=UTF-8
Cette propriété est particulièrement utile dans le cas de formats de fichier de texte non XML, où le type de média et le jeu de caractères ne sont pas explicites dans le fichier.
Modèle de fichier de sortie
output-file-pattern
Précise comment les noms des fichiers de sortie sont générés. Le modèle peut contenir des chaînes littérales ainsi qu’un ou plusieurs des jetons suivants :
  • ${INFILE}
    , qui est remplacé par le nom du fichier d'entrée.
  • ${UUID}
    , qui est remplacé par un identifiant unique universel.
  • ${EXT}
    , placé à la fin du modèle, qui est remplacé par une extension de nom de fichier en fonction du type de contenu des données qui sont écrits dans la sortie de la composante d'ensemble.
Mode
method
Précise le mode de transfert :
  • put
    : écrit des fichiers sur le point de terminaison FTP qui contient le répertoire distant.
  • list
    : répertorie tous les fichiers et répertoires au point de terminaison FTP. Utilisez la propriété
    Input File Template
    avec
    list
    pour appliquer un modèle à la liste en cours de retour. Vous pouvez accéder aux résultats de la
    list
    méthode utilisant l'objet
    ftp
    MVEL. Exemple :
    ftp.list()
    renvoie une liste de chaînes qui contient la dernière liste récupérée.
  • get
    : extrait le premier fichier trouvé qui correspond à la valeur de propriété
    du modèle de fichier d'entrée
    .
  • delete
    : supprime le premier fichier trouvé qui correspond à la valeur de propriété
    du modèle de fichier d'entrée
    .
    Un fichier n'est pas automatiquement supprimé du site FTP après une période de
    get
    a été exécutée. Si vous souhaitez supprimer un fichier, vous devez appeler une méthode distincte. Exemple : vous pouvez inclure un
    ftp-out
    transport spécifiquement pour supprimer le fichier.
Mot de passe
password
Le mot de passe associé au nom d'utilisateur utilisé pour accéder au serveur FTP.
Nom d'utilisateur
username
Le nom d'utilisateur utilisé pour accéder au serveur FTP.

Onglet Avanced

Propriété
Nom de l’attribut de la version XML
Description
Message de magasin
store-message
Préciser
aucune valeur
, sauf avis contraire du service de soutien de Workday.
Pour stocker les messages, utilisez l’étape
store
de Studio.
Classe de transport
transport-class
Indique une autre classe de mise en œuvre par agrégat, si nécessaire.
Vous pouvez changer les classes de mise en œuvre de manière globale en modifiant le fichier WEB-INF/classes/spring/assembly-bean.xml.
Ignorer les points de terminaison dynamiques
ignore-dynamic-endpoints
Indique s'il faut ignorer la valeur dynamique WS-Addressing (WSA) dans l'en-tête du message entrant ou l'utiliser pour remplacer la valeur dans la propriété
Endpoint
du transport.
Utilisez l’étape
set-dynamic-endpoint
pour préciser les détails d’adressage des services Web.
Mode passif
passive-mode
Indique si le transport prend en charge FTP en mode passif.
En mode passif, le client FTP établit les deux connexions requises pour la mutation FTP. Le client communique avec le serveur sur le port de commande et lance la commande PASV. Le serveur répond ensuite en indiquant le port qu’il écoute pour la connexion de données. Le client lance ensuite la connexion de données à partir de son port de données vers le port de données du serveur indiqué. Pour terminer, le serveur renvoie un accusé de réception au port de données du client. En mode actif, le client lance la connexion par commande et le serveur démarre la connexion de données.
Expiration
timeout
Indique, en millisecondes, une période d'expiration pour les sessions FTP entre les clients et le serveur FTP sur lequel le transport est à l'écoute.
Si vous ne précisez aucune valeur, la session expirera après 300 000 ms (5 minutes).
Fichier de carte de types MIME
mime-types-map-file
Emplacement d'un fichier de mappage pour le mappage entre les types MIME et les extensions de fichier. Utilisez cette propriété pour :
  • Mapper les types MIME aux extensions de fichier lorsque la propriété
    de la méthode
    est définie sur
    put
    .
  • Mapper les extensions de fichier aux types MIME lorsque la propriété
    de la méthode
    est définie à
    get
    .
Le fichier pour ce mappage est
ccx/conf/mime.types
. Vous pouvez fournir votre propre version de ce fichier.
Ce transport peut générer des noms pour ses fichiers de sortie à l'aide d'un
${EXT}
jeton placé à la fin de
output-file-pattern
valeur.
Nom du fichier temporaire
temp-file-name
Indique un nom de fichier temporaire. Lorsque la propriété
de la méthode
est définie sur
put
, le fichier est téléversé en utilisant ce nom de fichier temporaire. Une fois le FTP terminé, le fichier est renommé avec le nom indiqué par la propriété
du modèle de fichier de sortie
.
Fermer une connexion
close-connection
Indique si la déconnexion se produit lorsque l'action FTP est terminée.
Taille de l'enveloppe
pool-size
Nombre maximum de connexions et de sessions simultanées pouvant être prises en charge par hôte pour cette composante. Si un nombre de fils d’exécution plus grand que le nombre indiqué tentent de se connecter au même hôte, certains d’entre eux sont obligés d’attendre l’accès au regroupement.
Pour rendre la taille du regroupement illimitée, indiquez un nombre négatif.
Débogage
debug
Active le mode de débogage JSCOP dans le transport.