Project

General

Profile

Documentation #99970

étendre la documentation sur l'utilisation des fiches depuis combo (|include_fields etc.)

Added by Frédéric Péters 4 months ago. Updated 12 days ago.

Status:
Nouveau
Priority:
Normal
Category:
-
Target version:
-
Start date:
17 December 2024
Due date:
% Done:

0%

Estimated time:
Patch proposed:
No
Planning:
No
Club:
No

Description

Les filtres qui contrôlent les données récupérées (|include_fields, |include_evolution, |include_roles, |include_submission, |include_workflow, |include_workflow_data) mais aussi la structure des données reçues (les données des champs sous une clé "fields" par exemple), et les différences par rapport à ce qui est possible dans w.c.s. (par exemple |get:"champ" vs |get:"form_var_champ").

Peut-être dans la page "Paramétrage avancé des fiches" https://doc-publik.entrouvert.com/admin-fonctionnel/developper-des-applications-simples-avec/parametrage-avance-des-fiches/

History

#6

Updated by Anaïs Ecuvillon 4 months ago

  • Assignee set to Anaïs Ecuvillon

Je documenterai prochainement

#9

Updated by Mikaël Ates 4 months ago

Je lis #96743 et #96743 au cas où il y ait au passage à clarifier les questions d'accès aux données.

#11

Updated by Clément Serale 2 months ago

Je propose d'amender la page https://doc-publik.entrouvert.com/admin-fonctionnel/parametrage-avance/utiliser-les-filtres-de-requete/ avec les filtres de requête spécifique combo :

Une ébauche de texte :

Utilisation des filtres de requête dans combo

L'utilisation des filtres de requête dans combo est un peu différente que dans w.c.s. En effet par défaut combo n'a pas accès à toutes les informations des formulaires et fiches. Il faut donc lui dire dans la requête de rendre disponible ces informations. Typiquement cela se traduit par l'utilisation des filtres "include_fields", "include_workflow" et get|"fields".

Voici un exemple d'une requête dans combo pour récupérer le champ "form_var_nom" d'une fiche. Le modèle de fiche ciblé par la requête est lié à la page combo, ce qui permet d'obtenir la variable "fiche_id" :

{{ cards|objects:"id_modele_fiche"|include_fields|filter_by:"internal_id"|filter_value:fiche_id|first|get:"fields"|get:"nom" }}
#12

Updated by Anaïs Ecuvillon 2 months ago

  • Assignee changed from Anaïs Ecuvillon to Clément Serale

oui je te passe la main avec plaisir,

#13

Updated by Stéphane Laget 2 months ago

Bonne idée.

Pas sûr de la syntaxe

|filter_by:"internal_id" 

plutôt utiliser

|filter_by_internal_id:xxx (si ok dans combo ?)

ton exemple mérite un peu + d'explications car il fait référence à fiche_id (ce qui suppose d'avoir préalablement lié la page combo à un modèle de fiches nommé "fiche").

#14

Updated by Stéphane Laget 2 months ago

... Et donc la doc me dit que

C'est équivalent à |filter_by:"internal_id"|filter_value:xxx.

(les deux fonctionneraient)

#15

Updated by Clément Serale 12 days ago

ton exemple mérite un peu + d'explications car il fait référence à fiche_id (ce qui suppose d'avoir préalablement lié la page combo à un modèle de fiches nommé "fiche").

C'est mentionné mais effectivement il faudrait ajouter un lien vers la documentation qui explique cela :

Utilisation des filtres de requête dans combo

L'utilisation des filtres de requête dans combo est un peu différente que dans w.c.s. En effet par défaut combo n'a pas accès à toutes les informations des formulaires et fiches. Il faut donc lui dire dans la requête de rendre disponible ces informations. Typiquement cela se traduit par l'utilisation des filtres "include_fields", "include_workflow" et get|"fields".

Voici un exemple d'une requête dans combo pour récupérer le champ "form_var_nom" d'une fiche. Le modèle de fiche ciblé par la requête est lié à la page combo (https://doc-publik.entrouvert.com/admin-fonctionnel/developper-des-applications-simples-avec/parametrage-avance-des-fiches/#lier-un-modele-de-fiche-a-une-page), ce qui permet d'obtenir la variable "fiche_id" :

{{ cards|objects:"id_modele_fiche"|include_fields|filter_by:"internal_id"|filter_value:fiche_id|first|get:"fields"|get:"nom" }}

Also available in: Atom PDF