mirror of
https://github.com/OPCFoundation/UA-.NETStandard.git
synced 2026-10-16 21:02:51 +08:00
Marc Schier
e8bec27d5d
# Description
Complete WoT Binding preservation and the two-pump aggregation workflow
without implicit overlays or multi-source action fan-out.
- Add verified linked-document export and bounded partition merging.
Preserve complete source facts, reject contradictory archival content,
and retain usable readable content when a future native grammar is
unsupported.
- Wire local Methods and Condition events through the existing
injectable binding/runtime infrastructure. Keep local and upstream
identities distinct, translate namespace-bearing values, and bound
occurrence routes by source and generation.
- Wait for asynchronous event-producer readiness before completing
subscription creation, so the first alarm is not lost. Preserve
cancellation, teardown, and startup-failure reporting.
- Import runtime types in inheritance order and attach typed Method
argument Properties. Keep generated Double spelling deterministic across
supported frameworks and remove an AOT-unsafe registry validation
conversion.
- Generate both pumps and their asset/group projections. Expose fifteen
typed readings per pump, separate source-owned controls, and
acknowledge/confirm/reset workflows. Extend the demo script for managed
and NativeAOT execution, bounded failures, and exact-process cleanup.
- Synchronize current-state documentation and specification fixtures.
Compose fixture paths from platform-independent components and emit/pin
LF pump XML so byte-exact regeneration holds on Windows, Linux, and
macOS.
- Keep sample JSON readable with sorted members, two-space indentation,
and LF line endings. Normalize generated filenames to single hyphens
without changing registry resource IDs, document values, logical links,
or dependency ordering; the manifest maps resource IDs to their physical
filenames.
Most changed files are deterministic regenerations of checked-in sample
documents. The demo manifest contains 533 linked resources; the
aggregation server remains generic and has no Pump-specific compiled
model dependency.
No new alarm vocabulary, shelving/suppression/dialog/ConditionRefresh
transport mapping, Azure SDK changes, or complete Pump/OpenUSD parity is
introduced.
## Related Issues
Fixes #4430, which records the approved implementation scope, design
decisions, and acceptance criteria.
Follow-up to #4411. Specification fixtures are pinned to
[OPCF-Members/spec-drafts commit
82620d9](https://github.com/OPCF-Members/spec-drafts/commit/82620d9e313f35386dfc7477f7875cd47d2fd268),
associated with OPCF-Members/spec-drafts#35.
## Validation
- .NET 10 and .NET 8: complete affected converter/schema, WoT
Connectivity, and binding suites passed.
- .NET Framework 4.8: affected libraries, converter/generator, projected
runtime, readiness, and NodeSet-import compatibility runs passed. The
existing filesystem test exceeding the host's legacy path limit passed
through a temporary short-path alias, without changing its assertions.
- All 29 aggregation sample tests passed, including the independent
companion-model oracle.
- Managed/default-port and NativeAOT/alternate-port demo runs completed
with 533 documents, two pumps, thirty Good readings, and all four
pump/source control and alarm workflows.
- Timeout and duplicate-port failure paths were exercised; owned
processes and ports were released.
- Specification artifact/rule checks, byte-identical example mirroring,
statement-digest verification, and changed-file whitespace checks
passed.
- The [Build and Test .NET 10.0 workflow for
278b092](https://github.com/OPCFoundation/UA-.NETStandard/actions/runs/34095520510)
passed, including the previously failing Linux/macOS Types and WoT
Connectivity jobs. Portability fixes preserve the existing assertions
and add an explicit LF-output regression.
- After the readability changes in `dc61d032`, all 131 targeted
sample/projected-runtime cases passed on both .NET 10 and .NET Framework
4.8, and all 29 aggregation sample tests passed after rebuilding. All
539 JSON assets meet the formatting and filename rules; the 538 document
JSON values are unchanged, with only physical paths changing in the
manifest. Byte-exact regeneration assertions remain in place.
Local validation was scoped to affected projects rather than the entire
UA.slnx solution. Numeric coverage percentages and remaining CI gates
remain for CI; coverage thresholds were not changed. Existing unrelated
analyzer warnings were left unchanged.
## Checklist
- [ ] I have signed the
[CLA](https://opcfoundation.org/license/cla/ContributorLicenseAgreementv1.0.pdf)
and read the
[CONTRIBUTING](https://github.com/OPCFoundation/UA-.NETStandard/blob/master/CONTRIBUTING.md)
doc.
- [ ] I have added tests that prove my fix is effective or that my
feature works and increased code coverage.
- [x] I have added all necessary documentation.
- [x] I have verified that my changes do not introduce (new) build or
analyzer warnings.
- [ ] I ran **all** tests locally using the **UA.slnx** solution against
at least .net **framework** and .net **10**, and all passed.
- [ ] I fixed **all** failing and flaky tests in the CI pipelines and
**all** CodeQL warnings.
- [x] I have addressed **all** PR feedback received.
Regression and integration tests are included and passed as described
above; the combined tests/coverage checkbox remains open because numeric
coverage was not measured locally.
---------
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Copilot-Session: 6a9f41b1-72f0-4c74-bd7f-26fa531e5738
143 lines
4.2 KiB
JSON
143 lines
4.2 KiB
JSON
{
|
|
"@context": [
|
|
"https://www.w3.org/2022/wot/td/v1.1",
|
|
{
|
|
"tm": "https://www.w3.org/2019/wot/tm#",
|
|
"ua": "http://opcfoundation.org/UA/",
|
|
"uav": "http://opcfoundation.org/UA/WoT-Binding/"
|
|
}
|
|
],
|
|
"@type": [
|
|
"Thing",
|
|
"uav:projection"
|
|
],
|
|
"actions": {
|
|
"CavitationAcknowledge": {
|
|
"tm:ref": "sample-pump#/actions/CavitationAcknowledge"
|
|
},
|
|
"CavitationConfirm": {
|
|
"tm:ref": "sample-pump#/actions/CavitationConfirm"
|
|
},
|
|
"MotorOverheatAcknowledge": {
|
|
"tm:ref": "sample-pump#/actions/MotorOverheatAcknowledge"
|
|
},
|
|
"MotorOverheatConfirm": {
|
|
"tm:ref": "sample-pump#/actions/MotorOverheatConfirm"
|
|
},
|
|
"SourceAReset": {
|
|
"tm:ref": "sample-pump#/actions/SourceAReset"
|
|
},
|
|
"SourceAStart": {
|
|
"tm:ref": "sample-pump#/actions/SourceAStart"
|
|
},
|
|
"SourceAStop": {
|
|
"tm:ref": "sample-pump#/actions/SourceAStop"
|
|
},
|
|
"SourceBReset": {
|
|
"tm:ref": "sample-pump#/actions/SourceBReset"
|
|
},
|
|
"SourceBStart": {
|
|
"tm:ref": "sample-pump#/actions/SourceBStart"
|
|
},
|
|
"SourceBStop": {
|
|
"tm:ref": "sample-pump#/actions/SourceBStop"
|
|
}
|
|
},
|
|
"events": {
|
|
"CavitationAlarm": {
|
|
"tm:ref": "sample-pump#/events/CavitationAlarm"
|
|
},
|
|
"MotorOverheatAlarm": {
|
|
"tm:ref": "sample-pump#/events/MotorOverheatAlarm"
|
|
}
|
|
},
|
|
"id": "urn:opcfoundation.org:UA:WotAggregation:Asset:Pump1:Members",
|
|
"properties": {
|
|
"BearingTemperature": {
|
|
"tm:ref": "sample-pump-operational-measurements#/properties/BearingTemperature"
|
|
},
|
|
"Cavitation": {
|
|
"tm:ref": "sample-pump-events-supervisionprocessfluid#/properties/Cavitation"
|
|
},
|
|
"DifferentialPressure": {
|
|
"tm:ref": "sample-pump-operational-measurements#/properties/DifferentialPressure"
|
|
},
|
|
"FluidTemperature": {
|
|
"tm:ref": "sample-pump-operational-measurements#/properties/FluidTemperature"
|
|
},
|
|
"Level": {
|
|
"tm:ref": "sample-pump-operational-measurements#/properties/Level"
|
|
},
|
|
"Manufacturer": {
|
|
"tm:ref": "sample-pump-identification#/properties/Manufacturer"
|
|
},
|
|
"MassFlow": {
|
|
"tm:ref": "sample-pump-operational-measurements#/properties/MassFlow"
|
|
},
|
|
"MotorOverheat": {
|
|
"tm:ref": "sample-pump-events-supervisionpumpoperation#/properties/MotorOverheat"
|
|
},
|
|
"NumberOfStarts": {
|
|
"tm:ref": "sample-pump-operational-measurements#/properties/NumberOfStarts"
|
|
},
|
|
"ProductInstanceUri": {
|
|
"tm:ref": "sample-pump-identification#/properties/ProductInstanceUri"
|
|
},
|
|
"PumpEfficiency": {
|
|
"tm:ref": "sample-pump-operational-measurements#/properties/PumpEfficiency"
|
|
},
|
|
"PumpPowerInput": {
|
|
"tm:ref": "sample-pump-operational-measurements#/properties/PumpPowerInput"
|
|
},
|
|
"SerialNumber": {
|
|
"tm:ref": "sample-pump-identification#/properties/SerialNumber"
|
|
},
|
|
"SourceARunning": {
|
|
"tm:ref": "sample-pump#/properties/SourceARunning"
|
|
},
|
|
"SourceBRunning": {
|
|
"tm:ref": "sample-pump#/properties/SourceBRunning"
|
|
}
|
|
},
|
|
"security": "nosec_sc",
|
|
"securityDefinitions": {
|
|
"nosec_sc": {
|
|
"scheme": "nosec"
|
|
}
|
|
},
|
|
"title": "Pump1 Members",
|
|
"uav:projects": [
|
|
{
|
|
"href": "sample-pump",
|
|
"type": "application/td+json",
|
|
"uav:routing": "source",
|
|
"uav:sourceName": "sample-pump"
|
|
},
|
|
{
|
|
"href": "sample-pump-events-supervisionprocessfluid",
|
|
"type": "application/td+json",
|
|
"uav:routing": "source",
|
|
"uav:sourceName": "sample-pump-events-supervisionprocessfluid"
|
|
},
|
|
{
|
|
"href": "sample-pump-events-supervisionpumpoperation",
|
|
"type": "application/td+json",
|
|
"uav:routing": "source",
|
|
"uav:sourceName": "sample-pump-events-supervisionpumpoperation"
|
|
},
|
|
{
|
|
"href": "sample-pump-identification",
|
|
"type": "application/td+json",
|
|
"uav:routing": "source",
|
|
"uav:sourceName": "sample-pump-identification"
|
|
},
|
|
{
|
|
"href": "sample-pump-operational-measurements",
|
|
"type": "application/td+json",
|
|
"uav:routing": "source",
|
|
"uav:sourceName": "sample-pump-operational-measurements"
|
|
}
|
|
],
|
|
"uav:scenario": "urn:opcfoundation.org:UA:WotAggregation:AssetManagement"
|
|
}
|