Getting Information About Forms

The ReadForms operation provides information about each form in the Forms tool. It provides the following information for each form: ID, name, FormsRecordDataSet_ID, URI, Type, MaintainRecordVersionHistory, IsResponse, and IsDeleted.

When a Forms designer creates a new form in a Groove Forms Tool or imports a template to an InfoPath Forms Tool, the Forms Tool assigns a Form ID to it. This FormID is preserved if the tool is saved in a Groove tool template, workspace template, or workspace archive, and then re-created. To reliably identify a form in your Web Services application you should identify it by Form ID. Although you can identify a form by its display name, the display name may be changed by a workspace manager with design permission. Note that the Form ID is not displayed in the Forms Tool Designer user interface—you must run a Web Services application that calls ReadForms to determine the Form ID.

The FormsRecordDataSet_ID element is used in the Forms2RecordDataSet type as the schema name for records created with this form.

The URI element identifies the form and can be used to create an HTTP Target URL to call the ReadFormFields operation to find out the information about the fields in the form. In addition, you can query for the records created by a specific form by using the form's URI as the value of the FormURI parameter in the QueryRecords operation.

The Type element identifies the form implementation. In Microsoft Office Groove 2007, the form type has either a value of "DHTML" for forms in a Groove Forms Tool or a value of "InfoPath" for forms in an InfoPath Forms Tool. In future versions of Groove, there may be new values for form Type. Consequently, your code should not assume that the forms in a tool are either all "DHTML" or all "InfoPath."

The MaintainRecordVersionHistory element describes whether Groove saves the existing version of a record when it is updated. The existing version of the record is assigned a new RecordID and is saved as a child of the new updated record.

The IsResponse element describes whether the Forms tool designer has specified that the form is used to create response records.

The IsDeleted element describes whether the Forms tool designer has deleted the form and Groove has marked the form for deletion. Groove retains the form as long as there are undeleted records created with this form.

In This Section

Example Code: Reading Forms and Form Fields

See Also

Reference

GrooveForms2.ReadForms Operation
GrooveForms2.ReadFormFields Operation

Concepts

Accessing Forms Tool Design Information
Getting Information About Views