You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
[excel] (Samples) Adjust how the samples and scenarios are branded (#686)
* Organize samples to better separate complexity
* Add description
* Update TOC
* Apply suggestions from code review
Co-authored-by: Elizabeth Samuel <[email protected]>
* PR feedback
---------
Co-authored-by: Elizabeth Samuel <[email protected]>
Copy file name to clipboardExpand all lines: docs/resources/samples/add-excel-comments.md
+4-4Lines changed: 4 additions & 4 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,11 +1,11 @@
1
1
---
2
-
title: Add comments in Excel
3
-
description: Learn how to use Office Scripts to add comments in a worksheet.
4
-
ms.date: 10/20/2023
2
+
title: Notify people with comments
3
+
description: Learn how to use Office Scripts to add comments in a worksheet that notify users with @mentions.
4
+
ms.date: 12/05/2023
5
5
ms.localizationpriority: medium
6
6
---
7
7
8
-
# Add comments in Excel
8
+
# Notify people with comments
9
9
10
10
This sample shows how to add comments to a cell including [@mentioning](https://support.microsoft.com/office/90701709-5dc1-41c7-aa48-b01d4a46e8c7) a colleague.
Copy file name to clipboardExpand all lines: docs/resources/samples/range-samples.md
+4-4Lines changed: 4 additions & 4 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,11 +1,11 @@
1
1
---
2
-
title: Rangesin Office Scripts
3
-
description: A collection of code samples showing how to work with Excel ranges in Office Scripts.
4
-
ms.date: 09/08/2023
2
+
title: 'Ranges: Work with the grid in Office Scripts'
3
+
description: A collection of code samples showing how to work with Excel ranges, collections of cells, in Office Scripts.
4
+
ms.date: 12/05/2023
5
5
ms.localizationpriority: medium
6
6
---
7
7
8
-
# Ranges in Office Scripts
8
+
# Ranges: Work with the grid in Office Scripts
9
9
10
10
The following samples are simple scripts for you to try on your own workbooks. They form the building blocks to larger solutions. Expand these scripts to extend your solution and solve common problems.
Copy file name to clipboardExpand all lines: docs/resources/samples/samples-overview.md
+31-23Lines changed: 31 additions & 23 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,17 +1,18 @@
1
1
---
2
2
title: Office Scripts samples
3
3
description: Available Office Scripts samples and scenarios.
4
-
ms.date: 09/20/2023
4
+
ms.date: 12/05/2023
5
5
ms.localizationpriority: medium
6
6
---
7
7
8
8
# Office Scripts samples and scenarios
9
9
10
10
This section contains [Office Scripts](../../overview/excel.md) based solutions that help end users achieve automation of daily tasks. It contains realistic scenarios that users face and provides detailed solutions.
11
11
12
-
-[Basics](#basics) showcase common examples that make up larger scripts. Most don't need a specific workbook or dataset and can be run in the workbook of your choice.
13
-
-[Beyond the basics](#beyond-the-basics) are samples that are more involved or solve a particular problem. Some use Power Automate with an Office Script as a integral part of the flow.
14
-
-[Scenarios](#scenarios) are a few larger samples that demonstrate real-world use cases.
12
+
-[Basics](#basics) showcase common examples that make up larger scripts. They're categorized based on a common Excel feature.
13
+
-[Quick scenarios](#quick-scenarios) are samples that are more involved or solve a particular problem.
14
+
-[Cross-application scenarios](#cross-application-scenarios) are samples that use Power Automate with one or more Office Scripts as integral parts of the flow.
15
+
-[Real-world scenarios](#real-world-scenarios) are a few larger samples framed as complete, real-world solutions.
15
16
-[Contributions from the community](#community-contributions-and-fun-samples) are samples from members of the Office Scripts community, often light-hearted in nature.
16
17
17
18
> [!IMPORTANT]
@@ -21,38 +22,45 @@ This section contains [Office Scripts](../../overview/excel.md) based solutions
21
22
22
23
| Project | Details |
23
24
|---------|---------|
24
-
|[Range samples](range-samples.md)| These samples show how to work the `Range` object, which is central to most scripts. |
25
-
| [Table samples](table-samples.md) | A collection of samples that show common interactions with Excel tables.
26
-
|[Add comments in Excel](add-excel-comments.md)| This sample adds comments to a cell including @mentioning a colleague. |
27
-
|[Add images to a workbook](add-image-to-workbook.md)| This sample adds an image to a workbook and copies an image across sheets.|
28
-
|[Copy multiple Excel tables into a single table](copy-tables-combine.md)| This sample combines data from multiple Excel tables into a single table that includes all the rows. |
29
-
|[Data validation: dropdown lists, prompts, and warning pop-ups](data-validation-samples.md)| These samples show how to use data validation to mandate specific conditions for cell data and how the user is alerted to these rules. |
30
-
|[Create a workbook table of contents](table-of-contents.md)| This sample creates a table of contents with links to each worksheet. |
31
-
|[JavaScript `Date` samples](javascript-dates.md)| A collection of samples that show how to translate between JavaScript and Excel date formats. |
32
-
|[Record day-to-day changes in Excel and report them with a Power Automate flow](report-day-to-day-changes.md)| This sample uses a scheduled Power Automate flow to record daily readings and report the changes. |
25
+
|[Ranges: Work with the grid](range-samples.md)| These samples show how to work the `Range` object, which is central to most scripts. |
26
+
|[Data validation samples: Dropdown lists, prompts, and warning pop-ups](data-validation-samples.md)| These samples show how to use data validation to mandate specific conditions for cell data and how the user is alerted to these rules. |
27
+
|[Date samples](javascript-dates.md)| A collection of samples that show how to translate between JavaScript and Excel date formats. |
28
+
|[Image samples](add-image-to-workbook.md)| This sample adds an image to a workbook and copies an image across sheets.|
33
29
|[Row and column visibility samples](row-and-column-visibility.md)| A collection of samples that demonstrate how to show, hide, and freeze rows and columns. |
34
-
|[Run a script on all Excel files in a folder](automate-tasks-on-all-excel-files-in-folder.md)| This project performs a set of automation tasks on all files situated in a folder on OneDrive for Business (can also be used for a SharePoint folder). It performs calculations on the Excel files, adds formatting, and inserts a comment that @mentions a colleague. |
35
-
|[Set conditional formatting for cross-column comparisons](conditional-formatting-parameters.md)| This sample applies formatting based on values in adjacent columns. It also gets user input through script parameters. |
30
+
|[Table samples](table-samples.md)| A collection of samples that show common interactions with Excel tables. |
36
31
37
-
## Beyond the basics
32
+
## Quick scenarios
38
33
39
-
Check out the following end-to-end project that automates sample scenarios along with full scripts, sample Excel files used, and [videos (hosted on YouTube)](https://www.youtube.com/playlist?list=PLr3zVPZrMOUMl88fs8uc2GGAePRnNe6m0).
34
+
Be sure to download the sample workbooks included with each sample. That lets you skip setup and understand the core concept the sample demonstrates.
40
35
41
36
| Project | Details |
42
37
|---------|---------|
43
-
|[Combine worksheets into a single workbook](combine-worksheets-into-single-workbook.md)| This sample uses Office Scripts and Power Automate to pull data from other workbooks into a single workbook. |
44
-
|[Convert CSV files to Excel workbooks](convert-csv.md)| This sample uses Office Scripts and Power Automate to create .xlsx files from .csv files. |
45
-
|[Cross-reference workbooks](excel-cross-reference.md)| This sample uses Office Scripts and Power Automate to cross-reference and validate information in different workbooks. |
38
+
|[Copy multiple Excel tables into a single table](copy-tables-combine.md)| This sample combines data from multiple Excel tables into a single table that includes all the rows. |
39
+
|[Create a workbook table of contents](table-of-contents.md)| This sample creates a table of contents with links to each worksheet. |
46
40
|[Count blank rows in a specific sheet or in all sheets](count-blank-rows.md)| This sample detects if there are any blank rows in sheets where you anticipate data to be present and then report the blank row count for usage in a Power Automate flow. |
47
-
|[Email chart and table images](email-images-chart-table.md)| This sample uses Office Scripts and Power Automate actions to create a chart and send that chart as an image by email. |
48
41
|[Manage calculation mode in Excel](excel-calculation.md)| This sample shows how to use the calculation mode and calculate methods in Excel using Office Scripts. |
49
42
|[Move rows across tables](move-rows-across-tables.md)| This sample shows how to move rows across tables by saving filters, then processing and reapplying the filters. |
43
+
|[Notify people with comments](add-excel-comments.md)| This sample adds comments to a cell including @mentioning a colleague. |
50
44
|[Output Excel data as JSON](get-table-data.md)| This solution shows how to output Excel table data as JSON to use in Power Automate. |
51
45
|[Remove hyperlinks from each cell in an Excel worksheet](remove-hyperlinks-from-cells.md)| This sample clears all of the hyperlinks from the current worksheet. |
46
+
|[Set conditional formatting for cross-column comparisons](conditional-formatting-parameters.md)| This sample applies formatting based on values in adjacent columns. It also gets user input through script parameters. |
52
47
|[Use external fetch calls](external-fetch-calls.md)| This sample uses `fetch` to get information from GitHub for the script. |
53
-
|[Write a large dataset](write-large-dataset.md)| This sample shows how to send a large range as smaller subranges. |
54
48
55
-
## Scenarios
49
+
## Cross-application scenarios
50
+
51
+
Use [Power Automate](https://make.powerautomate.com/) to connect other applications to Excel. Have your scripts power emails, forms, Teams messages, and more. These samples include step-by-step instructions to create each Power Automate flow.
52
+
53
+
| Project | Details |
54
+
|---------|---------|
55
+
|[Combine worksheets into a single workbook](combine-worksheets-into-single-workbook.md)| This sample uses Office Scripts and Power Automate to pull data from other workbooks into a single workbook. |
56
+
|[Convert CSV files to Excel workbooks](convert-csv.md)| This sample uses Office Scripts and Power Automate to create .xlsx files from .csv files. |
57
+
|[Cross-reference workbooks](excel-cross-reference.md)| This sample uses Office Scripts and Power Automate to cross-reference and validate information in different workbooks. |
58
+
|[Email chart and table images](email-images-chart-table.md)| This sample uses Office Scripts and Power Automate actions to create a chart and send that chart as an image by email. |
59
+
|[Record day-to-day changes in Excel and report them with a flow](report-day-to-day-changes.md)| This sample uses a scheduled Power Automate flow to record daily readings and report the changes. |
60
+
|[Run a script on all Excel files in a folder](automate-tasks-on-all-excel-files-in-folder.md)| This sample performs a set of automation tasks on all files situated in a folder on OneDrive for Business (can also be used for a SharePoint folder). It performs calculations on the Excel files, adds formatting, and inserts a comment that @mentions a colleague. |
61
+
|[Write a large dataset](write-large-dataset.md)| This sample shows how to work with a large range as smaller subranges. This helps flows handle data transfer limits and operation timeouts. |
62
+
63
+
## Real-world scenarios
56
64
57
65
Office Scripts can automate parts of your daily routine. These day-to-day tasks often exist in unique ecosystems, with Excel workbooks that are set up in particular ways. These larger scenario samples demonstrate such real-world use-cases. They include both the Office Scripts and the workbooks, so you can see the scenario from end to end.
0 commit comments