i4connected Knowledgebase 5.6

Organizational Units Management

Abstract

Check out this article for an insight in the Organizational Units management functionalities and how to use them in your i4connected project.

This article describes the Organizational Units Management functionality from the Admin section of the i4connected portal. The Organizational Unit structure, is completely detached from the geographical structure and it can be built over different sites. An Organizational Units structure can contain any number of units and layers.

The list of Organizational Units can be accessed through the dedicated tile. The list of Organizational Units will only be visible for users having at least the View Organizational units permission enabled. Additionally, only the Organizational Units to which the currently logged in user is assigned will be visible in the list.

Org_Units_list.jpg

The Organizational Units panel

The Organizational Units are positioned in the panel's central area, as cards in a scrollable list. Each Organizational Unit card displays the following details:

  • The Organizational Unit name.

  • A numeric label, representing the number Sub-Organizational Units, assigned to the current entity.

Further on, this panel provides a filtering mechanism that helps the user to pinpoint the desired Organizational Units, by searching for the entity name.

Filter_OU.jpg

The Filtering option

By clicking the Reset filter button Reset_filter.jpg all the contents in the search field are removed and the filter is no longer applied.

The Refresh button from the top menu provides a manual way to reload/update this list.

Refresh_OU.jpg

The Refresh button

In the Organizational Units panel, the user can select a listed item in order to view its substructure Area_children.jpg or to view its details Area_details.jpg.

By selecting an Organizational Unit from the list view the detailed view mode panel is opened. In this view all the relevant Organizational Unit's information are displayed (Organizational Unit's Name and Alias).

Org_Unit_detailed_view.jpg

The Organizational Unit detailed view mode

A set of management tiles will also be displayed, depending on the level of the permissions that the currently logged in user has. Hence, the following management tiles can be available:

  • Manage Organizational Unit's Users - The Users tile will be visible for all users having at least the View Organizational Units and View users permissions enabled.

    The Users tile displays the amount of users assigned to the current Organizational Unit. Users can be assigned to an Organizational Units by means of direct assignment or by inheritance. By clicking on the Users tile, the Organizational Unit role assignments panel is opened, where further changes at level of users and their permissions can be processed.

    Tip

    For more details about the Sites role assignments panel please also visit the article here.

  • Manage Organizational Unit's Devices - the Devices tile will be visible for all users having at least the View Organizational Units permission enabled.

    The Devices tile displays the total amount of Devices assigned to the current Organizational Unit. However, the amount of displayed devices is highly related to the user's permissions set, as follows:

    • the View Organizational Units permission, enabled on hierarchical level, shows the Devices tile as empty;

    • the View all Organizational Units permission, enabled on global level, shows the Devices tile but only displays the devices that are assigned ONLY to Organizational Units;

    • the View Organizational Units / View all Organizational Units along with the View Sites and Areas / View all Sites and Areas, shows the Devices tile and displays all the Devices assigned to Sites, Areas and Organizational Units.

    By clicking the Devices tile, the Device List panel is opened.

    Tip

    For more details about Device List panel please also visit the article here.

  • Manage Organizational Unit's Measure aggregations - the Measure aggregations tile will be visible for all users having at least the View Organizational Units and Manage configurations permissions enabled.

    The Measure aggregations tile displays the total amount of Measure aggregations used by the current Organizational Unit. By clicking the Measure aggregations tile, the panel with the same name is opened.

    Tip

    For more details about Measure aggregations panel please also visit the article here.

  • Manage Organizational Unit's Sub-Organizational Units - the Sub-Organizational Units tile will be visible for all users having at least the View Organizational Units permission enabled.

    The Sub-Organizational Units tile displays the total amount of Organizational Units assigned to the current Organizational Unit. By clicking this tile, the list of Sub-Organizational Units is opened.

  • Manage Organizational Unit's Mappings - the Mappings tile will be visible for all users having at least the View Organizational Units and Manage configurations permissions enabled.

    The Mappings tile displays the total amount of Mappings of the current Organizational Units. By clicking this tile, the Measures import mappings panel is opened.

    Tip

    For more details about the Measures import mapping tool please also visit the article here.

  • Manage Organizational Unit's Measure Actions - the Measure actions tile will be visible for all users having at least the View Organizational Units and View measure actions permissions enabled.

    The Measure Action Management tile displays the number of measure actions associated to this Organizational Unit. The tile opens the Measure action list panel allowing user to view, edit and add measure actions.

    Measure_actions_list.jpg

    The Organizational Unit's Measure actions list

    Tip

    For a better understanding concerning Measure Actions please also visit the article here.

  • Manage Organizational Unit's KPI Cross-links - the KPI Cross-links tile will be visible for all users having at least the View Organizational Units and Manage configurations permissions enabled.

    The KPI Cross-links tile displays the number of cross-links created for this Organizational Unit. The tile opens the KPI Cross-links panel, allowing the user to view, edit and delete the existing cross-links and also add new ones.

    KPI_Cross_links.jpg

    The KPI Cross-links panel

  • Manage Organizational Unit's Shifts - the Shifts tile will be visible for all users having at least the View Organizational Units and Manage configurations permissions enabled.

    The Shifts tile displays the number of shifts defined for the respective Organizational Unit. Selecting this tile opens the OrgUnit shift list panel.

    Tip

    For more details regarding Shifts management please also visit the article here.

