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 permet d’enregistrer la réponse de l’appel dans la variable en question.

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.