Syrve POS API SDK

Fault tolerance

The V8Preview6 version introduces the possibility to control the state of the Main Terminal (MT) of a group and, if needed, to transfer this role to another terminal.

The innovation consists of the next elements:

  1. A list of reserve terminals;
  2. Tracking the status of the main terminal;
  3. Possibility to recustomize the main terminal via API.

More:

1) In the Syrve Office application in Store Settings => Group Settings it is possible to set up a list of reserve terminals. These terminals will be the spare terminals which can take over the role of the MT if needed. The form for set the reserve terminals is as follows:

ext_number

In API, in the ITerminalsGroup interface, the StandbyTerminals list has been added, which contains the list of reserve terminals set in Syrve Office. To get information about the current group of terminals, it is possible to use the GetHostTerminalsGroup method or subscribe to the TerminalsGroupChanged.

2) Each a waiter or user workstations tracks the state of the connection to the MT and if the state has changed, the terminal will report it. For this purpose a new notification ConnectionToMainTerminalChanged was added. In this notification the connection state is transmitted: true - connection with the MT is established, false - connection with the MT is lost.

3) A new operation ChangeGroupMainTerminalwas implemented in the API, which allows to change MT. To run this operation it is needed to have the permission to run dangerous operations (F_DOP) and to transfer as argument a terminal, which is a reserve terminal. After this operation, the transferred terminal will be as MT, and the previous MT will be moved to the list of reserve terminals.

Example:

private static void ChangeGroupMainTerminal(IOperationService os)
{
	var newMainTerminal = os.GetHostTerminalsGroup().StandbyTerminals.First();
	os.ChangeGroupMainTerminal(os.GetCredentials(),newMainTerminal);
}

At the moment, it is necessary to have license 21053302 in order to use this new feature. Also this license removes the 30-second delay when Syrve POS is rebooting.