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 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.

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

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

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 Neo4j.

Create 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, click the + icon next to Create in the Your Projects area.

   

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

   

3. Click Confirm.
   The new project appears under Your Projects.

   

You can now:

• 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 on the project name to enter the project's graph space, which will be empty.

• Click the project's Enable Share/Disable Share (Lock) icon to enable sharing of data views with another user. Share users you Invite have access only to that project and the data views you share.
  You can also click ShareUI Config to restrict share users' ability to navigate or edit the view.

  

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

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, under Your Projects click the plus + icon next to Create.

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

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

   

   • Project Name: Descriptive name, (e.g., the name of the Neo4j database).
   • Neo4j DB 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 DB Username: DB user name
   • Neo4j DB 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.

4. 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 enable sharing of data views with another user. Share users you Invite have access only to that project and its data views.
  You can also click ShareUI Config to restrict share users' ability to navigate or edit the view.

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