Creating auto-enroll links to submit forms via links in Confluence

Since version 1.7.8 we introduced the functionality to register entries through URL.

This was available earlier as a REST API call and returned JSON as a result of the call, but now we have made it easier to use for ordinal users and it works with HTML.

Let's consider the following URL:

http://you_confluence_server/confiforms/autoenroll.action?pageId=1114114&f=myform&fi1=someval&fi2=anotherval&id=f7772622-d91f-401e-ac3c-5f263f219b45

You can see that a service is available in "autoenroll.action"

It expects pageId ("pageId" parameter) and formName ("f" parameter). These parameters are mandatory and mean the following:

• pageId - specifies the page where the user will be redirected after the method completes and expects that you have a form named ("f" parameter) configured there. If the forms is configured elsewhere  you need to specify a "storagePageId" parameter telling Auto-enroll that the forms is actually on some other page.
• f - specifies the name of the ConfiForms form 

• fi1=someval&fi2=anotherval&id=f7772622-d91f-401e-ac3c-5f263f219b45

  Here are 3 parameters fi1, fi2 and id  - this means that the record with given id will be updated with the given values. if you omit the "id" parameter then a new record will be created

• fi1 and fi2 are ConfiForms Field Definitions configured on the form. Most of the types are supported. File types are not supported at all. And you should be very careful with updating values for smart classifier type fields and other complex fields what ConfiForms has. 

Starting with ConfiForms 3.6.2 you can specify _merge=true parameter to merge given in the auto-enrol values with values in the record (when id is given)