Edit the data model

As you explore the knowledge graph data model, you can add and delete entity and relationship types and their properties. You can modify, add, and delete properties of each type. You can also change the data model visualization layout. Changes made to the data model can be saved as draft designs or applied to the existing data model. Any changes applied to the data model will be seen in all investigations, maps, and link charts that use data from the knowledge graph.

Create an entity type

You can add a new entity type in the data model designer. New entity types are added to the draft design.

1. On the Data Model tab, in the Editing group, click the New drop-down list and click New Entity Type . Optionally, right-click an empty space in the view panel and click New Entity Type.

   The New Entity Type dialog box appears.

2. In the Name text box, type the entity type name.

   Note:

   Unicode characters can be used in the name with some restrictions.

3. Click the Spatial Type drop-down arrow and click the type of spatial feature that will be associated with this entity type. Click Nonspatial if the entity type is not associated with spatial information.

   Only one geometry type can be associated with each entity type. You can't change the geometry type after the new entity type has been added to the knowledge graph. For example, once an entity type has been defined as nonspatial, you can't change it and allow entities to have associated point features.

4. Click OK.

   The new entity type is added to the draft data model. A new entity appears in the Entity Types list in the Contents pane. An entity representing the new type is added to the view panel. The new entity is identified as a New item .

5. On the Data Model tab, in the Tools group, click Apply Design .

   The Apply Data Model Changes dialog box appears.

6. Click Apply.

   The new entity type is added to the data model.

Tip:

You can create an entity type from the Contents pane. Right-click Entity Types and click New Entity Type.

Create a relationship type

You can add a new relationship type in the data model designer to create associations between entities. New relationship types are added to the draft design.

1. Right-click the origin entity for the relationship in the data model designer and click Add Relationship.

   A relationship arrow appears in the data model designer.

2. Move the arrow and click the destination entity for the relationship. Optionally, on the Data Model tab, in the Editing group, click the New drop-down list and click New Relationship Type .

   The New Relationship Type dialog box appears.

3. If available, click the Origin drop-down list and click the entity type to use as the origin for the relationship.
4. Click the Type Name field.
5. Enter the name of your new relationship type or select an existing relationship type.
6. If available, click the Destination drop-down list and click the entity type to use as the destination for the relationship.
7. Click OK.

   The new relationship type is added to the draft data model. A new relationship appears in the Relationship Types list in the Contents pane. A dashed relationship representing the new type is added to the view panel. The new relationship is identified as a New item .

8. On the Data Model tab, in the Tools group, click Apply Design .
9. Click Apply.

   The new relationship type is added to the data model.

Tip:

You can create a relationship type from the Contents pane. Right-click Relationship Types and click New Relationship Type.

Delete an entity or relationship type

You can delete entity and relationship types in the data model designer. This will remove the unwanted types from the knowledge graph's data model. You can undo deletes before applying your changes.

1. With Selection mode enabled, click an entity or relationship type in the data model designer. Optionally, click and drag to select multiple types.
2. On the Data Model tab, in the Editing group, click Delete .

   The type is deleted in the draft design. This change is indicated as a Deleted item and the name of the text is displayed using a strike-through font.

3. Optionally, right-click a deleted type in the data model designer or its Contents pane and click Undo Delete.

   The deleted type is restored in the draft data model design and its name is displayed using a regular font.

4. On the Data Model tab, in the Tools group, click Apply Design .

   The Apply Data Model Changes dialog box appears.

5. Click Apply.

   Deleted types are removed from the knowledge graph's data model.

Tip:

You can delete and undo delete from the Contents pane. Right-click the type and click Delete or Undo Delete.

Change the data model layout

You can change the layout and switch color-coding of types in the data model designer. Relationship types will move when you move their respective origin and destination entity types—they cannot be moved manually. Layout changes can be saved in the investigation's data model designs for sharing or later use.

1. With Selection mode enabled, click an entity in the view panel.
2. Click and drag the entity to the desired location in the view panel. Optionally, on the view panel toolbar, click an alignment to reposition all entity nodes and connected relationships.
3. Optionally, in the Contents pane, click the Color-code entity types or the Color-code relationship types toggle button.

   Unique colors are applied to all entity and relationship types.

4. Optionally, save the data model design . The data model design is saved in the investigation.

Edit properties of entity and relationship types

You can add, edit, and delete properties of entity and relationship types in a data model design. You can add default values for properties and turn editing and visibility on or off.

Add properties to the data model design

To add properties to the data model design, complete the following steps:

1. In the view panel, click the entity type or relationship to which you want to add a property.
2. In the details panel, click the Properties tab.

   The properties of the selected entity or relationship type are listed.

3. Click the Add button .

   A new property is added at the bottom of the list.

4. Click in the Name column and type a new name for the property, and press Tab twice.

   Note:

   Unicode characters can be used in the name with some restrictions.

5. New properties have the Text data type by default. Press Enter to accept Text as the data type. To specify a different data type for this property, use the arrow keys to select the appropriate data type for the information the property will store, and press Enter.

   The new property is added to the draft data model design.

6. Optionally, click in the Alias column and type a new alias for the property
7. Optionally, uncheck the Visibilty and Editable check boxes

   Property visibility and editing are disabled for investigations, link charts, and maps using the knowledge graph service.

8. Optionally, click in the Default column and type a new default value for the property.

   New instances of the type will have the default property value.

9. Continue to modify the properties as needed.
10. Optionally, on the view panel toolbar, click Save .

    The data model design is saved.

11. Optionally, on the Data Model tab, in the Tools group, click Apply Design .

    The Apply Data Model Changes dialog box appears.

12. Click Apply.

    The new property is added to the data model of the knowledge graph service.

Tip:

You can add properties from the Contents pane. Right-click the property and click Add Property.

Delete properties in the data model design

You can delete properties from an entity type or relationship type if they are no longer needed.

1. In the view panel, click the entity type or relationship from which you want to delete a property.
2. In the details panel, click the Properties tab.

   The properties of the selected entity or relationship are listed.

3. Click the property you want to delete in the list.
4. Click Delete at the top of the properties list.

   The property is deleted in the draft design, indicated as a deleted item with strike-through text.

5. Optionally, click Undo Delete .

   The deleted property is restored in the data model design.

6. Optionally, on the view panel toolbar, click Save .

   The data model design is saved.

7. Optionally, on the Data Model tab, in the Tools group, click Apply Design .

   The Apply Data Model Changes dialog box appears.

8. Click Apply.

   The new property is deleted from the data model of the knowledge graph service.

Tip:

You can delete properties from the Contents pane. Right-click the property and click Delete.