함수 빌더에서 함수 생성

함수 빌더에서 함수를 선택하고 함수에 사용할 연결 및 멤버를 지정합니다. 이렇게 하면 함수 빌더에서 올바른 구문을 사용하여 함수를 생성하고 선택한 셀에 입력합니다. 이러한 함수를 편집할 수 있습니다.

주어진 함수 빌더 필드에서 선택할 수 있는 항목은 함수 빌더의 다른 필더에서 선택한 선택 항목에 의해 제한됩니다. 예를 들어 선택한 함수에서 지원되는 연결만 표시되며, 선택한 함수에서 지원되는 차원만 표시됩니다.

각 함수 인수에 대해 셀 참조를 선택할 수 있습니다. 인수 입력 값을 알고 있는 경우 오프라인 모드로 함수를 생성할 수 있습니다. 각 인수에 대해 입력 기능을 사용할 수 있습니다.

함수 설명

주:

11.1.2.2.310 릴리스 이전의 함수 빌더에서 생성된 함수를 사용할 수 있습니다. 그러나 11.1.2.2.310 릴리스부터는 함수 빌더가 세미콜론(;)이 아닌 쉼표(,)를 사용하여 멤버 목록 인수를 구분합니다. 두 문자 모두 새 함수 빌더에서 지원되지만, 이전 버전에서 생성된 함수를 수정할 때 새로운 쉼표 구분 형식으로 변환하라는 메시지가 표시됩니다. 변환하지 않도록 선택하면 함수에 수정한 내용이 적용되지 않습니다.

