GetAddonInfo

Retorna um objeto JSON com informações sobre um complemento.

Formato

GetAddonInfo ( addonID )

Parâmetros

addonID – texto que especifica o identificador único universal (UUID) de um complemento instalado ou empacotado.

Tipo de dados retornado

texto

Originada na versão

19.2.2

Descrição

Esta função procura um complemento cujo UUID corresponda ao parâmetro addonID e retorna informações sobre o complemento. A pesquisa inclui:

Complementos instalados, que estão no arquivo atual
Complementos empacotados, que não estão instalados no momento, mas estão disponíveis para o FileMaker Pro para serem instalados.

Se estiver desenvolvendo um complemento, você pode usar esta função para obter informações no tempo de execução sobre complementos instalados e empacotados. Por exemplo, você pode usar a Função GetLayoutObjectOwnerInfo para obter o ID do complemento que contém um determinado objeto de layout e, em seguida, passar esse ID do complemento para esta função a fim de obter o nome do complemento.

No exemplo a seguir do objeto JSON retornado, o complemento especificado foi instalado a partir do complemento empacotado, denominado "Pessoas" e renomeado como "Renomeado pessoas".

Copiar

{
    "APIVers" : 2,
    "Installed" : 
    {
        "Name" : "Renomeado pessoas",
        "UUID" : "B79DDD6D-DDF2-4370-A3C9-F9DEF2C52992",
        "UsesLayoutPayload" : 1,
        "UsesRelationship" : 1
    },
    "Package" : 
    {
        "Name" : "Pessoas",
        "UUID" : "3CB70E8B-B45E-4EF1-B2DD-8CA7DDB3CDC1"
    }
}

A tabela a seguir descreve os elementos do objeto JSON retornado.

Elemento JSON	Descrição
`APIVers`	Valor numérico para a versão da estrutura deste objeto JSON. Se a estrutura desse objeto JSON mudar em uma versão subsequente, esse número mudará. Versão 2: `UsesLayoutPayload` e `UsesRelationship` adicionados.
`Installed`	Objeto que descreve o complemento, se instalado. Inclui estas chaves: `Name` – Nome do complemento `UUID` – UUID do complemento `UsesLayoutPayload` – Booleano que indica se o complemento adiciona objetos de layout quando é arrastado para o layout atual. `UsesRelationship` – Booleano que indica se o complemento cria um relacionamento com a ocorrência de tabela atual.
`Package`	Objeto que descreve o complemento empacotado. Inclui estas chaves: `Name` – Nome do complemento `UUID` – UUID do complemento

Exemplo 1

Retorna o objeto JSON mostrado acima.