As the owner of a knowledge graph or an organization administrator, you control settings for a knowledge graph. These settings determine which users can edit what information in a knowledge graph, if searching the information in a knowledge graph is allowed, and if provenance can be collected to define the origin of information in the knowledge graph.
The knowledge graph settings you can change are determined by the knowledge graph's data store.
Enable editing
The owner of the knowledge graph and administrators of the ArcGIS Enterprise organization can always edit its data. By default, other users cannot modify this knowledge graph's data unless editing is enabled. With this setting, you can allow other users to edit the knowledge graph and determine what types of edits they can perform.
You can enable editing for hosted knowledge graphs and knowledge graphs referencing NoSQL data stores that contain data managed by ArcGIS. Once editing is enabled, users with whom you share the knowledge graph who have sufficient privileges can edit its content in ArcGIS Pro.
You can enable editing knowledge graphs referencing NoSQL data stores that contain user-managed data as well. However, you can only edit these knowledge graphs using a custom client application that accesses and updates the knowledge graph using one of the available developer APIs. When using a custom client, users can perform such edits as creating entities and relationships and defining values for their properties, depending on the editing capabilities allowed on the knowledge graph. However, new entity and relationship types and new properties for existing types cannot be created by any users. This capability cannot be enabled in ArcGIS Pro for these knowledge graphs, and editing their content is also not allowed in ArcGIS Pro.
Follow these steps to alter settings that control whether others can edit a knowledge graph and what edits can be made:
- Sign in to your organization and open the item details page for the knowledge graph.
- Click the Settings tab and scroll to the Knowledge Graph Settings section of the page.
- Check Enable editing to allow other users to edit the knowledge graph.
- Choose one of the following options for the What kind of editing is allowed? setting:
- Add entities and relationships—Users can create entities and relationships in the knowledge graph. Users can also add properties to entities and relationships.
- Delete entities and relationships—Users can delete entities and relationships from the knowledge graph.
- Update entities and relationships—You can restrict users to editing only existing properties of entities and relationships by choosing the Properties only option or allow them to also edit the geometries of entities by choosing the Properties or geometry option.
- Click Save at the bottom of the Settings tab.
If editing requirements change, you can alter what kind of editing is allowed by choosing different options in step 4 or uncheck Enable editing to prevent others from editing the knowledge graph.
Enable search
All knowledge graph data can be accessed with an openCypher query. However, you can only find graph items using a full-text search against the properties of entities and relationships if search is enabled. With this setting, you can allow users who can access the knowledge graph to use full-text search to find content in which they are interested.
Searching is always allowed for hosted knowledge graphs and knowledge graphs referencing NoSQL data stores that contain data managed by ArcGIS. For these knowledge graphs, you cannot disable searching.
You can enable searching knowledge graphs referencing NoSQL data stores that contain user-managed data. If searching was previously allowed and you turn it off, full-text search will not be available, and existing search indexes in the NoSQL database are deleted. If you try to search for an item, an openCypher query is used to find graph items whose properties contain the specified value, but you cannot use Lucene syntax such as using an asterisk to match partial values.
Follow these steps to alter settings that determine if you can use full-text search to find graph items in a knowledge graph:
- Sign in to your organization and open the item details page for the knowledge graph.
- Click the Settings tab and scroll to the Knowledge Graph Settings section of the page.
- Check Enable search to allow searching for entities and relationships in the knowledge graph.
- Click Save at the bottom of the Settings tab.
Users with whom you share the knowledge graph can now search for entities and relationships in ArcGIS Pro and ArcGIS Knowledge Studio. You can use Lucene syntax in the search string, including operators such as OR and LIKE. Also, you can add an asterisk with a partial keyword, such as plan*, to match all related words.
If searching requirements change, you can remove the ability to find entities and relationships in the knowledge graph using full-text search by unchecking Enable search.
Enable provenance
When provenance is supported in a knowledge graph, you can describe where its information originated. Each entity or relationship property value can reference a document in the knowledge graph, an external website or file, or text that explains the value's source. With this setting, you can allow users who have sufficient privileges to edit the knowledge graph to define the origin of a property value.
The owner of the knowledge graph and administrators of the ArcGIS Enterprise organization can always add provenance information if provenance is enabled. If editing is enabled for the knowledge graph, additional users with access to the knowledge graph who have sufficient privileges to edit can also add provenance records to define the origin of the knowledge graph's content.
You can enable provenance for hosted knowledge graphs and knowledge graphs referencing NoSQL data stores that contain data managed by ArcGIS. Once provenance has been enabled, existing provenance records must be deleted from a knowledge graph before provenance can be turned off.
Provenance cannot be enabled for knowledge graphs referencing NoSQL data stores that contain user-managed data.
Follow these steps to alter settings that determine if you can add provenance records to a knowledge graph:
- Sign in to your organization and open the item details page for the knowledge graph.
- Click the Settings tab and scroll to the Knowledge Graph Settings section of the page.
- Check Enable provenance to allow adding provenance records that specify the origin of property values in the knowledge graph.
- Click Save at the bottom of the Settings tab.
Users with whom you share the knowledge graph who can edit the knowledge graph can also add provenance records using ArcGIS Pro.
If requirements change, you can remove the ability to add provenance records to the knowledge graph by unchecking Enable provenance. You can only disable provenance if there are no provenance records in the knowledge graph.