Besides the general Organizational Unit's information and the management tiles, the Organizational Unit details panel may also display an associated i4designer Application.

OrgUnit_Application.jpg

Example of Organizational Unit's application

Tip

For more details about the i4designer Application mapping feature please also refer to the dedicated articles here.

Additionally, to learn how to manage an Organizational Unit's Application mappings please also visit this article.

Organizational Units management options

Adding a new Organizational Unit

The Add button from the toolbar of the Organizational Units panel provides access to the Add organizational unit panel, to users having the Manage Organizational Units permission enabled.

Add_button.jpg

The Add Organizational Unit panel

To add a new Organizational Unit, the user must fill in at least the mandatory details (marked with a asterisk), as follows:

Add_Org_panel.jpg

The Add Organizational Unit panel

  • Name* - the name of the Organizational Unit.

  • Alias - the alias (friendly name) of the Organizational Unit.

  • Organizational Unit subpage - the dedicated portal page which can provide access to all portal modules and tools, directly configured for this Organizational Unit. Clicking on the selection field, the Page List panel is opened allowing the user to select the page.

  • Roles - the role(s) defined for the new Organizational Unit. Role(s) can be selected in a dedicated panel, from a list of roles available for the currently logged in user.

  • Photo - the photo will represent the current Organizational Unit in thumbnails and tiles. The user can Browse for an image file or Clear the existing one.

The validation system will notify the user if the provided information is not sufficient for creating the new Organizational Unit.

Capture202.jpg

Example of validation error

The bottom section of the Add Organizational Unit panel provides the options of saving the new Organizational Unit and closing the panel. Upon saving, the new Organizational Unit will be automatically displayed in the Organizational Units panel's list.

Editing an Organizational Unit

While in the detailed view mode of an Organizational Unit the user can decide to update the general information of it, by clicking the Edit toolbar button. The Edit Organizational Unit panel allows the following edit options:

Edit_Org_Unit.jpg

The Edit Organizational Unit panel

  • Name

  • Alias

  • Organizational Unit subpage

  • Photo

Deleting an Organizational Unit

The Organizational Unit detailed view mode provides the user with the possibility to remove the Organizational Unit by clicking the Delete toolbar button.

Delete_OU_button.jpg

The Delete button

In the Delete Organizational Unit panel the user is provided with information about the impact of the deletion over the whole system.

Warning

When deleting an Organizational Unit all it's assigned Devices, Signals, Measurements and Event occurrences will be deleted as well.

To acknowledge the consequences and proceed with the deletion, the user has to type in the designated field, the displayed confirmation code. To proceed with the deletion, the user can press the Delete button, located at the bottom of the panel. Deletion is immediately visible, in the Organizational Units panel.

