Portfolio metrics become useful only after the operating team agrees on what each category means, where it applies and what evidence supports it. Editorial image; source metadata and non-documentary-use limits are recorded in the package.
A portfolio report shows that one facility logged 42 access exceptions last month. Another logged nine. A third logged none.
The easy conclusion is that the first property has a problem. The harder and more useful question is whether the three sites classified the same conditions the same way.
At one site, “access exception” may mean a gate controller was unavailable. At another, it may include a customer entering the wrong code. A third manager may record only events that required a vendor visit. If each system also offers an “Other” option, the report can look precise while hiding several incompatible definitions.
This is not a dashboard problem. It is a reason-code governance problem.
Before comparing facilities, the operating team needs a controlled definition for each portfolio concept, a versioned mapping from local codes, an evidence rule and a place to put records that do not map cleanly. The purpose is not to force every property into identical language. It is to make the differences visible enough that a comparison can be defended.
A label is not a definition
Two systems can display “Gate issue” and mean different things. One may use it for physical gate-equipment failure. Another may use it for any unsuccessful access attempt, including a customer authorization state that worked exactly as configured.
The reverse is also true. “Controller offline,” “access hardware unavailable” and “gate communications lost” may describe the same portfolio concept, depending on the local definitions and evidence.
Comparability therefore starts with a stable concept identifier, not the wording shown to a manager. Each portfolio code should have:
- a unique identifier;
- one preferred label;
- a plain-language definition;
- explicit inclusion and exclusion rules;
- required supporting evidence;
- a semantic owner who controls meaning;
- an operational owner who controls use;
- a version and effective period;
- a parent category, if hierarchy is useful; and
- separate fields for severity, suspected cause, customer state and outcome.
Those last separations matter. “High priority” is not a reason. “Power outage” may be a suspected cause rather than an observed condition. “Resolved on site” is an outcome. “Delinquent account” is a customer authorization state. If they all compete in one reason-code field, the portfolio loses the ability to distinguish what happened from why it may have happened and how it ended.
Preserve local language without surrendering portfolio meaning
A central taxonomy does not require every site to abandon the terms its team understands. Preserve the local code and label exactly as recorded. Then map that local record to a governed portfolio concept.
The mapping should state the relationship:
- Exact: The local definition and the portfolio definition match within the approved scope.
- Narrower: The local code describes a more specific case inside the portfolio concept.
- Broader: The local code includes cases outside the portfolio concept and cannot be counted without another filter.
- Related only: The concepts are associated but are not interchangeable.
- Ambiguous: The local label or definition supports more than one interpretation.
- Unmapped: No approved portfolio concept applies.
Do not turn broader, related, ambiguous or unmapped into exact because the dashboard needs a number. That decision creates false comparability.
The World Wide Web Consortium’s SKOS model is useful here as a design reference. It separates preferred and alternative labels, supports broader and narrower relationships, and distinguishes mapping relationships such as exact, close, broad and narrow matches. An operator does not need to implement RDF or publish a formal semantic-web vocabulary to use the lesson: labels, concepts, hierarchies and mappings are different objects.
“Other” is a queue, not a category
“Other” is sometimes necessary at the point of entry. A manager should not be forced to select a false reason just to close a form. But the portfolio should treat “Other” as a controlled exception state that requires review.
Every “Other” record should capture a short factual description, the source event, the person or system that classified it, and the review owner. The review can then produce one of four outcomes:
- map the record to an existing code;
- correct the source selection because the wrong code was used;
- propose a new or revised code through change control; or
- retain it as unmapped with a documented reason.
Set an operating threshold for review, not an invented industry benchmark. For example, the portfolio may choose to review when a facility’s “Other” share exceeds its approved internal limit or when the same free-text description repeats. That threshold is a management control, not proof that the facility is performing poorly.
An “Other” rate can reveal a weak code set, poor training, a recent system change or genuinely novel work. It does not identify the cause by itself.
Version the meaning, not just the menu
Reason codes change. A broad “Access problem” option may be replaced by separate equipment, communications and authorization concepts. A code may be retired because managers applied it inconsistently. A vendor migration may introduce new local labels.
Each change needs an effective date, a version identifier, a change note and a historical-treatment decision. The W3C Data Catalog Vocabulary, version 3, provides a general reference pattern for version identifiers, previous and current versions, version notes and resource status. It is designed for data catalogs, not self-storage reason-code governance, but the versioning principle transfers cleanly.
Do not overwrite the old definition in place and pretend the meaning was always the same. Preserve the old version. Identify its replacement. State whether old records remain under the original definition, can be mechanically remapped, require sampled review or must be excluded from trend comparison.
Historical restatement is a separate decision. A new mapping may improve future comparability without authorizing anyone to rewrite prior reports. Record who can approve a backfill, which periods are affected and how the revised series will be labeled.
Put three owners around every change
Reason-code governance often fails because one person owns the dropdown but no one owns the meaning.
Use three named responsibilities:
- Semantic owner: Defines the concept, boundaries, relationships and version changes.
- Operational owner: Confirms that the code can be applied consistently in the facility workflow and that the evidence is practical.
- Reporting owner: Controls when the mapped data becomes eligible for comparison and how changes affect dashboards and historical series.
One person may hold more than one role in a small organization, but the decisions should remain distinct. Editing a menu is not the same as approving a portfolio definition. Approving a definition is not the same as releasing a revised trend line.
The NIST Cybersecurity Framework 2.0 is not a taxonomy standard for self-storage. Its governance and improvement outcomes do, however, reinforce a general control principle: roles, responsibilities, authorities, policies and improvement activity should be established and communicated. Here, that means every code change has an owner, an approval path and a review cycle.
A fictional portfolio example
The following portfolio, facilities, systems, codes, records and outcomes are fictional teaching material.
Fictional Northline Storage Group receives three local labels from three properties:
- Pine Cross uses
GATE-ISSUEfor both gate-equipment unavailability and customer authorization denials. - Mill Yard uses
CTRL-OFFLINEonly when a controller-health source reports the device unavailable. - Harbor Annex uses
OTHERwith free text reading “code would not work.”
The portfolio team does not map all three to FACILITY_ACCESS_DEVICE_UNAVAILABLE.
Mill Yard’s definition is narrower and has the required equipment-state evidence, so the mapping is approved as exact for portfolio reporting. Pine Cross’s code is broader because it mixes an equipment condition with customer authorization. It is marked broader — not comparison eligible until the local workflow separates those cases or another governed field can distinguish them. Harbor Annex remains ambiguous — review required because the free text does not establish whether the device was unavailable, the credential was entered incorrectly or the customer was not authorized.
The dashboard counts only the Mill Yard record in the equipment-unavailability measure. Pine Cross and Harbor Annex remain visible in the mapping-quality queue. No facility is scored as better or worse from these three rows.
This is slower than forcing all three records into one bucket. It is also honest.
Use the register as a release gate
The accompanying Portfolio Exception-Code Definition, Mapping and Retirement Register gives the team one place to manage concepts, local mappings, change decisions and historical treatment.
Before a code enters a cross-facility report, confirm:
- the portfolio definition is active for the reporting period;
- the local definition and version are known;
- the mapping relationship is approved;
- required evidence exists;
- severity, cause, customer state and outcome are not being smuggled into the reason field;
- ambiguous and unmapped records remain outside the comparable count; and
- any historical change has an explicit backfill or no-restatement decision.
Then monitor mapping quality alongside the operating metric. Report the share of records that are exact, narrower with an approved roll-up, ambiguous, unmapped and “Other.” A portfolio total without mapping coverage tells leadership less than it appears to.
Comparable data starts before the chart
The most dangerous reporting errors are not always arithmetic. They are semantic: the numbers add correctly, but the rows do not mean the same thing.
A governed reason-code system prevents that error by keeping local evidence, portfolio meaning, mapping confidence and version history together. It gives managers a safe “unknown” path instead of rewarding guesses. It also gives reporting teams a clear rule for what may enter a comparison.
If every site chooses “Other,” the answer is not to delete the option. The answer is to inspect what the portfolio has failed to define.
Sources
- SKOS Simple Knowledge Organization System Reference, World Wide Web Consortium.
- Data Catalog Vocabulary (DCAT) — Version 3, World Wide Web Consortium.
- The NIST Cybersecurity Framework (CSF) 2.0, National Institute of Standards and Technology.
Disclosure
Northline Storage Group, Pine Cross, Mill Yard, Harbor Annex and every code, system, record, definition, owner, threshold and outcome in the article and dataset are fictional. The article proposes an operating method. It does not claim an industry standard, customer deployment, software feature, measured performance result, certification, legal conclusion or compliance outcome.
Companion operating tools
The governed register, blank template and fictional example are rendered accessibly below. They are operating aids, not proof of a real deployment, customer, facility result, industry benchmark or compliance state.
portfolio exception code definition mapping and retirement register
Use this register to govern the meaning of portfolio reason codes, map local codes without erasing them, control version changes and keep ambiguous records out of unsupported comparisons.
Record types
- PORTFOLIO_CONCEPT: Defines one governed portfolio reason code.
- LOCAL_MAPPING: Connects a local source code and version to a portfolio concept.
- CHANGE_DECISION: Records a new, revised, replaced or retired definition.
- QUALITY_REVIEW: Records mapping coverage, “Other” volume, ambiguity and follow-up.
Minimum definition fields
- Stable portfolio code
- Preferred label
- Plain-language definition
- Inclusion rule
- Exclusion rule
- Required evidence
- Parent code, if used
- Allowed alternate labels
- Semantic owner
- Operational owner
- Reporting owner
- Version and effective period
Keep severity, suspected root cause, customer state and outcome in separate fields. They may be analytically related, but they are not substitutes for the observed reason concept.
Mapping relations
- exact: Local and portfolio definitions match within the approved scope.
- narrower: Local concept is more specific and may roll up only under the approved rule.
- broader: Local concept includes out-of-scope cases; do not count without another governed discriminator.
- related: Concepts are associated but not interchangeable.
- ambiguous: Available definition or evidence supports multiple interpretations.
- unmapped: No approved portfolio concept applies.
Release states
- comparison eligible: Approved definition, version, mapping and evidence requirements pass.
- review required: A qualified owner must resolve ambiguity, “Other” or missing evidence.
- excluded: The record is outside the portfolio measure’s defined scope.
- retired: The code is no longer valid for new records; historical treatment remains documented.
Change sequence
- Preserve the current version and its effective period.
- Open a change request with examples and the operating reason.
- Review semantic, workflow and reporting effects separately.
- Name any replacement code and mapping relationship.
- Decide whether historical rows remain as originally classified, are mechanically backfilled, need sampled adjudication or are excluded from trend comparison.
- Validate a bounded sample before release.
- Publish the effective date and training/update owner.
- Monitor unmapped, ambiguous and “Other” shares after release.
A completed register documents governance. It does not prove that a local record is true, that a cause was established or that a facility performed better or worse.
portfolio exception code register template
portfolio exception code register template
- record id
- record type
- fictional record
- portfolio id
- facility id
- source system
- source field
- local code
- local label
- local definition
- local version
- local effective start
- local effective end
- portfolio code
- portfolio preferred label
- portfolio definition
- portfolio version
- parent code
- allowed alternate labels
- mapping relation
- mapping state
- comparison eligibility
- semantic owner
- operational owner
- reporting owner
- evidence required
- inclusion rule
- exclusion rule
- unknown handling
- severity separate
- root cause separate
- outcome separate
- customer state separate
- valid from
- valid to
- change request id
- change reason
- previous code
- replacement code
- backfill policy
- historical restatement policy
- record count impacted
- validation sample size
- validation result
- unmapped rate threshold
- other rate threshold
- monitoring period
- review owner
- reviewed at
- approval state
- approved by
- approved at
- source evidence ref
- limitations
- notes
portfolio exception code register fictional example
portfolio exception code register fictional example — record 1
- record id
- FIC-PORT-001
- record type
- PORTFOLIO_CONCEPT
- fictional record
- true
- portfolio id
- FIC-NORTHLINE
- facility id
- source system
- source field
- local code
- local label
- local definition
- local version
- local effective start
- local effective end
- portfolio code
- FACILITY_ACCESS_DEVICE_UNAVAILABLE
- portfolio preferred label
- Facility access device unavailable
- portfolio definition
- An identified facility access device is observed unavailable for its designed access-control function
- portfolio version
- 3.0
- parent code
- FACILITY_ACCESS_EXCEPTION
- allowed alternate labels
- controller offline|access hardware unavailable
- mapping relation
- not applicable
- mapping state
- active
- comparison eligibility
- comparison eligible
- semantic owner
- Fictional data governance lead
- operational owner
- Fictional regional operations lead
- reporting owner
- Fictional reporting lead
- evidence required
- Device identity plus governing device-health or approved field-verification record
- inclusion rule
- Observed device unavailable during defined period
- exclusion rule
- Customer authorization denial or unverified user-entry error
- unknown handling
- Retain as unknown and route to review when required evidence is missing
- severity separate
- yes
- root cause separate
- yes
- outcome separate
- yes
- customer state separate
- yes
- valid from
- 2026-10-01
- valid to
- change request id
- FIC-CHG-009
- change reason
- Separate observed equipment state from authorization and user-entry conditions
- previous code
- FACILITY_ACCESS_PROBLEM
- replacement code
- backfill policy
- no historical backfill without separate approval
- historical restatement policy
- no restatement approved
- record count impacted
- 0
- validation sample size
- 12
- validation result
- passed fictional definition review
- unmapped rate threshold
- 0.03
- other rate threshold
- 0.05
- monitoring period
- monthly
- review owner
- Fictional taxonomy review group
- reviewed at
- 2026-09-28T14:00:00-04:00
- approval state
- approved
- approved by
- Fictional governance chair
- approved at
- 2026-09-29T10:00:00-04:00
- source evidence ref
- FIC-POLICY-TAXONOMY-3
- limitations
- Entire portfolio concept owner policy and review are fictional. This row does not establish an industry definition or real implementation.
- notes
- Fictional portfolio definition
portfolio exception code register fictional example — record 2
- record id
- FIC-MAP-002
- record type
- LOCAL_MAPPING
- fictional record
- true
- portfolio id
- FIC-NORTHLINE
- facility id
- FIC-MILL-YARD
- source system
- Fictional access-monitoring export
- source field
- exception_code
- local code
- CTRL-OFFLINE
- local label
- Controller offline
- local definition
- Selected only when the controller-health source reports the identified controller unavailable
- local version
- 2.4
- local effective start
- 2026-08-01
- local effective end
- portfolio code
- FACILITY_ACCESS_DEVICE_UNAVAILABLE
- portfolio preferred label
- Facility access device unavailable
- portfolio definition
- An identified facility access device is observed unavailable for its designed access-control function
- portfolio version
- 3.0
- parent code
- FACILITY_ACCESS_EXCEPTION
- allowed alternate labels
- controller offline
- mapping relation
- exact
- mapping state
- approved
- comparison eligibility
- comparison eligible
- semantic owner
- Fictional data governance lead
- operational owner
- Fictional Mill Yard operations lead
- reporting owner
- Fictional reporting lead
- evidence required
- Device identity plus governing controller-health record
- inclusion rule
- Controller-health state unavailable during defined period
- exclusion rule
- Customer authorization denial or unverified user-entry error
- unknown handling
- Missing evidence remains unknown and outside comparable count
- severity separate
- yes
- root cause separate
- yes
- outcome separate
- yes
- customer state separate
- yes
- valid from
- 2026-10-01
- valid to
- change request id
- FIC-MAP-REVIEW-044
- change reason
- Initial approved mapping
- previous code
- replacement code
- backfill policy
- not applicable
- historical restatement policy
- no historical restatement approved
- record count impacted
- 18
- validation sample size
- 12
- validation result
- 12 of 12 fictional sampled rows met required evidence
- unmapped rate threshold
- 0.03
- other rate threshold
- 0.05
- monitoring period
- monthly
- review owner
- Fictional taxonomy review group
- reviewed at
- 2026-09-28T14:15:00-04:00
- approval state
- approved
- approved by
- Fictional governance chair
- approved at
- 2026-09-29T10:05:00-04:00
- source evidence ref
- FIC-MILL-YARD-CODEBOOK-2.4
- limitations
- All facility system codes counts evidence and outcomes are fictional. Sample result is illustrative and not performance evidence.
- notes
- Exact mapping for teaching example
portfolio exception code register fictional example — record 3
- record id
- FIC-MAP-003
- record type
- LOCAL_MAPPING
- fictional record
- true
- portfolio id
- FIC-NORTHLINE
- facility id
- FIC-PINE-CROSS
- source system
- Fictional incident form
- source field
- primary_reason
- local code
- GATE-ISSUE
- local label
- Gate issue
- local definition
- Used for equipment unavailability customer authorization denial and user-entry error
- local version
- 1.7
- local effective start
- 2026-05-15
- local effective end
- portfolio code
- FACILITY_ACCESS_DEVICE_UNAVAILABLE
- portfolio preferred label
- Facility access device unavailable
- portfolio definition
- An identified facility access device is observed unavailable for its designed access-control function
- portfolio version
- 3.0
- parent code
- FACILITY_ACCESS_EXCEPTION
- allowed alternate labels
- gate issue
- mapping relation
- broader
- mapping state
- review required
- comparison eligibility
- not comparison eligible
- semantic owner
- Fictional data governance lead
- operational owner
- Fictional Pine Cross operations lead
- reporting owner
- Fictional reporting lead
- evidence required
- Device evidence and a separate discriminator for equipment authorization or user-entry state
- inclusion rule
- Only records with verified device unavailability could qualify
- exclusion rule
- Authorization denial and user-entry error are excluded
- unknown handling
- Retain local code and route to workflow redesign; do not force map
- severity separate
- yes
- root cause separate
- yes
- outcome separate
- yes
- customer state separate
- yes
- valid from
- 2026-10-01
- valid to
- change request id
- FIC-MAP-REVIEW-045
- change reason
- Local code combines three different concepts
- previous code
- replacement code
- backfill policy
- not applicable
- historical restatement policy
- no historical restatement approved
- record count impacted
- 37
- validation sample size
- 12
- validation result
- Fictional sample confirmed mixed use
- unmapped rate threshold
- 0.03
- other rate threshold
- 0.05
- monitoring period
- monthly
- review owner
- Fictional taxonomy review group
- reviewed at
- 2026-09-28T14:30:00-04:00
- approval state
- pending
- approved by
- Fictional governance chair
- approved at
- source evidence ref
- FIC-PINE-CROSS-CODEBOOK-1.7
- limitations
- All facility system codes counts evidence and outcomes are fictional. Pending does not authorize portfolio comparison.
- notes
- Broader mapping remains out of comparable count
portfolio exception code register fictional example — record 4
- record id
- FIC-MAP-004
- record type
- LOCAL_MAPPING
- fictional record
- true
- portfolio id
- FIC-NORTHLINE
- facility id
- FIC-HARBOR-ANNEX
- source system
- Fictional manager log
- source field
- reason_code
- local code
- OTHER
- local label
- Other
- local definition
- Free-text reason when no listed option is selected
- local version
- 5.1
- local effective start
- 2026-07-01
- local effective end
- portfolio code
- FACILITY_ACCESS_DEVICE_UNAVAILABLE
- portfolio preferred label
- Facility access device unavailable
- portfolio definition
- An identified facility access device is observed unavailable for its designed access-control function
- portfolio version
- 3.0
- parent code
- FACILITY_ACCESS_EXCEPTION
- allowed alternate labels
- other
- mapping relation
- ambiguous
- mapping state
- review required
- comparison eligibility
- not comparison eligible
- semantic owner
- Fictional data governance lead
- operational owner
- Fictional Harbor Annex operations lead
- reporting owner
- Fictional reporting lead
- evidence required
- Free text plus source-event evidence sufficient to distinguish equipment authorization and user-entry state
- inclusion rule
- Only reviewed records with verified device unavailability could qualify
- exclusion rule
- Unreviewed free text is excluded
- unknown handling
- Retain as ambiguous until factual review resolves or leaves unmapped
- severity separate
- yes
- root cause separate
- yes
- outcome separate
- yes
- customer state separate
- yes
- valid from
- 2026-10-01
- valid to
- change request id
- FIC-MAP-REVIEW-046
- change reason
- Free text code would not work does not establish an equipment condition
- previous code
- replacement code
- backfill policy
- case-by-case adjudication only
- historical restatement policy
- no historical restatement approved
- record count impacted
- 11
- validation sample size
- 11
- validation result
- 0 of 11 fictional rows had sufficient evidence for automatic mapping
- unmapped rate threshold
- 0.03
- other rate threshold
- 0.05
- monitoring period
- weekly
- review owner
- Fictional taxonomy review group
- reviewed at
- 2026-09-28T14:45:00-04:00
- approval state
- pending
- approved by
- Fictional governance chair
- approved at
- source evidence ref
- FIC-HARBOR-LOG-5.1
- limitations
- All facility system codes counts evidence and outcomes are fictional. Zero automatic mappings is an invented teaching result and not a real performance claim.
- notes
- Ambiguous mapping remains out of comparable count
portfolio exception code register fictional example — record 5
- record id
- FIC-CHG-005
- record type
- CHANGE_DECISION
- fictional record
- true
- portfolio id
- FIC-NORTHLINE
- facility id
- FIC-PINE-CROSS
- source system
- Fictional incident form
- source field
- primary_reason
- local code
- GATE-ISSUE
- local label
- Gate issue
- local definition
- Legacy mixed-use code
- local version
- 1.7
- local effective start
- 2026-05-15
- local effective end
- 2026-10-31
- portfolio code
- FACILITY_ACCESS_DEVICE_UNAVAILABLE
- portfolio preferred label
- Facility access device unavailable
- portfolio definition
- An identified facility access device is observed unavailable for its designed access-control function
- portfolio version
- 3.0
- parent code
- FACILITY_ACCESS_EXCEPTION
- allowed alternate labels
- gate issue
- mapping relation
- broader
- mapping state
- retiring
- comparison eligibility
- not comparison eligible
- semantic owner
- Fictional data governance lead
- operational owner
- Fictional Pine Cross operations lead
- reporting owner
- Fictional reporting lead
- evidence required
- Approved replacement definitions and staff update evidence
- inclusion rule
- New records use separate equipment authorization and user-entry codes
- exclusion rule
- Legacy mixed-use code prohibited for records on or after retirement
- unknown handling
- Unknown remains available under a separate reviewed state
- severity separate
- yes
- root cause separate
- yes
- outcome separate
- yes
- customer state separate
- yes
- valid from
- 2026-10-01
- valid to
- 2026-10-31
- change request id
- FIC-CHG-010
- change reason
- Retire mixed-use code after approved local workflow update
- previous code
- GATE-ISSUE
- replacement code
- DEVICE-UNAVAILABLE|AUTH-DENIED|ENTRY-ERROR
- backfill policy
- Preserve historical rows under version 1.7 unless separately adjudicated
- historical restatement policy
- no restatement approved
- record count impacted
- 37
- validation sample size
- 12
- validation result
- Fictional replacement-code validation pending
- unmapped rate threshold
- 0.03
- other rate threshold
- 0.05
- monitoring period
- weekly for first fictional month
- review owner
- Fictional taxonomy review group
- reviewed at
- 2026-09-28T15:00:00-04:00
- approval state
- approved
- approved by
- Fictional governance chair
- approved at
- 2026-09-29T10:15:00-04:00
- source evidence ref
- FIC-PINE-CROSS-CHANGE-010
- limitations
- All facilities codes counts approvals and outcomes are fictional. Retirement does not prove training workflow adoption or better performance.
- notes
- Effective dates keep old and new meanings separate
