INFOR.GET.ELEMENT

이 함수는 하나 이상의 요소 특성을 나타내는 값을 반환합니다. 예를 들면 설명(MEMBER_CAPTION) 또는 Id(MEMBER_UNIQUE_NAME)가 있습니다.

INFOR.GET.ELEMENT에서는 다음 기능을 지원합니다.

  • 다중 선택

    동일한 계층 구조에서 다수의 요소 고유 이름을 지정할 수 있습니다.

  • 모든 특성 검색
  • MDX 식

    예를 들면 [HierarchyUN].DefaultMember를 지정하여 기본 요소 특성 또는 elementUN.Children을 반환하여 다수의 하위 항목 요소를 반환할 수 있습니다.

    집계된 요소 집합이 MDX 식으로부터 반환되면 상응하는 특성이 쉼표로 구분되어 단일 셀에 반환됩니다.

구문

함수의 구문은 다음과 같습니다.

=INFOR.GET.ELEMENT("data_connection", "cube", [attribute], "hierarchy" {, element, ...})

다음 표에는 매개 변수와 해당 설명이 나와 있습니다.

매개 변수 설명
data_connection 데이터베이스 고유 이름을 나타냅니다. 문자열 또는 셀 참조입니다.
큐브 큐브 고유 이름을 나타냅니다. 문자열 또는 셀 참조입니다.
특성 특성 고유 이름을 나타냅니다. 문자열 또는 셀 참조로 이루어진 행렬입니다. 지정되지 않은 경우, 기본값은 MEMBER_CAPTION입니다.
계층 구조 계층 구조 고유 이름을 나타냅니다. 문자열 또는 셀 참조입니다. 계층 구조가 지정되지 않은 경우, 기본값은 비어 있는 문자열이며 계층 구조가 요소 고유 이름으로부터 구문 분석됩니다.
요소 지정된 계층 구조에서 나온 요소 고유 이름을 나타냅니다. 문자열 또는 셀 참조 수입니다.
참고

계층 구조가 지정되지 않은 경우, 예를 들면 [PERIOD].[ALL YEARS].[2018]처럼 요소 고유 이름은 반드시 long 형식으로 지정되어야 합니다.

.

반환 값

이 함수는 임의 형식의 단일 셀 값을 반환합니다.

지정되고 유효한 계층 구조에 대해:

  • 요소 매개 변수가 쉼표로 구분된 다수의 고유 이름으로 지정된 경우, 집계된 구성원이 반환됩니다. 그러한 다수의 요소는 동일한 계층 구조의 요소여야 합니다.
  • 요소 매개 변수가 비어 있는 경우 지정된 계층 구조의 기본 요소가 반환됩니다.
  • 요소 매개 변수가 요소 이름뿐인 경우 그러한 이름을 가진 최초의 사용 가능한 요소가 반환됩니다.

특성 매개 변수에 다수의 고유 이름이 포함된 경우(예: MEMBER_CAPTIONMEMBER_UNIQUE_NAME), 함수는 1 x N 크기로 된 배열을 반환합니다. 지정된 특성의 순서가 반환되는 항목의 순서를 결정합니다.

[attribute] 인수가 지정되지 않은 경우, 함수에서 MEMBER_CAPTION 특성을 반환합니다.

오류

이 함수는 필요한 매개 변수가 누락된 경우 오류 값을 반환합니다. 지정된 매개 변수가 잘못된 경우 해당 element를 건너뜁니다.