함수 빌더를 사용하여 함수를 생성하려면

  1. 적절한 데이터 소스에 접속합니다.

    함수 빌더는 공유, 개인 및 URL 연결을 지원합니다. 큐브 레벨에서 연결되어 있는지 확인하는 것이 좋습니다. 애플리케이션 레벨에서 연결되어 있는 경우 HsGetValue 또는 HsSetValue 같은 Smart View 함수를 사용하면 "큐브가 선택되지 않음" 메시지가 표시될 수 있습니다. 하지만 Oracle Hyperion Financial Management의 경우 애플리케이션 레벨에서 계속 연결하여 Smart View 함수를 사용할 수 있습니다.

    Oracle Essbase: 개인 연결을 사용 중이고 함수에서 별칭 테이블을 사용하려면 연결에 대해 정확한 별칭 테이블이나 "기본" 별칭 테이블이 설정되어 있는지 확인해야 합니다. Smart View 패널에서 데이터베이스 이름을 마우스 오른쪽 버튼으로 누르고 별칭 테이블 설정을 선택합니다. 정확한 별칭 테이블이 선택되었는지 확인하고 시트를 새로고칩니다.

  2. 시트에서 함수를 입력하려는 셀을 선택합니다.
  3. Smart View 패널에서 함수의 기초로 사용할 데이터베이스로 이동하고 데이터베이스 이름을 마우스 오른쪽 버튼으로 누른 다음 함수 빌드를 선택합니다.

    이런 방식으로 함수 빌더에 액세스하면 4단계에 설명된 대로 함수 인수 대화상자의 연결 필드가 특정 연결 정보로 미리 채워집니다.

    또는 Smart View 리본에서 함수 및 함수 빌드 순으로 선택합니다.

    이런 방식으로 함수 빌더에 액세스하면 함수 인수 대화상자의 연결 필드가 비어 있습니다. 4단계에 설명된 대로 연결 정보를 제공할 수 있습니다. 또는 시트에 활성 연결이 있는 경우 드롭다운 목록에서 HSACTIVE를 선택합니다.

  4. 함수 선택의 목록에서 함수를 선택하고 확인을 누릅니다.

    그림 17-1 함수 빌더, 함수 선택 대화상자


    이 섹션에 설명된 대로 함수 빌더, 함수 선택 대화상자에서 HsGetValue가 선택된 모습

    주:

    모든 제공자가 모든 함수를 사용할 수 있는 것은 아닙니다. 함수 및 지원되는 제공자 목록은 표 17-1를 참조하십시오.

    함수 인수 대화상자가 표시됩니다. 연결 필드에는 연결 정보가 다음 형식 중 하나로 자동으로 채워져 있습니다.

    • 공유 연결의 경우:

      WSFN|ProviderType|Server|Application|Database

      위의 WSFN 매개변수는 이 함수가 Workspace 함수이며 공유 연결을 사용함을 나타냅니다. Workspace 함수는 Oracle Hyperion Enterprise Performance Management Workspace 또는 Oracle Enterprise Performance Management Cloud 연결을 지원합니다.

    • 개인 연결의 경우:

      PrivateConnectionName

    • URL 연결의 경우:

      URLFN|URL|Server|Application|Database

    연결하는 데 필요한 모든 정보는 위에 표시된 대로 토큰의 일부입니다. 부적합한 정보가 토큰에 포함된 경우 일반적으로 서버 토큰에 대한 다음 예외와 함께 #NoConnection 오류가 표시됩니다.

    • EPM Cloud 비즈니스 프로세스(예: Planning)의 경우 서버 토큰이 비어 있거나 부적합할 수 있습니다.
    • Essbase 서버 토큰은 비어 있어야만 합니다.
    • Financial Management에는 서버 토큰 매개변수가 필요합니다.

    연결 정보를 수동으로 입력하려면 위의 구문을 사용합니다.

  5. 함수 인수에서 선택한 함수의 각 인수에 대해 다음 중 하나를 수행합니다.

    • 맨 오른쪽 버튼 [멤버 선택] 버튼, [멤버 선택] 대화상자를 엽니다.를 누릅니다.

      예를 들어 HsGetValue의 경우 [멤버 선택] 버튼, [멤버 선택] 대화상자를 엽니다.을 눌러 멤버 선택에서 멤버를 선택하고, HsLabel 및 HsGetVariable의 경우 레이블 또는 변수 드롭다운 목록에서 선택합니다.

      Essbase: 변수 이름이 중복된 경우 드롭다운 목록에 전체 이름이 표시됩니다. 이를 통해 글로벌, 애플리케이션 및 데이터베이스 레벨에 정의된 변수를 식별할 수 있습니다.

    • 인수를 수동으로 입력하려면 텍스트 상자에 인수를 입력합니다. 예를 들어 멤버를 입력하려면 dimension#member 형식을 사용합니다(예: Year#Qtr1 또는 Year#Jan).

    • 셀 참조를 사용하려면 셀 참조 사용의 절차를 따릅니다.

    그림 17-2는 HsGetValue 함수에 대한 전체 함수 인수 대화상자를 보여 줍니다.

    그림 17-2 Essbase 샘플 기본 데이터베이스를 기반으로 하는 HsGetValue에 대한 함수 빌더, 함수 인수 대화상자


    HsGetValue 함수에 대한 함수 빌더, 함수 인수 대화상자 [연결] 필드와 각 함수 인수에 대한 차원 및 멤버를 입력하기 위한 필드가 있습니다.

    함수 인수에 나열되는 인수는 이전 단계에서 선택한 함수에 따라 달라집니다.

    주:

    다음 모범 사례를 고려하십시오.

    • HsGetSheetInfo의 경우 셀 참조를 사용합니다. 자세한 내용은 셀 참조 사용을 참조하십시오.

    • HsSetValue만 해당: 데이터 또는 셀 참조를 선택하고 제출할 값을 입력합니다.

    • HsGetText 및 HsSetText에만 해당:

      • 설명 또는 셀 참조를 선택하고 제출할 셀 텍스트를 입력합니다.

      • 셀 텍스트 레이블을 선택하고 드롭다운 메뉴에서 레이블을 선택합니다

    • 활성 워크시트 연결이 사용 가능한 경우 연결 드롭다운 목록에서 HSACTIVE를 선택할 수 있습니다.

  6. 검증을 누르고 표시되는 오류를 모두 수정합니다.

    표시될 수 있는 몇 가지 오류는 다음과 같습니다.

    • 연결이 오프라인이거나 부적합합니다.

    • 부적합한 선택

    • 멤버 이름이 부적합하거나 선택된 별칭과 일치하지 않습니다.

    • 차원 이름이 부적합하거나 선택된 별칭과 일치하지 않습니다.

    • 불완전한 Dimension#Member 조합

    • 따옴표가 누락되었거나 기타 사소한 구문 오류가 발생한 경우의 일반 "오류"

    그림 17-3에서는 검증 버튼을 누른 후의 [함수 인수] 대화상자를 보여 줍니다. Financial Management 샘플 애플리케이션의 다음 예에서는 두 가지 Dimension#Member 조합의 구문에 오류가 있습니다. 첫 번째 오류는 차원 이름이 부적합하거나 선택된 별칭과 일치하지 않는다는 것입니다. 두 번째 오류는 멤버 이름이 부적합하거나 선택된 별칭과 일치하지 않는다는 것입니다.

    그림 17-3 함수 빌더 검증 오류


    HsGetValue 함수에 대한 함수 빌더, 함수 인수 대화상자 두 가지 Dimension#Member 조합의 구문에 오류가 있습니다. 첫 번째 오류는 차원 이름이 부적합하거나 선택된 별칭과 일치하지 않는다는 것입니다. 두 번째 오류는 멤버 이름이 부적합하거나 선택된 별칭과 일치하지 않는다는 것입니다.
  7. 함수 검증에 성공한 경우 확인을 눌러 선택한 셀에 함수를 삽입합니다.
  8. 함수를 실행하려면 함수 실행의 절차를 따릅니다.