GrooveForms2.QueryRecords Operation

Applies to: SharePoint Workspace 2010 | Visual Studio 2008

In this article
HTTP Post URL
Input Message Header
Input Message Parameters
Output Message Header
Return Value

The QueryRecords operation returns the Forms tool records that match the specified conditions.

HTTP Post URL

The HTTP Post URL targets the Forms tool. This URI is provided by the GrooveTools.Read operation in the ToolData element.

Input Message Header

GrooveRequestHeader specifies information common to all Groove Web Services, including the Groove Identity URL and the Groove Request key.

Input Message Parameters

<RecordQuery />

Element

Data type

Description

RecordQuery

RecordQuery

Specifies the selection conditions. RecordQuery includes the following elements: ViewURI, FormURI, UnreadRecordsOnly, WhereClause, QueryMetaDataOnly, and IncludeFileAttachmentContent.

Output Message Header

GrooveResponseHeader specifies the Response key.

Return Value

<QueryRecordsResult />

Element

Data type

Description

QueryRecordsResult

Forms2RecordDataSet

The Schema element defines the record schemas. The Data element contains the records.

Remarks

If you specify the RecordQueryFormURI element, the QueryRecords operation matches only records created with the specified form. You can specify the FormURI of any form returned by the ReadForms operation including forms that have been marked for deletion but not yet deleted. This allows you to access existing records whose form has been deleted. If you do not specify the FormURI element, the Data element can contain records that are created using different forms and that are described by different record schemas.

If the QueryRecords operation finds no matching records, the returned Forms2RecordDataSet has an empty Data element and has no elements defining the record schemas in the Schema element.

The content of attachments are included if the RecordQueryIncludeFileAttachments element has a TRUE value.

If this operation fails for a single record, then it will fail for all records and will return a SOAP exception. For example, if the user specified by the Identity URL in the header does not have permission to read any of the specified records, then the operation will fail and no records will be returned.

See Also

Reference

GrooveForms2 Web Service

Forms2RecordDataSet Complex Type

Concepts

Querying Records