Merge pull request #737 from OfficeDev/main

[admin] Publish

Author: alison-mk

.openpublishing.redirection.json

@@ -22,7 +22,7 @@
       },
       {
         "source_path": "docs/resources/samples/filter-table-get-visible-range.md",
-        "redirect_url": "/office/dev/scripts/resources/samples/samples-overview"
+        "redirect_url": "/office/dev/scripts/resources/samples/table-samples"
       },
       {
         "source_path": "docs/resources/samples/range-basics.md",

SECURITY.md

@@ -14,7 +14,7 @@ Instead, please report them to the Microsoft Security Response Center (MSRC) at
 
 If you prefer to submit without logging in, send email to [[email protected]](mailto:[email protected]).  If possible, encrypt your message with our PGP key; please download it from the [Microsoft Security Response Center PGP Key page](https://aka.ms/opensource/security/pgpkey).
 
-You should receive a response within 24 hours. If for some reason you do not, please follow up via email to ensure we received your original message. Additional information can be found at [microsoft.com/msrc](https://aka.ms/opensource/security/msrc). 
+You should receive a response within 24 hours. If for some reason you do not, please follow up via email to ensure we received your original message. Additional information can be found at [microsoft.com/msrc](https://aka.ms/opensource/security/msrc).
 
 Please include the requested information listed below (as much as you can provide) to help us better understand the nature and scope of the possible issue:
 
@@ -24,7 +24,7 @@ Please include the requested information listed below (as much as you can provid
   * Any special configuration required to reproduce the issue
   * Step-by-step instructions to reproduce the issue
   * Proof-of-concept or exploit code (if possible)
-  * Impact of the issue, including how an attacker might exploit the issue
+  * Impact of the issue, including how a threat actor might exploit the issue
 
 This information will help us triage your report more quickly.
 

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/19/2023
+ms.date: 04/18/2024
 ms.localizationpriority: medium
 ---
 
@@ -179,6 +179,51 @@ The following code snippet adds a slicer for the "Type" field. It sets the selec
 
 :::image type="content" source="../images/slicer.png" alt-text="A slicer filtering data on a PivotTable.":::
 
+### Value field settings for summaries
+
+Change how the PivotTable summarizes and displays data with these settings. The field in each data hierarchy can display the data in different ways, such as percentages, standard deviations, and relative comparisons.
+
+#### Summarize by
+
+The default summarization of a data hierarchy field is as a sum. `DataPivotHierarchy.setSummarizeBy` lets you combine the data for each row or column in a different way. [`AggregationFunction`](/javascript/api/office-scripts/excelscript/excelscript.aggregationfunction) lists the all the available options.
+
+The following code snippet changes "Crates Sold Wholesale" to show each item's standard deviation, instead of the sum.
+
+```typescript
+  const wholesaleSales = farmPivot.getDataHierarchy("Sum of Crates Sold Wholesale");
+  wholesaleSales.setSummarizeBy(ExcelScript.AggregationFunction.standardDeviation);
+```
+
+#### Show values as
+
+`DataPivotHierarchy.setShowAs` applies a calculation to the values of a data hierarchy. Instead of the default sum, you can show values or percentages relative to other parts of the PivotTable. Use a [`ShowAsRule`](/javascript/api/office-scripts/excelscript/excelscript.showasrule) to set how data hierarchy values are shown.
+
+The following code snippet changes the display for "Crates Sold at Farm". The values will be shown as a percentage of the grand total for the field.
+
+```typescript
+  const farmSales = farmPivot.getDataHierarchy("Sum of Crates Sold at Farm");
+
+  const rule : ExcelScript.ShowAsRule = {
+    calculation: ExcelScript.ShowAsCalculation.percentOfGrandTotal
+  };
+  farmSales.setShowAs(rule);
+```
+
+Some `ShowAsRule`s need another field or item in that field as a comparison. The following code snippet again changes the display for "Crates Sold at Farm". This time, the field will show each value's difference from the value of the "Lemons" in that farm row. If a farm has not sold any lemons, the field shows "#N/A".
+
+```typescript
+  const typeField = farmPivot.getRowHierarchy("Type").getFields()[0];
+  const farmSales = farmPivot.getDataHierarchy("Sum of Crates Sold at Farm");
+
+  const rule: ExcelScript.ShowAsRule = {
+    calculation: ExcelScript.ShowAsCalculation.differenceFrom,
+    baseField: typeField, /* The field to use for the difference. */
+    baseItem: typeField.getPivotItem("Lemon") /* The item within that field that is the basis of comparison for the difference. */
+  };
+  farmSales.setShowAs(rule);
+  farmSales.setName("Difference from Lemons of Crates Sold at Farm");
+```
+
 ## See also
 
 - [Fundamentals for Office Scripts in Excel](scripting-fundamentals.md)

docs/includes/platform-requirements.md

@@ -2,7 +2,7 @@ To use Office Scripts, you'll need the following.
 
 # [For business and education](#tab/business)
 
-1. Excel for Windows (version 2210 or higher), Excel for Mac, or Excel on the web.
+1. Excel on the web, Excel for Windows (Version 2210 or higher), or Excel for Mac.
 1. OneDrive for Business.
 1. Any commercial or educational Microsoft 365 license with access to the Microsoft 365 Office desktop apps, such as:
     - Office 365 Business
@@ -22,7 +22,7 @@ To use Office Scripts, you'll need the following.
 > [!IMPORTANT]
 > Office Scripts is in preview for personal and family Microsoft 365 subscriptions. If you encounter any issues, please report them through the Feedback button in Excel.
 
-1. Excel for Microsoft 365 or Excel on the web.
+1. Excel on the web or Excel for Microsoft 365.
 1. Join the [Microsoft 365 Insider program](https://insider.microsoft365.com/join/windows).
 1. Internet connectivity with [connected experiences](/deployoffice/privacy/connected-experiences) enabled.
 

docs/resources/power-query-differences.md

@@ -44,7 +44,7 @@ Power Query is used in the [SQL Server](https://powerquery.microsoft.com/flow/)
 
 ## Platform dependencies
 
-Office Scripts is currently available for Excel for Windows, for Mac, and on the web. The full Power Query experience is currently [only available for Excel for Windows](/power-query/power-query-what-is-power-query#where-can-you-use-power-query). Both can be used through Power Automate, which lets the flow work with Excel workbooks stored in OneDrive.
+Office Scripts is currently available for Excel on the web, Excel for Windows, and Excel for Mac. The full Power Query experience is currently [only available for Excel for Windows](/power-query/power-query-what-is-power-query#where-can-you-use-power-query). Both can be used through Power Automate, which lets the flow work with Excel workbooks stored in OneDrive.
 
 ## See also