Skip to content

Asset list

The Asset list is the central navigation and management interface in IAH for viewing and managing all onboarded assets.

Each row contains the information about one asset. Use the search bar to search all asset information, custom properties, and fields shown in the details view, independent of the columns visible in the Asset list. A search can therefore match a property that is not displayed as a column or that is hidden in the List settings.

The search is case-sensitive. It does not search Asset gateway and Asset responsible. To search these values, use the filter in the corresponding column.

Click the three-dot menu on the far left of a row to access Asset details and other actions.

Navigate between pages and set the number of items displayed per page.

List settings

Open the List settings to show, hide, or reorder Asset list columns, or to add custom properties via Add custom property.

Show or hide columns

Select or deselect columns in the List settings to show or hide them. The default sorting of the columns is equivalent to a typical user workflow. After rearranging the columns, the sort order matches the new column order.

Custom property

Add additional columns to the Asset list with custom properties.

Add custom property

The custom property column is displayed in the Asset list. Add or edit the Custom property value for each asset.

  1. Click on List settings.
  2. Click on Add custom property to open the input field.
  3. Enter the name of the custom property.
  4. Click Save. The added custom property is visible in the list of columns in the Asset list settings dialog. By default, the custom property column is set to visible. Custom properties are not enforced to be unique.
  5. Click OK to close the dialog.

Edit or delete a custom property

  1. Open the List settings.
  2. Click on the three dots on the right of a custom property.
  3. Select Edit or Delete and follow the instructions.
  4. Click OK to close the dialog.

Reset to default

Reset to default resets column selection, column order, applied filters, sorting.

If a custom property was added or edited or deleted, the Reset to default option is disabled. Close and re-open the List settings to perform this action.

To reset settings for all lists (Asset list and Inbox), navigate to Reset list settings instead.

Customize the Asset list view

User settings

The following settings are saved per user and tenant and persist across sessions. If saving user settings fails after 3 retries, an error is reported as a toast message.

Setting Description
Column visibility Show or hide columns in the Asset list settings dialog
Column order Re-order columns via drag and drop
Column filtering Filter columns via the column header menu
Column sorting Sort columns by clicking the column header

Rearrange columns

Rearrange columns to any position using drag and drop.

Sort and filter the Asset list

Every column in the Asset list can be filtered. Every column in the Asset list can be sorted, except MAC address, IP address, Firmware version, Labels, Asset gateway and Asset responsible

Sort and filter a column

  1. Click the column header to sort. The column is marked with an arrow. Click it to switch between ascending and descending.

  2. Open the column header menu and select Filter to open the Filter dialog.

  3. Select a filter option from the drop-down menu.

Add additional information to an asset

Labels

Assign user-specific attributes to an asset in the Labels column.

  1. Hover over the desired row in the Labels column. The Edit symbol appears. Click it to open the Labels dialog.

  2. Insert a label or add more labels by pressing Space.

  3. Save the changes by pressing Enter or OK.

Custom property value

Assign a user-specific value to an asset in the column added as custom property.

  1. Double-click inside the custom property column in the desired row. The custom property value enters edit mode.

  2. Enter a value.

  3. Save the changes by leaving the edited cell by e.g. pressing Enter or clicking in another cell.

Access group column

Access groups structure your assets or restrict access to certain assets for certain users.

In the List settings of the Asset list, enable the Access group column to see the Access group entries for each asset.

If the Access group feature is not used, leave the Access group column entries untouched. All assets are automatically assigned to the default Access group.

If Access groups are used, only users with the user_admin role can assign users to Access groups. Rename the Access group to reassign the asset to it.

For further information, refer to Configure Access Management page.

Asset responsible column

The user onboarding an asset automatically becomes the asset responsible. It is displayed using the assigned e-mail address as a separate column.

For non-human users, the phrase Server user and the corresponding user ID are displayed.

Only users with both the user_admin and admin roles can change an asset's responsible person. To change an asset's responsible person, double-click on the asset responsible and select a different user from the list.

Note

This method only allows changing the responsible person, not removing them. To remove a responsible person completely, offboard the asset.

Asset details

View comprehensive information about the selected asset in the Asset details pane.

  1. Click the three dots on the far left of a row and click View details.

  2. Click the three dots of a different asset to switch to that asset's details and close the current one.


    Figure: Asset details of the selected asset

Leading view

Most assets can be discovered by multiple Asset Links. The views in the Asset list and in the asset details represent the results of the first Asset link that discovered this specific asset.

