ConfiForms

Page tree

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.


In this tutorial we will setup 2 data entry forms with ConfiForms on 2 different pages, where one form will be just a proxy, and the data (including attachments) will be passed to another form. This is done using ConfiForms IFTTT macro with action to "Create ConfiForms Entry"

The data is passed to another form (and deleted from original) only when:

  • we set a field "Backup?" to true

See form configuration below for fields and types

If you are new to ConfiForms, please take a few minutes to read the Basic concepts Guide, or go through the video tutorial on that page.  (smile)

As usual, let's start with form configuration (we will have 2 forms on different pages. Different pages is important here to demonstrate how the attachment/file type get's transferred)
So, a form with 4 fields
  • text field
  • another text field
  • file type field 
  • checkbox type field (this will be the condition to backup or not the contents)

Form in page edit mode:

In view mode the form looks like this

 

 

Full solution (storage format is here)

 

<ac:structured-macro ac:macro-id="19608453-440e-4c19-8b2a-db952f81f567" ac:name="confiform" ac:schema-version="1">
  <ac:parameter ac:name="formName">f</ac:parameter>
  <ac:rich-text-body>
    <p>
      <ac:structured-macro ac:macro-id="807fa60b-7cbe-4fe3-99c8-900b10f841b6" ac:name="confiform-field-definition" ac:schema-version="1">
        <ac:parameter ac:name="fieldName">t</ac:parameter>
        <ac:parameter ac:name="fieldLabel">TextField 1</ac:parameter>
        <ac:parameter ac:name="type">text</ac:parameter>
      </ac:structured-macro>
    </p>
    <p>
      <ac:structured-macro ac:macro-id="ac51aec4-6715-4e9d-832f-1994d1095519" ac:name="confiform-field-definition" ac:schema-version="1">
        <ac:parameter ac:name="fieldName">t1</ac:parameter>
        <ac:parameter ac:name="fieldLabel">Another TextField</ac:parameter>
        <ac:parameter ac:name="type">text</ac:parameter>
      </ac:structured-macro>
    </p>
    <p>
      <ac:structured-macro ac:macro-id="75e1f0e2-024f-4d89-a897-a40c4baaa03c" ac:name="confiform-field-definition" ac:schema-version="1">
        <ac:parameter ac:name="fieldName">backup</ac:parameter>
        <ac:parameter ac:name="fieldLabel">Backup?</ac:parameter>
        <ac:parameter ac:name="type">checkbox</ac:parameter>
      </ac:structured-macro>
    </p>
    <p>
      <ac:structured-macro ac:macro-id="e29cec22-5e91-4eac-9d1a-c8964ba6cd21" ac:name="confiform-field-definition" ac:schema-version="1">
        <ac:parameter ac:name="fieldName">f</ac:parameter>
        <ac:parameter ac:name="fieldLabel">File</ac:parameter>
        <ac:parameter ac:name="type">file</ac:parameter>
      </ac:structured-macro>
      <ac:structured-macro ac:macro-id="1d943281-7e87-4ef8-8d41-b140a8f4d9f9" ac:name="confiform-entry-register" ac:schema-version="1">
        <ac:parameter ac:name="atlassian-macro-output-type">INLINE</ac:parameter>
        <ac:rich-text-body>
          <p> </p>
        </ac:rich-text-body>
      </ac:structured-macro>
    </p>
    <ac:structured-macro ac:macro-id="3b48467f-e106-44e1-9669-7db873797b41" ac:name="confiform-ifttt" ac:schema-version="1">
      <ac:parameter ac:name="condition">backup:true</ac:parameter>
      <ac:parameter ac:name="action">Create ConfiForms Entry</ac:parameter>
      <ac:parameter ac:name="event">onCreated</ac:parameter>
      <ac:parameter ac:name="title">t=[entry.t]&amp;t1=[entry.t1]</ac:parameter>
      <ac:parameter ac:name="who">backup:5341692</ac:parameter>
      <ac:rich-text-body>
        <p>
          <ac:structured-macro ac:macro-id="6177d529-fc27-4fdd-b575-ad5650f252eb" ac:name="confiform-field" ac:schema-version="1">
            <ac:parameter ac:name="fieldName">f</ac:parameter>
          </ac:structured-macro>
        </p>
      </ac:rich-text-body>
    </ac:structured-macro>
    <ac:structured-macro ac:macro-id="162e023d-e833-4199-adc8-a4f092f127a0" ac:name="confiform-ifttt" ac:schema-version="1">
      <ac:parameter ac:name="condition">backup:true</ac:parameter>
      <ac:parameter ac:name="action">Create ConfiForms Entry</ac:parameter>
      <ac:parameter ac:name="event">onModified</ac:parameter>
      <ac:parameter ac:name="title">t=[entry.t]&amp;t1=[entry.t1]</ac:parameter>
      <ac:parameter ac:name="who">backup:5341692</ac:parameter>
      <ac:rich-text-body>
        <p>
          <ac:structured-macro ac:macro-id="eccce14f-6aa8-4bf8-bf7f-6d5beadb89ee" ac:name="confiform-field" ac:schema-version="1">
            <ac:parameter ac:name="fieldName">f</ac:parameter>
          </ac:structured-macro>
        </p>
      </ac:rich-text-body>
    </ac:structured-macro>
    <ac:structured-macro ac:macro-id="91d5efa6-8ab4-47c6-8f1d-9cc01a9c0321" ac:name="confiform-ifttt" ac:schema-version="1">
      <ac:parameter ac:name="condition">backup:true</ac:parameter>
      <ac:parameter ac:name="action">Delete ConfiForms Entry</ac:parameter>
      <ac:parameter ac:name="event">onCreated</ac:parameter>
      <ac:parameter ac:name="title">id:[entry.id]</ac:parameter>
      <ac:parameter ac:name="who">f:5341690</ac:parameter>
      <ac:rich-text-body>
        <p> </p>
      </ac:rich-text-body>
    </ac:structured-macro>
    <ac:structured-macro ac:macro-id="31e6bb23-b378-45a1-84a4-cf1050f33d96" ac:name="confiform-ifttt" ac:schema-version="1">
      <ac:parameter ac:name="condition">backup:true</ac:parameter>
      <ac:parameter ac:name="action">Delete ConfiForms Entry</ac:parameter>
      <ac:parameter ac:name="event">onModified</ac:parameter>
      <ac:parameter ac:name="title">id:[entry.id]</ac:parameter>
      <ac:parameter ac:name="who">f:5341690</ac:parameter>
      <ac:rich-text-body>
        <p> </p>
      </ac:rich-text-body>
    </ac:structured-macro>
  </ac:rich-text-body>
