Lire un fichier |
L'action Lire un fichier recherche un certain type de fichier dans un dossier spécifié, lit les données contenues dans le fichier, puis enregistre les données dans une variable.
Vous pouvez configurer les propriétés de l'action Lire un fichier dans les onglets suivants.
Source
Emplacement : Indique le système de fichiers dans lequel existe le dossier source. Les systèmes ou emplacements de fichiers peuvent comprendre des systèmes de fichiers locaux ou sur réseau, Librarian, voire un emplacement de stockage sur le cloud. Pour en savoir plus sur les emplacements de stockage cloud pris en charge, consultez Administration Console
Nom du fichier : Indique le fichier à partir duquel l'action est lue. Vous pouvez saisir l’emplacement du dossier et le nom du fichier ou cliquer sur Parcourir pour trouver, puis sélectionner le fichier que vous souhaitez. Autrement, vous pouvez ajouter une variable pour définir le fichier de votre choix ou ajouter un caractère spécial à la valeur que vous saisissez.
|
Si vous avez cliqué pour sélectionner Attendre que le fichier arrive dans Détection de fichier (voir ci-dessous), l'option Nom du fichier change en fonction de l'option Dossier à explorer. |
Dossier à explorer : Indique l'emplacement du dossier où vous voulez que l’action recherche les fichiers. Vous pouvez saisir l'emplacement du dossier ou cliquer sur Parcourir pour localiser et sélectionner le dossier souhaité. Autrement, vous pouvez ajouter une variable pour définir le dossier à analyser ou ajouter un caractère spécial à la valeur saisie. Disponible lorsque vous cliquez pour cocher la case Attendre que le fichier arrive sous Détection de fichier.
Analyser les dossiers enfants : Spécifie que l'action surveille également tous les sous-dossiers du dossier spécifié par la propriété Dossier à explorer.
Codage de fichier : Indique la méthode qui est utilisée pour coder le fichier lu.
Format de contenu de fichier : Indique le type de contenu de fichier. L’action traite le contenu du fichier selon ce format.
Les données sont contenues dans un message SOAP : Lorsque cette option est activée, l'action s'attend à ce que les données soient contenues dans un message SOAP.
Délai de fichier verrouillé : Indique combien de temps il est possible de tenter d'ouvrir un fichier verrouillé par une autre application.
Détection de fichier
Attendre que le fichier arrive : Spécifie que l'action attend que le fichier arrive s'il n'existe pas déjà dans le dossier.
|
Les options de détection de fichier sont disponibles uniquement quand vous cliquez pour cocher la case Attendre que le fichier arrive. |
Options de détection
Méthode d'exploration : Définit la méthode que l’action utilise pour contrôler l'arrivée du fichier indiqué dans le dossier à explorer.
Notification et scrutation : Indique que l’action contrôle le dossier à explorer en continu en plus de l'explorer à des intervalles réguliers. Cette option est utile si vous doutez de la fiabilité de votre système de fichiers. Si un balayage continu a manqué un événement, un balayage par sondage permettrait de s'assurer qu'il a été détecté. Lorsque vous sélectionnez cette option, vous pouvez définir l'intervalle de scrutation en millisecondes, secondes, minutes ou heures.
Notifications uniquement : Indique que l’action surveille le dossier à explorer en continu.
Scrutation uniquement : Indique que l’action surveille le dossier à des intervalles réguliers. Lorsque vous sélectionnez cette option, vous pouvez définir l'intervalle de scrutation en millisecondes, secondes, minutes ou heures.
Intervalle de scrutation : Indique la fréquence à laquelle l'action recherche le fichier. Disponible lorsque Notification et scrutation ou Scrutation uniquement est sélectionné pour la Méthode d'exploration.
Modèle de fichier :Indique le filtre que l'action utilise pour identifier le fichier sur lequel vous voulez que l'action soit exécutée. Ce filtre peut inclure des caractères génériques (tels que ? et *) ou des expressions régulières (telles que (?i)^.*\.csv$). Cliquez sur pour visualiser une liste de modificateurs d'expression régulière ou de caractère générique, puis cliquez sur celui que vous souhaitez pour l'ajouter. Vous pouvez aussi ajouter une variable qui définit le modèle de fichier ou ajouter un caractère spécial à la valeur saisie.
Utiliser une expression régulière : Indique que l’action utilise des expressions régulières pour identifier le modèle de fichier.Lorsque vous sélectionnez cette option, vous pouvez ajouter des modificateurs d'expression régulière à la propriété précédente pour mieux contrôler les critères de recherche.
Taille de fichier minimum : Indique la taille minimum qu'un fichier doit avoir pour que l'action l’accepte en tant que fichier source.
Taille de fichier maximum : Indique la taille maximum qu'un fichier ne doit pas dépasser pour être accepté comme fichier source par l’action.
Temps d'inactivité de fichier : Indique la durée maximale d’inactivité d'un fichier dans le dossier spécifié pour que l'action puisse encore être acceptée comme fichier source. La durée maximale d’inactivité peut être définie en millisecondes, secondes, minutes ou heures et elle est comparée au paramètre « LastModifiedTime » du fichier.
Ordre de tri de plusieurs fichiers
Définit l'ordre dans lequel l’action traite les fichiers contenus dans le dossier indiqué lorsque plusieurs fichiers répondent au modèle de fichier spécifié. Si aucun ordre n'est spécifié sur la page de propriétés, le processus de tri se fait par défaut selon l'heure de création (ordre croissant), puis selon le nom de fichier (ordre croissant). Vous pouvez définir jusqu’à quatre critères.
Ordre : Affiche l'ordre dans lequel les critères de tri sont appliqués aux fichiers correspondants contenus dans le dossier indiqué.
Champ de tri : Définit le critère à appliquer aux fichiers correspondants.
Direction : Définit si l'ordre croissant ou décroissant est utilisé pour l'application du critère de tri aux fichiers correspondants.
Ajouter des critères de tri : Définit des critères de tri supplémentaires.
Sortie
Enregistrer le contenu du fichier dans la variable : Indique la variable dans laquelle vous souhaitez enregistrer le contenu du fichier. Saisissez la variable dans la zone de saisie. Autrement, vous pouvez aussi ajouter une variable.
Action
Nom : Indique le nom de l'action. Vous pouvez remplacer le nom par défaut en saisissant un nouveau nom dans le champ.
Description : Présente une description de l’action.
Exécuter une action : Indique la fréquence à laquelle l'action est exécutée.
Toujours : Indique que l'action s'exécute chaque fois que le fichier de processus est exécuté.
Jamais : Indique que l'action ne s'exécute pas lorsque le fichier de processus est exécuté.
Sous conditions, en fonction de la variable : Indique que l'action est uniquement exécutée lorsqu’une variable sélectionnée répond à une condition spécifiée. Utiliser cette option dans les situations où une seule condition détermine l'exécution de l'action. Après avoir sélectionné cette option, vous pouvez créer l'instruction conditionnelle dans la zone de saisie.
Variable : Indique la variable que vous souhaitez utiliser pour l'instruction conditionnelle. Saisissez la variable dans la zone de saisie. Cliquez sur pour voir une liste des variables récemment utilisées ou cliquez surVariable ou sur Plus de variables pour ouvrir la boîte de dialogue Insérer une variable.
[Opérateur relationnel]: Définit l'opérateur relationnel à utiliser pour l'énoncé conditionnel. Cliquez sur l'opérateur existant pour afficher une liste contenant d'autres opérateurs, puis cliquez sur celui que vous souhaitez utiliser. Pour en savoir plus, reportez-vous à la rubrique Opérateurs relationnels. Les opérateurs qui sont disponibles dans la liste dépendent de si vous avez sélectionné Texte ou Décimal pour l'option Type.
Valeur : Définit les valeurs à utiliser pour l'instruction conditionnelle. Pour ajouter une valeur, cliquez sur , cliquez sur <saisir une valeur>, saisissez la valeur souhaitée, puis appuyez sur Enter
. Pour supprimer une valeur, utilisez le bouton secondaire de la souris pour cliquer dessus, puis cliquez sur Supprimer. Pour certains opérateurs, par exemple Est vide et N'est pas vide, il n'est pas nécessaire de définir de valeur. Dans ces cas, le champ Valeur n'est pas disponible.
Type : Indique si l'énoncé conditionnel évalue un texte ou une valeur décimale.
Sous conditions, en fonction de l'expression : Spécifie les conditions dans lesquelles l'action est exécutée. Utilisez cette option pour les situations nécessitant plusieurs énoncés conditionnels. Lorsque vous sélectionnez cette option, vous pouvez créer l'instruction conditionnelle dans la zone de saisie en créant les instructions conditionnelles de votre choix. Vous pouvez créer et éditer l'expression conditionnelle dans l'onglet Vue arborescente. Cliquez sur l'onglet Vue arborescente pour afficher une vue en lecture seule de l'expression conditionnelle.
Contrôles de zone de saisie (onglet Vue arborescente)
[Opérateur conditionnel]: Définit l'opérateur conditionnel pour les énoncés conditionnels du groupe. L'opérateur conditionnel par défaut est And.
Cliquez sur l'opérateur conditionnel existant pour afficher un menu permettant de configurer votre expression conditionnelle d'une des manières suivantes :
And, Or, NotAnd, NotOr : Cliquez sur l'opérateur conditionnel que vous souhaitez utiliser pour les instructions conditionnelles. Pour en savoir plus sur les opérateurs conditionnels pris en charge, consulter Opérateurs conditionnels.
Ajouter une condition : Cliquez pour ajouter un autre énoncé conditionnel au groupe actuel.
Ajouter groupe : Cliquez pour ajouter un sous-groupe d'instructions conditionnelles au groupe actuel.
Supprimer le groupe : Cliquez sur pour supprimer le sous-groupe. Disponible lorsque vous ouvrez le menu à partir d'un sous-groupe.
Tout supprimer : Cliquez pour supprimer tous les énoncés conditionnels (y compris les sous-groupes). Disponible lorsque vous ouvrez le menu à partir du groupe supérieur.
: Cliquez pour ajouter une instruction conditionnelle au groupe associé à cet opérateur. Visible à droite de chaque opérateur conditionnel de votre expression.
: Cliquez pour supprimer l'énoncé conditionnel. Visible à droite d'une instruction conditionnelle existante lorsque vous pointez sur l'instruction.
Variable : Indique la variable que vous souhaitez utiliser pour l'instruction conditionnelle. Saisissez la variable dans la zone de saisie. Cliquez sur pour voir une liste des variables récemment utilisées ou cliquez surVariable ou sur Plus de variables pour ouvrir la boîte de dialogue Insérer une variable.
[Opérateur relationnel]: Définit l'opérateur relationnel à utiliser pour l'énoncé conditionnel. Cliquez sur l'opérateur existant pour afficher une liste contenant d'autres opérateurs, puis cliquez sur celui que vous souhaitez utiliser. Pour en savoir plus, reportez-vous à la rubrique Opérateurs relationnels. Les opérateurs qui sont disponibles dans la liste dépendent de si vous avez sélectionné Texte ou Décimal pour l'option Type.
Valeur : Définit les valeurs à utiliser pour l'instruction conditionnelle. Pour ajouter une valeur, cliquez sur , cliquez sur <saisir une valeur>, saisissez la valeur souhaitée, puis appuyez sur Enter
. Pour supprimer une valeur, utilisez le bouton secondaire de la souris pour cliquer dessus, puis cliquez sur Supprimer. Pour certains opérateurs, par exemple Est vide et N'est pas vide, il n'est pas nécessaire de définir de valeur. Dans ces cas, le champ Valeur n'est pas disponible.
Type : Indique si l'énoncé conditionnel évalue un texte ou une valeur décimale.
Paramètres de connexion
Hériter de l'action parente : Indique que l'action hérite des identifiants de compte utilisateur qui sont définis sur l’onglet de propriétés Actions. Autrement, si l'action fait partie d'une action Grouper, elle hérite des identifiants de compte utilisateur qui sont définis sur la page de propriétés Grouper de l'action parente directe.
Spécifier les identifiants d'utilisateur : Indique que l'action s'exécute en utilisant les identifiants qui sont spécifiés.
Erreur de traitement et diagnostic
Ignorer les erreurs et continuer à exécuter les actions : Indique que lorsque cette option échoue, les autres actions continueront à être exécutées. Si elle n’est pas sélectionnée et que l'action échoue, le comportement résultant dépend de plusieurs facteurs, comme suit :
L'action s'inscrit dans une action du Groupe
Si vous avez spécifié De manière séquentielle pour la propriété Exécuter les actions sur l’onglet Exécution du Groupe, aucune autre action n'est exécutée dans cette action de groupe. Aucune action en dehors de cette action du Groupe n'est affectée.
Si vous avez spécifié En parallèle pour la propriété Exécuter les actions sur l’onglet Exécution du Groupe, les erreurs sont ignorées et les autres actions dans ce Groupe sont exécutées. Aucune action en dehors de cette action du Groupe n'est affectée.
L'action ne s'inscrit pas dans une action du Groupe
Si vous avez spécifié De manière séquentielle pour la propriété Exécuter les actions sur l’onglet Exécution de l'Action, aucune autre action dans le processus n'est exécutée.
Si vous avez spécifié En parallèle pour la propriété Exécuter les actions sur l’onglet Exécution de l'Action, les erreurs sont ignorées et les autres actions dans le processus sont exécutées.
Réessayer en cas d'échec : Indique que si l'action échoue, Integration Service tente de l'exécuter à nouveau.
Nombre maximum de nouvelles tentatives : Indique le nombre maximum de tentatives de réexécution de l'action par Integration Service. Disponible lorsque l'option Réessayer en cas d'échec est sélectionnée.
Intervalle de nouvelles tentatives : Indique le temps d'attente d’Integration Service après l'échec de l'action avant de tenter sa réexécution. Disponible lorsque l'option Réessayer en cas d'échec est sélectionnée.