mirror of
https://github.com/OPCFoundation/UA-.NETStandard.git
synced 2026-10-18 14:43:08 +08:00
Marc Schier
55bd944609
# Description Adds the pure Types-side WoT Thing Description / Thing Model to NodeSet conversion: resolution, context, declarations, types, values, localization, URI/format handling, bounded hashing, plus supporting native XML codec, NodeSet alias/value helpers, RelativePathFormatter and a JsonElement equality polyfill. - Carrier-witness fix: a missing native event is accepted only when the owning preserved type declares it through a `GeneratesEvent` reference (directly or via its type/supertype chain) AND a bounded, validated selected EventType carrier identity equals the normalized authored native target. Native-present events get a full compare; an ambiguous native key and a missing map stay strict; a readable document is never archive authority. - Support-only dependencies: additive per-instance, non-serialized `WotDocument.IsSupportOnly(kind, name)` (ArgumentNullException guard). The resolver marks support-only after closure; explicit selection wins; the View builder excludes only true support-only members, so unit/actsOn dependencies stay in the JSON. Nested controls cover inner value-only projection under an outer value-only selection (unit kept, support-only) versus an outer explicit SelectAll (explicit, not support-only). - Documentation/XML comments and member-order only in commit 5c368d3a; no logic change. - Timeout repair on current head6957dd46: invocation-scoped `ArchiveDerivations` reuse removes repeated document-set derivation work without a global cache (functional files `WotNodeSetConverter.{Archive,ArchiveDerivations,Partitions,WoT}.cs`, plus `WotArchiveDerivationsTests` and `WotDocumentSetSharedValidationTests`). The original local full29 reproduction changed from 27 passed / 2 Refresh timeouts to 29 passed with unchanged limits; official CI on this head FAILED at three per-project time ceilings (see the evidence ledger). Temporary RF1 diagnostics were fully removed; the final tree differs from0f7b9a09only in the six functional files. - Test-only net48 compile repair in commitb838907(earlier head): official CI on5c368d3awas RED on the net48 build with CS1061 (see ledger); the fix adds `using System.Threading;` and an unqualified `CancellationTokenSource` in one test file. No production change. Defaults: DI default document budget 256 versus the sample's explicit 1024. Corpus: canonical 540-JSON inventory; the actual manifest is 535 entries = 394 TD + 141 TM (the roles of the other 5 are not claimed). Native Pumps assertions (9624 nodes / 339 partitions) are unchanged.
69 lines
3.0 KiB
Markdown
69 lines
3.0 KiB
Markdown
# WoT / NodeSet conversion
|
|
|
|
`Opc.Ua.Wot.WotNodeSetConverter` converts OPC UA NodeSet2 documents to
|
|
WoT Thing Models / Thing Descriptions and materializes WoT documents back
|
|
to NodeSet2. The sections of the conversion guidance live in
|
|
[WoT bindings and conversion](WotBindings.md); the anchors below preserve
|
|
existing links.
|
|
|
|
For SDK callers, `ToNodeSetWithResolversAsync` converts a complete
|
|
`WotDocumentSet` with caller-supplied thing/schema resolution while preserving
|
|
set-local precedence. It performs no transport I/O itself.
|
|
|
|
## Contents
|
|
|
|
<a id="contents"></a>
|
|
<a id="which-specification-revision-this-tracks"></a>
|
|
<a id="conformance-claims-and-strict-mode-sections-41-61-66-and-11"></a>
|
|
<a id="authoring-a-claim-and-processing-one-are-different-acts"></a>
|
|
<a id="the-uavnodes-record-grammar-is-not-vocabulary"></a>
|
|
<a id="generated-documents-state-the-revision-they-were-generated-against"></a>
|
|
<a id="nodeclass-and-referencetype-vocabulary"></a>
|
|
<a id="model-and-platform-vocabulary-section-6"></a>
|
|
<a id="opaque-object-bounds"></a>
|
|
|
|
- [Revision, claims, vocabulary, and bounds](WotBindings.md#conformance-and-authoring-validation)
|
|
|
|
<a id="importable-output"></a>
|
|
<a id="verified-linked-document-sets"></a>
|
|
<a id="resolving-a-stated-selection-needs-the-asynchronous-conversion"></a>
|
|
|
|
- [Importable output and verified document sets](WotBindings.md#conversion-entry-points)
|
|
|
|
<a id="portable-identity-and-preservation-semantics"></a>
|
|
<a id="generated-nodeids-follow-annex-g1"></a>
|
|
<a id="preservation-digests-and-the-two-things-that-can-be-measured"></a>
|
|
|
|
- [Portable identities, preservation, and digests](WotBindings.md#identity-and-preservation)
|
|
|
|
<a id="wot-to-nodeset-defaults"></a>
|
|
<a id="modelling-rules-and-the-two-placeholder-identifiers"></a>
|
|
<a id="datatype-definitions-section-611"></a>
|
|
<a id="valuerank-and-arraydimensions-sections-7-and-91"></a>
|
|
<a id="method-arguments-section-91"></a>
|
|
|
|
- [DataTypes, ranks, arguments, and defaults](WotBindings.md#datatypes-ranks-arguments-and-model-vocabulary)
|
|
|
|
<a id="engineering-units-ranges-and-scaling-sections-64-and-641"></a>
|
|
<a id="localized-text-section-911"></a>
|
|
|
|
- [Engineering units, ranges, and locales](WotBindings.md#engineering-units-ranges-and-localized-text)
|
|
|
|
<a id="component-template-declarations"></a>
|
|
<a id="unmapped-reference-vocabulary-is-residue"></a>
|
|
<a id="referencetypes-and-relations-sections-512-53-and-62"></a>
|
|
<a id="uavcomponentof-and-its-uacomponentof-alias"></a>
|
|
|
|
- [Types and relations](WotBindings.md#resolving-a-relation-companion-referencetypes)
|
|
|
|
<a id="condition-events-derive-from-their-conditiontype"></a>
|
|
<a id="event-fields-come-from-the-type-not-only-from-the-document"></a>
|
|
|
|
- [Event selection](WotBindings.md#event-field-selection)
|
|
- [Condition runtime and mapping](WotBindings.md#projected-methods-events-and-conditions)
|
|
|
|
<a id="projection-documents-and-the-opc-10100-1-v102-asset-surface"></a>
|
|
|
|
- [Projection usage](WoTConnectivity.md#authoring-projection-views)
|
|
- [WoT-Con 1.02 compatibility](WoTConnectivity.md#wot-con-102-compatibility)
|