Share this page

# Custom entities

Custom Entities are a new set of entities that users can define and use for their specific purposes within the system. These entities are not restricted by predefined names, offering flexibility in how data is structured and managed.

In this topic:

## Overview

A shared space admin can create entities tailored to the organization's needs, such as for managing customers or cars. Custom entities are shared across workspaces within a shared space.

Example: A defect may have a Customer field to indicate which customer reported the defect. Typically, the names you can choose from are values in a List item. With custom entities, you can create an entity called Customers that has its own fields (such as License type, Agent, Industry), and business rules.

Custom entities are not available in isolated spaces.

## Add custom entities

The activation process for custom entities is done using a space parameter. After activating the entities, you need to set their display labels and allow access to them by selected roles.

To activate custom entities:

1. Open the global menu and select Administration > General Settings.

2. In the spaces sidebar, select a shared space node .

3. Select the Parameters tab.

4. Search for the NUMBER_OF_ACTIVATED_CUSTOM_ENTITIES parameter.

5. Set the value according to the number of custom entities you want to add. The maximum value is 15.

6. Click the Save button and refresh.

New entities are added to the space with temporary names: Entity A, Entity B, according to the number of entities that you activated.

System fields: The new entities are created with system fields for basic item management: Author, Creation time, Description, Has attachments, ID, Last modified, Name, Rank, Shared. The system fields cannot be deleted.

To assign display labels for the new entities:

1. Open the global menu and select Administration > General Settings.

2. Select a shared space .

3. Select the Entity Labels tab. New entities are added: Entity A, Entity B, according to the number of entities you activated.

4. For each new entity, define the editable display labels. For details, see Labels.

Note: You cannot change the custom entity's internal name. The internal name is used in APIs and remains the same even if the display labels are changed.

## Set custom entity permissions

Setting permissions for custom entities involves configuring CRUD permissions and allowing access to custom entities in the My Views module.

To set custom entity permissions:

1. Open the global menu and select Administration > General Settings.

2. In the spaces sidebar, select a shared space with custom entities.

3. Select the Permissions tab.

4. In the categories panel, select the Custom Entities category.

5. Select a role and assign permissions for the entities. Click Save.

   Repeat for other roles.

6. In the categories panel, select the Module Visibility category.

7. Select a role.

8. Under My Views, select the new entities. Click Save.

   Repeat for other roles.

For details, see Roles and permissions.

## Customize custom entities

You can customize the custom entities, the same as system entities. Customization options include: Business rules, fields, forms, email templates, and dynamic labels. Customizations can be made at the shared space level, affecting all workspaces, and at the workspace level, affecting the individual workspace. For details on the hierarchy, see Space configuration.

To customize custom entities:

1. Open the global menu and select Administration > General Settings.

2. Select a shared space or workspace.

3. Select the Entities tab.

4. In the Entities pane, the new entities are located at the bottom of the list. Select a new entity.

5. For each new entity, create business rules, add fields, design forms and email templates, and assign dynamic labels. For details, see the following topics:Business rules, Fields, Forms,Email templates, Dynamic labels.

## Create custom entity items

Create and manage items of custom entities in the My Views module.

To create and manage custom entity items:

1. Open the global menu and select My Views.

2. In a new tab, click Create new view.

3. In the list, select the custom entity. An empty grid is displayed.

4. To add an item, click the Add button.

   Shared items: If you have permissions, you can create an item that is shared across workspaces. Click the down arrow adjacent to the Add button add click Shared <entity name>.

5. Fill in details of the new item and save.

After you have added items, you can manage them in the grid by filtering, grouping, ordering and ranking. For details, see My Views.

## Use custom entities

You can use custom entities in the following ways:

- Reference fields: Add custom entities as reference fields in other entities, For example, a defect can have a field that references a customer entity. For details, see Fields.

- Widgets: You can display custom entities in summary widgets by selecting the custom entity for the widget's X Axis or Stack by fields. For example, if the custom Customers field is added to Defects, you can group defects in a widget by customer. For details, see Add and configure widgets.

## Limitations

Following are limitations regarding custom entities:

- Deactivation: Once activated, custom entities cannot be deactivated.

- Workflow: There is no phase workflow support for custom entities.

- Relations: You can add relations to custom entity items using the API. For details, see Relations.

https://admhelp.microfocus.com Software Delivery Management 8942
Tips to improve your search results... OpenText™ Software Delivery Management Help Center OpenText™ Software Delivery Management Help 26.3 All View Local Help Center View Online Help Center Version: