Two screens of Invantive Estate for Windows are neither a list, a summary nor an edit screen, but a matrix: "Role Authorisations" grants the functions of the application to the roles, and "User Roles" grants the roles to the users. Both are reached from the [[Invantive Estate/Screens/Navigation Tree|navigation tree]] and both are changed in the matrix itself rather than in an edit screen. The rows and the columns follow from the repository: every function against every role, and every user against every role. A cell holds what that combination grants, shown as a coloured pill with a letter on it. ## Reading a Cell The "Role Authorisations" matrix distinguishes three levels: - "-" on grey: nothing is granted. - "R" on blue: reading is granted, changing is not. - "R&W" on green: reading as well as changing is granted. The "User Roles" matrix has two levels, because a role is held or it is not: - "-" on grey: the role is not granted to the user. - "Y" on green: the role is granted. A red border around a cell means that the cell differs from what the repository holds. The border disappears once "Save" in the toolbar of the matrix has written the change. ## Changing One Cell Clicking a cell moves it to the next level. Nothing grants reading, reading grants changing as well, and everything granted starts over at nothing. In the "User Roles" matrix a click grants the role or withdraws it. A user who holds no right to change the matrix sees the levels but cannot move them. "Save" is left out of the toolbar for that user; the search box beside it stays, since looking something up asks for no right. ## Changing an Area at Once Dragging the mouse across the cells selects the rectangle it passes over. The Control and Shift keys work on top of that, so a second block is added to the selection and a block is extended from the keyboard. The selected area is changed as a whole in either of two ways: - Clicking inside the area moves every cell of it to the level after the one the clicked cell was at, whatever level the other cells were at. The area stays selected, so clicking again carries the whole block on to the level after that. - The right mouse button opens a menu that names the levels, plus an entry "Next Level" which does the same as clicking inside the area. The menu of the "Role Authorisations" matrix offers "No Rights", "Read" and "Read and Write"; the menu of the "User Roles" matrix offers "Not Granted" and "Granted". Choosing a level sets the whole area to that level, wherever its cells started. The menu acts on the selected area when it is opened on a cell inside that area, and on the single cell it is opened on otherwise. Nothing reaches the repository until "Save". Available from release 27.0. ## Finding a Row or a Column Both matrices run to hundreds of rows and dozens of columns, more than fits on a screen. The box beside "Save" narrows the matrix to the part whose name contains the text typed in it, in upper or lower case alike, and the matrix follows along as the text is changed. Pressing Escape empties the box and brings the whole matrix back, as does deleting the text. The text is looked for in both directions at once, so there is no need to say which one is meant: - Where it names one or more columns and no row, those columns are left and every row stays. Typing the name of a role therefore leaves the column of that role against all functions or all users. - Where it names one or more rows and no column, those rows are left and every column stays. Typing a function code therefore leaves the row of that function against all roles. - Where it names both, the matrix is narrowed in both directions and only the cells where the two meet are left. - Where it names nothing at all, no row is left, which is how the matrix says the text was not found. The columns which name the rows - the icon and the name of the function or of the user - are always left in place. A level changed in a part which is no longer shown keeps its new value. "Save" writes the whole matrix, so those changes are written along with the ones in view, and the red border is there again once the part is brought back. Available from release 27.0. ## See Also - [[Invantive Estate/Screens/Navigation Tree|Navigation Tree]] - [[Invantive Estate/Screens/Screens|Screens]]