diff --git a/modules/ROOT/images/empty-state.jpg b/modules/ROOT/images/empty-state.jpg new file mode 100644 index 000000000..77232692e Binary files /dev/null and b/modules/ROOT/images/empty-state.jpg differ diff --git a/modules/ROOT/pages/explore/explore-default-actions.adoc b/modules/ROOT/pages/explore/explore-default-actions.adoc index d0a87cd39..12791ef70 100644 --- a/modules/ROOT/pages/explore/explore-default-actions.adoc +++ b/modules/ROOT/pages/explore/explore-default-actions.adoc @@ -49,7 +49,7 @@ _Windows_: kbd:[Ctrl+Alt+A] | image:icon-fit-selection.png[width=25] | Fit to selection -| Zooms in and centers the selection on the canvas +| Zooms in and centers the selection on the scene | _Mac_: kbd:[⌘+F] _Windows_: kbd:[Ctrl+F] @@ -65,7 +65,7 @@ _Windows_: kbd:[Ctrl+E] | image:icon-expand-reveal.png[width=25] | Reveal | List/Detail view specific action. -Reveals all the selected nodes or relationships on the canvas. +Reveals all the selected nodes or relationships on the scene. | | {cross-mark} @@ -150,13 +150,13 @@ _Windows_: kbd:[Ctrl+⇧+S] | image:icon-jumpto.png[width=25] | Jump to node/relationship -| Zooms in and centers the desired node or relationship on the canvas +| Zooms in and centers the desired node or relationship on the scene | | {cross-mark} | | Select All -| Selects all properties and relationships on the canvas +| Selects all properties and relationships on the scene | _Mac_: kbd:[⌘+A] _Windows_: kbd:[Ctrl+A] diff --git a/modules/ROOT/pages/explore/explore-features/edit-graph-data.adoc b/modules/ROOT/pages/explore/explore-features/edit-graph-data.adoc index b5e920cd1..769dad93c 100644 --- a/modules/ROOT/pages/explore/explore-features/edit-graph-data.adoc +++ b/modules/ROOT/pages/explore/explore-features/edit-graph-data.adoc @@ -24,7 +24,7 @@ Relationship properties can also be edited in its respective Inspector. [.shadow] image::edit-properties.png[width=300] -* *Create new relationships* - New relationships can be created from the canvas directly. +* *Create new relationships* - New relationships can be created from the scene directly. To create a new relationship, select the source and destination nodes taking care to select the source node first. The right-click context menu will show the `Create relationship` enabled with a sub-menu showing the available relationship types. Only relationship types available in the database can be added. @@ -34,8 +34,8 @@ See the link:https://neo4j.com/docs/cypher-manual/current/constraints/[Cypher Ma [.shadow] image::create-relationship.png[width=300] -* *Create new nodes* - New nodes can also be created from the canvas. -To create an empty new node, use the canvas context menu and select an existing category to which the node should be assigned. +* *Create new nodes* - New nodes can also be created from the scene. +To create an empty new node, use the scene context menu and select an existing category to which the node should be assigned. Another option is to duplicate an existing node from its context menu. If you attempt to create a node of a particular label that has existence or uniqueness constraints for one or more properties, the Inspector shows which properties that require (unique) values before you can create the node. See the link:https://neo4j.com/docs/cypher-manual/current/constraints/[Cypher Manual -> Constraints] for more information on constraints. @@ -43,14 +43,14 @@ See the link:https://neo4j.com/docs/cypher-manual/current/constraints/[Cypher Ma [.shadow] image::create-node.png[width=300] -* *Delete a relationship* - A relationship can be deleted from the canvas as well. +* *Delete a relationship* - A relationship can be deleted from the scene as well. With the desired relationship selected, the context menu includes an option to delete the relationship. If more than one relationship is selected, you can delete the selection. [.shadow] image::delete-relationship.png[width=300] -* *Delete nodes* - Similarly, nodes can also be deleted directly from the canvas. +* *Delete nodes* - Similarly, nodes can also be deleted directly from the scene. The context menu for nodes allows you to delete selected node(s) in the same way as for relationships. [.shadow] @@ -64,6 +64,6 @@ See link:https://neo4j.com/docs/operations-manual/current/authentication-authori [WARNING] ==== -Deleting nodes and relationships from the canvas permanently deletes them from the database. +Deleting nodes and relationships from the scene permanently deletes them from the database. Be careful with this option as it cannot be undone. ==== diff --git a/modules/ROOT/pages/explore/explore-visual-tour/card-list.adoc b/modules/ROOT/pages/explore/explore-visual-tour/card-list.adoc index f4d0dc294..ac920c90a 100644 --- a/modules/ROOT/pages/explore/explore-visual-tour/card-list.adoc +++ b/modules/ROOT/pages/explore/explore-visual-tour/card-list.adoc @@ -3,7 +3,7 @@ [[card-list]] = Card list -The card list, when expanded, shows details about the currently shown nodes on the canvas. +The card list, when expanded, shows details about the currently shown nodes on the scene. You can choose between viewing all or only the selected nodes (if any). Each node appears as a little card which shows a few of the available properties on the node. The search bar in the card list lets you filter the card list further by typing a search and returning only the matching cards. @@ -12,8 +12,8 @@ The list can be even further refined by selecting _Nodes_ or _Relationships_ to [.shadow] image::card-list.png[width=700] -Cards in the list can be used to interact with nodes on the canvas. -Select one or more cards in the list to select them on canvas or vice versa. +Cards in the list can be used to interact with nodes on the scene. +Select one or more cards in the list to select them on scene or vice versa. Interact with the selected cards using shortcut actions like Expand or Dismiss that appear on the bottom of the list, or use the right-click context menu. Double-click on a card to see the Inspector, which shows its properties in detail. diff --git a/modules/ROOT/pages/explore/explore-visual-tour/scene-interactions.adoc b/modules/ROOT/pages/explore/explore-visual-tour/scene-interactions.adoc index 0cb8b17fb..e48d9c443 100644 --- a/modules/ROOT/pages/explore/explore-visual-tour/scene-interactions.adoc +++ b/modules/ROOT/pages/explore/explore-visual-tour/scene-interactions.adoc @@ -3,10 +3,18 @@ [[scene-interactions]] = Scene interactions -Several interactions are available from the canvas to help you explore your graph visualization. +When you first open a new Perspective and have no data visualized in your scene, you are greeted with two options to get started; *Show a graph snippet* or *Search the graph*. + +[.shadow] +image::empty-state.jpg[width=600] + +The first option returns a sample of your data and can help you get started with visualizing your database. +The second option takes you directly to the xref:explore/explore-visual-tour/search-bar.adoc[search bar] to start retrieving specific elements from your data. + +Once you have data in your scene, several interactions are readily available to help you explore your graph visualization. Some of the commonly expected ones are: -* Zoom in and out using your mouse or touchpad scroll functions, or use the buttons at the bottom right of the canvas. +* Zoom in and out using your mouse or touchpad scroll functions, or use the buttons at the bottom right of the scene. The size of the text on nodes is dynamic in relation to the size of the node. * Hover over a node or a relationship to see its label and selected properties. For nodes, but _not_ relationships, you can control what properties to display. @@ -20,14 +28,14 @@ image::hover.png[width=500] + * Left-click on a single node or relationship to select or deselect it. Multiple objects can be selected by holding the appropriate keyboard modifier key (Cmd or Ctrl key) before selecting. * Double-click on a node or relationship to open the Inspector to inspect the element’s details. -* Left-click in an empty spot on the canvas and drag immediately to pan the visualization. +* Left-click in an empty spot on the scene and drag immediately to pan the visualization. * Use the marquee tools to select multiple nodes and relationships. + [.shadow] image::marquee-tools.png[width=500] + -* Right-click anywhere on the canvas to bring up context-sensitive menus for the object(s) clicked on. -You can right-click on a single node or relationship, on a group of highlighted nodes and/or relationships, or on an empty spot on the canvas. +* Right-click anywhere on the scene to bring up context-sensitive menus for the object(s) clicked on. +You can right-click on a single node or relationship, on a group of highlighted nodes and/or relationships, or on an empty spot on the scene. + [.shadow] image::context-double.png[width=500] @@ -113,14 +121,14 @@ Explore searches for shortest paths within 20 hops and shows the first shortest In instances where you are interested in knowing more about _how_ various nodes are related in comparison to each other, Explore allows you to change the layout of your scene. By default, the nodes and relationships in a Scene are presented in a _force-based_ layout. -The _hierarchical_-layout option from the layout menu located at the bottom right-hand corner of the canvas, presents the nodes in the Scene in an hierarchical order instead. +The _hierarchical_-layout option from the layout menu located at the bottom right-hand corner of the scene, presents the nodes in the Scene in an hierarchical order instead. The nodes are then arranged by the directionality of their relationships, determined by the way relationship directions are set up in the database. When the hierarchical layout is activated, you can change the orientation with the edit-button directly to the right of the layout menu. [.shadow] image::layouts-hierarchy.png[width=800] -The third option is the _coordinate layout_ and it arranges, and fixes, the nodes on the canvas by their `integer`, `float`, or `point` type properties (provided that the nodes have them) and is used for geographical entities for example. +The third option is the _coordinate layout_ and it arranges, and fixes, the nodes on the scene by their `integer`, `float`, or `point` type properties (provided that the nodes have them) and is used for geographical entities for example. You can select which node property to use from the dropdown menu. If no property is selected for the x-axis, Explore automatically looks for any `point` property and if no such property exists, it looks for any property named _latitude_, then _lat_, and then _x_. @@ -147,7 +155,7 @@ It can be disabled via the edit-button. == Map -The map is located in the bottom right corner of the canvas and gives you an overview of the entire scene. +The map is located in the bottom right corner of the scene and gives you an overview of the entire scene. It helps you navigate, especially when your graph is large and/or when your nodes contain a lot of information and you often need to zoom in and out to view. The map shows all the nodes present in the scene, as well as the currently visible selection and where this selection is located in relation to the whole scene. diff --git a/modules/ROOT/pages/explore/explore-visual-tour/search-bar.adoc b/modules/ROOT/pages/explore/explore-visual-tour/search-bar.adoc index dd665a278..996eb2b02 100644 --- a/modules/ROOT/pages/explore/explore-visual-tour/search-bar.adoc +++ b/modules/ROOT/pages/explore/explore-visual-tour/search-bar.adoc @@ -69,16 +69,16 @@ See xref:explore/explore-features//full-text-search.adoc[Full-text search] tutor == Actions -Actions are phrases that trigger user-interface commands when typed in the search bar, e.g. `Clear Scene` will empty the canvas of the currently shown nodes and relationships. +Actions are phrases that trigger user-interface commands when typed in the search bar, e.g. `Clear Scene` will empty the scene of the currently shown nodes and relationships. This lists some of the available Actions: * Invert selection - selects every unselected node and deselects any selected node/s. -* Fit to selection - zooms in on the selection and centers it on the canvas. +* Fit to selection - zooms in on the selection and centers it on the scene. * Expand selection - option to see everything directly connected to the selected node/s. -* Clear Scene - empty the canvas. +* Clear Scene - empty the scene. * Dismiss - removes everything selected. * Dismiss others - removes everything not selected. -* Refresh Data - refreshes the data on the canvas. +* Refresh Data - refreshes the data on the scene. * Redo - repeat the latest action. * Undo - undo the latest action. diff --git a/modules/ROOT/pages/managing-instances/self-managed.adoc b/modules/ROOT/pages/managing-instances/self-managed.adoc index a97d1ab48..2fd331c41 100644 --- a/modules/ROOT/pages/managing-instances/self-managed.adoc +++ b/modules/ROOT/pages/managing-instances/self-managed.adoc @@ -11,7 +11,7 @@ There are two options to do this, either you register to: * Monitor your deployment, which allows you to also use the tools available in the console (Query, Explore, and Dashboards). * Only use the tools and not monitor. -Seee xref:fleet-management/overview.adoc[Fleet management] for more information about the monitoring functionality. +See xref:fleet-management/overview.adoc[Fleet management] for more information about the monitoring functionality. == Overview