Forms#
With the Forms Add-on you create forms and send them via link to employees for filling out. New colleagues can thus document, for example, computers in the company without needing to know the entire i-doit interface.
The advantage: Instead of all categories with all fields, you only show the attributes that actually need to be filled out.
More about this can be found in our Blog and in the Video.
The Forms Add-on is currently provided in English. Translations originating from i-doit are also translated into German.
Requirements#
The Forms add-on requires:
- i-doit Version >= v23
- MongoDB Server Version >=8
- NodeJS Version >= v22.x
The system requirements of MongoDB must be observed. Furthermore, MongoDB provides a checklist for production deployment.
NodeJS has its dependencies documented here.
Installation#
To install the add-on:
- Install the Forms Add-on via the Admin Center.
- Install MongoDB Server v8.
- Install NodeJS v22 via the nvm Package Manager.
- Configure the Forms backend.
- Configure i-doit.
Continue to the Forms Add-on installation
Assigning rights#
For users to be able to create forms, assign the corresponding permissions under Administration → Authorization system → Rights → Forms.
Clear the authorization system cache
After you have assigned or changed the permissions, clear the cache in the i-doit administration under Administration > [tenant-name] Administration > System repair and cleanup, so that the changes are applied by the system.
Accessing the add-on#
After completing all preparations, you can access the add-on under Add-ons → Forms.
Using the API#
This document contains a basic description of the Forms API.
Releases#
| Version | Date | Changelog |
|---|---|---|
| 1.3 | 2025-07-18 | [Bug] Object is not created when a attribute validation is used [Bug] Link to a form does not include tenant id [Bug] Using Forms to create an object bypasses validation "unique" check [Bug] Creating a object via Form ignores validation for attributes [Bug] The Location and all physically assigned objects below right only works if parameter All is selected [Bug] Created Objects are not indexed after creation [Bug] Highlight 'add-on' instead of 'extras' menu [Bug] Content is overlapping in list of forms [Bug] Unable to select objects for Net (Hostaddress (IPv4)) attribute [Bug] Hostaddress category can not be validated properly [Bug] Shorten object names dynamically in Object Browser [Bug] Change Service assignment to multiple select object browser |
| 1.2.1 | 2025-05-14 | [Task] Allow removal of instances and their data over cli [Task] Implement health endpoint on backend-server [Task] Add support for node v22 on backend-server [Task] Add support for mongodb v8.x on backend-server |
| 1.2.0 | 2023-05-03 | [Bug] Fix Investment cost and cost center with Forms [Bug] Align categories on the left side [Bug] Fix right to delete or create Forms [Bug] Fix empty list in object browser if category names should be used in header [Bug] Show objects if attribute type is missing [Bug] Improve rendering performance of object browser fields with multiple objects [Bug] Filter child values after parent values |
| 1.1.0 | 2022-06-27 | [Bug] Allow all default characters to be used in Forms-secret key [Bug] Do not show time selection in Start date for license keys [Bug] Allow to publish form if load balancer and HTTP2 is used [Bug] Save Form when publishing [Bug] Create Logbook entries when creating an object and category data via "Forms" add-on [Bug] Filter down connectable objects for custom categories with object relations in Forms [Bug] Allow user to copy link in Forms table [Bug] Allow user to select multiple objects in Forms object browser [Bug] Inform user about required attributes in category [Task] Add tooltip to disabled state of copy link button in Forms add-on [Task] Allow to add child attribute only when parent dependent is added [Task] Change real text to placeholder text in text field in Forms add-on [Task] Do not allow to add same attribute multiple times in Forms [Task] Give user warning before publishing if form will be empty [Task] Add dependencies of object browser to Forms add-on [Task] Split hostaddress category into virtual IPv4 and IPv6 categories for Forms add-on [Task] Take default template values in consideration in Forms [Task] Update attribute name in pre-defined field in Forms add-on [Task] Disable child attribute until a value for parent is assigned [Task] Implement Pagination in Attribute Type Object Browser Single- and Multi-Selection |
| 1.0.0 | 2022-02-21 | Initial release |