View Issue Details

IDProjectCategoryView StatusLast Update
0009514Part 83: UAFX Offline EngineeringSpecpublic2024-11-27 21:33
ReporterMarco Hoch Assigned ToJim Luth  
PriorityhighSeveritymajorReproducibilityalways
Status resolvedResolutionfixed 
Product Version1.00.02 
Target Version1.00.03 
Summary0009514: Structure field information missing in AML
Description

Chapter "A.3.3 Structures" describes how to map structures, but not how to handle information about fields of structures. In OPC UA, fields contain information such as valueRank, arrayDimensions, maxStringLength, isOptional. This information is lost at the moment. This information is lost at the moment. However, this information is important for creating the CCS.

TagsNo tags attached.

Relationships

related to 0009610 resolvedJim Luth Reference Type Mapping - Which attributes should be used on an instance 

Activities

Marco Hoch

2024-04-04 11:52

developer   ~0021084

In OPC UA, custom DataTypes have the DataTypeDefinition attribute. This information is also currently missing. It should be checked if it is needed.

muetzeclaudia

2024-04-04 12:21

reporter   ~0021085

Proposal is to specify the usage of the StructureDefinition type in the ATL for structure DataTypes.
The StructureDefinition type has the advantage that the StructureFields are included which deliver the information for ValueRank, MaxStringLength, ArrayDimensions and DataType.
A further advantage of the usage of the StructureDefinition type in the ATL is that this complete StructureDefinition from the ATL can be used for the DataSetMetaData.StructureDataTypes for customized DataSets of a CCS to be created by an FX connection editor.

Jim Luth

2024-04-12 19:33

administrator   ~0021123

I have a proposed design for this, but it requires some new rules and conventions. I want to present it in an OE meeting to get agreement before I write it up.

StructureDefinition.amlx (1,239,439 bytes)

Jim Luth

2024-10-11 18:27

administrator   ~0021880

Last edited: 2024-10-11 18:31

My revised proposal here: https://opcfoundation.sharepoint.com/:u:/r/FLC-WG/Work/@Sub-Groups/Offline_Engineering_WG/Prototyping/AML%20Definition%20Libraries%20Proposal/StructureDefinitionProposal.amlx?csf=1&web=1&e=Nvtz1z
is completely different. No new library is added. Instead, Attributes that should only appear in Types are decorated with the "AdditionalInformation" Header value of "OPCUA:TypeOnly" as shown here:

image.png (55,260 bytes)   
image.png (55,260 bytes)   

Jim Luth

2024-10-11 18:31

administrator   ~0021881

Last edited: 2024-10-11 18:33

So in the RedundantServerDataType example, the four highlighted attributes would be marked as "OPCUA:TypeOnly" so tooling would know to delete them in instances (ideally) or readers would ignore them in instances if not deleted by the tooling.

image-2.png (178,507 bytes)   
image-2.png (178,507 bytes)   

Marco Hoch

2024-10-22 09:36

developer   ~0021926

How about using an XML-element instead of separating by column?

"OPCUA:TypeOnly" -> <OPCUA>TypeOnly</OPCUA>

For e.g,, Nodeset2AmlToolVersion it is also done using an XML-element.

Jim Luth

2024-11-27 21:33

administrator   ~0022138

Added text to Part 83 draft in A.11.2 to explain the "OPC:TypeOnly" rules.

Issue History

Date Modified Username Field Change
2024-04-04 11:22 Marco Hoch New Issue
2024-04-04 11:22 Marco Hoch Status new => assigned
2024-04-04 11:22 Marco Hoch Assigned To => Emanuel Kolb
2024-04-04 11:52 Marco Hoch Note Added: 0021084
2024-04-04 12:21 muetzeclaudia Note Added: 0021085
2024-04-12 19:33 Jim Luth Note Added: 0021123
2024-04-12 19:33 Jim Luth File Added: StructureDefinition.amlx
2024-05-23 13:23 Emanuel Kolb Assigned To Emanuel Kolb => Jim Luth
2024-09-16 14:14 Jim Luth Relationship added related to 0009610
2024-10-11 18:27 Jim Luth Note Added: 0021880
2024-10-11 18:27 Jim Luth File Added: image.png
2024-10-11 18:31 Jim Luth Note Edited: 0021880
2024-10-11 18:31 Jim Luth Note Added: 0021881
2024-10-11 18:31 Jim Luth File Added: image-2.png
2024-10-11 18:33 Jim Luth Note Edited: 0021881
2024-10-22 09:36 Marco Hoch Note Added: 0021926
2024-11-27 21:33 Jim Luth Status assigned => resolved
2024-11-27 21:33 Jim Luth Resolution open => fixed
2024-11-27 21:33 Jim Luth Note Added: 0022138