Forms#
With this add-on you can create forms that you can send to other employees to fill in. This add-on can create a form that, for example, helps new employees document computers in your company.
When entering new objects, it is often the case that several categories are displayed, but only individual fields from each category need to be maintained. In this case it is easier for the user (especially if they are new colleagues) if only the attributes that actually need to be filled in are displayed.
We have also a Blog article with a lot of Information.
Requirements#
The Forms add-on requires:
- i-doit Version >=23
- MongoDB Server Version >=5
- NodeJS Version >=16.x
Also the system requirements of MongoDB must be observed. Also, MongoDB has a checklist for use in operations.
NodeJS has its dependencies documented here.
Installation#
The following steps are necessary to use the add-on:
- Installing the Forms add-on via the Admin-Center
- MongoDB Server v8 installation
- then NodeJS v22 via nvm Package Manager installed
- the Form backend configured
- and i-doit configured
Continue to the installation of the Forms add-on
Assignment of rights#
In order for users to be able to create forms, it is necessary to assign appropriate rights. This is possible in the i-doit administration under Authorization System > Rights > Forms, if the add-on is installed.
Clear cache for the rights system
After the rights have been assigned or changed, it is necessary to clear the cache in the i-doit administration at Administration → [Tenant-Name] Management → Repair and clean up so that the changes are adopted by the system.
Calling the add-on#
Once all preparations have been completed, the add-on can be accessed via Add-ons → Forms. The view of the "Add-ons" menu may differ due to different rights and/or other installed add-ons.
Using Forms Add-on API#
This document contains a rudimentary description of the Forms API.
Releases#
| Version | Date | Changelog |
|---|---|---|
| 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 |