Customizing your data types in IBM Match 360

Last updated: May 30, 2025
Customizing your data types in IBM Match 360

Customize your IBM Match 360 data types to match your organization's data model requirements. You can create or modify record types, entity types, relationship types, hierarchy types, attribute types, and fields.

Required permissions
To configure data types, you must be a member of the DataEngineer user group for the IBM Match 360 service.

When you onboard your first data asset, IBM Match 360 automatically generates a data model by using a combination of industry standard model attributes and embedded IBM Watson technology. When you upload more data, the model intelligently adjusts itself to accommodate newly populated attributes and fields.

If you want to store information about relationships or hierarchies in your master data, you must configure one or more relationship types or hierarchy types in your data model.

You can always customize your data types to match your organization's requirements by adding new relationship types, record types, entity types,, hierarchy types, attribute types, and fields.

Tip: Ensure that you publish your data types after every time you make changes. If the changes are not published, they cannot be used by the matching algorithm or other IBM Match 360 operations.

Watch the following video to see how to use IBM Match 360 to set up a customized data type and corresponding matching algorithm.

This video provides a visual method to learn the concepts and tasks in this documentation.

In this topic:

Accessing the data type definitions

To customize your IBM Match 360 data types:

  1. From the Master data navigation menu, click the Data types icon data types icon.

  2. Review the current data type settings. From the Data types screen, you can:

    • View, edit, or delete existing attributes or create new ones. You can also add or remove fields in each attribute type to reflect your organization's data model requirements. See Customizing attribute types.
    • View or edit existing record types or create new ones. See Customizing record types.
    • View, edit, or delete existing entity types or create new ones. See Customizing entity types
    • View or edit existing relationship types or create new ones. See Customizing relationship types.
    • View or edit existing group types or create new ones. See Customizing group types.
    • View or edit existing hierarchy types or create new ones. See Customizing hierarchy types.
    • Download the data type definitions as a JSON file. Click the Download icon download icon.
    • Upload data type definitions in JSON format. Click the Upload icon upload icon.
  3. When you are done updating the data types, click Publish data types publish data types icon in the toolbar.

Customizing attribute types

Click Data types > Attribute types to see all of the attribute types that have been defined. Select an attribute type to see its details, as well as to edit or delete it.

To customize the fields that make up your attribute types:

  1. From the Master data navigation menu, click the Data types icon data types icon.
  2. Click Attribute types.
  3. Browse the list of attribute types or use the search function to locate a specific type.
  4. Select an attribute type from the list to view it and its associated fields.
  5. To add a field to an attribute type: a. Click Add field. b. Define the field label, field name, and description, then click Save. The new field is added to the associated attribute type.
    Tip: The name must follow the snake_case format, using only lowercase letters and no spaces, such as `example_field_name`.

Remember: When you are done updating the data types, click Publish data types publish data types icon in the toolbar.

Customizing record types

By default, the data model includes record type definitions for person and organization. You can edit an existing record type to define new entity types or attribute types. You can also add new record types.

Click Data types > Record types to see all of the record types that have been defined. Select a record type to see its details, as well as to edit or delete it.

Adding or editing a record type

To add a record type to your data type definitions, or edit an existing one:

  1. From the Master data navigation menu, click the Data types icon data types icon.

  2. Click Record types.

  3. Click New record type or select the existing record type that you want to modify. If you are editing an existing record type, click the Edit icon edit icon.

  4. Define the display name and description of the record type.

  5. Optionally, define associated entity types that are valid for this record type. If you choose not to do this step now, you can associate one ore more entity types later.

  6. Click Create.

    Tip: The name must follow the snake_case format, using only lowercase letters and no spaces, such as example_record_type.
  7. Add attribute types and entity types to your record type. For details, see the following sections.

Adding an attribute or entity type to a record type

To add an attribute or entity type to a record type:

  1. From the Master data navigation menu, click the Data types icon data types icon.

  2. Click Record types.

  3. Click the name of the record type that you want to modify, then click the Edit icon edit icon.

  4. Click New attribute or New entity type to start creating and associating attributes and entity types with your new record type.

  5. Define the details of your new attribute type or entity type.

    • Attribute types can either be simple or complex. Complex attributes are made up of two or more simple values.

    • Entity types can either be identity entities or association entities. Identity entities link records that represent the same real-world person, organization, or object. Association entities link records that should be associated for another reason, such as a shared household or employer. For more information, see Data concepts in IBM Match 360.

  6. Click Create to add the attribute type to your record type.

