Documentation en ligne

Pages d'inspection, des outils de test et de debug

Les pages d'inspection sont des pages spécifiques pour aider à comprendre et à débugguer les formulaires et les workflows.

Journal des erreurs

Chaque fois qu'une erreur est générée, la trace apparaît dans le backoffice (sur la page du workflow et sur la page du formulaire concernés). Ces traces sont aussi envoyées à l'administrateur. Le journal contient un lien vers la page d'inspection de la demande.

Formulaires

Cette page n'est accessible que lorsqu'une demande a été remplie pour le formulaire concerné, il faut donc vérifier au préalable qu'il y a bien une demande.

Pour chaque demande, il est possible, lorsqu'on se trouve dans l'interface de traitement de cette demande, de rajouter « /inspect » à l'url dans la barre d'adresse du navigateur pour accéder à la page de d'inspection de la demande en question. L'URL sera donc du type :

https://{{url-des-demarches}}/backoffice/management/{{nom-du-formulaire}}/{{numero-de-la-demande}}/inspect

Outil de test

Cet outil va vous permettre de tester le résultat de conditions et de gabarit utilisant différentes syntaxes :

  • Condition (Django)
  • Condition (Python)
  • Gabarit / Expression (Django)
  • Gabarit HTML (WYSIWYG)

Cela facilite grandement la compréhension du fonctionnement des conditions.

Liste des variables

Sous l'outil de test, on trouvera :

  • Dans la première colonne : l'ensemble des variables utilisées pour cette demande
  • Dans la deuxième colonne : la valeur de ces variables au moment où on regarde cet écran (et parfois leur type entre parenthèses).

Cet écran permet donc de vérifier la valeur d'une variable à un instant t du traitement et facilite ainsi la recherche et l'identification des problèmes.

Workflows

Les workflows disposent aussi de leur propre page d'inspection même si son fonctionnement est un peu différent.

Pour y accéder il faut rajouter « /inspect » à l'url de la page d'accueil d'un workflow. L'URL sera donc de la forme

https://{{url-des-demarches}}/backoffice/workflows/{{nom-du-workflow}}/inspect
 
L'écran expose, pour chaque étape, la liste des actions qui s'y déroulent, en détaillant un certain nombre de paramètres, en particulier les modèles de mail.

Suppression d'un formulaire en erreur

En cas d'erreur, tel par exemple une référence à une source de donnée inexistante, la page d'accueil du formulaire ne donne plus accès aux commandes de base. Si il est souhaité supprimer ce formulaire, cela est possible en suffixant l'URL avec /delete :
 
https://{{url-des-demarches}}/backoffice/forms/{{numero-du-formulaire}}/delete

Dernière mise à jour le 31 mai 2019 18:03 — Éditer