Forms collect data from Synapse users and put it into a Synapse table. Forms are currently available only in experimental mode as they are not yet ready for full release; please use wiki forms only with this caveat in mind.

With forms, you can:

  • Create surveys to collect feedback

  • Crowdsource data collection

  • Allow others to contribute data through a user-friendly user interface

Creating a Table

In order to use forms, you’ll need to create a table first. Read more about creating tables.

Activating and Deactivating Experimental Mode

On the right side of the Synapse footer, you will see Experimental Mode Off. Click this text to read a statement about enabling experimental mode, and click OK if you agree to the terms. Doing so enables a small number of new widgets in our wiki pages, all available under under the @ Insert menu in the wiki editing window.

You can also deactivate experimental mode at any time; click on Experimental Mode On to deactivate it and return to the default Synapse product.

Creating a Form

Once experimental mode has been activated, visit the wiki page where you’d like to insert the form. Click on Edit Project Wiki and select the @ Insert menu. Select Synapse Form from the menu and enter the table synID into the resulting pop-up window. The following Markdown text will be added to your wiki.

${synapseForm?tableId=syn123&successMessage=Your response has been recorded}

Optionally, you can add a customized “success” message for users by editing the Markdown text. When a form is submitted, it will create a new row in a Synapse table.

  • Column names are used as question prompts. Each column will appear as a separate question for users to answer.

  • The possible values for an enum column type, for example, will be a represented by a multiple choice question.

The form is also responsive, so it will render on both large and small screens.

Allowing Others to Contribute

Entering data into a form is equivalent to editing the data in a table, so users who wish to add data using the form will need to have Edit permissions on the table. See Sharing settings for more information on controlling who can edit your table.

See also:

TablesWikisSharing Settings and Permissions

Need More Help? Ask a question in the Synapse Help Forum. Your feedback is key to improving our documentation, so contact us if something is unclear or open an issue.