Propriétés des méthodes projet

Après avoir créé une méthode projet, vous pouvez la renommer et modifier ses propriétés. Les propriétés des méthodes projet définissent principalement les conditions d’accès et de sécurité : accès par les utilisateurs, par le serveur Web, le serveur SQL et par les services Web. 

Les autres types de méthodes ne disposent pas de propriétés spécifiques. Leurs propriétés sont liées à celles des objets auxquelles elles sont attachées.

Pour modifier les propriétés d’une méthode projet :

1. Dans l’Editeur de méthodes, sélectionnez la commande Propriétés de la méthode... dans le menu Méthode.
   OU
   Dans la Page Méthodes de l’Explorateur, cliquez avec le bouton droit de la souris sur le nom de la méthode projet et sélectionnez Propriétés de la méthode... dans le menu contextuel ou le menu d’options.
   La boîte de dialogue des propriétés de la méthode apparaît.
   

Note : La fonction de modification globale permet de modifier un attribut pour un ensemble de méthodes (cf. paragraphe Modifier attributs globalement).

Vous pouvez changer le nom d’une méthode projet dans la zone "Nom" de la fenêtre des propriétés des méthodes ou depuis l'Explorateur.

Le nouveau nom doit respecter les règles de nommage de 4D (cf. section Nommer les objets du langage 4D dans le manuel Langage de 4D). Si une méthode du même nom existe déjà, 4D affiche un message vous indiquant que ce nom est déjà utilisé. La liste des méthodes est triée de nouveau par ordre alphabétique si nécessaire. 

Attention : Changer le nom d’une méthode déjà utilisée dans la base nécessite la mise à jour de ce nom dans les méthodes et formules qui font référence à l’ancien nom, sous peine de perturber le fonctionnement de l'application. Cette opération peut être effectuée manuellement, mais il est fortement conseillé d'utiliser la fonction de renommage des méthodes projet, décrite dans la section Renommer. Cette fonction permet de mettre à jour automatiquement les appelants de la méthode dans le mode Développement.

Avec 4D Server, le nom de la méthode est changé sur le serveur lorsque vous avez fini d’éditer le nom. Si plusieurs utilisateurs modifient simultanément le nom de la méthode, le nom final de la méthode sera celui affecté par le dernier utilisateur l’ayant édité. Il est conseillé de définir un propriétaire pour la méthode afin de ne permettre qu’à certains utilisateurs de modifier le nom de la méthode.

Note : Les méthodes base ne peuvent pas être renommées. De même, les triggers, les méthodes formulaire et les méthodes objet, qui sont liées à des objets de la base et tirent leur nom de cet objet, ne peuvent pas être renommées. 

Vous pouvez contrôler l’accès aux méthodes projet en définissant des privilèges d’accès ou de propriété pour des groupes d’utilisateurs. Pour plus d’informations sur la création d’un système de mots de passe comportant des utilisateurs et des groupes, reportez-vous au chapitre Utilisateurs et groupes.

• La liste déroulante “Accès” définit le groupe qui peut exécuter la méthode. Si un utilisateur qui n’appartient pas à ce groupe essaie d’exécuter cette méthode, 4D affiche un message lui indiquant que ses privilèges d’accès ne lui permettent pas d’exécuter cette méthode.
• La liste déroulante “Propriétaire” définit quel groupe peut modifier la méthode dans le mode Développement. Si un utilisateur qui n’appartient pas à ce groupe essaie d’éditer cette méthode, 4D affiche un message lui indiquant que ses privilèges d’accès ne lui permettent pas d’éditer cette méthode.

Les utilisateurs qui appartiennent aux deux groupes peuvent utiliser ou modifier la méthode sans restriction.

Les attributs permettent de contrôler l'utilisation et les appels de la méthode projet dans différents contextes. A noter que les attributs peuvent être définis globalement pour une sélection de méthodes projet à partir de l'Explorateur (cf. paragraphe suivant).

Si vous ne voulez pas que les utilisateurs puissent provoquer l’exécution de certaines méthodes projet via la commande Méthode... du menu Exécution, vous pouvez les rendre invisibles en cochant cette option. Une méthode invisible n’apparaît plus dans la boîte de dialogue d’exécution de méthodes (cf. paragraphe Depuis la boîte de dialogue d’exécution de méthode). 

Une méthode projet invisible reste toutefois disponible pour les programmeurs de la base. Elle reste référencée dans la Table du formulaire courant de l’Explorateur et dans la liste des routines de l’éditeur de méthodes.

Cette option permet de renforcer la sécurité du serveur Web de 4D : lorsqu’elle est désélectionnée, la méthode projet concernée ne peut pas être exécutée via une requête HTTP contenant l'URL spécial 4DACTION d’appel de méthodes (ainsi que l'ancien URL 4DMETHOD) ni les balises spéciales 4DSCRIPT, 4DTEXT et 4DHTML (ainsi que les anciennes balises 4DVAR et 4DHTMLVAR). Pour plus d’informations, reportez-vous aux sections URLs et actions de formulaires et Balises HTML 4D dans le manuel Langage.

Dans l'Explorateur, l'icône indique une méthode projet bénéficiant de cet attribut.

Pour des raisons de sécurité, cette option est désélectionnée par défaut. Vous devez désigner chaque méthode pouvant être exécutée via les URLs et les balises spéciales.

