Introduction
FormAssembly for AppExchange is a tool that allows you to access your FormAssembly account from within Salesforce, without requiring a separate login (this is also called Single Sign-On or SSO).
You may access the same form building and Salesforce integration capabilities by signing up directly on our main website: http://www.formassembly.com and selecting our Professional, Premier, or Enterprise Plan.
We highly recommend using the video tutorial below to help guide you through this process.
Getting Started
Follow the step by step guide below to begin using FormAssembly within Salesforce. These steps will work for both Salesforce Classic and Salesforce Lightning users.
Please note that FormAssembly for AppExchange can only be used between a single FormAssembly account and a single Salesforce account, and that the usernames for both must match.
You must complete this process while signed in as the administrator for your Salesforce instance.
1) Would you like to be able to access FormAssembly from within your Salesforce instance?
Yes. Continue to question 2.
2) Does your FormAssembly username exactly match your Salesforce username?
Yes. Continue to question 3.
3) Have you already installed the FormAssembly app for AppExchange?
Yes. Please make sure you have the most recent version by installing this package (currently version 2.6). Then continue to question 4.
4) Was the installation of the FormAssembly app for AppExchange successful?
Yes. You will be automatically taken to your Installed Packages page. Find the FormAssembly package and click Configure, then click Edit. You will see this screen:
If you are an enterprise user, make sure you FormAssembly instance URL is set to xxxxx.tfaforms.net (where xxxxx is your instance name).
Regardless of your plan type, you will also need to set a Location. This can either be a profile (e.g., system administrator) or a user (e.g., yourself). For initial setup, this should either be the system administrator user, or the system administrator profile. Please refer to the video tutorial below for additional help on this step.
Once you've completed this setup, click Save and move on to question 5.
5) Do you need to setup additional Salesforce users or profiles that will be using the FormAssembly App?
Yes. You may add in additional profiles and roles by going to your custom settings and clicking on Manage next to the FormAssembly package.
If you are an enterprise user, these new profiles/users must all have their instance URL set to xxxxx.tfaforms.net, as mentioned in question 4 above. You can watch the video tutorial below for additional help on this step if needed. Once this step is done, just complete the email verification process and you're all finished and you can now launch the FormAssembly app from the app launcher!
Installing the FormAssembly App on a Sandbox Instance
If you are installing FormAssembly for your Salesforce sandbox instance, you will first need to have the 2.6 version of the app installed in your production instance, as explained above.
Next, please refresh your sandboxes by going to Setup > Sandboxes > Refresh.
You should now see FormAssembly installed for your sandbox as well.
Using Single-Sign On Between Production and Sandbox
As noted above, SSO can only be used between a single Salesforce account and a single FormAssembly account, because the usernames must match.
Therefore, if you are planning on using SSO for both a sandbox instance of Salesforce and a production instance of Salesforce, you will need to request that your username be changed when switching between the two, in order for your FormAssembly and Salesforce username to match. Please note, if you are an enterprise user, you have the capability to change your username from the admin dashboard.
Alternatively, you can login to FormAssembly at app.formassembly.com or through your enterprise URL to avoid changing your username. You will have access to identical functionality by logging into the FormAssembly through the web, when compared to logging in through SSO in Salesforce.