From 7317ad2408a2c231f405f1cbdf2b39bd8581c821 Mon Sep 17 00:00:00 2001 From: Irina Loghin Date: Mon, 24 Nov 2025 18:36:32 +0000 Subject: [PATCH 1/2] added newlines at the end of question files --- asciidoc/courses/aura-dashboards/ad.adoc | 7 ++ asciidoc/courses/aura-dashboards/course.adoc | 29 +++-- .../lessons/1-what-are-dashboards/lesson.adoc | 79 ++++++------ .../questions/1-purpose.adoc | 12 +- .../2-accessing-aura-dashboards/lesson.adoc | 66 +++++++---- .../3-exploring-dashboards/lesson.adoc | 50 +------- .../modules/1-getting-started/module.adoc | 14 ++- .../lessons/1-describe-data-model/lesson.adoc | 8 +- .../lessons/2-build-with-ai/lesson.adoc | 8 +- .../lessons/1-first-card/lesson.adoc | 16 +-- .../2-visualise-aggregations/lesson.adoc | 10 +- .../modules/3-building-dashboards/module.adoc | 11 +- .../lessons/1-sharing/lesson.adoc | 59 ++++----- .../1-sharing/questions/1-choosing.adoc | 2 +- .../lessons/3-further-steps/lesson.adoc | 34 ++++-- .../modules/4-sharing-dashboards/module.adoc | 8 +- asciidoc/courses/aura-dashboards/summary.adoc | 112 +++++++++++------- 17 files changed, 284 insertions(+), 241 deletions(-) create mode 100644 asciidoc/courses/aura-dashboards/ad.adoc diff --git a/asciidoc/courses/aura-dashboards/ad.adoc b/asciidoc/courses/aura-dashboards/ad.adoc new file mode 100644 index 000000000..6bd7be219 --- /dev/null +++ b/asciidoc/courses/aura-dashboards/ad.adoc @@ -0,0 +1,7 @@ +:page-ad-icon: mortarboard +:page-ad-title: Building Dashboards in Neo4j +:page-ad-description: Enroll for free to learn how to create interactive dashboards and visualize graph data in Neo4j using AI and Cypher. +:page-ad-link: https://graphacademy.neo4j.com/courses/aura-dashboards/?ref=docs-ad-aura-dashboards +:page-ad-underline-role: button +:page-ad-underline: Enroll now + diff --git a/asciidoc/courses/aura-dashboards/course.adoc b/asciidoc/courses/aura-dashboards/course.adoc index 577a2d64f..1db36cd8a 100644 --- a/asciidoc/courses/aura-dashboards/course.adoc +++ b/asciidoc/courses/aura-dashboards/course.adoc @@ -1,16 +1,16 @@ -= Building Dashboards in Neo4j Aura += Building Dashboards in Neo4j :categories: administrator:1, beginners:5, foundation:1, aura:1 :status: draft :duration: 2 hours -:caption: Learn about data visualisation in Neo4j Aura. -:key-points: Aura dashboards, exploratory data analysis, data import and visualization, exploring relationships in data. +:caption: Learn about data visualization using Neo4j Dashboards. +:key-points: Neo4j dashboards, exploratory data analysis, data import and visualization, exploring relationships in data. -In this course you will learn about Aura Dashboards, a feature for visualising and exploring graph data directly within the Aura environment. -You will learn how to access Aura Dashboards, import and visualize data, create interactive dashboards using AI and Cypher queries, and share dashboards with others. +In this course you will learn about Neo4j Dashboards, a feature for visualizing and exploring graph data directly within Neo4j. +You will learn how to access Dashboards, import and visualize data, create interactive dashboards using AI and Cypher queries, and share dashboards with others. -You will explore the Aura Dashboards interface, learn about different visualization options for data representation, and discover the built-in tools for data exploration and visualization. +You will explore the Dashboards interface, learn about different visualization options for data representation, and discover the built-in tools for data exploration and visualization. -This course will prepare you to visualize and understand the Neo4j databases in the cloud with confidence. +This course will prepare you to visualize and understand Neo4j databases with confidence. While the examples use Neo4j Aura for ease of access, the same features are available in Neo4j Enterprise Edition on-premises. == Duration @@ -18,13 +18,20 @@ This course will prepare you to visualize and understand the Neo4j databases in == Prerequisites -Before starting this course, you should have a basic understanding of graph databases and basic knowledge on Neo4j. If you are new to Neo4j, you can familiarize yourself with the database with the link:/courses/neo4j-fundamentals/[Neo4j Fundamentals course^], the link:/courses/aura-fundamentals/[Aura Fundamentals course^] and the link:/courses/cypher-fundamentals/[Cypher Fundamentals course^]. +Before starting this course, you should have: + +* A basic understanding of graph databases and Neo4j +* Access to a Neo4j database - either: + ** Neo4j Aura (free tier available) - recommended for new users + ** Neo4j Enterprise Edition on-premises with Dashboards enabled + +If you are new to Neo4j, you can familiarize yourself with the database using the link:/courses/neo4j-fundamentals/[Neo4j Fundamentals course^], the link:/courses/aura-fundamentals/[Aura Fundamentals course^] and the link:/courses/cypher-fundamentals/[Cypher Fundamentals course^]. == What you will learn -* How to create dashboards in Neo4j Aura -* Understand how to structure Cypher queries to visualize graph data to explore relationships between data points -* How to make dashboards interactive +* How to create dashboards in Neo4j +* How to structure Cypher queries to visualize graph data and explore relationships +* How to make dashboards interactive with filters and parameters * How to share dashboards with others [.includes] diff --git a/asciidoc/courses/aura-dashboards/modules/1-getting-started/lessons/1-what-are-dashboards/lesson.adoc b/asciidoc/courses/aura-dashboards/modules/1-getting-started/lessons/1-what-are-dashboards/lesson.adoc index 7574a3592..e808a4181 100644 --- a/asciidoc/courses/aura-dashboards/modules/1-getting-started/lessons/1-what-are-dashboards/lesson.adoc +++ b/asciidoc/courses/aura-dashboards/modules/1-getting-started/lessons/1-what-are-dashboards/lesson.adoc @@ -1,26 +1,31 @@ -= Understanding Aura Dashboards += Understanding Neo4j Dashboards :type: lesson :order: 1 +// TODO: Consider restructuring this lesson to focus only on what dashboards are and when to use them. +// Currently includes course overview (lines 7-21) and prerequisites (lines 28-46) that could be moved to course.adoc. +// This would make the lesson more focused and under 5 minutes to read. + == Understanding Data Visualization -Welcome to the Visualizing Graph Data using Aura Dashboards Fundamentals course on GraphAcademy! +Welcome to the Building Dashboards in Neo4j course on GraphAcademy! Ever wondered how movie recommendation systems work, or how studios track which genres are trending? -Representing data in a visual format can help uncover patterns that might be missed otherwise. +Representing data in a visual format can help uncover patterns that might be missed otherwise. -* That's the power of graph databases and data visualization! +Data visualization transforms your graph into actionable insights that anyone can understand. -// Throughout this course, you will learn how to get started with Neo4j Aura Dashboards. +// TODO: These are course objectives, not lesson objectives. Consider adding lesson-specific objectives like: +// "In this lesson, you will learn: What Neo4j Dashboards are, When to use dashboards, How dashboards fit into your workflow" By the end of this course, you will be confident in: -* What are Aura Dashboards and when to use them. -* Accessing Aura Dashboards by importing our sample data. -* Creating interactive dashboards using our GenAI assistant and natural language. -* Building dashboard cards with Cypher queries. -* Adding filters to make dashboards dynamic. +* What Neo4j Dashboards are and when to use them +* Accessing Dashboards by importing sample data +* Creating interactive dashboards using the AI assistant and natural language +* Building dashboard cards with Cypher queries +* Adding filters to make dashboards dynamic // Aura provides a fully managed Neo4j database service, that allows you to run multiple instances in the cloud, while handling the underlying infrastructure, maintenance, and operations. // You can deploy Neo4j instances in the cloud and scale them as needed without the hassle of managing servers, backups, or updates. @@ -31,51 +36,54 @@ By the end of this course, you will be confident in: To follow along with this course, you will need: -* A Neo4j Aura account. If you don't have one, you can follow the step-by-step guide presented in the next lesson to create your account. -* Access to a Neo4j Aura instance. -* Basic understanding of Aura, graph databases, importing data (optional), data modeling, and Cypher query language (optional). +* Access to a Neo4j database with Dashboards enabled: + ** **Neo4j Aura** (recommended for this course) - Free tier available. If you don't have an account, the next lesson will guide you through creating one. + ** **Neo4j Enterprise Edition on-premises** - If you already have access to an on-premises installation with Dashboards enabled +* Basic understanding of graph databases (optional but helpful) +* Basic knowledge of Cypher query language (optional but helpful) -Also, if you are new to Neo4j, you can familiarize yourself with the database with the link:/courses/neo4j-fundamentals/[Neo4j Fundamentals course^]. +If you are new to Neo4j, you can familiarize yourself with the database using the link:/courses/neo4j-fundamentals/[Neo4j Fundamentals course^]. -It would be recommended to also check out: +Recommended additional courses: -* link:/courses/aura-fundamentals/[Aura Fundamentals^] +* link:/courses/aura-fundamentals/[Aura Fundamentals^] - If using Neo4j Aura * link:/courses/modeling-fundamentals/[Data Modeling Fundamentals^] * link:/courses/importing-fundamentals/[Importing Fundamentals^] * link:/courses/cypher-fundamentals/[Cypher Fundamentals^] -== Introducing Neo4j Aura Dashboards +== Introducing Neo4j Dashboards +Neo4j Dashboards is a visualization tool available in both Neo4j Aura and Neo4j Enterprise Edition on-premises. -Aura provides a fully managed Neo4j database service, which means you don't have to worry about the underlying infrastructure, maintenance, or operations. -// You can deploy Neo4j instances in the cloud and scale them as needed without the hassle of managing servers, backups, or updates. +Dashboards let you create interactive visualizations to explore your graph data and share insights with others. -In addition to the fully managed DBaaS (Database as a Service), you can also draw powerful dashboards to obtain insights from your graph data. +// TODO: Add informal spoken phrase here, e.g., "Think of it as a window into your graph - it turns nodes and relationships into charts anyone can understand." -For example, if you are running a streaming service, you might want to track metrics such as ratings per country, genre, and actors to understand user engagement and preferences: +For example, if you are running a streaming service, you might want to track metrics such as ratings per country, genre, and actors to understand user engagement and preferences. -The picture below shows a sample dashboard that visualizes movie data from the popular movie graph dataset, sorted by decade, represented as a line chart: - +The picture below shows a sample dashboard that visualizes movie data from the popular movie graph dataset, sorted by decade, represented as a line chart: image::images/movies-by-decade.png[Movies by Decade Dashboard,width=600,align=center] - - -To do this, you can use natural language to ask questions about your data, and Aura Dashboards will generate the necessary visualisations for you. -Writing Cypher queries is not required, although you can use them if you prefer. +To do this, you can use natural language to ask questions about your data, and Neo4j Dashboards will generate the necessary visualizations for you. +Writing Cypher queries is not required, although you can use them if you prefer for more advanced customizations. Use dashboards when you need: -* Visual representation of patterns and trends. -* Real-time data monitoring vs. static reports comparisons. -* Different stakeholders perspectives on the same data. -* Easy sharing of insights across teams. -* Interactive exploration of data without writing code. +* Visual representation of patterns and trends +* Real-time data monitoring vs. static reports comparisons +* Different stakeholders' perspectives on the same data +* Easy sharing of insights across teams +* Interactive exploration of data without writing code -You do not need to set up any additional infrastructure or tools, as Aura Dashboards are built on top of the Neo4j database service. +// TODO: Add concrete example from course context. E.g., "For example, in the movie dataset you'll work with, +// you might create a dashboard showing: top-rated films by decade (line chart), genre distribution (pie chart), +// and actor collaboration networks (graph visualization)." + +You do not need to set up any additional infrastructure or tools, as Dashboards are integrated directly into Neo4j. In this course, you will learn how to build dashboards similar to the one below: @@ -97,6 +105,7 @@ include::questions/1-purpose.adoc[leveloffset=+1] [.summary] == Summary -In this lesson, you learned what are the Neo4j Aura Dashboards and the benefits of using them for data visualisation and exploration. -In the next lesson, you will learn how to access Aura Dashboards, including creating an Aura account, selecting the appropriate tier, and navigating the Dashboards UI. +In this lesson, you learned what Neo4j Dashboards are and the benefits of using them for data visualization and exploration. + +In the next lesson, you will learn how to access Dashboards. If you're using Neo4j Aura, you'll learn how to create an account and navigate the interface. If you're using on-premises Neo4j, you'll learn how to access the Dashboards feature. diff --git a/asciidoc/courses/aura-dashboards/modules/1-getting-started/lessons/1-what-are-dashboards/questions/1-purpose.adoc b/asciidoc/courses/aura-dashboards/modules/1-getting-started/lessons/1-what-are-dashboards/questions/1-purpose.adoc index e2fa66d83..a36c45eb7 100644 --- a/asciidoc/courses/aura-dashboards/modules/1-getting-started/lessons/1-what-are-dashboards/questions/1-purpose.adoc +++ b/asciidoc/courses/aura-dashboards/modules/1-getting-started/lessons/1-what-are-dashboards/questions/1-purpose.adoc @@ -1,11 +1,11 @@ [.question] -= Purpose of Aura Dashboards += Purpose of Neo4j Dashboards -Which of the following statements best describes the purpose of Aura's integrated dashboard tool? +Which of the following statements best describes the purpose of Neo4j's integrated dashboard tool? -* [x] The integrated dashboard tool aims to provide a visual interface for exploring data insights directly within the Neo4j Aura environment without having to write Cypher queries. +* [x] The integrated dashboard tool provides a visual interface for exploring data insights directly within Neo4j without having to write Cypher queries. * [ ] The integrated dashboard tool is designed for database administrators to manage user roles and permissions. -* [ ] The integrated dashboard tool is primarily used for importing large datasets into the Neo4j Aura database. +* [ ] The integrated dashboard tool is primarily used for importing large datasets into Neo4j. [TIP,role=hint] @@ -17,5 +17,7 @@ Think about the main goal of dashboards in data visualization and exploration. [TIP,role=solution] .Solution ==== -The integrated dashboard tool aims to provide a visual interface for exploring data insights directly within the Neo4j Aura environment without having to write Cypher queries. +**The integrated dashboard tool provides a visual interface for exploring data insights directly within Neo4j without having to write Cypher queries.** + +This is the primary purpose - dashboards help you visualize and explore data without needing to write Cypher queries, though you can use Cypher for more advanced visualizations if needed. ==== diff --git a/asciidoc/courses/aura-dashboards/modules/1-getting-started/lessons/2-accessing-aura-dashboards/lesson.adoc b/asciidoc/courses/aura-dashboards/modules/1-getting-started/lessons/2-accessing-aura-dashboards/lesson.adoc index 4504f8e76..d37125a0b 100644 --- a/asciidoc/courses/aura-dashboards/modules/1-getting-started/lessons/2-accessing-aura-dashboards/lesson.adoc +++ b/asciidoc/courses/aura-dashboards/modules/1-getting-started/lessons/2-accessing-aura-dashboards/lesson.adoc @@ -1,21 +1,28 @@ -= Accessing Aura Dashboards += Accessing Neo4j Dashboards :type: lesson :order: 2 == Lesson Overview -In the previous lesson, you learned about the purpose of Neo4j Aura Dashboards and the benefits of using them for data visualization. -In this lesson, you will learn how to access Aura Dashboards, including creating an Aura account, selecting the appropriate tier, and navigating the Dashboards UI. +In the previous lesson, you learned about the purpose of Neo4j Dashboards and the benefits of using them for data visualization. + +In this lesson, you will learn how to access Dashboards. For ease of access in this course, we'll use Neo4j Aura. If you already have access to an on-premises Neo4j Enterprise Edition installation with Dashboards enabled, you can skip to **Step 4** and connect to your database. -== Getting Access to Aura Dashboards +== Getting Access to Dashboards + +To follow along with this course, you have two options: -To explore the Dashboards UI, you need an Aura account, and an instance to connect to. +* **Neo4j Aura** (recommended for this course) - Free tier available, quick setup +* **Neo4j Enterprise Edition on-premises** - If you already have access -Create an account and an instance by following these instructions: +The rest of this lesson focuses on setting up Neo4j Aura. If you're using on-premises, skip to **Step 4** to learn how to connect. -If you already have an Aura account and an instance, you can skip to **Step 4.** +[NOTE] +==== +If you already have a Neo4j Aura account and instance, you can skip to **Step 4.** +==== == Step 1: Visit the Neo4j Aura Website @@ -51,40 +58,54 @@ image::images/4-sign-up-email.png[Sign up page prompting to create a password] (Optional) Once you have an account, *create a new Aura instance* by selecting the desired tier (Free, Professional, Business Critical, or Virtual Dedicated Cloud) based on your requirements. -In this course, you will only need the **Free tier** to explore and learn about Aura Dashboards. +In this course, you will only need the **Free tier** to explore and learn about Neo4j Dashboards. image::images/4-free-instance-select.png[Create Aura instance page showing the different tiers available] -== Dashboard allocation per tier -In Aura Dashboards, you have access to different types of layouts to visualize your graph data effectively. The main types of layouts available are: -In Aura Dashboards, you have access to different types of layouts to visualise your graph data effectively. The main types of layouts available are: +== Dashboard page limits -* Free tier: 3 dashboard pages available. If you have already created a free tier instance, you can access upgrade at any time to access more dashboards. +The number of dashboard pages you can create depends on your platform: -image::images/free-tier-dashboards.png[Free tier dashboards,width=600,align=center] +**For Neo4j Aura users:** -* Professional, Enterprise and Visual Dedicated Cloud: 25 dashboard pages available. +* **Free tier:** 3 dashboard pages available. You can upgrade at any time to access more dashboards. +image::images/free-tier-dashboards.png[Free tier dashboards,width=600,align=center] + +* **Professional, Business Critical, and Virtual Dedicated Cloud:** 25 dashboard pages available. image::images/ee-dashboards.png[Enterprise tier dashboards,width=600,align=center] +**For on-premises Enterprise Edition users:** + +* Dashboard page limits depend on your license agreement. Consult your Neo4j representative for details. -== Step 4: Connect to an instance -. *Log in* to your Aura instance, and go to the *Dashboards* menu. From there, you can create new dashboards, access existing ones, and manage your dashboard settings. -. *Connect to your instance* by selecting it from the list of available instances. You can either connect to an Aura instance, or to a local Neo4j database if you have one, by entering the connection details. For more information, see link:https://neo4j.com/docs/aura//connecting-applications/overview/[Connecting Applications documentation^]. -. *Connect to your instance* by selecting it from the list of available instances. You can either connect to an Aura instance, or to a local Neo4j database if you have one, by entering the connection details. For more information, see link:https://neo4j.com/docs/aura/classic/auradb/connecting-applications/overview/[Connecting Applications documentation^]. +== Step 4: Connect to Dashboards +=== For Neo4j Aura users: + +. *Log in* to your Aura account and go to the *Dashboards* menu. From there, you can create new dashboards, access existing ones, and manage your dashboard settings. +. *Connect to your instance* by selecting it from the list of available instances. image::images/dashboards-ui.png[Dashboards UI,width=600,align=center] -After you click on **Connect to instance**, you will be prompted to enter the connection details, for either Aura or a Self managed database. In this course, you will connect to your Aura instance for simplicity: +After you click on **Connect to instance**, you will be prompted to enter the connection details: image::images/connect-from-dashboards.png[Connect to instance dialog,width=600,align=center] +You can find your Aura instance connection details by clicking the **...** menu next to your instance name and selecting **Inspect**, or by using the downloaded connection details file. + +For more information, see link:https://neo4j.com/docs/aura/auradb/connecting-applications/[Connecting Applications documentation^]. + +=== For on-premises users: -You can find the connection details of your Aura instance by clicking on the **...** menu next to your instance name, and selecting **Inspect**, or by using the downloaded connection details file. +. Access Dashboards through your Neo4j Enterprise Edition installation +. Navigate to the Dashboards interface +. Connect using your local database credentials + +The Dashboards interface and features work identically in both Aura and on-premises installations. @@ -99,6 +120,7 @@ include::questions/2-empty-dashboards-canvas.adoc[leveloffset=+1] [.summary] == Summary -In this lesson, you learned how to access Aura Dashboards, including creating an Aura account, selecting the appropriate tier, and navigating the Dashboards UI. -In the next lesson, you will learn how to load data into your Aura instance and generate a demo dashboard using AI. +In this lesson, you learned how to access Neo4j Dashboards. For Aura users, you learned how to create an account, select a tier, and navigate the interface. For on-premises users, you learned how to access Dashboards through your Enterprise Edition installation. + +In the next lesson, you will learn how to load data into your Neo4j database and generate a demo dashboard using AI. diff --git a/asciidoc/courses/aura-dashboards/modules/1-getting-started/lessons/3-exploring-dashboards/lesson.adoc b/asciidoc/courses/aura-dashboards/modules/1-getting-started/lessons/3-exploring-dashboards/lesson.adoc index 88243c116..d4c209143 100644 --- a/asciidoc/courses/aura-dashboards/modules/1-getting-started/lessons/3-exploring-dashboards/lesson.adoc +++ b/asciidoc/courses/aura-dashboards/modules/1-getting-started/lessons/3-exploring-dashboards/lesson.adoc @@ -38,12 +38,12 @@ image::images/clear-model.png[The clear all option in the data importer menu '.. Any data import you run will be against the connected Neo4j database. === Step 2: Navigate to the Query Editor -image::images/query-menu.png[The query menu in the Aura console] + After connecting to your Aura instance, you will need to navigate to the Query Editor in order to load data using Cypher. At this point, you do not need to understand Cypher in detail; you will only run the script that loads the data. -image::images/query-menu.png[The query menu in the Aura Console] +image::images/query-menu.png[The query menu in the Aura Console,width=600,align=center] === Step 3: Import the Movies Recommendation dataset @@ -72,43 +72,6 @@ Go to the Explore tab to visualize and explore the data you have just loaded: image::images/explore-check.png[The Explore tab showing the loaded data graph] -//TO-DO: Use this content later when we have cloud import credential rotation available - -// == Importing data from cloud - -// Importing data from cloud storage services is a convenient way to manage large datasets, and to ensure data security and accessibility. - -// When you go to the Import menu, you will see an option to add a new data source: - - -// image::images/import-menu.png[The data source importing UI] - -// In this example, you will learn how to import data from an S3 bucket. If you have other cloud storage services, the steps are similar: - -// * Set up access credentials: You might need to create an access key and secret key to authenticate your access to the cloud storage service. If you are using AWS S3, you can create an IAM user with the necessary permissions to access the S3 bucket. -// * Configure the data source in Data Importer: In the Data Importer interface, select the option to add a new data source and choose the cloud storage service you are using. - - -// image::images/new-data-source.png[The data source importing options] - - -// * You will need to provide the access credentials and the path to the data files, and make sure the bucket and files are accessible from Data Importer. - -// To import data from an S3 bucket, you will need to provide the following information: - -// * Access Key: Your AWS access key ID. -// * Secret Key: Your AWS secret access key. - -// image:://images/import-aws.png[The AWS S3 import configuration dialog] - -// * Bucket Name: The name of the S3 bucket containing the data files. -// * File Path: The path to the data files within the S3 bucket. - - - -If this is your first time using Dashboards, you will see an empty state with options to **Create with AI**, **Create from scratch**, or **Import**. You do not need to use the dropdown menu in this case. -// image:://images/import-aws-2.png[The AWS S3 import configuration dialog continued] - == Generating a demo dashboard using AI @@ -116,15 +79,12 @@ Once you have successfully loaded the data into your Aura instance, you can gene You will learn more about creating and managing dashboards in the next lessons, but for now, let's see how to quickly generate a dashboard using AI. -Prior to using the AI tool, ensure that you have read the AI disclaimer available in the Aura Dashboards interface: +Prior to using the AI tool, ensure that you have read the AI disclaimer available in the Dashboards interface: image::images/genai-disclaimer.png[AI disclaimer dialog,width=600,align=center] From the Dashboards menu, click on the **Create dashboard** dropdown, and select **Create with AI**. -Use the graph visualization to explore the relationships between users, movies, and genres interactively: - - In the prompt dialog, enter a description of the insights you want to visualize. For example, you can enter a description like "Visualize movie recommendations based on user ratings and genres.", or simply "Comedy movies": image::images/create-with-ai-prompt.png[Create dashboard with AI prompt,width=600,align=center] @@ -136,7 +96,7 @@ image::images/ai-dashboard.png[AI generated dashboard,width=600,align=center] In this dashboard, you can see various visualizations such as single values, bar charts, pie charts, and graph visualizations that provide insights into movie recommendations based on user ratings and genres. You will learn more about each type of chart in the following lessons. -Use the graph visualisation to explore the relationships between users, movies, and genres interactively: +Use the graph visualization to explore the relationships between users, movies, and genres interactively: image::images/ai-generated-graph.png[AI generated graph visualization,width=600,align=center] @@ -157,6 +117,6 @@ include::questions/2-empty-dashboards-canvas.adoc[leveloffset=+1] [.summary] == Summary -In this lesson, you learned how to load data into your Aura instance using a Cypher script and generate a demo dashboard using the AI tool. +In this lesson, you learned how to load data into your Neo4j database using a Cypher script and generate a demo dashboard using the AI tool. In the next lesson, you will learn how to describe your movie data model and design dashboards that align with stakeholder requirements. diff --git a/asciidoc/courses/aura-dashboards/modules/1-getting-started/module.adoc b/asciidoc/courses/aura-dashboards/modules/1-getting-started/module.adoc index ce80f6dfa..ada43db82 100644 --- a/asciidoc/courses/aura-dashboards/modules/1-getting-started/module.adoc +++ b/asciidoc/courses/aura-dashboards/modules/1-getting-started/module.adoc @@ -1,15 +1,19 @@ -= Introduction to Neo4j Aura Dashboards += Introduction to Neo4j Dashboards :order: 1 == Module Overview -This module explains the key concepts of Neo4j Aura Dashboards, including its benefits, use cases, and how it simplifies visualising graph data in the cloud. +This module explains the key concepts of Neo4j Dashboards, including its benefits, use cases, and how it simplifies visualizing graph data. You will learn how to: -* Import your data into Neo4j Aura. -* Explore relationships and patterns in your data. -* Generate insights from graph data using our AI assistant. +* Import your data into Neo4j +* Explore relationships and patterns in your data +* Generate insights from graph data using the AI assistant +[NOTE] +==== +This course uses Neo4j Aura for demonstrations, but all features work identically in on-premises Neo4j Enterprise Edition. +==== link:./1-what-are-dashboards/[Ready? Let's go →, role=btn] diff --git a/asciidoc/courses/aura-dashboards/modules/2-understand-your-data/lessons/1-describe-data-model/lesson.adoc b/asciidoc/courses/aura-dashboards/modules/2-understand-your-data/lessons/1-describe-data-model/lesson.adoc index dad176f62..3f1dc5807 100644 --- a/asciidoc/courses/aura-dashboards/modules/2-understand-your-data/lessons/1-describe-data-model/lesson.adoc +++ b/asciidoc/courses/aura-dashboards/modules/2-understand-your-data/lessons/1-describe-data-model/lesson.adoc @@ -44,9 +44,9 @@ For example, the following structure can be used to describe the movie project: ** Director: name, birthdate -This can be also found in the graph model generated after you have imported the movie dataset into your Aura instance: +This can be also found in the graph model generated after you have imported the movie dataset into your Neo4j database: -(Navigate to Imported Data > Graph Model in the Aura Dashboards console to view the graph model.) +(Navigate to Imported Data > Graph Model in the Dashboards interface to view the graph model.) image::images/movies-model.png[Movie Graph Model,width=600,align=center] @@ -54,7 +54,7 @@ image::images/movies-model.png[Movie Graph Model,width=600,align=center] **Challenge**: -You have been given a movie dataset and need to describe its data model. In your Aura instance, identify the key entities, relationships, and properties that define the structure of the movie project. +You have been given a movie dataset and need to describe its data model. In your Neo4j database, identify the key entities, relationships, and properties that define the structure of the movie project. After analyzing the dataset, you should be able to build a dashboard for a streaming service executive: @@ -129,4 +129,4 @@ include::questions/1-structure.adoc[leveloffset=+1] == Summary In this lesson, you learned about the graph project requirements and how to describe the key entities, relationships, and properties in your graph data. -In the next lesson, you will create your in-depth dashboard and configure it for your business needs in Neo4j Aura. +In the next lesson, you will create your in-depth dashboard and configure it for your business needs in Neo4j. diff --git a/asciidoc/courses/aura-dashboards/modules/2-understand-your-data/lessons/2-build-with-ai/lesson.adoc b/asciidoc/courses/aura-dashboards/modules/2-understand-your-data/lessons/2-build-with-ai/lesson.adoc index f451f32d6..fe46eb824 100644 --- a/asciidoc/courses/aura-dashboards/modules/2-understand-your-data/lessons/2-build-with-ai/lesson.adoc +++ b/asciidoc/courses/aura-dashboards/modules/2-understand-your-data/lessons/2-build-with-ai/lesson.adoc @@ -8,7 +8,7 @@ In the previous lessons, you learned how to execute Cypher queries using the Que In this lesson, you will learn how to: -* Create interactive dashboards using Aura's integrated dashboard tool +* Create interactive dashboards using Neo4j's integrated dashboard tool * Build dashboard cards using natural language AI prompts * Add filters to make dashboards dynamic @@ -20,13 +20,13 @@ A dashboard tool transforms raw data into visual representations that anyone can Think of dashboards as the "storefront window" for your graph data - they display the most important insights in an accessible, visual format that business users can interact with without writing code. -In Aura Dashboards, you have access to an integrated AI tool that allows you to quickly prototype and build production-ready dashboards. +In Neo4j Dashboards, you have access to an integrated AI tool that allows you to quickly prototype and build production-ready dashboards. == Creating your first dashboard You will learn how to build a dashboard that visualizes actor relationships in the movie database. -First, navigate to the Dashboards tool in your Aura console: +First, navigate to the Dashboards tool in your Neo4j interface: image::images/connect-from-dashboards.png[dashboard_connect,width=500,align=center] @@ -164,6 +164,6 @@ include::questions/1-dashboards-canvas.adoc[leveloffset=+1] [.summary] == Summary -In this lesson, you learned how to create interactive dashboards in Aura, build dashboard cards with natural language AI prompts, and add filters to make your dashboards dynamic and user-friendly. +In this lesson, you learned how to create interactive dashboards in Neo4j, build dashboard cards with natural language AI prompts, and add filters to make your dashboards dynamic and user-friendly. In the next lesson, you will learn how to create your first dashboard card using Cypher queries. diff --git a/asciidoc/courses/aura-dashboards/modules/3-building-dashboards/lessons/1-first-card/lesson.adoc b/asciidoc/courses/aura-dashboards/modules/3-building-dashboards/lessons/1-first-card/lesson.adoc index b2f12c7d2..d8c979d3e 100644 --- a/asciidoc/courses/aura-dashboards/modules/3-building-dashboards/lessons/1-first-card/lesson.adoc +++ b/asciidoc/courses/aura-dashboards/modules/3-building-dashboards/lessons/1-first-card/lesson.adoc @@ -2,11 +2,11 @@ :type: lesson :order: 1 -In this lesson, you will learn how to create your first card in Neo4j Aura Dashboards, using the natural language AI assistant or by writing Cypher queries. +In this lesson, you will learn how to create your first card in Neo4j Dashboards, using the natural language AI assistant or by writing Cypher queries. You will learn how to: -* Connect to your Aura instance using the integrated Query tool. +* Connect to your Neo4j database using the integrated Query tool * Create a new dashboard page. * Create your first card using a Cypher query. @@ -15,17 +15,17 @@ Optionally, you can dive into writing Cypher queries to fetch and visualize data == Connecting -Before you start, make sure you have completed the previous lesson and imported the sample data into your Aura instance. -NOTE: The sample data should be _loaded_ into your Aura instance using the provided Cypher script, not the Import service. +Before you start, make sure you have completed the previous lesson and imported the sample data into your Neo4j database. +NOTE: The sample data should be _loaded_ into your database using the provided Cypher script, not the Import service. -If you haven't done that yet, go back to lesson 2 - Accessing Aura Dashboards and follow the steps to import the data. +If you haven't done that yet, go back to lesson 2 - Accessing Dashboards and follow the steps to import the data. -Open the Aura console and select the instance you want to connect to. Make a note of the number of nodes and relationships in the database, as you might need to create advanced filters to work with larger datasets. +Open your Dashboards interface and select the database you want to connect to. Make a note of the number of nodes and relationships in the database, as you might need to create advanced filters to work with larger datasets. image::images/02_query_tool_connect.jpg[querytool_connect,width=500,align=center] -You can also connect to the instance directly from the Aura console by adding the credentials in the connection dialog: +You can also connect to the instance directly from your Dashboards interface by adding the credentials in the connection dialog: image::images/connect-instance-ui.png[Connect to instance dialog,width=600,align=center] @@ -131,6 +131,6 @@ include::questions/1-purpose.adoc[leveloffset=+1] == Summary TIP: -In this lesson you learned how to use the integrated Query tool in the Aura console to connect to your database instance, execute Cypher queries, and visualize the results. +In this lesson you learned how to use the integrated Query tool in the Dashboards interface to connect to your database, execute Cypher queries, and visualize the results. In the next lesson, you will learn a different way to explore your data by analysing aggregated metrics. diff --git a/asciidoc/courses/aura-dashboards/modules/3-building-dashboards/lessons/2-visualise-aggregations/lesson.adoc b/asciidoc/courses/aura-dashboards/modules/3-building-dashboards/lessons/2-visualise-aggregations/lesson.adoc index 8839ebe41..0820fef39 100644 --- a/asciidoc/courses/aura-dashboards/modules/3-building-dashboards/lessons/2-visualise-aggregations/lesson.adoc +++ b/asciidoc/courses/aura-dashboards/modules/3-building-dashboards/lessons/2-visualise-aggregations/lesson.adoc @@ -6,7 +6,7 @@ In the previous lesson, you learned how to visualize data in an Aura database. In this lesson, you will learn how to: -* Connect to your Aura instance using the integrated Explore tool. +* Connect to your Neo4j database using the integrated Explore tool * Compare different ways to visualize aggregated metrics. * Visualize your aggregated data without using our GenAI tools. * Write Cypher queries to explore your data. @@ -18,7 +18,7 @@ The **Explore** tool is a powerful interface for visualizing and exploring your == Connecting -From the Aura console, either go to **Instances** and select the instance you want to connect to and use the **Connect** dropdown and select **Explore**, or directly to **Explore** and use the Connect button from there. +From your Dashboards interface, either go to **Instances** and select the database you want to connect to and use the **Connect** dropdown and select **Explore**, or go directly to **Explore** and use the Connect button from there. image::images/03_explore_tool_connect.jpg[exploretool_connect,width=500,align=center] @@ -64,7 +64,7 @@ image::images/03_explore_tool_styling.jpg[exploretool_styling,width=500,align=ce == Visualizing the data -There are multiple visualization types available in Aura Dashboards, each suited for different data representation needs. +There are multiple visualization types available in Neo4j Dashboards, each suited for different data representation needs. From the card editor, select the dropdown menu under **Visualization type** to choose the most appropriate visualization for your data: @@ -190,7 +190,7 @@ You should obtain something similar to this: image::images/single-card.png[Single Value card example,width=600,align=center] -If you have obtained a different value, don't worry! The data in your Aura instance may vary based on other activities you have performed. +If you have obtained a different value, don't worry! The data in your database may vary based on other activities you have performed. === Text card @@ -270,7 +270,7 @@ image::images/text-card-matrix-part2.png[text card example part 2,width=600,alig === Visualising aggregated data -You have now seen multiple ways to visualize aggregated data using different card types in Aura Dashboards. +You have now seen multiple ways to visualize aggregated data using different card types in Neo4j Dashboards. When working with aggregated data, it's important to choose the right visualization type that effectively communicates the insights you want to convey. Consider the following factors when selecting a card type: diff --git a/asciidoc/courses/aura-dashboards/modules/3-building-dashboards/module.adoc b/asciidoc/courses/aura-dashboards/modules/3-building-dashboards/module.adoc index 440f6f901..12f414834 100644 --- a/asciidoc/courses/aura-dashboards/modules/3-building-dashboards/module.adoc +++ b/asciidoc/courses/aura-dashboards/modules/3-building-dashboards/module.adoc @@ -4,15 +4,14 @@ == Module Overview - -In this module, you will learn how to create and customise complex dashboards in Aura. -You will explore the various tools and features available to build insightful visualisations that help you understand your graph data better. +In this module, you will learn how to create and customize complex dashboards in Neo4j. +You will explore the various tools and features available to build insightful visualizations that help you understand your graph data better. You will learn how to: -* Create dashboard cards to visualise data using natural language prompts and Cypher queries. -* Customize dashboard layouts for better data representation. -* Visualise aggregated metrics to gain insights from your data. +* Create dashboard cards to visualize data using natural language prompts and Cypher queries +* Customize dashboard layouts for better data representation +* Visualize aggregated metrics to gain insights from your data By the end of this module, you will have a comprehensive movie dashboard that provides stakeholders with valuable insights into movie data. diff --git a/asciidoc/courses/aura-dashboards/modules/4-sharing-dashboards/lessons/1-sharing/lesson.adoc b/asciidoc/courses/aura-dashboards/modules/4-sharing-dashboards/lessons/1-sharing/lesson.adoc index 2ceb66612..9ca3fcd64 100644 --- a/asciidoc/courses/aura-dashboards/modules/4-sharing-dashboards/lessons/1-sharing/lesson.adoc +++ b/asciidoc/courses/aura-dashboards/modules/4-sharing-dashboards/lessons/1-sharing/lesson.adoc @@ -2,23 +2,28 @@ :type: lesson :order: 1 -In the previous lessons, you learned how to create interactive dashboards in Aura using AI and Cypher queries. +In the previous lessons, you learned how to create interactive dashboards in Neo4j using AI and Cypher queries. -In this lesson, you will learn how to: +In this lesson, you will learn how to share dashboards with others. The specific steps vary depending on whether you're using Neo4j Aura or on-premises Enterprise Edition. -* Share dashboards with specific users. -* Enable access to dashboards to everyone in your project. +**For Neo4j Aura users:** +* Share dashboards with specific users +* Enable project-level access for all team members +**For on-premises users:** -== Sharing your dashboards +* Share dashboards based on your Neo4j user management system +* Consult your database administrator for user access procedures -Once you have created a dashboard, you can share it with others to collaborate and get feedback. +[NOTE] +==== +The examples in this lesson focus on Neo4j Aura's sharing features. If you're using on-premises Enterprise Edition, work with your database administrator to manage dashboard access using your organization's user management system. +==== -To share a dashboard, you can: +== Sharing your dashboards -* Invite users: Add specific users to your project so they can access your dashboards -* Set project level access: everyone in the project can access the dashboards +Once you have created a dashboard, you can share it with others to collaborate and get feedback. == Inviting users to your project @@ -30,35 +35,23 @@ First, make sure the users you want to share it with are added as PROJECT_VIEWER image::images/invite-project-viewer.png[project viewer added,width=600,align=center] -To do this, Navigate to Organisation>Project settings > Users, and click on the **Invite Users** button. - To invite users to your project so they can access your dashboards, follow these steps: -1. Go to the **Project Settings** page in the Aura console -2. Click on the **Users** menu - -image::images/1-users.png[Project menu open, users is selected] - -[start=3] -. Click on the **Invite Users** button - -image::images/1-invite-users-1.png[Project users menu with the invite users button highlighted] - -[start=4] -. Enter the email addresses of the users you want to invite +1. Click on the **Invite Users** button in the **Project Settings** page. +2. Enter the email addresses of the users you want to invite image::images/1-invite-users-2.png[Email address added to the invite users field] [start=5] -. Select the appropriate roles for the invited users +. Select the appropriate roles for the invited users. image::images/1-users-roles.png[Project role drop down showing the different roles available] [start=6] -. Click **Send Invites** to send the invitations +. Click **Send Invites** to send the invitations. [start=7] -. To review the full list of your project users, go to the **Users** menu in the **Project Settings** page, where you can see their roles and statuses +. To review the full list of your project users, go to the **Users** menu in the **Project Settings** page, where you can see their roles and statuses. image::images/1-project-viewer.png[Projects users screen showing the new user added] @@ -82,15 +75,15 @@ When you create a new database instance, you will be supplied with a separate se ==== -== Sharing dashboads via email invitation +== Sharing dashboards via email invitation -Confirm that the users you invited have accepted the invitation to join your project, and have a VIEWER role. +Confirm that the users you invited have accepted the invitation to join your project, and have a PROJECT_VIEWER role. -Once you have confirmed that the users have access to your project, you can share the dashboard with them by sending an email invitation: +Once you have confirmed that the users have access to your project, you can share the dashboard with them by adding their email address to the *Shared with* field in the dashboard settings. image::images/invite-dashboard-viewer.png[invite dashboard viewer,width=600,align=center] -After clicking the **Invite** button, the users will receive an email invitation to access the dashboard, and will be able to view all your pages created in that dashboard. +After clicking the **Invite** button, the users will be able to access the dashboard, as well as will be able to view all your pages created in that dashboard. image::images/invite-dashboard-viewer-part2.png[invite dashboard viewer,width=600,align=center] @@ -98,7 +91,7 @@ image::images/invite-dashboard-viewer-part2.png[invite dashboard viewer,width=60 == Setting general project access -If you want everyone in your project to have access to the dashboards, you can set the project level access: +If you want everyone in your project to have access to the dashboards, you can set the project level access: image::images/dashboards-access-settings.png[dashboard viewer access confirmed,width=600,align=center] @@ -115,6 +108,6 @@ include::questions/1-choosing.adoc[leveloffset=+1] [.summary] == Summary -In this lesson, you learned how to share dashboards with others by inviting users to your project and dashboards as VIEWERS. You also learned about different user roles and their permissions. +In this lesson, you learned how to share dashboards with others by inviting users to your project and dashboards as *Project Viewers*. You also learned about different user roles and their permissions. -In the next lesson, you will learn about additional resources and next steps to continue your learning journey with Neo4j Aura Dashboards. +In the next lesson, you will learn about additional resources and next steps to continue your learning journey with Neo4j Dashboards. diff --git a/asciidoc/courses/aura-dashboards/modules/4-sharing-dashboards/lessons/1-sharing/questions/1-choosing.adoc b/asciidoc/courses/aura-dashboards/modules/4-sharing-dashboards/lessons/1-sharing/questions/1-choosing.adoc index 465bccbb8..f217706b2 100644 --- a/asciidoc/courses/aura-dashboards/modules/4-sharing-dashboards/lessons/1-sharing/questions/1-choosing.adoc +++ b/asciidoc/courses/aura-dashboards/modules/4-sharing-dashboards/lessons/1-sharing/questions/1-choosing.adoc @@ -2,7 +2,7 @@ = Making the Right Choice -You have a team of stakeholders and marketing analysts who need to view dashboards to plan further actions based on the insights derived from the data. However, they should not have the ability to modify the dashboards or access the database directly. +You have a team of stakeholders and marketing analysts who need to view dashboards to plan further actions based on the insights derived from the data. However, they should not have the ability to modify the dashboards or access the database directly. Which role should you assign to these users to ensure they have the appropriate level of access? diff --git a/asciidoc/courses/aura-dashboards/modules/4-sharing-dashboards/lessons/3-further-steps/lesson.adoc b/asciidoc/courses/aura-dashboards/modules/4-sharing-dashboards/lessons/3-further-steps/lesson.adoc index 5805be525..b22905079 100644 --- a/asciidoc/courses/aura-dashboards/modules/4-sharing-dashboards/lessons/3-further-steps/lesson.adoc +++ b/asciidoc/courses/aura-dashboards/modules/4-sharing-dashboards/lessons/3-further-steps/lesson.adoc @@ -2,9 +2,9 @@ :type: lesson :order: 3 -In the previous lessons, you learned how to manage your Aura instances and users. +In the previous lessons, you learned how to create, customize, and share dashboards. -In this section, you will learn about additional resources and next steps to continue your journey with Neo4j Aura. +In this section, you will learn about additional resources and next steps to continue your journey with Neo4j Dashboards. Feel free to ask any questions in the chat! @@ -13,19 +13,31 @@ Feel free to ask any questions in the chat! To continue your learning journey, you can explore the following resources: +**For Neo4j Aura users:** + * Documentation: -** link:https://neo4j.com/docs/aura/security/mfa/[Secure your account by enabling MFA^] -** link:https://neo4j.com/docs/aura/security/encryption/[Learn about Encryption in Aura^] -** link:https://neo4j.com/docs/aura/tutorials/migration/[Migrate on-premises Neo4j Databases to Aura^] -* link:https://community.neo4j.com/[Visit the Neo4j Community Forum^] -* link:https://graphacademy.neo4j.com/[Explore GraphAcademy for more courses^] -** link:https://graphacademy.neo4j.com/courses/cypher-fundamentals/[Learn Cypher, the query language for Neo4j^] -** link:https://graphacademy.neo4j.com/courses/[Explore more advanced topics^] +** link:https://neo4j.com/docs/aura/dashboards/[What are dashboards?] +** link:https://neo4j.com/docs/aura/dashboards/getting-started/[Getting started with dashboards] +** link:https://neo4j.com/docs/aura/dashboards/managing-dashboards/[Managing dashboards] +** link:https://neo4j.com/docs/aura/dashboards/visualizations/[Visualizations and charts] +** link:https://neo4j.com/docs/aura/dashboards/sharing-dashboards/[Sharing dashboards] +** link:https://neo4j.com/docs/aura/dashboards/import/[Import and export dashboards] +** link:https://neo4j.com/docs/aura/visual-tour/[Visual tour of the Aura console] + +**For on-premises Enterprise Edition users:** +* Documentation: +** link:https://neo4j.com/docs/operations-manual/current/dashboards/[Neo4j Dashboards in Operations Manual] +**For all users:** + +* Blog and community: +** link:https://neo4j.com/blog/auradb/neo4j-dashboards/[AI-Powered Dashboard Creation] +** link:https://community.neo4j.com/c/neo4j-graph-platform/dashboards/[Dashboards community discussion] [.TIP] + After launching one of the available sample projects, you can use them to practice your GraphAcademy obtained skills. read::Click to complete[] @@ -33,6 +45,6 @@ read::Click to complete[] [.summary] == Summary -In this lesson, you learned about additional resources to continue your learning journey with Neo4j Aura. +In this lesson, you learned about additional resources to continue your learning journey with Neo4j Dashboards. -You can explore the Neo4j documentation, community forum, and GraphAcademy for more information and learning materials. +You can explore the Neo4j documentation, community forum, and GraphAcademy for more information and learning materials specific to both Aura and on-premises installations. diff --git a/asciidoc/courses/aura-dashboards/modules/4-sharing-dashboards/module.adoc b/asciidoc/courses/aura-dashboards/modules/4-sharing-dashboards/module.adoc index dead3f063..4cd73b0eb 100644 --- a/asciidoc/courses/aura-dashboards/modules/4-sharing-dashboards/module.adoc +++ b/asciidoc/courses/aura-dashboards/modules/4-sharing-dashboards/module.adoc @@ -5,8 +5,12 @@ In this module, you will learn how to share your dashboards with stakeholders an You will learn about: -* Different sharing options available in Neo4j Aura Dashboards -* Best practices for collaboration and distribution of insights. +* Different sharing options available in Neo4j Dashboards +* Best practices for collaboration and distribution of insights +[NOTE] +==== +Sharing procedures vary between Neo4j Aura and on-premises installations. This module focuses on Aura's sharing features, with notes for on-premises users. +==== link:./1-sharing/[Ready? Let's go →, role=btn] diff --git a/asciidoc/courses/aura-dashboards/summary.adoc b/asciidoc/courses/aura-dashboards/summary.adoc index 6526970a9..0011c0524 100644 --- a/asciidoc/courses/aura-dashboards/summary.adoc +++ b/asciidoc/courses/aura-dashboards/summary.adoc @@ -1,78 +1,102 @@ = Course Summary -Congratulations on completing "Aura Dashboard Fundamentals"! +Congratulations on completing "Building Dashboards in Neo4j"! -You have successfully learned how to use Neo4j Aura Dashboards, as part of the fully managed cloud graph database service. +You have successfully learned how to create interactive dashboards to visualize and explore graph data using Neo4j's built-in dashboard functionality. -== Understanding Neo4j Aura Dashboards +== Understanding Neo4j Dashboards You now know how to: -* Understand the benefits of fully managed Neo4j Aura Dashboards for data visualisation and exploration -* Navigate the Aura Dashboards user interface -* Use natural language queries to explore graph data without writing Cypher -* Create and manage dashboards to visualize graph data effectively -* Share dashboards with stakeholders for collaborative insights +* Understand the benefits of Neo4j Dashboards for data visualization and exploration +* Navigate the Dashboards interface effectively +* Access dashboards in both Neo4j Aura and on-premises Enterprise Edition +* Recognize when dashboards are the right tool for your use case -== Getting Started with Aura +== Creating and Designing Dashboards You've mastered the fundamentals of: -* Navigating the Aura Dashboards interface -* Creating and configuring your first AI-powered dashboard -* Managing instance visualizations and settings -* Sharing dashboards with team members and stakeholders +* Creating your first dashboard using AI-powered generation +* Building dashboard cards with natural language prompts +* Writing and using Cypher queries for custom visualizations +* Designing dashboards that align with stakeholder requirements +* Understanding your data model to create meaningful visualizations -== Data Management and Operations +[NOTE] +==== +These skills apply to both Neo4j Aura and on-premises Enterprise Edition installations. The dashboard features work identically across both platforms. +==== + +== Building Interactive Dashboards You've learned essential skills for: -* Importing data into your Aura instance using built-in tools -* Querying data effectively with the integrated query tool -* Exploring your graph data using the visualization tools -* Building dashboards to visualize and monitor your data +* Creating various chart types (bar charts, pie charts, line charts, tables) +* Visualizing aggregated metrics and single values +* Adding graph visualizations to show relationships +* Using filters to make dashboards interactive +* Customizing dashboard layouts for better data representation +* Managing multiple dashboard pages -== Production Best Practices +== Sharing and Collaboration You've gained knowledge about: -* Instance management and monitoring -* Connecting external applications to your Aura instance +* Inviting users to your project with appropriate roles +* Sharing dashboards with specific users via email +* Setting project-level access for broader collaboration +* Understanding user roles (Organization Admin, Project Admin, Project Member, Project Viewer, Metrics Reader) +* Managing dashboard permissions and access control == Pro Tips -=== Cost Management -* Start with Aura Free for experimentation and learning -* Monitor your usage patterns before upgrading tiers -* Choose the right region to optimize performance and costs -* Use snapshots strategically for data protection +=== Dashboard Design +* Start with stakeholder requirements before building dashboards +* Analyze your data model to identify relevant metrics +* Use AI generation for rapid prototyping, then refine with Cypher +* Keep dashboards focused on specific use cases +* Use descriptive names for dashboards and cards + +=== Visualization Best Practices +* Choose the right chart type for your data (bar charts for comparisons, line charts for trends, pie charts for proportions) +* Use graph visualizations to show relationships and patterns +* Add filters for interactivity and dynamic exploration +* Keep visualizations simple and easy to understand +* Test dashboards with actual stakeholders for feedback + +=== Platform Considerations + +**For Neo4j Aura users:** +* Start with Aura Free (3 dashboard pages) for learning and experimentation +* Upgrade to Professional or Business Critical (25 pages) for production use +* Plan your dashboard structure to fit within tier limits -=== Performance Optimization -* Select appropriate instance sizes based on your workload -* Use the query tool to optimize your Cypher queries -* Leverage the explore tool to understand your data patterns -* Build focused dashboards for specific use cases +**For on-premises Enterprise Edition users:** +* Dashboard limits depend on your license agreement +* Consult your Neo4j representative for specific limitations -=== Security Best Practices -* Use strong authentication and proper access controls -* Regularly review and audit user permissions -* Keep your connection credentials secure -* Understand the shared responsibility model +**For all users:** +* Use multiple pages within a dashboard to organize related metrics +* Consider your audience when designing dashboard layouts == Ready for your next challenge? -TODO: next links when aura course is created -Continue your Neo4j journey with these recommended courses: +Now that you can create and share dashboards, continue your Neo4j journey with these recommended courses: -* link:/courses/cypher-fundamentals/[Cypher Fundamentals^] - Master the Neo4j query language +=== Strengthen Your Foundation +* link:/courses/aura-fundamentals/[Aura Fundamentals^] - Learn more about managing Neo4j Aura instances +* link:/courses/cypher-fundamentals/[Cypher Fundamentals^] - Master the Neo4j query language for more powerful dashboard queries * link:/courses/modeling-fundamentals/[Graph Data Modeling Fundamentals^] - Learn to design effective graph models -* link:/courses/importing-data/[Importing Data into Neo4j^] - Advanced data import techniques -* link:/courses/drivers-python/[Using Neo4j with Python^] or link:/courses/drivers-java/[Using Neo4j with Java^] - Build applications with Neo4j -For cloud-specific learning, explore: +=== Advanced Data Skills +* link:/courses/importing-data/[Importing Data into Neo4j^] - Advanced data import techniques for your dashboards +* link:/courses/cypher-advanced/[Advanced Cypher^] - Build complex queries for sophisticated visualizations -* link:/courses/aura-fundamentals/[Aura Fundamentals^] - Advanced import strategies for cloud databases +=== Build Applications +* link:/courses/app-python/[Building Neo4j Applications with Python^] - Create custom applications that complement your dashboards +* link:/courses/app-nodejs/[Building Neo4j Applications with Node.js^] - Integrate dashboards with web applications -You can now confidently design and manage Neo4j dashboards in the cloud using Aura! +You can now confidently create, customize, and share interactive dashboards to visualize graph data in Neo4j, whether you're using Aura or on-premises Enterprise Edition! From ad36f12b73032da0a2b4bed8e6df7bfc8ea4c982 Mon Sep 17 00:00:00 2001 From: Irina Loghin Date: Tue, 25 Nov 2025 15:35:25 +0000 Subject: [PATCH 2/2] rephrased the storyline and added some fixes to images paths --- .../2-accessing-aura-dashboards/lesson.adoc | 5 +- .../questions/2-empty-dashboards-canvas.adoc | 4 +- .../3-exploring-dashboards/lesson.adoc | 7 +- .../questions/2-empty-dashboards-canvas.adoc | 23 --- .../modules/1-getting-started/module.adoc | 1 + .../2-visualise-aggregations/lesson.adoc | 12 +- .../lessons/1-sharing/lesson.adoc | 1 + .../lessons/3-further-steps/lesson.adoc | 137 +++++++++++++++++- .../modules/4-sharing-dashboards/module.adoc | 1 + asciidoc/courses/aura-dashboards/summary.adoc | 1 + 10 files changed, 148 insertions(+), 44 deletions(-) delete mode 100644 asciidoc/courses/aura-dashboards/modules/1-getting-started/lessons/3-exploring-dashboards/questions/2-empty-dashboards-canvas.adoc diff --git a/asciidoc/courses/aura-dashboards/modules/1-getting-started/lessons/2-accessing-aura-dashboards/lesson.adoc b/asciidoc/courses/aura-dashboards/modules/1-getting-started/lessons/2-accessing-aura-dashboards/lesson.adoc index d37125a0b..a679e8ca3 100644 --- a/asciidoc/courses/aura-dashboards/modules/1-getting-started/lessons/2-accessing-aura-dashboards/lesson.adoc +++ b/asciidoc/courses/aura-dashboards/modules/1-getting-started/lessons/2-accessing-aura-dashboards/lesson.adoc @@ -20,6 +20,7 @@ To follow along with this course, you have two options: The rest of this lesson focuses on setting up Neo4j Aura. If you're using on-premises, skip to **Step 4** to learn how to connect. [NOTE] +.Skip if you already have an account ==== If you already have a Neo4j Aura account and instance, you can skip to **Step 4.** ==== @@ -97,7 +98,7 @@ image::images/connect-from-dashboards.png[Connect to instance dialog,width=600,a You can find your Aura instance connection details by clicking the **...** menu next to your instance name and selecting **Inspect**, or by using the downloaded connection details file. -For more information, see link:https://neo4j.com/docs/aura/auradb/connecting-applications/[Connecting Applications documentation^]. +For more information, see link:https://neo4j.com/docs/aura/auradb/[AuraDB documentation^]. === For on-premises users: @@ -113,8 +114,6 @@ The Dashboards interface and features work identically in both Aura and on-premi [.quiz] == Check your understanding -include::questions/1-choosing.adoc[leveloffset=+1] - include::questions/2-empty-dashboards-canvas.adoc[leveloffset=+1] diff --git a/asciidoc/courses/aura-dashboards/modules/1-getting-started/lessons/2-accessing-aura-dashboards/questions/2-empty-dashboards-canvas.adoc b/asciidoc/courses/aura-dashboards/modules/1-getting-started/lessons/2-accessing-aura-dashboards/questions/2-empty-dashboards-canvas.adoc index 806869aff..fb4a5f712 100644 --- a/asciidoc/courses/aura-dashboards/modules/1-getting-started/lessons/2-accessing-aura-dashboards/questions/2-empty-dashboards-canvas.adoc +++ b/asciidoc/courses/aura-dashboards/modules/1-getting-started/lessons/2-accessing-aura-dashboards/questions/2-empty-dashboards-canvas.adoc @@ -1,5 +1,5 @@ [.question] -= Getting access to Aura Dashboards += Understanding the Empty Canvas Why is the Dashboards canvas page empty when you first access it? @@ -18,6 +18,8 @@ Think about what is required to visualize data in dashboards. [TIP,role=solution] .Solution ==== + +**Because you need to import data first.** To visualize data in Aura Dashboards, you first need to import data into your Neo4j Aura instance. Without any data, the dashboards canvas will be empty as there is nothing to display. ==== diff --git a/asciidoc/courses/aura-dashboards/modules/1-getting-started/lessons/3-exploring-dashboards/lesson.adoc b/asciidoc/courses/aura-dashboards/modules/1-getting-started/lessons/3-exploring-dashboards/lesson.adoc index d4c209143..655c0d991 100644 --- a/asciidoc/courses/aura-dashboards/modules/1-getting-started/lessons/3-exploring-dashboards/lesson.adoc +++ b/asciidoc/courses/aura-dashboards/modules/1-getting-started/lessons/3-exploring-dashboards/lesson.adoc @@ -63,6 +63,7 @@ CALL db.schema.visualization This will display a visualization of the database schema, showing the nodes and relationships that have been created. In the Explore tab, you need to search for a node label or use the _Show a graph snippet_ button in the empty state to view part of the graph. + image::images/run-query.png[The import-recommendations.cypher script in the Query Editor] Once the script has finished running, you will see a summary of the nodes and relationships created in your Aura instance. @@ -96,8 +97,7 @@ image::images/ai-dashboard.png[AI generated dashboard,width=600,align=center] In this dashboard, you can see various visualizations such as single values, bar charts, pie charts, and graph visualizations that provide insights into movie recommendations based on user ratings and genres. You will learn more about each type of chart in the following lessons. -Use the graph visualization to explore the relationships between users, movies, and genres interactively: - +Use the graph visualization to explore the relationships between users, movies, and genres interactively: image::images/ai-generated-graph.png[AI generated graph visualization,width=600,align=center] @@ -109,9 +109,6 @@ Before moving to the next lesson, take your time to explore the different cards include::questions/1-requirements.adoc[leveloffset=+1] -include::questions/2-empty-dashboards-canvas.adoc[leveloffset=+1] - - [.summary] diff --git a/asciidoc/courses/aura-dashboards/modules/1-getting-started/lessons/3-exploring-dashboards/questions/2-empty-dashboards-canvas.adoc b/asciidoc/courses/aura-dashboards/modules/1-getting-started/lessons/3-exploring-dashboards/questions/2-empty-dashboards-canvas.adoc deleted file mode 100644 index 806869aff..000000000 --- a/asciidoc/courses/aura-dashboards/modules/1-getting-started/lessons/3-exploring-dashboards/questions/2-empty-dashboards-canvas.adoc +++ /dev/null @@ -1,23 +0,0 @@ -[.question] -= Getting access to Aura Dashboards - - -Why is the Dashboards canvas page empty when you first access it? - -* [ ] Because you need to pay extra. -* [x] Because you need to import data first. -* [ ] Because you need to create another account. -* [ ] Because you need to install additional software. - -[TIP,role=hint] -.Hint -==== -Think about what is required to visualize data in dashboards. -==== - -[TIP,role=solution] -.Solution -==== -To visualize data in Aura Dashboards, you first need to import data into your Neo4j Aura instance. Without any data, the dashboards canvas will be empty as there is nothing to display. - -==== diff --git a/asciidoc/courses/aura-dashboards/modules/1-getting-started/module.adoc b/asciidoc/courses/aura-dashboards/modules/1-getting-started/module.adoc index ada43db82..35d2bada4 100644 --- a/asciidoc/courses/aura-dashboards/modules/1-getting-started/module.adoc +++ b/asciidoc/courses/aura-dashboards/modules/1-getting-started/module.adoc @@ -12,6 +12,7 @@ You will learn how to: * Generate insights from graph data using the AI assistant [NOTE] +.Platform compatibility ==== This course uses Neo4j Aura for demonstrations, but all features work identically in on-premises Neo4j Enterprise Edition. ==== diff --git a/asciidoc/courses/aura-dashboards/modules/3-building-dashboards/lessons/2-visualise-aggregations/lesson.adoc b/asciidoc/courses/aura-dashboards/modules/3-building-dashboards/lessons/2-visualise-aggregations/lesson.adoc index 0820fef39..e0c0839d9 100644 --- a/asciidoc/courses/aura-dashboards/modules/3-building-dashboards/lessons/2-visualise-aggregations/lesson.adoc +++ b/asciidoc/courses/aura-dashboards/modules/3-building-dashboards/lessons/2-visualise-aggregations/lesson.adoc @@ -51,11 +51,6 @@ Use the **Run** button or press `Ctrl+Enter` to execute the search. image::images/03_explore_tool_result.jpg[exploretool_result,width=500,align=center] -[NOTE] -.Zooming for Details -==== -You may have to zoom in a bit before the details are shown. -==== Notice that your styling choices are kept between runs and can even be shared with other users, using the **Perspectives** feature. @@ -89,6 +84,7 @@ The **Graph** visualization type is ideal for displaying relationships between n You can either use the AI assistant to generate a graph card based on a natural language prompt, or write a Cypher query to fetch specific nodes and relationships. For example, you can create a graph card to visualize the relationships between actors and movies: + image::images/ai-generated-graph.png[Graph card example,width=600,align=center] === Table card @@ -235,8 +231,8 @@ A computer hacker learns from mysterious rebels about the true nature of his rea **Rotten Tomatoes:** 88% (Critics), 85% (Audience) ## Awards -- 🏆 4 Academy Awards (Visual Effects, Sound, Film Editing, Sound Effects Editing) -- 🏆 2 BAFTA Awards +- 4 Academy Awards (Visual Effects, Sound, Film Editing, Sound Effects Editing) +- 2 BAFTA Awards ## Key Relationships in Graph ``` @@ -339,7 +335,7 @@ Also, feel free to modify the queries to explore different aspects of your data. [NOTE] -.Understanding Your Data Model +.Important considerations for Perspectives ==== 1. The model has to be understood. You can explore the data knowing what the database holds and how it is organized. diff --git a/asciidoc/courses/aura-dashboards/modules/4-sharing-dashboards/lessons/1-sharing/lesson.adoc b/asciidoc/courses/aura-dashboards/modules/4-sharing-dashboards/lessons/1-sharing/lesson.adoc index 9ca3fcd64..4f7315368 100644 --- a/asciidoc/courses/aura-dashboards/modules/4-sharing-dashboards/lessons/1-sharing/lesson.adoc +++ b/asciidoc/courses/aura-dashboards/modules/4-sharing-dashboards/lessons/1-sharing/lesson.adoc @@ -17,6 +17,7 @@ In this lesson, you will learn how to share dashboards with others. The specific * Consult your database administrator for user access procedures [NOTE] +.For on-premises users ==== The examples in this lesson focus on Neo4j Aura's sharing features. If you're using on-premises Enterprise Edition, work with your database administrator to manage dashboard access using your organization's user management system. ==== diff --git a/asciidoc/courses/aura-dashboards/modules/4-sharing-dashboards/lessons/3-further-steps/lesson.adoc b/asciidoc/courses/aura-dashboards/modules/4-sharing-dashboards/lessons/3-further-steps/lesson.adoc index b22905079..f3869bf09 100644 --- a/asciidoc/courses/aura-dashboards/modules/4-sharing-dashboards/lessons/3-further-steps/lesson.adoc +++ b/asciidoc/courses/aura-dashboards/modules/4-sharing-dashboards/lessons/3-further-steps/lesson.adoc @@ -9,6 +9,133 @@ In this section, you will learn about additional resources and next steps to con Feel free to ask any questions in the chat! +== Final Project: Build Your Stakeholders Dashboard + +Now it's time to apply everything you've learned by creating a comprehensive, production-ready dashboard. + + +=== Project Overview + +**Scenario:** Design a dashboard for a streaming service to support content acquisition decisions. The dashboard will serve three stakeholder groups: executives, marketing team, and content acquisition team. + +**Budget context:** $5M quarterly content acquisition budget +**Decision timeline:** Board presentation in 3 weeks +**Your deliverable:** 3-page dashboard with actionable insights + + +=== Requirements + +Create **3 dashboard pages:** + +**Page 1: Executive Summary** + +* 3 single value cards: Total content, Average rating, Active users +* 1 line chart: Genre trends over last 5 years +* 1 bar chart: Top performing regions +* 1 text card: Strategic recommendation based on data + +**Page 2: Marketing Analytics** + +* 1 bar chart: User ratings by genre +* 1 table: Top 20 movies with detailed metrics +* 2 filters: Genre selector, Date range picker +* Clear labels using business language (not technical jargon) + +**Page 3: Content Acquisition Intelligence** + +* 1 horizontal bar chart: Top 15 directors by average rating +* 1 graph visualization: Actor-Movie-Director relationships +* 1 text card: Acquisition recommendations with specific director names + + +=== Quality Criteria + +Before submitting, verify: + +* All visualizations answer a business question +* Charts follow best practices (no pie charts for rankings) +* Labels use business-friendly language +* Dashboard tells a coherent story +* Includes at least one actionable recommendation +* Filters work correctly +* No technical jargon in titles or labels + + +=== Bonus Challenges (Optional) + +* Add period-over-period comparisons (e.g., "+15% from last quarter") +* Include benchmark lines or targets on charts +* Export dashboard as PDF for board distribution +* Add a fourth page for regional managers with geographic filters + + +== Share Your Work! + +We encourage you to share your completed dashboard with the Neo4j community! + + +=== How to Share + +1. **Take screenshots** of your 3 dashboard pages (high resolution) +2. **Write a brief description** (2-3 paragraphs): + - What business problem does it solve? + - What insights did you discover? + - What challenges did you face? + + +3. **Post to Neo4j Community Forum** + +Visit link:https://community.neo4j.com/[Neo4j Community Forum^] and create a post with: + +``` +Title: [Course Project] My Streaming Service Stakeholder Dashboard + +Hi Neo4j Community! + +I just completed the "Building Dashboards in Neo4j" course and created +this stakeholder dashboard for a streaming service use case. + +**What it does:** +[Describe your dashboard's purpose] + +**Key insights discovered:** +[Share 2-3 insights from your data analysis] + +**What I learned:** +[Mention 1-2 key takeaways] + +Feedback welcome! + +[Attach your screenshots] +``` + +4. **Optional: Share on LinkedIn** + +Consider adding to your LinkedIn profile as a portfolio piece: +[source,markdown] +---- +Just completed my Neo4j Dashboard project! + +Built a comprehensive stakeholder dashboard for streaming service +content strategy using Neo4j Dashboards. + +Key features: +- Executive KPIs and trend analysis +- Interactive filters for marketing team +- Director performance rankings + +#DataAnalytics #Neo4j #DataVisualization #GraphDatabase +---- + + +=== Why Share? + +* **Build your portfolio** - Showcase your skills to potential employers +* **Get feedback** - Learn from experienced Neo4j users +* **Help others** - Inspire fellow students with your approach +* **Get recognized** - Outstanding dashboards may be featured by Neo4j + + == Continuing your learning journey To continue your learning journey, you can explore the following resources: @@ -27,13 +154,13 @@ To continue your learning journey, you can explore the following resources: **For on-premises Enterprise Edition users:** * Documentation: -** link:https://neo4j.com/docs/operations-manual/current/dashboards/[Neo4j Dashboards in Operations Manual] +** link:https://neo4j.com/docs/operations-manual/current/[Neo4j Operations Manual] **For all users:** * Blog and community: ** link:https://neo4j.com/blog/auradb/neo4j-dashboards/[AI-Powered Dashboard Creation] -** link:https://community.neo4j.com/c/neo4j-graph-platform/dashboards/[Dashboards community discussion] +** link:https://community.neo4j.com/[Neo4j Community Forum] [.TIP] @@ -45,6 +172,8 @@ read::Click to complete[] [.summary] == Summary -In this lesson, you learned about additional resources to continue your learning journey with Neo4j Dashboards. +In this lesson, you received your final project specification: Build a comprehensive stakeholders dashboard for a streaming service. + +You also learned how to share your work with the Neo4j community to build your portfolio, get feedback, and connect with other Neo4j users. -You can explore the Neo4j documentation, community forum, and GraphAcademy for more information and learning materials specific to both Aura and on-premises installations. +Additional resources are available in the Neo4j documentation, community forum, and GraphAcademy for continued learning. diff --git a/asciidoc/courses/aura-dashboards/modules/4-sharing-dashboards/module.adoc b/asciidoc/courses/aura-dashboards/modules/4-sharing-dashboards/module.adoc index 4cd73b0eb..c4a038bd0 100644 --- a/asciidoc/courses/aura-dashboards/modules/4-sharing-dashboards/module.adoc +++ b/asciidoc/courses/aura-dashboards/modules/4-sharing-dashboards/module.adoc @@ -9,6 +9,7 @@ You will learn about: * Best practices for collaboration and distribution of insights [NOTE] +.Platform differences in sharing ==== Sharing procedures vary between Neo4j Aura and on-premises installations. This module focuses on Aura's sharing features, with notes for on-premises users. ==== diff --git a/asciidoc/courses/aura-dashboards/summary.adoc b/asciidoc/courses/aura-dashboards/summary.adoc index 0011c0524..5fbba2b77 100644 --- a/asciidoc/courses/aura-dashboards/summary.adoc +++ b/asciidoc/courses/aura-dashboards/summary.adoc @@ -24,6 +24,7 @@ You've mastered the fundamentals of: * Understanding your data model to create meaningful visualizations [NOTE] +.Platform compatibility ==== These skills apply to both Neo4j Aura and on-premises Enterprise Edition installations. The dashboard features work identically across both platforms. ====