Remember: When you are done updating the data types, click Publish data types publish data types icon in the toolbar.

Deleting an attribute or entity type from a record type

To edit an existing record type by removing one of its entity types or attribute types:

  1. From the Master data navigation menu, click the Data types icon data types icon.
  2. Click Record types.
  3. Click the name of the record type that you want to modify and click the Edit icon edit icon.
  4. Browse through the entity and attribute types that are associated with this record type. To find a specific attribute type, use the search function.
  5. From the record type view, click the entity or attribute type you want to remove.
  6. Click the Delete icon delete icon.

Remember: When you are done updating the data types, click Publish data types publish data types icon in the toolbar.

Customizing entity types

By default, the data model includes definitions for person and organization entity types. You can edit an existing entity type to add an attribute type. When defined at the entity type level, an attribute is referred to as an entity attribute. You can also add new entity types to your data model.

Click Data types > Entity types to see all of the entity types that have been defined. Select an entity type to see its details, as well as to edit or delete it.

Adding or editing an entity type

Entity types can either be identity entities or association entities. Identity entities link records that represent the same real-world person, organization, or object. Association entities link records that should be associated for another reason, such as a shared household or employer. For more information, see Data concepts in IBM Match 360.

To create or edit an entity type:

  1. From the Master data navigation menu, click the Data types icon data types icon.

  2. Click Entity types.

  3. Click New entity type or click the name of the entity type that you want to modify and click the Edit icon edit icon.

  4. Define the display name and description of this entity type.

  5. Define whether this type of entity persists its composite view in the database or whether it is composed on demand from its member records.

    When an entity's composite view is configured to persist, you can directly search on entity data, including attributes and system properties such as record count and entity ID.

    After an entity type's composite view is configured to persist, this setting cannot be reversed.

  6. Click Create to add this entity type to the data model.

  7. Add attributes to your new entity type. For details, see the following section.

Adding an attribute to an entity type

Attributes that you define as part of an entity type are stored in the database at the entity level, as opposed to the record level. Entity attribute values display when users view an entity, regardless of the member record attributes values. If no entity attribute values are defined, then the system determines all of an entity's attribute values from its member records' values by using attribute composition rules. For more information about attribute composition, see Defining attribute composition rules in IBM Match 360.

To add an attribute to an entity type:

  1. From the Master data navigation menu, click the Data types icon data types icon.

  2. Click Entity types.

  3. Click the name of the entity type that you want to modify and click the Edit icon edit icon.

  4. Click New attribute to start creating and associating attributes with your entity type.

  5. Define the details of your attribute.

    Attribute types can either be simple or complex. Complex attributes are made up of two or more simple values.

  6. Click Create to add the attribute to your entity type.

Remember: When you are done updating the data types, click Publish data types publish data types icon in the toolbar.

Customizing relationship types

Create a new relationship type within your data type definitions or edit an existing one. You can also delete an existing relationship type.

Click Data types > Relationship types to see all of the relationship types that have been defined. Select a relationship type to see its details, as well as to edit or delete it.

Adding a relationship type

To add a relationship typedel:

  1. From the Master data navigation menu, click the Data types icon data types icon.

  2. Click Relationship types, then click New relationship type.

  3. Define the label to use for the new relationship type. This label will be used to refer to relationships of this type. As you type the label, the relationship type name automatically completes.

  4. Optionally, edit the prefilled relationship type name.

    Tip: The name must follow the snake_case format, using only lowercase letters and no spaces, such as `example_relationship_type`.
  5. Type a short description of the relationship type.

  6. Define whether this relationship is directional or bidirectional.

    • Directional relationships differ depending on which member of the relationship you are viewing. The labels for directional relationships are different depending on which side of the relationship you view. For example: Doctor-Patient, Parent-Child, Employer-Employee.
    • Bidirectional relationships are mutual relationships. The label used for bidirectional relationships is the same regardless of which side of the relationship you view. For example: Married to, Sibling of, Coworker of.
  7. Click Next.

  8. If you are defining a directional relationship, define the labels for each side of the relationship (source and target). For example, for an employment relationship, you can define labels such as "Employs" and "Is employed by".

  9. Click Add endpoint rules to define rules that govern the types of entities that can be involved in relationships of this type. Endpoint rules are made up of source-target pairs. They define what types of entities are allowed for both the source and target sides of the relationship. Select All record types if there are no entity type restrictions or select one of the existing entity types in your data model.

    Tip: You must define at least one endpoint rule, but can define as many as necessary.
  10. After adding endpoint rules, click Done.

  11. Click Create

