Présentation
L’option de sourceignoreFilesBefore ignore les fichiers modifiés avant une date donnée. Elle est utile pour réinitialiser une Datasource à partir d’un dossier qui contient aussi des fichiers plus anciens.
Par exemple, un nouvel export complet peut être déposé à côté d’anciens exports ou deltas, sans déplacer ni supprimer de fichiers. Une nouvelle version de Datasource n’a pas d’historique d’import ; après validation, son premier import lit tous les fichiers correspondant au chemin.
Fonctionnement
L’option s’applique uniquement aux chemins avec wildcard, où* apparaît dans le nom du fichier. Chaque fichier correspondant, daté avant la limite, est ignoré lors de chaque lecture : l’échantillon à la configuration, l’import de validation, le premier import de la nouvelle version et chaque import planifié.
Les fichiers datés à la limite ou après celle-ci suivent les règles habituelles de processType.
Utilisez une date-heure au format ISO 8601. Le fuseau UTC avec Z est recommandé, par exemple 2026-10-08T06:00:00Z.
Une date invalide rejette l’étape configure_sources avec le statut 400 et le message Invalid ignoreFilesBefore date: <value>. Cette validation s’applique aussi aux chemins sans wildcard, pour lesquels une date valide n’a aucun effet.
Date utilisée selon le type de source
La date comparée à la limite dépend du type de source :
File Upload est utile lorsque les fichiers arrivent dans la Datasource via le FTP/SFTP hébergé par Reelevant. Dans ce cas, la date comparée est l’heure de téléversement ; consultez Mise à jour via FTP / SFTP.
Définir la date
Aucun champ de l’interface ne permet de définir cette option. AjoutezignoreFilesBefore aux options existantes de la source dans la requête configure_sources du brouillon, sans modifier les autres options.
Utilisez GET /v2/datasources/{DATASOURCE_ID}/steps pour récupérer les options actuelles de la source. Avant la requête, définissez :
Cet exemple configure une source File Upload alimentée par FTP. Remplacez les valeurs fictives par le bucket, l’ID de société, le dossier, l’objet format et l’encodage du texte des options actuelles :
validate du brouillon. Consultez l’import dans les logs de la Datasource.
Choisir la date
Définissez la limite juste avant le téléversement du nouvel export complet, par exemple quelques minutes plus tôt. Pour File Upload,processType n’est pas utilisé. Pour lire l’export complet et chaque delta suivant, la Datasource doit utiliser le mode de mise à jour Keep Previous Data. Avec tout autre mode de mise à jour, chaque import ne lit que le fichier le plus récent.
Pour FTP, SFTP, Amazon S3 et Google Cloud Storage, utilisez "processType": "all_unprocess" pour lire l’export complet et chaque delta suivant. Avec la valeur par défaut last_unprocess, chaque import lit uniquement le fichier non traité le plus récent.
Consultez les sections sur les modes de traitement des pages FTP/SFTP, Amazon S3 et Google Cloud Storage.
Conservez ignoreFilesBefore après la réinitialisation. L’option continue d’exclure les anciens fichiers des imports suivants.