ObtenirInfoExtension

Renvoie un objet JSON avec des informations sur une extension.

Format 

ObtenirInfoExtension ( IDextension )

Paramètres 

IDextension : texte indiquant l'identifiant unique universel (UUID) d'une extension installée ou archivée.

Résultat 

Texte

Provient de la version 

19.2.2

Description 

Cette fonction recherche une extension dont l'UUID correspond au paramètre IDextension et renvoie des informations concernant l'extension. La recherche inclut :

  • des extensions installées, qui sont dans le fichier actif

  • des extensions archivées, qui ne sont pas actuellement installées, mais qui peuvent l'être dans FileMaker Pro

Si vous développez une extension, vous pouvez utiliser cette fonction pour obtenir à son exécution des informations concernant les extensions installées et archivées. Par exemple, vous pouvez utiliser la fonction ObtenirInfoProprietaireObjetModele pour obtenir l'identifiant de l'extension qui contient un objet de modèle donné, puis transférer cet identifiant à cette fonction pour obtenir le nom de l'extension.

Dans l'exemple d'objet JSON renvoyé suivant, l'extension spécifiée a été installée depuis l'extension archivée nommée "Contacts" et renommée "Contacts renommés".

Copier
{
    "APIVers" : 2,
    "Installed"
    {
        "Name" : "Contacts renommés",
        "UUID" : "B79DDD6D-DDF2-4370-A3C9-F9DEF2C52992",
        "UsesLayoutPayload" : 1,
        "UsesRelationship" : 1
    },
    "Package"
    {
        "Name" : "Contacts",
        "UUID" : "3CB70E8B-B45E-4EF1-B2DD-8CA7DDB3CDC1"
    }
}

Le tableau suivant répertorie les éléments figurant dans l'objet JSON renvoyé.

Elément JSON

Description

APIVers

Valeur numérique correspondant à la version de la structure de cet objet JSON. Si la structure de cet objet JSON change dans une version ultérieure, ce numéro changera également.

Version 2 : ajout des éléments UsesLayoutPayload et UsesRelationship.

Installed

Objet décrivant l'extension, si elle a été installée. Inclut ces clés :

  • Name : nom de l'extension.

  • UUID : UUID de l'extension.

  • UsesLayoutPayload : valeur booléenne qui indique si l'extension ajoute des objets de modèle lorsqu'elle est déplacée vers le modèle actif.

  • UsesRelationship : valeur booléenne qui indique si l'extension crée un lien avec l'occurrence de table active.

Package

Objet décrivant l'extension archivée. Inclut ces clés :

  • Name : nom de l'extension.

  • UUID : UUID de l'extension.

Exemple 1 

Renvoie l'objet JSON affiché ci-dessus.

Copier
ObtenirInfoExtension ( "B79DDD6D-DDF2-4370-A3C9-F9DEF2C52992" )