View Issue Details

IDProjectCategoryView StatusLast Update
001015310000-006: MappingsSpecpublic2025-05-27 16:35
ReporterBjarneBostrom Assigned ToRandy Armstrong  
PrioritynormalSeverityminorReproducibilityalways
Status closedResolutionfixed 
Product Version1.05.04 
Fixed in Version1.05.06 RC1 
Summary0010153: Section 5.4.1 text (JSON General) should clarifiy 'fields' to be Structure or JSON fields
Description

https://reference.opcfoundation.org/Core/Part6/v105/docs/5.4.1 first says:
"The JSON format is defined in RFC 8259. It is partially self-describing because each field has a name encoded in addition to the value..."
which can make one think 'field' later mean a JSON field, but then it says in a later paragraph
"The CompactEncoding omits all fields with a value equal to the default value for the type. The VerboseEncoding includes all fields."

It is possible to interpret that to mean ALL JSON fields. However, based on the PubSub new JSON formats Plugfest, I think here actually 'Structure fields' are intended instead. Because e.g. DataValue (https://reference.opcfoundation.org/Core/Part6/v105/docs/5.4.2.18) e.g. for the status field it says "Not encoded if the value is Good (0).", which would have conflicted the wording if it would have been about JSON fields (i.e. do you or not put it in Verbose when it is 0). If the wording is changed to something like:
"The CompactEncoding omits all Structure fields with a field value equal to the default value for the field type. The VerboseEncoding includes all Structure fields."
it shouldn't be ambiguous anymore.

TagsNo tags attached.
Commit Version
Fix Due Date

Activities

Matthias Damm

2025-02-13 14:37

developer   ~0022393

Agreed in MQTT plug-fest wrap up that "The CompactEncoding omits all fields with" should be more precise since fields in built-in types have their own rules

Randy Armstrong

2025-05-21 07:52

administrator   ~0022754

Added additional text.

Jim Luth

2025-05-27 16:35

administrator   ~0022799

Agreed to changes in Web meeting.

Issue History

Date Modified Username Field Change
2025-02-12 11:34 BjarneBostrom New Issue
2025-02-13 14:36 Matthias Damm Assigned To => Randy Armstrong
2025-02-13 14:36 Matthias Damm Status new => assigned
2025-02-13 14:37 Matthias Damm Note Added: 0022393
2025-05-21 07:52 Randy Armstrong Status assigned => resolved
2025-05-21 07:52 Randy Armstrong Resolution open => fixed
2025-05-21 07:52 Randy Armstrong Note Added: 0022754
2025-05-27 16:35 Jim Luth Status resolved => closed
2025-05-27 16:35 Jim Luth Fixed in Version => 1.05.06 RC1
2025-05-27 16:35 Jim Luth Note Added: 0022799