Skip to content

Floorplan

You can find practical examples on our Blog.

With the add-on Floorplan, you assign graphical plans to location objects, add a scale to them, and position the spatially assigned objects within them.

Floorplan

The add-on is installed via the Admin Center. Afterwards, it can be accessed under Add-ons → Floorplan.

Installed

Assigning rights#

Under Administration → Permissions → Floorplan, permissions for persons and person groups can be adjusted.

Assigning rights

Creating a floorplan#

Creating a floorplan

To create a floorplan:

  1. In the location view, click the Plus icon next to the desired location object and save the floorplan.
  2. Click Edit to modify the plan.
  3. Via Change background, you place a graphic (e.g., a floor layout) in the background. Alternatively, you can create a layout directly in the Layout editor.
  4. With Set scale, you add a scale to the graphic. This way, objects are later displayed to scale according to their form factor.

Supported graphic formats: bmp, png, jpg, jpeg, gif (max. 5 MB). You can also create different layers and show or hide them.

Assigning and placing objects#

Via the location list, you display all spatially assigned objects:

Assigned objects

To place objects on the floorplan:

  1. Hover over an object in the list -- the green Plus icon appears.
  2. Click the Plus icon to place the object. Alternatively, place all assigned objects at once using the button in the room row.
  3. Click Edit to select and move already placed objects by clicking.

Customizing and shaping objects on the floorplan#

In the left area, you customize selected objects. Select an object to use the following options:

Orientation: Define the orientation (top, bottom, right, left). A triangle points in the chosen direction.

Change position Select and create object shape: The shape of the object can be customized freely. Custom shapes can be saved.

CenterCenter on object: The selected object is centered in the middle of the screen.

Rotate Rotate object: The object can be rotated freely.

Unposition object Remove positioning: The object disappears from the floorplan but can be added again via the object list.

radius Define object radius: Opens a popup to color the radius, display it transparently, and configure it in different units of measurement.

icon Apply form factor: Adopts the data from the category Form factor and scales the object to scale.

icon Filter object types: Show or hide specific object types in the floorplan.

icon Open object: Opens the selected object in a new browser tab.

In edit mode, a selected object is highlighted by a blinking outline. Additionally, options for changing the shape, free rotation, and rotating the label are available.

edit Floorplan

Managing Objects Using Layers#

Organizing objects into different layers can help make the floor plan easier to read. By placing objects on different layers, you can group them and display them either below or above one another.

To open the menu for editing layers, first click the Layers button.

Layerbutton

The Layers menu displays the objects currently placed in the floorplan. You can create a new layer using the New Layer button, and move objects to that layer by dragging and dropping them via the small grid dots.

An object positioned above another object in the Layers menu will also be displayed above the object below it in the floorplan. The same applies to individual layers and the objects beneath them.

Layeroder

There are three visual states for objects within a room plan. You can change these states using the eye icon in the Layers menu. Clicking the eye icon makes the object more transparent, clicking it again hides the object completely.

Visability

Layers can be renamed by hovering over the current layer and using the Edit button, or you can remove the layer using the Delete button.

Merging floorplans#

You can nest floorplans within each other -- e.g., a floor containing multiple rooms. The following rules apply: A maximum of three levels of layouts are displayed.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
Base floorplan:
-   obj A
-   obj B
-   Floorplan A:
    -   obj C
    -   obj D
-   Floorplan B:
    -   obj E
    -   obj F
    -   Floorplan C (displayed as empty block without its positioned objects)
        -   obj G
        -   obj H

In the "Base" floorplan, you see the nested "Floorplan A", and within it "Floorplan B" (including "obj E" and "obj F"). "Floorplan C", however, is only displayed as a simple object -- nesting is liwithed to three levels to avoid recursion and performance issues.

How it works#

In the "Base" floorplan, you move "Floorplan A" and "Floorplan B" like other objects -- however, you cannot edit the content of the nested floorplans here.

When can a nested floorplan be displayed?#

For "Floorplan A" to appear as a floorplan within the "Base" floorplan, it must meet one of the following conditions:

  • have a background image
  • have a layout

If a condition is met, the floorplan icon appears when editing: icon

The floorplan is scaled to the previous object size. The layout or background image determines the scale.

Floorplan profiles#

Profile

With profiles, you control which objects and attributes are displayed in the floorplan. A default profile is included.

Profile

To create a new profile:

  1. Click Create new profile (or duplicate an existing one).
  2. Enter a name.
  3. Specify whether Clicking on object opens object view and Double-clicking on object opens it in a new tab should be enabled.

Visualization options#

Visualization options

Highlight color: Here you select a color by clicking that outlines the object when it is clicked.

Display object radius: Here you specify whether the object radius is displayed by default.

Default values#

Filter

Object information#

Attributes

This object information is displayed in the object view under Object information.

Object information

Settings#

Under Settings, you can define the profile as default globally or for specific users.

Settings

Export#

Floorplans can be exported as SVG or PNG files via the Export button.

Releases#