Cet attribut permet de publier la méthode courante comme Web Service, accessible via des requêtes SOAP. Pour plus d’informations, reportez-vous au chapitre Publication et utilisation de Services Web. Lorsque cette option est cochée, l’option Publié dans WSDL est active.

Dans l'Explorateur, l'icône indique une méthode projet bénéficiant de cet attribut.

Note : Il n'est pas possible de publier en tant que Web service une méthode dont le nom comporte des caractères non conformes à la nomenclature XML (par exemple des espaces). Si le nom de la méthode n'est pas conforme, 4D refuse l'affectation de la propriété.

Cet attribut est actif uniquement si l'attribut "Offerte comme Web service" est coché. Il permet d’inclure la méthode courante dans le fichier WSDL de l’application 4D. Pour plus d’informations sur ce point, reportez-vous au paragraphe Génération du WSDL. 

Les méthodes projet offertes comme Web Service et publiées dans le WSDL bénéficient d’une icône spécifique. 

Dans l'Explorateur, l'icône indique une méthode projet bénéficiant de cet attribut. 

Cet attribut est utilisé dans le cadre de l’emploi de composants. Lorsqu’il est coché, il indique que la méthode sera accessible aux composants si l’application est utilisée comme base hôte. A l’inverse, si l’application est utilisée comme composant, la méthode sera accessible aux bases hôtes. 

Pour plus d’informations sur les composants, reportez-vous au chapitre Développer et installer des composants 4D.

Lorsqu’elle est cochée, cette option autorise l’exécution de la méthode projet par le moteur SQL de 4D. Elle désélectionnée par défaut, ce qui signifie que, sauf autorisation explicite, les méthodes projet de 4D sont protégées et peuvent pas être appelées par le moteur SQL de 4D. 

Cette propriété s’applique à toutes les requêtes SQL internes et externes — exécutées via le pilote ODBC, le code SQL inséré dans les balises Debut SQL/Fin SQL ou la commande CHERCHER PAR SQL. 

Notes :

• Même si une méthode dispose de l’attribut “Disponible via SQL”, les accès définis au niveau des propriétés de la base et des propriétés de la méthode sont pris en compte pour l’exécution de la méthode.
• La fonction ODBC SQLProcedure retourne uniquement les méthodes projet disposant de l’attribut “Disponible via SQL”.

Pour plus d’informations, reportez-vous à la section Implémentations du moteur SQL de 4D dans le manuel SQL de 4D .

Cet attribut est pris en compte uniquement dans le cadre d’une application 4D en client/serveur. Lorsque cette option est cochée, la méthode projet est toujours exécutée sur le serveur, quel que soit le mode d’appel de la méthode. 

Pour plus d’informations sur cette option, reportez-vous à la section Attribut Exécuter sur serveur dans le Manuel de référence de 4D Server.

Cette option permet de configurer la disponibilité et le périmètre d'action de la méthode dans le contexte d'une liaison 4D Mobile avec un serveur Wakanda.

Pour plus d'informations sur cette option, reportez-vous à la section Configuration de la base 4D dans le manuel 4D Mobile.

La boîte de dialogue “Attributs des méthodes” permet de modifier un attribut de méthode projet (Invisible, Offerte comme Web Service, etc.) pour la totalité ou une partie des méthodes de la base en une seule opération. Cette fonction est très utile pour modifier les attributs d’un grand nombre de méthodes projet. Elle peut également être utilisée en cours de développement pour appliquer rapidement des attributs communs à des groupes homogènes de méthodes.

Pour modifier globalement les attributs des méthodes :

1. Dans la Page Méthodes de l'Explorateur de 4D, déployez le menu d'options puis choisissez la commande Modifier attributs globalement...
   
   La boîte de dialogue “Attributs des méthodes” apparaît :
   
2. Dans la zone “Méthodes à modifier”, saisissez une chaîne de caractères permettant de désigner les méthodes que vous souhaitez modifier globalement.
   La chaîne de caractères est utilisée comme critère de recherche des noms de méthodes.
   Vous devez utiliser le caractère “joker” @ afin de définir des ensembles de méthodes :
   
   • pour désigner les méthodes dont le nom débute par..., saisissez @ en fin de chaîne. Par exemple : web@
   • pour désigner les méthodes dont le nom contient..., saisissez @ en milieu de chaîne. Par exemple : web@write
   • pour désigner les méthodes dont le nom se termine par..., saisissez @ en début de chaîne. Par exemple : @write
   • pour désigner toutes les méthodes, saisissez uniquement le caractère @ dans la zone.
     Notes :
     
     • La recherche ne tient pas compte des majuscules/minuscules.
     • Vous pouvez insérer plusieurs @ dans la chaîne, par exemple dtro_@web@pro@
3. Dans la zone “Attributs à modifier”, choisissez un attribut dans la liste déroulante puis cliquez sur le bouton radio Vrai ou Faux correspondant à la valeur à appliquer.
   Note : L’attribut “Publié dans WSDL” à Vrai ne sera appliqué qu’aux méthodes projet contenant déjà l’attribut “Offert comme Web Service”.
4. Cliquez sur le bouton Appliquer.
   La modification est appliquée instantanément à toutes les méthodes projet désignées par la chaîne de caractères définie.