HsGetValue

Smart View 함수 HsGetValue에 대해 설명합니다.

클라우드 데이터 소스 유형: Oracle Essbase, Planning, Planning Modules, Financial Consolidation and Close, Tax Reporting, Narrative Reporting

온-프레미스 데이터 소스 유형: Oracle Essbase, Oracle Hyperion Financial Management, Oracle Hyperion Planning

설명

HsGetValue는 선택한 POV 차원 멤버의 데이터 소스에서 데이터를 검색합니다.

HsGetValue가 데이터를 검색하지 못하면 #NoData/Missing 레이블 대체 옵션에 대해 지정한 값이 사용됩니다(표 5-7 참조).

[새로고침] 또는 [모두 새로고침]을 선택하면 HsGetValue만 호출됩니다. [제출]을 선택하면 먼저 HsSetValue가 호출되며, HsSetValue가 반환된 경우에만 HsGetValue가 호출됩니다.

HsGetValue 함수는 Essbase 데이터 소스와 함께 하나의 속성 차원 및 멤버 사용을 지원합니다. Oracle Smart View for Office 11.1.2.5.710 이상에서는 HsGetValue가 Planning, Planning 모듈, Financial Consolidation and Close, Tax Reporting 데이터 소스로 속성 지원을 확장합니다(예 18-2 참조).

Smart View 11.1.2.5.720 이상에서는 HsGetValue를 사용하여 스마트 목록, 텍스트, 날짜 같은 열거된 데이터 유형을 반환할 수 있습니다(예 18-3 참조).

Narrative Reporting 24.02 이상에서는 Excel 셀 참조를 사용하여 빌드된 HsGetValue() 함수에 대한 서버 시작 새로고침이 지원됩니다.

구문

개인 연결:

HsGetValue("PrivateConnectionName","POV")

공유 연결:

HsGetValue("WSFN|ProviderType|Server|Application|Database","POV")

URL 연결:

HsGetValue("URLFN|URL|Server|Application|Database","POV")

자세한 구문 정보는 수동으로 함수 생성을 참조하십시오.

예 18-1 속성이 사용되지 않은 예

클라우드 데이터 소스 유형: Essbase, Planning, Planning Modules, Financial Consolidation and Close, Tax Reporting, Narrative Reporting

온-프레미스 데이터 소스 유형: Essbase, Financial Management, Planning

이 예에서 HsGetValue는 기본 POV에 대한 HFM01 애플리케이션에서 값을 반환합니다.

개인 연결:

=HsGetValue("HFM01","Scenario#Actual","Year#2004","Period#July","View#YTD","Entity#UnitedStates.Connecticut","Value#USD","Account#Sales","ICP#[ICP None]","Custom1#GolfBalls","Custom2#Customer2","Custom3#[None]","Custom4#Increases")

공유 연결:

=HsGetValue("WSFN|HFM|hfm_svr|HFM01|HFM01","Scenario#Actual","Year#2004","Period#July","View#YTD","Entity#UnitedStates.Connecticut","Value#USD","Account#Sales","ICP#[ICP None]","Custom1#GolfBalls","Custom2#Customer2","Custom3#[None]","Custom4#Increases")

URL 연결:

=HsGetValue("URLFN|http://<servername:port>/hfmadf/../hfmadf/officeprovider|<servername:port>|HFM01|HFM01","Scenario#Actual","Year#2004","Period#July","View#YTD","Entity#UnitedStates.Connecticut","Value#USD","Account#Sales","ICP#[ICP None]","Custom1#GolfBalls","Custom2#Customer2","Custom3#[None]","Custom4#Increases")

예 18-2 속성이 사용된 예

클라우드 데이터 소스 유형: Essbase, Planning, Planning Modules, Financial Consolidation and Close, Tax Reporting

온-프레미스 데이터 소스 유형: Essbase

이 예에서는 HsGetValue가 Vision 애플리케이션, Plan1 데이터베이스의 값을 반환하며 POV에는 속성 차원 및 멤버, Entity_Regions#NA_Reg가 포함되어 있습니다.

