Le plugin struct supporte l'intégration avec l'extension Bureaucracy. Cela permet de réutiliser les mécanismes d'entrée des différents types dans les formulaires Bureaucracy et la création de données structurées lorsque les pages sont créées à l'aide de l'action de modèle Bureaucracy ou en les sauvegardant dans des schémas de consultation.

Vous pouvez utiliser n'importe quel champ de n'importe quel schéma défini comme un champ dans un formulaire Bureaucracy. Pour ce faire, utilisez simplement le type struct_field et spécifiez le nom du champ sous la forme <schema>.<name>.

<form>
Action template templates:product product :
struct_field "products.product" @
submit "Create new product"
</form>

Le label défini (traduit) sera automatiquement utilisé pour le champ ainsi que toutes les règles de validation configurées dans le schéma.

Vous pouvez utiliser la valeur saisie dans un champ struct comme n'importe quelle autre valeur pour le modèle. Par exemple, vous pouvez utiliser @@products.product@@ pour accéder à la valeur de l'exemple ci-dessus.

Toutes les valeurs de struct seront assignées aux pages résultantes à l'aide de l'action de modèle (quand vous utilisez le modèle d'action de Bureaucracy), à ​​condition que les assignations de schéma correspondent.

Au lieu d'ajouter des champs individuels à un formulaire de bureaucracry comme décrit ci-dessus, vous pouvez également ajouter un schéma entier au formulaire. Pour ce faire, utilisez simplement la commande struct_schema.

<form>
Action template templates:product product :
textbox name @
struct_schema "products" !
submit "Create new product"
</form>

Veuillez noter que tous les paramètres additionnels donnés seront ajoutés à chaque champ individuel. Par exemple, vous ne pouvez uniquement rendre obligatoires ou facultatifs tous les champs du schéma.

De cette façon, vous ne pouvez pas utiliser @ pour marquer les champs à utiliser comme noms de page. Pour utiliser un champ du schéma struct comme nom de page, vous pouvez le définir avec la syntaxe de Bureaucracy @@ et le nom complet du champ struct, par exemple products.product dans la [destination]. Le [séparateur] : n'est donc pas nécessaire.

<form>
Action template templates:product destination:@@products.product@@
textbox name @
struct_schema "products" !
submit "Create new product"
</form>

Pour le moment, il n'est pas possible d'utiliser des champs pré-remplis comme modèles dans les fieldset de Bureaucracy.

Vous pouvez sauvegarder les données de formulaires Bureaucracy dans des schémas de consultation en utilisant struct_lookup dans l'action du formulaire. Pour ce faire, ajoutez action struct_lookup et les champs souhaités du schéma de consultation en utilisant struct_field ou struct_schema. Par exemple :

<form>
action struct_lookup
struct_field "someschema.name"
submit "Save into lookup"
</form>

Vous pouvez pré-remplir les champs en ajoutant un = après le nom du champ. Vous devez pré-remplir avec des données stockées dans la base de données, et non avec ce que vous obtenez lorsque la table ou la page est affichée (par exemple, les dates sont au format Y-m-d indépendamment de votre lieu). Lorsque vous définissez un champ Text, utilisez "=votre text", pour une date, utilisez =2020-01-01 ou des variables simples comme =%Y-%m-%d. Pour les champs type lookup (recherche) sur les schémas de pages, vous devez configurer l'espace de noms complet à la cible (par exemple "=[""ns:ns1:ns2:page"",0] "). Pour les champs de recherche dans les schémas de consultation¹⁾, vous devez définir le rid (par exemple "=["""",1] ") de la ligne. Attention aux guillemets doubles ! Ce formulaire est valable pour la version 16 de struct-db.

Le code suivant

<form>
action struct_lookup	
struct_field "employeetraining.employee"	
struct_field "employeetraining.training" "=[""ns:ns1:ns2:page"",0]"
struct_field "employeetraining.date" =%Y-%m-%d
struct_fieldhidden "employeetraining.last date" =%Y-%m-%d
submit "Save into lookup"
</form>

résultera en ceci (dans l'éditeur de schéma):

en attente de l'image