Links

Form Manager

Introduction

The Form Manager application is a dedicated form building and data management interface built specifically for non-developers. This application is useful to offer to a team of non-developers so that they can easily manage the forms within a project without running the risk of them modifying configurations or making advanced changes that could potentially affect the stability of the application running on Form.io. Only forms designated to be seen by the Form Manager are available within the interface. This interface looks like the following.
This also provides an interface for building forms as well as managing the data within those forms.
This feature is enabled by first enabling the Developer Portal within your deployment by providing the PORTAL_ENABLED variable. For more information on how to set this up, see Portal Environment deployment in the enterprise deployment section.
Once you have done this, you will then need to Contact Support to have us enable this for each project that you wish to have this enabled.
Once this is done, you can now go to the following URL to see the Form Manager application.
https://yourproject.yourdomain.com/manager
Or, if you are using subdirectory project path method, it may look like the following.
https://yoursite.com/yourproject/manager

Authentication

The Form Manager uses the user resources within the project to authenticate. This means that you will not be able to use your Developer Portal accounts to log into the Form Manager application. The reason for this is to ensure that the users logging into the form manager application do not have the permission context to modify any other project other than the one that they are logging into.
By default the Form Manager application uses the User Login form within the project. Because of this the following form
Is the same form you get when you go to your Developer Portal | User Login form.
What this means is that any configurations you make to this form, such as SSO configurations, would also be applied to the Form Manager. This enables the Form manager to be used with other SSO strategies such as SAML or OAuth. For documentation on how to setup Form Manager for SSO, go to the following documentation.

Form Manager Users

If you are not using SSO, then you will most likely need to ensure that a User who has form management access is able to login to the Form Manager application. By default, the Administrator role has this access, which is provided to anyone who is added to the Admin resource. We can do this by first navigating to the Admin resource and add a new user account by using that form.
Once the user has been added, we will now need to ensure that our User Login form will allow for authentication into the Admin resource. This can be done by modifying the User Login > Login Action as follows and select Admin as an available resource.
Once this is done, you will now be able to login to the Form Manager application and manage the forms using the new "admin" that you just created

Adding Forms to Form Manager

Any form within the Developer Portal can be configured to be shown within Form Manager. In order to do this, the form you wish to display within Form Manager must be configured with a tag called common
Once this is done, that form will now appear within the Form Manager application where it can be managed by the form building administrators.

Multi-Tenant Form Building

The other major use case for the Form Manager application is to enable each Tenant to have their own form building interface for their tenant. This enables administrators for each tenant the ability to authenticate into their own form builder interface, where they will see their logo and theme configurations to build, manage, and embed the forms within their own applications. For more information on the Form.io Multi-tenant feature, check out the Tenants section.

Form Manager Configurations

The Form Manager application can be configured using a projects Public Configurations. This provides an interface where each project can provide public configurations that are used to control the behavior of their applications, but it can also be used as the configuration mechanism for the Form Manager application. To change the Form Manager configurations, first navigate to the Public Configurations of your project as follows.
Once you are here, you can now use the Public Configuration to provide any of the following configurations, which will customize how the Form manager behaves.
Setting
Description
Example
title
The title you would like to give to the Form Manager Application
Form Manager
logo
The url for the logo to present within the Form Manager
https://manager.form.io/assets/logo.png
logoHeight
The height of the logo within the Form Manager
40px
logout
The Logout URL which will redirect when the user clicks logout.
https://yourapplication.com/logout
js
The URL to a custom JavaScript file that allows for custom components and logic.
https://yoursite.com/js/custom.js
css
The URL to a custom CSS file for custom styling. This can also be used to change the Bootswatch theme as follows.
assets/lib/bootswatch/dist/cosmo/bootstrap.min.css
navbar
The class to apply to the Navbar to allow for inverted, etc.
navbar-dark bg-primary
sso
The type of Single Sign On to perform. Currently only supports “saml”.
saml
ssoProject
The project that will be used as the Authentication project for the Form Manager application.
https://yourdomain.com/formio
userIndicator
An HTML indicator that you would like to have for the user indicator within the navbar of the application
{{ user.data.email }}
vpat
Enable the VPAT mode for the Form Manager application. Requires your license to also have this flag enabled.
true