Testing Whether the Forms Tool Design Has Been Initialized
Before accessing the data in the Forms tool, you should first check if the Forms tool has been designed. When the Forms tool is first added to a workspace, it is empty and does not have any forms or views. The Forms tool must be designed before any records can be added. At a minimum, the Forms tool designer must define a form and a view in the design sandbox and then publish the sandbox. After the Forms tool design is initialized, workspace members can add records to the Forms tool.
The IsFormsToolDesignInitialized operation returns true if the Forms tool design has been initialized. A design is considered initialized when the designer has created at least one form and one view and has published the sandbox. In an InfoPath Forms tool, the design is initialized when the designer has imported an InfoPath template, created at least one view, and published the sandbox. Once an instance of a Forms tool design has been initialized, it cannot return to the undesigned state.
If you call any other GrooveForms2 operation before the Forms tool design is initialized, you may get a SOAP exception.
In This Section
Example Code: Testing Whether the Forms Tool Design Is Initialized
See Also
Reference
GrooveForms2.IsFormsToolDesignInitialized Operation