Create client entities

In Cloud, client organizations are represented by Client Entities. These entities can be categorized and organized in multiple ways, such as by forming associations between them or by assigning tags or workflow stages.

Creating client entities from a client list

Cloud enables you to add multiple client entities in a single procedure using a .csv file or a block of delimited text.

When using either method, ensure that:

  • Each row represents one client entity, and

  • Each column represents a property, such as their name, start date, and tags. To assign multiple tags, place the tags between quote marks and separate them with commas. Any tags that do not currently exist in Cloud will be created by performing the import.

  • The dates in the Client Since and Inactive Date column must be in the same format as the date format set in your personal regional settings.

In this example, an administrator wants to add two client entities:

Name, Location, Entity Number, Client Since, Fiscal Year End, Tags
Chockablock Industries, Toronto, 4829, 09/07/2012, December, "Retail, Partnership"
Superior Furniture, Toronto, 5937, 22 /08/2010, December, Retail

To import a list of entities:

  1. Ensure that you have the Entities Admin role or equivalent privileges.

  2. From the Cloud menu, select Entities.

  3. Select New | Import.

    Select Import from the New Entities menu to open the Import Entities dialog

  4. Select Import from CSV and browse to your .csv directory file, or paste your delimited list text into the text box.

  5. Choose the appropriate options, then select Next.

    The options on the first page of the Import Entities dialog

  6. Map the property that matches each column. The Name (up to 60 characters) and Entity Number (up to 10 characters) are required to complete the import. Any existing entities with the same Entity Number value will be modified.

    Map the columns of your entity list before you complete the import

  7. Select Import.

The entities are added to Cloud. Any existing entities with the same Entity Number are modified.

Creating a single client entity

If you want to create organizations individually instead, you can do so from the Entities page.

To create an entity:

  1. Ensure that you have the Entities Admin role or equivalent privileges.

  2. From the Cloud menu, select Entities.

  3. Select New and the appropriate entity type.

    When creating a new entity, first select the entity type.

  4. Choose a Country of Registration and an Organization Type. The available organization types vary based on which country of registration is selected. For more information, see Entity creation.

    The Create Entity dialog.

  5. Enter a Name and Entity Number. These fields are required.

    Note: The Entities page may not sort correctly if it contains alphanumeric codes with inconsistent lengths (e.g. 1 ABC, 23 DEF, 456 GHI). To correct this, pad each number with zeroes to ensure a consistent length (e.g. 001 ABC, 023 DEF, 456 GHI) or use numeric codes.

  6. Select Save.

The entity is added, and is displayed on the Entities page.

Tagging entities

Assigning Tags helps to categorize and identify people, files, and entities in your organization. You may want to tag entities according to their industry, organizational structure, or the type of work your organization performs for them.

To tag entities:

  1. Ensure that you have the Staff Editor role or equivalent privileges.

  2. From the Cloud menu, select Entities.

  3. Select the entity you want to edit the tags for. In the entity's menu, select Tag ().

    Select the Tag icon on an entity or file to manage its tags

  4. Choose appropriate Unassigned tags to assign them.

    The Assign Tags dialog

  5. Select Save to apply your changes.

After you've assigned tags to an entity, you can filter entities based on their tags from the Search bar.

Tags displayed in the Filter drop-down menu.

Categorizing client entities

If you have created a workflow for client entities, you can use that workflow's stages to categorize your client entities appropriately. For more information on creating workflows, see Create custom fields, tags and workflows.

You can also categorize entities using the entity status. Both workflow stages and entity statuses are informational only and have no impact on what actions a staff member can take in the entity.

Before you start, ensure you have the Entity Access role or equivalent rights to the entity.

To set an entity's workflow stage:

  1. From the Cloud menu (), select Entities and then select the entity you want to edit.

  2. Select the entity's current workflow stage and then select the workflow stage you want to assign to the entity.

    Update your client's workflow to change its type

To set an entity's status:

  1. From the Cloud menu (), select Entities and then select the entity you want to edit.

  2. Select the Edit () button.

  3. In the Edit Entity dialog, select the Profile tab.

  4. Select the appropriate status from the Status dropdown.

Moving client entities

If your firm is utilizing business units, you can move entities to organize them based on characteristics such as business type or region. Before you start, ensure you have the Entity Access role or equivalent rights in the entities.

Notes:

  • You can only store entities in one business unit at a time and should not duplicate them across multiple business units.
  • You cannot partially move associated entities; move associated entities either individually or all together.
  • You cannot move entities where association sharing is enabled. Disable association sharing before attempting the move.

To move client entities:

  1. From the Cloud menu (), select Entities.

  2. In the list of entities, select the applicable entities to move.

  3. On the entity details pane, select More Actions () | Move.

  4. In the dialog that displays, select the destination business unit from the drop-down menu. If required, ensure the option to move the entities' security settings is selected.

  5. Select Move.

The entities are flagged to move and the moving process will begin. Note that depending on the size of the entities, this process may take some time. If the entities or any of the contained engagements failed to move, an error will display in the entity details pane under Move Details. Once resolved, you can retry the move.