FORM FIXER ENTREE

4D v18

FORM FIXER ENTREE


FORM FIXER ENTREE ( {laTable ;} formulaire {; formUtilisateur {; *}} )

Paramètre	Type	Description
laTable	Table	Table pour laquelle définir le formulaire entrée ou Table par défaut si ce paramètre est omis
formulaire	Chaîne, Objet	Nom du formulaire table (chaîne), ou Chemin POSIX (chaîne) d'un fichier .json décrivant le formulaire, ou Objet décrivant le formulaire
formUtilisateur	Chaîne	Nom du formulaire utilisateur à utiliser
*		Taille de fenêtre automatique

Description

FORM FIXER ENTREE désigne formulaire ou formUtilisateur comme formulaire entrée courant de laTable pour le process courant. formulaire doit appartenir à laTable.

La portée de cette commande est le process courant. Chaque table dispose d'un formulaire entrée courant pour chaque process.

Dans le paramètre formulaire, vous pouvez passer :

le nom d'un formulaire (table) à utiliser,
le chemin (en syntaxe POSIX) d'un fichier .json valide contenant la description du formulaire à utiliser (voir Chemin d'accès du formulaire),
un objet contenant la description du formulaire à utiliser.

Note : Pour des raisons structurelles, cette commande n'est pas compatible avec les formulaires projets.

La commande FORM FIXER ENTREE n'affiche pas de formulaire ; elle désigne juste celui qui sera affiché ou utilisé par d'autres commandes. Pour plus d'informations sur la création de formulaires, reportez-vous au manuel Mode Développement de 4D.

Pour chaque table de la base, un formulaire entrée par défaut est défini dans la fenêtre de l'Explorateur. Ce formulaire est utilisé si la commande FORM FIXER ENTREE n'est pas appelée, ou si le paramètre formulaire est invalide.

Le paramètre facultatif formUtilisateur permet de désigner un formulaire utilisateur (issu du formulaire) comme formulaire entrée par défaut. Si vous passez un nom de formulaire utilisateur valide, ce formulaire sera utilisé par défaut en lieu et place du formulaire entrée dans le process courant. Ce principe permet de disposer simultanément de différents formulaires utilisateurs personnalisés (générés à l’aide de la commande _o_CREER FORMULAIRE UTILISATEUR) et d’utiliser celui qui convient en fonction du contexte.
Pour plus d’informations sur les formulaires utilisateurs, reportez-vous à la section Présentation des formulaires utilisateurs.

Le formulaire entrée est affiché par de nombreuses commandes. Ces commandes sont généralement utilisées pour la saisie ou la modification de valeurs. Les commandes suivantes affichent un formulaire entrée :

Les commandes VISUALISER SELECTION et MODIFIER SELECTION affichent une liste d'enregistrements dans le formulaire sortie. Chacune d'entre elles permet ensuite à l'utilisateur de double-cliquer sur un enregistrement, qui s'affiche alors dans le formulaire entrée.

Le formulaire entrée est aussi utilisé par les commandes d'import IMPORTER TEXTE, LECTURE SYLK et LECTURE DIF.

Le paramètre optionnel * est destiné à être utilisé conjointement avec les propriétés du formulaire, que vous définissez en mode Développement dans la fenêtre des Propriétés du formulaire, et avec la commande Creer fenetre. En passant le paramètre *, vous indiquez à 4D d'utiliser les propriétés du formulaire pour redimensionner automatiquement la fenêtre lors de l'utilisation ultérieure de la fenêtre comme formulaire entrée ou comme dialogue. Reportez-vous à la description de la commande Creer fenetre pour plus d'informations sur ce point.

Note : Que vous passiez ou non le paramètre *, FORM FIXER ENTREE change le formulaire entrée pour la table.

Exemple 1

L'exemple suivant illustre une utilisation typique de FORM FIXER ENTREE. A noter que, si dans cet exemple FORM FIXER ENTREE est appelé juste avant que le formulaire soit utilisé, cela n'est absolument pas nécessaire. FORM FIXER ENTREE peut en fait être exécuté dans une tout autre méthode, du moment qu'elle est exécutée avant celle-ci :

 FORM FIXER ENTREE([Sociétés];"Nouvelle Sté") ` Formulaire pour les nouvelles sociétés

 AJOUTER ENREGISTREMENT([Sociétés]) ` Ajout d'une nouvelle société

Exemple 2

Dans une base de facturation gérant plusieurs sociétés, la création d’une facture doit s’effectuer dans le formulaire utilisateur correspondant :

 Au cas ou

    :(société="4D SAS")

       FORM FIXER ENTREE([Factures];"Saisie";"4D_SAS")

    :(société="4D Inc")

       FORM FIXER ENTREE([Factures];"Saisie";"4D_Inc")

    :(société="Acme")

       FORM FIXER ENTREE([Factures];"Saisie";"ACME")

 Fin de cas

 AJOUTER ENREGISTREMENT([Factures])

Exemple 3

L'exemple suivant utilise un fichier .json de description de formulaire pour la saisie des enregistrements des employés :

 FORM FIXER ENTREE([Personnel];"/RESOURCES/PersonnelForm.json")

 AJOUTER ENREGISTREMENT([Personnel])

Résultat :

Voir aussi

_o_CREER FORMULAIRE UTILISATEUR
AFFICHER ENREGISTREMENT
AJOUTER ENREGISTREMENT
CHERCHER PAR EXEMPLE
Creer fenetre
FORM FIXER SORTIE
IMPORTER TEXTE
LECTURE DIF
LECTURE SYLK
MODIFIER ENREGISTREMENT
MODIFIER SELECTION
VISUALISER SELECTION