docs(exploring-data): various updates to match latest superset version (

#17516) * update db modal screenshots, rm stale info * pivot table v2 tutorial * more updates * rm old images
apache · Dec 1, 2021 · 1cd07ca · 1cd07ca
1 parent 76cd7b0
commit 1cd07ca
Show file tree

Hide file tree

Showing 12 changed files with 33 additions and 39 deletions.
diff --git a/docs/src/pages/docs/Creating Charts and Dashboards/exploring-data.mdx b/docs/src/pages/docs/Creating Charts and Dashboards/exploring-data.mdx
@@ -34,9 +34,11 @@ select the **Edit** button.
 
 <img src="/images/edit-record.png" />
 
-In the resulting modal window, switch to the **Extra** tab and
-tick the checkbox for **Allow Data Upload**. End by clicking the **Save** button.
+In the resulting modal window, switch to the **Advanced** tab and
+expand the **Security** section. Tick the checkbox for **Allow Data Upload**.
+End by clicking the **Save** button.
 
+<img src="/images/db-modal-advanced.png" />
 <img src="/images/add-data-upload.png" />
 
 ### Loading CSV Data
@@ -62,18 +64,7 @@ Leaving all the other options in their default settings, select **Save** at the
 You should now see _tutorial_flights_ as a dataset in the **Datasets** tab. Click on the entry to
 launch an Explore workflow using this dataset.
 
-In this section, we'll create a table visualization
-to show the number of flights and cost per travel class.
-
-By default, Apache Superset only shows the last week of data. In our example, we want to visualize all
-of the data in the dataset. Click the **Time ‣ Time Range** section and change
-the **Range Type** to **No Filter**.
-
-<img src="/images/no_filter_on_time_filter.png" />
-
-Click **Apply** to save.
-
-Now, we want to specify the rows in our table by using the **Group by** option. Since in this
+First, we want to specify the rows in our table by using the **Group by** option. Since in this
 example, we want to understand different Travel Classes, we select **Travel Class** in this menu.
 
 Next, we can specify the metrics we would like to see in our table with the **Metrics** option.
@@ -82,6 +73,7 @@ Next, we can specify the metrics we would like to see in our table with the **Me
 (in this case, quantity of flights in each Travel Class)
 - `SUM(Cost)`, which represents the total cost spent by each Travel Class
 
+<img src="/images/count_column.png" />
 <img src="/images/sum_cost_column.png" />
 
 Finally, select **Run Query** to see the results of the table.
@@ -112,40 +104,42 @@ dashboard** and then hover over the table. By selecting the bottom right hand co
 
 Finally, save your changes by selecting Save changes in the top right.
 
-### Pivot Table
+### Pivot Table v2
 
-In this section, we will extend our analysis using a more complex visualization, Pivot Table. By the
+In this section, we will extend our analysis using a more complex visualization, Pivot Table v2. By the
 end of this section, you will have created a table that shows the monthly spend on flights for the
 first six months, by department, by travel class.
 
 Create a new chart by selecting **+ ‣ Chart** from the top right corner. Choose
 tutorial_flights again as a datasource, then click on the visualization type to get to the
-visualization menu. Select the **Pivot Table** visualization (you can filter by entering text in the
+visualization menu. Select the **Pivot Table v2** visualization (you can filter by entering text in the
 search box) and then **Create New Chart**.
 
-<img src="/images/create_pivot.png" />
+<img src="/images/create_pivot_2.png" />
 
-In the **Time** section, keep the Time Column as Travel Date (this is selected automatically as we
+In the **Time** section, keep the Time Column as Travel Date (this is selected automatically, as we
 only have one time column in our dataset). Then select Time Grain to be month as having daily data
-would be too granular to see patterns from. Then select the time range to be the first six months of
-2011 by click on Last week in the Time Range section, then in Custom selecting a Start / end of 1st
-January 2011 and 30th June 2011 respectively by either entering directly the dates or using the
-calendar widget (by selecting the month name and then the year, you can move more quickly to far
-away dates).
+would be too granular to see patterns from. Then select the Time Range to be the first six months of
+2011 by clicking into the Time Range edit menu, selecting Custom from the Range Type dropdown,
+and selecting a Start / end of 1st January 2011 and 30th June 2011 respectively by either entering
+the dates directly or using the calendar widget (by selecting the month name and then the year, you
+can move more quickly to far away dates).
 
-<img src="/images/select_dates_pivot_table.png" />
+<img src="/images/select_dates_pivot_table_v2.png" />
 
-Next, within the **Query** section, remove the default COUNT(\*) and add Cost, keeping the default
-SUM aggregate. Note that Apache Superset will indicate the type of the metric by the symbol on the
-left hand column of the list (ABC for string, # for number, a clock face for time, etc.).
+Next, within the **Query** section, add a SUM(Cost) metric. Note that Apache Superset will indicate
+the type of the metric by the symbol on the left hand column of the list (ABC for string, # for
+number, a clock face for time, etc.).
 
-In **Group by** select **Time**: this will automatically use the Time Column and Time Grain
+In **Rows** select **Travel Date**: this will automatically use the Time Column and Time Grain
 selections we defined in the Time section.
 
-Within **Columns**, select first Department and then Travel Class. All set – let’s **Run Query** to
-see some data!
+Within **Columns**, select first Department and then Travel Class.
+
+Under **Options**, tick the Show Rows Total and Show Columns Total checkboxes. All set – let’s
+**Run Query** to see some data!
 
-<img src="/images/tutorial_pivot_table.png" />
+<img src="/images/tutorial_pivot_table_v2.png" />
 
 You should see months in the rows and Department and Travel Class in the columns. Publish this chart
 to your existing Tutorial Dashboard you created earlier.
@@ -183,7 +177,7 @@ Once you’re done, publish the chart in your Tutorial Dashboard.
 
 ### Markup
 
-In this section, we will add some text to our dashboard. If you’re there already, you can navigate
+In this section, we will add some text to our dashboard. If you’re not there already, you can navigate
 to the dashboard by selecting Dashboards on the top menu, then Tutorial dashboard from the list of
 dashboards. Got into edit mode by selecting **Edit dashboard**.
 
@@ -248,12 +242,12 @@ annotation to the Tutorial Line Chart we made in a previous section. Specificall
 dates when some flights were cancelled by the UK’s Civil Aviation Authority in response to the
 eruption of the Grímsvötn volcano in Iceland (23-25 May 2011).
 
-First, add an annotation layer by navigating to Manage ‣ Annotation Layers. Add a new annotation
-layer by selecting the green plus sign to add a new record. Enter the name Volcanic Eruptions and
+First, add an annotation layer by navigating to Settings ‣ Manage ‣ Annotation Layers. Add a new annotation
+layer by selecting the blue plus button to add a new record. Enter the name Volcanic Eruptions and
 save. We can use this layer to refer to a number of different annotations.
 
-Next, add an annotation by navigating to Manage ‣ Annotations and then create a new annotation by
-selecting the green plus sign. Then, select the Volcanic Eruptions layer, add a short description
+Next, add an annotation by clicking into the newly created layer and then create a new annotation by
+selecting the blue plus button. Then, select the Volcanic Eruptions layer, add a short description
 Grímsvötn and the eruption dates (23-25 May 2011) before finally saving.
 
 <img src="/images/edit_annotation.png" />
@@ -263,7 +257,7 @@ list. Next, go to the Annotations and Layers section and select Add Annotation L
 dialogue:
 
 - Name the layer as Volcanic Eruptions
-- Change the Annotation Layer Type to Event
+- Change the Annotation Layer Type to Interval
 - Set the Annotation Source as Superset annotation
 - Specify the Annotation Layer as Volcanic Eruptions
 
@@ -302,7 +296,7 @@ Dashboard.
 
 There is quite a lot of variation in the data, which makes it difficult to identify any trend. One
 approach we can take is to show instead a rolling average of the time series. To do this, in the
-**Moving Average** subsection of **Advanced Analytics**, select mean in the **Rolling** box and
+**Rolling Window** subsection of **Advanced Analytics**, select mean in the **Rolling Function** box and
 enter 7 into both Periods and Min Periods. The period is the length of the rolling period expressed
 as a multiple of the Time Grain. In our example, the Time Grain is day, so the rolling period is 7
 days, such that on the 7th October 2011 the value shown would correspond to the first seven days of

diff --git a/docs/static/images/add-data-upload.png b/docs/static/images/add-data-upload.png
diff --git a/docs/static/images/count_column.png b/docs/static/images/count_column.png
diff --git a/docs/static/images/create_pivot.png b/docs/static/images/create_pivot.png
diff --git a/docs/static/images/create_pivot_v2.png b/docs/static/images/create_pivot_v2.png
diff --git a/docs/static/images/db-modal-advanced.png b/docs/static/images/db-modal-advanced.png
diff --git a/docs/static/images/no_filter_on_time_filter.png b/docs/static/images/no_filter_on_time_filter.png
diff --git a/docs/static/images/select_dates_pivot_table.png b/docs/static/images/select_dates_pivot_table.png
diff --git a/docs/static/images/select_dates_pivot_table_v2.png b/docs/static/images/select_dates_pivot_table_v2.png
diff --git a/docs/static/images/sum_cost_column.png b/docs/static/images/sum_cost_column.png
diff --git a/docs/static/images/tutorial_pivot_table.png b/docs/static/images/tutorial_pivot_table.png
diff --git a/docs/static/images/tutorial_pivot_table_v2.png b/docs/static/images/tutorial_pivot_table_v2.png