Accéder au contenu principal Passer au contenu complémentaire

cFile

Ce composant offre un accès aux systèmes de fichiers, pour traiter des fichiers ou des messages par d'autres composants à sauvegarder sur le disque.

Pour plus d'informations, consultez la documentation Apache Camel https://camel.apache.org/components/latest/ (en anglais).

Propriétés du cFile Standard

Ces propriétés sont utilisées pour configurer le cFile s'exécutant dans le framework de Jobs Standard.

Le composant cFile Standard appartient à la famille Connectivity.

Note InformationsRemarque : Les propriétés du cFile ont été mises à jour dans la version R2026-01. Pour disposer de toutes les propriétés des tableaux suivants, vous devez installer la version de mise à jour mensuelle R2026-01 du Studio Talend ou une plus récente fournie par Talend. Pour plus d'informations, contactez votre administrateur ou administratrice.

Basic settings

Propriétés Description

Path

Chemin d'accès au(x) fichier(s) au(x)quel(s) accéder ou à sauvegarder.

Les options suivantes sont disponibles lorsque le composant cFile est utilisé comme consommateur :

 
Parameters/noop

Une fois cette option est activée, le fichier n'est ni déplacé, ni supprimé.

Parameters/recursive Lorsque cette option est activée, les fichiers de tous les sous-répertoires sont également consommés.
Parameters/readlock
Lorsque cette option est activée, le fichier est consommé uniquement si ses autorisations sont exclusivement lecture/verrouillage. Sélectionnez la stratégie parmi les suivantes :
  • none : aucun verrouillage de lecture n'est utilisé.
  • markerFile : un fichier marqueur est créé et un verrou est appliqué sur le fichier.
  • fileLock : stratégie pour utiliser java.nio.channels.FileLock. Cette approche doit être évitée lors de l'accès à un système de fichiers distant via montage/partage, sauf ce système de fichiers supporte les verrous de fichiers distribués.
  • rename : stratégie tentant de renommer le fichier comme test si un verrouillage exclusif de lecture peut être obtenu.
  • idempotent : stratégie permettant l'utilisation de idempotentRepository comme verrouillage de lecture. Cela vous permet d'utiliser les verrouillages de lecture si l'implémentation du référentiel supporte le clustering.
  • idempotent-changed : stratégie permettant l'utilisation de idempotentRepository et modification comme verrouillage combiné de lecture. Cela vous permet d'utiliser les verrouillages de lecture si l'implémentation du référentiel supporte le clustering.
  • idempotent-rename : stratégie permettant l'utilisation de idempotentRepository et renommage comme verrouillage combiné de lecture. Cela vous permet d'utiliser les verrouillages de lecture si l'implémentation du référentiel supporte le clustering.
Parameters/doneFileName

Nom d'un fichier marqueur (fichier terminé) signalant qu'un fichier est terminé et prêt à être consommé. Si ce nom est fourni, le fichier sera consommé uniquement si un fichier terminé existe. Le fichier terminé est toujours attendu dans le même dossier que le fichier d'origine.

Filter Sélectionnez un filtre pour les fichiers à consommer, parmi les suivants :
  • fileName : filtre les fichiers en fonction du nom de fichier. Spécifiez le nom du fichier dans le champ fileName.
  • Ant : Filtre les fichiers en se basant sur le style Ant. Spécifiez les critères d'inclusion et d'exclusion, respectivement. Cochez la case case sensitive pour activer le rapprochement sensible à la casse. Vous pouvez spécifier plusieurs inclusions et exclusions, si vous les séparez par une virgule. Si vous utilisez l'inclusion et l'exclusion, l'exclusion est prioritaire sur l'inclusion.
  • Regex : filtre les fichiers en fonction du modèle regex. Spécifiez les critères d'inclusion et d'exclusion, respectivement. Le rapprochement n'est pas sensible à la casse.
  • fileName Extention : filtre les fichiers en fonction de l'extension du fichier. Spécifiez les critères d'inclusion et d'exclusion, respectivement. Le rapprochement n'est pas sensible à la casse. Vous pouvez spécifier plusieurs extensions, si vous les séparez par une virgule.
move/success

Cette option vous permet de déplacer les fichiers qui ont bien été consommés vers un autre emplacement. Saisissez le dossier vers lequel déplacer les fichiers qui ont bien été consommés. Par exemple, pour déplacer des fichiers dans un sous-répertoire .done, saisissez ".done".

move/failed

Cette option vous permet de déplacer les fichiers qui ne peuvent être consommés correctement vers un autre emplacement. Saisissez le dossier vers lequel déplacer les fichiers qui n'ont pas pu être consommés correctement.

move/delete file

Cochez cette case pour supprimer le fichier une fois qu'il a bien été consommé.

Les options suivantes sont disponibles lorsque le composant cFile est utilisé comme producteur :

 
Filename Nom du fichier à écrire.
Parameters/fileExist
Sélectionnez dans la liste l'opération à effectuer si un fichier du nom spécifié dans le champ FileName existe déjà :
  • Override : remplacer le fichier existant.
  • Append : ajouter du contenu au fichier existant.
  • Fail : retourner une exception GenericFileOperationException, indiquant qu'un fichier existe déjà.
  • Ignore : ignorer le problème de manière silencieuse et ne pas écraser le fichier existant.
  • Move : déplacer tout fichier existant vers un dossier cible avant d'écrire le fichier. Spécifiez le dossier cible de votre choix dans le champ move/exisiting.
  • TryRename : essayer de renommer le fichier sans vérification préalable.
Parameters/doneFileName

Nom d'un fichier marqueur (fichier terminé) à signaler lorsque le fichier d'origine a été écrit. S'il est fourni, un fichier terminé sera écrit. Le fichier terminé sera vide et toujours écrit dans le même dossier que le fichier d'origine.

Advanced settings

Propriétés Description

Parameters/AutoCreate

Cochez cette case pour créer automatiquement le répertoire spécifié dans le champ Path s'il n'existe pas.
Parameters/Encoding Sélectionnez l'encodage du fichier, ISO-8859-15, UTF-8 ou CUSTOM.
Advanced Configurez les arguments facultatifs dans la table correspondante. Cliquez sur le bouton [+] autant de fois que nécessaire afin d'ajouter les arguments au tableau. Dans le champ Name, vous pouvez sélectionner l'option URI dans la liste déroulante ou saisir un nom d'option qui n'est pas disponible dans la liste. Cliquez dans le champ Value correspondant et saisissez une valeur. Consultez le site http://camel.apache.org/file2.html (en anglais) pour voir les options d'URI disponibles.

Les options suivantes sont disponibles uniquement lorsque le composant cFile est utilisé comme producteur :

 

Parameters/Flatten

Cochez cette case pour supprimer le nom des sous-répertoires dans le chemin d'accès au fichier. Cela vous permet de produire de manière récursive dans les sous-répertoires, mais quand vous écrivez, par exemple, les fichiers dans un autre répertoire, ils seront écrits dans un seul répertoire.

Parameters/BufferSize(kb)

Saisissez la taille de la mémoire tampon, en kilooctets.

Utilisation

Conseils d'utilisation Description

Règle d'utilisation

Le composant cFile peut être un composant de début, un composant intermédiaire ou un composant de fin dans une Route.

Limitation

 n/a

Cette page vous a-t-elle aidé ?

Si vous rencontrez des problèmes sur cette page ou dans son contenu – une faute de frappe, une étape manquante ou une erreur technique – faites-le-nous savoir.