To switch to a different leading view for an asset:

  1. Click the three dots on the far left of a row and click View details.

  2. Click the drop-down menu of the Leading view and select the Asset Link that provides the desired view. The Asset details are refreshed automatically. Manually refresh the Asset list.

Remote connection

Establish a remote connection to an asset to view and manage it via its web or SSH server. For web-based connections, IAH supports interactive communication over HTTP or HTTPS, including WebSocket-based traffic.

Supported mechanisms:

  • HTTP/HTTPS web applications
  • WebSocket-based applications, including Socket.IO over HTTP/HTTPS
  • RPC-style communication exposed by the asset web service over HTTP/HTTPS
  • Terminal sessions through ttyd over HTTP/HTTPS
  • SSH support

Preconditions:

  • admin or supervisor role
  • Member of the Access group of the remote connection's asset
  • Device has a valid IP address and is associated with a gateway ID

For further information, refer to the Configure Access Management page.

Establish a remote connection

Establish a remote connection to an asset:

  1. Click the three dots on the far left of the row.
  2. Click Establish remote connection.
  3. Select the Connection Type in the drop-down. The default port for the selected type appears in the input field. If necessary, change it according to your configuration.
  4. Click Connect to initiate the remote connection.
  5. After initiating the remote connection, click Remote connections to access the connected asset web/ssh server or to disconnect the remote connection.

Check the status of remote connections on the Jobs page.

Note

  • For the remote connection to be usable, the asset must expose its web server via http or https on a specific port. For ssh server, the asset must expose its specific port.
  • Establish remote connection button will be disabled for the assets that do not have any Asset Gateway associated with them.

Remote connections

Open the web/ssh server of an established remote connection or disconnect a session.

  1. Click the Remote connections button on the upper right corner. A dialog lists all initiated and established remote connections.

  2. Once the connection is established, the Open link to the session appears in the dialog. The session is valid for a maximum of 12 hours after which it is automatically terminated.

  3. Click Open to access the web/ssh server of the connected asset. The web server page or SSH terminal opens in a new tab.

  4. Click Disconnect to disconnect an active remote connection.

Note

  • If a remote connection remains inactive for 1 hour, credentials expire and a 404 error is shown. To reestablish the session, open the remote connection URL from the list of remote connections.
  • Accessing multiple remote connection web/ssh servers within a single browser is supported.
  • The remote connection web server supports a maximum file size of 150 MB for downloading or uploading files.

Remote connections with Access groups

  • All users within the same tenant can view all remote connections for that tenant, but only users who have access to the asset's Access group can perform operations on those connections.
  • If the Access group of an asset with an active remote connection is changed, only users in the new Access group can perform operations on that connection.

Actions in the Asset list

Select assets to perform the following actions: Offboard, Delete, and Add.

Action 'Offboard'

Offboard discovered and manually added assets. Offboarding moves the selected assets to the Inbox.

  1. Select the assets you want to offboard using the checkboxes.
  2. Click Offboard.
  3. A confirmation dialog appears.
  4. Optionally, expand the section to view the selected assets.
  5. Click OK to offboard the assets.

Action 'Delete'

Select assets and click Delete to remove them. The selected assets are shown in the confirm dialog. No changes are applied to the physical edge assets in the factory.

Action 'Export'

Export the Asset list as an Excel or CSV file.

  1. Click Export.
  2. Enter or confirm the file name.
  3. Select the format: Excel (.xlsx) or CSV (.csv).
  4. Click Export to initiate the download. The export applies the same filters and sorting as currently displayed.

Action 'Import'

File import: Import assets via an Excel file.

  1. Click Import and select File import.
  2. Follow the description from the dialog.
  3. Click Import.

For more information, see the Excel Import page.

Manual entry: Add assets manually that could not be discovered via the Inbox scan.

  1. Click Import and select Manual entry.
  2. Fill out the mandatory fields.
  3. For Access groups, if the feature is not used, leave the input field blank. The asset is automatically assigned to the default Access group. Enter an Access group to use the feature. If a new Access group name is entered, the asset will disappear until the user is assigned to the new Access group by the administrator and user should have the role as access_group_admin.
  4. Click Add to save the new asset and close the dialog. Duplicate MAC addresses are not allowed; a duplication check based on MAC address is performed for these assets.

UI keyboard navigation

Key combination Function
Arrow up/ Arrow down Navigate between assets within the Asset list.
Return Perform a left mouse click.
Tab Navigate between controls and/or cells in a predefined order.
Tab + Shift Navigate between controls and/or cells in reverse order.
Escape Close any open dialog. When editing data, cancel editing and discard any changes made.
Space Check or uncheck a checkbox.

Any questions left?

Ask the community