En phase d'exécution, l'activité FTP Interroger répertoire se connecte à un serveur FTP et recherche le ou les fichiers spécifiés, à l'emplacement indiqué. Après avoir lu le contenu des fichiers et mappé ce contenu sur des variables de l'orchestration, l'activité FTP Interroger répertoire peut supprimer, déplacer ou conserver ces fichiers dans le répertoire du serveur FTP.
L'activité FTP Interroger répertoire est une activité de démarrage. Lorsque vous déployez une orchestration qui commence par l'activité FTP Interroger répertoire sur le dispositif d'intégration, ce dernier interroge le serveur FTP à la recherche de fichiers à ajouter à un répertoire donné. Lorsque des fichiers sont affichés sur le serveur FTP, un travail d'orchestration est démarré pour traiter ces fichiers et les activités restantes de l'orchestration. Pour plus d'informations, voir Comportement de l'intervalle d'interrogation. Pour consulter un exemple d'orchestration à l'aide de l'activité FTP Interroger répertoire, voir le manuel Getting Started Guide.
Liens symboliques vers... | Liens en dur | Liens symboliques | Remarques |
---|---|---|---|
Fichiers | Non pris en charge | Non pris en charge | L'activité FTP Interroger répertoire 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 Interroger répertoire en phase d'exécution. |
Répertoires | Pris en charge | Pris en charge |
Vous pouvez activer la persistance pour une orchestration contenant une activité FTP Interroger répertoire. Par exemple, si vous désactivez la persistance et qu'un travail d'orchestration est en cours avec l'activité FTP Interroger répertoire et l'option Conserver à l'emplacement sélectionnée, si un échec se produit en cours d'exécution et cause l'arrêt du travail, lorsque l'orchestration est redémarrée, elle traite à nouveau le fichier. L'état du travail est perdu et le dispositif d'intégration ne sait pas qu'il a déjà traité le fichier. Pour plus d'informations, voir Activation de la persistance.
Zone | Description |
---|---|
Fichier nommé | Spécifie un modèle ou une expression régulière qui définit les noms de fichier provenant du serveur FTP. Le traitement de l'expression régulière est effectué par le serveur FTP. Pour plus d'informations, voir la documentation du serveur FTP sur les expressions régulières. Généralement, les serveurs FTP prennent en charge les caractères génériques suivants dans leurs expressions régulières :
Remarque : Etant donné que le traitement de l'expression régulière est effectué sur le serveur FTP, la sensibilité à la casse est déterminée par le serveur FTP.
Si le serveur FTP est sensible à la casse, la concordance de fichiers effectuée par l'activité FTP
Interroger répertoire est également sensible à la casse.
|
Dans le répertoire | Spécifie le répertoire dans lequel le dispositif d'intégration recherche des fichiers sur le serveur FTP. 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.
|
Tester | Lorsque vous avez indiqué une expression régulière dans la zone Nom de fichier et le répertoire dans lequel doivent être recherchés les fichiers sur le serveur FTP, dans la zone Dans le répertoire, cliquez sur Tester pour tester l'expression régulière sur l'ensemble de fichiers, dans le répertoire spécifié, sur le serveur FTP. |
De type | Spécifie comment lire le contenu du fichier - soit en tant que données binaires, soit en tant que texte codé. Si l'option Texte est sélectionnée, définissez le type de codage à l'aide de l'une des options suivantes :
Remarque : Certains caractères codés sur deux octets ne sont pas convertis à l'aide du codage SHIFT-JIS. Pour plus d'informations, voir Utilisation du codage Shift-JIS.
ATTENTION : Vous devez spécifier l'option Transfert au format texte (ASCII) pour les activités FTP lorsque vous extrayez des fichiers et placez des fichiers texte sur un serveur FTP pour des noeuds finaux qui manipulent des données texte en transférant des données depuis et vers le noeud final FTP en mode ASCII. Par exemple, les noeuds finaux FTP de grand système et DOS manipulent les données ASCII lorsqu'ils transmettent des données en mode ASCII. Par exemple, si votre orchestration extrait des fichiers ASCII à l'aide de l'activité FTP Interroger répertoire et place les fichiers ASCII, à l'aide de l'activité FTP Placer fichier, sur un serveur FTP de grand système, vous devez spécifier les options des tâches suivantes dans
Studio :
|
Après la lecture du fichier | Le supprimer - Supprimez le fichier après la lecture. Le déplacer dans le répertoire - Déplacez le fichier dans le répertoire indiqué, une fois qu'il a été lu. Indiquez le répertoire vers lequel est déplacé le fichier en phase d'exécution à l'aide de l'une des options suivantes :
Avertissement : Indiquez le séparateur de répertoire après le dernier nom de répertoire affiché. Par exemple, pour déplacer un fichier vers le répertoire processed/acme dans un chemin relatif, spécifiez le répertoire suivant dans la zone Le déplacer dans le répertoire : processed/acme/
Facultatif - Indiquez le format du nom de fichier après l'avoir renommé. Dans la liste déroulante Masque, sélectionnez le masque souhaité. Pour spécifier le caractère utilisé pour séparer les sous-zones dans le nom de fichier, entrez un caractère dans la zone Séparateur de masque.
Indiquez le comportement en phase d'exécution lorsqu'un fichier portant le même nom existe :
Remarque : Lors de la première exécution de l'activité FTP Interroger répertoire en phase d'exécution, si l'activité ne peut pas se déplacer vers le fichier car le répertoire cible n'existe pas, un avertissement est consigné (et non une erreur) dans la console de gestion Web et le fichier n'est pas déplacé. Pour toutes les interrogations suivantes, l'activité ne tente pas de déplacer le même fichier et un message d'information est consigné dans la console de gestion Web indiquant que le fichier a déjà été traité.
Conserver à l'emplacement - Conservez le fichier dans le répertoire d'entrée une fois qu'il a été lu. |
Options avancées | Description |
Taille de liste dupliquée | Taille de la liste interne utilisée par le dispositif d'intégration pour savoir quels fichiers ont été interrogés sur le serveur FTP. La valeur par défaut est 10000. Vous devez uniquement spécifier une taille supérieure à la taille par défaut. |
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 Interroger répertoire 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. |
Paramètre de sortie | Description |
---|---|
filename | Fournit le nom du fichier trouvé sur le serveur FTP. |
data | Indique le contenu du fichier. |
timestamp | Fournit la date et l'heure sous forme de chaîne, au format dataType de schéma XML (AAAA-MM-JJhh:mm:ss, où AA représente l'année, MM le mois, JJ le jour, hh le fuseau horaire, mm les minutes et ss les secondes.) Remarque : Si le paramètre de sortie timestamp est mappé dans la tâche Mapper les sorties mais que la fonctionnalité MDTM (renvoie l'horodatage de modification d'un fichier) n'est pas disponible ou n'est pas activée pour le serveur FTP, pendant l'exécution, l'orchestration n'arrête pas le traitement en raison de cette erreur. Un avertissement est généré et la date d'époque (1/1/1970) est renvoyée dans le paramètre de sortie timestamp.
|