After creating a relationship type, you can see it listed in the Relationship types table.

Select a relationship type to see its details, as well as to edit or delete it.

Remember: When you are done updating the data types, click Publish data types publish data types icon in the toolbar.

Adding an attribute to a relationship type

Add attributes to a relationship type to enable the relationship entity to store additional information about relationships of this type.

To add an attribute to a record type:

  1. From the Master data navigation menu, click the Data types icon data types icon.
  2. Click Relationship types.
  3. Click the name of the relationship type that you want to modify and click the Edit icon edit icon.
  4. Click New attribute to start creating and associating attributes and entity types with your new record type.
  5. Define the details of the attribute type. An attribute can either be simple or complex. Complex attributes are made up of two or more simple values.
  6. Click Add to add the attribute type to the record type.

Remember: When you are done updating the data types, click Publish data types publish data types icon in the toolbar.

Deleting an attribute from a relationship type

To edit an existing relationship type by removing one of its attribute types:

  1. From the Master data navigation menu, click the Data types icon data types icon.
  2. Click Relationship types.
  3. Click the name of the relationship type that you want to modify and click the Edit icon edit icon.
  4. Browse through the attribute types that are associated with this relationship type. To find a specific attribute type, use the search function.
  5. From the relationship type view, click the attribute type you want to remove.
  6. Click the Delete icon delete icon.

Remember: When you are done updating the data types, click Publish data types publish data types icon in the toolbar.

Customizing hierarchy types

To enable data stewards to work with hierarchies, you must define at least one hierarchy type in your data model. After a hierarchy type has been defined, data stewards can create hierarchy instances, add or remove members, and define hierarchy relationships. For more information about working with hierarchies, see Exploring hierarchies.

Click Data types > Hierarchy types to see all of the hierarchy types that have been defined. Select a hierarchy type to see its details, as well as to edit or delete it.

Adding a hierarchy type

To define a new hierarchy type:

  1. From the Master data navigation menu, click Data types data types icon to open the data types page.

  2. Select Hierarchy types and then click New hierarchy type.

  3. Specify the details of your new hierarchy type: a) Provide a display name and description for this hierarchy type. b) Select the allowed data types in this hierarchy type. For example, if this hierarchy is a company organizational chart, you might choose to only allow records that have the Employee record type. c) Click Create.

  4. Optionally, add attributes and fields to the hierarchy. For more information. see Adding attributes and fields to a hierarchy type.

  5. When you are done adding the hierarchy type, click Publish data type in the action bar of the screen.

    Important: After a hierarchy type is published, it cannot be deleted. You can only delete hierarchy types before they are published.

    To delete an unpublished hierarchy type: a) Click Data types in the navigation path to go back to the Hierarchy types screen. b) Review the list of hierarchy types. In the Data model status column, check to ensure that the value is Not published. c) Click the action menu for the hierarchy and choose Delete hierarchy type.

Adding attributes and fields to a hierarchy type

After you have created a hierarchy type, you can add attributes and fields. You can add either hierarchy attributes or member attributes.

  • Hierarchy attributes are attributes that describe the hierarchy object.
  • Member attributes are attributes that get applied to each member node in the hierarchy.

Within the hierarchy attributes, there is a preset attribute called Hierarchy name. This attribute value is typically used as a label to display the hierarchy name within IBM Match 360.

To add an attribute or field to a hierarchy type:

  1. From the Master data navigation menu, click Data types data types icon to open the data types page.

  2. Click the Attributes and fields tab. There are two sections on this page: Hierarchy attributes and Member attributes.

  3. Click New attribute to add hierarchy or and member attributes. Specify the attribute details: a) Select the base attribute type. These options are based on other attributes defined in your data model. b) Define the cardinality of this attribute. Choose Single if you do not need provide multiple values for this attribute. d) Type the display name and, optionally, provide a description of the attribute. e) Click Create.

    Repeat this process to add as many attributes as you need.

  4. Define the display name for hierarchies of this type: a) Select an attribute. b) Drag or click + to add a field.

  5. When you are done adding the hierarchy type, click Publish data type in the action bar of the screen.

    Important: After a hierarchy type is published, it cannot be deleted. You can only delete hierarchy types before they are published.

    To delete an unpublished hierarchy type: a) Click Data types in the navigation path to go back to the Hierarchy types screen. b) Review the list of hierarchy types. In the Data model status column, check to ensure that the value is Not published. c) Click the action menu for the hierarchy and choose Delete hierarchy type.

Next steps

Learn more

Parent topic: Configuring master data