Dematik simplifie la dématérialisation des processus.

La solution permet de générer des formulaires en partant:

• de fichiers yaml pour les libellés
• de simples fichiers texte pour la définition des formulaires

Points forts :

• L'emploi de simples fichiers texte accélère la mise au point de formulaires (copier/coller, ...).
• La relecture des libellés ou encore la définition d'un formulaire devient un jeu d'enfant
• L'approche par bloc pré-packagé permet une homogénéité des formulaires
• L'écriture des conditions est simplifiée. Les conditions sont écrites en français et traduites automatiquement en expression django.
• Tout est en français (message d'erreur, définition du formulaire, conditions, ...)

Points faibles :

• L'écriture d'une condition dont la typologie n'a pas été prévue nécessite le recours à des développements complémentaires
• L'utilisation de types de champs non prévus nécessite la définition de nouveau block ou macro

Dematik nécessite python version 2.7 et pip

pip install git+https://github.com/departement-loire-atlantique/dematik.git

La commande doit être tapé dans un dossier contenant deux sous dossiers :

• Un nommé labels contenant les fichiers YAML des libellés
• Un nommé definitions contenant la definition des formulaires

Génération de tous les processus modifiés :

python -m dematik

Génération de tous les processus, modifiés ou non :

python -m dematik --force

Génération d'un seul processus (ici process/definitions/aide_habitat/pa.def) :

python -m dematik --pattern aide_habitat/pa.def

Génération d'un seul processus (ici process/definitions/aide_habitat/pa.def) en mode mise au point :

python -m dematik --pattern aide_habitat/pa.def --debug

git clone https://github.com/departement-loire-atlantique/dematik
cd dematik
pip install -e .

Validation du programme (éxécution des tests unitaires)

python -m unittest discover

Les contenus textuels des champs sont stockés dans un fichier .yaml stocké dans le dossier process/labels

Exemple :

identifiant: texte sur une ligne

liste:
  Titre de la liste:
    - Elément 1
    - Elément 2

identifiant2: >
  texte sur 
  plusieurs lignes


  laisser deux lignes vides pour démarrer un nouveau paragraphe

texte_enrichi: >
  Titres :
  
  # ceci est un titre 1
  ## ceci est un titre 2
  ### ceci est un titre 3
  #### ceci est un titre 3

  Ceci est en  **gras** (mettre ** avant et après le mot en gras)
  Ceci est en *italique* (mettre * avant et après le mot en italique)

  Pour faire une liste, précéder la phrase de - :
  - élément 1
  - élément 2

Les définitions de formulaires sont stockés dans des fichiers .def stockés dans le dossier process/definitions

Exemple :

formulaire "nom du formulaire" 

    url "url-du-formulaire" 
    description "description du formulaire"
    identifiant "identifiant-du-formulaire"

    workflow "nom du workflow"
    Le paramètre "nom_paramètre" du workflow vaut "valeur"
    Le paramètre "nom_paramètre2" du workflow vaut "valeur2"

    category_id "identifiant-categorie"
    category_name "nom de la catégorie"

    user_roles_id "identifiant-role-utilisateur"
    user_roles_name "nom du rôle de l'utilisateur"

    backoffice_submission_roles_id "identifiant-role-saisie-backoffice"
    backoffice_submission_roles_name "nom du rôle pour la saisie back-office"

    roles_id metadata_roles_id "identifiant-role-destinataire"
    roles_key metadata_roles_key "clé du rôle pour le rôle destinataire"
    roles_name metadata_roles_name "nom du rôle pour le rôle destinataire"

    listing ce_champ_sera_affiche_en_colonne_dans_les_listes
    listing ce_champ_sera_affiche_en_colonne_dans_les_listes

    filter ce_champ_permettra_de_filtrer
    filter ce_champ_permettra_de_filtrer

page nom_page

    liste* ma_liste_obligatoire

    texte mon_texte

    champ_texte beneficiaire:nom

page nom_page_2
    
    titre titre_nom_page_2

    champ_texte mandant:nom

Le nom d'un libellé peut être utilisé simplement ou précédé d'un espace de nommage.

Exemple :

mandant:nom => Espace de nommage = mandant, libellé = nom

Les espaces de nommages permettent d'utiliser le même libellé plusieurs fois sans pour autant créer d'ambiguité lors de leur utilisateur dans une condition.

Pour ajouter un pré-remplissage d'un champ basé sur le profil de l'utilisateur, utiliser la syntaxe suivante :

si condition alors préremplir code_cham avec profil:civilite

ou

préremplir code_cham avec profil:civilite

Liste des codes pour les valeurs dépendant du profil :

• profil:civilite : Civilité
• profil:nom : Nom
• profil:prenom : Prénom
• profil:adresse : Adresse (rue et numéro)
• profil:code_postal : Adresse (code postal)
• profil:commune : Adresse (commune)
• profil:courriel : Courriel
• profil:telephone_mobile : Téléphone mobile
• profil:telephone_fixe : Téléphone fixe

Une condition est de la forme : si CONDITION (et/ou CONDITION) alors ACTION Un action est de la forme : ACTION

Liste des ACTIONs supportées :

• masquer cette page - Doit être associé à une condition
• masquer le champ CHAMP - Doit être associé à une condition
• afficher le message (CHAMP ou VALEUR) - Doit être associé à une condition
• préremplir CHAMP avec (CHAMP ou VALEUR) - Non supporté si associé à une condition
• préremplir CHAMP avec (CHAMP ou VALEUR) - Non supporté si associé à une condition
• lier le champ CHAMP avec les choix issus de l'expression python VALEUR - Non supporté si associé à une condition
• lier le champ CHAMP avec la source de données json (CHAMP ou VALEUR) - Non supporté si associé à une condition
• lier le champ CHAMP avec la source de données jsonp (CHAMP ou VALEUR) - Non supporté si associé à une condition
• lier le champ CHAMP avec la source de données nommée (CHAMP ou VALEUR) - Non supporté si associé à une condition

Liste des CONDITIONs supportées :

• CHAMP est vide

• CHAMP n'est pas vide

• CHAMP est rempli

• CHAMP n'est pas rempli

• CHAMP est coché

• CHAMP n'est pas coché

• moins de N élément(s) de CHAMP sont cochés

• moins de N élément(s) de CHAMP est(sont) coché(s)

• CHAMP est différent de (CHAMP ou VALEUR_ENTIERE)

• CHAMP est égal à (CHAMP ou VALEUR_ENTIERE)

• CHAMP n'est pas égal (CHAMP ou VALEUR_ENTIERE)

• CHAMP est supérieur à (CHAMP ou VALEUR_ENTIERE)

• CHAMP est inférieur à (CHAMP ou VALEUR_ENTIERE)

• CHAMP commence par VALEUR

• CHAMP ne commence pas par VALEUR

• CHAMP contient (CHAMP ou VALEUR_ENTIERE)

• CHAMP ne contient pas (CHAMP ou VALEUR_ENTIERE)

Si vous souhaitez ajouter un nouveau "block", une nouvelle "macro" ou le support de nouvelles "actions" ou "conditions", vous pouvez "forker" ce dépôt et faire un pull request.

Les "blocks" et "macro" sont des templates Jinja2 correspondant à des sections de XML d'un fichier d'export de formulaire WCS.

• Migration vers python 3 lorsque Publik (Module WCS) aura été migré en Python 3
• Dépôt automatique des PyPi
• Paquet conditions, séparer les tokens, les conditions, les actions et l'expression complète (conditions + action)
• Support de nouvelles conditions
• Validation et d'autocomplétion pour les fichiers de définition (éditeur)
• Mise à jour automatique dans une instance publik en ligne de commande