[!TIP] See also: About DataMiner

About Skyline Communications

At Skyline Communications, we deal in world-class solutions that are deployed by leading companies around the globe. Check out our proven track record and see how we make our customers' lives easier by empowering them to take their operations to the next level.

Requirements

The "DataMiner Integration Studio" Visual Studio extension is required for development of connectors and Automation scripts using NuGets.

See Installing DataMiner Integration Studio

[!IMPORTANT] NuGets are mandatory to be installed with PackageReferences. DIS was redesigned to work with PackageReferences and be future-proof.

For more information on how to migrate from packages.config to PackageReferences, see docs.microsoft.com.

Getting started

You can use the DIS Plugin to generate the Matrix present since DIS 2.40. Before this, DIS contains a macro that can be used to quickly get started with a new Matrix in a connector.

You may need to adjust some namespaces as the generated code may reference older namespaces then the ones provided by this NuGet.

Generating the two table approach allows the use of the Router Control

Make sure you have the DIS Macros Tool Window open in Visual Studio then run the "Protocols/Matrix/Create Matrix" macro and follow the wizard.

[!IMPORTANT] When using the Matrix UI Component defined as a parameter with type array it's guaranteed to work well up to 1000X1000 size (and up to 4000X4000 before it becomes clunky)

  <Type options="dimensions=640,640;columntypes=99:0-639">array</Type> 

The newer Matrix Parameter defined as a type Matrix is currently an initial release and is less efficient. This should only be used if you need the ability to set a tooltip or perform a force set of a crosspoint even when locked. It is currently intended for matrices sizes 64X64

  <Type>Matrix</Type>

More details on implementing this can be found in the Documentation: About Matrix Component for Matrix Types

[!IMPORTANT] For larger matrices its recommended to not use the Matrix UI Component and stick with only the two tables.