About “pruning” the Master Explorer folder display

The Prune Explorer Folder Callout process default is used to specify a user-defined method to be called during expansion of each Explorer folder node. The specification must be in the form: IDOName.MethodName.

Note: The IDOName and MethodName are determined by the application developers.

The purpose of this callout method is to “prune out” undesired form names from the Explorer node’s XML according to criteria that is defined by the user.

This method must be defined as an IDO extension class method and can be on an existing or new application IDO.

The callout method accepts three parameters:
Parameters Description
UserName (input, string) Mongoose application username logged into WinStudio or web client. This value is supplied by the framework when the callout method is invoked.
OriginalExplorerXML (input, string) The explorer XML for a given node that is loaded in response to the framework LoadExplorer request. This XML stream is supplied by the framework when the callout method is invoked.
PrunedExplorerXML (output, string) A “pruned” version of the OriginaExplorerXML that is passed in.

OriginalExplorerXML string represents a serialized version of the LoadExplorerResponseData class. To massage or prune any form name specifications out of that XML, the method must deserialize that XML, manipulate the data in the resultant LoadExplorerResponseData class, and then serialize the XML again before you assign the XML to the third output parameter.

To deserialize, use LoadExplorerResponseData lxrd = LoadExplorerResponseData.FromXml( OriginalExplorerXML ). To serialize, use PrunedExplorerXML = lxrd.ToXml().

Implementation of the desired algorithm for pruning the explorer folder contents must be done by the application developer. A method template is provided and the user implementation code is included between these two comments:

// Begin user implementation

// End user implementation