주:

HsGetValue는 함수당 하나의 속성 차원 및 멤버만 지원합니다.

개인 연결:

=HsGetValue("Vision","Account#Amount","Period#Jan","Years#2017","Scenario#Annual Contract","Version#Final","Entity#AR02-Argentina-IS_Adjustments","Package#Depreciation","Currency#Local Currency","Entity_Regions#NA_Reg")

공유 연결:

=HsGetValue("WSFN|HP|serviceURL|Vision|Plan1","Account#Amount","Period#Jan","Years#2017","Scenario#Annual Contract","Version#Final","Entity#AR02-Argentina-IS_Adjustments","Package#Depreciation","Currency#Local Currency","Entity_Regions#NA_Reg")

URL 연결:

=HsGetValue("URLFN|https://<servername:port>/HyperionPlanning/SmartView
|<servername:port>|Vision|Plan1","Account#Amount","Period#Jan","Years#2017","Scenario#Annual Contract","Version#Final","Entity#AR02-Argentina-IS_Adjustments","Package#Depreciation","Currency#Local Currency","Entity_Regions#NA_Reg")

예 18-3 스마트 목록이 사용된 예

클라우드 데이터 소스 유형: Planning, Planning 모듈, Financial Consolidation and Close, Tax Reporting

이 예에서는 HsGetValue가 Vision 애플리케이션, Plan1 데이터베이스의 스마트 목록 값을 반환합니다. 이 경우 스마트 목록은 정리 및 유지관리를 위한 드라이버 값을 찾습니다. 반환 가능한 값은 "수익 %", "단위", "FTE 시간", "영업 콜", "출장", "평방피트" 및 "없음"입니다.

개인 연결:

=HsGetValue("Vision","Account#7440: Cleaning and Maintenance","Period#x---------x","HSP_View#BaseData","Year#FY15","Scenario#Plan","Version#Driver","Entity#No Entity","Product#No Product")

공유 연결:

=HsGetValue("WSFN|HP|serviceURL|Vision|Plan1","Account#7440: Cleaning and Maintenance","Period#x---------x","HSP_View#BaseData","Year#FY15","Scenario#Plan","Version#Driver","Entity#No Entity","Product#No Product")

URL 연결:

=HsGetValue("URLFN|https://<servername:port>/HyperionPlanning/SmartView|<servername:port>|Vision|Plan1","Account#7440: Cleaning and Maintenance","Period#x---------x","HSP_View#BaseData","Year#FY15","Scenario#Plan","Version#Driver","Entity#No Entity","Product#No Product")

예 18-4 데이터 소스 연결에 대한 셀 참조가 포함된 예

Excel 파일에서 데이터 소스 연결에 대한 셀 참조를 사용하여 빌드된 HsGetValue 함수는 URL 연결 형식을 사용하여 함수에 대한 연결을 정의합니다.

URLFN|URL:Port|Server|Application|Database

주:

개인 연결 이름을 가리키는 셀 참조를 사용하는 HsGetValue 함수가 워크북에 포함된 경우에는 개인 연결이 시스템 간에 이식 가능하지 않으므로 서버 시작 새로고침이 지원되지 않습니다. 해당 함수를 변환하여 URLFN 형식을 사용하는 것이 좋습니다.

다음 예에서는 셀 B1에 연결 정보가 포함된다고 가정합니다. 접두어로 URLFN을 추가하여 다음 형식으로 연결 정보를 입력합니다.

URLFN|http://<serviceURL>:<port>/HyperionPlanning/SmartView|<serverName>|App|Database

그런 다음, 셀 B1을 참조하는 연결 매개변수를 사용하여 다음과 같이 함수를 빌드합니다.

=HsGetValue(B1,"Scenario#Actual","Year#2004","Period#July","View#YTD","Entity#UnitedStates.Utah","Value#USD","Account#Sales","ICP#[ICP None]","Custom1#GolfBalls","Custom2#Customer2","Custom3#[None]","Custom4#Increases")