</ac:structured-macro>

Second form is very simple, just 3 fields:

  • text field 
  • another text field 
  • file type field

Storage format for the second form

<ac:structured-macro ac:macro-id="55303a18-9a34-4f7f-a130-99fff66ced0f" ac:name="confiform" ac:schema-version="1">
  <ac:parameter ac:name="formName">backup</ac:parameter>
  <ac:rich-text-body>
    <p>
      <ac:structured-macro ac:macro-id="f9f990de-a265-445f-83ff-142909b51ab3" ac:name="confiform-field-definition" ac:schema-version="1">
        <ac:parameter ac:name="fieldName">t</ac:parameter>
        <ac:parameter ac:name="fieldLabel">TextField 1</ac:parameter>
        <ac:parameter ac:name="type">text</ac:parameter>
      </ac:structured-macro>
    </p>
    <p>
      <ac:structured-macro ac:macro-id="4a8b19ea-a23c-45ea-b31a-53ae4297e108" ac:name="confiform-field-definition" ac:schema-version="1">
        <ac:parameter ac:name="fieldName">t1</ac:parameter>
        <ac:parameter ac:name="fieldLabel">Another textfield</ac:parameter>
        <ac:parameter ac:name="type">text</ac:parameter>
      </ac:structured-macro>
    </p>
    <p>
      <ac:structured-macro ac:macro-id="1c8fb1b0-4696-4edc-b96b-efaa628230ee" ac:name="confiform-field-definition" ac:schema-version="1">
        <ac:parameter ac:name="fieldName">f</ac:parameter>
        <ac:parameter ac:name="fieldLabel">f</ac:parameter>
        <ac:parameter ac:name="type">file</ac:parameter>
      </ac:structured-macro>
    </p>
  </ac:rich-text-body>
</ac:structured-macro>

 

Let's start with important bits about IFTTT setups, which will help us to implement this solution

For this 1st main form we will have 4 IFTTT handlers

2 for each event, and we will track record creation and record updates. and will fire the IFTTT action only when "Backup?" checkbox field is checked

See first 2 IFTTT integration rules, they are identical but are binded to different events, their fire when condition

backup:true

is met, and they create a new record in our second form and, very important bit, they also say that field "f" should be included into action. Field "f" on our form is a file field type and this bit tells IFTTT action to transfer the File to a new place

Here is how the setup for those both IFTTT handlers looks like (they differ only in the event type they are binded to)

So, we fire this event only when "backup:true", meaning that checkbox to backup the record is set to "checked" and we copy values from original entry to the new one

t=[entry.t]&t1=[entry.t1]

And include the ConfiForms Field macro which references a file (in our case field type is called "f")

inside the IFTTT macro body

 

 

Last 2 IFTTT Integration Rules macros deal with cleanup in the original form (also binded to 2 events: create and modify).

When the same condition is met the cleanup routine is executed

So, the original record in original form get's deleted by given filter when "backup:true" condition is met

 

For IFTTT macro configurations which work with creating or deleting records in the form one very important configuration parameter is left unset

It is the form name and form's location (page)

So, scroll down for each IFTTT macro defined, and for the ones which copy the data the "Reference form and location" will be the backup form and it's location (pageId)

 

For the IFTTTs which clean up the data in original form you will need to reference this form

 

Where do you see the pageId?

The most easiest way is to go to the page edit mode and see the "pageId" parameter value in your browser bar

 

 

And the solution is ready!

First form takes inputs from a user, stores it inside it's own storage and when a backup is requested then the data is copied to another form (including files!) and deleted from original place

 

 

  • No labels