[excel] (IA) Break out "basic" samples into independent articles (#644)

* Partial refactoring

* Refactor basic sample list to increase discoverability

* Fix links

* Remove view parameter from reference doc link

* Apply suggestions from code review

Co-authored-by: Elizabeth Samuel <[email protected]>

---------

Co-authored-by: Elizabeth Samuel <[email protected]>

Author: AlexJerabek

.openpublishing.redirection.json

@@ -2,7 +2,15 @@
     "redirections": [      
       {
         "source_path": "docs/resources/excel-samples.md",
-        "redirect_url": "/office/dev/scripts/resources/samples/excel-samples"
+        "redirect_url": "/office/dev/scripts/resources/samples/samples-overview"
+      },    
+      {
+        "source_path": "docs/resources/samples/excel-samples.md",
+        "redirect_url": "/office/dev/scripts/resources/samples/samples-overview"
+      },
+      {
+        "source_path": "docs/resources/samples/clear-table-filter-for-active-cell.md",
+        "redirect_url": "/office/dev/scripts/resources/samples/table-samples"
       },
       {
         "source_path": "docs/resources/samples/document-number-generator.md",

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: 10/01/2022
+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.localizationpriority: medium
 ---
 
@@ -74,6 +74,36 @@ Each part of the PivotTable maps to a range. This lets your script get data from
 
 :::image type="content" source="../images/pivottable-layout-breakdown.png" alt-text="A diagram showing which sections of a PivotTable are returned by the layout's get range functions.":::
 
+### PivotTable total output
+
+The location of the total row is based on the layout. Use [`PivotLayout.getBodyAndTotalRange`](/javascript/api/office-scripts/excelscript/excelscript.pivotlayout#excelscript-excelscript-pivotlayout-getbodyandtotalrange-member(1)) and get the last row of the column to use the data from the PivotTable in your script.
+
+The following sample finds the first PivotTable in the workbook and logs the values in the "Grand Total" cells (as highlighted in green in the image below).
+
+:::image type="content" source="../images/sample-pivottable-grand-total-row.png" alt-text="A PivotTable showing fruit sales with the Grand Total row highlighted green.":::
+
+```TypeScript
+function main(workbook: ExcelScript.Workbook) {
+  // Get the first PivotTable in the workbook.
+  const pivotTable = workbook.getPivotTables()[0];
+
+  // Get the names of each data column in the PivotTable.
+  const pivotColumnLabelRange = pivotTable.getLayout().getColumnLabelRange();
+
+  // Get the range displaying the pivoted data.
+  const pivotDataRange = pivotTable.getLayout().getBodyAndTotalRange();
+
+  // Get the range with the "grand totals" for the PivotTable columns.
+  const grandTotalRange = pivotDataRange.getLastRow();
+
+  // Print each of the "Grand Totals" to the console.
+  grandTotalRange.getValues()[0].forEach((column, columnIndex) => {
+    console.log(`Grand total of ${pivotColumnLabelRange.getValues()[0][columnIndex]}: ${grandTotalRange.getValues()[0][columnIndex]}`);
+    // Example log: "Grand total of Sum of Crates Sold Wholesale: 11000"
+  });
+}
+```
+
 ## Filters and slicers
 
 There are three ways to filter a PivotTable.

docs/resources/samples/clear-table-filter-for-active-cell.md

@@ -0,0 +1,43 @@
+---
+title: Create a dropdown list using data validation
+description: Learn how to add data validation to a cell and give the user a selection of values to enter.
+ms.date: 09/08/2023
+ms.localizationpriority: medium
+---
+
+# Create a dropdown list using data validation
+
+This script creates a dropdown selection list for a cell. It uses the existing values of the selected range as the choices for the list.
+
+:::image type="content" source="../../images/sample-data-validation.png" alt-text="A worksheet showing a range of three cells containing color choices 'red, blue, green' and next to it, the same choices shown in a dropdown list.":::
+
+```TypeScript
+function main(workbook: ExcelScript.Workbook) {
+  // Get the values for data validation.
+  let selectedRange = workbook.getSelectedRange();
+  let rangeValues = selectedRange.getValues();
+
+  // Convert the values into a comma-delimited string.
+  let dataValidationListString = "";
+  rangeValues.forEach((rangeValueRow) => {
+    rangeValueRow.forEach((value) => {
+      dataValidationListString += value + ",";
+    });
+  });
+
+  // Clear the old range.
+  selectedRange.clear(ExcelScript.ClearApplyTo.contents);
+
+  // Apply the data validation to the first cell in the selected range.
+  let targetCell = selectedRange.getCell(0,0);
+  let dataValidation = targetCell.getDataValidation();
+
+  // Set the content of the dropdown list.
+  dataValidation.setRule({
+      list: {
+        inCellDropDown: true,
+        source: dataValidationListString
+      }
+    });
+}
+```