Formulaires dynamiques

4D v20 R8

Présentation

Les Dynamic Forms sont des formulaires dont les structures sont définies dans un fichier .json ou dans un objet 4D. Ils sont régénérés chaque fois qu'ils sont exécutés et offrent un niveau élevé de flexibilité. Quelques-uns de leurs avantages notables sont :

Utilisabilité
- mises à jour simples
- modifications dynamiques de l'utilisateur
- réutilisation facile
- recherche plus rapide
Portabilité
- partage simplifié
- peut être stocké dans un système de gestion de version (source control)

Chaque objet défini dans un un formulaire dynamique, y compris le formulaire lui-même, possède une ou plusieurs propriétés. Voir le Sommaire de la page pour une description rapide de ces propriétés.

Exemple Hello World

Ce qui suit est un simple fichier JSON ("HW.json", stocké dans le dossier Resources) avec du texte, une image et un bouton :

{
    "windowTitle": "Hello World",
    "windowMinWidth": 220,
    "windowMinHeight": 80,
    "method": "HWexample",
    "pages": [
        null,
        {
            "objects": {
                "text": {
                "type": "text",
                "text": "Hello World!",
                "textAlign": "center",
                "left": 50,
                "top": 120,
                "width": 120,
                "height": 80
                },
                "image": {
                "type": "picture",
                "pictureFormat": "scaled",
                "picture": "/RESOURCES/Images/HW.png",
                "alignment":"center", 
                "left": 70,
                "top": 20, 
                "width":75, 
                "height":75        
                },
                "button": {
                "type": "button",
                "text": "OK",
                "action": "Cancel",
                "left": 60,
                "top": 160,
                "width": 100,
                "height": 20
                }
            }
        }
    ]
}

Ce formulaire peut être chargé dans une boîte de dialogue avec le code 4D suivant :

 $fen:=Open form window("/RESOURCES/HW.json")

 DIALOG("/RESOURCES/HW.json")

 CLOSE WINDOW($fen)

Qui affiche le formulaire :

Schéma JSON

Lors de la création de formulaires à partir de fichier, ceux-ci doivent :

se conformer au schéma JSON. Le schéma JSON des formulaires 4D peut être trouvé dans le dossier de l'application 4D à l'adresse : Resources/formsSchema.json. Il est de votre responsabilité de vérifier la validité du fichier .json du formulaire. Voir la commande .
être des fichiers avec une extension ".json".
être stockés dans le répertoire de l'application, contenant le fichier de structure.

Note : Les commentaires dans les fichiers .json doivent être contenus dans la propriété "comments". Les caractères standards pour les commentaires (c'est-à-dire, "//", "/*", "'", etc.) rendront le fichier invalide.

Chemin d'accès du formulaire

Tous les chemins d'accès peuvent être relatifs ou absolus. Ils doivent utiliser '/' comme délimiteur et sont résolus de la façon suivante :

Un chemin relatif ne doit pas commencer par '/'. Il est résolu relativement au document JSON dans lequel se trouve la chaîne de chemin d'accès,
Un chemin absolu commence par '/'. Pour des raisons de sécurité, seul "/RESOURCES" est accepté comme chemin absolu et désigne le dossier de ressources de la base de données en cours. Par exemple, "/RESOURCES/templates/myfile.json" pointe vers le fichier "myfile.json" situé dans le dossier des ressources de la base courante.

Notes :

La résolution du nom est sensible à la casse.
4D ne résout pas le chemin vers un fichier . json situé sur le réseau (commençant par "http/https").
Si le chemin est incorrect ou si le fichier n'est pas valide conformément au schéma JSON, une erreur sera générée.

Pointeurs JSON

Les formulaires dynamiques peuvent contenir des pointeurs JSON. Les pointeurs JSON sont automatiquement résolus lorsque vous appelez une des commandes 4D qui acceptent un formulaire dynamique en paramètre (chemin fichier .json ou objet 4D) :

Pour plus d'informations sur les pointeurs JSON, veuillez vous reporter à la section Defining JSON Pointers.

Définition

Documentation déplacée

La documentation de cette section a été mise à jour et déplacée vers developer.4d.com dans les sections suivantes :

Voir aussi

Vue d'ensemble