METHODE FIXER ATTRIBUTS

4D v16.3


METHODE FIXER ATTRIBUTS ( chemin ; attributs {; *} )

Paramètre	Type	Description
chemin	Texte, Tableau texte	Chemin(s) de méthode(s)
attributs	Objet, Tableau objet	Attribut(s) de méthode(s) à définir
*	Opérateur	Si passé = la commande s’applique à la base hôte lorsqu’elle est exécutée depuis un composant (paramètre ignoré hors de ce contexte)

Description

La commande METHODE FIXER ATTRIBUTS vous permet de définir les valeurs des attributs pour la ou les méthode(s) spécifiée(s) dans le paramètre chemin.

Dans le paramètre chemin, vous pouvez passer soit un texte contenant un chemin de méthode, soit un tableau texte contenant un tableau de chemins. Vous devrez passer le même type de paramètre (variable simple ou tableau) dans le paramètre attributs afin de définir les valeurs adéquates. Cette commande ne fonctionne qu’avec les méthodes projet. Si vous passez un chemin invalide, une erreur est générée.

Dans le paramètre attributs, vous pouvez passer un objet ou un tableau d'objets, selon le type de paramètre passé dans chemin, contenant tous les attributs à fixer pour la ou les méthode(s).

Les attributs de méthodes doivent être définis à l'aide des commandes OB FIXER ou OB FIXER TABLEAU, avec les valeurs Vrai or Faux pour les attributs booléens, ou des valeurs spécifiques pour les attributs étendus (par exemple, "scope":"table" pour la propriété 4D Mobile). Seuls les attributs présents dans le paramètre attributs seront mis à jour dans les attributs des méthodes.

Si la commande est exécutée depuis un composant, elle s’applique par défaut aux méthodes du composant. Si vous passez le paramètre *, elle accède aux méthodes de la base hôte.

Note : La commande existante METHODE FIXER ATTRIBUT reste prise en charge, toutefois comme elle ne peut retourner que des valeurs booléennes, elle ne peut pas être utilisée pour les attributs étendus tels que les propriétés 4D Mobile.

Les attributs pris en charge sont :

{
    "invisible" : false, // true si visible
    "preemptive" : "capable" // ou bien "incapable" ou "indifferent"
    "publishedWeb" : false,  // true si disponible via les balised et URLs 4D
    "publishedSoap": false,  // true si offerte comme Web Service
    "publishedWsdl": false,  // true si publiée dans WSDL
    "shared" : false,  // true si partagée entre composants et base hôte
    "publishedSql" : false,  // true si disponible via SQL
    "executedOnServer" : false, // true si exécutée sur le serveur
    "published4DMobile" : {
        "scope": "table",  // "none" ou "table" ou "currentRecord" ou "currentSelection" 
        "table": "nomTable"  // présent si scope est différent de "none" 
    }
}

Note : Pour les attributs "published4DMobile", si la valeur "table" n'existe pas ou si le "scope" est invalide, ces attributs sont ignorés.

Exemple 1

Vous souhaiter modifier un seul attribut :

 C_OBJET($attributes)

 OB FIXER($attributes;"executedOnServer";Vrai)

 METHODE FIXER ATTRIBUTS("aMethod";$attributes) //seul l'attribut "executedOnServer" est modifié

Exemple 2

Vous souhaitez qu'une méthode soit indisponible pour 4D Mobile (la valeur "none" doit être passée à l'attribut "scope") :

 C_OBJET($attributes)

 C_OBJET($fourDMobileAttribute)

 OB FIXER($fourDMobileAttribute;"scope";"none")

 OB FIXER($attributes;"published4DMobile";$fourDMobileAttribute)

 METHODE FIXER ATTRIBUTS("aMethod";$attributes)

Voir aussi

METHODE FIXER ATTRIBUT
METHODE LIRE ATTRIBUTS