[excel] (Samples) Add buttons to workbook downloads (#665)

AlexJerabek · web-flow · commit adf074eac509 · 2023-10-20T13:31:26.000-07:00
* Test button

* BUtton as next step

* Add more buttons

* Revert zip file download links

* More buttons

* Comment sample test

* Make the button not seem optional

* Typo fix
diff --git a/docs/develop/pivottables.md b/docs/develop/pivottables.md
@@ -1,7 +1,7 @@
 ---
 title: Work with PivotTables in Office Scripts
 description: Learn about the object model for PivotTables in the Office Scripts JavaScript API.
-ms.date: 09/08/2023
+ms.date: 10/19/2023
 ms.localizationpriority: medium
 ---
 
@@ -26,7 +26,10 @@ The [PivotTable](/javascript/api/office-scripts/excelscript/excelscript.pivottab
 - The [PivotLayout](/javascript/api/office-scripts/excelscript/excelscript.pivotlayout) defines how the [PivotFields](/javascript/api/office-scripts/excelscript/excelscript.pivotfield) and [PivotItems](/javascript/api/office-scripts/excelscript/excelscript.pivotitem) are displayed.
 - [PivotFilters](/javascript/api/office-scripts/excelscript/excelscript.pivotfilters) filter data from the [PivotTable](/javascript/api/office-scripts/excelscript/excelscript.pivottable) using different criteria.
 
-Look at how these relationships work in practice. The following data describes fruit sales from various farms. It's the base for all the examples in this article. Use [pivottable-sample.xlsx](pivottable-sample.xlsx) to follow along.
+To look at how these relationships work in practice, start by downloading the sample workbook. That data describes fruit sales from various farms. It's the base for all the examples in this article. Run the sample scripts throughout the article to create and explore PivotTables.
+
+> [!div class="nextstepaction"]
+> [Download the sample workbook](pivottable-sample.xlsx)
 
 :::image type="content" source="../images/pivottable-raw-data.png" alt-text="A collection of fruit sales of different types from different farms.":::
 
diff --git a/docs/resources/samples/add-excel-comments.md b/docs/resources/samples/add-excel-comments.md
@@ -1,7 +1,7 @@
 ---
 title: Add comments in Excel
 description: Learn how to use Office Scripts to add comments in a worksheet.
-ms.date: 08/14/2023
+ms.date: 10/20/2023
 ms.localizationpriority: medium
 ---
 
@@ -11,22 +11,25 @@ This sample shows how to add comments to a cell including [@mentioning](https://
 
 ## Example scenario
 
-* The team lead maintains the shift schedule. The team lead assigns an employee ID to the shift record.
-* The team lead wishes to notify the employee. By adding a comment that @mentions the employee, the employee is emailed with a custom message from the worksheet.
-* Subsequently, the employee can view the workbook and respond to the comment at their convenience.
+The team lead maintains the shift schedule. They assign an employee ID to the shift record. If the team lead wishes to notify the employee, they add a comment that @mentions the employee. The employee is emailed with a custom message from the worksheet. Subsequently, the employee can view the workbook and respond to the comment at their convenience.
 
 ## Solution
 
 1. The script extracts employee information from the employee worksheet.
 1. The script then adds a comment (including the relevant employee email) to the appropriate cell in the shift record.
 1. Existing comments in the cell are removed before adding the new comment.
 
-## Sample Excel file
+## Setup: Sample Excel file
 
-Download [add-excel-comments.xlsx](add-excel-comments.xlsx) for a ready-to-use workbook. Add the following script to try the sample yourself!
+This workbook contains the data, objects, and formatting expected by the script.
+
+> [!div class="nextstepaction"]
+> [Download the sample workbook](add-excel-comments.xlsx)
 
 ## Sample code: Add comments
 
+Add the following script to the sample workbook and try the sample yourself!
+
 ```TypeScript
 function main(workbook: ExcelScript.Workbook) {
   // Get the list of employees.
diff --git a/docs/resources/samples/add-image-to-workbook.md b/docs/resources/samples/add-image-to-workbook.md
@@ -17,12 +17,17 @@ The first sample copies an image from one worksheet to another. This could be us
 
 The second sample copies an image from a URL. This could be used to copy photos that a colleague stored in a shared folder to a related workbook. Please note that this sample can't be adapted to work with a local image file, as that isn't supported by Office Scripts.
 
-## Sample Excel file
+## Setup: Sample Excel file
 
-Download [add-images.xlsx](add-images.xlsx) for a ready-to-use workbook. Add the following scripts and try the sample yourself!
+This workbook contains the data, objects, and formatting expected by the script.
+
+> [!div class="nextstepaction"]
+> [Download the sample workbook](add-images.xlsx)
 
 ## Sample code: Copy an image across worksheets
 
+Add the following script to the sample workbook and try the sample yourself!
+
 ```TypeScript
 /**
  * This script transfers an image from one worksheet to another.
diff --git a/docs/resources/samples/community-seasons-greetings.md b/docs/resources/samples/community-seasons-greetings.md
@@ -13,9 +13,16 @@ Enjoy!
 
 [Watch the Seasons greetings script in action on the "Les's IT Blog" YouTube channel](https://youtu.be/HBiGEkzmkgo).
 
-## Script
+## Setup: Sample Excel file
 
-Download [happy-tree.xlsx](happy-tree.xlsx) for a ready-to-use workbook. Add the following script to try the sample yourself!
+This workbook contains the data, objects, and formatting expected by the script.
+
+> [!div class="nextstepaction"]
+> [Download the sample workbook](happy-tree.xlsx)
+
+## Sample code: Happy tree
+
+Add the following script to the sample workbook and try the sample yourself!
 
 ```TypeScript
 /* Original version by Leslie Black.  */
diff --git a/docs/resources/samples/copy-tables-combine.md b/docs/resources/samples/copy-tables-combine.md
@@ -14,12 +14,17 @@ There are two variations of this script:
 1. The [first script](#sample-code-combine-data-from-multiple-excel-tables-into-a-single-table) combines all tables in the Excel file.
 1. The [second script](#sample-code-combine-data-from-multiple-excel-tables-in-select-worksheets-into-a-single-table) selectively gets tables within a set of worksheets.
 
-## Sample Excel file
+## Setup: Sample Excel file
 
-Download [tables-copy.xlsx](tables-copy.xlsx) for a ready-to-use workbook. Add the following scripts to try the sample yourself!
+This workbook contains the data, objects, and formatting expected by the script.
+
+> [!div class="nextstepaction"]
+> [Download the sample workbook](tables-copy.xlsx)
 
 ## Sample code: Combine data from multiple Excel tables into a single table
 
+Add the following script to the sample workbook and try the sample yourself!
+
 ```TypeScript
 function main(workbook: ExcelScript.Workbook) {
   // Delete the "Combined" worksheet, if it's present.
diff --git a/docs/resources/samples/email-images-chart-table.md b/docs/resources/samples/email-images-chart-table.md
@@ -35,12 +35,17 @@ This solution has two parts:
 1. [An Office Script to calculate and extract Excel chart and table](#sample-code-calculate-and-extract-excel-chart-and-table)
 1. A Power Automate flow to invoke the script and email the results. For an example on how to do this, see [Create an automated workflow with Power Automate](../../tutorials/excel-power-automate-returns.md#create-an-automated-workflow-with-power-automate).
 
-## Sample Excel file
+## Setup: Sample Excel file
 
-Download [email-chart-table.xlsx](email-chart-table.xlsx) for a ready-to-use workbook. Add the following script to try the sample yourself!
+This workbook contains the data, objects, and formatting expected by the script.
+
+> [!div class="nextstepaction"]
+> [Download the sample workbook](email-chart-table.xlsx)
 
 ## Sample code: Calculate and extract Excel chart and table
 
+Add the following script to the sample workbook and try the sample yourself!
+
 ```TypeScript
 function main(workbook: ExcelScript.Workbook): ReportImages {
   // Recalculate the workbook to ensure all tables and charts are updated.
diff --git a/docs/resources/samples/get-table-data.md b/docs/resources/samples/get-table-data.md
@@ -9,9 +9,12 @@ ms.localizationpriority: medium
 
 Excel table data can be represented as an array of objects in the form of [JSON](https://www.w3schools.com/whatis/whatis_json.asp). Each object represents a row in the table. This helps extract the data from Excel in a consistent format that is visible to the user. The data can then be given to other systems through Power Automate flows.
 
-## Sample Excel file
+## Setup: Sample Excel file
 
-Download the file [table-data-with-hyperlinks.xlsx](table-data-with-hyperlinks.xlsx) for a ready-to-use workbook.
+This workbook contains the data, objects, and formatting expected by the script.
+
+> [!div class="nextstepaction"]
+> [Download the sample workbook](table-data-with-hyperlinks.xlsx)
 
 :::image type="content" source="../../images/table-input.png" alt-text="A worksheet showing input table data.":::
 
@@ -21,7 +24,7 @@ A variation of this sample also includes the hyperlinks in one of the table colu
 
 ## Sample code: Return table data as JSON
 
-Add the following script to try the sample yourself!
+Add the following script to the sample workbook and try the sample yourself!
 
 > [!NOTE]
 > You can change the `interface TableData` structure to match your table columns. Note that for column names with spaces, be sure to place your key in quotation marks, such as with `"Event ID"` in the sample. For more information about working with JSON, read [Use JSON to pass data to and from Office Scripts](../../develop/use-json.md).
diff --git a/docs/resources/samples/move-rows-across-tables.md b/docs/resources/samples/move-rows-across-tables.md
@@ -13,12 +13,17 @@ This script does the following:
 * Moves all selected rows into the target table in another worksheet.
 * Reapplies the relevant filters to the source table.
 
-## Sample Excel file
+## Setup: Sample Excel file
 
-Download the file [input-table-filters.xlsx](input-table-filters.xlsx) for a ready-to-use workbook. Add the following script to try the sample yourself!
+This workbook contains the data, objects, and formatting expected by the script.
+
+> [!div class="nextstepaction"]
+> [Download the sample workbook](input-table-filters.xlsx)
 
 ## Sample code: Move rows using range values
 
+Add the following script to the sample workbook and try the sample yourself!
+
 ```TypeScript
 function main(workbook: ExcelScript.Workbook) {
 
diff --git a/docs/resources/samples/remove-hyperlinks-from-cells.md b/docs/resources/samples/remove-hyperlinks-from-cells.md
@@ -12,12 +12,17 @@ ms.localizationpriority: medium
 > [!NOTE]
 > This only works if the cell count is < 10k.
 
-## Sample Excel file
+## Setup: Sample Excel file
 
-Download the file [remove-hyperlinks.xlsx](remove-hyperlinks.xlsx) for a ready-to-use workbook. Add the following script to try the sample yourself!
+This workbook contains the data, objects, and formatting expected by the script.
+
+> [!div class="nextstepaction"]
+> [Download the sample workbook](remove-hyperlinks.xlsx)
 
 ## Sample code: Remove hyperlinks
 
+Add the following script to the sample workbook and try the sample yourself!
+
 ```TypeScript
 function main(workbook: ExcelScript.Workbook, sheetName: string = 'Sheet1') {
   // Get the active worksheet. 
diff --git a/docs/resources/samples/report-day-to-day-changes.md b/docs/resources/samples/report-day-to-day-changes.md
@@ -9,12 +9,17 @@ ms.localizationpriority: medium
 
 Power Automate and Office Scripts combine to handle repetitive tasks for you. In this sample, you're tasked with recording a single numerical reading in a workbook every day and reporting the change since yesterday. You'll build a flow to get that reading, log it in the workbook, and report the change through an email.
 
-## Sample Excel file
+## Setup: Sample Excel file
 
-Download [daily-readings.xlsx](daily-readings.xlsx) for a ready-to-use workbook. Add the following script to try the sample yourself!
+This workbook contains the data, objects, and formatting expected by the script.
+
+> [!div class="nextstepaction"]
+> [Download the sample workbook](daily-readings.xlsx)
 
 ## Sample code: Record and report daily readings
 
+Add the following script to the sample workbook and try the sample yourself!
+
 ```TypeScript
 function main(workbook: ExcelScript.Workbook, newData: string): string {
   // Get the table by its name.
diff --git a/docs/resources/samples/table-of-contents.md b/docs/resources/samples/table-of-contents.md
@@ -11,12 +11,17 @@ This sample shows how to create a table of contents for the workbook. Each entry
 
 :::image type="content" source="../../images/table-of-contents-sample.png" alt-text="The table of contents worksheet showing links to the other worksheets.":::
 
-## Sample Excel file
+## Setup: Sample Excel file
 
-Download [table-of-contents.xlsx](table-of-contents.xlsx) for a ready-to-use workbook. Add the following script and try the sample yourself!
+This workbook contains the data, objects, and formatting expected by the script.
+
+> [!div class="nextstepaction"]
+> [Download the sample workbook](table-of-contents.xlsx)
 
 ## Sample code: Create a workbook table of contents
 
+Add the following script to the sample workbook and try the sample yourself!
+
 ```TypeScript
 function main(workbook: ExcelScript.Workbook) {
   // Insert a new worksheet at the beginning of the workbook.
diff --git a/docs/resources/scenarios/analyze-web-downloads.md b/docs/resources/scenarios/analyze-web-downloads.md
@@ -22,7 +22,9 @@ You'll develop a script that analyzes weekly downloads data in the active worksh
 
 ## Setup instructions
 
-1. Download [analyze-web-downloads.xlsx](analyze-web-downloads.xlsx) to your OneDrive.
+1. Download sample workbook to your OneDrive.
+    > [!div class="nextstepaction"]
+    > [Download the sample workbook](analyze-web-downloads.xlsx)
 
 1. Open the workbook in Excel.
 
diff --git a/docs/resources/scenarios/grade-calculator.md b/docs/resources/scenarios/grade-calculator.md
@@ -20,7 +20,9 @@ You'll develop a script that totals the grades for each point category. It will
 
 ## Setup instructions
 
-1. Download [grade-calculator.xlsx](grade-calculator.xlsx) to your OneDrive.
+1. Download sample workbook to your OneDrive.
+    > [!div class="nextstepaction"]
+    > [Download the sample workbook](grade-calculator.xlsx)
 
 1. Open the workbook in Excel.
 
diff --git a/docs/resources/scenarios/punch-clock.md b/docs/resources/scenarios/punch-clock.md
@@ -15,7 +15,9 @@ In this scenario, you'll create a time sheet for an employee that allows them to
 
 ## Setup instructions
 
-1. Download [punch-clock-sample.xlsx](punch-clock-sample.xlsx) to your OneDrive.
+1. Download the sample workbook to your OneDrive.
+    > [!div class="nextstepaction"]
+    > [Download the sample workbook](punch-clock-sample.xlsx)
 
     :::image type="content" source="../../images/punch-clock-sample-1.png" alt-text="A table with three columns: 'Clock In', 'Clock Out', and 'Duration'.":::
 
diff --git a/docs/resources/scenarios/schedule-interviews-in-teams.md b/docs/resources/scenarios/schedule-interviews-in-teams.md
@@ -23,13 +23,21 @@ For more information about working with JSON, read [Use JSON to pass data to and
 * Teams integration
 * Table parsing
 
-## Sample Excel file
+## Setup instructions
 
-Download the file [hr-schedule.xlsx](hr-schedule.xlsx) used in this solution and try it out yourself! Be sure to change at least one of the email addresses so that you receive an invite.
+### Download the workbook
 
-## Sample code: Extract table data to schedule invites
+1. Download the sample workbook to your OneDrive.
+    > [!div class="nextstepaction"]
+    > [Download the sample workbook](hr-schedule.xlsx)
 
-Add this script to your script collection. Name it **Schedule Interviews** for the flow.
+1. Open the workbook in Excel.
+
+1. Change at least one of the email addresses to your own so that you receive an invite.
+
+### Create the scripts
+
+1. Under the **Automate** tab, select **New Script** and paste the following script into the editor. This will extract table data to schedule invites.
 
 ```TypeScript
 function main(workbook: ExcelScript.Workbook): InterviewInvite[] {
@@ -88,9 +96,9 @@ interface InterviewInvite {
 }
 ```
 
-## Sample code: Mark rows as invited
+1. Name the script **Schedule Interviews** for the flow.
 
-Add this script to your script collection. Name it **Record Sent Invites** for the flow.
+1. Create another new script with the following code. This will mark rows as invited.
 
 ```TypeScript
 function main(workbook: ExcelScript.Workbook, invites: InterviewInvite[]) {
@@ -129,7 +137,11 @@ interface InterviewInvite {
 }
 ```
 
-## Sample flow: Run the interview scheduling scripts and send the Teams meetings
+1. Name the second script **Record Sent Invites** for the flow.
+
+### Create the Power Automate flow
+
+This flow run the interview scheduling scripts, send the Teams meetings, and record the activity back in the workbook.
 
 1. Create a new **Instant cloud flow**.
 1. Choose **Manually trigger a flow** and select **Create**.
diff --git a/docs/resources/scenarios/task-reminders.md b/docs/resources/scenarios/task-reminders.md
@@ -25,10 +25,16 @@ This scenario uses [Power Automate](https://make.powerautomate.com) and [Microso
 
 ## Setup instructions
 
-1. Download [task-reminders.xlsx](task-reminders.xlsx) to your OneDrive.
+### Download the workbook
+
+1. Download the sample workbook to your OneDrive.
+    > [!div class="nextstepaction"]
+    > [Download the sample workbook](task-reminders.xlsx)
 
 1. Open the workbook in Excel.
 
+### Create the scripts
+
 1. First, we need a script to get all the employees with status reports that are missing from the spreadsheet. Under the **Automate** tab, select **New Script** and paste the following script into the editor.
 
     ```TypeScript
@@ -138,7 +144,9 @@ This scenario uses [Power Automate](https://make.powerautomate.com) and [Microso
 
 1. Save the script with the name **Save Status**.
 
-1. Now, we need to create the flow. Open the [Power Automate **Create** tab](https://make.powerautomate.com/create).
+### Create the Power Automate flow
+
+1. Open the [Power Automate **Create** tab](https://make.powerautomate.com/create).
 
     > [!TIP]
     > If you haven't created a flow before, please check out our tutorial [Start using scripts with Power Automate](../../tutorials/excel-power-automate-manual.md) to learn the basics.
