Skip to content

Fix ORDS docs on the withheld problem column - #59

Merged
ardelato merged 1 commit into
hermesfrom
fix/ords-docs-column-shape
Aug 14, 2026
Merged

Fix ORDS docs on the withheld problem column#59
ardelato merged 1 commit into
hermesfrom
fix/ords-docs-column-shape

Conversation

@ardelato

@ardelato ardelato commented Aug 7, 2026

Copy link
Copy Markdown
Collaborator

Description

Docs clarification, no code change.

ORDS_INCLUDE_PROBLEM empties the problem column, it doesn't remove it.

The docs from #58 said to expect thirteen columns with the flag off, but it's always fourteen: OrdsRecordMapper::COLUMNS is a fixed list and the CSV header is written from it. A withheld problem comes back null in JSON and as an empty cell in CSV, same as any other column with no value.

qa_req 0

ORDS_INCLUDE_PROBLEM withholds the value, not the column. The docs said
the export drops to thirteen columns with the flag off, which would read
to a consumer as non-conformance with a standard that defines fourteen.

The mapper emits a fixed column list and the CSV header is a constant, so
the shape never varies. A withheld problem comes back null in JSON and as
an empty cell in CSV, the same as any other column with no value.
@ardelato
ardelato merged commit 0fc6226 into hermes Aug 14, 2026
@ardelato
ardelato deleted the fix/ords-docs-column-shape branch August 14, 2026 17:06
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants