The default behavior is to have one item list type "Item in room". This is the recommended way if the same group of user are responsible for working with all the items in dRofus. This workflow allows to enforce that only one template can be assigned to a room, this is so you "know" what items a room has only by looking at the status.
But if more than one group is working with Items in dRofus and/or you would like to use templates that span different types of rooms and/or you would like to limit access rights to different Item lists using multiple item lists allows for this. One example might be that furniture and medical items could be placed in different lists so that they can utilize different templates and perhaps have different workflows for creating the content.
Manage Item List Types
You can modify what items lists to use as an administrator from within dRofus: Home -> Settings → Project and database administration -> Settings → Items -> Item Lists.
When you create more than one Item list type in the project they all work as independent lists for the room. If you e.g. create Item list types Furniture and Medical Equipment, each room will have independent status for each list type. So room A can have a unique list for Funiture, but have a Medical Item list from a room template.
Room Templates and Item Templates
A room template will always have all the Item lists defined, but when you relate a room to a room template you don't have to use the template for all lists and can even let the room use different room templates for the different 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.
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.