Usage avancé¶
Gestion des noms de fichiers¶
Un chemin de stockage décrit le dossier et le nom sous lesquels NOMA range le fichier d'un document. Il se crée dans le menu Attributs, rubrique Chemins de stockage, et s'écrit sous la forme d'un modèle : un texte qui contient des variables entre doubles accolades.
{{ created_year }}/{{ correspondent }}/{{ title }}
Avec ce modèle, une facture de 2026 émise par « Ma banque » et intitulée
« Relevé janvier » est rangée sous 2026/Ma banque/Relevé janvier.pdf.
À savoir :
- Les barres obliques créent des dossiers.
- L'extension du fichier (
.pdf,.jpg, etc.) est ajoutée automatiquement. - Si deux documents aboutissent au même nom, NOMA ajoute un compteur
(
_01,_02). - Les caractères interdits dans un nom de fichier sont remplacés.
- Le champ Chemin de la fenêtre de création propose un test : choisissez un document pour voir le résultat du modèle avant d'enregistrer.
Variables disponibles¶
| Variable | Signification |
|---|---|
title |
Titre du document |
correspondent |
Nom du correspondant |
document_type |
Nom du type de document |
tag_list |
Liste des étiquettes, séparées par des virgules |
created |
Date de création, au format ISO 8601 |
created_year |
Année de création, sur quatre chiffres |
created_year_short |
Année de création, sur deux chiffres |
created_month |
Mois de création, de 01 à 12 |
created_month_name |
Nom du mois de création |
created_month_name_short |
Nom abrégé du mois de création |
created_day |
Jour de création, de 01 à 31 |
added |
Date d'ajout, au format ISO 8601 |
added_year, added_year_short |
Année d'ajout, sur quatre ou deux chiffres |
added_month, added_month_name, added_month_name_short |
Mois d'ajout : numéro, nom, nom abrégé |
added_day |
Jour d'ajout |
owner_username |
Identifiant du propriétaire |
original_name |
Nom du fichier d'origine, sans extension |
doc_pk |
Numéro interne du document, sur sept chiffres |
Valeurs vides¶
Quand une variable n'a pas de valeur (un document sans correspondant, par
exemple), elle est remplacée par le mot none. Un modèle qui emploie
{{ correspondent }} comme dossier peut donc produire un dossier nommé
none. Pour l'éviter, utilisez une condition (voir ci-dessous).
Modèles conditionnels¶
Les modèles acceptent des conditions if, elif et else, des comparaisons
et des filtres.
{% if document.mime_type == "application/pdf" %}
pdf/{{ created_year }}/{{ title }}
{% else %}
autres/{{ created_year }}/{{ title }}
{% endif %}
L'objet document donne accès aux propriétés du document, par exemple
document.title, document.created, document.mime_type,
document.page_count, document.original_filename, et aux objets liés, par
exemple document.correspondent.name.
Filtres utiles :
slugify: transforme une valeur en segment de chemin simple, sans espaces ni accents, par exemple{{ title | slugify }}.datetime(format): met en forme une date, par exemple{{ created | datetime('%Y-%m') }}.
Attribution d'un chemin de stockage¶
- Un chemin de stockage peut être attribué automatiquement, grâce à son algorithme de rapprochement, ou choisi à la main sur un document.
- Un changement de chemin de stockage sur un document prend effet à l'enregistrement : le fichier est déplacé.
- Un document sans chemin de stockage est rangé sous son numéro interne.
Exemples :
| Chemin de stockage | Modèle |
|---|---|
| Par année | {{ created_year }}/{{ correspondent }}/{{ title }} |
| Assurances | Assurances/{{ correspondent }}/{{ created_year }}-{{ created_month }}-{{ created_day }} {{ title }} |
Précautions¶
- Un modèle très long, notamment avec
tag_list, peut dépasser la longueur de chemin autorisée. Le fichier garde alors son emplacement précédent. - Si un modèle contient une erreur, NOMA revient au rangement par défaut.