Difference between revisions of "Live Value Server (Plugin)"

Revision as of 11:56, 3 August 2016

UBIK^® Live Value Servers read data from different types of server providing live data, for example from a process control system. This feature is provided by UBIK^® plugins injected to an existing system. Once configured accordingly the live value servers fetch the data from the external servers and publish the values directly to the clients, bypassing other UBIK^® web services or the customizing. Hence, all such values read and published to the clients are far more accurate but not available in the UBIK^® customizing.

Available Live Value Server Plugins

Name	Since Version	Comment
OPCLiveValueServer	2.5	Reads and publishes live values provided by an OPC UA Server
XHQLiveValueServer	2.5	Reads and publishes live values provided by a XHQ Server

[edit]

Introduction
Example

Introduction

Requirements

The plugin must implement the UBIK.Injection.IUBIKLiveValueServer interface and has to be registered for MEF composition by defining the export contract via attributes.

namespace UBIK.Injection
{
public interface IUBIKLiveValueServer
{
/// <summary>
/// Initializes the opc live value server.
/// </summary>
/// <param name="environment">The environment.</param>
void InitLiveValueServer(UBIKEnvironment environment);

/// <summary>
/// Starts the live value server and starts to read data from the 3rd party system
/// </summary>
void Startup();

/// <summary>
/// Stops the live value server.
/// </summary>
void Shutdown();

/// <summary>
/// Tries the get a live value specified by the given data point id.
/// </summary>
/// <param name="dataPointID">The data point identifier.</param>
/// <param name="ILiveValueInformation">The i live value information.</param>
/// <returns>true as a configured live value was found, false otherwise</returns>
bool TryGetLiveValue(Guid dataPointID, out ILiveValueInformation value);

/// <summary>
/// Gets status information of the current live value server
/// </summary>
/// <returns>status information</returns>
ILiveValueServerStatus GetStatus();
}
}

Example

[Export(typeof(UBIK.Injection.IUbikPlugin))]
[ExportMetadata("ID", "4AD25939-C2F3-4E25-88F8-D1143E3D566B")]
[ExportMetadata("Type", typeof(OPCLiveValueServer))]
[ExportMetadata("Name", "OPCLiveValueServer")]
[ExportMetadata("Description", "OPCUA Live Value Server")]
[ExportMetadata("Version", 1)]
[ExportMetadata("Company", "Augmensys GmbH")]
[ExportMetadata("Copyright", "2015, Augmensys GmbH")]
[ExportMetadata("MinimumKernelVersion", "2.5.0.0")]
[ExportMetadata("TargetApplication", TargetApplication.UBIK_WebService)]
public class OPCLiveValueServer : IUBIKLiveValueServer, UBIK.Injection.IUbikPlugin
{
....
}

@@ Line 1: / Line 1: @@
-{{UBIK}} Live Value Server Plugins can be injected to {{UBIK}} using the [[Injection Management]].
+{{UBIK}} Live Value Servers read data from different types of server providing live data, for example from a process control system. This feature is provided by {{UBIK}} plugins injected to an existing system. Once configured accordingly the live value servers fetch the data from the external servers and publish the values directly to the clients, bypassing other {{UBIK}} web services or the customizing. Hence, all such values read and published to the clients are far more accurate but not available in the {{UBIK}} customizing.
 == Available Live Value Server Plugins ==
@@ Line 11: / Line 11: @@
 |}
-== Implementation ==
+= Introduction =
+== Requirements ==
 The plugin must implement the '''UBIK.Injection.IUBIKLiveValueServer''' interface and has to be registered for MEF composition by defining the export contract via attributes.
@@ Line 53: / Line 54: @@
 </source>
+= Example =
-== Example ==
 <source lang="csharp">
      [Export(typeof(UBIK.Injection.IUbikPlugin))]
@@ Line 74: / Line 71: @@
      }
 </source>
+<headertabs/>
 == See also ==