Utiliser les balises de gabarit

make_public_url

Génère une URL publique permettant d’accéder à un contenu spécifique, en ajoutant une signature qui autorise l’accès. La signature est liée à la session de l'utilisateur qui n'a pas besoin d'être connecté. Cela ne doit donc pas servir à construire une URL pérenne, pour une écriture dans l'historique d'une demande par exemple.

Exemple d'utilisation :

{% make_public_url url=form_var_document_url %}

Ou (dans une cellule fiche) :

{% make_public_url url=card.fields.document.url %}

 En pratique :

Cette balise est utile pour partager des fichiers ou des ressources d’une fiche depuis une page combo, sans nécessiter une authentification.

temporary_access_url

Génère une adresse d’accès temporaire (URL), sans authentification, à une demande.

Paramètre :

• days, hours, minutes, seconds (facultatif) : Permettent de définir la durée de validité du lien. La durée par défaut est de 30 minutes.
• bypass_checks (facultatif) : Permet de s’affranchir des validations supplémentaires qui sont parfois demandées pour les codes de suivi.

Exemple d'utilisation :

{% temporary_access_url minutes=15 bypass_checks=True %} → génère une URL temporaire valide pendant 15 minutes, permettant d'accéder à une demande sans effectuer les validations habituellement requises lors d'un accès avec un code de suivi.

En pratique :

Cette balise est particulièrement utile pour créer un lien à durée limitée qui peut remplacer un code de suivi pour des accès de courte durée.

token_alphanum

Génère un code aléatoire qui combine des chiffres et des lettres. Par défaut, la balise retourne un code à 4 chiffres et/ou lettres.

Pour éviter toute confusion, les chiffres 0 et 1, ainsi que les lettres O et I, ne sont pas utilisés lors de la génération de ce code.

Paramètre :

• length (facultatif) : Permet de spécifier la longueur du code généré.

Exemple d'utilisation :

{% token_alphanum length=7 %} → génère un code à 7 chiffres et/ou lettres, par exemple : E2RA3XT

En pratique :

Cette balise est utile pour générer des codes aléatoires dans des contextes nécessitant une identification temporaire (ex. : OTP, codes de validation).

Il est ensuite possible d’utiliser le filtre |token_check dans une condition pour vérifier si le token saisi par l’usager correspond à celui qui a été envoyé, sans tenir compte des espaces en début et en fin de chaîne.
Exemple : form_workflow_form_DT_TOKEN_SAISI|token_check:form_var_DT_TOKEN_RECU

token_decimal

Génère un code aléatoire composé de chiffres. Par défaut, la balise retourne un code à 6 chiffres.

Paramètre :

• length (facultatif) : Permet de spécifier la longueur du code généré.

Exemple d'utilisation :

{% token_decimal length=10 %} → génère un code à 10 chiffres, par exemple : 1234567890

webservice

Permet d’appeler un webservice préalablement déclarer; par rapport à la syntaxe {{ webservice.slug }} cette balise permet de passer des variables supplémentaires à l’appel.

Syntaxe :

{% webservice "identifiant" param=... autre_param=... etc. as variable %}

Le premier paramètre est l'identifiant de l’appel webservice (les guillemets sont importants); les pramètres suivants correspondent à des variables supplémentaires qui pourront être utilisées par l’appel, sous la forme {{ parameters.XXX }}, par exemple ici {{ parameters.autre_param }}. L’utilisation de as variable en fin d’expression permet de renseigner le nom de la variable dans laquelle enregistrer la réponse de l’appel; celle-ci est obligatoire pour pouvoir exploiter sans erreur cette syntaxe.

zip

Crée un fichier ZIP contenant un ou plusieurs fichiers. Elle est utile pour regrouper des documents à télécharger ou à transmettre dans un seul fichier compressé.

Syntaxe :

{% zip nom_du_fichier_zip [chemin=fichier_contenu]* %}

• nom_du_fichier_zip : spécifie le nom du fichier ZIP à générer (ex. : "archive.zip" ou une variable contenant ce nom).
• fichier_contenu : définit un fichier ou une liste de fichiers à inclure dans le ZIP. La liste de fichiers peut provenir d'un bloc de champ, la syntaxe sera alors : form_var_BLOC_DE_CHAMP|getlist:"fichier".
• chemin (facultatif) : indique où et comment nommer les fichiers dans le ZIP :
  • lorsqu'un nom de fichier est spécifié (ex. : "dossier/rapport.pdf"), il sera utilisé.
  • pour une liste de fichiers, un suffixe numéroté est ajouté (ex. : rapport-1.pdf, rapport-2.pdf, etc.).
  • lorqu'aucun nom de fichier n'est précisé ou que le chemin se termine par /, les noms d'origine des fichiers sont conservés.

Exemples d'utilisation :

{% zip "archive.zip" demande.pdf=form_var_export_demande piece-jointes/piece.pdf=form_var_bloc|getlist:"fichier" %}

Crée un fichier zip nommé "archive.zip" contenant un fichier "demande.pdf" à sa racine et des fichiers "piece-1.pdf" (puis -2, -3, etc...) dans un sous-répertoire piece-jointes.

{% zip form_var_archive_name =form_var_export_demande|rename_file:form_var_export_demande_name %}

→ si form_var_export_demande_name est pré-rempli avec le gabarit DEMANDE-{{ form_user_display_name|slugify|upper }}.pdf et form_var_archive_name avec DEMANDE-{{ form_number }}.pdf, donnera un fichier .zip nommé DEMANDE-7-1234.zip contenant le fichier DEMANDE-JOHN-DOE.pdf

Et aussi :

L'extension des fichiers est adaptée à leur contenu réel (ex. : un fichier nommé image.pdf contenant une image JPEG sera renommé image.jpg dans le ZIP).
Utilisez le filtre rename_file pour personnaliser dynamiquement les noms des fichiers.