Skip to main content

Interface ISaintAgent

Namespace: SuperOffice.WebApi.Agents
Assembly: SuperOffice.WebApi.dll
Administration and maintenance of SAINT counters and statuses

Implements

IAgentBase, IDisposable

Methods

CreateDefaultSaintConfigurationAsync(RequestOptions)

Set default values into a new SaintConfiguration. NetServer calculates default values on the entity, which is required when creating/storing a new instance

Parameters

requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<SaintConfiguration&gt; A blank SaintConfiguration

CreateDefaultStatusMonitorAsync(RequestOptions)

Set default values into a new StatusMonitor. NetServer calculates default values on the entity, which is required when creating/storing a new instance

Parameters

requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<StatusMonitor&gt; A blank StatusMonitor

CreateDefaultStatusMonitorPeriodsAsync(RequestOptions)

Set default values into a new StatusMonitorPeriods. NetServer calculates default values on the entity, which is required when creating/storing a new instance

Parameters

requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<StatusMonitorPeriods&gt; A blank StatusMonitorPeriods

GetSaintConfigurationsAsync(RequestOptions)

Returns the StatusMonitorPeriods entity.

Parameters

requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<SaintConfiguration[]&gt; The SaintConfiguration for all entities

GetStatusMonitorAsync(int, RequestOptions)

Get a single status monitor based on its identity

Parameters

id int Identity of status monitor requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<StatusMonitor&gt; The requested status monitor

GetStatusMonitorPeriodsAsync(RequestOptions)

Returns the StatusMonitorPeriods entity.

Parameters

requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<StatusMonitorPeriods&gt; The StatusMonitorEntity

GetStatusMonitorsAsync(int, string, RequestOptions)

Get all active status monitors for a specified target

Parameters

id int Identity of target type(contact identity, project identity etc.) type string Type to get status monitors for(“contact”, “project”, etc.) requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<StatusMonitor[]&gt; Active status monitors

RegenerateCountersAsync(bool, RequestOptions)

Regenerate the Saint counters - this can take several minutes

Parameters

runAsBatch bool If true, then execute the regeneration as a Batch Task; the service call will return immediately. Otherwise wait until the task completes, may cause a timeout if called as a Web Service requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<BatchTaskInfo&gt; Information about the batch task, if batch execution was requested. Otherwise null

RegenerateStatusMonitorAsync(int, RequestOptions)

Regenerate the given status monitor

Parameters

statusMonitorId int The id of the statusmonitor to regenerate requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task This method has no return value

RegenerateStatusMonitorsAsync(bool, RequestOptions)

Regenerate status monitors

Parameters

runAsBatch bool If true, then execute the regeneration as a Batch Task; the service call will return immediately. Otherwise wait until the task completes, may cause a timeout if called as a Web Service requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<BatchTaskInfo&gt; Information about the batch task, if batch execution was requested. Otherwise null

SaveSaintConfigurationAsync(SaintConfiguration, RequestOptions)

Updates the existing SaintConfiguration or creates a new SaintConfiguration if the id parameter is 0.

Parameters

saintConfiguration SaintConfiguration The SaintConfiguration that is saved. requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<SaintConfiguration&gt; New or updated SaintConfiguration

SaveStatusMonitorAsync(StatusMonitor, RequestOptions)

Updates the existing StatusMonitor or creates a new StatusMonitor if the id parameter is 0.

Parameters

statusMonitor StatusMonitor The StatusMonitor that is saved. requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<StatusMonitor&gt; New or updated StatusMonitor

SaveStatusMonitorPeriodsAsync(StatusMonitorPeriods, RequestOptions)

Updates the existing StatusMonitorPeriods or creates a new StatusMonitorPeriods if the id parameter is 0.

Parameters

statusMonitorPeriods StatusMonitorPeriods The StatusMonitorPeriods that is saved. requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task<StatusMonitorPeriods&gt; New or updated StatusMonitorPeriods

SetRankOnStatusMonitorsAsync(string, int[], RequestOptions)

Set rank order on status monitors

Parameters

type string Type of status monitors to reorder (“contact”, “project”, etc.) itemsIds int[] The ids of the items in the order you want requestOptions RequestOptions Override language/culture codes on this request.

Returns

Task This method has no return value