Version Date Changelog
1.10 2025-09-09 [Task] PHP 8.4 compatibility
1.9 2025-02-26 [Task] Make symfony 6.4 compatible
[Task] Make Smarty 5 compatible
[Bug] Main content is not wrapped correctly when resizing the window
[Bug] Adding a layer before saving causes database error
1.8 2024-02-27 [Task] Compatibility to i-doit 29, Colorpicker and PHP 8.2
1.7 2023-11-07 [Bug] MySQL8 causes database error "incorrect DATETIME" when opening Floorplan
[Bug] When turning an object, the text should also turn
[Bug] Language constant 'LC__CMDB__CATG__ACCOUNTING_ORDER_DATE' is not replaced
[Bug] Highlight 'add-on' instead of 'extras' menu
1.6 2022-09-05 [Task] PHP 8.0 Compatibility
[Task] Design Compatibility
1.5.1 2022-02-22 [Bug] Floorplan cannot be opened
1.5 [Improvement] It is possible to display a floorplan in a floorplan
[Improvement] It is possible to remove a layout from the floorplan
[Improvement] It is possible to remove the background from the floorplan
[Improvement] Show the object name of the current floorplan in the breadcrumb
[Bug] Function to inherit form factor data scales dimensions wrong
1.4.4 [Bug] Customizable header size
[Bug] Option to start chapter on new page is ignored
[Bug] When saving the contents of a subchapter, new subchapters are always created
[Bug] External Object function does not work in the Documents Add on
[Bug] Permissions for the document add-on are incorrect (Save Template)
[Bug] Creating documents always shows warning, empty templates exist
[Bug] Output of the primary contact is not possible
[Bug] Main object can no longer be edited in the Documents add-on when the grid is disabled
[Bug] Nach dem Speichern einer Dokumentvorlage werden die Einstellungen auf der Registerkarte Optionen falsch angezeigt
[Bug] Chapters from other document templates are not referenced correctly
1.4.3 [Improvement] Compatibility with i-doit 1.16
1.4.2 [Bug] Permissions for the document add-on are incorrect (Save Template)
[Bug] Authorizations for the document add-on are incorrect (Templates Visible)
[Bug] Headers are only displayed on the first page
[Bug] Attributes of SIM cards assigned to mobile phones cannot be displayed
[Bug] The output of a yes/no field with nothing selected "-" is not correct
[Bug] New revision of a document cannot be created if the list has been filtered
1.4.1 [Improvement] Create a document for multiple objects
[Improvement] Make floor plan available in the documents add-on
[Bug] Corrupted display of tables in PDF format
[Bug] The location path is displayed unsightly
[Bug] Selected attributes of master object are deleted when reopened
1.4 [Improvement] The size of the headings cannot be adjusted.
[Improvement] Images cannot be displayed over the entire header line
[Improvement] Remove requirement for PHPs "bcmath" extension
[Improvement] IF Queries in User-Defined Categories
[Bug] Placeholder represents only sub-request with one recursion depth
[Bug] Output of the primary contact is not possible
[Bug] Doku: Assigned objects from emergency plan delivers only first object
[Bug] Archived contacts of the category "contact assignment" are output
[Bug] Document templates cannot be sorted by creation date/change date
[Bug] PDF documents do not display the formatting correctly
[Bug] Image in footer is displayed in different sizes
[Bug] Tables were not properly truncated when this goes over two pages
[Bug] lines are unnecessarily high/wide in HTML documents
1.3.3 [Bug] Category "e-mail" description field no output in a table
[Bug] Placeholder for creation date/revision date also contains time of creation
[Bug] Export of enumerated fields from the wysiwyg editor is not possible
1.3.2 [Bug] Bad behavior with add-on license
1.3.1 [Bug] Empty table columns can trigger PHP warnings during revision creation
[Bug] Fix permission to import template from repository
1.3 [Improvement] Delete a room plan
[Improvement] Layers and transparency
[Improvement] Floorplan can now be deleted
[Improvement] Improve export options
[Improvement] Provide floorplan screenshots (e.g. documents add-on)
[Bug] The field label of the date field of self created categories is not displayed correctly
1.2.3 [Bug] Room plan can not be used with only "see" right
1.2.2 2019-07-05 [Bug] Buttons in navigation tree are not clickable
[Bug] Clicking a non-positioned object inside the navigation tree triggers a JS error
[Bug] Edit and save on the "splash screen" causes a SQL error
1.2.1 2019-05-20 [Bug] Creating a new room is not possible
[Bug] Defined i-doit address (URL) is ignored and the host name is used instead
[Bug] Profiles are not saved with references
[Bug] Cannot save profiles[Bug] Long object titles don't look good in the location tree
1.2 2018-12-05 [Improvement] Rotate objects freely instead of 90° steps
[Improvement] Export the floorplan as PNG
[Improvement] New function to open a selected object
[Improvement] GUI Update: display location tree
[Improvement] Rotate objects 45 instead of 90 degrees
[Improvement] A object-polygon can consist of 20 instead of 10 points
[Improvement] Make the polygon-editor more intuitive
[Improvement] Implement view and edit mode
[Improvement] Improve editing and positioning of objects
[Improvement] Objects can display an own radius
[Improvement] Splash screen with the five last updated/created floorplan
[Improvement] Make floorplan category more dynamic
[Improvement] Navigation tree displays positioned objects
[Improvement] New profiles analog to the CMDB-Explorer
[Improvement] Clicked objects should be displayed more prominently
[Bug] Update floorplan category with useful functions
[Bug] Font color is too dark for some object type colors
[Change] Replace object browser with location tree
1.1 2018-04-16 [Improvement] The scale will now be displayed dynamically
[Improvement] Smoother zoom
[Bug] Background image won't be displayed after uploading
[Bug] Misspelling of form factor in the English version of the floorplan
1.0.5 2017-10-02 [Bug] Object list won't be displayed properly
[Bug] Background image won't be displayed after moving the installation
[Bug] Floorplan shows objects with non-"normal" status
1.0.4 2017-05-02 [Bug] Self added icons do not scale in the floorplan extension
[Bug] Scale is not set, "form factor data" button is disabled
1.0.3 2016-10-24 [Improvement] Failure while uploading a background image
1.0.2 [Change] Compatibility with i-doit 1.8
[Bug] Object link is malformed when Wiki-URL is configured
[Bug] Read right is enough to make changes in Floorplan
1.0.1 2016-03-23 Initial release