Delete_org_unit.jpg

The Delete Organizational Unit panel

Managing Application Mappings

The Manage Application button displayed in the Organizational Unit's details panel allows users, having the Manage Organizational Units permission enabled, to add and update an Organizational Unit's i4designer Application mapping.

Manage_App_button.jpg

The Manage application button

Tip

For more details about the i4designer Application mapping feature please also refer to the dedicated articles here.

The Manage Application Mappings panel of an Organizational Unit features the following properties:

Manage_Application_Mappings.jpg

The Manage Application Mappings panel

  • Default Application - the application added in this section will be displayed in the Organizational Unit's details panel.

    • Default Application - the Application mapping used by the current Organizational Unit, that will be displayed in the Organizational Unit's details panel.

      Default_OrgUnit_Aplication.jpg

      The list of Application mappings

      Warning

      Please note that the Application mappings list will be available when accessed from the Manage Application Mappings only for users having at least the View applications permission enabled. The list will display only Applications owned by or assigned to the logged in user.

    • Subpage path - an optional sub-page of the i4designer project. The sub-page path is given by the project's sub-page exact name.

      Note

      By setting a sub-page path the page will be by default displayed by the Organizational Unit application. If the field is left empty, the project's default page will be displayed.

    • Title - the title displayed by the panel, when opening the Application in view or preview mode. If no title is filled in this field, the Application panel will display the name of the Application mapping.

    • Subtitle - the sub-title displayed by the panel, when opening the Application in view or preview mode. If no sub-title is filled in the field, the Application panel will display no sub-title.

    • Panel size - the size of the panel, when opening the Application in view or preview mode. By default, the panel size is set to lg (large) but the user can decide to apply the following sizes: sm (small), md (medium), lg (large), xlg (extra large), xxlg (extra extra large), 3xlg (3 times extra large), 6xlg (6 times extra-large).

      Panel_size.jpg

      The Panel size selector

    • Navigation parameters - an optional set of parameters based on key-value mappings.

      Navigation parameters can be added by clicking the Add parameter button Add_parameter.jpg. The user needs to manually input the Parameter Name and Value. Inserted parameters can be removed by clicking the Delete button Remove_parameter.jpg.

      Navigation_parameters.jpg

      The Navigation parameters

While configuring the Organizational Unit Default Application, the user can check the Application's display in preview mode. By clicking the bottom Preview button a separate panel is opened displaying the drill-down Application as it will be displayed in view mode.

Preview_mode.jpg

Example of Application opened in preview mode

While in preview mode, the user can asses the Application before saving and applying the settings.

Further on, the URL of the Application is displayed at the top of the preview panel allowing the user to copy it to the clipboard. The copied URL can be afterwards used to pin tiles to i4connected pages.

Copy_to_clipboard.jpg

The Copy URL to clipboard option

Tip

For more details about the Pin tiles option, please also visit the dedicated article.

Importing Ewon configuration

The toolbar of the Organizational Unit's details panel allows users having the Manage Organizational Units and Manage configuration permissions enabled, to Import Ewon configuration.

Org_Unit_import_ewon_button.jpg

The Import Ewon configuration button

The Import Ewon configuration panel features the following parameters:

Org_Unit_import_panel.jpg

The Import Ewon configuration panel

  • Site - the Site where the devices will be assigned. This field is optional.

  • Area - the Area where the devices will be assigned. This field is optional.

  • Organizational Unit - the Organizational Unit where the devices will be assigned. This field is by default filled in with the currently opened Organizational Unit.

  • Adapter - the Adapter where the devices will be chosen from.

  • Time zone - the time zone that will be assigned to the devices. After the import, the time zone setting can be modified in the Device configuration panel.

  • Add Ewon Devices button - when clicked, the list of Ewon devices available for import, is opened.

    Select_ewon_dev_for_Org_unit.jpg

    The Select ewon device panel

By clicking the Import button the selected Devices and all their tags (signals) will be configured for the given Organizational Unit and the server will be notified that it can start collecting data.