diff --git a/site/sigmaguides/src/dataaps_fundamentals/assets/dataaps_fun_0c.png b/site/sigmaguides/src/dataaps_fundamentals/assets/dataaps_fun_0c.png new file mode 100644 index 00000000..339420a3 Binary files /dev/null and b/site/sigmaguides/src/dataaps_fundamentals/assets/dataaps_fun_0c.png differ diff --git a/site/sigmaguides/src/dataaps_fundamentals/assets/dataaps_fun_2ia.png b/site/sigmaguides/src/dataaps_fundamentals/assets/dataaps_fun_2ia.png new file mode 100644 index 00000000..f1be0dce Binary files /dev/null and b/site/sigmaguides/src/dataaps_fundamentals/assets/dataaps_fun_2ia.png differ diff --git a/site/sigmaguides/src/dataaps_fundamentals/assets/dataaps_fun_2ib.png b/site/sigmaguides/src/dataaps_fundamentals/assets/dataaps_fun_2ib.png new file mode 100644 index 00000000..99b5e477 Binary files /dev/null and b/site/sigmaguides/src/dataaps_fundamentals/assets/dataaps_fun_2ib.png differ diff --git a/site/sigmaguides/src/dataaps_fundamentals/assets/dataaps_fun_5i.png b/site/sigmaguides/src/dataaps_fundamentals/assets/dataaps_fun_5i.png index 02f68974..2ad936b9 100644 Binary files a/site/sigmaguides/src/dataaps_fundamentals/assets/dataaps_fun_5i.png and b/site/sigmaguides/src/dataaps_fundamentals/assets/dataaps_fun_5i.png differ diff --git a/site/sigmaguides/src/dataaps_fundamentals/assets/dataaps_fun_6m1.png b/site/sigmaguides/src/dataaps_fundamentals/assets/dataaps_fun_6m1.png new file mode 100644 index 00000000..510078d3 Binary files /dev/null and b/site/sigmaguides/src/dataaps_fundamentals/assets/dataaps_fun_6m1.png differ diff --git a/site/sigmaguides/src/dataaps_fundamentals/dataaps_fundamentals.md b/site/sigmaguides/src/dataaps_fundamentals/dataaps_fundamentals.md index 79e2ec79..eb42278a 100644 --- a/site/sigmaguides/src/dataaps_fundamentals/dataaps_fundamentals.md +++ b/site/sigmaguides/src/dataaps_fundamentals/dataaps_fundamentals.md @@ -3,9 +3,9 @@ id: dataaps_fundamentals summary: dataaps_fundamentals categories: dataapps environments: web -status: hidden +status: published feedback link: https://github.com/sigmacomputing/sigmaquickstarts/issues -tags: +tags: default lastUpdated: 2024-10-24 # Data Apps Fundamentals @@ -13,14 +13,87 @@ lastUpdated: 2024-10-24 ## Overview Duration: 5 -To be written by PB +Sigma has always been known as a leader in analytics, with its cloud-built platform designed to support today’s massive data scale challenges. + +Sigma has been extended to enable customers to build rich, interactive applications, automate workflows, and take action customized to their team’s needs—all without writing any code. + +This transformation has occurred in stages, and we are now in stage three, as shown in the image below. + + + +This QuickStart demonstrates how to use Sigma to build a data application (app) entirely within the Sigma UI. The data used will come from, and be stored in, Snowflake. During this demonstration, we will build a fully functional project tracking data app that, in the past, may have taken significant time to get up and running. + +This QuickStart is a bit longer than usual, and we understand that people can be pressed for time. While it is well worth the investment, if you can’t spare the time, you can instead [watch this 5-minute video](https://sigmacomputing.wistia.com/medias/6lneuw4062?__hstc=191098485.ee45354cafd3cb03900ca8358c6cba7c.1713989091503.1733934938183.1734711950588.87&__hssc=191098485.2.1734711950588&__hsfp=336580338) to see how impactful Sigma data apps can be for your organization. + +### Project Tracker use case +The `Project Tracker` will support the following: + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
CategoryDescription
ProjectsTop Level reporting.
TasksTasks are children of projects. Each project may have 1 or more tasks.
StatusProject status changes over time. Create a flow to track status over time while displaying just the latest status for a project.
ApprovalsAll projects must be reviewed and approved prior to being marked as complete.
UIAble to see all project details in one place.
+
+ +**Some of the core Sigma functionalities we will touch are:** + + ### What we will build -After completing this QuickStart we will have built a fully functional data app based on a project management use case. The finished will look something like this (depending on your styling choices!): +After completing this QuickStart we will have built a fully functional data app based on a project management use case. + +The finished can look something like this (depending on your styling choices!): @@ -100,10 +173,11 @@ Change the title of the new input table (by double-clicking its current title) t #### Step 3: Add new columns: +In this step, we will create three new columns: two as `text` and one as `date` format. First, rename the existing `Text` column to `Project Name`. -Next create two additional `text` fields and one `date` field: +Next, create two additional `text` and one `date` columns: @@ -111,12 +185,12 @@ Rename the new columns to `Project Owner`, `Project Type`, and `Project Due Date -#### Step 5: Rename the page +#### Step 4: Rename the page Rename the workbook page to `Project Tracker` and add a new page, by clicking the `+` icon in the footer. Rename it to `Data Validation`: -#### Step 6: Validation input tables +#### Step 5: Validation input tables In this step we will create three additional input tables, reloading them with data from csv files. -#### Step 17: +#### Step 16: Select each control (shift+click) and the `Create Project` button. At the top right, choose the `Create container` option from the selected elements menu: @@ -258,13 +332,7 @@ At the top right, choose the `Create container` option from the selected element PRO TIP:
You can also use hot keys! "Command+G" will put all selected items into a container. -For more information on hot-keys in Sigma, see the documentation: - -[Windows](https://help.sigmacomputing.com/docs/keyboard-shortcuts-microsoft-windows) - -[Mac](https://help.sigmacomputing.com/docs/keyboard-shortcuts-mac-os) - -#### Step 18: +#### Step 17: Rename the container `Create Project Container` @@ -273,14 +341,14 @@ Rename the container `Create Project Container` IMPORTANT:
Naming containers as you create them will make life much easier as the data application grows. -#### Step 19: +#### Step 18: Click on your `Create Project” button`, and go to `Actions`. Create a second action set to `Clear control` applied to `Container` with our newly created `Create Project Container`. This will set the action to automatically target all four control elements: -#### Step 20: +#### Step 19: Add an additional row of data to test the clear action on each control element within the container. The updated `Project Tracker` Input Table should look as follows, with a new row of data and the controls cleared once the `Create Project` button is clicked: @@ -314,7 +382,7 @@ Move the various elements around and resize everthiong to suit. Trim any unneces ### Step 3: -Create a new button for `Clear Form`. +Create a new button and rename it to `Clear Form`. In the actions panel, set the action to clear the `Create Project Container.` This is a good best practice for improving user experience. @@ -330,7 +398,7 @@ Actions can be added in series to create dynamic behavors. For more information ### Step 5: Return to the `Project Tracker` page and add a button titled `Create Project`. -Add an action to `Open a Moda`l for the `Modal - Create Project`: +Add an action to `Open a Modal` for the `Modal - Create Project`: @@ -351,6 +419,16 @@ On the `Project Tracker Input Table` page, crate filters for the `Project Name`, + + +For more information on keyboard shortcuts in Sigma, check out these docs: + +[Windows](https://help.sigmacomputing.com/docs/keyboard-shortcuts-microsoft-windows) + +[Mac](https://help.sigmacomputing.com/docs/keyboard-shortcuts-mac-os) + Convert to each filter to a page control by selecting the vertical ellipsis: @@ -368,7 +446,7 @@ Click `Publish`. ### Step 8: Container it Select the filters and place them into a container titled `Filters Container`, -Move this container to a modal titled `Modal - Filters`. +Move this container to a new modal titled `Modal - Filters`. Add a `Filters` title and this time keep the footer buttons naming the primary `Close Modal` and the secondary `Clear Filters`. @@ -388,8 +466,12 @@ Add an additional button named `Clear Filters`. Select all three buttons and place those into a container titled `Buttons Container`. + + Set the action on the `Clear Filters` button to clear the `Filters Container (Modal - Filters)`. + + Test that the new buttons work as expected.