Class NSDiagnosticsAgent

Diagnostics, usage data collection, caches, and flushing

Syntax

Examples

NSDiagnosticsAgent agent;
agent.callMethod(arg1, arg2);

Constructors

NSDiagnosticsAgent()

Diagnostics, usage data collection, caches, and flushing

Introduced or updated in version: 7

Declaration

NSDiagnosticsAgent

Examples

NSDiagnosticsAgent agent;
agent.callMethod(arg1, arg2);

Methods

AddWebAppUsage(NSWebAppUsage[])

Adds WebApp usage to existing log.

Introduced or updated in version: 7.5

Declaration

Void AddWebAppUsage(NSWebAppUsage[] webAppUsages)

Parameters

Type	Name	Description
NSWebAppUsage[]	webAppUsages

Returns

Type	Description
Void

ChangeLogSettings(Bool,Bool,Bool,Bool,Bool,Bool,Bool,Bool)

Changes NetServer log settings.

Introduced or updated in version: 7.5

Declaration

Void ChangeLogSettings(Bool logWarning, Bool logInformation, Bool logSuccessAudit, Bool logFailureAudit, Bool logToEventLog, Bool logToSuperOffice, Bool logToFile, Bool logToTrace)

Parameters

Type	Name	Description
Bool	logWarning
Bool	logInformation
Bool	logSuccessAudit
Bool	logFailureAudit
Bool	logToEventLog
Bool	logToSuperOffice
Bool	logToFile
Bool	logToTrace

Returns

Type	Description
Void

CollectDataAdditions()

Collects and transmits usage statistics: Database Additions. If opted-out then this call does nothing. The call returns immediately (starting a background thread), and updates CS scheduler table to set the next run time.

Introduced or updated in version: 8.0sr3

Declaration

Void CollectDataAdditions()

Returns

Type	Description
Void

Examples

NSDiagnosticsAgent agent;
agent.CollectDataAdditions();

CollectTableSizes()

Collects and transmits usage statistics: Table Sizes. If opted-out then this call does nothing. The call returns immediately (starting a background thread), and updates CS scheduler table to set the next run time.

NSDiagnosticsAgent agent;
agent.CollectTableSizes();

Introduced or updated in version: 8.0sr3

Declaration

Void CollectTableSizes()

Returns

Type	Description
Void

Examples

NSDiagnosticsAgent agent;
agent.CollectTableSizes();

CollectWebUsage()

Collects and transmits usage statistics: Web-based clients Usage. If opted-out then this call does nothing. The call returns immediately (starting a background thread), and updates CS scheduler table to set the next run time.

Introduced or updated in version: 8.0sr3

Declaration

Void CollectWebUsage()

Returns

Type	Description
Void

Examples

NSDiagnosticsAgent agent;
agent.CollectWebUsage();

CollectWinUsage()

Collects and transmits usage statistics: Windows CRM Client Usage. If opted-out then this call does nothing. The call returns immediately (starting a background thread), and updates CS scheduler table to set the next run time.

NSDiagnosticsAgent agent;
agent.CollectWinUsage();

Introduced or updated in version: 8.0sr3

Declaration

Void CollectWinUsage()

Returns

Type	Description
Void

Examples

NSDiagnosticsAgent agent;
agent.CollectWinUsage();

FlushCaches()

Flushes all NetServer caches

Introduced or updated in version: 7

Declaration

Void FlushCaches()

Returns

Type	Description
Void

FlushCachesByName(String[])

Flushes all NetServer caches named

Introduced or updated in version: 7.5

Declaration

Void FlushCachesByName(String[] cacheNames)

Parameters

Type	Name	Description
String[]	cacheNames

Returns

Type	Description
Void

Examples

NSDiagnosticsAgent agent;
String[] cacheNames;
agent.FlushCachesByName(cacheNames);

GetCacheNames()

Gets the name of the caches that can be flushed

Introduced or updated in version: 7.5

Declaration

String[] GetCacheNames()

Returns

Type	Description
String[]

Examples

NSDiagnosticsAgent agent;
String[] res = agent.GetCacheNames();

GetWebAppUsagesForPeriod(DateTime,DateTime,String)

Gets all WebAppUsages for a given period, that match an optional search term

Introduced or updated in version: 8.5R08

Declaration

NSWebAppUsage[] GetWebAppUsagesForPeriod(DateTime fromDate, DateTime toDate, String searchTerm)

Parameters

Type	Name	Description
	fromDate
	toDate
String	searchTerm

Returns

Type	Description
NSWebAppUsage[]

LogViewState(String)

Logs a change in view state.

Introduced or updated in version: 7

Declaration

Void LogViewState(String viewState)

Parameters

Type	Name	Description
String	viewState

Returns

Type	Description
Void

Remarks

The granularity of the logging depends on the current configuration.

This call returns asynchronously, leaving the server to finish processing later on.

PerformTasksAfterUpgrade()

After upgrading to a new file set, there may be tasks that need to be done. Fpr example, import new TypicalSearches, if present. Tasks performed here need to be idempotent and independent of the actual upgrade jump (what was the previous version). They should complete in a reasonable time, not more than a few minutes maximum.

Introduced or updated in version: 7

Declaration

String PerformTasksAfterUpgrade()

Returns

Type	Description
String

Examples

NSDiagnosticsAgent agent;
String res = agent.PerformTasksAfterUpgrade();

ResyncUsers()

Resynchronizes user information with SuperOffice Community, if opted-out then this call does nothing. The call returns immediately (starting a background thread), and updates CS scheduler table to set the next run time.

Introduced or updated in version: 8.0sr3

Declaration

Void ResyncUsers()

Returns

Type	Description
Void

Examples

NSDiagnosticsAgent agent;
agent.ResyncUsers();

WebAppUsageExistsInPeriod(Integer,String,DateTime)

Checks if viewState has been clicked at least once since a date.

Introduced or updated in version: 8.5R08

Declaration

Bool WebAppUsageExistsInPeriod(Integer associateId, String viewState, DateTime fromDate)

Parameters

Type	Name	Description
Integer	associateId
String	viewState
	fromDate

Returns

Type	Description
Bool	true if viewState has been clicked at least once since FromDate, if asscoiateId < 0 or FromDate is DateTime.MinValue no restriction given for those parameters.

Examples

NSDiagnosticsAgent agent;
Integer associateId;
String viewState;
DateTime fromDate;
Bool res = agent.WebAppUsageExistsInPeriod(associateId, viewState, fromDate);