FFF May 2024

site/sigmaguides/src/05_2024_first_friday_features/05_2024_first_friday_features.md

@@ -0,0 +1,303 @@
+author: pballai
+id: 05_2024_first_friday_features
+summary: 05_2024_first_friday_features
+categories: Administration
+environments: web
+status: Published
+feedback link: https://github.com/sigmacomputing/sigmaquickstarts/issues
+tags: first_friday_features
+lastUpdated: 2024-04-31
+
+<-- 
+May 10th, 2024 - Done
+May 17th, 2024 - Done
+May 24th, 2024
+
+!-->
+
+# (05-2024) May
+<!-- The above name is what appears on the website and is searchable. -->
+
+## Overview 
+Duration: 5 
+
+This QuickStart lists all the new and public beta features released, as well as bugs fixed in May 2024.
+
+It is summary in nature, and you should refer to the specific Sigma documentation links provided for more information.
+
+**Public beta features will carry the section text "Beta".**
+
+All other features are considered released (**GA** or generally available).
+
+Sigma actually has feature and bug fix releases weekly, and high-priority bug fixes on demand. We felt it was best to keep these QuickStarts to a summary of the previous month for your convenience.
+
+New first Friday features QuickStarts will be published on the first Friday of each month, and will include information for the previous month.
+
+![Footer](assets/sigma_footer.png)
+
+## Administration
+Duration: 20
+
+### OAuth write access (Beta)
+Configure an OAuth connection with write access to leverage the benefits of OAuth permission management with Sigma’s write-access features, including input tables, warehouse views, workbook materializations, and CSV uploads.
+
+For more information, see [Configure OAuth with write access.](https://help.sigmacomputing.com/docs/configure-oauth-with-write-access)
+
+### Organization translation files
+We have made it easier to serve Sigma users in your organization and consumers of embedded analytics with content in their preferred language.
+
+Sigma admins can create organization-wide `translation files` to translate custom strings that are common across workbooks in an organization, saving time and ensuring a consistent experience. 
+
+<img src="assets/fff_05_2024_6.png" width="400"/>
+
+Workbook owners inherit the organization-level translations and can override and supplement them with translations unique to an individual workbook. For more information, see:
+
+[Manage organization translation files](https://help.sigmacomputing.com/docs/manage-organization-translation-files)
+[Manage workbook localization](https://help.sigmacomputing.com/docs/manage-workbook-localization)
+[New translations API endpoints](https://help.sigmacomputing.com/reference/change-log#new-translations-api-endpoints)
+
+
+![Footer](assets/sigma_footer.png)
+
+## API
+Duration: 20
+
+### New API reference and recipes
+We have migrated to a new API Reference platform that is far more feature rich while being easier to use.
+
+All API reference documentation has moved [here.](https://help.sigmacomputing.com/reference/get-started-sigma-api)
+
+The new structure for the API reference offers better in-line documentation for endpoints and interactive code samples in a variety of languages:
+
+<img src="assets/api.gif">
+
+In addition, we have published API code samples ([Recipes](https://help.sigmacomputing.com/recipes)) and a [corresponding QuickStart](https://quickstarts.sigmacomputing.com/guide/administration_api_code_samples/index.html?_gl=1*2dnp9q*_ga*ODgwOTI4NTIyLjE3MTM1NjI2OTE.*_ga_PMMQG4DCHC*MTcxNjU3MzM1OC4yOC4xLjE3MTY1NzM0MTMuNS4wLjA.#0) that walks you through real-world code examples using the API. 
+
+All the current "Recipes" are written in JavaScript today. The recipes can be downloaded individually from the [Recipes page]() and are also available in a public [Git repository]().
+
+The following Recipes are available today:
+
+<img src="assets/recipeslist.png" width="800"/>
+
+### SUPPORT_CHATS audit log dimension table
+We have added a new log table that provides reference information about user interactions with Sigma's live chat support feature.
+
+The `SIGMA_SHARED` schema in the Sigma `Audit Logs` connection now features a `SUPPORT_CHATS` dimension table containing information about individual live chat conversations, including timestamp, user name, user email, and the full chat transcript.
+
+Customers can build a dashboard or report that includes this information to allow others to access or be updated on support status.
+
+![Footer](assets/sigma_footer.png)
+
+## Bug Fixes
+Duration: 20
+
+**1:** Administrators can no longer circumvent UI restrictions to raise privileges of guest and embed users.<br><br>
+**2:** Sigma no longer throws an error when multiple embeds attempt to add a new user at the same time.<br><br>
+**3:** In the `Administration` > `Embeds` page, you can now successfully preview an embed in the `Embed Sandbox` when you click `More` and select `Test embed`.<br><br>
+**4:** When viewing an individual embed user's profile in the `Administration` > `People` page, the `Edit member` and account type modal now displays "Embed user" in the Account type field instead of “Invalid selection.”<br><br>
+**5:**A user’s Sigma access token now expires when the OAuth access token expires, ensuring the user is logged out when the OAuth session has ended.<br><br>
+**6:**Updates to filters and sorting in tagged workbook versions are now reflected in exports and no longer trigger errors.
+
+![Footer](assets/sigma_footer.png)
+
+## Input Tables
+Duration: 20
+
+### CSV input tables
+You can now pre-populate a new input table with uploaded CSV data that you can then edit at the cell level.
+
+Like empty input tables, CSV input tables support data entry independent of existing data, enabling you to add editable rows and columns to construct the table as you see fit.
+
+For more information, [see Intro to input tables](https://help.sigmacomputing.com/docs/intro-to-input-tables) and [Create new input tables.](https://help.sigmacomputing.com/docs/create-new-input-tables)
+
+There is also a [QuickStart that covers several common use cases here.](https://quickstarts.sigmacomputing.com/guide/input_tables_use_cases/index.html?index=..%2F..index#0)
+
+![Footer](assets/sigma_footer.png)
+
+## Embedding
+Duration: 20
+
+### Embed Events (formally known as Action and Events):
+To avoid confusion with Sigma's new [Actions feature](https://help.sigmacomputing.com/docs/intro-to-actions), we have renamed embedded Actions and Events to `Embed Events`. 
+
+There are two types:
+**Inbound Events:**
+Are variables sent from the Parent application to Sigma. There is no "listener" to code into the iframe; Sigma handles that out-of-the-box. Sigma can use these messages to update control values. For example, passing a new value to a Sigma control that is used to filter table data.
+
+Inbound events can be passed using either JavaScript or URL.
+
+**Out-bound Events:**
+Are variables sent from Sigma to the Parent application which must have a "listener" coded into the Parent application to receive and react to the message as desire
+
+For more information, see [Implement inbound and outbound events in embeds.](https://help.sigmacomputing.com/docs/inbound-and-outbound-events-in-embeds)
+
+Embed Events are discussed and demonstrated in this [QuickStart.](https://quickstarts.sigmacomputing.com/guide/embedding_07_events/index.html?index=..%2F..index#0)
+
+### New Embedded Events
+Sigma has added many new events to support existing and new functionality.
+
+#### New Inbound events:
+```code
+workbook:bookmark:create
+workbook:fullscreen:update
+workbook:selectednodeid:update
+workbook:variables:list
+workbook:variables:update
+```
+
+#### New Outbound events:
+```code
+url:onchange
+workbook:bookmark:oncreate
+workbook:bookmark:update
+workbook:chart:error
+workbook:dataloaded
+workbook:error
+workbook:fullscreen:onchange
+workbook:id:onchange
+workbook:pageheight:onchange
+workbook:pivottable:oncellselect
+workbook:published
+```
+
+For more information, see [Implement inbound and outbound events in embeds.](https://help.sigmacomputing.com/docs/inbound-and-outbound-events-in-embeds)
+
+There is also a [QuickStart for using events with Sigma embedding.](https://quickstarts.sigmacomputing.com/guide/embedding_07_events/index.html?index=..%2F..index#0)
+
+### nodeType property for workbook:selectednodeid:update
+We have added the ability to programmatically determine whether a selected node is a page or an element by referencing the nodeType property in the inbound event.
+
+```code 
+workbook:selectednodeid:update
+```
+
+For more information, see [Available inbound events.](https://help.sigmacomputing.com/docs/inbound-and-outbound-events-in-embeds#workbookselectednodeidupdate)
+
+![Footer](assets/sigma_footer.png)
+
+## New QuickStarts in May
+Duration: 20
+
+### Sigma REST API Recipes
+
+This [QuickStart](https://quickstarts.sigmacomputing.com/guide/administration_api_code_samples/index.html?_gl=1*2dnp9q*_ga*ODgwOTI4NTIyLjE3MTM1NjI2OTE.*_ga_PMMQG4DCHC*MTcxNjU3MzM1OC4yOC4xLjE3MTY1NzM0MTMuNS4wLjA.#0) is designed to support Sigma's API Recipes and demonstrates many common operations that customers may use the REST API for.
+
+## Visualizations
+Duration: 20
+
+### Dynamic button text
+You can now add dynamic values to button elements. 
+
+When configuring the button text, enter `=` to include a dynamic value defined by a formula expression.
+
+<img src="assets/fff_05_2024_5.png" width="800"/>
+
+For more information about buttons, see [Create a button element.](https://help.sigmacomputing.com/docs/create-a-button-element)
+
+![Footer](assets/sigma_footer.png)
+
+## Workbooks
+Duration: 20
+
+### Custom formula aggregations in chart reference marks
+You can now specify a `custom formula aggregation` when configuring reference marks in charts.
+
+For more information about reference marks, see [Display chart reference marks.](https://help.sigmacomputing.com/docs/display-chart-reference-marks)
+
+### Data labels in maps
+Add one or more columns to generate data labels in point and region maps. This update makes it easier to quickly view at-a-glance details directly in the element.
+
+For more information, see [Display chart data labels.](https://help.sigmacomputing.com/docs/display-chart-data-labels)
+
+### Default version tags
+Users with `Can edit` workbook permission can now designate a tag as the default tag for a workbook. As a result, any user who does not have access to the `Published` workbook will see the default tagged version. 
+
+Applying default tags to workbooks with multiple tags results in a more consistent viewing experience.
+
+For more information, see [Set a default tag for a workbook.](https://help.sigmacomputing.com/docs/version-tagging#set-a-default-tag-for-a-workboo)
+
+### Donut hole value in donut charts
+Display an aggregate value within the hole of a donut chart to add more context to your visualization.
+
+<img src="assets/fff_05_2024_7.png" width="400"/>
+
+For details about adding a donut hole value, see [Pie and donut charts.](https://help.sigmacomputing.com/docs/pie-and-donut-charts)
+
+### Embedding Sigma's documentation now supported
+Many customers provide useful information on how to best use Sigma workbooks directly in the workbook itself. 
+
+There are time when it can be used to embed specific Sigma documentation content from the Sigma help pages. 
+
+This is quite easy to do now using the [Embed element](https://help.sigmacomputing.com/docs/intro-to-ui-elements#embed-element)
+
+For example, you may want to provide a basic introduction to your new users on how to get started with Sigma:
+
+<img src="assets/fff_05_2024_1.png" width="800"/>
+
+Another example is to provide the list of popular functions that are available:
+
+<img src="assets/fff_05_2024_2.png" width="800"/>
+
+Users will appreciate the time saved by avoiding opening another browser page to access documentation.
+
+### Enhanced SQL editor (Beta)
+We have added a new, in-line SQL editor that allows SQL users to write their code directly in the workbook, and reference / build on top of other elements in the workbook.
+
+Use the new SQL editor—featuring a more integrated and collaborative experience—to build workbooks, datasets, and elements (tables, pivot tables, and visualizations) with custom SQL.
+
+<aside class="positive">
+<strong>IMPORTANT:</strong><br> The new SQL editor replaces a previous, more limited SQL editing feature. This is a public beta feature that’s subject to quick, iterative changes. As a result, the latest product version may differ from the contents of this document.
+</aside>
+
+The `Beta` release includes the following enhanced capabilities:
+
+ <ul>
+      <li> Toggle to an inline SQL editor view within any SQL-based workbook element, and expand the element to enter full screen mode.</li>
+      <li> Collaborate with other workbook developers in a live editing environment.</li>
+      <li> Use search and replace functionality within the custom SQL.</li>
+      <li> Apply autocomplete suggestions featuring improved performance.</li>
+      <li> View and access custom SQL from the workbook Lineage view.</li>
+
+</ul>
+
+For more information about using custom SQL directly in Sigma, see [Write custom SQL.](https://help.sigmacomputing.com/docs/write-custom-sql)
+
+For a video demonstration, [click here.](https://www.loom.com/share/4ae2e65a1d18447b867e209d7f6e1887?sid=bd5366a2-a372-4396-b437-e8b6f7e43bef)
+
+<aside class="positive">
+<strong>IMPORTANT:</strong><br> Sigma is continually working to improve usability for our customers. We want Sigma to not only be simple to use, but also beautiful looking.
+</aside>
+
+### Improved data source selection UI
+Select data sources for workbook elements using a new popover UI. 
+
+With the new experience, you can `search` for data sources, `review` a list of suggested sources, and `preview` data sources. 
+
+<img src="assets/fff_05_2024_3.png" width="800"/>
+
+Preview a data source to review the source data and choose specific columns to apply to the element:
+
+<img src="assets/fff_05_2024_4.png" width="800"/>
+
+
+
+For more information, see [Create a data element.](https://help.sigmacomputing.com/docs/create-a-data-element)
+
+![Footer](assets/sigma_footer.png)
+
+## Additional Information
+Duration: 20
+
+**Additional Resource Links**
+
+[Blog](https://www.sigmacomputing.com/blog/)<br>
+[Community](https://community.sigmacomputing.com/)<br>
+[Help Center](https://help.sigmacomputing.com/hc/en-us)<br>
+[QuickStarts](https://quickstarts.sigmacomputing.com/)<br>
+<br>
+
+[<img src="./assets/twitter.png" width="75"/>](https://twitter.com/sigmacomputing)&emsp;
+[<img src="./assets/linkedin.png" width="75"/>](https://www.linkedin.com/company/sigmacomputing)&emsp;
+[<img src="./assets/facebook.png" width="75"/>](https://www.facebook.com/sigmacomputing)
+
+![Footer](assets/sigma_footer.png)

site/sigmaguides/src/embedding_07_actions_events/embedding_07_actions_events.md

@@ -19,6 +19,8 @@ We also recommend you table the the QuickStart [Embedding 3: Application Embeddi
 
 **Some steps may not be shown in detail as we assume you have taken these other two QuickStarts or are familiar with Sigma workflows.**
 
+A list of all the [available events is available here.](https://help.sigmacomputing.com/docs/inbound-and-outbound-events-in-embeds)
+
 ### Target Audience
 Semi-technical users who will be aiding in the planning or implementation of Sigma. Limited SQL and technical data skills are needed to do this QuickStart. It does assume some common computer skills like installing software, using Terminal, navigating folders and edit/copy/paste operations.