Forms#
Mit dem Forms Add-on erstellst du Formulare und versendest sie per Link an Mitarbeiter zum Ausfüllen. Neue Kollegen dokumentieren so z. B. Computer im Unternehmen, ohne die gesamte i-doit-Oberfläche kennen zu müssen.
Der Vorteil: Statt aller Kategorien mit sämtlichen Feldern zeigst du nur die Attribute, die tatsächlich ausgefüllt werden müssen.
Mehr dazu findest du in unserem Blog und im Video.
Das Forms Add-on wird aktuell in Englisch bereitgestellt. Übersetzungen die von i-doit stammen werden auch in Deutsch übersetzt.
Anforderungen#
Das Forms Add-on benötigt:
- i-doit Version >= v23
- MongoDB Server Version >=8
- NodeJS Version >= v22.x
Es müssen die Systemvoraussetzungen von MongoDB beachtet werden. Außerdem hat MongoDB eine Checkliste für den Einsatz im Betrieb.
NodeJS hat seine Abhängigkeiten hier Dokumentiert.
Installation#
So installierst du das Add-on:
- Installiere das Forms Add-on über das Admin-Center.
- Installiere MongoDB Server v8.
- Installiere NodeJS v22 via nvm Package Manager.
- Konfiguriere das Forms Backend.
- Konfiguriere i-doit.
Weiter zur Installation des Forms Add-on
Rechtevergabe#
Damit Benutzer Formulare erstellen können, vergib die entsprechenden Rechte unter Verwaltung → Rechtesystem → Rechtevergabe → Forms.
Cache für das Rechtesystem leeren
Nachdem du die Rechte vergeben oder geändert hast, leere in der i-doit Verwaltung unter Verwaltung > [Mandanten-Name] Verwaltung > Systemreparatur und Berechtigungen den Cache, damit die Änderungen vom System übernommen werden.
Aufruf des Add-ons#
Nach Abschluss aller Vorbereitungen erreichst du das Add-on unter Add-ons → Forms.
Verwendung der API#
Dieses Dokument enthält eine rudimentäre Beschreibung der 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 |