Home > Class Reference > ENSLIB namespace > Ens.Setting.Reporter


class Ens.Setting.Reporter extends %RegisteredObject

This class is for InterSystems internal use.


Parameters Properties Methods Queries Indices ForeignKeys Triggers
1 17 9


AllNamespaces CallonFinishSave CreateDocDBAndApplication
ExternalClientRESTPath ExternalClientRegistryID ExternalResultsAsJSON
IncludeExternalClients LocalResults LocalResultsAsJSON
LogExternalCallErrors RemoteTimeout RemoveLocalResultsAfterCopyToJSON
SearchNamespaces SettingNamePattern SettingReportClass
SpecificNamespace StoreLocalResultsAsJSON
%AddToSaveSet %ClassIsLatestVersion %ClassName %ConstructClone
%DispatchClassMethod %DispatchGetModified %DispatchGetProperty %DispatchMethod
%DispatchSetModified %DispatchSetMultidimProperty %DispatchSetProperty %Extends
%GetParameter %IsA %IsModified %New
%NormalizeObject %ObjectModified %OriginalNamespace %PackageName
%RemoveFromSaveSet %SerializeObject %SetModified %ValidateObject
AllowOthers GetPersistentReportNamespace GetReportAppURL SaveSearchResults
SearchSettings SetPersistentReportNamespace SetReportAppURL UseExclusively


parameter RESTVERSION = 1;
This is used to identify the External Registry Entry


property AllNamespaces as %Boolean [ InitialExpression = 0 ];
If AllNamespaces then SearchNamespaces array will be rebuilt for each search.
property CallonFinishSave as %Boolean [ InitialExpression = 1 ];
Allows control of calling onFinishSave of the Setting Report class after saving saving search results
property CreateDocDBAndApplication as %Boolean [ InitialExpression = 1 ];
If the Document database for the Setting Report does not exist when saving create the document database and application
property ExternalClientRESTPath as %String;
Override path for REST call to External client. Default is first to use the Client's RESTPath value and if that is empty string use /api/docdb/v1//find/
property ExternalClientRegistryID as %String(MAXLEN=254);
At the start of a search of ExternalClients if this is set then search is limited to this client whether or not it has property RESTClient of true. The Client is the Registry ID
property ExternalResultsAsJSON as %String [ MultiDimensional ];
%Dynamic array of %Doc objects subscripted by External Registry ID if retrieved from external system
property IncludeExternalClients as %Boolean [ InitialExpression = 0 ];
Whether to include External Clients in search
property LocalResults as %String [ MultiDimensional ];
Array of local instance results subscripted by Namespace
property LocalResultsAsJSON as %String [ MultiDimensional ];
Array of local instance results as %DynamicArray objects subscripted by Namespace
property LogExternalCallErrors as %Boolean [ InitialExpression = 0 ];
If this is true then Event Log Warnings will be used to report REST Call errors
property RemoteTimeout as %Integer [ InitialExpression = 5 ];
Timeout used REST connect to External Clients
property RemoveLocalResultsAfterCopyToJSON as %Boolean [ InitialExpression = 0 ];
If StoreLocalResultsAsJSON is true then this property allows for removing contents of LocalResults
property SearchNamespaces as %String [ MultiDimensional ];
Namespaces on this instance to search Subscripted by Namespace. Data is Production to search. If Data empty then the active production for the namespace is used.
property SettingNamePattern as %String;
This can be used to override the SettingNamePattern parameter from report class.
property SettingReportClass as %String(MAXLEN=254) [ InitialExpression = "Ens.Setting.Report.Port" ];
required to extend Ens.Setting.Report.base
property SpecificNamespace as %String(MAXLEN=255) [ InitialExpression = $Namespace ];
If not searching all namespaces and SearchNamespaces not defined specify one namespace to search - or populate ..SearchNamespaces() array
property StoreLocalResultsAsJSON as %Boolean [ InitialExpression = 0 ];
After searching convert LocalResults to an array of %DynamicArray objects in LocalResultsAsJSON


method AllowOthers()
method GetPersistentReportNamespace(Output pSC As %Status = $$$OK, pSetIfHaveData As %Boolean = 0) as %String
method GetReportAppURL(Output pWebServer As %String = "", Output pWebPort As %String = "", pWebPath As %String = "", pUseSSL As %Boolean = "") as %Status
method SaveSearchResults(pIncludeExternalResults As %Boolean = 1, pKeepExclusive As %Boolean = 0) as %Status
Save contents of LocalResults array and External Results if specified to persistent table. pKeepExclusive flag will keep exclusive lock at end of save if required. Default is not to.
method SearchSettings(pKeepExclusive As %Boolean = 0) as %Status
Search the specified namespaces and clients examining active/registered production
method SetPersistentReportNamespace(pNamespace As %String = "", pChangeNamespace As %Boolean = 0) as %Status
method SetReportAppURL(pWebServer As %String, pWebPort As %String, pWebPath As %String, pUseSSL As %Boolean) as %Status
method UseExclusively() as %Status
method configureSenderFromAttributes(pSender As Ens.Host, pExternalRegistryService As Ens.ServiceRegistry.External.Service)