A l'exécution, l'activité FTP Répertorier fichier se connecte à un serveur FTP et génère une liste de fichiers depuis l'emplacement de répertoire spécifié, à l'aide de l'expression régulière indiquée. L'activité FTP Répertorier fichiers renvoie la liste des fichiers à l'orchestration, à l'aide du paramètre de sortie directoryListing ou fileListing.
Si la case Fichiers de liste uniquement (NLST) est désélectionnée, une liste complète de répertoires, contenant notamment les droits d'accès sur les répertoires, les horodatages et la propriété, est renvoyée dans le paramètre de sortie directoryListing en tant que chaîne unique. Lorsqu'une liste complète de répertoires est renvoyée sous forme de chaîne, vous devez analyser cette liste à l'aide d'un schéma de fichier à plat, avec l'activité Lire fichier à plat. Si la case Répertorier uniquement les fichiers (NLST) est cochée et que l'activité FTP Répertorier fichiers gère le format de la liste de répertoires de votre serveur FTP, une structure répétée de noms de fichiers uniquement (si elle est prise en charge par le serveur FTP) est renvoyée dans le paramètre de sortie fileListing. Lorsqu'une structure répétée de nom de fichier est renvoyée, il n'est pas nécessaire d'analyser la liste de répertoires, il suffit de renouveler l'opération dans la liste à l'aide de l'activité Pour chaque ou Pendant que. Le serveur FTP auquel vous vous connecter doit gérer la commande NLST. La réponse fournie par le serveur FTP est renvoyée.
Dans certains cas, vous devez associer l'activité FTP Répertorier fichiers aux activités FTP Obtenir fichier, FTP Placer fichier, FTP Supprimer fichier et FTP Renommer fichier. pour traiter un ensemble de fichiers trouvés dans un répertoire FTP, alors que dans d'autres cas, vous pouvez simplement utiliser l'activité FTP Interroger répertoire.
Liens symboliques vers... | Liens en dur | Liens symboliques | Remarques |
---|---|---|---|
Fichiers | Non pris en charge | Non pris en charge | L'activité FTP Répertorier fichiers n'interprète pas les liens symboliques vers des fichiers en tant que fichiers et, par conséquent, les liens symboliques vers des fichiers ne sont pas traités par l'activité FTP Répertorier fichiers en phase d'exécution. |
Répertoires | Pris en charge | Pris en charge |
Zone | Description |
---|---|
Dans le répertoire | Indique le répertoire sur le serveur FTP où le dispositif d'intégration génère la liste des fichiers du répertoire.
Vous pouvez indiquer un répertoire à l'aide de l'une des options suivantes:
Remarque : UNIX : Si vous spécifiez un chemin de répertoire relatif lorsque vous vous connectez à un serveur FTP sur une machine UNIX, vérifiez que le répertoire de base FTP a été correctement spécifié dans le fichier /etc/password
pour le compte utilisateur qui se connecte au serveur FTP.
|
Fichier nommé | Spécifie un masque glob définissant les noms de fichier que vous souhaitez obtenir du serveur FTP. Le traitement du masque glob est réalisé par le serveur FTP. Pour plus d'informations, consultez la description du masque (pattern) glob dans la documentation du serveur FTP. |
Fichiers de liste uniquement (NLST) | La case Fichiers de liste uniquement (NLST) détermine le type de liste de répertoires renvoyé par le bouton Tester et pendant l'exécution. En outre, cette case définit si le paramètre de sortie fileListing ou directoryListing est affiché dans la tâche Mapper les sorties et renvoyé par l'activité pendant l'exécution. |
Si la case Répertorier uniquement les fichiers (NLST) est cochée, seuls les noms de fichiers (si ceci est pris en charge par le serveur FTP) sont renvoyés lorsque vous cliquez sur le bouton Tester, comme illustré dans la Figure 1. En outre, lorsque la case Fichiers de liste uniquement (NLST) est cochée, le paramètre de sortie fileListing est répertorié dans la tâche Mapper les sorties. A l'exécution, l'ensemble de fichiers est renvoyé dans le noeud répété fileName du paramètre de sortie fileListing. Le serveur FTP auquel vous vous connecter doit gérer la commande NLST. La réponse fournie par le serveur FTP est renvoyée. | |
Si la case Fichiers de liste uniquement (NLST) est désélectionnée, une liste complète de répertoires, contenant notamment les droits d'accès sur les répertoires, les horodatages et la propriété, est renvoyée lorsque vous cliquez sur le bouton Test, comme illustré dans Figure 2. En outre, lorsque la case Fichiers de liste uniquement (NLST) est cochée, le paramètre de sortie directoryListing est répertorié dans la tâche Mapper les sorties. A l'exécution, la liste complète de répertoires est fournie en tant que chaîne unique et renvoyée à l'aide du paramètre de sortie directoryListing. |
bidAcmeInc.txt
bidBudgetManufacture.txt
bidCrankCo.txt
bidSamAndSons.txt
bidWidgetRUs.txt
-rw-r--r-- 1 551 551 65 May 3 11:39 bidAcmeInc.txt
-rw-r--r-- 1 551 551 43 May 3 11:39 bidBudgetManufacture.txt
-rw-r--r-- 1 551 551 0 May 3 11:39 bidCrankCo.txt
-rw-r--r-- 1 551 551 73 May 3 11:39 bidSamAndSons.txt
-rw-r--r-- 1 551 551 33 May 3 11:39 bidWidgetRUs.txt
Zone | Description |
---|---|
Réessayer | |
1) Attendre ___ seconde(s) entre chaque tentative. | Nombre de secondes pendant lesquelles le dispositif d'intégration attend avant de tenter d'établir une connexion avec le serveur FTP. |
2) Tenter de se connecter ___ fois avant l'échec. | Indique le nombre de tentatives - nombre maximum de fois que le dispositif d'intégration tente d'établir une connexion avec le serveur FTP avant d'émettre une erreur. Si vous déployez une orchestration qui commence par une activité FTP Répertorier fichiers et que le dispositif d'intégration ne peut pas se connecter au serveur FTP spécifié, le dispositif d'intégration consigne les erreurs de connexion en tant qu'avertissements dans le journal système jusqu'à ce que la valeur du nombre de tentatives soit atteinte. Lorsque le nombre de tentatives est atteint, le dispositif d'intégration consigne une erreur dans le journal système, remet le nombre d'erreurs de connexion à zéro et poursuit les tentatives d'établissement d'une connexion au serveur FTP. Par exemple, si vous définissez le nombre de tentatives à 3, les erreurs de première, seconde et troisième connexions apparaissent dans le journal système en tant qu'avertissements. Le dispositif d'intégration consigne la quatrième erreur de connexion en tant qu'erreur et remet à zéro le nombre d'erreurs de connexion. Par conséquent, la cinquième erreur de connexion génère un avertissement dans le journal système. Le dispositif d'intégration continue de tenter l'établissement d'une connexion avec le serveur FTP. |
Si les paramètres d'entrée répertoriés dans le tableau suivant ne sont pas affichés dans le panneau Vers l'activité de la fenêtre Mapper les entrées, sélectionnez Afficher les paramètres facultatifs. Si vous ne pouvez pas sélectionner l'option dans le menu de la barre d'outils, cliquez sur un noeud dans le panneau Mapper les entrées pour activer cette option.
dans le menu de la barre d'outils ou cliquez avec le bouton droit de la souris dans le panneau Vers l'activité et sélectionnez l'optionSi vous le souhaitez, vous pouvez remplacer les paramètres spécifiés dans la tâche Configurer et Sélectionner le noeud final de la Liste de contrôle, dynamiquement en phase d'exécution, à l'aide des paramètres d'entrée définis dans le tableau suivant.
Par exemple, vous pouvez définir le répertoire du serveur FTP où le dispositif d'intégration obtient la liste de fichiers, dans la tâche Configurer par le répertoire appelé input. A l'exécution, le nom du répertoire inputXML peut être transmis à l'activité à l'aide du paramètre d'entrée directory. Le nom du répertoire spécifié dynamiquement pendant l'exécution remplace le paramètre initial, spécifié dans le panneau Configurer. Dans cet exemple, la liste de fichiers est générée à partir du répertoire inputXML.
Nom de paramètre d'entrée/Noeud | Description | Remplace le paramètre dans la tâche ? |
---|---|---|
directory | Indique le répertoire sur le serveur FTP où le dispositif d'intégration génère la liste des fichiers de cette activité. | Le paramètre d'entrée directory remplace la zone Dans le répertoire de la tâche Configurer. |
connection/timeout | Spécifie la durée en secondes avant l'expiration du délai entre la tentative du dispositif d'intégration pour établir une connexion avec le noeud final et le temps nécessaire au noeud final pour répondre à la demande de connexion. Pour l'activité FTP Supprimer fichier, durée pendant laquelle le dispositif d'intégration tente d'établir une connexion avec le serveur FTP avant l'expiration du délai. | Le noeud timeout du paramètre d'entrée connection remplace la zone Délai de connexion - Dépassement de délai d'attente après ___ seconde(s) lors de l'établissement d'une connexion avec le noeud final du noeud final FTP. |
connection/host | Spécifie le nom d'hôte ou l'adresse IP du serveur FTP. | Le noeud host du paramètre d'entrée connection remplace la zone Nom d'hôte du noeud final FTP. |
connection/port | Spécifie le numéro de port attribué au nom d'hôte spécifié. Le port standard pour le trafic FTP est 21. Le port par défaut pour le trafic SFTP est 22. | Le noeud port du paramètre d'entrée connection remplace la zone Port du noeud final FTP. |
connection/username | Spécifiez le nom d'utilisateur du compte utilisé pour la connexion au serveur FTP. | Le noeud username du paramètre d'entrée connection remplace la zone Nom d'utilisateur du noeud final FTP. |
connection/password | Spécifiez le mot de passe du compte utilisé pour la connexion au serveur FTP. | Le noeud password du paramètre d'entrée connection remplace la zone Mot de passe du noeud final FTP. |
A l'exécution, l'activité FTP Répertorier fichiers renvoie la liste des fichiers à l'orchestration, à l'aide du paramètre de sortie directoryListing ou fileListing.
Si la case Fichiers de liste uniquement (NLST) est désélectionnée dans la tâche Configurer, une liste complète de répertoires, contenant notamment les droits d'accès sur les répertoires, les horodatages et la propriété, est renvoyée dans le paramètre de sortie directoryListing en tant que chaîne unique. Lorsqu'une liste complète de répertoires est renvoyée sous forme de chaîne, vous devez analyser cette liste à l'aide d'un schéma de fichier à plat, avec l'activité Lire fichier à plat. Vous pouvez créer un schéma de fichier à plat à l'aide de l'éditeur de schéma de fichier à plat. Pour consulter un exemple d'orchestration analysant une liste de répertoires à l'aide d'un schéma de fichier à plat, voir Exemple d'analyse syntaxique de liste de répertoires : Exemple d'analyse syntaxique de liste de répertoires.
Si la case Répertorier uniquement les fichiers (NLST) est cochée et que l'activité FTP Répertorier fichiers gère le format de la liste de répertoires de votre serveur FTP, une structure répétée de noms de fichiers uniquement (si elle est prise en charge par le serveur FTP) est renvoyée dans le paramètre de sortie fileListing. Lorsqu'une structure répétée de nom de fichier est renvoyée, il n'est pas nécessaire d'analyser la liste de répertoires, il suffit de renouveler l'opération dans la liste à l'aide de l'activité Pour chaque ou Pendant que.