All Collections
ESSENSYS PLATFORM
Occupier management
essensys Platform - Occupier management - Delete users in bulk
essensys Platform - Occupier management - Delete users in bulk

How do I delete a group of selected users in bulk? | Occupier user | Delete |

Stuart avatar
Written by Stuart
Updated over a week ago

You can delete a number of users that are associated with a single occupier in one bulk action. This might be useful when a group of users leave the company, for example.

When you bulk delete occupier users:

  • The selected users are deleted from the system. No historical record of their details is retained.

  • If the deleted users previously had assigned phone numbers, that assignment is removed. The phone numbers return to the reserved state (allocated to the occupier) and can be assigned to other users with the same occupier or deallocated entirely.

  • If the deleted users had Wi-Fi access, the Wi-Fi account is deleted and the users can no longer sign in to the Wi-Fi Secure network using their user name and password.

  • If the deleted users had user access to a white-labeled mobile app or portal, the user account is deleted and they can no longer sign in to the mobile app or portal.

You cannot bulk delete users:

  • Where there is an action currently in progress against a user. For example, a request to assign a phone number to a particular user is underway but not complete. Any users in this state are not included the Edit or delete users dialog box for selection.

  • Where the occupier is being, or has been, decommissioned. You cannot open the Edit or delete users dialog box for an occupier that is in any of the states: Decommissioned, Decommission pending, or Decommission failed. For more details, see Decommission states.

Delete occupier users in bulk

Accessing the occupier users page

  1. In the main menu on the left, select Occupiers.

  2. In the Occupier list, select the correct occupier.

  3. Click the Users tab.
    The Users list opens, with the top user in the list (if there is one) selected.

Tip: You can filter the list of occupiers, or the list of users, by typing text into the search text fields. The list is filtered as you type.

Deleting the occupier users in bulk

  1. Above the list of users for the selected occupier, click Edit or delete multiple users.

    The Edit or delete multiple users dialog box opens. For more information, see Edit or delete multiple users.

  2. Select the users that you want to delete from the list:

    • If you want to delete all users, do not set any filters and then click the Select all users check box at the top-left.

    • If you want to delete a specific subset of users:

      • Filter the list of users using the drop-down lists at the top of the dialog box. For more information, see Filter user list.

      • Click the Select all users check box to select all of the users that are currently visible in the list.

    • To select or clear the selection of individual users, click the check box alongside each user name.

  3. Once you are happy that you have selected the users you want to delete, click Delete users.

  4. From the confirmation dialog box, click Delete users.

The following outcomes are expected:

  • If all users are successfully deleted, the Done dialog box opens. Click OK.

  • If some users were successfully deleted, but some were not, the Partially done dialog box opens. Click OK and resolve the issues manually. See Complete partially done deletes.

  • If none of your users were successfully deleted, the Error message opens. Click OK and either try again or resolve the issues manually. See Repeat failed deletes.

Complete partially done deletes

If some users were not successfully deleted, they are listed in the Partially done dialog box. You can either:

  • Repeat the bulk delete process, selecting these failed users.

  • If there are only a small number of failed deletes, delete the users individually following the standard (single user) process:

    1. View the details of the first user in the Users page.
      Tip: You may be able to tell why the delete failed for this user. For example, if there is a change that is underway for this occupier or if the occupier has been decommissioned since the bulk delete was requested.

    2. If the user is in an appropriate state to be deleted, click Delete.

    3. Repeat for each of the users.

Repeat failed deletes

If the delete process failed and no users were deleted, you should repeat the bulk delete process selecting the same users again.


Edit or delete multiple users

Top row (filters and select all)

You can filter the users in the list by their Wi-Fi account and User account details.

Field

Description

Select all users

Select all of the users that are currently visible in the dialog box.

This action:

  • Selects all visible users.

  • Clears the selection, such that no users are selected.

Tip: If you select all users, every user that is visible in the dialog box is selected. Any users that have been filtered out of the view are not selected.

Filters:

  • Wi-Fi Account

  • Wi-Fi homesite

  • Concurrent device limit

  • Portal account

  • Mobile app account

The filters above each header row allow you to filter the users that are shown in this view.

For each filter:

  • Select All to not filter on the values in the named column.

  • Select a <value> from the filter to only show users with the selected value in this column.

Note: Which values are available for selection depends on the values associated with the user's Wi-Fi and user accounts.

Columns (user details)

Field

Description

Select <user>

Select the check box to the left of an individual row to:

  • Select the user represented by the row for deletion.

  • Clear the selection of this user to prevent them being deleted.

Name

The name of a user that can be deleted.

Note: Users are not included in this list if they have an action currently in progress.

Wi-Fi Account

Indicates whether the Wi-Fi account for this user is active or inactive.

Note: Wi-Fi Accounts that have been deactivated are in the inactive state.

Wi-Fi homesite

If the user has an active Wi-Fi account, this field indicates the user's Wi-Fi homesite.

Concurrent device limit

If the user has an active Wi-Fi account, this field indicates the number of private devices that this user can connect to the Wi-Fi Secure network concurrently.

Portal account

Indicates whether the user account that entitles this user to connect to the white-labeled essensys portal is active or inactive.

Mobile app account

Indicates whether the user account that entitles this user to connect to the white-labeled essensys mobile app is active or inactive.

Actions (bottom-right)

Field

Description

Cancel

Cancel your changes and close the dialog box.

Delete users

Delete all currently selected users.

Tip: This button becomes enabled when you have selected a set of users for delete.

Select all users, and move on to select the changes that you want to apply to all of those users.

Did this answer your question?