Skip to main content
Skip table of contents

Introducing GraphXR Projects

The Projects page is your portal to create and manage individual GraphXR projects. It’s also where you review details of your GraphXR account and register your questions and comments.

The menu at the top of the Projects page lets you access and edit your GraphXR account or log out. Feedback lets you log questions and comments for administrator review and response and Help takes you to the Kineviz website where you can find learning resources and contact information.

A language selector menu enables you to choose UI elements labeled in either English or Chinese.

The body of the Projects page includes areas to create and access GraphXR projects:

  • Recent Projects displays projects you have recently opened.

  • My Projects lets you Create a new project, and displays projects you’ve created.

  • Shared Projects displays projects of other users which have been shared with you.

  • Demo Projects lets you select a demo project from those available using the Select Demo dropdown.

The Search Projects bar at the top of the page lets you find one or more projects by name.

A display icon lets you display projects in a more compact list, instead of the default tiles.

Explore a Demo Project

To get started quickly with GraphXR you can explore available Demo projects.

To open a Demo project:

  1. Click the dropdown arrow next to Select Demo and select a project from the menu.

  2. Now click the demo project you selected to enter its graph space.

  3. The project’s graph space will be empty when you open it.

    For Demo projects that are connected to a Neo4j database, you can click the Project menu item on the upper left side of the browser window to explore the categories and relationships in the connected database.

    For example, in the Demo project with data for the HBO Game of Thrones series, categories such as Character, House, Episode, etc, and relationships such as child_of, married_to, guarded_by, etc. have been created in the Neo4j graph database. You’ll also see the color assigned to each category (or relationship), and a list of their defined property names.

To explore the data, you’ll need to pull it into the graph space from the database. GraphXR provides several different ways to do this. For details, see Import from a Graph Database (Neo4j).

Creating a Project

You can create a new GraphXR project and either leave the project unconnected, or immediately connect to a Neo4j database.

Create a stand-alone project

Creating a project without connecting it to a Neo4j database can be useful for importing and working with data available in a variety of formats (e.g. CSV, SQL, JSON, GraphXR's GXRF and Snapshot files, and others). Once the project is created, you can import many types of data files simply by drag and drop, or select and model specific data using GraphXR’s Mapping Editor.

To create a stand-alone project:

  1. In the Projects page and My Projects area, click the Create button at the right, or click the + icon on the Create tile.

  2. In the Project Name text box, enter a descriptive project name. Make sure that Configure Neo4j Instance is not checked.

    NOTE: The Apply Template menu lets you select a pre-defined template when creating a new project.

  3. Click Confirm.
    The new project tile appears under Your Projects. Sharing of the project with another user is enabled by default.

    You can:
    • Click Invite to email users and grant access only to that project and the data views you share.
    • Click ShareUI Config to restrict share users' ability to navigate or edit the view.
    • Click the project’s Enable Share/Disable Share (Lock) icon to disable sharing.

    • Click the Edit icon to edit the project, for example, to connect it to a Neo4j database.
    • Click the Clone icon to duplicate the project.
    • Click the Delete (trash can) icon to delete the project.
    • Click anywhere on the project tile to enter the project's graph space, which will be empty.

Create a project connected to a Neo4j database

You can connect a project to an existing Neo4j graph database by specifying the database and server details. Once the connection is established, you can review the project settings and enter its graph space.

To create a project connected to a Neo4j database:

  1. In the Projects page and My Projects area, click the Create button at the right, or click the + icon in the Create tile.

  2. In the dialog that appears, click the Configure Neo4j Instance checkbox.

  3. Enter a descriptive Project Name and, optionally, select a template using the Apply Template menu.

  4. Enter the information required to connect to your Neo4j database:


    Neo4j h\Host: Host address, (e.g., a url such as localhost, or other host location). Do not include https://, bolt://, or :(port number) here.
    Bolt Port: (e.g. 7687)
    Neo4j username: DB user name
    Neo4j password: DB password
    Connection Type: Choose one of the following:
    -- Browser Connection: GraphXR connects to the Neo4j DB directly through the browser.
    HTTPS is required to be on for Neo4j, and this is the preferred connection type.
    -- Through GraphXR server connection: Data flows from the Neo4j DB through a GraphXR server
    to the browser. In this mode you can share the project. HTTPS is optional for the Neo4j DB.
    Advanced Neo4j Filter: Experienced Neo4j users can optionally specify graph data structures and Neo4j version expected for the project. Click the tooltip icon (question mark) for an example.

  5. Click Confirm.
    The new project appears in Your Projects.

You can now:

  • Click the Settings icon, labeled APOC Search Index Config, to use Neo4j's indexing plugin to configure the allowed search terms for the project. You can modify these search terms at any time.

  • Click the project's Switch DB icon to edit its Neo4j configuration.

  • Click the Delete (trash can) icon to delete a project. This deletes only the GraphXR project, not its Neo4j database.

  • Click on the project name to enter the project's graph space and begin pulling data from the Neo4j database.

  • Click the project’s Enable Share/Disable Share (Lock) icon to specify sharing of data views with other users. Share users you Invite have access only to that project and its data views. Click ShareUI Config to restrict share users' ability to navigate or edit the view.

  • Click the Delete (trash can) icon to delete the project.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.