docs: Saved Reports in Cube Cloud (#9607)

Author: igorlukanin

docs/pages/product/apis-integrations/google-sheets.mdx

@@ -117,10 +117,14 @@ Click <Btn>Edit</Btn> to chnage the query or the location.
   highlight="inset(15% 0 25% 76.5% round 10px)"
 />
 
+You can also manage saved reports in the <Btn>[Saved Reports][ref-saved-reports]</Btn> page
+in Cube Cloud.
+
 
 [link-google-sheets]: https://workspace.google.com/products/sheets/
 [link-marketplace-listing]: https://workspace.google.com/u/0/marketplace/app/cube_cloud_for_sheets/641460343379
 [ref-playground]: /product/workspace/playground
 [ref-views]: /product/data-modeling/concepts#views
 [ref-pre-aggs]: /product/caching/using-pre-aggregations
-[ref-sql-api-enabled]: /product/apis-integrations/sql-api#cube-cloud
+[ref-sql-api-enabled]: /product/apis-integrations/sql-api#cube-cloud
+[ref-saved-reports]: /product/workspace/saved-reports

docs/pages/product/apis-integrations/microsoft-excel.mdx

@@ -123,6 +123,9 @@ Click <Btn>Edit</Btn> to chnage the query or the location.
   highlight="inset(22.5% 0 20% 72.5% round 10px)"
 />
 
+You can also manage saved reports in the <Btn>[Saved Reports][ref-saved-reports]</Btn> page
+in Cube Cloud.
+
 
 [ref-excel]: /product/configuration/visualization-tools/excel
 [ref-mdx-api]: /product/apis-integrations/mdx-api
@@ -132,4 +135,5 @@ Click <Btn>Edit</Btn> to chnage the query or the location.
 [ref-pre-aggs]: /product/caching/using-pre-aggregations
 [ref-sql-api-enabled]: /product/apis-integrations/sql-api#cube-cloud
 [link-excel-addins]: https://support.microsoft.com/en-us/office/add-or-remove-add-ins-in-excel-0af570c4-5cf3-4fa9-9b88-403625a0b460
-[link-ms-appsource]: https://appsource.microsoft.com/en-us/product/office/WA200008486
+[link-ms-appsource]: https://appsource.microsoft.com/en-us/product/office/WA200008486
+[ref-saved-reports]: /product/workspace/saved-reports

docs/pages/product/workspace.mdx

@@ -19,6 +19,9 @@ editor to build and enhance the data model of your semantic layer.
 - Use the [development mode][ref-dev-mode] and [environments][ref-environments] to
 collaborate and test features before going to production.
 - Use [Playground][ref-playground] to run queries and test the data model.
+- Use [Saved Reports][ref-saved-reports] to manage reports saved from Playground and
+spreadsheet integrations, i.e., [Cube Cloud for Sheets][ref-sheets-integration] and
+[Cube Cloud for Excel][ref-excel-integration].
 - Use [Chart Prototyping][ref-vizard] to generate code of a front-end
   application that works with Cube.
 - Use [SQL Runner][ref-sql-runner] to inform the development of the data
@@ -76,4 +79,7 @@ With Cube Core, you can:
 [ref-semantic-catalog]: /product/workspace/semantic-catalog
 [ref-encryption-keys]: /product/workspace/encryption-keys
 [ref-cube-store-encryption]: /product/caching/running-in-production#data-at-rest-encryption
-[ref-visual-model]: /product/workspace/visual-model
+[ref-visual-model]: /product/workspace/visual-model
+[ref-saved-reports]: /product/workspace/saved-reports
+[ref-sheets-integration]: /product/apis-integrations/google-sheets
+[ref-excel-integration]: /product/apis-integrations/excel

docs/pages/product/workspace/_meta.js

@@ -3,6 +3,7 @@ module.exports = {
   "vizard": "Chart Prototyping",
   "data-model": "Data Model",
   "visual-model": "Visual Model",
+  "saved-reports": "Saved Reports",
   "rollup-designer": "Rollup Designer",
   "dev-mode": "Development mode",
   "environments": "Environments",

docs/pages/product/workspace/playground.mdx

@@ -124,6 +124,17 @@ and will be restored when you open Playground once again.
 
 You can also double-click on a query tab to give it a meaningful name.
 
+### Saving a report
+
+You can save a _query to a view_ by clicking <Btn>Save Report</Btn> in the top right corner.
+
+<Screenshot
+  src="https://ucarecdn.com/c4865552-59ab-4d20-bd7d-5310be07e16c/"
+  highlight="inset(6% 0 88% 91% round 10px)"
+/>
+
+You can manage saved reports in the <Btn>[Saved Reports][ref-saved-reports]</Btn> page.
+
 ## Viewing results
 
 Click <Btn>Run Query</Btn> on the top to run (or re-run) the query and check the
@@ -216,4 +227,5 @@ manually.
 [ref-time-zone]: /product/apis-integrations/queries#time-zone
 [ref-row-limit]: /product/apis-integrations/queries#limit
 [ref-chart-prototyping]: /product/workspace/vizard
-[ref-boolean-filters]: /product/apis-integrations/rest-api/query-format#boolean-logical-operators
+[ref-boolean-filters]: /product/apis-integrations/rest-api/query-format#boolean-logical-operators
+[ref-saved-reports]: /product/workspace/saved-reports

docs/pages/product/workspace/saved-reports.mdx

@@ -0,0 +1,81 @@
+# Saved Reports
+
+Saved Reports provides a way to manage reports saved from [Playground][ref-playground]
+and spreadsheet integrations, i.e., [Cube Cloud for Sheets][ref-sheets-integration]
+and [Cube Cloud for Excel][ref-excel-integration].
+
+<SuccessBox>
+
+Saved Reports are available in Cube Cloud on
+[Premium and above](https://cube.dev/pricing) product tiers.
+
+</SuccessBox>
+
+<WarningBox>
+
+Saved Reports are currently in preview.
+
+</WarningBox>
+
+You can [create reports](#creating-reports) and then [manage](#managing-reports) them:
+[view](#viewing-reports) reports, [organize](#organizing-reports) them into folders,
+and [share](#sharing-reports) them with your team.
+
+## Creating reports
+
+### Playground
+
+You can compose a _query to a [view][ref-views]_ in [Playground][ref-playground] and then
+save it by clicking the <Btn>Save Report</Btn> button.
+
+<Screenshot
+  src="https://ucarecdn.com/c4865552-59ab-4d20-bd7d-5310be07e16c/"
+  highlight="inset(6% 0 88% 91% round 10px)"
+/>
+
+### Spreadsheets
+
+You can create a report in [Cube Cloud for Sheets][ref-sheets-integration] or [Cube Cloud
+for Excel][ref-excel-integration]. When ready, click the <Btn>Save</Btn> button to save
+the report.
+
+<Screenshot
+  src="https://ucarecdn.com/b51aeae7-a0bf-450d-a7b4-849de68c1fa1/"
+  highlight="inset(23% 0 72% 95% round 10px)"
+/>
+
+## Managing reports
+
+You can find all saved reports by going to <Btn>Saved Reports</Btn> in the top-level menu.
+
+### Viewing reports
+
+View reports in the root folder or navigate to subfolders to view reports there.
+
+<Screenshot src="https://ucarecdn.com/21474fc2-17bb-45d0-a3da-09a0ae28ad02/" />
+
+### Organizing reports
+
+You can organize reports into folders. Click <Btn>+ New Folder</Btn> to create a new folder.
+
+If you'd like to move a report into another folder, click <Btn>... → Move</Btn> and select
+the destination folder in the modal window.
+
+<Screenshot src="https://ucarecdn.com/d9bc50ec-9875-479d-8a0e-53f4b748a07e/" />
+
+### Sharing reports
+
+You can share reports with members of your team by managing their [access
+control][ref-rbac] roles.
+
+If you'd like to share a report with a team member, click <Btn>... → Share</Btn> and select
+the role in the modal window.
+
+<Screenshot src="https://ucarecdn.com/d536dbed-a40d-450f-8adf-02a4b697d8df/" />
+
+
+[ref-playground]: /product/workspace/playground
+[ref-sheets-integration]: /product/apis-integrations/google-sheets
+[ref-excel-integration]: /product/apis-integrations/excel
+[ref-views]: /product/data-modeling/concepts#views
+[ref-rbac]: /product/workspace/access-control#managing-roles