Form Transfer Tool 


In this Article
Related Articles

Overview

The FormAssembly Form Transfer tool makes it easy for you to move your forms and connectors from your main app account (at the Professional or Premier level) to your Enterprise instance, as well as Enterprise to Enterprise instances.

You can move your forms and connectors on your own without needing to start a support ticket, of course we're here and ready to help if you run into difficulties!

Please note, that forms cannot be downgraded from Enterprise to App accounts.  They can only be transferred from App (Professional and/or Premier) to Enterprise. 


Requirements

For information on upgrading, please contact our Sales Department at sales@formassembly.com.


Setup

Step 1 - Enable your Server: Then you will need to add any servers that you want to tranfer forms to or from. You can add them by going to Admin → Settings → Miscellaneous → Form Transfer Settings. The main FormAssembly server (for Professional and Premier plans) is enabled by default:

Step 2 - Register the Third Party App: Finally, you will need to go to Admin Dashboard → Settings → Third Party Apps and choose Create new app

You will need to set the name to exactly: "FormAssembly Form Transfer" and then choose Save.

Edit the app you just created by clicking on the pencil icon and set the Client ID to VosD7L0xJzL7dkjJXTK2 and the Client Secret to m5xjILyKJNv8IuuNQaXJ then click save again.


Transferring Forms

Prior to beginning your form transfer, please make sure to read the Important Note about Form ID's below.  You will need to ensure that the form you are transferring does not have the same ID as a form that already exists in the destination location.

Please Note:  Archived forms cannot be transferred.  They must be active for the Transfer Tool to see them.  

To start your form transfer, make sure that you are logged in as the desired user (as defined above) on your Enterprise instance. This may require you to do an admin override as the user you want to transfer forms to.

Next, go to the Form Transfer Tool. It can be found here:https://[server sub-domain].tfaforms.net/form_transfer/

From here you will need to select the server to log into. You will need to select both the server you will be copying forms from, and the server you will be copying forms to. Select one on the right and one on the left, it does not matter which server is on which side.

Select the one that you want to connect to and choose to log in. Once there you will need to authorize the external access:

After logging in you will need to select the forms you want to move over and choose "Copy Selected # forms".

If you do not see any forms after authenticating, try refreshing the webpage without selecting "Log out all connections."

After that, you're ready to go!  Your new forms will have been transferred over to the server you selected.

If you get any red exclamation points (!) when copying your form, you can visit your Admin Dashboard → Settings → Miscellaneous and at the bottom of the page increase your API quota to a large number (e.g. 10000) and try again.

Please Note:  Connectors on the transferred form will need to be reauthenticated to your Salesforce account after transferring.


What Gets Copied

When you use the Form Transfer tool, you are essentially copying the form to a new location, so the form will still be available in its original location as well, once the transfer is complete.

Additionally, when you transfer a form, the connectors and theme will be transferred along with the form.

The only things that are not transferred are form settings you have on the display, configuration, and/or notification tabs, any associated images that were uploaded into a form, and response data (including form attachments).  

You are able to reconfigure your notification and display/processing options on your new form once it has been transferred.  Currently, we have no way of transferring response data or form images. 


Predefined Content

Predefined content can be added by transferring this form via the Form Transfer Tool.  After transferring this form to your instance, follow the instructions below.

  1. Admin Dashboard - Templates - Predefined Content
  2. Click Edit Settings
  3. Click Start all new form with this template
  4. Click Apply
  5. Click Back to Forms List
  6. Click New Form (The predefined content form will open.)
  7. To add Google Analytics to your Predefined, click on the last page, page 8.
  8. Now click on the Google Account ID field
  9. Click Options
  10. Click Save as Predefined Content from the menu
  11. Give it a name and click Save

This element will be available in the Add Content menu for the Enterprise user that you currently logged into.

To get back out of Predefined mode so that when you create a new form it won’t auto open that form:

  1. Click on Admin Dashboard - Templates - Predefined Content
  2. Click Edit Settings
  3. Uncheck Start all new form with this template
  4. Click Apply

Important Notes

If you are transferring your forms to an Enterprise instance, you will need to update any links pointing to the form.  The links should reflect the URL of your newly transferred forms.   The correct URL may be located on the Publish page of your form.

Note: If the form you are transferring has the same ID as a form that already exists in the destination location, the form in the destination location will NOT be overwritten.  Instead, a new ID will be assigned to the transferred form.  
To OVERWRITE the existing form in the destination location, be sure to check the box labeled "Keep current form IDs when transferring."  



IP Whitelisting

If you are running into difficulties with the Form Transfer Tool, please check that you have whitelisted the following IP Addresses:

Start IP AddressEnd IP Address
34.230.105.24334.230.105.243
34.231.230.1134.231.230.11
18.221.37.21418.221.37.214
169.46.2.120169.46.2.127
Please note: Foreign provisions outside of the US will be using different IP ranges, which can be found by contacting our support team through your in-app chat. 
Terms of Service · Privacy Policy