Add a knowledge graph to a map or scene

You can add entities with a spatial location to a map or scene. This allows you to see spatial relationships between entities that aren't apparent in a nongeographic view and visually correlate those entities with geographic features that don't participate in the knowledge graph.

When you add entities and relationships to a map, a knowledge graph layer is created. A knowledge graph layer is a composite layer with a knowledge graph as its data source. The knowledge graph layer contains knowledge graph feature layers and knowledge graph tables. Knowledge graph feature layers provide access to entity and relationship types where their instances can have spatial features. Knowledge graph tables provide access to nonspatial entity and relationship types.

After adding content from a knowledge graph to the map, you work with and symbolize knowledge graph layers in much the same way you work with feature layers and stand-alone tables. You can control the behavior and appearance of the knowledge graph feature layers by modifying their properties and symbology. You can copy properties from one knowledge graph feature layer to another in a map, or to a link chart layer in a link chart created from a knowledge graph.

Open a feature layer's attribute table to see the properties of entities and relationships that can have spatial features. You can also display properties of spatial entities and relationships by configuring the feature layer's pop-ups. Pop-ups can also use ArcGIS Arcade expressions to query the knowledge graph and show information about relationships and related entities in the pop-up. Open a table in the knowledge graph layer to see the properties of nonspatial entities and relationships.

You can perform spatial analysis on knowledge graph feature layers included in a map. You can also leverage the information provided by nonspatial entities and relationships in your analysis. Any geoprocessing tool can use knowledge graph feature layers and knowledge graph tables as input.

Add content from an investigation

Follow these steps to add a knowledge graph layer to a map or scene from an investigation in your project. You can add as much or as little content from the investigation's knowledge graph as you want.

1. Open an investigation and browse its content.
2. Select the content to add to a map or scene.
   • Right-click the investigation in the Contents pane to add all of its content.
   • Right-click the knowledge graph in the Contents pane to add all the entities and relationships it contains.
   • Right-click Entity Types or Relationship Types in the Contents pane to add all entities or all relationships.
   • Right-click an entity type or relationship type to add all items of that type.
   • Press Ctrl and click individual entities and relationships in the contents list to select the items you want to add, and right-click a selected item.
   • Right-click a single entity or relationship that you want to add.
3. On the context menu that appears, click the appropriate option to add the specified content to a one of the open maps or scenes. Or click Add To New and click Map , Global Scene , or Local Scene to add a knowledge graph layer representing the specified content to the new map or scene that is created.

A knowledge graph layer is created in the map or scene representing the selected content.

Note:

You can drag any of the items associated with an investigation's knowledge graph from its Contents pane or the investigation's contents list and drop them on a map, including entities and relationships returned by a search. For example, you can drag a specific entity type onto a map to create and edit entities.

Also, when viewing details for entities or relationships, you can right-click the display expression at the top of the details panel and choose to add the selected entities or relationships to a new map or scene.

Add content from the Catalog pane or view

Follow these steps to add content from an investigation in your project to a map or scene.

1. Make sure a map or scene is your active view.
2. On the Map tab, in the Layer group, click Add Data .
3. Click Investigations on the left side of the browse dialog box.
4. Select the content from the investigation you want to add.
   • Click the investigation to add all of its content.
   • Browse to an investigation's contents and click its knowledge graph to add all content in the knowledge graph.
   • Browse to a knowledge graph and click Entity Types or Relationship Types to add all entities or all relationships.
   • Browse to a knowledge graph's Entity Types or Relationship Types list and click an entity type or relationship type to add all of its entities or relationships.
5. Click OK.

A knowledge graph layer is created in the map or scene representing the selected content.

Note:

You can browse the contents of an investigation in the catalog view or Catalog pane in the same manner as in the browse dialog box. Right-click the investigation or the entity type you want to work with, for example. Click the appropriate option on the context menu to add the specified content to an open map or scene. Or click Add To New and click Map , Global Scene , or Local Scene to add the selected content as a layer.

Add a knowledge graph from its URL

Follow these steps to add a knowledge graph layer to a map or scene by specifying the URL for a knowledge graph service in ArcGIS Enterprise.

1. On the Map tab, in the Layer group, , click Add Data From Path .
2. Type a path or URL to a knowledge graph, for example, https://<portal_url>/server/rest/services/Hosted/<serviceName>/KnowledgeGraphServer.
3. Click Add to add the knowledge graph as a new layer in your map or scene.

A knowledge graph layer representing the entire knowledge graph is created in the map or scene.

Add a knowledge graph from a link chart

After creating a link chart from an investigation's knowledge graph, you can add selected content from the link chart to a map or scene.

1. Select the entities and relationships in the link chart that you want to add to the map or scene.
2. On the Link Chart tab, in the Selection group, click the Add To menu .
3. Click the appropriate option to add a knowledge graph layer to the specified map or scene.
   • Click the name of an open map or scene.
   • Click New Map to create a map in the project.
   • Click New Global Scene to create a global scene in the project.
   • Click New Local Scene to create a local scene in the project.

A knowledge graph layer representing the selected content is created and added to the map or scene.

Repair a broken data source for a knowledge graph layer

When you open a map, a scene, or a link chart, the data referenced by each of the layers is accessed. If the data source has been moved, renamed, deleted, or is otherwise inaccessible, that layer doesn't draw and its broken status is indicated in the Contents pane with a red exclamation point . Similarly, if the data source of a stand-alone table is unavailable, the same indicator is shown.

If the data source is available in a new location or with a new name, you can repair the data source link. For example, if the NoSQL database associated with the original knowledge graph is now referenced by a new knowledge graph on a new ArcGIS Enterprise deployment, you can repair the data source link. Configure the layer to access the new knowledge graph on the new Enterprise portal. Alternatively, if you are not able to repair the link immediately, you can leave the data source broken and continue to work with the link chart, or you can remove the layer or table if it is no longer needed.

Different options are available to repair layers that access spatial data sources and stand-alone tables. However, some of those options are not available for knowledge graph layers. Follow the steps below to repair a knowledge graph layer.

Learn about repairing spatial data layers and stand-alone tables

1. Ensure the current knowledge graph is available on the active portal and you are signed in with sufficient privileges to access it.
2. In the Contents pane of a link chart, right-click the knowledge graph layer, and click Properties.
3. On the Source tab, click Set Data Source.
4. On the dialog box that appears, browse to the new knowledge graph, select it, and click OK.
5. Click Apply or OK in the Layer Properties dialog box.