GetLayoutObjectOwnerInfo

레이아웃 대상체에 대한 소유권 정보가 있는 JSON 대상체를 반환합니다.

포맷 

GetLayoutObjectOwnerInfo ( objectID )

매개 변수 

objectID - 레이아웃 대상체의 UUID(Universally Unique Identifier) 또는 소유자 ID를 지정하는 텍스트입니다.

반환되는 데이터 유형 

텍스트

다음 버전에서 시작됨 

19.2.2

설명 

이 함수는 UUID 또는 소유자 ID가 objectID 매개 변수와 일치하고 대상체의 소유자 정보를 반환하는 레이아웃 대상체를 검색합니다. 다음을 레이아웃 대상체의 소유자로 간주합니다.

  • 대상체가 있는 레이아웃

  • 대상체가 있는 애드온(적용되는 경우)

레이아웃에 레이아웃 대상체가 추가되면 이는 UUID를 할당받습니다. 애드온의 인스턴스가 레이아웃에 추가되면 이는 소유자 ID를 할당받습니다. objectID 매개 변수의 값은 대상체의 UUID 또는 소유자 ID가 될 수 있습니다. LayoutObjectUUID 함수를 참조하십시오.

애드온 개발자의 경우 이 함수를 사용하여 런타임에서 자신의 애드온 인스턴스에 있는 레이아웃 대상체에 대한 정보를 얻을 수 있습니다.

다음의 반환된 JSON 대상체 예제에서는 레이아웃 대상체가 Tasks 레이아웃에 있는 애드온의 인스턴스에 있습니다.

복사
{
    "APIVers" : 1,
    "Object"
    {
        "UUID" : "D7C30E98-1924-4BF5-A263-53E9CD36862F",
        "Index" : 1,
        "Name" : "ActivityTimeLineWV_970E9CAE-D6FA-40DE-ACFA-14D110731F82",
        "Owners"
        {
            "Add-on"
            {
                "InstanceID" : "38EA3124-9CFD-4490-A634-A0A72A613145"
            },
            "Layout"
            {
                "UUID" : "D7C30E98-1924-4BF5-A263-53E9CD36862F",
                "Name" : "Tasks"
            }
        }
    }
}

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

JSON 요소

설명

APIVers

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

Object.UUID

지정된 레이아웃 대상체의 UUID입니다.

Object.Index

레이아웃에 있는 대상체의 인덱스입니다(0으로 시작).

Object.Name

레이아웃 대상체의 이름입니다(대상체 이름 지정하기를 참조하십시오).

Object.Owners
.Add-on.InstanceID

오브젝트가 있는 애드온 인스턴스의 ID입니다. 대상체가 애드온에 없는 경우 Add-on 요소가 나타나지 않습니다.

Object.Owners
.Layout.UUID

대상체가 있는 레이아웃의 UUID입니다.

Object.Owners
.Layout.Name
대상체가 있는 레이아웃의 이름입니다.

예제 1 

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

복사
GetLayoutObjectOwnerInfo ( "970E9CAE-D6FA-40DE-ACFA-14D110731F82" )