Table of Contents

About the DataMinerSystem library

The Skyline.DataMiner.Core.DataMinerSystem namespace defines types that can be used to implement DataMiner-related logic in protocols and automation scripts. It provides types for interacting with a DataMiner System to, for example, create elements, update element settings, work with views, edit properties, etc.

The namespace consists of three sub-namespaces:

Important
  • If you encounter abbreviations like SLC, Lib, or CLib, make sure to update the NuGet packages to the latest version, as these are considered obsolete.
  • QAction 63000 Auto-generated Class Library is obsolete and should be replaced by the latest NuGet packages. See Obsolete namespaces.

To use the DataMinerSystem library in a protocol, install the following NuGet package: Skyline.DataMiner.Core.DataMinerSystem.Protocol.

To use the DataMinerSystem library in an automation script, install the following NuGet package: Skyline.DataMiner.Core.DataMinerSystem.Automation.

Both packages have a dependency on the Skyline.DataMiner.Core.DataMinerSystem.Common NuGet package. Therefore, this package is installed automatically when Skyline.DataMiner.Core.DataMinerSystem.Protocol or Skyline.DataMiner.Core.DataMinerSystem.Automation are installed.

Note

Using the DataMinerSystem library, you can retrieve parameter values, tables, etc. from elements. However, it is important to note that this should only be used for obtaining values from other elements. To perform operations on the local element, we recommend using the SLProtocol API as this is much more efficient (because the operation is then performed in the SLProtocol process immediately).

For example, to start using the DataMinerSystem library from a QAction, use the GetDms extension method:

IDms dms = slProtocol.GetDms();

The GetDms method (see SLProtocolExtensions.GetDms method) is an extension method on the SLProtocol interface that returns an object that implements the IDms interface.

To start using the DataMinerSystem library from an automation script, use the GetDms extension method:

IDms dms = engine.GetDms();

The GetDms method (see Engine.GetDms method) is an extension method on the Engine interface that returns an object that implements the IDms interface.

Refer to Examples for some example use cases.

Note

If you are a Skyline employee and you are interested in adding or changing the DataMinerSystem library, see DataMinerSystem library development.