---

---

AMLEngine2.1

News

Since version 3.3.0 the Aml.Engine core package is also provided on plattforms:

• .NET 8.0-macos
• .NET 8.0-maccatalyst
• .NET 8.0-android
• .NET 8.0-ios

The sample solutions have been updated to the actual .NET version. A new solution has been added that shows how to use the AutomationML Library service using examples. Among other things, you will learn how to check the validity of a signed AutomationML library.

The AMLEngine2.1 API Reference Guide has been updated and is now available at https://automationml.github.io/AMLEngine2.1/. A diagram of the complete CAEX datamodel is included. It can be downloaded from https://automationml.github.io/AMLEngine2.1/media/CAEXClassDiagram.png.

New Wiki Pages are added:

• Working with external libraries and classes.
• Using Indices to speed up queries.
• New Examples to access elements in structured Attributes.

Important Note

Please note a problem according to DocumentVersionInformation in CAEXFiles

AutomationML 2.1 Application Programming Interface

The AMLEngine2.1 allows you to process AutomationML documents with a provided Application Programming Interface, based on the .NET Framework. Using the API you interact with CAEX-Elements and AutomationML-Objects. This AMLEngine is an advanced development of the AMLEngine Version 3.x which only supports AutomationML Version 2.0 and the CAEX Version 2.15. This new development also supports AutomationML Version 2.1 which is based on CAEX Version 3.0.

A detailed overview of the differences between CAEX 2.15 and CAEX 3.0 is presented here.

A short guide explaining a migration strategy to adpat applications, using AMLEngine Version 3.x, to the Aml.Engine is presented here.

To see a complete documentation of the Aml.Engine API reference guide look here.

Additional documentatons with more examples are included in the Wiki

Download

The AMLEngine2.1 is published in the core package Aml.Engine on nuget at https://www.nuget.org/packages/Aml.Engine and additional extension packages.

Getting started

See the documentation and examine the provided examples. There are various basic examples and advanced examples. A special adaption section describes the steps to be executed, how old code, using the former AMLEngine v3.x.x, can be adapted to the new engine.

A short introduction to the application of the engine

1. Create a new empty Document, add content and save it.

using Aml.Engine.CAEX;
using Aml.Engine.CAEX.Extensions;

// create a new empty document
var caexDocument = CAEXDocument.New_CAEXDocument();

// add content to the ROOT CAEXFile element
var myIH = caexDocument.CAEXFile.New_InstanceHierarchy("myIH");

caexDocument.SaveToFile ("myfile.aml", true);

2. Load the created Document

using Aml.Engine.CAEX;


// load a document
var caexDocument = CAEXDocument.LoadFromFile("myfile.aml");

// get the InstanceHierarchy
var myIH = caexDocument.CAEXFile.InstanceHierarchy[0];

// add more content
myIH.InternalElement.Append ("Ie1");

3. Use of AutomationML standard classes

using Aml.Engine.AmlObjects;
using Aml.Engine.CAEX;

var caexDocument = CAEXDocument.New_CAEXDocument();

// adds the base libraries to the document
AutomationMLInterfaceClassLibType.InterfaceClassLib(caexDocument);
AutomationMLBaseRoleClassLibType.RoleClassLib(caexDocument);

// add an InstanceHierarchy to the ROOT CAEXFile element
var myIH = caexDocument.CAEXFile.New_InstanceHierarchy("myIH");

// add an InternalElement
var ie = myIH.InternalElement.Append ("ie");

// assign the AutomationMLBaseRole
ie.AddRoleClassReference(AutomationMLBaseRoleClassLib.AutomationMLBaseRole);