S4. Service Method Details

---

All Methods return the standard envelope. Method input parameters, and the varying content of the node for each Method is indicated in each Method’s detailed description.

4.1. Method: GetContainer

Input Parameters:

Parameter	Data Type	Required	Sample Data	Description
Scope	String	Yes	display	XDOC function / need for the Object.
Container	String	Yes	12345	Primary Id of the Object in the Integrated Application.
IncludeLists	Bool		0,1	Indicates to include detail lists in the output XML.
IncludeRoles	Bool		0,1	Indicates to include the User Role list.

Method Invocation URL Example:

/xdoc/service.ashx?Method=GetContainer&Scope=display&Container=5565

ResponseData Node Content:

The ResponseData node must be valid Container XML as defined in section 2. If the container was not found, it should be left empty.

4.2. Method: FindContainer This Method is identical to the GetContainer method, except that the Container parameter may either be the ContainerKey (primary id) or the ContainerReference (user friendly unique key) for the Object.

In many Integrated Applications, if the ContainerReference is un-changeable, then this value is often the same as the ContainerKey. E.g.: Loan Number. In some Integrated Applications however, the ContainerKey may be an internal identifier for the object, while the ContainerReference may be a different human readable identifier. E.g.: PersonId and SSN respectively.

Input Parameters:

Parameter	Data Type	Required	Sample Data	Description
Scope	String	Yes	display	XDOC function / need for the Object.
Container	String	Yes	12345	ContainerKey or ContainerReference for the Object.
IncludeLists	Bool		0,1	Indicates to include detail lists in the output XML.
IncludeRoles	Bool		0,1	Indicates to include the User Role list.

Method Invocation URL Example:

/xdoc/service.ashx?Method=FindContainer&Scope=display&Container=5565

ResponseData Node Content:

The ResponseData node must be valid Container XML as defined in section 2. If the container was not found, it should be left empty.

4.3. Method: GetLastUserContainer Returns the Container XML for the last Container the user was working on in the Integrated Application.

Input Parameters:

Parameter	Data Type	Required	Sample Data	Description
Scope	String	Yes	display	Indicates how XDOC is using the result data.
IncludeLists	Bool			Indicates to include detail lists in the output XML.
IncludeRoles	Bool		0,1	Indicates to include the User Role list.

Method Invocation URL:

/xsuite/xms/webservice/Message/service.ashx?Method=GetLastUserContainer&Scope=display&UserName=jsmith

ResponseData Node Content:

The ResponseData node must be valid Container XML as defined in section 2. If the container was not found, it should be left empty.

4.4. Method: SearchContainers Returns Container List XML for containers matching the input Search Field Criteria.

The Search Field parameters are multi-instance parameters. E.g., multiple instances of each may be passed to the method, each representing a search condition.

Input Parameters:

Parameter	Data Type	Required	Sample Data	Description
Scope	String	Yes	search	Indicates how XDOC is using the result data.
IncludeLists	Bool			Indicates to include detail lists in the output XML.
FieldCode	String		loanType	The field to search on.
FieldOperator	String		inList	The operator to use for the search condition.
FieldValue	String		refi,purchase	The value for the search condition.

Method Invocation URL:

/xsuite/xms/webservice/Message/service.ashx?Method=SearchContainers&SecurityToken=&UserName=jsmith&FieldCode=loanNumber&FieldOperator=inList&FieldValue=12345,67898&FieldCode=submittedDate&FieldOperator=%3E&FieldValue=20100201

ResponseData Node Content:

The ResponseData node must be valid ContainerList XML as defined in section 2.

4.5. Method: GetGroupContainers Returns ContainerList XML for containers defined as part of this “Group” in the Integrated Application.

Input Parameters:

Parameter	Data Type	Required	Sample Data	Description
GroupKey	String	Yes	99	User Friendly Identifier of the Group in the Integrated Application.
GroupScope	String		trade	The type of group being requested. This allows for Integrated Applications that have more than 1 grouping construct for Containers.
IncludeLists	Bool			Indicates to include detail lists in the output XML.
IncludeRoles	Bool		0,1	Indicates to include the User Role list.

Method Invocation URL:

/xsuite/xms/webservice/Message/service.ashx?Method=GetGroupContainers&UserName=jsmith&GroupKey=99

ResponseData Node Content: The ResponseData node must be valid ContainerList XML as defined in section 2.