Documentation en ligne

Paramétrage avancé

Affichage expérimental : la cellule Prototype JSON

Une cellule prototype JSON n'est pas conçue pour être exploitée en production. Il est possible en revanche de s'en servir de modèle pour développer une cellule combo spécifique utilisable en production.
Construisez une vue personnalisée sur la fiche concernée, elle doit être visible par tous.
Dans la cellule Combo utilisez l'URL :
https://URL-DES-DEMARCHES/api/cards/SLUG-DE-LA-FICHE/list/SLUG-DE-LA-VUE?email=EMAIL-UTILISATEUR-AUTORISÉ
Mettez <pre>{{json|pprint}}</pre> dans le corps de la cellule pour afficher l'ensemble de la réponse JSON
Parsez le JSON en utilisant du HTML pour afficher et mettre en forme uniquement les informations que vous souhaitez afficher dans la cellule (et supprimez <pre>{{json|pprint}}</pre> une fois que c'est fait).

Faire un moteur de recherche sur un modèle de fiche

La cellule recherche de combo peut être configurée pour chercher :

  • des usagers
  • et/ou des codes de suivi
  • et/ou des pages
  • et/ou des demandes.

De la même façon cette cellule, peut être utilisée pour chercher des fiches en plus ou à la place des éléments précités. Pour cela vous devez, dans cet ordre :

  1. Créer une page dédiée dans combo qui aura pour « Expression de sous-page » : fiche_id. « Expression de sous-page » est accessible quand on modifie le slug de la page (barre latérale).
    Remplacer fiche_id par le slug du modèle de fiche, par exemple si le modèle de fiche a pour identifiant lieu-ecole, il faut mettre lieu-ecole_id
  2. Configurer l'option redirection de la page pour qu'elle pointe vers {{eservices_url}}backoffice/data/MODELE-DE-FICHE/{{MODELE_DE_FICHE_id}}/
    À la place de MODELE_DE_FICHE_id, si le modèle de fiche a pour identifiant lieu-ecole, mettre lieu_ecole_id (attention au premier underscore).
  3.  Configurer une cellule recherche pour qu'elle utilise cette page. Dans l'écran de configuration de la cellule, en face de  « Ajouter : », cliquer sur le nom de la page que vous venez de configurer.

Lier un usager à une fiche

Il est fréquemment utile de lier une fiche particulière, contenant des informations métier, à un usager (à un compte) dans Publik. Le but étant :
  • de pouvoir donner à cet usager des droits particuliers pour voir / modifier la fiche en question,
  • de permettre aux agents habilités de voir immédiatement les informations métier liées à tel ou tel usager.
Pour pouvoir lier des usagers à des fiches, il est nécessaire d'activer dans le modèle de fiche « Lien avec un usager » (en choisissant « Optionnel »).
Une fois fait, on dispose lors de la création ou de la modification de chaque fiche d'une liste déroulante des utilisateurs en barre latérale, elle permet de choisir l'usager que l'on souhaite associer à la fiche.
Lorsqu'une fiche est liée à un usager, le filtre |filter_by_user pourra être utilisé. Par exemple dans une cellule « Contenu d'une fiche », on pourra récupérer l'identifiant d'une fiche grâce à une expression du type :
{% load wcs %} {{ cards|objects:"enfant"|filter_by_user:request.user|first|get:"id"}}
|filter_by_user:considered_user peut-être utilisé dans les formulaires/fiches pour désigner le demandeur et pas la personne connectée (pour un usage backoffice).

Construire une couche cartographique avec des fiches

Pour construire une couche cartographique basée sur des fiches, vous devez concevoir un modèle de fiche avec :
 Vous pourrez alors utiliser une URL de ce type comme couche cartographique dans combo :
{{eservices_url}}api/cards/IDENTIFIANT-MODELE-DE-FICHE/geojson?1=on&3=on&4=on&5=on
 Cette couche cartographique sera ensuite utilisable pour afficher une carte sur le portail via une cellule carte.

 
 

Dernière mise à jour le 9 février 2021 14:55 — Éditer