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

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

Onglet Common

Propriété
Nom de l’attribut de la version XML
Description
Identifiant
id
L’identifiant unique de la composante
de flexibilité-out
au sein de l’ensemble.
Achemine la réponse à
routes-response-to
La destination du message de réponse pour le transport
sftp-out
.
Exécuter quand
execute-when
Indique une condition qui détermine si le transport s'exécute ou non.
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
sftp://SFTP-directory
, où
SFTP-directory
est l'emplacement cible.
Exemple :
sftp://sftpserver.example.org/outputDir
L'emplacement du répertoire que vous indiquez doit déjà exister sur le serveur.
Double authentification
dual-authentication
Indique s'il faut mettre en application la double authentification avec une combinaison nom d'utilisateur/mot de passe et une clé privée. La valeur par défaut est
false
, ce qui signifie qu'un utilisateur peut s'authentifier avec une clé privée ou une combinaison nom d'utilisateur/mot de passe, mais pas les deux.
Si la propriété est définie à
false
et qu’un utilisateur entre une clé privée (en configurant les propriétés de la clé privée de la composante
sftp-out
), l’authentification utilise alors automatiquement cette valeur clé et le nom d’utilisateur, en ignorant le champ du mot de passe. Si la propriété est définie à
false
et qu'aucune clé privée n'est configurée, l'authentification utilise la combinaison nom d'utilisateur/mot de passe.
Si la propriété est définie à
true
l’authentification utilise alors à la fois la combinaison de valeur de clé privée et de nom d’utilisateur/mot de passe.
Empreinte digitale de la clé hôte
host-key-fingerprint
La clé de chiffrement qui sera utilisée par le serveur FTP pour les communications SSH.
Nom d'utilisateur
username
Le nom d'utilisateur utilisé pour accéder au serveur FTP.
Mot de passe
password
Le mot de passe associé au nom d'utilisateur utilisé pour accéder au serveur FTP.
Fichier binaire
binary-file
Précise si les fichiers de sortie sont transférés en format binaire.
SSL explicite
explicit-ssl
Type de connexion : SSL explicite (AUTH TLS) ou SSL implicite (AUTH SSL). Défini à
true
d'utiliser SSL explicite.
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 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.

Onglet Avancé

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.
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
Indique l'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.