GetAddonInfo

애드온에 대한 정보가 있는 JSON 대상체를 반환합니다.

포맷 

GetAddonInfo ( addonID )

매개 변수 

addonID - 설치되거나 패키지된 애드온의 UUID(Universally Unique Identifier)를 지정하는 텍스트입니다.

반환되는 데이터 유형 

텍스트

다음 버전에서 시작됨 

19.2.2

설명 

이 함수는 UUID가 addonID 매개 변수와 일치하고 해당 애드온 정보를 반환하는 애드온을 검색합니다. 검색은 다음을 포함합니다.

  • 현재 파일에 있는 설치된 애드온

  • 현재 설치되지 않았지만 FileMaker Pro에 설치 가능한 패키지된 애드온

애드온 개발자의 경우 이 함수를 사용하여 런타임에서 설치된 애드온과 패키지된 애드온에 대한 정보를 얻을 수 있습니다. 예를 들어 GetLayoutObjectOwnerInfo 함수를 사용하여 주어진 레이아웃 대상체를 포함하는 애드온의 ID를 얻은 다음, 해당 애드온 ID를 이 함수에 넣어 애드온의 이름을 얻을 수 있습니다.

다음의 반환된 JSON 대상체 예시에서는 지정된 애드온이 ‘사람’이라는 패키지된 애드온에서 설치되었으며 ‘사람 이름 변경됨’으로 이름이 다시 지정되었습니다.

복사 
{
    "APIVers" : 2,
    "Installed" : 
    {
        "Name" : "사람 이름 변경됨",
        "UUID" : "B79DDD6D-DDF2-4370-A3C9-F9DEF2C52992",
        "UsesLayoutPayload" : 1,
        "UsesRelationship" : 1
    },
    "Package" : 
    {
        "Name" : "사람",
        "UUID" : "3CB70E8B-B45E-4EF1-B2DD-8CA7DDB3CDC1"
    }
}

다음 표는 반환된 JSON 대상체의 요소를 설명합니다.

JSON 요소

설명

APIVers

이 JSON 대상체 구조 버전의 숫자 값입니다. 이 JSON 대상체의 구조가 다음 릴리즈에서 변경되면 이 숫자가 변경됩니다.

버전 2: UsesLayoutPayload 및 UsesRelationship이 추가되었습니다.
Installed

애드온을 설명하는 대상체입니다(설치된 경우). 다음 키를 포함합니다.

  • Name – 애드온의 이름입니다.

  • UUID – 애드온의 UUID입니다.

  • UsesLayoutPayload – 애드온이 현재 레이아웃으로 드래그될 때 레이아웃 대상체를 추가할지 나타내는 부울입니다.

  • UsesRelationship – 애드온이 현재 테이블 일치 항목과 함께 관계를 생성할지 나타내는 부울입니다.
Package

패키지된 애드온을 설명하는 대상체입니다. 다음 키를 포함합니다.

  • Name – 애드온의 이름입니다.

  • UUID – 애드온의 UUID입니다.

예제 1 

위에 표시된 JSON 대상체를 반환합니다.

복사 
GetAddonInfo ( "B79DDD6D-DDF2-4370-A3C9-F9DEF2C52992" ) 

관련 주제