PSGC Terminology FHIR Implementation Guide - Local Development build (v0.1.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

Testing Guidance

This page provides guidance for implementers testing conformance to this IG.

Validation Test Cases

Test	Input	Expected
Known code, latest version	$validate-code(code=1300000000)	result=true, display="NCR"
Known code, specific version	$validate-code(system\|Q4_2024, code=1800000000)	result=false (NIR not in Q4 2024)
Unknown code	$validate-code(code=9999999999)	result=false
Short code (padded)	$validate-code(code=13006)	result=true (padded to 1300600000)

Hierarchy Test Cases

Test	Input	Expected
Region subsumes barangay	$subsumes(codeA=0100000000, codeB=0102801001)	outcome=subsumes
Same code	$subsumes(codeA=X, codeB=X)	outcome=equivalent
Unrelated codes	$subsumes(codeA=01..., codeB=13...)	outcome=not-subsumed

Property Test Cases

$lookup(code=0102801001) SHALL return:

• display: "Adams"
• property[level]: "Bgy"
• property[parent]: "0102801000"

Evolution Test Cases

Test	Source	Target	Expected
Maguindanao split	Q2_2021	Q3_2022	code 1500000000 → narrower (2 targets)
NIR abolished	Q1_2023	Q4_2024	1800000000 → unmatched
Stable code	any	any	1300000000 → equal (NCR always exists)

Reference Implementation

The HAPI FHIR PSGC plugin includes a full test suite demonstrating these cases. See:

• PsgcValidationSupportTest — properties and parent derivation
• PsgcGeoProviderSubsumesTest — hierarchy testing
• PsgcEvolutionServiceTest — evolution diff logic
• PsgcMassLoadTest — boundary conditions across 12 releases