You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 16 Next »

This is the documentation for ConfiForms Server/Data Center app

However, this might also work for ConfiForms cloud and in most cases it does. But please see this page to understand the differences between server and cloud versions of the ConfiForms app.

We at Vertuna LLC, live, eat and breath data entry forms, we just love to build forms to quickly collect user opinions and feedback. And we love Atlassian products, so we have built, and continue to build, the best forms add-on for Confluence available on Atlassian Marketplace called - ConfiForms, Data entry forms and workflows.

ConfiForms provides a lot of versatility on the features and use cases it covers and supports. While, almost everything could be build with Confluence editor, using the macros ConfiForms provides, in this article we would like to show you some custom, sexy forms, you can build with ConfiForms and with a bit of scripting.

We will build a form to quickly gather user's feedback, something you have probably seen in the airports all over the globe

An example of how ongoing feedback is collected at Heathrow Airport [Source]


Looks familiar? OK, in our case it will look a little bit different and will be something like this

Icons designed by from Flaticon [License]


We would like to collect the data from our users and show some simple charts and reports over the collected data later.

Let's get this going. 

We will use ConfiForms plugin to define the form, The form will be very simple, having just one field definition and the field definition would be of type "Dropdown" with 4 options

idlabel
1Awesome
2Good
3Could be better
4WTF!?

In Confluence editor this would look like this:

[---- HOW the form looks in Confluence Editor ---- ]


We can add a default FormView, but it is rather boring, as you can see below

We want something more sexy and user engaging. So, we will build a user macro with icons and a little bit of scripting to glue the things together.

Awesome

Good

Could be better

WTF!?

Thank you for your feedback

When a form is used by an authenticated user then this information is stored in the createdBy field, as ConfiForms has some metadata fields stored with each record (even when you have defined just one field, as we did in this example)

When a form is used by anonymous users the createdBy field is left blank

What is good about ConfiForms is that you can use and re-use the defined form on multiple pages, as well as build the "views" around the stored data where you want. Let's build the table over the stored data, we will show the metadata field created with the feedback given

Also, to have a good overview of the data stored we will make a simple report using Confluence built in chart macro and will group the choices made by our users and present the aggregated data as a pie chart



  • No labels