Aller au contenu

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.