Règles de placement des fichiers reçus
Où et sous quel nom Filarr range un fichier reçu par la boîte noire : le dossier, le chemin demandé, les règles, le renommage, les doublons, le repli.
Sur cette page
Sections de l’aide
Un fichier reçu par la boîte noire est rangé par votre appli, jamais par la boîte noire ni par Filarr. Les règles se règlent dans Paramètres → Accès API → Fichiers reçus, sur l'accès qui reçoit des fichiers : Règles de placement.
Où vivent les règles
Au trousseau chiffré de votre profil : les mêmes sur tous vos appareils. Elles remplacent le dossier réglé appareil par appareil pour une boîte de dépôt. La première fois, Filarr reprend le dossier que vous aviez choisi sur cet appareil ; si un autre appareil en avait choisi un autre, le premier enregistré gagne, et l'autre appareil vous prévient une fois : « Le dossier de la boîte « Entrées API » est désormais « Comptabilité », réglé sur un autre appareil. »
Ranger automatiquement sur cet appareil reste un choix de chaque appareil.
L'ordre de décision
- Le chemin demandé par le logiciel (
path), si vous l'acceptez : il passe avant les règles, à l'intérieur du dossier seulement. - Les règles par type, dans l'ordre : la première qui correspond gagne ; une règle désactivée est sautée.
- Tout le reste : ce qu'aucune règle n'a pris va dans le Sous-dossier de repli (« À ranger » d'office), où la page « À ranger » vous propose une place apprise.
Sans aucune règle active, et sans chemin demandé accepté, le fichier va dans le dossier lui-même, comme une boîte de dépôt ordinaire.
Une règle
À l'écran, une règle a un nom, des Extensions (.pdf, ou .jpg .png .heic) et un Sous-dossier. Une case l'active ou la désactive ; Monter et Descendre changent son rang ; + Ajouter une règle en crée une autre.
Exemples :
| nom | extensions | sous-dossier |
|---|---|---|
.pdf | Factures/{année}/{mois} | |
| Images | .jpg .png .heic .webp | Photos/{année} |
| Tableurs | .csv .xlsx .ods | Exports |
Vingt règles au plus par boîte. Essayer montre où irait un dépôt imaginaire (Un dépôt arrive, avec path (facultatif)), et pourquoi.
Le format des règles connaît aussi le type du fichier, les étiquettes envoyées par le logiciel et le nom de la clé d'application qui a déposé, mais l'écran ne les propose pas encore.
Les modèles de nom et de chemin
Renommer selon donne le nom du fichier rangé. Un nom ou un sous-dossier peut contenir des jetons, remplacés au rangement. Vous pouvez les écrire en français ou en anglais : Filarr les affiche dans votre langue.
| jeton | en anglais | devient |
|---|---|---|
{nom} | {name} | le nom d'origine, sans extension |
{ext} | {ext} | l'extension, avec son point |
{date} | {date} | la date du dépôt, 2026-10-09 |
{année} {mois} {jour} | {year} {month} {day} | 2026, 10, 09 |
{source} | {source} | la clé d'application (erp) ; link pour un dépôt par lien, email par e-mail |
{étiquette} | {tag} | la première étiquette, ou rien |
{n} | {n} | le numéro du dépôt dans le mois, sur quatre chiffres (0041) |
Exemple : le modèle {date}_{source}_{nom}{ext} range facture-2291.pdf, déposé par la clé erp le 9 octobre 2026, sous le nom 2026-10-09_erp_facture-2291.pdf.
Les dates se comptent dans le fuseau horaire choisi à la création des règles : deux appareils de fuseaux différents rangent au même endroit.
Chaque morceau de chemin est nettoyé comme un nom de fichier : les caractères interdits (< > : " | ? *) et les espaces et points de fin sont retirés, un nom réservé de Windows reçoit un _ devant, et 120 caractères au plus. Un morceau vide disparaît ; huit morceaux au plus. . et .. sont refusés dès l'enregistrement de la règle.
Le chemin demandé par le logiciel
Cochez Accepter le chemin demandé par l'appelant (path), à l'intérieur de ce dossier seulement pour que path soit lu. Il est accepté s'il reste dans le dossier : relatif, sans .., sans / ni \ en tête, sans lettre de lecteur (C:), sans morceau vide, huit morceaux et 200 caractères au plus.
Un chemin qui sort du dossier est refusé : le fichier va dans le repli, et le journal dit « chemin refusé, à ranger ». Le renommage s'applique dans les deux cas.
Les doublons
Un doublon est un fichier de même empreinte qu'un fichier déjà rangé au même endroit. L'empreinte est calculée par la boîte noire, chiffrée avec le fichier, puis vérifiée par votre appli après déchiffrement.
- Ignorer (d'office pour une nouvelle boîte) : le fichier n'est pas rangé une seconde fois, il compte comme rangé, et le journal dit « doublon laissé ».
- Garder les deux (d'office pour une boîte qui existait déjà) : rangé à côté, avec « (1) ».
- Nouvelle version : il devient une nouvelle version du fichier existant.
Sur le web, seuls les fichiers déjà en cache peuvent être comparés ; sinon le fichier est rangé comme s'il n'était pas un doublon.
Un nom déjà pris, sans être un doublon, reçoit « (1) ».
Cliquez sur Enregistrer les règles.