Skip to content

DocumentVersions

Josef edited this page Apr 24, 2023 · 1 revision

There are two different methods of embedding DocumentVersionInformation elements into a CAEXFile object in the engine.

  1. DocumentVersions.AppendDocumentVersionInformation
  2. AMLFile.DocumentVersion

The result of the first method is:

<AdditionalInformation DocumentVersions="Recommendations">
    <Document xmlns="" DocumentIdentifier="VDI/VDE/NAMUR 2658-1:Manifest" Version="1.1.0" />
    <Document xmlns="" DocumentIdentifier="VDI/VDE/NAMUR 2658-4:ServiceSet" Version="1.0.0" />
    <Document xmlns="" DocumentIdentifier="VDI/VDE/NAMUR 2658-2:HmiSet" Version="1.0.0" />
 </AdditionalInformation>

Adding elements to the sequence provided with option two, results in:

<AdditionalInformation DocumentVersions="Recommendations">
    <Document DocumentIdentifier="VDI/VDE/NAMUR 2658-1:Manifest" Version="1.1.0" />
</AdditionalInformation>
<AdditionalInformation DocumentVersions="Recommendations">
    <Document DocumentIdentifier="VDI/VDE/NAMUR 2658-4:ServiceSet" Version="1.0.0" />
</AdditionalInformation>
<AdditionalInformation DocumentVersions="Recommendations">
    <Document DocumentIdentifier="VDI/VDE/NAMUR 2658-2:HmiSet" Version="1.0.0" />
</AdditionalInformation>

Unfortunately, both methods are incompatible. If the document versions were realized with method 1, they will not be listed in method 2 and vice versa. With version 3.1 of the Aml.Engine, this has been corrected. The engine will only create the structure, defined by the first method, but both methods will recognize each version. If the DocumentVersionInformation in the CAEXFile was edited with the AutomationML Editor, you should use the second method to retrieve the information. With Editor version 6.2, the editor will also create a structure as defined by the first method.

Clone this wiki locally