The form editor allows creating, editing and deleting forms, which are collections of information (texts, pictures) that applications can read remotely. Those information are stored on Make me Droid site, they are available at any time.
Every item added or edited in those collections is immediately available to your application: in 2 mouse clicks, users get your latest changes.
Through the form editor, you create and manage information that you display inside your application the way you want. You define your own page layout while building the application, and that layout is then used to display information to users.
Creating a form
Let's imagine that we wish to have a book collection. Each book has a title, an illustrative picture and an excerpt. Here are a few steps to setup this:
From your Make me Droid account, select the application in which you want to show those information. The Live application content panel appears. Click on Dynamic application content.
Start by adding a new form, with name Books then click on Add.
A first form instance is created automatically for you. Every instance is a book in the collection. In our example, every instance (book) will have 3 fields: book title, illustrative picture and excerpt.
Firstly, use the word title as the identifier for the first row. Set Harry Potter as a value, then click on Add.
Do the same for the excerpt and the illustrative picture. For the excerpt, choose the Text format to be able to input multiple lines, and use excerpt as an identifier. For the picture, choose Picture format, use the identifier illupic then click on the default picture to select you own picture.
Your first book is ready. Note that your changes are saved real time, you don't have to save manually.
When all the fields you need are defined (title, illupic, ...) you can then clone the first instance you have just made to use it as a base for the next books. Use the Clone fields button and fill in some information for a few books for our example.
Using form content in the application
To show form content in the application, go to the screen designer, and add a screen of type dynamic list then follow those steps:
Default layout shown in the dynamic list screen is actually the template that will be used by every item of the list. Every form instance will be displayed in the list one after each other, based on that template.
In the template, replace one of the text item value with keyword $[title]. In the application, keywords are replaced with the real value of information that you have provided in the form editor. $[title] will in this case become Harry Potter for the first list item. The appropriate keyword for a form instance field is displayed in column Keyword in the form editor.
Click on the picture in the template, and in its properties, set Picture source to Data. Then in the Data source area, type $[illupic].
For the book excerpt, do the same as for the title: link a graphical item of type "text" with keyword $[excerpt].
Then click on the name of your dynamic list from your application screen list. Its properties let you configure its data source. A data source for a screen lets it know where to find the dynamic information to display.
Edit the data source, choose Form from online storage, then select form Books and validate clicking on Use this form then finally Set data source.
Save your application, and try it. You will see the book collection appear in the list.
After this basic list is created, you can improve the page layout and associate it with more actions. For example, when a dynamic list item is clicked, you could open a custom layout screen to show more details about a book, including its price, and proceed to a payment.
A line field format can contain more than standard text. For example, it can contain the web address of a picture such as http://www.mysite.com/mypicture.png. If you use it as a data source for a picture, then the application will get that picture from the web automatically.
You can also do this to provide a link (a web page to open, a package to be downloaded) and use the keyword in an action such as open a web page or download a file.