Document toolboxDocument toolbox

Multiple Item List Types

By default, there is a single item list type called "Item in room." This approach is recommended when a consistent group of users is responsible for managing all the items in dRofus. This workflow ensures that only one template can be assigned to a room, which enables users to determine the items within a room simply by observing the status.

When multiple groups are responsible for handling items in dRofus, or when the goal is to utilize templates across different room types, or when access rights need to be limited to specific item lists, employing multiple item lists becomes advantageous. For example, one can segregate furniture and medical items into separate lists, enabling them to utilize distinct templates and potentially follow different content creation workflows.

Manage Item List Types

An administrator can add or modify Item list

  1. Go to Settings

  2. Project and database administration -> Settings

  3. Items -> Item Lists.

Room Templates and Item Templates

Each item list operates independently for a room. When items are divided into separate lists, such as "Furniture" and "Medical Equipment," each list type maintains its own status for every room. This implies that Room A can possess a distinct list for furniture while utilizing a medical item list from a room template.

Although a room template includes all the item lists, when associating a room with a template, it is not mandatory to utilize the template for all lists. In fact, the room can even employ different room templates for various item list types.

If you have enabled Item list types (Home -> Settings → Project and database administration -> Settings  → Room Templates -> Settings) you get one list of Item templates per Item list type and they can therefore only be used as templates for Item lists of that type.

Item List Types and Access Rights

An Item list type can be assigned to one or more responsibility groups. If a list type is limited to one or more responsibility groups this means:

  • Only Items with any of the responsibility groups set can be added to a room. This implies to all subs Items of the Item are added to the room as well. This will prevent an Item that has been placed in an Item list from changing to an illegal responsibility group (or add violating sub-Item) later.

  • Only users with proper permissions to all the responsibility groups for the listcan do list operations on the room (e.g. create, delete and attach to template).

  • Users with read permissions to any of the responsibility groups will see the lists. In other words if you have an Item list type "Doors" limited to only responsibility group "D" – a user which has Item rights none (level 4) to group "D" will not see that the lists even exists in the database and not see status etc.

  • When adding new occurrences from model (Revit/ArchiCAD) they can automatically be placed in the correct Item list if the responsibility group is correct set. See section below.

If an Item list type is not limited to one or more article responsibility groups this means:

  • List operations on the room are available for any user that has at least limited write access to any article group, but will fail if any Item in the list is read only for the user.

  • The list (and list status etc.) are visible to any user with any Item rights *).



Note: You should be careful with limiting all your Item list types to responsibility groups. This is because you then potentially can have Item in your database that you cannot add to a room! E.g. Items without any responsibility set can only be added to Item lists types not limited to any responsibility group.

Please note that even if a user has the permission to view a certain Item list type the user may not see all Item occurrences in that list if some of those items are limited to responsibility groups the user is not in.


Reports

When using multiple Item lists the default report prints all the Item lists after each other in the order you define in the settings for the Item list type. The user can also limit it to print one or more Item lists for each room.

If you make your own custom report using XF designer the room has multiple <occurrence-list> nodes with an attribute Item_list_id. You can then decide if you would like to iterate over all occurrences or each list and then occurrences or only one specific Item list type.

Multiple Item Lists from Revit / ArchiCAD

When working in Revit or ArchiCAD and comparing counts of Item ("Item in room" and "Item in level/model") all Item lists in dRofus are combined. You can use the options filter to limit what to see. 

When adding new occurrences from Revit/ ArchiCAD to dRofus it is automatically added to the "correct" Item list using the following logic:

  • If the Item to add has a responsibility group: it will look first for an Item list type that is limited to this responsibility group and add to it.

  • If none are found or Item does not have a responsibility group – it will be added to first Item list that is not limited to any responsibility group.

For example if you have three Item list types: Doors (limited to responsibility group D), Medical Item (limited to responsibility group M) and Furniture (with no limitation). All doors and medical Item will be added to Doors and Medical Item lists, and the rest will be added as Furniture.

Incompatibility with previous versions of dRofus (< 1.6)

It is important to note that if your project uses more than one Item list, users logging into dRofus with a client older than 1.6 will not be able to use the room and Item module.