Workflow de transfert de fichiers SFTP

  • Rversion finale: Xanadu
  • Mis à jour 1 août 2024
  • 7 minutes de lecture

    • Le pack d’activités de transfert de fichiers SFTP inclut un workflow inclus dans le périmètre qui utilise plusieurs activités pour gérer les fichiers sur les serveurs SFTP.

    Le nombre maximal d’activités pour le workflow de transfert de fichiers SFTP est fixé à 10 000. Cela permet au workflow de déplacer jusqu’à 1000 fichiers d’un serveur à un autre.

    Accéder au workflow

    • Accédez à la Workflow > Éditeur de workflow et sélectionnez l’onglet Workflows .
    • Cliquez sur le flux de travail de transfert de fichiers SFTP pour l’ouvrir.
    • Cliquez sur l’icône d’informations dans l’en-tête du workflow pour afficher la boîte de dialogue des propriétés.

    Variables d'entrée

    Tableau 1. Variables d’entrée du workflow de transfert de fichiers SFTP
    Variable Description Valeur par défaut
    Hôte source Nom ou adresse IP du serveur contenant les fichiers que vous souhaitez déplacer.
    Port source Numéro de port à utiliser pour communiquer avec le serveur source. 22
    Répertoire source Chemin d’accès complet au répertoire où se trouvent les fichiers source.
    Fichiers sources Noms des fichiers sources spécifiques à déplacer. Séparez les noms de fichiers de cette liste par des points-virgules. Ce champ prend en charge l’utilisation de caractères génériques. Pour plus d’informations sur la façon dont les valeurs de ce champ sont affectées par les options d’autres champs, reportez-vous à la section située sous le tableau.
    Fichiers exclus Noms des fichiers sources spécifiques à exclure du déplacement. Le système déplace tous les autres fichiers trouvés dans le répertoire source ou les sous-dossiers. Séparez les noms de fichiers de cette liste par des points-virgules. Ce champ prend en charge l’utilisation de caractères génériques. Pour plus d’informations sur la façon dont les valeurs de ce champ sont affectées par les options d’autres champs, reportez-vous à la section située sous le tableau.
    Hôte cible Nom ou adresse IP du serveur vers lequel les fichiers sont déplacés.
    Port cible Numéro de port à utiliser pour communiquer avec l’hôte cible. 22
    Format de date/heure Format d’horodatage à appliquer lorsque la variable $[DateTime] est utilisée dans le champ Répertoire cible ou Fichiers cibles . Le système utilise l’heure actuelle de l’instance pour créer des valeurs d’horodatage. aaaa-MM-jj
    Répertoire cible Chemin d’accès au répertoire de l’hôte cible vers lequel les fichiers sont déplacés. Vous pouvez spécifier un répertoire cible dont le nom inclut l’horodatage en ajoutant la variable $[DateTime] au nom du répertoire. Par exemple, vous pouvez entrer ce chemin dans un répertoire cible : /user/jacinto.gawron/documents/projects_$[DateTime]. Cela produit le répertoire projects_20150505 . Lorsque la variable d’horodatage est utilisée, le système utilise le format spécifié dans le champ Format date/heure .
    Fichier cible Format à utiliser pour les noms de fichiers cibles lorsqu’un horodatage est ajouté. Vous pouvez configurer le système pour ajouter l’horodatage en tant que préfixe au nom du fichier ou insérer l’horodatage dans le nom, à l’aide des variables suivantes :
    • $[DateTime] : horodatage actuel, utilisant le format défini dans le champ Format date/heure .
    • $[SourceFile] : nom de fichier complet.
    • $[SourceFile :Base] : nom du fichier de base sans l’extension.
    • $[SourceFile :Ext] : extension de fichier uniquement.

    Un nom de fichier cible avec l’horodatage ajouté comme préfixe est exprimé comme suit : $[DateTime]_$[SourceFile]. Cela produit un nom de fichier qui ressemble à ceci : 20150505_file1.txt

    Un nom de fichier cible avec l’horodatage inséré dans le nom est exprimé comme suit : $[SourceFile :Base]_$[DateTime]$[SourceFile :Ext]. Cela produit un nom de fichier qui ressemble à ceci : file1_20150505.txt
    Appliquer les conditions de déplacement Case à cocher permettant d’appliquer des conditions au transfert de fichier. Si cette case est cochée, des champs supplémentaires apparaissent pour définir les conditions. faux
    Taille minimale du fichier, en octets Condition qui définit les exigences de taille minimale d’un fichier cible. Ce paramètre peut aider à déterminer si le fichier est valide. Ce champ s’affiche lorsque la case Appliquer les conditions de déplacement est cochée. 0
    Taille maximale du fichier, en octets Condition qui définit les exigences de taille maximale d’un fichier cible. Ce champ s’affiche lorsque la case Appliquer les conditions de déplacement est cochée. -1
    Le fichier n'est pas plus ancien que Condition qui définit la date la plus tôt acceptable pour la tranche d’âge de ce fichier. La plage commence à 00:00 (minuit) à la date spécifiée. Ce champ s’affiche lorsque la case Appliquer les conditions de déplacement est cochée.
    Le fichier n'est pas plus récent que Condition qui définit la dernière date acceptable pour la tranche d’âge de ce fichier. La plage se termine à 23h59 à la date spécifiée. Ce champ s’affiche lorsque la case Appliquer les conditions de déplacement est cochée.
    Inclure les sous-dossiers Cochez la case pour déplacer les fichiers des sous-dossiers dans le répertoire source. Pour plus d’informations sur la façon dont votre sélection affecte les autres champs du formulaire, consultez la section sous le tableau.
    Ordre des déplacements Ordre dans lequel les fichiers sont déplacés de la source vers la cible. Les options possibles sont les suivantes :
    • Aucun (même ordre que les fichiers dans le répertoire source)
    • Par horodatage
    • Par nom de fichier
    • Par taille de fichier
    Ordre de tri Ordre dans lequel les fichiers sont triés dans le répertoire cible, à l’aide de l’option sélectionnée dans le champ Ordre des déplacements . Les options de tri sont Croissant et Décroissant. Desc
    Nombre maximal de nouvelles tentatives Nombre de tentatives que l’activité peut effectuer pour se connecter à l’hôte cible ou pour déplacer un fichier avant l’expiration. Lorsque la limite de nouvelles tentatives pour déplacer un fichier ou se connecter à l’hôte est dépassée, le système consigne un échec. Si le nombre maximal d’échecs n’est pas dépassé, le système tente de se connecter à nouveau ou de déplacer le fichier suivant nommé. 2
    Temps entre les nouvelles tentatives, en secondes Temps, en secondes, entre les tentatives répétées de connexion à la cible ou de début de déplacement d’un fichier. 10
    Nombre maximal de défaillances Nombre acceptable de fois où le système peut échouer à se connecter à l’hôte cible ou à déplacer un fichier avant qu’il ne cesse d’essayer. Un échec se produit lorsque le nombre de nouvelles tentatives configurées est dépassé. Avec les paramètres par défaut, une défaillance se produit lorsque le système ne peut pas se connecter à la cible ou déplacer un fichier après deux nouvelles tentatives. 0
    Action de duplication de fichier Action à exécuter si un fichier en cours de déplacement existe déjà dans le répertoire cible. Les choix possibles sont les suivants :
    • Remplacer si le fichier existe (par défaut)
    • Renommer avec index
    • Ne pas déplacer
    		 écraser
    Conserver les attributs de fichier Cochez la case pour utiliser les informations d’horodatage et de mode des fichiers sources pour les fichiers copiés. Si cette case n’est pas cochée, les fichiers copiés ont un horodatage et un mode actuels.
    Remarque :
    Cet horodatage est un attribut de fichier et n’est pas ajouté au nom de fichier.
    		 faux
    En cas de réussite, supprimer les fichiers de la s Cochez la case pour supprimer les fichiers d’origine du répertoire source lorsqu’ils sont copiés vers le nouvel emplacement. Décochez cette case pour conserver les fichiers source à leur emplacement actuel dans l’hôte source. faux
    En cas de défaillance, conserver les fichiers dépl Cochez la case pour conserver tous les fichiers sur la cible qui ont été déplacés avec succès, même si l’ensemble de l’opération de transfert de fichiers s’est soldée par un échec. Si cette case n’est pas cochée, le système supprime tous les fichiers transférés avec succès de la cible en cas de défaillance générale. VRAI
    Balise d'informations d'identification pour la sou Alias d’informations d’identification spécifiques pour les activités d’orchestration que cette activité doit utiliser pour exécuter les commandes SSH sur l’hôte source.
    Balise d'informations d'identification pour la cib Balise d’informations d’identification spécifique que cette activité doit utiliser pour exécuter des commandes SSH sur l’hôte cible.

    Logique de sélection de fichier

    Lors de la sélection des fichiers à déplacer à partir de l’hôte source, le système utilise la logique suivante :
    • Si les champs Fichiers sources et Fichiers exclus sont vides, le système déplace tous les fichiers du répertoire source.
    • Lorsque la case Inclure les sous-dossiers est cochée, les dépendances suivantes existent :
      • Si aucun fichier n’est spécifié dans les champs Fichiers sources et Exclure les fichiers , le système déplace tous les fichiers dans le répertoire source et tous les fichiers dans tous les sous-dossiers du répertoire source.
      • Si le champ Fichiers sources contient des noms de fichiers, le système déplace ces fichiers de leur emplacement soit dans le répertoire source, soit dans l’un de ses sous-dossiers.
      • Si le champ Exclure les fichiers contient des noms de fichiers, le système déplace tous les fichiers du répertoire source et de ses sous-dossiers, à l’exception des fichiers exclus.
    • Lorsque la case Inclure les sous-dossiers est décochée, le système recherche uniquement dans le répertoire source les fichiers à déplacer ou à exclure.