Setting Up a Simple Test Form

 Previous  Home topic  Next  Print this topic Send Feedback

Complete the steps below to set up a simple test form.

 

Document Icon
1.Go to the PerfectForms™ Forms Dashboard.
2.In the tree view, select Private Forms. Click New then Folder.
3.Name the folder 'APITests'.
4.Now, with the new folder selected, click New then Form. A new form will be automatically created and the Form Designer displayed.
5.Drag a Text Input object from the Common Inputs section of the Toolbox onto the form.
6.In the Properties bar, change the name of the field from 'Text Input 1' to 'txtInstanceName'.

Changing Field Name

7.Repeat steps 6 and 7 with another Text Input, and change its name to 'txtAPIText'.
8.Drag a Numeric Input from the Common Inputs section of the Toolbox onto the form.
9.Now, in the Properties bar, change the name of the field from 'Numeric Input 1' to 'txtAPINumeric'.
10.Drag and drop a Submit Button and a Text object (both in the Common Visuals section) onto the form.
11.Once you have added the Text object, change its Name property to “Instance Name”. Add two more Text objects and change their names to 'API Text Field' and 'API Numeric Field'.

API Demo Form

12. Set the form property Instance Name to the value of the field txtInstanceName.

Setting Instance Name

13. Make sure that the property Mandatory answer for the txtInstanceName object of the form is selected.

Selecting 'Mandatory Answer'

14.The form is now complete. Save the form by clicking Form > Save on the menu bar.
15.Close the form by clicking Form > Close on the menu bar or by clicking the Close button in the upper right corner of the Layout canvas area.
16.In the Forms Dashboard, publish the form by clicking on the Publish button at the bottom of the details area for the form. The form is now ready to be used with the API. The only remaining step is to get the URL of the Web service that manages this specific form.
17.Click the Link button at the bottom of the details area to launch the Link to Latest Published Version dialog. You will find the URL in the API Reference field.

Link Dialog - API Reference

18.The API link should look something like this: https://app.perfectforms.com/api/forms/auKggkgAgAAgnAgM_FirstTest.asmx
19.You can now test the Web Service by copying and pasting the URL into a browser window.
20.The URL is composed from the FirstTest and the exposed class name: http://devel.perfectforms.com/SDKFilter/formID_className.asmx. For  these examples, you will use the class name of 'APIDemoForm' so just rename the URL to http://devel.perfectforms.com/SDKFilter/mkIggQAgAAgACggE_APIDemoForm.asmx
21.Create some test instances by selecting the form in the tree view and clicking the New Instance button in the details area. Enter some data in the form and submit the form. Repeat this until you have filled in a few forms.
22.Now you can return to reviewing some sample code. This will be addressed in the next topic in this section; the Instances List topic.

 

Updated: 06/12/2011  Page url: http://www.perfectforms.com/Documentation/manual/html/?api_setting_up_a_simple_test_form.htm
PerfectForms™ -- forms software, workflow software, and business process management