OPCFoundation.Opc.Ua.SpecificationValidator 1.0.58

OPC UA Specification Validator

A command-line tool that bridges OPC UA specification Word documents and their OPC UA NodeSets. It:

• converts an OPC UA specification .docx to NISO STS 1.2 Extended XML;
• validates an STS document's tables (Type definitions, attributes, method signatures, references, Conformance Units) against the OPC UA NodeSet(s) the specification describes;
• writes clause documentation links back into a NodeSet.

Windows-only. The tool drives Microsoft Word, Visio, PowerPoint, and Excel via COM to preprocess documents and rasterize embedded figures.

Install

dotnet tool install --global OPCFoundation.Opc.Ua.SpecificationValidator

Usage

Opc.Ua.SpecificationValidator <verb> [options]

Convert and validate in one step

Opc.Ua.SpecificationValidator convert-validate <input.docx> <output-dir> \
    --nodeset <primary.nodeset2.xml> \
    --profile-group "UAFX 1.00"

Validate an existing STS document

Opc.Ua.SpecificationValidator validate <spec.xml> <primary.nodeset2.xml> \
    [--dependency <nodeset.xml>]... [--dependency-dir <dir>]...

NodeSet resolution

A specification part frequently documents Types across several sibling namespaces (for example UAFX Part 81 documents FX/Data, FX/AC, and FX/CM even though its primary NodeSet is FX/Data). You only need to pass the primary --nodeset: the converter reads the document's namespace table, then locates each additional NodeSet in the primary's directory, any --dependency-dir, or by download. A namespace a definition table references but that cannot be located is a hard error; --no-download restricts resolution to local sources.

Outputs

Alongside the STS/validation run the tool writes:

• <doc>-validation.log / <doc>-validation.json — findings (human- and machine-readable);
• <doc>-documentation.csv — Type/Object clause links (merge-on-run);
• <doc>-conformanceunits.csv — Conformance Units checked against the Profile Group;
• <doc>-ignoretables.csv — baseline of tables whose UnknownTableType warning is suppressed.

License

MIT © OPC Federation AISBL