Create an investigation in a project

You can create an investigation from an existing knowledge graph, or create a knowledge graph to support your investigation in ArcGIS Pro.

Create an investigation from an existing knowledge graph

When the active portal in ArcGIS Pro is an ArcGIS Enterprise portal, you can browse, search, filter, and sort portal content to find the knowledge graph you want to work with and add it to a project. A new investigation will be created in the project, allowing you to analyze the knowledge graph's content.

1. Open the catalog view and click Project in the Contents pane.
2. On the Catalog tab on the ribbon, in the Create group, click the New drop-down arrow and click New Investigation .

   The Create Investigation wizard appears.

3. On the Define Investigation page of the wizard, type a name for the new investigation in the Title text box.

   Only alphanumeric characters can be used in the investigation name at this time.

4. Type descriptive information in the Summary and Tags text boxes.
5. Under the Knowledge Graph heading, click Use an existing knowledge graph.
6. Click the Browse button .

   The Add Knowledge Graph dialog box appears.

7. Browse to or search for the knowledge graph you want to investigate, select the knowledge graph, and click OK.
8. Click Finish.

   If you decide not to create an investigation, click Cancel or click the close button at the top of the pane to close the Create Investigation wizard.

A new investigation is created, and appears in the Catalog pane and the catalog view in the Investigations category. The investigation is opened and lets you explore the entities and relationships in the knowledge graph.

Once the investigation has been created, you can rename it in ArcGIS Pro in the same way you rename other items in your project.

Tip:

When you browse the contents of the active portal in the catalog view or the Catalog pane, you can create an investigation from an existing knowledge graph by right-clicking it and clicking Add To New Investigation .

Create an investigation and a knowledge graph

To create a knowledge graph, you must have the following:

• The active portal in ArcGIS Pro must be an ArcGIS Enterprise portal that has been configured to support ArcGIS Knowledge.
• You must be signed in to the active portal using an account that has been assigned sufficient privileges to create a knowledge graph.

1. Open the catalog view and click Project in the Contents pane.
2. On the Catalog tab on the ribbon, in the Create group, click the New drop-down arrow and click New Investigation .

   The Create Investigation wizard appears.

3. On the Define Investigation page of the wizard, type a name for the new investigation in the Title text box that is unique in the active portal.
4. Type descriptive information in the Summary text box.
5. Under the Knowledge Graph heading, click Create a new knowledge graph.
6. Click Next.

   Information you provided to describe the investigation is copied to the second page of the wizard. You can modify this description or use the same information to describe the knowledge graph.

7. On the Define Knowledge Graph page of the wizard, type a name for the new knowledge graph in the Title text box.

   Note:

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

8. Type descriptive information in the Summary and Tags text boxes.
9. Under Location, use the Folder drop-down list to choose a folder in My Content in which to store the knowledge graph. Optionally, create a folder.

   By default, the knowledge graph is stored at the root level of your portal content.

   Tip:

   Click the Browse button to browse to a folder in your portal content. You can also type a folder name in the text box.
10. Under Data Stores, use the Data Stores drop-down list to choose where the knowledge graph's entities and relationships will be stored.
    • Hosted graph store—The default data store. The knowledge graph's entities and relationships are created and stored in the ArcGIS Data Store graph store associated with the Enterprise portal.
    • NoSQL data store—Other data stores can be listed in addition to the Hosted graph store. These are NoSQL data store items that have been registered with the ArcGIS Knowledge Server site. Each NoSQL data store provides access to a supported database that can store content for one knowledge graph. If all listed NoSQL data stores are in use by other knowledge graphs, you must add a new NoSQL data store for the new investigation you are creating and click Refresh to show the new data store in the list.

    In the example below, the Enterprise portal has a Hosted graph store and a NoSQL data store named neo4j_db1.

    

11. Under Share with, specify how the knowledge graph will be shared.
    • ArcGIS Enterprise—This option allows your content to be shared with all authenticated users in the organization.
    • Groups—This option allows you to share your content with groups to which you belong and their members.

    Leave all options unchecked to set the sharing level to the owner of the item.

12. Click Next.
13. On the Spatial Reference page of the wizard, you see the WGS 1984 coordinate system will be used for any geospatial features defined as part of the knowledge graph.

    Note:

    Geospatial features can only be defined in the WGS 1984 coordinate system at this time. Additional spatial references will be supported in a future release.

14. Click Finish.

    If at any point you want to discard your changes and not create a knowledge graph, click Cancel or the close button at the top of the pane to close the Create Investigation wizard.

    Tip:

    If the Finish button does not become enabled, check if another knowledge graph with the same name exists in the active portal.

The knowledge graph is created in the active portal. A new investigation is created in the project referencing the new knowledge graph and appears in the Catalog pane and the catalog view in the Investigations category. The investigation is opened and lists the entities and relationships in the knowledge graph. You can explore the knowledge graph further in the investigation view.

Tip:

When your project already includes an investigation, you can add another investigation to the project by right-clicking Investigations in the Catalog pane or the catalog view and clicking New Investigation .

Delete an investigation

You can delete an investigation from your project. This will not delete the knowledge graph associated with the investigation from the Enterprise portal. A knowledge graph can support several investigations.

1. Open the catalog view and click Investigations in the Contents pane.
2. Click an investigation in the contents list to select it.
3. Delete the investigation from the project using one of the following methods:
   • Click Delete on the Catalog tab on the ribbon, in the Organize group.
   • Right-click the investigation and click Delete .
4. In the message box that appears, click Yes to indicate you want to permanently delete the investigation from your project.

The selected investigation is deleted from the project and the contents list is updated. Item categories only appear in a project if the project includes those items. For example, after successfully deleting the last investigation in the project, the Investigations category will no longer appear in the Catalog pane and the catalog view. The category will reappear if you add another investigation to the project.

The knowledge graph that was associated with the investigation remains on the ArcGIS Enterprise portal. If you access the portal using a web browser, you can delete knowledge graph items that you own. Administrators can also delete knowledge graphs owned by other users. Once a knowledge graph has been deleted in the ArcGIS Enterprise portal, any associated investigations, link charts, and map layers must be deleted; they can't be used with a different knowledge graph.