2 May 2026

Using GET_VALUE_SET in a BI Publisher Data Model

Advised Solutions - Business Analytics Series

Using Miscellaneous Fast Formula Functions in BI Publisher

GET_VALUE_SET streamlines Oracle BI Publisher data models by tapping into table-validated value sets for secure, dynamic lookups, eliminating redundant SQL in reports.

Core Function Mechanics

GET_VALUE_SET(value_set_code, bind_string) pulls the first row from a table value set. The bind string supplies parameters like |=P_PERSON_ID='12345'|P_DATE='2025-12-31', which filter the value set’s WHERE clause for targeted results such as HCM balances or employee details.

Data Model Integration

Embed it in BI Publisher derived columns or expressions:

  • Build binds dynamically: '|=P_EMPLOYEE_ID=' || :p_emp_id || '|P_PERIOD=' || :p_period.

  • Invoke GET_VALUE_SET('MY_VALUE_SET', bind_str) for runtime resolution.

  • Output becomes straightforward fields for templates, syncing reports with centralized value set rules.

SQL Testing Example

Debug or directly use pay_ff_functions.gvs in a BI Publisher data model SQL query from DUAL:

				
					SELECT pay_ff_functions.gvs('XX_GET_PERSON_NUM','|=PERSON_ID=900000088911218') AS person_number
FROM dual;

				
			

This mirrors fast formula behavior, testing value sets like assignment lookups before report deployment.

Key Tips

    • Limit value sets to one row per bind to capture the correct data.

    • Null-proof with NVL(GET_VALUE_SET(...), 'DEFAULT').

    • Switch to SQL views for multi-row needs; pair with fast formulas for HCM contexts.​

Need some assistance?

Ready to bring clarity to customer, supplier and employee communications? With BI Publisher, we specialise in customising customer, supplier, and employee-facing documents such as invoices, purchase orders, payslips, and statements to meet your exact branding, compliance, and operational needs. From layout design to data logic enhancements, we help you deliver clear, consistent, and impactful outputs across your organization. Contact us today to discover how our expertise in BI Publisher can streamline your document processes and elevate your business communications.