Ethiris Admin Manual

Transaction-objektet

Transaction-objektet är ett objekt som returneras när man skickar de fem olika kommandona via ett kommando-objekt. Kommandona är: SelectView, SelectSection, ShowDynamicView, ShowPopupView och ReloadConfiguration. Transaktionsobjektet innehåller information om kommandotransaktionens ID och hur många klienter som kommandot skickades till.

Egenskaper på Transaction-objektet

TransactionID

Detta är ett löpnummer som räknas upp varje gång ett kommando skickas.

Exempel:

var client;
var oldTrigger;
var transObj;
if (clients == undefined)
{
// Get client
client = Clients.GetClientByHostName("Chaotic");
}
if (trigger && !oldTrigger)
{
// Show dynamic view on monitor 2
transObj = client.ShowDynamicView(2, [ "Door" ]);
}
oldTrigger = Boolean(trigger);
Clients.onCommandCompleted = function(event)
{
// Check transaction ID
if (transObj.TransactionID == event.TransactionID)
{
if (event.Result >= Clients.RESULT_OK)
{
// ShowDynamicView command successful...
}
}
}

I ovanstående exempel används transaktionsobjektet i onCommandCompleted för att vara säker på att det är rätt kommando som har blivit färdigt. Man kan potentiellt ha flera kommandon i gång samtidigt mot flera olika klienter.

NumClients

Denna egenskap innehåller antalet klienter som kommandot skickats till.

Exempel:

transObj = client.ReloadConfiguration(true);
sResult = transObj.NumClients + " clients updated";

Command

Denna egenskap innehåller namnet på kommandot som skapade transaktionsobjektet.

Exempel:

transObj = client.ReloadConfiguration(true);
//Will return ReloadConfiguration
sResult = transObj.Command;