00197702-04_VD_SIPLACE-OIB-4.3_EN.pdf - 第18页

Version Descript ion SIPLAC E OIB 4 . 3 05/201 6 E dition 18 5.3 Discont inued Fea tures • The Support of the IT raceabil ityOibSer vice in the SDK is dis co nt inued st arting i n OIB 4. 2 . T his means that the SD K do…

Version Description

SIPLACE OIB 4.3 05/2016 Edition

5.2.5 OIB WS Eventing

A new method is introduced that allows to update an existing PushWithAck subscription:

• The port number to be able to use a changed port number after restart without losing any messages

buffered for that subscription.

• The endpoint address to be able to get stored messages after moving the application from one

computer to another.

• The filter of an existing subscription to be able to use a new filter after restart without losing any

messages buffered for that subscription.

• Remove an existing filter

• Adjust the DeliveryMody (only possible from PushWithAck to PushWithAckUnreliable or vice versa).

Version Description

SIPLACE OIB 4.3 05/2016 Edition

5.3 Discontinued Features

• The Support of the ITraceabilityOibService in the SDK is discontinued starting in OIB 4.2. This

means that the SDK does not contain any interface artefacts for that interface anymore.

CAUTION

Please check the support of the ITraceabilityOibService interface in the

Traceability service documentation. See the chapter Discontinued Features in the

document “00197701-04_IM_SIPLACE-OIB-4.3_EN.pdf” for migration to the new

solution.

• The XML Import function in the SPI is discontinued starting in OIB version 3.0 and the usage will

throw an exception. This is due to potential wrong usage and the danger of corrupting your data.

• The WSDL Interface files for the SIPLACE Pro SPI have been removed from the SDK content. The

recommendation is to use the SPI smart proxy instead.

• The “OIB Configuration Editor” Operation Manager plug-in was removed. Please use the SIPLACE

Studio plug-ins instead.

Version Description

SIPLACE OIB 4.3 05/2016 Edition

6 Functions in SIPLACE OIB Setup Center Adapter

6.1 Connection check event in SIPLACE Setup Center Proxy

Since version 3.0 SIPLACE OIB adds support for an event in the Setup Center smart proxy component.

The SIPLACE Setup Center class has a new event implemented that clients can subscribe for:

/// <summary>

/// Occurs when the proxy detects a connection state change.

/// </summary>

public event ConnectionStateChangedEvent ConnectionStateChanged;

/// <summary>

/// This event is fired whenever a connection state change is detected

/// </summary>

/// <param name="args">The <see cref="ConnectionStateDetails"/> instance containing the

event data.</param>

public delegate void ConnectionStateChangedEvent(ConnectionStateDetails args);

The event will contain information about when the connection state change was detected (in UTC time)

and what change was detected.

Changes monitored are:

• Connection state SC proxy -> Setup Center Adapter

• Connection state SC proxy -> OIB Core

• Connection state Setup Center Adapter -> Setup Center Application / Server

• Connection state Setup Center Adapter -> OIB Core

The Proxy will check periodically for state changes. This period can be configured programmatically by a

new static property in the SIPLACESetup Center class:

/// <summary>

/// Gets or sets the check alive frequency in ms.

/// This value must be greater or equal to 1 second (1000) and less or equal to 1 hour

(3600000).

/// Default value is 60000 (1 minute)

/// Can also be set in the application configuration file appSettings like so, value is in

milliseconds:

/// <add key="Asm.As.Oib.SetupCenter.Proxy.CheckConnectionStateFrequency" value="60000" />

/// </summary>

/// <value>The check alive frequency in ms.</value>

public static int CheckConnectionStateFrequency

Alternatively it can be configured in the application configuration file:

<?xml version="1.0" encoding="utf-8"?>

</appSettings>

</configuration>