diff --git a/docs/docs-ref-autogen/excel/excel.yml b/docs/docs-ref-autogen/excel/excel.yml
index 622dbb624..feafe80f3 100644
--- a/docs/docs-ref-autogen/excel/excel.yml
+++ b/docs/docs-ref-autogen/excel/excel.yml
@@ -1141,11 +1141,16 @@ functions:
package: excel!
summary: >-
Creates and opens a new workbook. Optionally, the workbook can be
- pre-populated with a Base64-encoded .xlsx file. Note: Macros can be a
- security risk. If this API is used to create a workbook that includes a
- macro, the add-in user will be prompted with a "Trust this add-in?" dialog
- in the Excel UI. The user must select the "Trust add-in" button to
- proceed.
+ pre-populated with a Base64-encoded .xlsx file. The `extensionHardening`
+ Windows registry key affects the `base64File` param. The file extension
+ defined by the param must match the real file type of the file. If
+ `extensionHardening` is set to deny mismatches and the file extension does
+ not match the real file type, this API throws the following error: "This
+ operation is not allowed due to the extension hardening policy." Note:
+ Macros can be a security risk. If this API is used to create a workbook
+ that includes a macro, the add-in user will be prompted with a "Trust this
+ add-in?" dialog in the Excel UI. The user must select the "Trust add-in"
+ button to proceed.
\[ [API set: ExcelApi
diff --git a/docs/docs-ref-autogen/excel/excel/excel.cardlayout.yml b/docs/docs-ref-autogen/excel/excel/excel.cardlayout.yml
index 13bd37ee7..ad538d6d8 100644
--- a/docs/docs-ref-autogen/excel/excel/excel.cardlayout.yml
+++ b/docs/docs-ref-autogen/excel/excel/excel.cardlayout.yml
@@ -4,7 +4,16 @@ uid: excel!Excel.CardLayout:type
package: excel!
fullName: Excel.CardLayout
summary: Represents the layout of a card in card view.
-remarks: "\\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \\]\r\n\r\nLearn more about the types in this type alias through the following links. \r\n\r\n[Excel.EntityCardLayout](/javascript/api/excel/excel.entitycardlayout), [Excel.EntityArrayCardLayout](/javascript/api/excel/excel.entityarraycardlayout)"
+remarks: >-
+ \[ [API set: ExcelApi
+ 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ Learn more about the types in this type alias through the following links.
+
+
+ [Excel.EntityCardLayout](/javascript/api/excel/excel.entitycardlayout),
+ [Excel.EntityArrayCardLayout](/javascript/api/excel/excel.entityarraycardlayout)
isPreview: false
isDeprecated: false
diff --git a/docs/docs-ref-autogen/excel/excel/excel.cardlayoutsection.yml b/docs/docs-ref-autogen/excel/excel/excel.cardlayoutsection.yml
index 5491f6727..cca1b0c56 100644
--- a/docs/docs-ref-autogen/excel/excel/excel.cardlayoutsection.yml
+++ b/docs/docs-ref-autogen/excel/excel/excel.cardlayoutsection.yml
@@ -4,7 +4,17 @@ uid: excel!Excel.CardLayoutSection:type
package: excel!
fullName: Excel.CardLayoutSection
summary: Represents the layout of a section of a card in card view.
-remarks: "\\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \\]\r\n\r\nLearn more about the types in this type alias through the following links. \r\n\r\n[Excel.CardLayoutListSection](/javascript/api/excel/excel.cardlayoutlistsection), [Excel.CardLayoutTableSection](/javascript/api/excel/excel.cardlayouttablesection), [Excel.CardLayoutTwoColumnSection](/javascript/api/excel/excel.cardlayouttwocolumnsection)"
+remarks: >-
+ \[ [API set: ExcelApi
+ 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ Learn more about the types in this type alias through the following links.
+
+
+ [Excel.CardLayoutListSection](/javascript/api/excel/excel.cardlayoutlistsection),
+ [Excel.CardLayoutTableSection](/javascript/api/excel/excel.cardlayouttablesection),
+ [Excel.CardLayoutTwoColumnSection](/javascript/api/excel/excel.cardlayouttwocolumnsection)
isPreview: false
isDeprecated: false
diff --git a/docs/docs-ref-autogen/excel/excel/excel.cellcontrol.yml b/docs/docs-ref-autogen/excel/excel/excel.cellcontrol.yml
index ecd03dccf..5e5954d3d 100644
--- a/docs/docs-ref-autogen/excel/excel/excel.cellcontrol.yml
+++ b/docs/docs-ref-autogen/excel/excel/excel.cellcontrol.yml
@@ -4,7 +4,47 @@ uid: excel!Excel.CellControl:type
package: excel!
fullName: Excel.CellControl
summary: Represents an interactable control inside of a cell.
-remarks: "\\[ [API set: ExcelApi 1.18](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \\]\n\n\r\n\r\nLearn more about the types in this type alias through the following links. \r\n\r\n[Excel.UnknownCellControl](/javascript/api/excel/excel.unknowncellcontrol), [Excel.EmptyCellControl](/javascript/api/excel/excel.emptycellcontrol), [Excel.MixedCellControl](/javascript/api/excel/excel.mixedcellcontrol), [Excel.CheckboxCellControl](/javascript/api/excel/excel.checkboxcellcontrol)\r\n\r\n#### Examples\n\n```TypeScript\n// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/42-range/range-cell-control.yaml\n\n// Add checkboxes to the table.\nawait Excel.run(async (context) => {\n const sheet = context.workbook.worksheets.getActiveWorksheet();\n\n // Get the second column in the table, without the header.\n const range = sheet.tables.getItem(\"FruitTable\").columns.getItem(\"Analysis\").getDataBodyRange();\n\n // Change the boolean values to checkboxes.\n range.control = {\n type: Excel.CellControlType.checkbox\n };\n await context.sync();\n});\n```"
+remarks: >-
+ \[ [API set: ExcelApi
+ 1.18](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+
+
+ Learn more about the types in this type alias through the following links.
+
+
+ [Excel.UnknownCellControl](/javascript/api/excel/excel.unknowncellcontrol),
+ [Excel.EmptyCellControl](/javascript/api/excel/excel.emptycellcontrol),
+ [Excel.MixedCellControl](/javascript/api/excel/excel.mixedcellcontrol),
+ [Excel.CheckboxCellControl](/javascript/api/excel/excel.checkboxcellcontrol)
+
+
+ #### Examples
+
+
+ ```TypeScript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/42-range/range-cell-control.yaml
+
+
+ // Add checkboxes to the table.
+
+ await Excel.run(async (context) => {
+ const sheet = context.workbook.worksheets.getActiveWorksheet();
+
+ // Get the second column in the table, without the header.
+ const range = sheet.tables.getItem("FruitTable").columns.getItem("Analysis").getDataBodyRange();
+
+ // Change the boolean values to checkboxes.
+ range.control = {
+ type: Excel.CellControlType.checkbox
+ };
+ await context.sync();
+ });
+
+ ```
isPreview: false
isDeprecated: false
diff --git a/docs/docs-ref-autogen/excel/excel/excel.cellvalue.yml b/docs/docs-ref-autogen/excel/excel/excel.cellvalue.yml
index 62429faa0..57f85ca48 100644
--- a/docs/docs-ref-autogen/excel/excel/excel.cellvalue.yml
+++ b/docs/docs-ref-autogen/excel/excel/excel.cellvalue.yml
@@ -4,7 +4,30 @@ uid: excel!Excel.CellValue:type
package: excel!
fullName: Excel.CellValue
summary: Represents the value in a cell.
-remarks: "\\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \\]\r\n\r\nLearn more about the types in this type alias through the following links. \r\n\r\n[Excel.ArrayCellValue](/javascript/api/excel/excel.arraycellvalue), [Excel.BooleanCellValue](/javascript/api/excel/excel.booleancellvalue), [Excel.DoubleCellValue](/javascript/api/excel/excel.doublecellvalue), [Excel.EntityCellValue](/javascript/api/excel/excel.entitycellvalue), [Excel.EmptyCellValue](/javascript/api/excel/excel.emptycellvalue), [Excel.ErrorCellValue](/javascript/api/excel/excel.errorcellvalue), [Excel.ExternalCodeServiceObjectCellValue](/javascript/api/excel/excel.externalcodeserviceobjectcellvalue), [Excel.FormattedNumberCellValue](/javascript/api/excel/excel.formattednumbercellvalue), [Excel.FunctionCellValue](/javascript/api/excel/excel.functioncellvalue), [Excel.LinkedEntityCellValue](/javascript/api/excel/excel.linkedentitycellvalue), [Excel.LocalImageCellValue](/javascript/api/excel/excel.localimagecellvalue), [Excel.ReferenceCellValue](/javascript/api/excel/excel.referencecellvalue), [Excel.StringCellValue](/javascript/api/excel/excel.stringcellvalue), [Excel.ValueTypeNotAvailableCellValue](/javascript/api/excel/excel.valuetypenotavailablecellvalue), [Excel.WebImageCellValue](/javascript/api/excel/excel.webimagecellvalue), [Excel.CellValueExtraProperties](/javascript/api/excel/excel.cellvalueextraproperties)"
+remarks: >-
+ \[ [API set: ExcelApi
+ 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ Learn more about the types in this type alias through the following links.
+
+
+ [Excel.ArrayCellValue](/javascript/api/excel/excel.arraycellvalue),
+ [Excel.BooleanCellValue](/javascript/api/excel/excel.booleancellvalue),
+ [Excel.DoubleCellValue](/javascript/api/excel/excel.doublecellvalue),
+ [Excel.EntityCellValue](/javascript/api/excel/excel.entitycellvalue),
+ [Excel.EmptyCellValue](/javascript/api/excel/excel.emptycellvalue),
+ [Excel.ErrorCellValue](/javascript/api/excel/excel.errorcellvalue),
+ [Excel.ExternalCodeServiceObjectCellValue](/javascript/api/excel/excel.externalcodeserviceobjectcellvalue),
+ [Excel.FormattedNumberCellValue](/javascript/api/excel/excel.formattednumbercellvalue),
+ [Excel.FunctionCellValue](/javascript/api/excel/excel.functioncellvalue),
+ [Excel.LinkedEntityCellValue](/javascript/api/excel/excel.linkedentitycellvalue),
+ [Excel.LocalImageCellValue](/javascript/api/excel/excel.localimagecellvalue),
+ [Excel.ReferenceCellValue](/javascript/api/excel/excel.referencecellvalue),
+ [Excel.StringCellValue](/javascript/api/excel/excel.stringcellvalue),
+ [Excel.ValueTypeNotAvailableCellValue](/javascript/api/excel/excel.valuetypenotavailablecellvalue),
+ [Excel.WebImageCellValue](/javascript/api/excel/excel.webimagecellvalue),
+ [Excel.CellValueExtraProperties](/javascript/api/excel/excel.cellvalueextraproperties)
isPreview: false
isDeprecated: false
diff --git a/docs/docs-ref-autogen/excel/excel/excel.cellvalueandpropertymetadata.yml b/docs/docs-ref-autogen/excel/excel/excel.cellvalueandpropertymetadata.yml
index 566432a91..5f661bb32 100644
--- a/docs/docs-ref-autogen/excel/excel/excel.cellvalueandpropertymetadata.yml
+++ b/docs/docs-ref-autogen/excel/excel/excel.cellvalueandpropertymetadata.yml
@@ -6,7 +6,16 @@ fullName: Excel.CellValueAndPropertyMetadata
summary: >-
Represents the value and metadata of a property. The metadata applies to the
property (and not the value), but it is combined with the value in this type.
-remarks: "\\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \\]\r\n\r\nLearn more about the types in this type alias through the following links. \r\n\r\n[Excel.CellValue](/javascript/api/excel/excel.cellvalue), [Excel.EntityPropertyExtraProperties](/javascript/api/excel/excel.entitypropertyextraproperties)"
+remarks: >-
+ \[ [API set: ExcelApi
+ 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ Learn more about the types in this type alias through the following links.
+
+
+ [Excel.CellValue](/javascript/api/excel/excel.cellvalue),
+ [Excel.EntityPropertyExtraProperties](/javascript/api/excel/excel.entitypropertyextraproperties)
isPreview: false
isDeprecated: false
diff --git a/docs/docs-ref-autogen/excel/excel/excel.compactlayout.yml b/docs/docs-ref-autogen/excel/excel/excel.compactlayout.yml
index 3f2549677..5bb689c66 100644
--- a/docs/docs-ref-autogen/excel/excel/excel.compactlayout.yml
+++ b/docs/docs-ref-autogen/excel/excel/excel.compactlayout.yml
@@ -6,7 +6,15 @@ fullName: Excel.CompactLayout
summary: >-
Represents the layout used when there is limited space to represent the
entity.
-remarks: "\\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \\]\r\n\r\nLearn more about the types in this type alias through the following links. \r\n\r\n[Excel.EntityCompactLayout](/javascript/api/excel/excel.entitycompactlayout)"
+remarks: >-
+ \[ [API set: ExcelApi
+ 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ Learn more about the types in this type alias through the following links.
+
+
+ [Excel.EntityCompactLayout](/javascript/api/excel/excel.entitycompactlayout)
isPreview: false
isDeprecated: false
diff --git a/docs/docs-ref-autogen/excel/excel/excel.entitypropertytype.yml b/docs/docs-ref-autogen/excel/excel/excel.entitypropertytype.yml
index 41a8cc7fc..bc54a6eff 100644
--- a/docs/docs-ref-autogen/excel/excel/excel.entitypropertytype.yml
+++ b/docs/docs-ref-autogen/excel/excel/excel.entitypropertytype.yml
@@ -4,7 +4,16 @@ uid: excel!Excel.EntityPropertyType:type
package: excel!
fullName: Excel.EntityPropertyType
summary: Represents the value of a property.
-remarks: "\\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \\]\r\n\r\nLearn more about the types in this type alias through the following links. \r\n\r\n[Excel.CellValueAndPropertyMetadata](/javascript/api/excel/excel.cellvalueandpropertymetadata), [Excel.CellValue](/javascript/api/excel/excel.cellvalue)"
+remarks: >-
+ \[ [API set: ExcelApi
+ 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ Learn more about the types in this type alias through the following links.
+
+
+ [Excel.CellValueAndPropertyMetadata](/javascript/api/excel/excel.cellvalueandpropertymetadata),
+ [Excel.CellValue](/javascript/api/excel/excel.cellvalue)
isPreview: false
isDeprecated: false
diff --git a/docs/docs-ref-autogen/excel/excel/excel.errorcellvalue.yml b/docs/docs-ref-autogen/excel/excel/excel.errorcellvalue.yml
index cd381f72c..f5e56306d 100644
--- a/docs/docs-ref-autogen/excel/excel/excel.errorcellvalue.yml
+++ b/docs/docs-ref-autogen/excel/excel/excel.errorcellvalue.yml
@@ -4,7 +4,64 @@ uid: excel!Excel.ErrorCellValue:type
package: excel!
fullName: Excel.ErrorCellValue
summary: Represents a cell value which contains an error.
-remarks: "\\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \\]\n\n\r\n\r\nLearn more about the types in this type alias through the following links. \r\n\r\n[Excel.BlockedErrorCellValue](/javascript/api/excel/excel.blockederrorcellvalue), [Excel.BusyErrorCellValue](/javascript/api/excel/excel.busyerrorcellvalue), [Excel.CalcErrorCellValue](/javascript/api/excel/excel.calcerrorcellvalue), [Excel.ConnectErrorCellValue](/javascript/api/excel/excel.connecterrorcellvalue), [Excel.Div0ErrorCellValue](/javascript/api/excel/excel.div0errorcellvalue), [Excel.ExternalErrorCellValue](/javascript/api/excel/excel.externalerrorcellvalue), [Excel.FieldErrorCellValue](/javascript/api/excel/excel.fielderrorcellvalue), [Excel.GettingDataErrorCellValue](/javascript/api/excel/excel.gettingdataerrorcellvalue), [Excel.NotAvailableErrorCellValue](/javascript/api/excel/excel.notavailableerrorcellvalue), [Excel.NameErrorCellValue](/javascript/api/excel/excel.nameerrorcellvalue), [Excel.NullErrorCellValue](/javascript/api/excel/excel.nullerrorcellvalue), [Excel.NumErrorCellValue](/javascript/api/excel/excel.numerrorcellvalue), [Excel.PlaceholderErrorCellValue](/javascript/api/excel/excel.placeholdererrorcellvalue), [Excel.PythonErrorCellValue](/javascript/api/excel/excel.pythonerrorcellvalue), [Excel.RefErrorCellValue](/javascript/api/excel/excel.referrorcellvalue), [Excel.SpillErrorCellValue](/javascript/api/excel/excel.spillerrorcellvalue), [Excel.TimeoutErrorCellValue](/javascript/api/excel/excel.timeouterrorcellvalue), [Excel.ValueErrorCellValue](/javascript/api/excel/excel.valueerrorcellvalue)\r\n\r\n#### Examples\n\n```TypeScript\n// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/20-data-types/data-types-error-values.yaml\n\n// This function sets the value of cell A1 to a #BUSY! error using data types.\nawait Excel.run(async (context) => {\n // Retrieve the Sample worksheet and cell A1 on that sheet.\n const sheet = context.workbook.worksheets.getItemOrNullObject(\"Sample\");\n const range = sheet.getRange(\"A1\");\n\n // Get the error data type and set its type to `busy`.\n const error: Excel.ErrorCellValue = {\n type: Excel.CellValueType.error,\n errorType: Excel.ErrorCellValueType.busy\n };\n\n // Set cell A1 as the busy error.\n range.valuesAsJson = [[error]];\n await context.sync();\n});\n```"
+remarks: >-
+ \[ [API set: ExcelApi
+ 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+
+
+ Learn more about the types in this type alias through the following links.
+
+
+ [Excel.BlockedErrorCellValue](/javascript/api/excel/excel.blockederrorcellvalue),
+ [Excel.BusyErrorCellValue](/javascript/api/excel/excel.busyerrorcellvalue),
+ [Excel.CalcErrorCellValue](/javascript/api/excel/excel.calcerrorcellvalue),
+ [Excel.ConnectErrorCellValue](/javascript/api/excel/excel.connecterrorcellvalue),
+ [Excel.Div0ErrorCellValue](/javascript/api/excel/excel.div0errorcellvalue),
+ [Excel.ExternalErrorCellValue](/javascript/api/excel/excel.externalerrorcellvalue),
+ [Excel.FieldErrorCellValue](/javascript/api/excel/excel.fielderrorcellvalue),
+ [Excel.GettingDataErrorCellValue](/javascript/api/excel/excel.gettingdataerrorcellvalue),
+ [Excel.NotAvailableErrorCellValue](/javascript/api/excel/excel.notavailableerrorcellvalue),
+ [Excel.NameErrorCellValue](/javascript/api/excel/excel.nameerrorcellvalue),
+ [Excel.NullErrorCellValue](/javascript/api/excel/excel.nullerrorcellvalue),
+ [Excel.NumErrorCellValue](/javascript/api/excel/excel.numerrorcellvalue),
+ [Excel.PlaceholderErrorCellValue](/javascript/api/excel/excel.placeholdererrorcellvalue),
+ [Excel.PythonErrorCellValue](/javascript/api/excel/excel.pythonerrorcellvalue),
+ [Excel.RefErrorCellValue](/javascript/api/excel/excel.referrorcellvalue),
+ [Excel.SpillErrorCellValue](/javascript/api/excel/excel.spillerrorcellvalue),
+ [Excel.TimeoutErrorCellValue](/javascript/api/excel/excel.timeouterrorcellvalue),
+ [Excel.ValueErrorCellValue](/javascript/api/excel/excel.valueerrorcellvalue)
+
+
+ #### Examples
+
+
+ ```TypeScript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/20-data-types/data-types-error-values.yaml
+
+
+ // This function sets the value of cell A1 to a #BUSY! error using data types.
+
+ await Excel.run(async (context) => {
+ // Retrieve the Sample worksheet and cell A1 on that sheet.
+ const sheet = context.workbook.worksheets.getItemOrNullObject("Sample");
+ const range = sheet.getRange("A1");
+
+ // Get the error data type and set its type to `busy`.
+ const error: Excel.ErrorCellValue = {
+ type: Excel.CellValueType.error,
+ errorType: Excel.ErrorCellValueType.busy
+ };
+
+ // Set cell A1 as the busy error.
+ range.valuesAsJson = [[error]];
+ await context.sync();
+ });
+
+ ```
isPreview: false
isDeprecated: false
diff --git a/docs/docs-ref-autogen/excel/excel/excel.functioncellvalue.yml b/docs/docs-ref-autogen/excel/excel/excel.functioncellvalue.yml
index 50b723960..b1f83d2ff 100644
--- a/docs/docs-ref-autogen/excel/excel/excel.functioncellvalue.yml
+++ b/docs/docs-ref-autogen/excel/excel/excel.functioncellvalue.yml
@@ -4,7 +4,15 @@ uid: excel!Excel.FunctionCellValue:type
package: excel!
fullName: Excel.FunctionCellValue
summary: Represents a cell value which can be evaluated as a function.
-remarks: "\\[ [API set: ExcelApi 1.19](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \\]\r\n\r\nLearn more about the types in this type alias through the following links. \r\n\r\n[Excel.JavaScriptCustomFunctionReferenceCellValue](/javascript/api/excel/excel.javascriptcustomfunctionreferencecellvalue)"
+remarks: >-
+ \[ [API set: ExcelApi
+ 1.19](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ Learn more about the types in this type alias through the following links.
+
+
+ [Excel.JavaScriptCustomFunctionReferenceCellValue](/javascript/api/excel/excel.javascriptcustomfunctionreferencecellvalue)
isPreview: false
isDeprecated: false
diff --git a/docs/docs-ref-autogen/excel/excel/excel.notavailableerrorcellvalue.yml b/docs/docs-ref-autogen/excel/excel/excel.notavailableerrorcellvalue.yml
index cf47303c1..4153e8017 100644
--- a/docs/docs-ref-autogen/excel/excel/excel.notavailableerrorcellvalue.yml
+++ b/docs/docs-ref-autogen/excel/excel/excel.notavailableerrorcellvalue.yml
@@ -3,7 +3,7 @@ name: Excel.NotAvailableErrorCellValue
uid: excel!Excel.NotAvailableErrorCellValue:interface
package: excel!
fullName: Excel.NotAvailableErrorCellValue
-summary: Represents the value of a cell containing a \#N/A! error.
+summary: Represents the value of a cell containing a \#N/A error.
remarks: >-
\[ [API set: ExcelApi
1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
@@ -48,9 +48,9 @@ properties:
isPreview: false
isDeprecated: false
syntax:
- content: 'basicValue?: "#N/A!" | string;'
+ content: 'basicValue?: "#N/A" | string;'
return:
- type: '"#N/A!" | string'
+ type: '"#N/A" | string'
- name: errorSubType
uid: excel!Excel.NotAvailableErrorCellValue#errorSubType:member
package: excel!
diff --git a/docs/docs-ref-autogen/excel/excel/excel.notavailableerrorcellvaluesubtype.yml b/docs/docs-ref-autogen/excel/excel/excel.notavailableerrorcellvaluesubtype.yml
index 3fd09742e..e1529765b 100644
--- a/docs/docs-ref-autogen/excel/excel/excel.notavailableerrorcellvaluesubtype.yml
+++ b/docs/docs-ref-autogen/excel/excel/excel.notavailableerrorcellvaluesubtype.yml
@@ -3,7 +3,7 @@ name: Excel.NotAvailableErrorCellValueSubType
uid: excel!Excel.NotAvailableErrorCellValueSubType:enum
package: excel!
fullName: Excel.NotAvailableErrorCellValueSubType
-summary: Represents types of \#N/A! errors.
+summary: Represents types of \#N/A errors.
remarks: >-
\[ [API set: ExcelApi BETA (PREVIEW
ONLY)](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
@@ -15,7 +15,7 @@ fields:
uid: excel!Excel.NotAvailableErrorCellValueSubType.eRegexMatchNoCapture:member
package: excel!
summary: >-
- No capture groups were matched. Displays as error type \#N/A! in Excel.
+ No capture groups were matched. Displays as error type \#N/A in Excel.
* \[ [API set: ExcelApi BETA (PREVIEW
@@ -27,7 +27,7 @@ fields:
package: excel!
summary: >-
No match was found for the pattern in the text provided. Displays as error
- type \#N/A! in Excel.
+ type \#N/A in Excel.
* \[ [API set: ExcelApi BETA (PREVIEW
@@ -40,7 +40,7 @@ fields:
package: excel!
summary: >-
Occurrence is greater than the total number of matches. Displays as error
- type \#N/A! in Excel.
+ type \#N/A in Excel.
* \[ [API set: ExcelApi BETA (PREVIEW
@@ -52,7 +52,7 @@ fields:
package: excel!
summary: >-
An error caused by `HLOOKUP` not finding its `lookup_value` in the search
- range. Displays as error type \#N/A! in Excel.
+ range. Displays as error type \#N/A in Excel.
* \[ [API set: ExcelApi BETA (PREVIEW
@@ -64,7 +64,7 @@ fields:
package: excel!
summary: >-
An error caused by an external code service returning an unknown object.
- Displays as error type \#N/A! in Excel.
+ Displays as error type \#N/A in Excel.
* \[ [API set: ExcelApi BETA (PREVIEW
@@ -77,7 +77,7 @@ fields:
package: excel!
summary: >-
An error caused by an invalid property argument to `STOCKHISTORY`.
- Displays as error type \#N/A! in Excel.
+ Displays as error type \#N/A in Excel.
* \[ [API set: ExcelApi BETA (PREVIEW
@@ -89,7 +89,7 @@ fields:
package: excel!
summary: >-
An error caused by no data being available for a `STOCKHISTORY` function.
- Displays as error type \#N/A! in Excel.
+ Displays as error type \#N/A in Excel.
* \[ [API set: ExcelApi BETA (PREVIEW
@@ -100,7 +100,7 @@ fields:
uid: excel!Excel.NotAvailableErrorCellValueSubType.unknown:member
package: excel!
summary: >-
- An unknown type of error. Displays as error type \#N/A! in Excel.
+ An unknown type of error. Displays as error type \#N/A in Excel.
* \[ [API set: ExcelApi BETA (PREVIEW
@@ -112,7 +112,7 @@ fields:
package: excel!
summary: >-
An error caused by `VLOOKUP` not finding its `lookup_value` in the search
- range. Displays as error type \#N/A! in Excel.
+ range. Displays as error type \#N/A in Excel.
* \[ [API set: ExcelApi BETA (PREVIEW
diff --git a/docs/docs-ref-autogen/excel/excel/excel.range.yml b/docs/docs-ref-autogen/excel/excel/excel.range.yml
index 8b6e770ae..0ae0df5a3 100644
--- a/docs/docs-ref-autogen/excel/excel/excel.range.yml
+++ b/docs/docs-ref-autogen/excel/excel/excel.range.yml
@@ -2120,7 +2120,8 @@ methods:
summary: >-
Returns a range object that includes the current range and up to the edge
of the range, based on the provided direction. This matches the
- Ctrl+Shift+Arrow key behavior in the Excel on Windows UI.
+ Ctrl+Shift+Arrow key behavior in the
+ Excel on Windows UI.
remarks: >-
\[ [API set: ExcelApi
1.13](/javascript/api/requirement-sets/excel/excel-api-requirement-sets)
@@ -2185,7 +2186,8 @@ methods:
summary: >-
Returns a range object that includes the current range and up to the edge
of the range, based on the provided direction. This matches the
- Ctrl+Shift+Arrow key behavior in the Excel on Windows UI.
+ Ctrl+Shift+Arrow key behavior in the
+ Excel on Windows UI.
remarks: >-
\[ [API set: ExcelApi
1.13](/javascript/api/requirement-sets/excel/excel-api-requirement-sets)
@@ -2701,8 +2703,8 @@ methods:
fullName: getRangeEdge(direction, activeCell)
summary: >-
Returns a range object that is the edge cell of the data region that
- corresponds to the provided direction. This matches the Ctrl+Arrow key
- behavior in the Excel on Windows UI.
+ corresponds to the provided direction. This matches the
+ Ctrl+Arrow key behavior in the Excel on Windows UI.
remarks: >-
\[ [API set: ExcelApi
1.13](/javascript/api/requirement-sets/excel/excel-api-requirement-sets)
@@ -2766,8 +2768,8 @@ methods:
fullName: getRangeEdge(direction, activeCell)
summary: >-
Returns a range object that is the edge cell of the data region that
- corresponds to the provided direction. This matches the Ctrl+Arrow key
- behavior in the Excel on Windows UI.
+ corresponds to the provided direction. This matches the
+ Ctrl+Arrow key behavior in the Excel on Windows UI.
remarks: >-
\[ [API set: ExcelApi
1.13](/javascript/api/requirement-sets/excel/excel-api-requirement-sets)
diff --git a/docs/docs-ref-autogen/excel/excel/excel.referencedvalue.yml b/docs/docs-ref-autogen/excel/excel/excel.referencedvalue.yml
index 57044e8eb..168b4928b 100644
--- a/docs/docs-ref-autogen/excel/excel/excel.referencedvalue.yml
+++ b/docs/docs-ref-autogen/excel/excel/excel.referencedvalue.yml
@@ -4,7 +4,20 @@ uid: excel!Excel.ReferencedValue:type
package: excel!
fullName: Excel.ReferencedValue
summary: Represents the value in a cell.
-remarks: "\\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \\]\r\n\r\nLearn more about the types in this type alias through the following links. \r\n\r\n[Excel.ArrayCellValue](/javascript/api/excel/excel.arraycellvalue), [Excel.EntityCellValue](/javascript/api/excel/excel.entitycellvalue), [Excel.RootReferenceCellValue](/javascript/api/excel/excel.rootreferencecellvalue), [Excel.DoubleCellValue](/javascript/api/excel/excel.doublecellvalue), [Excel.StringCellValue](/javascript/api/excel/excel.stringcellvalue), [Excel.BooleanCellValue](/javascript/api/excel/excel.booleancellvalue)"
+remarks: >-
+ \[ [API set: ExcelApi
+ 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ Learn more about the types in this type alias through the following links.
+
+
+ [Excel.ArrayCellValue](/javascript/api/excel/excel.arraycellvalue),
+ [Excel.EntityCellValue](/javascript/api/excel/excel.entitycellvalue),
+ [Excel.RootReferenceCellValue](/javascript/api/excel/excel.rootreferencecellvalue),
+ [Excel.DoubleCellValue](/javascript/api/excel/excel.doublecellvalue),
+ [Excel.StringCellValue](/javascript/api/excel/excel.stringcellvalue),
+ [Excel.BooleanCellValue](/javascript/api/excel/excel.booleancellvalue)
isPreview: false
isDeprecated: false
diff --git a/docs/docs-ref-autogen/excel/excel/excel.workbook.yml b/docs/docs-ref-autogen/excel/excel/excel.workbook.yml
index 33a78133b..714a988b1 100644
--- a/docs/docs-ref-autogen/excel/excel/excel.workbook.yml
+++ b/docs/docs-ref-autogen/excel/excel/excel.workbook.yml
@@ -1155,17 +1155,22 @@ methods:
fullName: insertWorksheetsFromBase64(base64File, options)
summary: >-
Inserts the specified worksheets from a source workbook into the current
- workbook.
-
-
- *Note**: This API is currently only supported for Office on Windows,
- Mac, and the web.
+ workbook. The `extensionHardening` Windows registry key affects this API.
+ The file extension defined by the `base64File` param must match the real
+ file type of the inserted file. If `extensionHardening` is set to deny
+ mismatches and the file extension does not match the real file type, this
+ API throws the following error: "This operation is not allowed due to the
+ extension hardening policy."
remarks: >-
\[ [API set: ExcelApi
1.13](/javascript/api/requirement-sets/excel/excel-api-requirement-sets)
\]
+ This API is currently only supported for Office on Windows, Mac, and the
+ web.
+
+
#### Examples
diff --git a/docs/docs-ref-autogen/excel_1_10/excel.yml b/docs/docs-ref-autogen/excel_1_10/excel.yml
index 070e1b615..2f4bed538 100644
--- a/docs/docs-ref-autogen/excel_1_10/excel.yml
+++ b/docs/docs-ref-autogen/excel_1_10/excel.yml
@@ -911,11 +911,16 @@ functions:
package: excel!
summary: >-
Creates and opens a new workbook. Optionally, the workbook can be
- pre-populated with a Base64-encoded .xlsx file. Note: Macros can be a
- security risk. If this API is used to create a workbook that includes a
- macro, the add-in user will be prompted with a "Trust this add-in?" dialog
- in the Excel UI. The user must select the "Trust add-in" button to
- proceed.
+ pre-populated with a Base64-encoded .xlsx file. The `extensionHardening`
+ Windows registry key affects the `base64File` param. The file extension
+ defined by the param must match the real file type of the file. If
+ `extensionHardening` is set to deny mismatches and the file extension does
+ not match the real file type, this API throws the following error: "This
+ operation is not allowed due to the extension hardening policy." Note:
+ Macros can be a security risk. If this API is used to create a workbook
+ that includes a macro, the add-in user will be prompted with a "Trust this
+ add-in?" dialog in the Excel UI. The user must select the "Trust add-in"
+ button to proceed.
\[ [API set: ExcelApi
diff --git a/docs/docs-ref-autogen/excel_1_11/excel.yml b/docs/docs-ref-autogen/excel_1_11/excel.yml
index a129e2d49..adcab0d63 100644
--- a/docs/docs-ref-autogen/excel_1_11/excel.yml
+++ b/docs/docs-ref-autogen/excel_1_11/excel.yml
@@ -919,11 +919,16 @@ functions:
package: excel!
summary: >-
Creates and opens a new workbook. Optionally, the workbook can be
- pre-populated with a Base64-encoded .xlsx file. Note: Macros can be a
- security risk. If this API is used to create a workbook that includes a
- macro, the add-in user will be prompted with a "Trust this add-in?" dialog
- in the Excel UI. The user must select the "Trust add-in" button to
- proceed.
+ pre-populated with a Base64-encoded .xlsx file. The `extensionHardening`
+ Windows registry key affects the `base64File` param. The file extension
+ defined by the param must match the real file type of the file. If
+ `extensionHardening` is set to deny mismatches and the file extension does
+ not match the real file type, this API throws the following error: "This
+ operation is not allowed due to the extension hardening policy." Note:
+ Macros can be a security risk. If this API is used to create a workbook
+ that includes a macro, the add-in user will be prompted with a "Trust this
+ add-in?" dialog in the Excel UI. The user must select the "Trust add-in"
+ button to proceed.
\[ [API set: ExcelApi
diff --git a/docs/docs-ref-autogen/excel_1_12/excel.yml b/docs/docs-ref-autogen/excel_1_12/excel.yml
index 3aa1af978..700865849 100644
--- a/docs/docs-ref-autogen/excel_1_12/excel.yml
+++ b/docs/docs-ref-autogen/excel_1_12/excel.yml
@@ -949,11 +949,16 @@ functions:
package: excel!
summary: >-
Creates and opens a new workbook. Optionally, the workbook can be
- pre-populated with a Base64-encoded .xlsx file. Note: Macros can be a
- security risk. If this API is used to create a workbook that includes a
- macro, the add-in user will be prompted with a "Trust this add-in?" dialog
- in the Excel UI. The user must select the "Trust add-in" button to
- proceed.
+ pre-populated with a Base64-encoded .xlsx file. The `extensionHardening`
+ Windows registry key affects the `base64File` param. The file extension
+ defined by the param must match the real file type of the file. If
+ `extensionHardening` is set to deny mismatches and the file extension does
+ not match the real file type, this API throws the following error: "This
+ operation is not allowed due to the extension hardening policy." Note:
+ Macros can be a security risk. If this API is used to create a workbook
+ that includes a macro, the add-in user will be prompted with a "Trust this
+ add-in?" dialog in the Excel UI. The user must select the "Trust add-in"
+ button to proceed.
\[ [API set: ExcelApi
diff --git a/docs/docs-ref-autogen/excel_1_13/excel.yml b/docs/docs-ref-autogen/excel_1_13/excel.yml
index 71daef747..e47c89227 100644
--- a/docs/docs-ref-autogen/excel_1_13/excel.yml
+++ b/docs/docs-ref-autogen/excel_1_13/excel.yml
@@ -954,11 +954,16 @@ functions:
package: excel!
summary: >-
Creates and opens a new workbook. Optionally, the workbook can be
- pre-populated with a Base64-encoded .xlsx file. Note: Macros can be a
- security risk. If this API is used to create a workbook that includes a
- macro, the add-in user will be prompted with a "Trust this add-in?" dialog
- in the Excel UI. The user must select the "Trust add-in" button to
- proceed.
+ pre-populated with a Base64-encoded .xlsx file. The `extensionHardening`
+ Windows registry key affects the `base64File` param. The file extension
+ defined by the param must match the real file type of the file. If
+ `extensionHardening` is set to deny mismatches and the file extension does
+ not match the real file type, this API throws the following error: "This
+ operation is not allowed due to the extension hardening policy." Note:
+ Macros can be a security risk. If this API is used to create a workbook
+ that includes a macro, the add-in user will be prompted with a "Trust this
+ add-in?" dialog in the Excel UI. The user must select the "Trust add-in"
+ button to proceed.
\[ [API set: ExcelApi
diff --git a/docs/docs-ref-autogen/excel_1_13/excel/excel.range.yml b/docs/docs-ref-autogen/excel_1_13/excel/excel.range.yml
index f516b0ab4..4aadff9fb 100644
--- a/docs/docs-ref-autogen/excel_1_13/excel/excel.range.yml
+++ b/docs/docs-ref-autogen/excel_1_13/excel/excel.range.yml
@@ -1860,7 +1860,8 @@ methods:
summary: >-
Returns a range object that includes the current range and up to the edge
of the range, based on the provided direction. This matches the
- Ctrl+Shift+Arrow key behavior in the Excel on Windows UI.
+ Ctrl+Shift+Arrow key behavior in the
+ Excel on Windows UI.
remarks: >-
\[ [API set: ExcelApi
1.13](/javascript/api/requirement-sets/excel/excel-api-requirement-sets)
@@ -1925,7 +1926,8 @@ methods:
summary: >-
Returns a range object that includes the current range and up to the edge
of the range, based on the provided direction. This matches the
- Ctrl+Shift+Arrow key behavior in the Excel on Windows UI.
+ Ctrl+Shift+Arrow key behavior in the
+ Excel on Windows UI.
remarks: >-
\[ [API set: ExcelApi
1.13](/javascript/api/requirement-sets/excel/excel-api-requirement-sets)
@@ -2389,8 +2391,8 @@ methods:
fullName: getRangeEdge(direction, activeCell)
summary: >-
Returns a range object that is the edge cell of the data region that
- corresponds to the provided direction. This matches the Ctrl+Arrow key
- behavior in the Excel on Windows UI.
+ corresponds to the provided direction. This matches the
+ Ctrl+Arrow key behavior in the Excel on Windows UI.
remarks: >-
\[ [API set: ExcelApi
1.13](/javascript/api/requirement-sets/excel/excel-api-requirement-sets)
@@ -2454,8 +2456,8 @@ methods:
fullName: getRangeEdge(direction, activeCell)
summary: >-
Returns a range object that is the edge cell of the data region that
- corresponds to the provided direction. This matches the Ctrl+Arrow key
- behavior in the Excel on Windows UI.
+ corresponds to the provided direction. This matches the
+ Ctrl+Arrow key behavior in the Excel on Windows UI.
remarks: >-
\[ [API set: ExcelApi
1.13](/javascript/api/requirement-sets/excel/excel-api-requirement-sets)
diff --git a/docs/docs-ref-autogen/excel_1_13/excel/excel.workbook.yml b/docs/docs-ref-autogen/excel_1_13/excel/excel.workbook.yml
index 29e3b36fa..1e77ea849 100644
--- a/docs/docs-ref-autogen/excel_1_13/excel/excel.workbook.yml
+++ b/docs/docs-ref-autogen/excel_1_13/excel/excel.workbook.yml
@@ -831,17 +831,22 @@ methods:
fullName: insertWorksheetsFromBase64(base64File, options)
summary: >-
Inserts the specified worksheets from a source workbook into the current
- workbook.
-
-
- *Note**: This API is currently only supported for Office on Windows,
- Mac, and the web.
+ workbook. The `extensionHardening` Windows registry key affects this API.
+ The file extension defined by the `base64File` param must match the real
+ file type of the inserted file. If `extensionHardening` is set to deny
+ mismatches and the file extension does not match the real file type, this
+ API throws the following error: "This operation is not allowed due to the
+ extension hardening policy."
remarks: >-
\[ [API set: ExcelApi
1.13](/javascript/api/requirement-sets/excel/excel-api-requirement-sets)
\]
+ This API is currently only supported for Office on Windows, Mac, and the
+ web.
+
+
#### Examples
diff --git a/docs/docs-ref-autogen/excel_1_14/excel.yml b/docs/docs-ref-autogen/excel_1_14/excel.yml
index edf8cee98..a8023db47 100644
--- a/docs/docs-ref-autogen/excel_1_14/excel.yml
+++ b/docs/docs-ref-autogen/excel_1_14/excel.yml
@@ -967,11 +967,16 @@ functions:
package: excel!
summary: >-
Creates and opens a new workbook. Optionally, the workbook can be
- pre-populated with a Base64-encoded .xlsx file. Note: Macros can be a
- security risk. If this API is used to create a workbook that includes a
- macro, the add-in user will be prompted with a "Trust this add-in?" dialog
- in the Excel UI. The user must select the "Trust add-in" button to
- proceed.
+ pre-populated with a Base64-encoded .xlsx file. The `extensionHardening`
+ Windows registry key affects the `base64File` param. The file extension
+ defined by the param must match the real file type of the file. If
+ `extensionHardening` is set to deny mismatches and the file extension does
+ not match the real file type, this API throws the following error: "This
+ operation is not allowed due to the extension hardening policy." Note:
+ Macros can be a security risk. If this API is used to create a workbook
+ that includes a macro, the add-in user will be prompted with a "Trust this
+ add-in?" dialog in the Excel UI. The user must select the "Trust add-in"
+ button to proceed.
\[ [API set: ExcelApi
diff --git a/docs/docs-ref-autogen/excel_1_14/excel/excel.range.yml b/docs/docs-ref-autogen/excel_1_14/excel/excel.range.yml
index 85409db82..f897b8e33 100644
--- a/docs/docs-ref-autogen/excel_1_14/excel/excel.range.yml
+++ b/docs/docs-ref-autogen/excel_1_14/excel/excel.range.yml
@@ -1860,7 +1860,8 @@ methods:
summary: >-
Returns a range object that includes the current range and up to the edge
of the range, based on the provided direction. This matches the
- Ctrl+Shift+Arrow key behavior in the Excel on Windows UI.
+ Ctrl+Shift+Arrow key behavior in the
+ Excel on Windows UI.
remarks: >-
\[ [API set: ExcelApi
1.13](/javascript/api/requirement-sets/excel/excel-api-requirement-sets)
@@ -1925,7 +1926,8 @@ methods:
summary: >-
Returns a range object that includes the current range and up to the edge
of the range, based on the provided direction. This matches the
- Ctrl+Shift+Arrow key behavior in the Excel on Windows UI.
+ Ctrl+Shift+Arrow key behavior in the
+ Excel on Windows UI.
remarks: >-
\[ [API set: ExcelApi
1.13](/javascript/api/requirement-sets/excel/excel-api-requirement-sets)
@@ -2441,8 +2443,8 @@ methods:
fullName: getRangeEdge(direction, activeCell)
summary: >-
Returns a range object that is the edge cell of the data region that
- corresponds to the provided direction. This matches the Ctrl+Arrow key
- behavior in the Excel on Windows UI.
+ corresponds to the provided direction. This matches the
+ Ctrl+Arrow key behavior in the Excel on Windows UI.
remarks: >-
\[ [API set: ExcelApi
1.13](/javascript/api/requirement-sets/excel/excel-api-requirement-sets)
@@ -2506,8 +2508,8 @@ methods:
fullName: getRangeEdge(direction, activeCell)
summary: >-
Returns a range object that is the edge cell of the data region that
- corresponds to the provided direction. This matches the Ctrl+Arrow key
- behavior in the Excel on Windows UI.
+ corresponds to the provided direction. This matches the
+ Ctrl+Arrow key behavior in the Excel on Windows UI.
remarks: >-
\[ [API set: ExcelApi
1.13](/javascript/api/requirement-sets/excel/excel-api-requirement-sets)
diff --git a/docs/docs-ref-autogen/excel_1_14/excel/excel.workbook.yml b/docs/docs-ref-autogen/excel_1_14/excel/excel.workbook.yml
index 2047e0734..84e3a57f9 100644
--- a/docs/docs-ref-autogen/excel_1_14/excel/excel.workbook.yml
+++ b/docs/docs-ref-autogen/excel_1_14/excel/excel.workbook.yml
@@ -847,17 +847,22 @@ methods:
fullName: insertWorksheetsFromBase64(base64File, options)
summary: >-
Inserts the specified worksheets from a source workbook into the current
- workbook.
-
-
- *Note**: This API is currently only supported for Office on Windows,
- Mac, and the web.
+ workbook. The `extensionHardening` Windows registry key affects this API.
+ The file extension defined by the `base64File` param must match the real
+ file type of the inserted file. If `extensionHardening` is set to deny
+ mismatches and the file extension does not match the real file type, this
+ API throws the following error: "This operation is not allowed due to the
+ extension hardening policy."
remarks: >-
\[ [API set: ExcelApi
1.13](/javascript/api/requirement-sets/excel/excel-api-requirement-sets)
\]
+ This API is currently only supported for Office on Windows, Mac, and the
+ web.
+
+
#### Examples
diff --git a/docs/docs-ref-autogen/excel_1_15/excel.yml b/docs/docs-ref-autogen/excel_1_15/excel.yml
index 04c2f042c..9b0464797 100644
--- a/docs/docs-ref-autogen/excel_1_15/excel.yml
+++ b/docs/docs-ref-autogen/excel_1_15/excel.yml
@@ -969,11 +969,16 @@ functions:
package: excel!
summary: >-
Creates and opens a new workbook. Optionally, the workbook can be
- pre-populated with a Base64-encoded .xlsx file. Note: Macros can be a
- security risk. If this API is used to create a workbook that includes a
- macro, the add-in user will be prompted with a "Trust this add-in?" dialog
- in the Excel UI. The user must select the "Trust add-in" button to
- proceed.
+ pre-populated with a Base64-encoded .xlsx file. The `extensionHardening`
+ Windows registry key affects the `base64File` param. The file extension
+ defined by the param must match the real file type of the file. If
+ `extensionHardening` is set to deny mismatches and the file extension does
+ not match the real file type, this API throws the following error: "This
+ operation is not allowed due to the extension hardening policy." Note:
+ Macros can be a security risk. If this API is used to create a workbook
+ that includes a macro, the add-in user will be prompted with a "Trust this
+ add-in?" dialog in the Excel UI. The user must select the "Trust add-in"
+ button to proceed.
\[ [API set: ExcelApi
diff --git a/docs/docs-ref-autogen/excel_1_15/excel/excel.range.yml b/docs/docs-ref-autogen/excel_1_15/excel/excel.range.yml
index 6f26ff15f..9ff26954e 100644
--- a/docs/docs-ref-autogen/excel_1_15/excel/excel.range.yml
+++ b/docs/docs-ref-autogen/excel_1_15/excel/excel.range.yml
@@ -1916,7 +1916,8 @@ methods:
summary: >-
Returns a range object that includes the current range and up to the edge
of the range, based on the provided direction. This matches the
- Ctrl+Shift+Arrow key behavior in the Excel on Windows UI.
+ Ctrl+Shift+Arrow key behavior in the
+ Excel on Windows UI.
remarks: >-
\[ [API set: ExcelApi
1.13](/javascript/api/requirement-sets/excel/excel-api-requirement-sets)
@@ -1981,7 +1982,8 @@ methods:
summary: >-
Returns a range object that includes the current range and up to the edge
of the range, based on the provided direction. This matches the
- Ctrl+Shift+Arrow key behavior in the Excel on Windows UI.
+ Ctrl+Shift+Arrow key behavior in the
+ Excel on Windows UI.
remarks: >-
\[ [API set: ExcelApi
1.13](/javascript/api/requirement-sets/excel/excel-api-requirement-sets)
@@ -2497,8 +2499,8 @@ methods:
fullName: getRangeEdge(direction, activeCell)
summary: >-
Returns a range object that is the edge cell of the data region that
- corresponds to the provided direction. This matches the Ctrl+Arrow key
- behavior in the Excel on Windows UI.
+ corresponds to the provided direction. This matches the
+ Ctrl+Arrow key behavior in the Excel on Windows UI.
remarks: >-
\[ [API set: ExcelApi
1.13](/javascript/api/requirement-sets/excel/excel-api-requirement-sets)
@@ -2562,8 +2564,8 @@ methods:
fullName: getRangeEdge(direction, activeCell)
summary: >-
Returns a range object that is the edge cell of the data region that
- corresponds to the provided direction. This matches the Ctrl+Arrow key
- behavior in the Excel on Windows UI.
+ corresponds to the provided direction. This matches the
+ Ctrl+Arrow key behavior in the Excel on Windows UI.
remarks: >-
\[ [API set: ExcelApi
1.13](/javascript/api/requirement-sets/excel/excel-api-requirement-sets)
diff --git a/docs/docs-ref-autogen/excel_1_15/excel/excel.workbook.yml b/docs/docs-ref-autogen/excel_1_15/excel/excel.workbook.yml
index 2047e0734..84e3a57f9 100644
--- a/docs/docs-ref-autogen/excel_1_15/excel/excel.workbook.yml
+++ b/docs/docs-ref-autogen/excel_1_15/excel/excel.workbook.yml
@@ -847,17 +847,22 @@ methods:
fullName: insertWorksheetsFromBase64(base64File, options)
summary: >-
Inserts the specified worksheets from a source workbook into the current
- workbook.
-
-
- *Note**: This API is currently only supported for Office on Windows,
- Mac, and the web.
+ workbook. The `extensionHardening` Windows registry key affects this API.
+ The file extension defined by the `base64File` param must match the real
+ file type of the inserted file. If `extensionHardening` is set to deny
+ mismatches and the file extension does not match the real file type, this
+ API throws the following error: "This operation is not allowed due to the
+ extension hardening policy."
remarks: >-
\[ [API set: ExcelApi
1.13](/javascript/api/requirement-sets/excel/excel-api-requirement-sets)
\]
+ This API is currently only supported for Office on Windows, Mac, and the
+ web.
+
+
#### Examples
diff --git a/docs/docs-ref-autogen/excel_1_16/excel.yml b/docs/docs-ref-autogen/excel_1_16/excel.yml
index c27f5b5e2..1cb8041a9 100644
--- a/docs/docs-ref-autogen/excel_1_16/excel.yml
+++ b/docs/docs-ref-autogen/excel_1_16/excel.yml
@@ -1034,11 +1034,16 @@ functions:
package: excel!
summary: >-
Creates and opens a new workbook. Optionally, the workbook can be
- pre-populated with a Base64-encoded .xlsx file. Note: Macros can be a
- security risk. If this API is used to create a workbook that includes a
- macro, the add-in user will be prompted with a "Trust this add-in?" dialog
- in the Excel UI. The user must select the "Trust add-in" button to
- proceed.
+ pre-populated with a Base64-encoded .xlsx file. The `extensionHardening`
+ Windows registry key affects the `base64File` param. The file extension
+ defined by the param must match the real file type of the file. If
+ `extensionHardening` is set to deny mismatches and the file extension does
+ not match the real file type, this API throws the following error: "This
+ operation is not allowed due to the extension hardening policy." Note:
+ Macros can be a security risk. If this API is used to create a workbook
+ that includes a macro, the add-in user will be prompted with a "Trust this
+ add-in?" dialog in the Excel UI. The user must select the "Trust add-in"
+ button to proceed.
\[ [API set: ExcelApi
diff --git a/docs/docs-ref-autogen/excel_1_16/excel/excel.cardlayout.yml b/docs/docs-ref-autogen/excel_1_16/excel/excel.cardlayout.yml
index 4de2b1d60..07ebbc46e 100644
--- a/docs/docs-ref-autogen/excel_1_16/excel/excel.cardlayout.yml
+++ b/docs/docs-ref-autogen/excel_1_16/excel/excel.cardlayout.yml
@@ -4,7 +4,15 @@ uid: excel!Excel.CardLayout:type
package: excel!
fullName: Excel.CardLayout
summary: Represents the layout of a card in card view.
-remarks: "\\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \\]\r\n\r\nLearn more about the types in this type alias through the following links. \r\n\r\n[Excel.EntityCardLayout](/javascript/api/excel/excel.entitycardlayout)"
+remarks: >-
+ \[ [API set: ExcelApi
+ 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ Learn more about the types in this type alias through the following links.
+
+
+ [Excel.EntityCardLayout](/javascript/api/excel/excel.entitycardlayout)
isPreview: false
isDeprecated: false
diff --git a/docs/docs-ref-autogen/excel_1_16/excel/excel.cardlayoutsection.yml b/docs/docs-ref-autogen/excel_1_16/excel/excel.cardlayoutsection.yml
index b54480411..97e90f572 100644
--- a/docs/docs-ref-autogen/excel_1_16/excel/excel.cardlayoutsection.yml
+++ b/docs/docs-ref-autogen/excel_1_16/excel/excel.cardlayoutsection.yml
@@ -4,7 +4,16 @@ uid: excel!Excel.CardLayoutSection:type
package: excel!
fullName: Excel.CardLayoutSection
summary: Represents the layout of a section of a card in card view.
-remarks: "\\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \\]\r\n\r\nLearn more about the types in this type alias through the following links. \r\n\r\n[Excel.CardLayoutListSection](/javascript/api/excel/excel.cardlayoutlistsection), [Excel.CardLayoutTableSection](/javascript/api/excel/excel.cardlayouttablesection)"
+remarks: >-
+ \[ [API set: ExcelApi
+ 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ Learn more about the types in this type alias through the following links.
+
+
+ [Excel.CardLayoutListSection](/javascript/api/excel/excel.cardlayoutlistsection),
+ [Excel.CardLayoutTableSection](/javascript/api/excel/excel.cardlayouttablesection)
isPreview: false
isDeprecated: false
diff --git a/docs/docs-ref-autogen/excel_1_16/excel/excel.cellvalue.yml b/docs/docs-ref-autogen/excel_1_16/excel/excel.cellvalue.yml
index 63e5befd2..b679b8142 100644
--- a/docs/docs-ref-autogen/excel_1_16/excel/excel.cellvalue.yml
+++ b/docs/docs-ref-autogen/excel_1_16/excel/excel.cellvalue.yml
@@ -4,7 +4,26 @@ uid: excel!Excel.CellValue:type
package: excel!
fullName: Excel.CellValue
summary: Represents the value in a cell.
-remarks: "\\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \\]\r\n\r\nLearn more about the types in this type alias through the following links. \r\n\r\n[Excel.ArrayCellValue](/javascript/api/excel/excel.arraycellvalue), [Excel.BooleanCellValue](/javascript/api/excel/excel.booleancellvalue), [Excel.DoubleCellValue](/javascript/api/excel/excel.doublecellvalue), [Excel.EntityCellValue](/javascript/api/excel/excel.entitycellvalue), [Excel.EmptyCellValue](/javascript/api/excel/excel.emptycellvalue), [Excel.ErrorCellValue](/javascript/api/excel/excel.errorcellvalue), [Excel.LinkedEntityCellValue](/javascript/api/excel/excel.linkedentitycellvalue), [Excel.ReferenceCellValue](/javascript/api/excel/excel.referencecellvalue), [Excel.StringCellValue](/javascript/api/excel/excel.stringcellvalue), [Excel.ValueTypeNotAvailableCellValue](/javascript/api/excel/excel.valuetypenotavailablecellvalue), [Excel.WebImageCellValue](/javascript/api/excel/excel.webimagecellvalue), [Excel.CellValueExtraProperties](/javascript/api/excel/excel.cellvalueextraproperties)"
+remarks: >-
+ \[ [API set: ExcelApi
+ 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ Learn more about the types in this type alias through the following links.
+
+
+ [Excel.ArrayCellValue](/javascript/api/excel/excel.arraycellvalue),
+ [Excel.BooleanCellValue](/javascript/api/excel/excel.booleancellvalue),
+ [Excel.DoubleCellValue](/javascript/api/excel/excel.doublecellvalue),
+ [Excel.EntityCellValue](/javascript/api/excel/excel.entitycellvalue),
+ [Excel.EmptyCellValue](/javascript/api/excel/excel.emptycellvalue),
+ [Excel.ErrorCellValue](/javascript/api/excel/excel.errorcellvalue),
+ [Excel.LinkedEntityCellValue](/javascript/api/excel/excel.linkedentitycellvalue),
+ [Excel.ReferenceCellValue](/javascript/api/excel/excel.referencecellvalue),
+ [Excel.StringCellValue](/javascript/api/excel/excel.stringcellvalue),
+ [Excel.ValueTypeNotAvailableCellValue](/javascript/api/excel/excel.valuetypenotavailablecellvalue),
+ [Excel.WebImageCellValue](/javascript/api/excel/excel.webimagecellvalue),
+ [Excel.CellValueExtraProperties](/javascript/api/excel/excel.cellvalueextraproperties)
isPreview: false
isDeprecated: false
diff --git a/docs/docs-ref-autogen/excel_1_16/excel/excel.cellvalueandpropertymetadata.yml b/docs/docs-ref-autogen/excel_1_16/excel/excel.cellvalueandpropertymetadata.yml
index 566432a91..5f661bb32 100644
--- a/docs/docs-ref-autogen/excel_1_16/excel/excel.cellvalueandpropertymetadata.yml
+++ b/docs/docs-ref-autogen/excel_1_16/excel/excel.cellvalueandpropertymetadata.yml
@@ -6,7 +6,16 @@ fullName: Excel.CellValueAndPropertyMetadata
summary: >-
Represents the value and metadata of a property. The metadata applies to the
property (and not the value), but it is combined with the value in this type.
-remarks: "\\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \\]\r\n\r\nLearn more about the types in this type alias through the following links. \r\n\r\n[Excel.CellValue](/javascript/api/excel/excel.cellvalue), [Excel.EntityPropertyExtraProperties](/javascript/api/excel/excel.entitypropertyextraproperties)"
+remarks: >-
+ \[ [API set: ExcelApi
+ 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ Learn more about the types in this type alias through the following links.
+
+
+ [Excel.CellValue](/javascript/api/excel/excel.cellvalue),
+ [Excel.EntityPropertyExtraProperties](/javascript/api/excel/excel.entitypropertyextraproperties)
isPreview: false
isDeprecated: false
diff --git a/docs/docs-ref-autogen/excel_1_16/excel/excel.compactlayout.yml b/docs/docs-ref-autogen/excel_1_16/excel/excel.compactlayout.yml
index 3f2549677..5bb689c66 100644
--- a/docs/docs-ref-autogen/excel_1_16/excel/excel.compactlayout.yml
+++ b/docs/docs-ref-autogen/excel_1_16/excel/excel.compactlayout.yml
@@ -6,7 +6,15 @@ fullName: Excel.CompactLayout
summary: >-
Represents the layout used when there is limited space to represent the
entity.
-remarks: "\\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \\]\r\n\r\nLearn more about the types in this type alias through the following links. \r\n\r\n[Excel.EntityCompactLayout](/javascript/api/excel/excel.entitycompactlayout)"
+remarks: >-
+ \[ [API set: ExcelApi
+ 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ Learn more about the types in this type alias through the following links.
+
+
+ [Excel.EntityCompactLayout](/javascript/api/excel/excel.entitycompactlayout)
isPreview: false
isDeprecated: false
diff --git a/docs/docs-ref-autogen/excel_1_16/excel/excel.entitypropertytype.yml b/docs/docs-ref-autogen/excel_1_16/excel/excel.entitypropertytype.yml
index 41a8cc7fc..bc54a6eff 100644
--- a/docs/docs-ref-autogen/excel_1_16/excel/excel.entitypropertytype.yml
+++ b/docs/docs-ref-autogen/excel_1_16/excel/excel.entitypropertytype.yml
@@ -4,7 +4,16 @@ uid: excel!Excel.EntityPropertyType:type
package: excel!
fullName: Excel.EntityPropertyType
summary: Represents the value of a property.
-remarks: "\\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \\]\r\n\r\nLearn more about the types in this type alias through the following links. \r\n\r\n[Excel.CellValueAndPropertyMetadata](/javascript/api/excel/excel.cellvalueandpropertymetadata), [Excel.CellValue](/javascript/api/excel/excel.cellvalue)"
+remarks: >-
+ \[ [API set: ExcelApi
+ 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ Learn more about the types in this type alias through the following links.
+
+
+ [Excel.CellValueAndPropertyMetadata](/javascript/api/excel/excel.cellvalueandpropertymetadata),
+ [Excel.CellValue](/javascript/api/excel/excel.cellvalue)
isPreview: false
isDeprecated: false
diff --git a/docs/docs-ref-autogen/excel_1_16/excel/excel.errorcellvalue.yml b/docs/docs-ref-autogen/excel_1_16/excel/excel.errorcellvalue.yml
index e5addcc22..b88b1959c 100644
--- a/docs/docs-ref-autogen/excel_1_16/excel/excel.errorcellvalue.yml
+++ b/docs/docs-ref-autogen/excel_1_16/excel/excel.errorcellvalue.yml
@@ -4,7 +4,62 @@ uid: excel!Excel.ErrorCellValue:type
package: excel!
fullName: Excel.ErrorCellValue
summary: Represents a cell value which contains an error.
-remarks: "\\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \\]\n\n\r\n\r\nLearn more about the types in this type alias through the following links. \r\n\r\n[Excel.BlockedErrorCellValue](/javascript/api/excel/excel.blockederrorcellvalue), [Excel.BusyErrorCellValue](/javascript/api/excel/excel.busyerrorcellvalue), [Excel.CalcErrorCellValue](/javascript/api/excel/excel.calcerrorcellvalue), [Excel.ConnectErrorCellValue](/javascript/api/excel/excel.connecterrorcellvalue), [Excel.Div0ErrorCellValue](/javascript/api/excel/excel.div0errorcellvalue), [Excel.ExternalErrorCellValue](/javascript/api/excel/excel.externalerrorcellvalue), [Excel.FieldErrorCellValue](/javascript/api/excel/excel.fielderrorcellvalue), [Excel.GettingDataErrorCellValue](/javascript/api/excel/excel.gettingdataerrorcellvalue), [Excel.NotAvailableErrorCellValue](/javascript/api/excel/excel.notavailableerrorcellvalue), [Excel.NameErrorCellValue](/javascript/api/excel/excel.nameerrorcellvalue), [Excel.NullErrorCellValue](/javascript/api/excel/excel.nullerrorcellvalue), [Excel.NumErrorCellValue](/javascript/api/excel/excel.numerrorcellvalue), [Excel.PlaceholderErrorCellValue](/javascript/api/excel/excel.placeholdererrorcellvalue), [Excel.RefErrorCellValue](/javascript/api/excel/excel.referrorcellvalue), [Excel.SpillErrorCellValue](/javascript/api/excel/excel.spillerrorcellvalue), [Excel.ValueErrorCellValue](/javascript/api/excel/excel.valueerrorcellvalue)\r\n\r\n#### Examples\n\n```TypeScript\n// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/20-data-types/data-types-error-values.yaml\n\n// This function sets the value of cell A1 to a #BUSY! error using data types.\nawait Excel.run(async (context) => {\n // Retrieve the Sample worksheet and cell A1 on that sheet.\n const sheet = context.workbook.worksheets.getItemOrNullObject(\"Sample\");\n const range = sheet.getRange(\"A1\");\n\n // Get the error data type and set its type to `busy`.\n const error: Excel.ErrorCellValue = {\n type: Excel.CellValueType.error,\n errorType: Excel.ErrorCellValueType.busy\n };\n\n // Set cell A1 as the busy error.\n range.valuesAsJson = [[error]];\n await context.sync();\n});\n```"
+remarks: >-
+ \[ [API set: ExcelApi
+ 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+
+
+ Learn more about the types in this type alias through the following links.
+
+
+ [Excel.BlockedErrorCellValue](/javascript/api/excel/excel.blockederrorcellvalue),
+ [Excel.BusyErrorCellValue](/javascript/api/excel/excel.busyerrorcellvalue),
+ [Excel.CalcErrorCellValue](/javascript/api/excel/excel.calcerrorcellvalue),
+ [Excel.ConnectErrorCellValue](/javascript/api/excel/excel.connecterrorcellvalue),
+ [Excel.Div0ErrorCellValue](/javascript/api/excel/excel.div0errorcellvalue),
+ [Excel.ExternalErrorCellValue](/javascript/api/excel/excel.externalerrorcellvalue),
+ [Excel.FieldErrorCellValue](/javascript/api/excel/excel.fielderrorcellvalue),
+ [Excel.GettingDataErrorCellValue](/javascript/api/excel/excel.gettingdataerrorcellvalue),
+ [Excel.NotAvailableErrorCellValue](/javascript/api/excel/excel.notavailableerrorcellvalue),
+ [Excel.NameErrorCellValue](/javascript/api/excel/excel.nameerrorcellvalue),
+ [Excel.NullErrorCellValue](/javascript/api/excel/excel.nullerrorcellvalue),
+ [Excel.NumErrorCellValue](/javascript/api/excel/excel.numerrorcellvalue),
+ [Excel.PlaceholderErrorCellValue](/javascript/api/excel/excel.placeholdererrorcellvalue),
+ [Excel.RefErrorCellValue](/javascript/api/excel/excel.referrorcellvalue),
+ [Excel.SpillErrorCellValue](/javascript/api/excel/excel.spillerrorcellvalue),
+ [Excel.ValueErrorCellValue](/javascript/api/excel/excel.valueerrorcellvalue)
+
+
+ #### Examples
+
+
+ ```TypeScript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/20-data-types/data-types-error-values.yaml
+
+
+ // This function sets the value of cell A1 to a #BUSY! error using data types.
+
+ await Excel.run(async (context) => {
+ // Retrieve the Sample worksheet and cell A1 on that sheet.
+ const sheet = context.workbook.worksheets.getItemOrNullObject("Sample");
+ const range = sheet.getRange("A1");
+
+ // Get the error data type and set its type to `busy`.
+ const error: Excel.ErrorCellValue = {
+ type: Excel.CellValueType.error,
+ errorType: Excel.ErrorCellValueType.busy
+ };
+
+ // Set cell A1 as the busy error.
+ range.valuesAsJson = [[error]];
+ await context.sync();
+ });
+
+ ```
isPreview: false
isDeprecated: false
diff --git a/docs/docs-ref-autogen/excel_1_16/excel/excel.notavailableerrorcellvalue.yml b/docs/docs-ref-autogen/excel_1_16/excel/excel.notavailableerrorcellvalue.yml
index 408016466..0587e033a 100644
--- a/docs/docs-ref-autogen/excel_1_16/excel/excel.notavailableerrorcellvalue.yml
+++ b/docs/docs-ref-autogen/excel_1_16/excel/excel.notavailableerrorcellvalue.yml
@@ -3,7 +3,7 @@ name: Excel.NotAvailableErrorCellValue
uid: excel!Excel.NotAvailableErrorCellValue:interface
package: excel!
fullName: Excel.NotAvailableErrorCellValue
-summary: Represents the value of a cell containing a \#N/A! error.
+summary: Represents the value of a cell containing a \#N/A error.
remarks: >-
\[ [API set: ExcelApi
1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
@@ -48,9 +48,9 @@ properties:
isPreview: false
isDeprecated: false
syntax:
- content: 'basicValue?: "#N/A!" | string;'
+ content: 'basicValue?: "#N/A" | string;'
return:
- type: '"#N/A!" | string'
+ type: '"#N/A" | string'
- name: errorType
uid: excel!Excel.NotAvailableErrorCellValue#errorType:member
package: excel!
diff --git a/docs/docs-ref-autogen/excel_1_16/excel/excel.range.yml b/docs/docs-ref-autogen/excel_1_16/excel/excel.range.yml
index 9a3d2380b..19fcc66cb 100644
--- a/docs/docs-ref-autogen/excel_1_16/excel/excel.range.yml
+++ b/docs/docs-ref-autogen/excel_1_16/excel/excel.range.yml
@@ -1994,7 +1994,8 @@ methods:
summary: >-
Returns a range object that includes the current range and up to the edge
of the range, based on the provided direction. This matches the
- Ctrl+Shift+Arrow key behavior in the Excel on Windows UI.
+ Ctrl+Shift+Arrow key behavior in the
+ Excel on Windows UI.
remarks: >-
\[ [API set: ExcelApi
1.13](/javascript/api/requirement-sets/excel/excel-api-requirement-sets)
@@ -2059,7 +2060,8 @@ methods:
summary: >-
Returns a range object that includes the current range and up to the edge
of the range, based on the provided direction. This matches the
- Ctrl+Shift+Arrow key behavior in the Excel on Windows UI.
+ Ctrl+Shift+Arrow key behavior in the
+ Excel on Windows UI.
remarks: >-
\[ [API set: ExcelApi
1.13](/javascript/api/requirement-sets/excel/excel-api-requirement-sets)
@@ -2575,8 +2577,8 @@ methods:
fullName: getRangeEdge(direction, activeCell)
summary: >-
Returns a range object that is the edge cell of the data region that
- corresponds to the provided direction. This matches the Ctrl+Arrow key
- behavior in the Excel on Windows UI.
+ corresponds to the provided direction. This matches the
+ Ctrl+Arrow key behavior in the Excel on Windows UI.
remarks: >-
\[ [API set: ExcelApi
1.13](/javascript/api/requirement-sets/excel/excel-api-requirement-sets)
@@ -2640,8 +2642,8 @@ methods:
fullName: getRangeEdge(direction, activeCell)
summary: >-
Returns a range object that is the edge cell of the data region that
- corresponds to the provided direction. This matches the Ctrl+Arrow key
- behavior in the Excel on Windows UI.
+ corresponds to the provided direction. This matches the
+ Ctrl+Arrow key behavior in the Excel on Windows UI.
remarks: >-
\[ [API set: ExcelApi
1.13](/javascript/api/requirement-sets/excel/excel-api-requirement-sets)
diff --git a/docs/docs-ref-autogen/excel_1_16/excel/excel.referencedvalue.yml b/docs/docs-ref-autogen/excel_1_16/excel/excel.referencedvalue.yml
index 57044e8eb..168b4928b 100644
--- a/docs/docs-ref-autogen/excel_1_16/excel/excel.referencedvalue.yml
+++ b/docs/docs-ref-autogen/excel_1_16/excel/excel.referencedvalue.yml
@@ -4,7 +4,20 @@ uid: excel!Excel.ReferencedValue:type
package: excel!
fullName: Excel.ReferencedValue
summary: Represents the value in a cell.
-remarks: "\\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \\]\r\n\r\nLearn more about the types in this type alias through the following links. \r\n\r\n[Excel.ArrayCellValue](/javascript/api/excel/excel.arraycellvalue), [Excel.EntityCellValue](/javascript/api/excel/excel.entitycellvalue), [Excel.RootReferenceCellValue](/javascript/api/excel/excel.rootreferencecellvalue), [Excel.DoubleCellValue](/javascript/api/excel/excel.doublecellvalue), [Excel.StringCellValue](/javascript/api/excel/excel.stringcellvalue), [Excel.BooleanCellValue](/javascript/api/excel/excel.booleancellvalue)"
+remarks: >-
+ \[ [API set: ExcelApi
+ 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ Learn more about the types in this type alias through the following links.
+
+
+ [Excel.ArrayCellValue](/javascript/api/excel/excel.arraycellvalue),
+ [Excel.EntityCellValue](/javascript/api/excel/excel.entitycellvalue),
+ [Excel.RootReferenceCellValue](/javascript/api/excel/excel.rootreferencecellvalue),
+ [Excel.DoubleCellValue](/javascript/api/excel/excel.doublecellvalue),
+ [Excel.StringCellValue](/javascript/api/excel/excel.stringcellvalue),
+ [Excel.BooleanCellValue](/javascript/api/excel/excel.booleancellvalue)
isPreview: false
isDeprecated: false
diff --git a/docs/docs-ref-autogen/excel_1_16/excel/excel.workbook.yml b/docs/docs-ref-autogen/excel_1_16/excel/excel.workbook.yml
index 74d0c35c9..ff7ee83f8 100644
--- a/docs/docs-ref-autogen/excel_1_16/excel/excel.workbook.yml
+++ b/docs/docs-ref-autogen/excel_1_16/excel/excel.workbook.yml
@@ -876,17 +876,22 @@ methods:
fullName: insertWorksheetsFromBase64(base64File, options)
summary: >-
Inserts the specified worksheets from a source workbook into the current
- workbook.
-
-
- *Note**: This API is currently only supported for Office on Windows,
- Mac, and the web.
+ workbook. The `extensionHardening` Windows registry key affects this API.
+ The file extension defined by the `base64File` param must match the real
+ file type of the inserted file. If `extensionHardening` is set to deny
+ mismatches and the file extension does not match the real file type, this
+ API throws the following error: "This operation is not allowed due to the
+ extension hardening policy."
remarks: >-
\[ [API set: ExcelApi
1.13](/javascript/api/requirement-sets/excel/excel-api-requirement-sets)
\]
+ This API is currently only supported for Office on Windows, Mac, and the
+ web.
+
+
#### Examples
diff --git a/docs/docs-ref-autogen/excel_1_17/excel.yml b/docs/docs-ref-autogen/excel_1_17/excel.yml
index 9db593c91..1f223c14f 100644
--- a/docs/docs-ref-autogen/excel_1_17/excel.yml
+++ b/docs/docs-ref-autogen/excel_1_17/excel.yml
@@ -1037,11 +1037,16 @@ functions:
package: excel!
summary: >-
Creates and opens a new workbook. Optionally, the workbook can be
- pre-populated with a Base64-encoded .xlsx file. Note: Macros can be a
- security risk. If this API is used to create a workbook that includes a
- macro, the add-in user will be prompted with a "Trust this add-in?" dialog
- in the Excel UI. The user must select the "Trust add-in" button to
- proceed.
+ pre-populated with a Base64-encoded .xlsx file. The `extensionHardening`
+ Windows registry key affects the `base64File` param. The file extension
+ defined by the param must match the real file type of the file. If
+ `extensionHardening` is set to deny mismatches and the file extension does
+ not match the real file type, this API throws the following error: "This
+ operation is not allowed due to the extension hardening policy." Note:
+ Macros can be a security risk. If this API is used to create a workbook
+ that includes a macro, the add-in user will be prompted with a "Trust this
+ add-in?" dialog in the Excel UI. The user must select the "Trust add-in"
+ button to proceed.
\[ [API set: ExcelApi
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.cardlayout.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.cardlayout.yml
index 4de2b1d60..07ebbc46e 100644
--- a/docs/docs-ref-autogen/excel_1_17/excel/excel.cardlayout.yml
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.cardlayout.yml
@@ -4,7 +4,15 @@ uid: excel!Excel.CardLayout:type
package: excel!
fullName: Excel.CardLayout
summary: Represents the layout of a card in card view.
-remarks: "\\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \\]\r\n\r\nLearn more about the types in this type alias through the following links. \r\n\r\n[Excel.EntityCardLayout](/javascript/api/excel/excel.entitycardlayout)"
+remarks: >-
+ \[ [API set: ExcelApi
+ 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ Learn more about the types in this type alias through the following links.
+
+
+ [Excel.EntityCardLayout](/javascript/api/excel/excel.entitycardlayout)
isPreview: false
isDeprecated: false
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.cardlayoutsection.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.cardlayoutsection.yml
index b54480411..97e90f572 100644
--- a/docs/docs-ref-autogen/excel_1_17/excel/excel.cardlayoutsection.yml
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.cardlayoutsection.yml
@@ -4,7 +4,16 @@ uid: excel!Excel.CardLayoutSection:type
package: excel!
fullName: Excel.CardLayoutSection
summary: Represents the layout of a section of a card in card view.
-remarks: "\\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \\]\r\n\r\nLearn more about the types in this type alias through the following links. \r\n\r\n[Excel.CardLayoutListSection](/javascript/api/excel/excel.cardlayoutlistsection), [Excel.CardLayoutTableSection](/javascript/api/excel/excel.cardlayouttablesection)"
+remarks: >-
+ \[ [API set: ExcelApi
+ 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ Learn more about the types in this type alias through the following links.
+
+
+ [Excel.CardLayoutListSection](/javascript/api/excel/excel.cardlayoutlistsection),
+ [Excel.CardLayoutTableSection](/javascript/api/excel/excel.cardlayouttablesection)
isPreview: false
isDeprecated: false
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.cellvalue.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.cellvalue.yml
index 63e5befd2..b679b8142 100644
--- a/docs/docs-ref-autogen/excel_1_17/excel/excel.cellvalue.yml
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.cellvalue.yml
@@ -4,7 +4,26 @@ uid: excel!Excel.CellValue:type
package: excel!
fullName: Excel.CellValue
summary: Represents the value in a cell.
-remarks: "\\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \\]\r\n\r\nLearn more about the types in this type alias through the following links. \r\n\r\n[Excel.ArrayCellValue](/javascript/api/excel/excel.arraycellvalue), [Excel.BooleanCellValue](/javascript/api/excel/excel.booleancellvalue), [Excel.DoubleCellValue](/javascript/api/excel/excel.doublecellvalue), [Excel.EntityCellValue](/javascript/api/excel/excel.entitycellvalue), [Excel.EmptyCellValue](/javascript/api/excel/excel.emptycellvalue), [Excel.ErrorCellValue](/javascript/api/excel/excel.errorcellvalue), [Excel.LinkedEntityCellValue](/javascript/api/excel/excel.linkedentitycellvalue), [Excel.ReferenceCellValue](/javascript/api/excel/excel.referencecellvalue), [Excel.StringCellValue](/javascript/api/excel/excel.stringcellvalue), [Excel.ValueTypeNotAvailableCellValue](/javascript/api/excel/excel.valuetypenotavailablecellvalue), [Excel.WebImageCellValue](/javascript/api/excel/excel.webimagecellvalue), [Excel.CellValueExtraProperties](/javascript/api/excel/excel.cellvalueextraproperties)"
+remarks: >-
+ \[ [API set: ExcelApi
+ 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ Learn more about the types in this type alias through the following links.
+
+
+ [Excel.ArrayCellValue](/javascript/api/excel/excel.arraycellvalue),
+ [Excel.BooleanCellValue](/javascript/api/excel/excel.booleancellvalue),
+ [Excel.DoubleCellValue](/javascript/api/excel/excel.doublecellvalue),
+ [Excel.EntityCellValue](/javascript/api/excel/excel.entitycellvalue),
+ [Excel.EmptyCellValue](/javascript/api/excel/excel.emptycellvalue),
+ [Excel.ErrorCellValue](/javascript/api/excel/excel.errorcellvalue),
+ [Excel.LinkedEntityCellValue](/javascript/api/excel/excel.linkedentitycellvalue),
+ [Excel.ReferenceCellValue](/javascript/api/excel/excel.referencecellvalue),
+ [Excel.StringCellValue](/javascript/api/excel/excel.stringcellvalue),
+ [Excel.ValueTypeNotAvailableCellValue](/javascript/api/excel/excel.valuetypenotavailablecellvalue),
+ [Excel.WebImageCellValue](/javascript/api/excel/excel.webimagecellvalue),
+ [Excel.CellValueExtraProperties](/javascript/api/excel/excel.cellvalueextraproperties)
isPreview: false
isDeprecated: false
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.cellvalueandpropertymetadata.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.cellvalueandpropertymetadata.yml
index 566432a91..5f661bb32 100644
--- a/docs/docs-ref-autogen/excel_1_17/excel/excel.cellvalueandpropertymetadata.yml
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.cellvalueandpropertymetadata.yml
@@ -6,7 +6,16 @@ fullName: Excel.CellValueAndPropertyMetadata
summary: >-
Represents the value and metadata of a property. The metadata applies to the
property (and not the value), but it is combined with the value in this type.
-remarks: "\\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \\]\r\n\r\nLearn more about the types in this type alias through the following links. \r\n\r\n[Excel.CellValue](/javascript/api/excel/excel.cellvalue), [Excel.EntityPropertyExtraProperties](/javascript/api/excel/excel.entitypropertyextraproperties)"
+remarks: >-
+ \[ [API set: ExcelApi
+ 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ Learn more about the types in this type alias through the following links.
+
+
+ [Excel.CellValue](/javascript/api/excel/excel.cellvalue),
+ [Excel.EntityPropertyExtraProperties](/javascript/api/excel/excel.entitypropertyextraproperties)
isPreview: false
isDeprecated: false
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.compactlayout.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.compactlayout.yml
index 3f2549677..5bb689c66 100644
--- a/docs/docs-ref-autogen/excel_1_17/excel/excel.compactlayout.yml
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.compactlayout.yml
@@ -6,7 +6,15 @@ fullName: Excel.CompactLayout
summary: >-
Represents the layout used when there is limited space to represent the
entity.
-remarks: "\\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \\]\r\n\r\nLearn more about the types in this type alias through the following links. \r\n\r\n[Excel.EntityCompactLayout](/javascript/api/excel/excel.entitycompactlayout)"
+remarks: >-
+ \[ [API set: ExcelApi
+ 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ Learn more about the types in this type alias through the following links.
+
+
+ [Excel.EntityCompactLayout](/javascript/api/excel/excel.entitycompactlayout)
isPreview: false
isDeprecated: false
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.entitypropertytype.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.entitypropertytype.yml
index 41a8cc7fc..bc54a6eff 100644
--- a/docs/docs-ref-autogen/excel_1_17/excel/excel.entitypropertytype.yml
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.entitypropertytype.yml
@@ -4,7 +4,16 @@ uid: excel!Excel.EntityPropertyType:type
package: excel!
fullName: Excel.EntityPropertyType
summary: Represents the value of a property.
-remarks: "\\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \\]\r\n\r\nLearn more about the types in this type alias through the following links. \r\n\r\n[Excel.CellValueAndPropertyMetadata](/javascript/api/excel/excel.cellvalueandpropertymetadata), [Excel.CellValue](/javascript/api/excel/excel.cellvalue)"
+remarks: >-
+ \[ [API set: ExcelApi
+ 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ Learn more about the types in this type alias through the following links.
+
+
+ [Excel.CellValueAndPropertyMetadata](/javascript/api/excel/excel.cellvalueandpropertymetadata),
+ [Excel.CellValue](/javascript/api/excel/excel.cellvalue)
isPreview: false
isDeprecated: false
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.errorcellvalue.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.errorcellvalue.yml
index e5addcc22..b88b1959c 100644
--- a/docs/docs-ref-autogen/excel_1_17/excel/excel.errorcellvalue.yml
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.errorcellvalue.yml
@@ -4,7 +4,62 @@ uid: excel!Excel.ErrorCellValue:type
package: excel!
fullName: Excel.ErrorCellValue
summary: Represents a cell value which contains an error.
-remarks: "\\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \\]\n\n\r\n\r\nLearn more about the types in this type alias through the following links. \r\n\r\n[Excel.BlockedErrorCellValue](/javascript/api/excel/excel.blockederrorcellvalue), [Excel.BusyErrorCellValue](/javascript/api/excel/excel.busyerrorcellvalue), [Excel.CalcErrorCellValue](/javascript/api/excel/excel.calcerrorcellvalue), [Excel.ConnectErrorCellValue](/javascript/api/excel/excel.connecterrorcellvalue), [Excel.Div0ErrorCellValue](/javascript/api/excel/excel.div0errorcellvalue), [Excel.ExternalErrorCellValue](/javascript/api/excel/excel.externalerrorcellvalue), [Excel.FieldErrorCellValue](/javascript/api/excel/excel.fielderrorcellvalue), [Excel.GettingDataErrorCellValue](/javascript/api/excel/excel.gettingdataerrorcellvalue), [Excel.NotAvailableErrorCellValue](/javascript/api/excel/excel.notavailableerrorcellvalue), [Excel.NameErrorCellValue](/javascript/api/excel/excel.nameerrorcellvalue), [Excel.NullErrorCellValue](/javascript/api/excel/excel.nullerrorcellvalue), [Excel.NumErrorCellValue](/javascript/api/excel/excel.numerrorcellvalue), [Excel.PlaceholderErrorCellValue](/javascript/api/excel/excel.placeholdererrorcellvalue), [Excel.RefErrorCellValue](/javascript/api/excel/excel.referrorcellvalue), [Excel.SpillErrorCellValue](/javascript/api/excel/excel.spillerrorcellvalue), [Excel.ValueErrorCellValue](/javascript/api/excel/excel.valueerrorcellvalue)\r\n\r\n#### Examples\n\n```TypeScript\n// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/20-data-types/data-types-error-values.yaml\n\n// This function sets the value of cell A1 to a #BUSY! error using data types.\nawait Excel.run(async (context) => {\n // Retrieve the Sample worksheet and cell A1 on that sheet.\n const sheet = context.workbook.worksheets.getItemOrNullObject(\"Sample\");\n const range = sheet.getRange(\"A1\");\n\n // Get the error data type and set its type to `busy`.\n const error: Excel.ErrorCellValue = {\n type: Excel.CellValueType.error,\n errorType: Excel.ErrorCellValueType.busy\n };\n\n // Set cell A1 as the busy error.\n range.valuesAsJson = [[error]];\n await context.sync();\n});\n```"
+remarks: >-
+ \[ [API set: ExcelApi
+ 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+
+
+ Learn more about the types in this type alias through the following links.
+
+
+ [Excel.BlockedErrorCellValue](/javascript/api/excel/excel.blockederrorcellvalue),
+ [Excel.BusyErrorCellValue](/javascript/api/excel/excel.busyerrorcellvalue),
+ [Excel.CalcErrorCellValue](/javascript/api/excel/excel.calcerrorcellvalue),
+ [Excel.ConnectErrorCellValue](/javascript/api/excel/excel.connecterrorcellvalue),
+ [Excel.Div0ErrorCellValue](/javascript/api/excel/excel.div0errorcellvalue),
+ [Excel.ExternalErrorCellValue](/javascript/api/excel/excel.externalerrorcellvalue),
+ [Excel.FieldErrorCellValue](/javascript/api/excel/excel.fielderrorcellvalue),
+ [Excel.GettingDataErrorCellValue](/javascript/api/excel/excel.gettingdataerrorcellvalue),
+ [Excel.NotAvailableErrorCellValue](/javascript/api/excel/excel.notavailableerrorcellvalue),
+ [Excel.NameErrorCellValue](/javascript/api/excel/excel.nameerrorcellvalue),
+ [Excel.NullErrorCellValue](/javascript/api/excel/excel.nullerrorcellvalue),
+ [Excel.NumErrorCellValue](/javascript/api/excel/excel.numerrorcellvalue),
+ [Excel.PlaceholderErrorCellValue](/javascript/api/excel/excel.placeholdererrorcellvalue),
+ [Excel.RefErrorCellValue](/javascript/api/excel/excel.referrorcellvalue),
+ [Excel.SpillErrorCellValue](/javascript/api/excel/excel.spillerrorcellvalue),
+ [Excel.ValueErrorCellValue](/javascript/api/excel/excel.valueerrorcellvalue)
+
+
+ #### Examples
+
+
+ ```TypeScript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/20-data-types/data-types-error-values.yaml
+
+
+ // This function sets the value of cell A1 to a #BUSY! error using data types.
+
+ await Excel.run(async (context) => {
+ // Retrieve the Sample worksheet and cell A1 on that sheet.
+ const sheet = context.workbook.worksheets.getItemOrNullObject("Sample");
+ const range = sheet.getRange("A1");
+
+ // Get the error data type and set its type to `busy`.
+ const error: Excel.ErrorCellValue = {
+ type: Excel.CellValueType.error,
+ errorType: Excel.ErrorCellValueType.busy
+ };
+
+ // Set cell A1 as the busy error.
+ range.valuesAsJson = [[error]];
+ await context.sync();
+ });
+
+ ```
isPreview: false
isDeprecated: false
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.notavailableerrorcellvalue.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.notavailableerrorcellvalue.yml
index 408016466..0587e033a 100644
--- a/docs/docs-ref-autogen/excel_1_17/excel/excel.notavailableerrorcellvalue.yml
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.notavailableerrorcellvalue.yml
@@ -3,7 +3,7 @@ name: Excel.NotAvailableErrorCellValue
uid: excel!Excel.NotAvailableErrorCellValue:interface
package: excel!
fullName: Excel.NotAvailableErrorCellValue
-summary: Represents the value of a cell containing a \#N/A! error.
+summary: Represents the value of a cell containing a \#N/A error.
remarks: >-
\[ [API set: ExcelApi
1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
@@ -48,9 +48,9 @@ properties:
isPreview: false
isDeprecated: false
syntax:
- content: 'basicValue?: "#N/A!" | string;'
+ content: 'basicValue?: "#N/A" | string;'
return:
- type: '"#N/A!" | string'
+ type: '"#N/A" | string'
- name: errorType
uid: excel!Excel.NotAvailableErrorCellValue#errorType:member
package: excel!
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.range.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.range.yml
index 9a3d2380b..19fcc66cb 100644
--- a/docs/docs-ref-autogen/excel_1_17/excel/excel.range.yml
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.range.yml
@@ -1994,7 +1994,8 @@ methods:
summary: >-
Returns a range object that includes the current range and up to the edge
of the range, based on the provided direction. This matches the
- Ctrl+Shift+Arrow key behavior in the Excel on Windows UI.
+ Ctrl+Shift+Arrow key behavior in the
+ Excel on Windows UI.
remarks: >-
\[ [API set: ExcelApi
1.13](/javascript/api/requirement-sets/excel/excel-api-requirement-sets)
@@ -2059,7 +2060,8 @@ methods:
summary: >-
Returns a range object that includes the current range and up to the edge
of the range, based on the provided direction. This matches the
- Ctrl+Shift+Arrow key behavior in the Excel on Windows UI.
+ Ctrl+Shift+Arrow key behavior in the
+ Excel on Windows UI.
remarks: >-
\[ [API set: ExcelApi
1.13](/javascript/api/requirement-sets/excel/excel-api-requirement-sets)
@@ -2575,8 +2577,8 @@ methods:
fullName: getRangeEdge(direction, activeCell)
summary: >-
Returns a range object that is the edge cell of the data region that
- corresponds to the provided direction. This matches the Ctrl+Arrow key
- behavior in the Excel on Windows UI.
+ corresponds to the provided direction. This matches the
+ Ctrl+Arrow key behavior in the Excel on Windows UI.
remarks: >-
\[ [API set: ExcelApi
1.13](/javascript/api/requirement-sets/excel/excel-api-requirement-sets)
@@ -2640,8 +2642,8 @@ methods:
fullName: getRangeEdge(direction, activeCell)
summary: >-
Returns a range object that is the edge cell of the data region that
- corresponds to the provided direction. This matches the Ctrl+Arrow key
- behavior in the Excel on Windows UI.
+ corresponds to the provided direction. This matches the
+ Ctrl+Arrow key behavior in the Excel on Windows UI.
remarks: >-
\[ [API set: ExcelApi
1.13](/javascript/api/requirement-sets/excel/excel-api-requirement-sets)
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.referencedvalue.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.referencedvalue.yml
index 57044e8eb..168b4928b 100644
--- a/docs/docs-ref-autogen/excel_1_17/excel/excel.referencedvalue.yml
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.referencedvalue.yml
@@ -4,7 +4,20 @@ uid: excel!Excel.ReferencedValue:type
package: excel!
fullName: Excel.ReferencedValue
summary: Represents the value in a cell.
-remarks: "\\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \\]\r\n\r\nLearn more about the types in this type alias through the following links. \r\n\r\n[Excel.ArrayCellValue](/javascript/api/excel/excel.arraycellvalue), [Excel.EntityCellValue](/javascript/api/excel/excel.entitycellvalue), [Excel.RootReferenceCellValue](/javascript/api/excel/excel.rootreferencecellvalue), [Excel.DoubleCellValue](/javascript/api/excel/excel.doublecellvalue), [Excel.StringCellValue](/javascript/api/excel/excel.stringcellvalue), [Excel.BooleanCellValue](/javascript/api/excel/excel.booleancellvalue)"
+remarks: >-
+ \[ [API set: ExcelApi
+ 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ Learn more about the types in this type alias through the following links.
+
+
+ [Excel.ArrayCellValue](/javascript/api/excel/excel.arraycellvalue),
+ [Excel.EntityCellValue](/javascript/api/excel/excel.entitycellvalue),
+ [Excel.RootReferenceCellValue](/javascript/api/excel/excel.rootreferencecellvalue),
+ [Excel.DoubleCellValue](/javascript/api/excel/excel.doublecellvalue),
+ [Excel.StringCellValue](/javascript/api/excel/excel.stringcellvalue),
+ [Excel.BooleanCellValue](/javascript/api/excel/excel.booleancellvalue)
isPreview: false
isDeprecated: false
diff --git a/docs/docs-ref-autogen/excel_1_17/excel/excel.workbook.yml b/docs/docs-ref-autogen/excel_1_17/excel/excel.workbook.yml
index 74d0c35c9..ff7ee83f8 100644
--- a/docs/docs-ref-autogen/excel_1_17/excel/excel.workbook.yml
+++ b/docs/docs-ref-autogen/excel_1_17/excel/excel.workbook.yml
@@ -876,17 +876,22 @@ methods:
fullName: insertWorksheetsFromBase64(base64File, options)
summary: >-
Inserts the specified worksheets from a source workbook into the current
- workbook.
-
-
- *Note**: This API is currently only supported for Office on Windows,
- Mac, and the web.
+ workbook. The `extensionHardening` Windows registry key affects this API.
+ The file extension defined by the `base64File` param must match the real
+ file type of the inserted file. If `extensionHardening` is set to deny
+ mismatches and the file extension does not match the real file type, this
+ API throws the following error: "This operation is not allowed due to the
+ extension hardening policy."
remarks: >-
\[ [API set: ExcelApi
1.13](/javascript/api/requirement-sets/excel/excel-api-requirement-sets)
\]
+ This API is currently only supported for Office on Windows, Mac, and the
+ web.
+
+
#### Examples
diff --git a/docs/docs-ref-autogen/excel_1_18/excel.yml b/docs/docs-ref-autogen/excel_1_18/excel.yml
index 462fb5c2d..3a002668e 100644
--- a/docs/docs-ref-autogen/excel_1_18/excel.yml
+++ b/docs/docs-ref-autogen/excel_1_18/excel.yml
@@ -1048,11 +1048,16 @@ functions:
package: excel!
summary: >-
Creates and opens a new workbook. Optionally, the workbook can be
- pre-populated with a Base64-encoded .xlsx file. Note: Macros can be a
- security risk. If this API is used to create a workbook that includes a
- macro, the add-in user will be prompted with a "Trust this add-in?" dialog
- in the Excel UI. The user must select the "Trust add-in" button to
- proceed.
+ pre-populated with a Base64-encoded .xlsx file. The `extensionHardening`
+ Windows registry key affects the `base64File` param. The file extension
+ defined by the param must match the real file type of the file. If
+ `extensionHardening` is set to deny mismatches and the file extension does
+ not match the real file type, this API throws the following error: "This
+ operation is not allowed due to the extension hardening policy." Note:
+ Macros can be a security risk. If this API is used to create a workbook
+ that includes a macro, the add-in user will be prompted with a "Trust this
+ add-in?" dialog in the Excel UI. The user must select the "Trust add-in"
+ button to proceed.
\[ [API set: ExcelApi
diff --git a/docs/docs-ref-autogen/excel_1_18/excel/excel.cardlayout.yml b/docs/docs-ref-autogen/excel_1_18/excel/excel.cardlayout.yml
index 4de2b1d60..07ebbc46e 100644
--- a/docs/docs-ref-autogen/excel_1_18/excel/excel.cardlayout.yml
+++ b/docs/docs-ref-autogen/excel_1_18/excel/excel.cardlayout.yml
@@ -4,7 +4,15 @@ uid: excel!Excel.CardLayout:type
package: excel!
fullName: Excel.CardLayout
summary: Represents the layout of a card in card view.
-remarks: "\\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \\]\r\n\r\nLearn more about the types in this type alias through the following links. \r\n\r\n[Excel.EntityCardLayout](/javascript/api/excel/excel.entitycardlayout)"
+remarks: >-
+ \[ [API set: ExcelApi
+ 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ Learn more about the types in this type alias through the following links.
+
+
+ [Excel.EntityCardLayout](/javascript/api/excel/excel.entitycardlayout)
isPreview: false
isDeprecated: false
diff --git a/docs/docs-ref-autogen/excel_1_18/excel/excel.cardlayoutsection.yml b/docs/docs-ref-autogen/excel_1_18/excel/excel.cardlayoutsection.yml
index b54480411..97e90f572 100644
--- a/docs/docs-ref-autogen/excel_1_18/excel/excel.cardlayoutsection.yml
+++ b/docs/docs-ref-autogen/excel_1_18/excel/excel.cardlayoutsection.yml
@@ -4,7 +4,16 @@ uid: excel!Excel.CardLayoutSection:type
package: excel!
fullName: Excel.CardLayoutSection
summary: Represents the layout of a section of a card in card view.
-remarks: "\\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \\]\r\n\r\nLearn more about the types in this type alias through the following links. \r\n\r\n[Excel.CardLayoutListSection](/javascript/api/excel/excel.cardlayoutlistsection), [Excel.CardLayoutTableSection](/javascript/api/excel/excel.cardlayouttablesection)"
+remarks: >-
+ \[ [API set: ExcelApi
+ 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ Learn more about the types in this type alias through the following links.
+
+
+ [Excel.CardLayoutListSection](/javascript/api/excel/excel.cardlayoutlistsection),
+ [Excel.CardLayoutTableSection](/javascript/api/excel/excel.cardlayouttablesection)
isPreview: false
isDeprecated: false
diff --git a/docs/docs-ref-autogen/excel_1_18/excel/excel.cellcontrol.yml b/docs/docs-ref-autogen/excel_1_18/excel/excel.cellcontrol.yml
index ecd03dccf..5e5954d3d 100644
--- a/docs/docs-ref-autogen/excel_1_18/excel/excel.cellcontrol.yml
+++ b/docs/docs-ref-autogen/excel_1_18/excel/excel.cellcontrol.yml
@@ -4,7 +4,47 @@ uid: excel!Excel.CellControl:type
package: excel!
fullName: Excel.CellControl
summary: Represents an interactable control inside of a cell.
-remarks: "\\[ [API set: ExcelApi 1.18](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \\]\n\n\r\n\r\nLearn more about the types in this type alias through the following links. \r\n\r\n[Excel.UnknownCellControl](/javascript/api/excel/excel.unknowncellcontrol), [Excel.EmptyCellControl](/javascript/api/excel/excel.emptycellcontrol), [Excel.MixedCellControl](/javascript/api/excel/excel.mixedcellcontrol), [Excel.CheckboxCellControl](/javascript/api/excel/excel.checkboxcellcontrol)\r\n\r\n#### Examples\n\n```TypeScript\n// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/42-range/range-cell-control.yaml\n\n// Add checkboxes to the table.\nawait Excel.run(async (context) => {\n const sheet = context.workbook.worksheets.getActiveWorksheet();\n\n // Get the second column in the table, without the header.\n const range = sheet.tables.getItem(\"FruitTable\").columns.getItem(\"Analysis\").getDataBodyRange();\n\n // Change the boolean values to checkboxes.\n range.control = {\n type: Excel.CellControlType.checkbox\n };\n await context.sync();\n});\n```"
+remarks: >-
+ \[ [API set: ExcelApi
+ 1.18](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+
+
+ Learn more about the types in this type alias through the following links.
+
+
+ [Excel.UnknownCellControl](/javascript/api/excel/excel.unknowncellcontrol),
+ [Excel.EmptyCellControl](/javascript/api/excel/excel.emptycellcontrol),
+ [Excel.MixedCellControl](/javascript/api/excel/excel.mixedcellcontrol),
+ [Excel.CheckboxCellControl](/javascript/api/excel/excel.checkboxcellcontrol)
+
+
+ #### Examples
+
+
+ ```TypeScript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/42-range/range-cell-control.yaml
+
+
+ // Add checkboxes to the table.
+
+ await Excel.run(async (context) => {
+ const sheet = context.workbook.worksheets.getActiveWorksheet();
+
+ // Get the second column in the table, without the header.
+ const range = sheet.tables.getItem("FruitTable").columns.getItem("Analysis").getDataBodyRange();
+
+ // Change the boolean values to checkboxes.
+ range.control = {
+ type: Excel.CellControlType.checkbox
+ };
+ await context.sync();
+ });
+
+ ```
isPreview: false
isDeprecated: false
diff --git a/docs/docs-ref-autogen/excel_1_18/excel/excel.cellvalue.yml b/docs/docs-ref-autogen/excel_1_18/excel/excel.cellvalue.yml
index 63e5befd2..b679b8142 100644
--- a/docs/docs-ref-autogen/excel_1_18/excel/excel.cellvalue.yml
+++ b/docs/docs-ref-autogen/excel_1_18/excel/excel.cellvalue.yml
@@ -4,7 +4,26 @@ uid: excel!Excel.CellValue:type
package: excel!
fullName: Excel.CellValue
summary: Represents the value in a cell.
-remarks: "\\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \\]\r\n\r\nLearn more about the types in this type alias through the following links. \r\n\r\n[Excel.ArrayCellValue](/javascript/api/excel/excel.arraycellvalue), [Excel.BooleanCellValue](/javascript/api/excel/excel.booleancellvalue), [Excel.DoubleCellValue](/javascript/api/excel/excel.doublecellvalue), [Excel.EntityCellValue](/javascript/api/excel/excel.entitycellvalue), [Excel.EmptyCellValue](/javascript/api/excel/excel.emptycellvalue), [Excel.ErrorCellValue](/javascript/api/excel/excel.errorcellvalue), [Excel.LinkedEntityCellValue](/javascript/api/excel/excel.linkedentitycellvalue), [Excel.ReferenceCellValue](/javascript/api/excel/excel.referencecellvalue), [Excel.StringCellValue](/javascript/api/excel/excel.stringcellvalue), [Excel.ValueTypeNotAvailableCellValue](/javascript/api/excel/excel.valuetypenotavailablecellvalue), [Excel.WebImageCellValue](/javascript/api/excel/excel.webimagecellvalue), [Excel.CellValueExtraProperties](/javascript/api/excel/excel.cellvalueextraproperties)"
+remarks: >-
+ \[ [API set: ExcelApi
+ 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ Learn more about the types in this type alias through the following links.
+
+
+ [Excel.ArrayCellValue](/javascript/api/excel/excel.arraycellvalue),
+ [Excel.BooleanCellValue](/javascript/api/excel/excel.booleancellvalue),
+ [Excel.DoubleCellValue](/javascript/api/excel/excel.doublecellvalue),
+ [Excel.EntityCellValue](/javascript/api/excel/excel.entitycellvalue),
+ [Excel.EmptyCellValue](/javascript/api/excel/excel.emptycellvalue),
+ [Excel.ErrorCellValue](/javascript/api/excel/excel.errorcellvalue),
+ [Excel.LinkedEntityCellValue](/javascript/api/excel/excel.linkedentitycellvalue),
+ [Excel.ReferenceCellValue](/javascript/api/excel/excel.referencecellvalue),
+ [Excel.StringCellValue](/javascript/api/excel/excel.stringcellvalue),
+ [Excel.ValueTypeNotAvailableCellValue](/javascript/api/excel/excel.valuetypenotavailablecellvalue),
+ [Excel.WebImageCellValue](/javascript/api/excel/excel.webimagecellvalue),
+ [Excel.CellValueExtraProperties](/javascript/api/excel/excel.cellvalueextraproperties)
isPreview: false
isDeprecated: false
diff --git a/docs/docs-ref-autogen/excel_1_18/excel/excel.cellvalueandpropertymetadata.yml b/docs/docs-ref-autogen/excel_1_18/excel/excel.cellvalueandpropertymetadata.yml
index 566432a91..5f661bb32 100644
--- a/docs/docs-ref-autogen/excel_1_18/excel/excel.cellvalueandpropertymetadata.yml
+++ b/docs/docs-ref-autogen/excel_1_18/excel/excel.cellvalueandpropertymetadata.yml
@@ -6,7 +6,16 @@ fullName: Excel.CellValueAndPropertyMetadata
summary: >-
Represents the value and metadata of a property. The metadata applies to the
property (and not the value), but it is combined with the value in this type.
-remarks: "\\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \\]\r\n\r\nLearn more about the types in this type alias through the following links. \r\n\r\n[Excel.CellValue](/javascript/api/excel/excel.cellvalue), [Excel.EntityPropertyExtraProperties](/javascript/api/excel/excel.entitypropertyextraproperties)"
+remarks: >-
+ \[ [API set: ExcelApi
+ 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ Learn more about the types in this type alias through the following links.
+
+
+ [Excel.CellValue](/javascript/api/excel/excel.cellvalue),
+ [Excel.EntityPropertyExtraProperties](/javascript/api/excel/excel.entitypropertyextraproperties)
isPreview: false
isDeprecated: false
diff --git a/docs/docs-ref-autogen/excel_1_18/excel/excel.compactlayout.yml b/docs/docs-ref-autogen/excel_1_18/excel/excel.compactlayout.yml
index 3f2549677..5bb689c66 100644
--- a/docs/docs-ref-autogen/excel_1_18/excel/excel.compactlayout.yml
+++ b/docs/docs-ref-autogen/excel_1_18/excel/excel.compactlayout.yml
@@ -6,7 +6,15 @@ fullName: Excel.CompactLayout
summary: >-
Represents the layout used when there is limited space to represent the
entity.
-remarks: "\\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \\]\r\n\r\nLearn more about the types in this type alias through the following links. \r\n\r\n[Excel.EntityCompactLayout](/javascript/api/excel/excel.entitycompactlayout)"
+remarks: >-
+ \[ [API set: ExcelApi
+ 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ Learn more about the types in this type alias through the following links.
+
+
+ [Excel.EntityCompactLayout](/javascript/api/excel/excel.entitycompactlayout)
isPreview: false
isDeprecated: false
diff --git a/docs/docs-ref-autogen/excel_1_18/excel/excel.entitypropertytype.yml b/docs/docs-ref-autogen/excel_1_18/excel/excel.entitypropertytype.yml
index 41a8cc7fc..bc54a6eff 100644
--- a/docs/docs-ref-autogen/excel_1_18/excel/excel.entitypropertytype.yml
+++ b/docs/docs-ref-autogen/excel_1_18/excel/excel.entitypropertytype.yml
@@ -4,7 +4,16 @@ uid: excel!Excel.EntityPropertyType:type
package: excel!
fullName: Excel.EntityPropertyType
summary: Represents the value of a property.
-remarks: "\\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \\]\r\n\r\nLearn more about the types in this type alias through the following links. \r\n\r\n[Excel.CellValueAndPropertyMetadata](/javascript/api/excel/excel.cellvalueandpropertymetadata), [Excel.CellValue](/javascript/api/excel/excel.cellvalue)"
+remarks: >-
+ \[ [API set: ExcelApi
+ 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ Learn more about the types in this type alias through the following links.
+
+
+ [Excel.CellValueAndPropertyMetadata](/javascript/api/excel/excel.cellvalueandpropertymetadata),
+ [Excel.CellValue](/javascript/api/excel/excel.cellvalue)
isPreview: false
isDeprecated: false
diff --git a/docs/docs-ref-autogen/excel_1_18/excel/excel.errorcellvalue.yml b/docs/docs-ref-autogen/excel_1_18/excel/excel.errorcellvalue.yml
index e5addcc22..b88b1959c 100644
--- a/docs/docs-ref-autogen/excel_1_18/excel/excel.errorcellvalue.yml
+++ b/docs/docs-ref-autogen/excel_1_18/excel/excel.errorcellvalue.yml
@@ -4,7 +4,62 @@ uid: excel!Excel.ErrorCellValue:type
package: excel!
fullName: Excel.ErrorCellValue
summary: Represents a cell value which contains an error.
-remarks: "\\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \\]\n\n\r\n\r\nLearn more about the types in this type alias through the following links. \r\n\r\n[Excel.BlockedErrorCellValue](/javascript/api/excel/excel.blockederrorcellvalue), [Excel.BusyErrorCellValue](/javascript/api/excel/excel.busyerrorcellvalue), [Excel.CalcErrorCellValue](/javascript/api/excel/excel.calcerrorcellvalue), [Excel.ConnectErrorCellValue](/javascript/api/excel/excel.connecterrorcellvalue), [Excel.Div0ErrorCellValue](/javascript/api/excel/excel.div0errorcellvalue), [Excel.ExternalErrorCellValue](/javascript/api/excel/excel.externalerrorcellvalue), [Excel.FieldErrorCellValue](/javascript/api/excel/excel.fielderrorcellvalue), [Excel.GettingDataErrorCellValue](/javascript/api/excel/excel.gettingdataerrorcellvalue), [Excel.NotAvailableErrorCellValue](/javascript/api/excel/excel.notavailableerrorcellvalue), [Excel.NameErrorCellValue](/javascript/api/excel/excel.nameerrorcellvalue), [Excel.NullErrorCellValue](/javascript/api/excel/excel.nullerrorcellvalue), [Excel.NumErrorCellValue](/javascript/api/excel/excel.numerrorcellvalue), [Excel.PlaceholderErrorCellValue](/javascript/api/excel/excel.placeholdererrorcellvalue), [Excel.RefErrorCellValue](/javascript/api/excel/excel.referrorcellvalue), [Excel.SpillErrorCellValue](/javascript/api/excel/excel.spillerrorcellvalue), [Excel.ValueErrorCellValue](/javascript/api/excel/excel.valueerrorcellvalue)\r\n\r\n#### Examples\n\n```TypeScript\n// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/20-data-types/data-types-error-values.yaml\n\n// This function sets the value of cell A1 to a #BUSY! error using data types.\nawait Excel.run(async (context) => {\n // Retrieve the Sample worksheet and cell A1 on that sheet.\n const sheet = context.workbook.worksheets.getItemOrNullObject(\"Sample\");\n const range = sheet.getRange(\"A1\");\n\n // Get the error data type and set its type to `busy`.\n const error: Excel.ErrorCellValue = {\n type: Excel.CellValueType.error,\n errorType: Excel.ErrorCellValueType.busy\n };\n\n // Set cell A1 as the busy error.\n range.valuesAsJson = [[error]];\n await context.sync();\n});\n```"
+remarks: >-
+ \[ [API set: ExcelApi
+ 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+
+
+ Learn more about the types in this type alias through the following links.
+
+
+ [Excel.BlockedErrorCellValue](/javascript/api/excel/excel.blockederrorcellvalue),
+ [Excel.BusyErrorCellValue](/javascript/api/excel/excel.busyerrorcellvalue),
+ [Excel.CalcErrorCellValue](/javascript/api/excel/excel.calcerrorcellvalue),
+ [Excel.ConnectErrorCellValue](/javascript/api/excel/excel.connecterrorcellvalue),
+ [Excel.Div0ErrorCellValue](/javascript/api/excel/excel.div0errorcellvalue),
+ [Excel.ExternalErrorCellValue](/javascript/api/excel/excel.externalerrorcellvalue),
+ [Excel.FieldErrorCellValue](/javascript/api/excel/excel.fielderrorcellvalue),
+ [Excel.GettingDataErrorCellValue](/javascript/api/excel/excel.gettingdataerrorcellvalue),
+ [Excel.NotAvailableErrorCellValue](/javascript/api/excel/excel.notavailableerrorcellvalue),
+ [Excel.NameErrorCellValue](/javascript/api/excel/excel.nameerrorcellvalue),
+ [Excel.NullErrorCellValue](/javascript/api/excel/excel.nullerrorcellvalue),
+ [Excel.NumErrorCellValue](/javascript/api/excel/excel.numerrorcellvalue),
+ [Excel.PlaceholderErrorCellValue](/javascript/api/excel/excel.placeholdererrorcellvalue),
+ [Excel.RefErrorCellValue](/javascript/api/excel/excel.referrorcellvalue),
+ [Excel.SpillErrorCellValue](/javascript/api/excel/excel.spillerrorcellvalue),
+ [Excel.ValueErrorCellValue](/javascript/api/excel/excel.valueerrorcellvalue)
+
+
+ #### Examples
+
+
+ ```TypeScript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/20-data-types/data-types-error-values.yaml
+
+
+ // This function sets the value of cell A1 to a #BUSY! error using data types.
+
+ await Excel.run(async (context) => {
+ // Retrieve the Sample worksheet and cell A1 on that sheet.
+ const sheet = context.workbook.worksheets.getItemOrNullObject("Sample");
+ const range = sheet.getRange("A1");
+
+ // Get the error data type and set its type to `busy`.
+ const error: Excel.ErrorCellValue = {
+ type: Excel.CellValueType.error,
+ errorType: Excel.ErrorCellValueType.busy
+ };
+
+ // Set cell A1 as the busy error.
+ range.valuesAsJson = [[error]];
+ await context.sync();
+ });
+
+ ```
isPreview: false
isDeprecated: false
diff --git a/docs/docs-ref-autogen/excel_1_18/excel/excel.notavailableerrorcellvalue.yml b/docs/docs-ref-autogen/excel_1_18/excel/excel.notavailableerrorcellvalue.yml
index 408016466..0587e033a 100644
--- a/docs/docs-ref-autogen/excel_1_18/excel/excel.notavailableerrorcellvalue.yml
+++ b/docs/docs-ref-autogen/excel_1_18/excel/excel.notavailableerrorcellvalue.yml
@@ -3,7 +3,7 @@ name: Excel.NotAvailableErrorCellValue
uid: excel!Excel.NotAvailableErrorCellValue:interface
package: excel!
fullName: Excel.NotAvailableErrorCellValue
-summary: Represents the value of a cell containing a \#N/A! error.
+summary: Represents the value of a cell containing a \#N/A error.
remarks: >-
\[ [API set: ExcelApi
1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
@@ -48,9 +48,9 @@ properties:
isPreview: false
isDeprecated: false
syntax:
- content: 'basicValue?: "#N/A!" | string;'
+ content: 'basicValue?: "#N/A" | string;'
return:
- type: '"#N/A!" | string'
+ type: '"#N/A" | string'
- name: errorType
uid: excel!Excel.NotAvailableErrorCellValue#errorType:member
package: excel!
diff --git a/docs/docs-ref-autogen/excel_1_18/excel/excel.range.yml b/docs/docs-ref-autogen/excel_1_18/excel/excel.range.yml
index 0fdbd601d..3a50551fb 100644
--- a/docs/docs-ref-autogen/excel_1_18/excel/excel.range.yml
+++ b/docs/docs-ref-autogen/excel_1_18/excel/excel.range.yml
@@ -2087,7 +2087,8 @@ methods:
summary: >-
Returns a range object that includes the current range and up to the edge
of the range, based on the provided direction. This matches the
- Ctrl+Shift+Arrow key behavior in the Excel on Windows UI.
+ Ctrl+Shift+Arrow key behavior in the
+ Excel on Windows UI.
remarks: >-
\[ [API set: ExcelApi
1.13](/javascript/api/requirement-sets/excel/excel-api-requirement-sets)
@@ -2152,7 +2153,8 @@ methods:
summary: >-
Returns a range object that includes the current range and up to the edge
of the range, based on the provided direction. This matches the
- Ctrl+Shift+Arrow key behavior in the Excel on Windows UI.
+ Ctrl+Shift+Arrow key behavior in the
+ Excel on Windows UI.
remarks: >-
\[ [API set: ExcelApi
1.13](/javascript/api/requirement-sets/excel/excel-api-requirement-sets)
@@ -2668,8 +2670,8 @@ methods:
fullName: getRangeEdge(direction, activeCell)
summary: >-
Returns a range object that is the edge cell of the data region that
- corresponds to the provided direction. This matches the Ctrl+Arrow key
- behavior in the Excel on Windows UI.
+ corresponds to the provided direction. This matches the
+ Ctrl+Arrow key behavior in the Excel on Windows UI.
remarks: >-
\[ [API set: ExcelApi
1.13](/javascript/api/requirement-sets/excel/excel-api-requirement-sets)
@@ -2733,8 +2735,8 @@ methods:
fullName: getRangeEdge(direction, activeCell)
summary: >-
Returns a range object that is the edge cell of the data region that
- corresponds to the provided direction. This matches the Ctrl+Arrow key
- behavior in the Excel on Windows UI.
+ corresponds to the provided direction. This matches the
+ Ctrl+Arrow key behavior in the Excel on Windows UI.
remarks: >-
\[ [API set: ExcelApi
1.13](/javascript/api/requirement-sets/excel/excel-api-requirement-sets)
diff --git a/docs/docs-ref-autogen/excel_1_18/excel/excel.referencedvalue.yml b/docs/docs-ref-autogen/excel_1_18/excel/excel.referencedvalue.yml
index 57044e8eb..168b4928b 100644
--- a/docs/docs-ref-autogen/excel_1_18/excel/excel.referencedvalue.yml
+++ b/docs/docs-ref-autogen/excel_1_18/excel/excel.referencedvalue.yml
@@ -4,7 +4,20 @@ uid: excel!Excel.ReferencedValue:type
package: excel!
fullName: Excel.ReferencedValue
summary: Represents the value in a cell.
-remarks: "\\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \\]\r\n\r\nLearn more about the types in this type alias through the following links. \r\n\r\n[Excel.ArrayCellValue](/javascript/api/excel/excel.arraycellvalue), [Excel.EntityCellValue](/javascript/api/excel/excel.entitycellvalue), [Excel.RootReferenceCellValue](/javascript/api/excel/excel.rootreferencecellvalue), [Excel.DoubleCellValue](/javascript/api/excel/excel.doublecellvalue), [Excel.StringCellValue](/javascript/api/excel/excel.stringcellvalue), [Excel.BooleanCellValue](/javascript/api/excel/excel.booleancellvalue)"
+remarks: >-
+ \[ [API set: ExcelApi
+ 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ Learn more about the types in this type alias through the following links.
+
+
+ [Excel.ArrayCellValue](/javascript/api/excel/excel.arraycellvalue),
+ [Excel.EntityCellValue](/javascript/api/excel/excel.entitycellvalue),
+ [Excel.RootReferenceCellValue](/javascript/api/excel/excel.rootreferencecellvalue),
+ [Excel.DoubleCellValue](/javascript/api/excel/excel.doublecellvalue),
+ [Excel.StringCellValue](/javascript/api/excel/excel.stringcellvalue),
+ [Excel.BooleanCellValue](/javascript/api/excel/excel.booleancellvalue)
isPreview: false
isDeprecated: false
diff --git a/docs/docs-ref-autogen/excel_1_18/excel/excel.workbook.yml b/docs/docs-ref-autogen/excel_1_18/excel/excel.workbook.yml
index 877ed68f7..48669d8a8 100644
--- a/docs/docs-ref-autogen/excel_1_18/excel/excel.workbook.yml
+++ b/docs/docs-ref-autogen/excel_1_18/excel/excel.workbook.yml
@@ -892,17 +892,22 @@ methods:
fullName: insertWorksheetsFromBase64(base64File, options)
summary: >-
Inserts the specified worksheets from a source workbook into the current
- workbook.
-
-
- *Note**: This API is currently only supported for Office on Windows,
- Mac, and the web.
+ workbook. The `extensionHardening` Windows registry key affects this API.
+ The file extension defined by the `base64File` param must match the real
+ file type of the inserted file. If `extensionHardening` is set to deny
+ mismatches and the file extension does not match the real file type, this
+ API throws the following error: "This operation is not allowed due to the
+ extension hardening policy."
remarks: >-
\[ [API set: ExcelApi
1.13](/javascript/api/requirement-sets/excel/excel-api-requirement-sets)
\]
+ This API is currently only supported for Office on Windows, Mac, and the
+ web.
+
+
#### Examples
diff --git a/docs/docs-ref-autogen/excel_1_19/excel.yml b/docs/docs-ref-autogen/excel_1_19/excel.yml
index 5fc3db46e..1badd608a 100644
--- a/docs/docs-ref-autogen/excel_1_19/excel.yml
+++ b/docs/docs-ref-autogen/excel_1_19/excel.yml
@@ -1075,11 +1075,16 @@ functions:
package: excel!
summary: >-
Creates and opens a new workbook. Optionally, the workbook can be
- pre-populated with a Base64-encoded .xlsx file. Note: Macros can be a
- security risk. If this API is used to create a workbook that includes a
- macro, the add-in user will be prompted with a "Trust this add-in?" dialog
- in the Excel UI. The user must select the "Trust add-in" button to
- proceed.
+ pre-populated with a Base64-encoded .xlsx file. The `extensionHardening`
+ Windows registry key affects the `base64File` param. The file extension
+ defined by the param must match the real file type of the file. If
+ `extensionHardening` is set to deny mismatches and the file extension does
+ not match the real file type, this API throws the following error: "This
+ operation is not allowed due to the extension hardening policy." Note:
+ Macros can be a security risk. If this API is used to create a workbook
+ that includes a macro, the add-in user will be prompted with a "Trust this
+ add-in?" dialog in the Excel UI. The user must select the "Trust add-in"
+ button to proceed.
\[ [API set: ExcelApi
diff --git a/docs/docs-ref-autogen/excel_1_19/excel/excel.cardlayout.yml b/docs/docs-ref-autogen/excel_1_19/excel/excel.cardlayout.yml
index 4de2b1d60..07ebbc46e 100644
--- a/docs/docs-ref-autogen/excel_1_19/excel/excel.cardlayout.yml
+++ b/docs/docs-ref-autogen/excel_1_19/excel/excel.cardlayout.yml
@@ -4,7 +4,15 @@ uid: excel!Excel.CardLayout:type
package: excel!
fullName: Excel.CardLayout
summary: Represents the layout of a card in card view.
-remarks: "\\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \\]\r\n\r\nLearn more about the types in this type alias through the following links. \r\n\r\n[Excel.EntityCardLayout](/javascript/api/excel/excel.entitycardlayout)"
+remarks: >-
+ \[ [API set: ExcelApi
+ 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ Learn more about the types in this type alias through the following links.
+
+
+ [Excel.EntityCardLayout](/javascript/api/excel/excel.entitycardlayout)
isPreview: false
isDeprecated: false
diff --git a/docs/docs-ref-autogen/excel_1_19/excel/excel.cardlayoutsection.yml b/docs/docs-ref-autogen/excel_1_19/excel/excel.cardlayoutsection.yml
index 5491f6727..cca1b0c56 100644
--- a/docs/docs-ref-autogen/excel_1_19/excel/excel.cardlayoutsection.yml
+++ b/docs/docs-ref-autogen/excel_1_19/excel/excel.cardlayoutsection.yml
@@ -4,7 +4,17 @@ uid: excel!Excel.CardLayoutSection:type
package: excel!
fullName: Excel.CardLayoutSection
summary: Represents the layout of a section of a card in card view.
-remarks: "\\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \\]\r\n\r\nLearn more about the types in this type alias through the following links. \r\n\r\n[Excel.CardLayoutListSection](/javascript/api/excel/excel.cardlayoutlistsection), [Excel.CardLayoutTableSection](/javascript/api/excel/excel.cardlayouttablesection), [Excel.CardLayoutTwoColumnSection](/javascript/api/excel/excel.cardlayouttwocolumnsection)"
+remarks: >-
+ \[ [API set: ExcelApi
+ 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ Learn more about the types in this type alias through the following links.
+
+
+ [Excel.CardLayoutListSection](/javascript/api/excel/excel.cardlayoutlistsection),
+ [Excel.CardLayoutTableSection](/javascript/api/excel/excel.cardlayouttablesection),
+ [Excel.CardLayoutTwoColumnSection](/javascript/api/excel/excel.cardlayouttwocolumnsection)
isPreview: false
isDeprecated: false
diff --git a/docs/docs-ref-autogen/excel_1_19/excel/excel.cellcontrol.yml b/docs/docs-ref-autogen/excel_1_19/excel/excel.cellcontrol.yml
index ecd03dccf..5e5954d3d 100644
--- a/docs/docs-ref-autogen/excel_1_19/excel/excel.cellcontrol.yml
+++ b/docs/docs-ref-autogen/excel_1_19/excel/excel.cellcontrol.yml
@@ -4,7 +4,47 @@ uid: excel!Excel.CellControl:type
package: excel!
fullName: Excel.CellControl
summary: Represents an interactable control inside of a cell.
-remarks: "\\[ [API set: ExcelApi 1.18](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \\]\n\n\r\n\r\nLearn more about the types in this type alias through the following links. \r\n\r\n[Excel.UnknownCellControl](/javascript/api/excel/excel.unknowncellcontrol), [Excel.EmptyCellControl](/javascript/api/excel/excel.emptycellcontrol), [Excel.MixedCellControl](/javascript/api/excel/excel.mixedcellcontrol), [Excel.CheckboxCellControl](/javascript/api/excel/excel.checkboxcellcontrol)\r\n\r\n#### Examples\n\n```TypeScript\n// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/42-range/range-cell-control.yaml\n\n// Add checkboxes to the table.\nawait Excel.run(async (context) => {\n const sheet = context.workbook.worksheets.getActiveWorksheet();\n\n // Get the second column in the table, without the header.\n const range = sheet.tables.getItem(\"FruitTable\").columns.getItem(\"Analysis\").getDataBodyRange();\n\n // Change the boolean values to checkboxes.\n range.control = {\n type: Excel.CellControlType.checkbox\n };\n await context.sync();\n});\n```"
+remarks: >-
+ \[ [API set: ExcelApi
+ 1.18](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+
+
+ Learn more about the types in this type alias through the following links.
+
+
+ [Excel.UnknownCellControl](/javascript/api/excel/excel.unknowncellcontrol),
+ [Excel.EmptyCellControl](/javascript/api/excel/excel.emptycellcontrol),
+ [Excel.MixedCellControl](/javascript/api/excel/excel.mixedcellcontrol),
+ [Excel.CheckboxCellControl](/javascript/api/excel/excel.checkboxcellcontrol)
+
+
+ #### Examples
+
+
+ ```TypeScript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/42-range/range-cell-control.yaml
+
+
+ // Add checkboxes to the table.
+
+ await Excel.run(async (context) => {
+ const sheet = context.workbook.worksheets.getActiveWorksheet();
+
+ // Get the second column in the table, without the header.
+ const range = sheet.tables.getItem("FruitTable").columns.getItem("Analysis").getDataBodyRange();
+
+ // Change the boolean values to checkboxes.
+ range.control = {
+ type: Excel.CellControlType.checkbox
+ };
+ await context.sync();
+ });
+
+ ```
isPreview: false
isDeprecated: false
diff --git a/docs/docs-ref-autogen/excel_1_19/excel/excel.cellvalue.yml b/docs/docs-ref-autogen/excel_1_19/excel/excel.cellvalue.yml
index ef4aaccfd..4722937eb 100644
--- a/docs/docs-ref-autogen/excel_1_19/excel/excel.cellvalue.yml
+++ b/docs/docs-ref-autogen/excel_1_19/excel/excel.cellvalue.yml
@@ -4,7 +4,28 @@ uid: excel!Excel.CellValue:type
package: excel!
fullName: Excel.CellValue
summary: Represents the value in a cell.
-remarks: "\\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \\]\r\n\r\nLearn more about the types in this type alias through the following links. \r\n\r\n[Excel.ArrayCellValue](/javascript/api/excel/excel.arraycellvalue), [Excel.BooleanCellValue](/javascript/api/excel/excel.booleancellvalue), [Excel.DoubleCellValue](/javascript/api/excel/excel.doublecellvalue), [Excel.EntityCellValue](/javascript/api/excel/excel.entitycellvalue), [Excel.EmptyCellValue](/javascript/api/excel/excel.emptycellvalue), [Excel.ErrorCellValue](/javascript/api/excel/excel.errorcellvalue), [Excel.FormattedNumberCellValue](/javascript/api/excel/excel.formattednumbercellvalue), [Excel.FunctionCellValue](/javascript/api/excel/excel.functioncellvalue), [Excel.LinkedEntityCellValue](/javascript/api/excel/excel.linkedentitycellvalue), [Excel.ReferenceCellValue](/javascript/api/excel/excel.referencecellvalue), [Excel.StringCellValue](/javascript/api/excel/excel.stringcellvalue), [Excel.ValueTypeNotAvailableCellValue](/javascript/api/excel/excel.valuetypenotavailablecellvalue), [Excel.WebImageCellValue](/javascript/api/excel/excel.webimagecellvalue), [Excel.CellValueExtraProperties](/javascript/api/excel/excel.cellvalueextraproperties)"
+remarks: >-
+ \[ [API set: ExcelApi
+ 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ Learn more about the types in this type alias through the following links.
+
+
+ [Excel.ArrayCellValue](/javascript/api/excel/excel.arraycellvalue),
+ [Excel.BooleanCellValue](/javascript/api/excel/excel.booleancellvalue),
+ [Excel.DoubleCellValue](/javascript/api/excel/excel.doublecellvalue),
+ [Excel.EntityCellValue](/javascript/api/excel/excel.entitycellvalue),
+ [Excel.EmptyCellValue](/javascript/api/excel/excel.emptycellvalue),
+ [Excel.ErrorCellValue](/javascript/api/excel/excel.errorcellvalue),
+ [Excel.FormattedNumberCellValue](/javascript/api/excel/excel.formattednumbercellvalue),
+ [Excel.FunctionCellValue](/javascript/api/excel/excel.functioncellvalue),
+ [Excel.LinkedEntityCellValue](/javascript/api/excel/excel.linkedentitycellvalue),
+ [Excel.ReferenceCellValue](/javascript/api/excel/excel.referencecellvalue),
+ [Excel.StringCellValue](/javascript/api/excel/excel.stringcellvalue),
+ [Excel.ValueTypeNotAvailableCellValue](/javascript/api/excel/excel.valuetypenotavailablecellvalue),
+ [Excel.WebImageCellValue](/javascript/api/excel/excel.webimagecellvalue),
+ [Excel.CellValueExtraProperties](/javascript/api/excel/excel.cellvalueextraproperties)
isPreview: false
isDeprecated: false
diff --git a/docs/docs-ref-autogen/excel_1_19/excel/excel.cellvalueandpropertymetadata.yml b/docs/docs-ref-autogen/excel_1_19/excel/excel.cellvalueandpropertymetadata.yml
index 566432a91..5f661bb32 100644
--- a/docs/docs-ref-autogen/excel_1_19/excel/excel.cellvalueandpropertymetadata.yml
+++ b/docs/docs-ref-autogen/excel_1_19/excel/excel.cellvalueandpropertymetadata.yml
@@ -6,7 +6,16 @@ fullName: Excel.CellValueAndPropertyMetadata
summary: >-
Represents the value and metadata of a property. The metadata applies to the
property (and not the value), but it is combined with the value in this type.
-remarks: "\\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \\]\r\n\r\nLearn more about the types in this type alias through the following links. \r\n\r\n[Excel.CellValue](/javascript/api/excel/excel.cellvalue), [Excel.EntityPropertyExtraProperties](/javascript/api/excel/excel.entitypropertyextraproperties)"
+remarks: >-
+ \[ [API set: ExcelApi
+ 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ Learn more about the types in this type alias through the following links.
+
+
+ [Excel.CellValue](/javascript/api/excel/excel.cellvalue),
+ [Excel.EntityPropertyExtraProperties](/javascript/api/excel/excel.entitypropertyextraproperties)
isPreview: false
isDeprecated: false
diff --git a/docs/docs-ref-autogen/excel_1_19/excel/excel.compactlayout.yml b/docs/docs-ref-autogen/excel_1_19/excel/excel.compactlayout.yml
index 3f2549677..5bb689c66 100644
--- a/docs/docs-ref-autogen/excel_1_19/excel/excel.compactlayout.yml
+++ b/docs/docs-ref-autogen/excel_1_19/excel/excel.compactlayout.yml
@@ -6,7 +6,15 @@ fullName: Excel.CompactLayout
summary: >-
Represents the layout used when there is limited space to represent the
entity.
-remarks: "\\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \\]\r\n\r\nLearn more about the types in this type alias through the following links. \r\n\r\n[Excel.EntityCompactLayout](/javascript/api/excel/excel.entitycompactlayout)"
+remarks: >-
+ \[ [API set: ExcelApi
+ 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ Learn more about the types in this type alias through the following links.
+
+
+ [Excel.EntityCompactLayout](/javascript/api/excel/excel.entitycompactlayout)
isPreview: false
isDeprecated: false
diff --git a/docs/docs-ref-autogen/excel_1_19/excel/excel.entitypropertytype.yml b/docs/docs-ref-autogen/excel_1_19/excel/excel.entitypropertytype.yml
index 41a8cc7fc..bc54a6eff 100644
--- a/docs/docs-ref-autogen/excel_1_19/excel/excel.entitypropertytype.yml
+++ b/docs/docs-ref-autogen/excel_1_19/excel/excel.entitypropertytype.yml
@@ -4,7 +4,16 @@ uid: excel!Excel.EntityPropertyType:type
package: excel!
fullName: Excel.EntityPropertyType
summary: Represents the value of a property.
-remarks: "\\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \\]\r\n\r\nLearn more about the types in this type alias through the following links. \r\n\r\n[Excel.CellValueAndPropertyMetadata](/javascript/api/excel/excel.cellvalueandpropertymetadata), [Excel.CellValue](/javascript/api/excel/excel.cellvalue)"
+remarks: >-
+ \[ [API set: ExcelApi
+ 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ Learn more about the types in this type alias through the following links.
+
+
+ [Excel.CellValueAndPropertyMetadata](/javascript/api/excel/excel.cellvalueandpropertymetadata),
+ [Excel.CellValue](/javascript/api/excel/excel.cellvalue)
isPreview: false
isDeprecated: false
diff --git a/docs/docs-ref-autogen/excel_1_19/excel/excel.errorcellvalue.yml b/docs/docs-ref-autogen/excel_1_19/excel/excel.errorcellvalue.yml
index e5addcc22..b88b1959c 100644
--- a/docs/docs-ref-autogen/excel_1_19/excel/excel.errorcellvalue.yml
+++ b/docs/docs-ref-autogen/excel_1_19/excel/excel.errorcellvalue.yml
@@ -4,7 +4,62 @@ uid: excel!Excel.ErrorCellValue:type
package: excel!
fullName: Excel.ErrorCellValue
summary: Represents a cell value which contains an error.
-remarks: "\\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \\]\n\n\r\n\r\nLearn more about the types in this type alias through the following links. \r\n\r\n[Excel.BlockedErrorCellValue](/javascript/api/excel/excel.blockederrorcellvalue), [Excel.BusyErrorCellValue](/javascript/api/excel/excel.busyerrorcellvalue), [Excel.CalcErrorCellValue](/javascript/api/excel/excel.calcerrorcellvalue), [Excel.ConnectErrorCellValue](/javascript/api/excel/excel.connecterrorcellvalue), [Excel.Div0ErrorCellValue](/javascript/api/excel/excel.div0errorcellvalue), [Excel.ExternalErrorCellValue](/javascript/api/excel/excel.externalerrorcellvalue), [Excel.FieldErrorCellValue](/javascript/api/excel/excel.fielderrorcellvalue), [Excel.GettingDataErrorCellValue](/javascript/api/excel/excel.gettingdataerrorcellvalue), [Excel.NotAvailableErrorCellValue](/javascript/api/excel/excel.notavailableerrorcellvalue), [Excel.NameErrorCellValue](/javascript/api/excel/excel.nameerrorcellvalue), [Excel.NullErrorCellValue](/javascript/api/excel/excel.nullerrorcellvalue), [Excel.NumErrorCellValue](/javascript/api/excel/excel.numerrorcellvalue), [Excel.PlaceholderErrorCellValue](/javascript/api/excel/excel.placeholdererrorcellvalue), [Excel.RefErrorCellValue](/javascript/api/excel/excel.referrorcellvalue), [Excel.SpillErrorCellValue](/javascript/api/excel/excel.spillerrorcellvalue), [Excel.ValueErrorCellValue](/javascript/api/excel/excel.valueerrorcellvalue)\r\n\r\n#### Examples\n\n```TypeScript\n// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/20-data-types/data-types-error-values.yaml\n\n// This function sets the value of cell A1 to a #BUSY! error using data types.\nawait Excel.run(async (context) => {\n // Retrieve the Sample worksheet and cell A1 on that sheet.\n const sheet = context.workbook.worksheets.getItemOrNullObject(\"Sample\");\n const range = sheet.getRange(\"A1\");\n\n // Get the error data type and set its type to `busy`.\n const error: Excel.ErrorCellValue = {\n type: Excel.CellValueType.error,\n errorType: Excel.ErrorCellValueType.busy\n };\n\n // Set cell A1 as the busy error.\n range.valuesAsJson = [[error]];\n await context.sync();\n});\n```"
+remarks: >-
+ \[ [API set: ExcelApi
+ 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+
+
+ Learn more about the types in this type alias through the following links.
+
+
+ [Excel.BlockedErrorCellValue](/javascript/api/excel/excel.blockederrorcellvalue),
+ [Excel.BusyErrorCellValue](/javascript/api/excel/excel.busyerrorcellvalue),
+ [Excel.CalcErrorCellValue](/javascript/api/excel/excel.calcerrorcellvalue),
+ [Excel.ConnectErrorCellValue](/javascript/api/excel/excel.connecterrorcellvalue),
+ [Excel.Div0ErrorCellValue](/javascript/api/excel/excel.div0errorcellvalue),
+ [Excel.ExternalErrorCellValue](/javascript/api/excel/excel.externalerrorcellvalue),
+ [Excel.FieldErrorCellValue](/javascript/api/excel/excel.fielderrorcellvalue),
+ [Excel.GettingDataErrorCellValue](/javascript/api/excel/excel.gettingdataerrorcellvalue),
+ [Excel.NotAvailableErrorCellValue](/javascript/api/excel/excel.notavailableerrorcellvalue),
+ [Excel.NameErrorCellValue](/javascript/api/excel/excel.nameerrorcellvalue),
+ [Excel.NullErrorCellValue](/javascript/api/excel/excel.nullerrorcellvalue),
+ [Excel.NumErrorCellValue](/javascript/api/excel/excel.numerrorcellvalue),
+ [Excel.PlaceholderErrorCellValue](/javascript/api/excel/excel.placeholdererrorcellvalue),
+ [Excel.RefErrorCellValue](/javascript/api/excel/excel.referrorcellvalue),
+ [Excel.SpillErrorCellValue](/javascript/api/excel/excel.spillerrorcellvalue),
+ [Excel.ValueErrorCellValue](/javascript/api/excel/excel.valueerrorcellvalue)
+
+
+ #### Examples
+
+
+ ```TypeScript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/20-data-types/data-types-error-values.yaml
+
+
+ // This function sets the value of cell A1 to a #BUSY! error using data types.
+
+ await Excel.run(async (context) => {
+ // Retrieve the Sample worksheet and cell A1 on that sheet.
+ const sheet = context.workbook.worksheets.getItemOrNullObject("Sample");
+ const range = sheet.getRange("A1");
+
+ // Get the error data type and set its type to `busy`.
+ const error: Excel.ErrorCellValue = {
+ type: Excel.CellValueType.error,
+ errorType: Excel.ErrorCellValueType.busy
+ };
+
+ // Set cell A1 as the busy error.
+ range.valuesAsJson = [[error]];
+ await context.sync();
+ });
+
+ ```
isPreview: false
isDeprecated: false
diff --git a/docs/docs-ref-autogen/excel_1_19/excel/excel.functioncellvalue.yml b/docs/docs-ref-autogen/excel_1_19/excel/excel.functioncellvalue.yml
index 50b723960..b1f83d2ff 100644
--- a/docs/docs-ref-autogen/excel_1_19/excel/excel.functioncellvalue.yml
+++ b/docs/docs-ref-autogen/excel_1_19/excel/excel.functioncellvalue.yml
@@ -4,7 +4,15 @@ uid: excel!Excel.FunctionCellValue:type
package: excel!
fullName: Excel.FunctionCellValue
summary: Represents a cell value which can be evaluated as a function.
-remarks: "\\[ [API set: ExcelApi 1.19](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \\]\r\n\r\nLearn more about the types in this type alias through the following links. \r\n\r\n[Excel.JavaScriptCustomFunctionReferenceCellValue](/javascript/api/excel/excel.javascriptcustomfunctionreferencecellvalue)"
+remarks: >-
+ \[ [API set: ExcelApi
+ 1.19](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ Learn more about the types in this type alias through the following links.
+
+
+ [Excel.JavaScriptCustomFunctionReferenceCellValue](/javascript/api/excel/excel.javascriptcustomfunctionreferencecellvalue)
isPreview: false
isDeprecated: false
diff --git a/docs/docs-ref-autogen/excel_1_19/excel/excel.notavailableerrorcellvalue.yml b/docs/docs-ref-autogen/excel_1_19/excel/excel.notavailableerrorcellvalue.yml
index 408016466..0587e033a 100644
--- a/docs/docs-ref-autogen/excel_1_19/excel/excel.notavailableerrorcellvalue.yml
+++ b/docs/docs-ref-autogen/excel_1_19/excel/excel.notavailableerrorcellvalue.yml
@@ -3,7 +3,7 @@ name: Excel.NotAvailableErrorCellValue
uid: excel!Excel.NotAvailableErrorCellValue:interface
package: excel!
fullName: Excel.NotAvailableErrorCellValue
-summary: Represents the value of a cell containing a \#N/A! error.
+summary: Represents the value of a cell containing a \#N/A error.
remarks: >-
\[ [API set: ExcelApi
1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
@@ -48,9 +48,9 @@ properties:
isPreview: false
isDeprecated: false
syntax:
- content: 'basicValue?: "#N/A!" | string;'
+ content: 'basicValue?: "#N/A" | string;'
return:
- type: '"#N/A!" | string'
+ type: '"#N/A" | string'
- name: errorType
uid: excel!Excel.NotAvailableErrorCellValue#errorType:member
package: excel!
diff --git a/docs/docs-ref-autogen/excel_1_19/excel/excel.range.yml b/docs/docs-ref-autogen/excel_1_19/excel/excel.range.yml
index 1accde8c5..1fa17eceb 100644
--- a/docs/docs-ref-autogen/excel_1_19/excel/excel.range.yml
+++ b/docs/docs-ref-autogen/excel_1_19/excel/excel.range.yml
@@ -2120,7 +2120,8 @@ methods:
summary: >-
Returns a range object that includes the current range and up to the edge
of the range, based on the provided direction. This matches the
- Ctrl+Shift+Arrow key behavior in the Excel on Windows UI.
+ Ctrl+Shift+Arrow key behavior in the
+ Excel on Windows UI.
remarks: >-
\[ [API set: ExcelApi
1.13](/javascript/api/requirement-sets/excel/excel-api-requirement-sets)
@@ -2185,7 +2186,8 @@ methods:
summary: >-
Returns a range object that includes the current range and up to the edge
of the range, based on the provided direction. This matches the
- Ctrl+Shift+Arrow key behavior in the Excel on Windows UI.
+ Ctrl+Shift+Arrow key behavior in the
+ Excel on Windows UI.
remarks: >-
\[ [API set: ExcelApi
1.13](/javascript/api/requirement-sets/excel/excel-api-requirement-sets)
@@ -2701,8 +2703,8 @@ methods:
fullName: getRangeEdge(direction, activeCell)
summary: >-
Returns a range object that is the edge cell of the data region that
- corresponds to the provided direction. This matches the Ctrl+Arrow key
- behavior in the Excel on Windows UI.
+ corresponds to the provided direction. This matches the
+ Ctrl+Arrow key behavior in the Excel on Windows UI.
remarks: >-
\[ [API set: ExcelApi
1.13](/javascript/api/requirement-sets/excel/excel-api-requirement-sets)
@@ -2766,8 +2768,8 @@ methods:
fullName: getRangeEdge(direction, activeCell)
summary: >-
Returns a range object that is the edge cell of the data region that
- corresponds to the provided direction. This matches the Ctrl+Arrow key
- behavior in the Excel on Windows UI.
+ corresponds to the provided direction. This matches the
+ Ctrl+Arrow key behavior in the Excel on Windows UI.
remarks: >-
\[ [API set: ExcelApi
1.13](/javascript/api/requirement-sets/excel/excel-api-requirement-sets)
diff --git a/docs/docs-ref-autogen/excel_1_19/excel/excel.referencedvalue.yml b/docs/docs-ref-autogen/excel_1_19/excel/excel.referencedvalue.yml
index 57044e8eb..168b4928b 100644
--- a/docs/docs-ref-autogen/excel_1_19/excel/excel.referencedvalue.yml
+++ b/docs/docs-ref-autogen/excel_1_19/excel/excel.referencedvalue.yml
@@ -4,7 +4,20 @@ uid: excel!Excel.ReferencedValue:type
package: excel!
fullName: Excel.ReferencedValue
summary: Represents the value in a cell.
-remarks: "\\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \\]\r\n\r\nLearn more about the types in this type alias through the following links. \r\n\r\n[Excel.ArrayCellValue](/javascript/api/excel/excel.arraycellvalue), [Excel.EntityCellValue](/javascript/api/excel/excel.entitycellvalue), [Excel.RootReferenceCellValue](/javascript/api/excel/excel.rootreferencecellvalue), [Excel.DoubleCellValue](/javascript/api/excel/excel.doublecellvalue), [Excel.StringCellValue](/javascript/api/excel/excel.stringcellvalue), [Excel.BooleanCellValue](/javascript/api/excel/excel.booleancellvalue)"
+remarks: >-
+ \[ [API set: ExcelApi
+ 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ Learn more about the types in this type alias through the following links.
+
+
+ [Excel.ArrayCellValue](/javascript/api/excel/excel.arraycellvalue),
+ [Excel.EntityCellValue](/javascript/api/excel/excel.entitycellvalue),
+ [Excel.RootReferenceCellValue](/javascript/api/excel/excel.rootreferencecellvalue),
+ [Excel.DoubleCellValue](/javascript/api/excel/excel.doublecellvalue),
+ [Excel.StringCellValue](/javascript/api/excel/excel.stringcellvalue),
+ [Excel.BooleanCellValue](/javascript/api/excel/excel.booleancellvalue)
isPreview: false
isDeprecated: false
diff --git a/docs/docs-ref-autogen/excel_1_19/excel/excel.workbook.yml b/docs/docs-ref-autogen/excel_1_19/excel/excel.workbook.yml
index 622265085..bc73fc30d 100644
--- a/docs/docs-ref-autogen/excel_1_19/excel/excel.workbook.yml
+++ b/docs/docs-ref-autogen/excel_1_19/excel/excel.workbook.yml
@@ -988,17 +988,22 @@ methods:
fullName: insertWorksheetsFromBase64(base64File, options)
summary: >-
Inserts the specified worksheets from a source workbook into the current
- workbook.
-
-
- *Note**: This API is currently only supported for Office on Windows,
- Mac, and the web.
+ workbook. The `extensionHardening` Windows registry key affects this API.
+ The file extension defined by the `base64File` param must match the real
+ file type of the inserted file. If `extensionHardening` is set to deny
+ mismatches and the file extension does not match the real file type, this
+ API throws the following error: "This operation is not allowed due to the
+ extension hardening policy."
remarks: >-
\[ [API set: ExcelApi
1.13](/javascript/api/requirement-sets/excel/excel-api-requirement-sets)
\]
+ This API is currently only supported for Office on Windows, Mac, and the
+ web.
+
+
#### Examples
diff --git a/docs/docs-ref-autogen/excel_1_8/excel.yml b/docs/docs-ref-autogen/excel_1_8/excel.yml
index e59f62706..bad520f77 100644
--- a/docs/docs-ref-autogen/excel_1_8/excel.yml
+++ b/docs/docs-ref-autogen/excel_1_8/excel.yml
@@ -733,11 +733,16 @@ functions:
package: excel!
summary: >-
Creates and opens a new workbook. Optionally, the workbook can be
- pre-populated with a Base64-encoded .xlsx file. Note: Macros can be a
- security risk. If this API is used to create a workbook that includes a
- macro, the add-in user will be prompted with a "Trust this add-in?" dialog
- in the Excel UI. The user must select the "Trust add-in" button to
- proceed.
+ pre-populated with a Base64-encoded .xlsx file. The `extensionHardening`
+ Windows registry key affects the `base64File` param. The file extension
+ defined by the param must match the real file type of the file. If
+ `extensionHardening` is set to deny mismatches and the file extension does
+ not match the real file type, this API throws the following error: "This
+ operation is not allowed due to the extension hardening policy." Note:
+ Macros can be a security risk. If this API is used to create a workbook
+ that includes a macro, the add-in user will be prompted with a "Trust this
+ add-in?" dialog in the Excel UI. The user must select the "Trust add-in"
+ button to proceed.
\[ [API set: ExcelApi
diff --git a/docs/docs-ref-autogen/excel_1_9/excel.yml b/docs/docs-ref-autogen/excel_1_9/excel.yml
index c1d148c4b..78da41ef4 100644
--- a/docs/docs-ref-autogen/excel_1_9/excel.yml
+++ b/docs/docs-ref-autogen/excel_1_9/excel.yml
@@ -873,11 +873,16 @@ functions:
package: excel!
summary: >-
Creates and opens a new workbook. Optionally, the workbook can be
- pre-populated with a Base64-encoded .xlsx file. Note: Macros can be a
- security risk. If this API is used to create a workbook that includes a
- macro, the add-in user will be prompted with a "Trust this add-in?" dialog
- in the Excel UI. The user must select the "Trust add-in" button to
- proceed.
+ pre-populated with a Base64-encoded .xlsx file. The `extensionHardening`
+ Windows registry key affects the `base64File` param. The file extension
+ defined by the param must match the real file type of the file. If
+ `extensionHardening` is set to deny mismatches and the file extension does
+ not match the real file type, this API throws the following error: "This
+ operation is not allowed due to the extension hardening policy." Note:
+ Macros can be a security risk. If this API is used to create a workbook
+ that includes a macro, the add-in user will be prompted with a "Trust this
+ add-in?" dialog in the Excel UI. The user must select the "Trust add-in"
+ button to proceed.
\[ [API set: ExcelApi
diff --git a/docs/docs-ref-autogen/excel_online/excel.yml b/docs/docs-ref-autogen/excel_online/excel.yml
index e26f35241..e4bce20e9 100644
--- a/docs/docs-ref-autogen/excel_online/excel.yml
+++ b/docs/docs-ref-autogen/excel_online/excel.yml
@@ -1089,11 +1089,16 @@ functions:
package: excel!
summary: >-
Creates and opens a new workbook. Optionally, the workbook can be
- pre-populated with a Base64-encoded .xlsx file. Note: Macros can be a
- security risk. If this API is used to create a workbook that includes a
- macro, the add-in user will be prompted with a "Trust this add-in?" dialog
- in the Excel UI. The user must select the "Trust add-in" button to
- proceed.
+ pre-populated with a Base64-encoded .xlsx file. The `extensionHardening`
+ Windows registry key affects the `base64File` param. The file extension
+ defined by the param must match the real file type of the file. If
+ `extensionHardening` is set to deny mismatches and the file extension does
+ not match the real file type, this API throws the following error: "This
+ operation is not allowed due to the extension hardening policy." Note:
+ Macros can be a security risk. If this API is used to create a workbook
+ that includes a macro, the add-in user will be prompted with a "Trust this
+ add-in?" dialog in the Excel UI. The user must select the "Trust add-in"
+ button to proceed.
\[ [API set: ExcelApi
diff --git a/docs/docs-ref-autogen/excel_online/excel/excel.cardlayout.yml b/docs/docs-ref-autogen/excel_online/excel/excel.cardlayout.yml
index 4de2b1d60..07ebbc46e 100644
--- a/docs/docs-ref-autogen/excel_online/excel/excel.cardlayout.yml
+++ b/docs/docs-ref-autogen/excel_online/excel/excel.cardlayout.yml
@@ -4,7 +4,15 @@ uid: excel!Excel.CardLayout:type
package: excel!
fullName: Excel.CardLayout
summary: Represents the layout of a card in card view.
-remarks: "\\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \\]\r\n\r\nLearn more about the types in this type alias through the following links. \r\n\r\n[Excel.EntityCardLayout](/javascript/api/excel/excel.entitycardlayout)"
+remarks: >-
+ \[ [API set: ExcelApi
+ 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ Learn more about the types in this type alias through the following links.
+
+
+ [Excel.EntityCardLayout](/javascript/api/excel/excel.entitycardlayout)
isPreview: false
isDeprecated: false
diff --git a/docs/docs-ref-autogen/excel_online/excel/excel.cardlayoutsection.yml b/docs/docs-ref-autogen/excel_online/excel/excel.cardlayoutsection.yml
index 5491f6727..cca1b0c56 100644
--- a/docs/docs-ref-autogen/excel_online/excel/excel.cardlayoutsection.yml
+++ b/docs/docs-ref-autogen/excel_online/excel/excel.cardlayoutsection.yml
@@ -4,7 +4,17 @@ uid: excel!Excel.CardLayoutSection:type
package: excel!
fullName: Excel.CardLayoutSection
summary: Represents the layout of a section of a card in card view.
-remarks: "\\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \\]\r\n\r\nLearn more about the types in this type alias through the following links. \r\n\r\n[Excel.CardLayoutListSection](/javascript/api/excel/excel.cardlayoutlistsection), [Excel.CardLayoutTableSection](/javascript/api/excel/excel.cardlayouttablesection), [Excel.CardLayoutTwoColumnSection](/javascript/api/excel/excel.cardlayouttwocolumnsection)"
+remarks: >-
+ \[ [API set: ExcelApi
+ 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ Learn more about the types in this type alias through the following links.
+
+
+ [Excel.CardLayoutListSection](/javascript/api/excel/excel.cardlayoutlistsection),
+ [Excel.CardLayoutTableSection](/javascript/api/excel/excel.cardlayouttablesection),
+ [Excel.CardLayoutTwoColumnSection](/javascript/api/excel/excel.cardlayouttwocolumnsection)
isPreview: false
isDeprecated: false
diff --git a/docs/docs-ref-autogen/excel_online/excel/excel.cellcontrol.yml b/docs/docs-ref-autogen/excel_online/excel/excel.cellcontrol.yml
index ecd03dccf..5e5954d3d 100644
--- a/docs/docs-ref-autogen/excel_online/excel/excel.cellcontrol.yml
+++ b/docs/docs-ref-autogen/excel_online/excel/excel.cellcontrol.yml
@@ -4,7 +4,47 @@ uid: excel!Excel.CellControl:type
package: excel!
fullName: Excel.CellControl
summary: Represents an interactable control inside of a cell.
-remarks: "\\[ [API set: ExcelApi 1.18](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \\]\n\n\r\n\r\nLearn more about the types in this type alias through the following links. \r\n\r\n[Excel.UnknownCellControl](/javascript/api/excel/excel.unknowncellcontrol), [Excel.EmptyCellControl](/javascript/api/excel/excel.emptycellcontrol), [Excel.MixedCellControl](/javascript/api/excel/excel.mixedcellcontrol), [Excel.CheckboxCellControl](/javascript/api/excel/excel.checkboxcellcontrol)\r\n\r\n#### Examples\n\n```TypeScript\n// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/42-range/range-cell-control.yaml\n\n// Add checkboxes to the table.\nawait Excel.run(async (context) => {\n const sheet = context.workbook.worksheets.getActiveWorksheet();\n\n // Get the second column in the table, without the header.\n const range = sheet.tables.getItem(\"FruitTable\").columns.getItem(\"Analysis\").getDataBodyRange();\n\n // Change the boolean values to checkboxes.\n range.control = {\n type: Excel.CellControlType.checkbox\n };\n await context.sync();\n});\n```"
+remarks: >-
+ \[ [API set: ExcelApi
+ 1.18](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+
+
+ Learn more about the types in this type alias through the following links.
+
+
+ [Excel.UnknownCellControl](/javascript/api/excel/excel.unknowncellcontrol),
+ [Excel.EmptyCellControl](/javascript/api/excel/excel.emptycellcontrol),
+ [Excel.MixedCellControl](/javascript/api/excel/excel.mixedcellcontrol),
+ [Excel.CheckboxCellControl](/javascript/api/excel/excel.checkboxcellcontrol)
+
+
+ #### Examples
+
+
+ ```TypeScript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/42-range/range-cell-control.yaml
+
+
+ // Add checkboxes to the table.
+
+ await Excel.run(async (context) => {
+ const sheet = context.workbook.worksheets.getActiveWorksheet();
+
+ // Get the second column in the table, without the header.
+ const range = sheet.tables.getItem("FruitTable").columns.getItem("Analysis").getDataBodyRange();
+
+ // Change the boolean values to checkboxes.
+ range.control = {
+ type: Excel.CellControlType.checkbox
+ };
+ await context.sync();
+ });
+
+ ```
isPreview: false
isDeprecated: false
diff --git a/docs/docs-ref-autogen/excel_online/excel/excel.cellvalue.yml b/docs/docs-ref-autogen/excel_online/excel/excel.cellvalue.yml
index ef4aaccfd..4722937eb 100644
--- a/docs/docs-ref-autogen/excel_online/excel/excel.cellvalue.yml
+++ b/docs/docs-ref-autogen/excel_online/excel/excel.cellvalue.yml
@@ -4,7 +4,28 @@ uid: excel!Excel.CellValue:type
package: excel!
fullName: Excel.CellValue
summary: Represents the value in a cell.
-remarks: "\\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \\]\r\n\r\nLearn more about the types in this type alias through the following links. \r\n\r\n[Excel.ArrayCellValue](/javascript/api/excel/excel.arraycellvalue), [Excel.BooleanCellValue](/javascript/api/excel/excel.booleancellvalue), [Excel.DoubleCellValue](/javascript/api/excel/excel.doublecellvalue), [Excel.EntityCellValue](/javascript/api/excel/excel.entitycellvalue), [Excel.EmptyCellValue](/javascript/api/excel/excel.emptycellvalue), [Excel.ErrorCellValue](/javascript/api/excel/excel.errorcellvalue), [Excel.FormattedNumberCellValue](/javascript/api/excel/excel.formattednumbercellvalue), [Excel.FunctionCellValue](/javascript/api/excel/excel.functioncellvalue), [Excel.LinkedEntityCellValue](/javascript/api/excel/excel.linkedentitycellvalue), [Excel.ReferenceCellValue](/javascript/api/excel/excel.referencecellvalue), [Excel.StringCellValue](/javascript/api/excel/excel.stringcellvalue), [Excel.ValueTypeNotAvailableCellValue](/javascript/api/excel/excel.valuetypenotavailablecellvalue), [Excel.WebImageCellValue](/javascript/api/excel/excel.webimagecellvalue), [Excel.CellValueExtraProperties](/javascript/api/excel/excel.cellvalueextraproperties)"
+remarks: >-
+ \[ [API set: ExcelApi
+ 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ Learn more about the types in this type alias through the following links.
+
+
+ [Excel.ArrayCellValue](/javascript/api/excel/excel.arraycellvalue),
+ [Excel.BooleanCellValue](/javascript/api/excel/excel.booleancellvalue),
+ [Excel.DoubleCellValue](/javascript/api/excel/excel.doublecellvalue),
+ [Excel.EntityCellValue](/javascript/api/excel/excel.entitycellvalue),
+ [Excel.EmptyCellValue](/javascript/api/excel/excel.emptycellvalue),
+ [Excel.ErrorCellValue](/javascript/api/excel/excel.errorcellvalue),
+ [Excel.FormattedNumberCellValue](/javascript/api/excel/excel.formattednumbercellvalue),
+ [Excel.FunctionCellValue](/javascript/api/excel/excel.functioncellvalue),
+ [Excel.LinkedEntityCellValue](/javascript/api/excel/excel.linkedentitycellvalue),
+ [Excel.ReferenceCellValue](/javascript/api/excel/excel.referencecellvalue),
+ [Excel.StringCellValue](/javascript/api/excel/excel.stringcellvalue),
+ [Excel.ValueTypeNotAvailableCellValue](/javascript/api/excel/excel.valuetypenotavailablecellvalue),
+ [Excel.WebImageCellValue](/javascript/api/excel/excel.webimagecellvalue),
+ [Excel.CellValueExtraProperties](/javascript/api/excel/excel.cellvalueextraproperties)
isPreview: false
isDeprecated: false
diff --git a/docs/docs-ref-autogen/excel_online/excel/excel.cellvalueandpropertymetadata.yml b/docs/docs-ref-autogen/excel_online/excel/excel.cellvalueandpropertymetadata.yml
index 566432a91..5f661bb32 100644
--- a/docs/docs-ref-autogen/excel_online/excel/excel.cellvalueandpropertymetadata.yml
+++ b/docs/docs-ref-autogen/excel_online/excel/excel.cellvalueandpropertymetadata.yml
@@ -6,7 +6,16 @@ fullName: Excel.CellValueAndPropertyMetadata
summary: >-
Represents the value and metadata of a property. The metadata applies to the
property (and not the value), but it is combined with the value in this type.
-remarks: "\\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \\]\r\n\r\nLearn more about the types in this type alias through the following links. \r\n\r\n[Excel.CellValue](/javascript/api/excel/excel.cellvalue), [Excel.EntityPropertyExtraProperties](/javascript/api/excel/excel.entitypropertyextraproperties)"
+remarks: >-
+ \[ [API set: ExcelApi
+ 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ Learn more about the types in this type alias through the following links.
+
+
+ [Excel.CellValue](/javascript/api/excel/excel.cellvalue),
+ [Excel.EntityPropertyExtraProperties](/javascript/api/excel/excel.entitypropertyextraproperties)
isPreview: false
isDeprecated: false
diff --git a/docs/docs-ref-autogen/excel_online/excel/excel.compactlayout.yml b/docs/docs-ref-autogen/excel_online/excel/excel.compactlayout.yml
index 3f2549677..5bb689c66 100644
--- a/docs/docs-ref-autogen/excel_online/excel/excel.compactlayout.yml
+++ b/docs/docs-ref-autogen/excel_online/excel/excel.compactlayout.yml
@@ -6,7 +6,15 @@ fullName: Excel.CompactLayout
summary: >-
Represents the layout used when there is limited space to represent the
entity.
-remarks: "\\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \\]\r\n\r\nLearn more about the types in this type alias through the following links. \r\n\r\n[Excel.EntityCompactLayout](/javascript/api/excel/excel.entitycompactlayout)"
+remarks: >-
+ \[ [API set: ExcelApi
+ 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ Learn more about the types in this type alias through the following links.
+
+
+ [Excel.EntityCompactLayout](/javascript/api/excel/excel.entitycompactlayout)
isPreview: false
isDeprecated: false
diff --git a/docs/docs-ref-autogen/excel_online/excel/excel.entitypropertytype.yml b/docs/docs-ref-autogen/excel_online/excel/excel.entitypropertytype.yml
index 41a8cc7fc..bc54a6eff 100644
--- a/docs/docs-ref-autogen/excel_online/excel/excel.entitypropertytype.yml
+++ b/docs/docs-ref-autogen/excel_online/excel/excel.entitypropertytype.yml
@@ -4,7 +4,16 @@ uid: excel!Excel.EntityPropertyType:type
package: excel!
fullName: Excel.EntityPropertyType
summary: Represents the value of a property.
-remarks: "\\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \\]\r\n\r\nLearn more about the types in this type alias through the following links. \r\n\r\n[Excel.CellValueAndPropertyMetadata](/javascript/api/excel/excel.cellvalueandpropertymetadata), [Excel.CellValue](/javascript/api/excel/excel.cellvalue)"
+remarks: >-
+ \[ [API set: ExcelApi
+ 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ Learn more about the types in this type alias through the following links.
+
+
+ [Excel.CellValueAndPropertyMetadata](/javascript/api/excel/excel.cellvalueandpropertymetadata),
+ [Excel.CellValue](/javascript/api/excel/excel.cellvalue)
isPreview: false
isDeprecated: false
diff --git a/docs/docs-ref-autogen/excel_online/excel/excel.errorcellvalue.yml b/docs/docs-ref-autogen/excel_online/excel/excel.errorcellvalue.yml
index e5addcc22..b88b1959c 100644
--- a/docs/docs-ref-autogen/excel_online/excel/excel.errorcellvalue.yml
+++ b/docs/docs-ref-autogen/excel_online/excel/excel.errorcellvalue.yml
@@ -4,7 +4,62 @@ uid: excel!Excel.ErrorCellValue:type
package: excel!
fullName: Excel.ErrorCellValue
summary: Represents a cell value which contains an error.
-remarks: "\\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \\]\n\n\r\n\r\nLearn more about the types in this type alias through the following links. \r\n\r\n[Excel.BlockedErrorCellValue](/javascript/api/excel/excel.blockederrorcellvalue), [Excel.BusyErrorCellValue](/javascript/api/excel/excel.busyerrorcellvalue), [Excel.CalcErrorCellValue](/javascript/api/excel/excel.calcerrorcellvalue), [Excel.ConnectErrorCellValue](/javascript/api/excel/excel.connecterrorcellvalue), [Excel.Div0ErrorCellValue](/javascript/api/excel/excel.div0errorcellvalue), [Excel.ExternalErrorCellValue](/javascript/api/excel/excel.externalerrorcellvalue), [Excel.FieldErrorCellValue](/javascript/api/excel/excel.fielderrorcellvalue), [Excel.GettingDataErrorCellValue](/javascript/api/excel/excel.gettingdataerrorcellvalue), [Excel.NotAvailableErrorCellValue](/javascript/api/excel/excel.notavailableerrorcellvalue), [Excel.NameErrorCellValue](/javascript/api/excel/excel.nameerrorcellvalue), [Excel.NullErrorCellValue](/javascript/api/excel/excel.nullerrorcellvalue), [Excel.NumErrorCellValue](/javascript/api/excel/excel.numerrorcellvalue), [Excel.PlaceholderErrorCellValue](/javascript/api/excel/excel.placeholdererrorcellvalue), [Excel.RefErrorCellValue](/javascript/api/excel/excel.referrorcellvalue), [Excel.SpillErrorCellValue](/javascript/api/excel/excel.spillerrorcellvalue), [Excel.ValueErrorCellValue](/javascript/api/excel/excel.valueerrorcellvalue)\r\n\r\n#### Examples\n\n```TypeScript\n// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/20-data-types/data-types-error-values.yaml\n\n// This function sets the value of cell A1 to a #BUSY! error using data types.\nawait Excel.run(async (context) => {\n // Retrieve the Sample worksheet and cell A1 on that sheet.\n const sheet = context.workbook.worksheets.getItemOrNullObject(\"Sample\");\n const range = sheet.getRange(\"A1\");\n\n // Get the error data type and set its type to `busy`.\n const error: Excel.ErrorCellValue = {\n type: Excel.CellValueType.error,\n errorType: Excel.ErrorCellValueType.busy\n };\n\n // Set cell A1 as the busy error.\n range.valuesAsJson = [[error]];\n await context.sync();\n});\n```"
+remarks: >-
+ \[ [API set: ExcelApi
+ 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+
+
+ Learn more about the types in this type alias through the following links.
+
+
+ [Excel.BlockedErrorCellValue](/javascript/api/excel/excel.blockederrorcellvalue),
+ [Excel.BusyErrorCellValue](/javascript/api/excel/excel.busyerrorcellvalue),
+ [Excel.CalcErrorCellValue](/javascript/api/excel/excel.calcerrorcellvalue),
+ [Excel.ConnectErrorCellValue](/javascript/api/excel/excel.connecterrorcellvalue),
+ [Excel.Div0ErrorCellValue](/javascript/api/excel/excel.div0errorcellvalue),
+ [Excel.ExternalErrorCellValue](/javascript/api/excel/excel.externalerrorcellvalue),
+ [Excel.FieldErrorCellValue](/javascript/api/excel/excel.fielderrorcellvalue),
+ [Excel.GettingDataErrorCellValue](/javascript/api/excel/excel.gettingdataerrorcellvalue),
+ [Excel.NotAvailableErrorCellValue](/javascript/api/excel/excel.notavailableerrorcellvalue),
+ [Excel.NameErrorCellValue](/javascript/api/excel/excel.nameerrorcellvalue),
+ [Excel.NullErrorCellValue](/javascript/api/excel/excel.nullerrorcellvalue),
+ [Excel.NumErrorCellValue](/javascript/api/excel/excel.numerrorcellvalue),
+ [Excel.PlaceholderErrorCellValue](/javascript/api/excel/excel.placeholdererrorcellvalue),
+ [Excel.RefErrorCellValue](/javascript/api/excel/excel.referrorcellvalue),
+ [Excel.SpillErrorCellValue](/javascript/api/excel/excel.spillerrorcellvalue),
+ [Excel.ValueErrorCellValue](/javascript/api/excel/excel.valueerrorcellvalue)
+
+
+ #### Examples
+
+
+ ```TypeScript
+
+ // Link to full sample:
+ https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/20-data-types/data-types-error-values.yaml
+
+
+ // This function sets the value of cell A1 to a #BUSY! error using data types.
+
+ await Excel.run(async (context) => {
+ // Retrieve the Sample worksheet and cell A1 on that sheet.
+ const sheet = context.workbook.worksheets.getItemOrNullObject("Sample");
+ const range = sheet.getRange("A1");
+
+ // Get the error data type and set its type to `busy`.
+ const error: Excel.ErrorCellValue = {
+ type: Excel.CellValueType.error,
+ errorType: Excel.ErrorCellValueType.busy
+ };
+
+ // Set cell A1 as the busy error.
+ range.valuesAsJson = [[error]];
+ await context.sync();
+ });
+
+ ```
isPreview: false
isDeprecated: false
diff --git a/docs/docs-ref-autogen/excel_online/excel/excel.functioncellvalue.yml b/docs/docs-ref-autogen/excel_online/excel/excel.functioncellvalue.yml
index 50b723960..b1f83d2ff 100644
--- a/docs/docs-ref-autogen/excel_online/excel/excel.functioncellvalue.yml
+++ b/docs/docs-ref-autogen/excel_online/excel/excel.functioncellvalue.yml
@@ -4,7 +4,15 @@ uid: excel!Excel.FunctionCellValue:type
package: excel!
fullName: Excel.FunctionCellValue
summary: Represents a cell value which can be evaluated as a function.
-remarks: "\\[ [API set: ExcelApi 1.19](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \\]\r\n\r\nLearn more about the types in this type alias through the following links. \r\n\r\n[Excel.JavaScriptCustomFunctionReferenceCellValue](/javascript/api/excel/excel.javascriptcustomfunctionreferencecellvalue)"
+remarks: >-
+ \[ [API set: ExcelApi
+ 1.19](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ Learn more about the types in this type alias through the following links.
+
+
+ [Excel.JavaScriptCustomFunctionReferenceCellValue](/javascript/api/excel/excel.javascriptcustomfunctionreferencecellvalue)
isPreview: false
isDeprecated: false
diff --git a/docs/docs-ref-autogen/excel_online/excel/excel.notavailableerrorcellvalue.yml b/docs/docs-ref-autogen/excel_online/excel/excel.notavailableerrorcellvalue.yml
index 408016466..0587e033a 100644
--- a/docs/docs-ref-autogen/excel_online/excel/excel.notavailableerrorcellvalue.yml
+++ b/docs/docs-ref-autogen/excel_online/excel/excel.notavailableerrorcellvalue.yml
@@ -3,7 +3,7 @@ name: Excel.NotAvailableErrorCellValue
uid: excel!Excel.NotAvailableErrorCellValue:interface
package: excel!
fullName: Excel.NotAvailableErrorCellValue
-summary: Represents the value of a cell containing a \#N/A! error.
+summary: Represents the value of a cell containing a \#N/A error.
remarks: >-
\[ [API set: ExcelApi
1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
@@ -48,9 +48,9 @@ properties:
isPreview: false
isDeprecated: false
syntax:
- content: 'basicValue?: "#N/A!" | string;'
+ content: 'basicValue?: "#N/A" | string;'
return:
- type: '"#N/A!" | string'
+ type: '"#N/A" | string'
- name: errorType
uid: excel!Excel.NotAvailableErrorCellValue#errorType:member
package: excel!
diff --git a/docs/docs-ref-autogen/excel_online/excel/excel.range.yml b/docs/docs-ref-autogen/excel_online/excel/excel.range.yml
index 1accde8c5..1fa17eceb 100644
--- a/docs/docs-ref-autogen/excel_online/excel/excel.range.yml
+++ b/docs/docs-ref-autogen/excel_online/excel/excel.range.yml
@@ -2120,7 +2120,8 @@ methods:
summary: >-
Returns a range object that includes the current range and up to the edge
of the range, based on the provided direction. This matches the
- Ctrl+Shift+Arrow key behavior in the Excel on Windows UI.
+ Ctrl+Shift+Arrow key behavior in the
+ Excel on Windows UI.
remarks: >-
\[ [API set: ExcelApi
1.13](/javascript/api/requirement-sets/excel/excel-api-requirement-sets)
@@ -2185,7 +2186,8 @@ methods:
summary: >-
Returns a range object that includes the current range and up to the edge
of the range, based on the provided direction. This matches the
- Ctrl+Shift+Arrow key behavior in the Excel on Windows UI.
+ Ctrl+Shift+Arrow key behavior in the
+ Excel on Windows UI.
remarks: >-
\[ [API set: ExcelApi
1.13](/javascript/api/requirement-sets/excel/excel-api-requirement-sets)
@@ -2701,8 +2703,8 @@ methods:
fullName: getRangeEdge(direction, activeCell)
summary: >-
Returns a range object that is the edge cell of the data region that
- corresponds to the provided direction. This matches the Ctrl+Arrow key
- behavior in the Excel on Windows UI.
+ corresponds to the provided direction. This matches the
+ Ctrl+Arrow key behavior in the Excel on Windows UI.
remarks: >-
\[ [API set: ExcelApi
1.13](/javascript/api/requirement-sets/excel/excel-api-requirement-sets)
@@ -2766,8 +2768,8 @@ methods:
fullName: getRangeEdge(direction, activeCell)
summary: >-
Returns a range object that is the edge cell of the data region that
- corresponds to the provided direction. This matches the Ctrl+Arrow key
- behavior in the Excel on Windows UI.
+ corresponds to the provided direction. This matches the
+ Ctrl+Arrow key behavior in the Excel on Windows UI.
remarks: >-
\[ [API set: ExcelApi
1.13](/javascript/api/requirement-sets/excel/excel-api-requirement-sets)
diff --git a/docs/docs-ref-autogen/excel_online/excel/excel.referencedvalue.yml b/docs/docs-ref-autogen/excel_online/excel/excel.referencedvalue.yml
index 57044e8eb..168b4928b 100644
--- a/docs/docs-ref-autogen/excel_online/excel/excel.referencedvalue.yml
+++ b/docs/docs-ref-autogen/excel_online/excel/excel.referencedvalue.yml
@@ -4,7 +4,20 @@ uid: excel!Excel.ReferencedValue:type
package: excel!
fullName: Excel.ReferencedValue
summary: Represents the value in a cell.
-remarks: "\\[ [API set: ExcelApi 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \\]\r\n\r\nLearn more about the types in this type alias through the following links. \r\n\r\n[Excel.ArrayCellValue](/javascript/api/excel/excel.arraycellvalue), [Excel.EntityCellValue](/javascript/api/excel/excel.entitycellvalue), [Excel.RootReferenceCellValue](/javascript/api/excel/excel.rootreferencecellvalue), [Excel.DoubleCellValue](/javascript/api/excel/excel.doublecellvalue), [Excel.StringCellValue](/javascript/api/excel/excel.stringcellvalue), [Excel.BooleanCellValue](/javascript/api/excel/excel.booleancellvalue)"
+remarks: >-
+ \[ [API set: ExcelApi
+ 1.16](/javascript/api/requirement-sets/excel/excel-api-requirement-sets) \]
+
+
+ Learn more about the types in this type alias through the following links.
+
+
+ [Excel.ArrayCellValue](/javascript/api/excel/excel.arraycellvalue),
+ [Excel.EntityCellValue](/javascript/api/excel/excel.entitycellvalue),
+ [Excel.RootReferenceCellValue](/javascript/api/excel/excel.rootreferencecellvalue),
+ [Excel.DoubleCellValue](/javascript/api/excel/excel.doublecellvalue),
+ [Excel.StringCellValue](/javascript/api/excel/excel.stringcellvalue),
+ [Excel.BooleanCellValue](/javascript/api/excel/excel.booleancellvalue)
isPreview: false
isDeprecated: false
diff --git a/docs/docs-ref-autogen/excel_online/excel/excel.workbook.yml b/docs/docs-ref-autogen/excel_online/excel/excel.workbook.yml
index 484099bd6..668381c7a 100644
--- a/docs/docs-ref-autogen/excel_online/excel/excel.workbook.yml
+++ b/docs/docs-ref-autogen/excel_online/excel/excel.workbook.yml
@@ -1006,17 +1006,22 @@ methods:
fullName: insertWorksheetsFromBase64(base64File, options)
summary: >-
Inserts the specified worksheets from a source workbook into the current
- workbook.
-
-
- *Note**: This API is currently only supported for Office on Windows,
- Mac, and the web.
+ workbook. The `extensionHardening` Windows registry key affects this API.
+ The file extension defined by the `base64File` param must match the real
+ file type of the inserted file. If `extensionHardening` is set to deny
+ mismatches and the file extension does not match the real file type, this
+ API throws the following error: "This operation is not allowed due to the
+ extension hardening policy."
remarks: >-
\[ [API set: ExcelApi
1.13](/javascript/api/requirement-sets/excel/excel-api-requirement-sets)
\]
+ This API is currently only supported for Office on Windows, Mac, and the
+ web.
+
+
#### Examples
diff --git a/generate-docs/API Coverage Report.csv b/generate-docs/API Coverage Report.csv
index ff48b4652..5125fcd5b 100644
--- a/generate-docs/API Coverage Report.csv
+++ b/generate-docs/API Coverage Report.csv
@@ -6676,7 +6676,7 @@ Excel.Workbook,"getIsActiveCollabSession()",Method,Excellent,false
Excel.Workbook,"getLinkedEntityCellValue(linkedEntityCellValueId)",Method,Great,false
Excel.Workbook,"getSelectedRange()",Method,Excellent,true
Excel.Workbook,"getSelectedRanges()",Method,Excellent,true
-Excel.Workbook,"insertWorksheetsFromBase64(base64File, options)",Method,Good,true
+Excel.Workbook,"insertWorksheetsFromBase64(base64File, options)",Method,Great,true
Excel.Workbook,"load(options)",Method,Excellent,false
Excel.Workbook,"load(propertyNames)",Method,Excellent,false
Excel.Workbook,"load(propertyNamesAndPaths)",Method,Excellent,false
diff --git a/generate-docs/api-extractor-inputs-excel-release/Excel_1_10/excel.d.ts b/generate-docs/api-extractor-inputs-excel-release/Excel_1_10/excel.d.ts
index 9fe1343c8..964afc00e 100644
--- a/generate-docs/api-extractor-inputs-excel-release/Excel_1_10/excel.d.ts
+++ b/generate-docs/api-extractor-inputs-excel-release/Excel_1_10/excel.d.ts
@@ -581,6 +581,7 @@ export declare namespace Excel {
/**
*
* Creates and opens a new workbook. Optionally, the workbook can be pre-populated with a Base64-encoded .xlsx file.
+ * The `extensionHardening` Windows registry key affects the `base64File` param. The file extension defined by the param must match the real file type of the file. If `extensionHardening` is set to deny mismatches and the file extension does not match the real file type, this API throws the following error: "This operation is not allowed due to the extension hardening policy."
* Note: Macros can be a security risk. If this API is used to create a workbook that includes a macro, the add-in user will be prompted with a "Trust this add-in?" dialog in the Excel UI. The user must select the "Trust add-in" button to proceed.
*
* [Api set: ExcelApi 1.8]
diff --git a/generate-docs/api-extractor-inputs-excel-release/Excel_1_11/excel.d.ts b/generate-docs/api-extractor-inputs-excel-release/Excel_1_11/excel.d.ts
index ee1d1872a..cbb2fdfcd 100644
--- a/generate-docs/api-extractor-inputs-excel-release/Excel_1_11/excel.d.ts
+++ b/generate-docs/api-extractor-inputs-excel-release/Excel_1_11/excel.d.ts
@@ -581,6 +581,7 @@ export declare namespace Excel {
/**
*
* Creates and opens a new workbook. Optionally, the workbook can be pre-populated with a Base64-encoded .xlsx file.
+ * The `extensionHardening` Windows registry key affects the `base64File` param. The file extension defined by the param must match the real file type of the file. If `extensionHardening` is set to deny mismatches and the file extension does not match the real file type, this API throws the following error: "This operation is not allowed due to the extension hardening policy."
* Note: Macros can be a security risk. If this API is used to create a workbook that includes a macro, the add-in user will be prompted with a "Trust this add-in?" dialog in the Excel UI. The user must select the "Trust add-in" button to proceed.
*
* [Api set: ExcelApi 1.8]
diff --git a/generate-docs/api-extractor-inputs-excel-release/Excel_1_12/excel.d.ts b/generate-docs/api-extractor-inputs-excel-release/Excel_1_12/excel.d.ts
index 4dddbf04e..fd15f2676 100644
--- a/generate-docs/api-extractor-inputs-excel-release/Excel_1_12/excel.d.ts
+++ b/generate-docs/api-extractor-inputs-excel-release/Excel_1_12/excel.d.ts
@@ -581,6 +581,7 @@ export declare namespace Excel {
/**
*
* Creates and opens a new workbook. Optionally, the workbook can be pre-populated with a Base64-encoded .xlsx file.
+ * The `extensionHardening` Windows registry key affects the `base64File` param. The file extension defined by the param must match the real file type of the file. If `extensionHardening` is set to deny mismatches and the file extension does not match the real file type, this API throws the following error: "This operation is not allowed due to the extension hardening policy."
* Note: Macros can be a security risk. If this API is used to create a workbook that includes a macro, the add-in user will be prompted with a "Trust this add-in?" dialog in the Excel UI. The user must select the "Trust add-in" button to proceed.
*
* [Api set: ExcelApi 1.8]
diff --git a/generate-docs/api-extractor-inputs-excel-release/Excel_1_13/excel.d.ts b/generate-docs/api-extractor-inputs-excel-release/Excel_1_13/excel.d.ts
index 8a811f675..0ef0959ac 100644
--- a/generate-docs/api-extractor-inputs-excel-release/Excel_1_13/excel.d.ts
+++ b/generate-docs/api-extractor-inputs-excel-release/Excel_1_13/excel.d.ts
@@ -581,6 +581,7 @@ export declare namespace Excel {
/**
*
* Creates and opens a new workbook. Optionally, the workbook can be pre-populated with a Base64-encoded .xlsx file.
+ * The `extensionHardening` Windows registry key affects the `base64File` param. The file extension defined by the param must match the real file type of the file. If `extensionHardening` is set to deny mismatches and the file extension does not match the real file type, this API throws the following error: "This operation is not allowed due to the extension hardening policy."
* Note: Macros can be a security risk. If this API is used to create a workbook that includes a macro, the add-in user will be prompted with a "Trust this add-in?" dialog in the Excel UI. The user must select the "Trust add-in" button to proceed.
*
* [Api set: ExcelApi 1.8]
@@ -3324,11 +3325,12 @@ export declare namespace Excel {
getSelectedRanges(): Excel.RangeAreas;
/**
* Inserts the specified worksheets from a source workbook into the current workbook.
-
- **Note**: This API is currently only supported for Office on Windows, Mac, and the web.
+ * The `extensionHardening` Windows registry key affects this API. The file extension defined by the `base64File` param must match the real file type of the inserted file. If `extensionHardening` is set to deny mismatches and the file extension does not match the real file type, this API throws the following error: "This operation is not allowed due to the extension hardening policy."
*
* @remarks
* [Api set: ExcelApi 1.13]
+ *
+ * This API is currently only supported for Office on Windows, Mac, and the web.
*
* @param base64File - Required. The Base64-encoded string representing the source workbook file.
* @param options - Optional. The options that define which worksheets to insert and where in the workbook the new worksheets will be inserted. By default, all the worksheets from the source workbook are inserted at the end of the current workbook.
@@ -5055,7 +5057,7 @@ export declare namespace Excel {
*/
getEntireRow(): Excel.Range;
/**
- * Returns a range object that includes the current range and up to the edge of the range, based on the provided direction. This matches the Ctrl+Shift+Arrow key behavior in the Excel on Windows UI.
+ * Returns a range object that includes the current range and up to the edge of the range, based on the provided direction. This matches the Ctrl+Shift+Arrow key behavior in the Excel on Windows UI.
*
* @remarks
* [Api set: ExcelApi 1.13]
@@ -5065,7 +5067,7 @@ export declare namespace Excel {
*/
getExtendedRange(direction: Excel.KeyboardDirection, activeCell?: Range | string): Excel.Range;
/**
- * Returns a range object that includes the current range and up to the edge of the range, based on the provided direction. This matches the Ctrl+Shift+Arrow key behavior in the Excel on Windows UI.
+ * Returns a range object that includes the current range and up to the edge of the range, based on the provided direction. This matches the Ctrl+Shift+Arrow key behavior in the Excel on Windows UI.
*
* @remarks
* [Api set: ExcelApi 1.13]
@@ -5153,7 +5155,7 @@ export declare namespace Excel {
getPivotTables(fullyContained?: boolean): Excel.PivotTableScopedCollection;
/**
- * Returns a range object that is the edge cell of the data region that corresponds to the provided direction. This matches the Ctrl+Arrow key behavior in the Excel on Windows UI.
+ * Returns a range object that is the edge cell of the data region that corresponds to the provided direction. This matches the Ctrl+Arrow key behavior in the Excel on Windows UI.
*
* @remarks
* [Api set: ExcelApi 1.13]
@@ -5163,7 +5165,7 @@ export declare namespace Excel {
*/
getRangeEdge(direction: Excel.KeyboardDirection, activeCell?: Range | string): Excel.Range;
/**
- * Returns a range object that is the edge cell of the data region that corresponds to the provided direction. This matches the Ctrl+Arrow key behavior in the Excel on Windows UI.
+ * Returns a range object that is the edge cell of the data region that corresponds to the provided direction. This matches the Ctrl+Arrow key behavior in the Excel on Windows UI.
*
* @remarks
* [Api set: ExcelApi 1.13]
diff --git a/generate-docs/api-extractor-inputs-excel-release/Excel_1_14/excel.d.ts b/generate-docs/api-extractor-inputs-excel-release/Excel_1_14/excel.d.ts
index c2e4a36fa..189d99e7e 100644
--- a/generate-docs/api-extractor-inputs-excel-release/Excel_1_14/excel.d.ts
+++ b/generate-docs/api-extractor-inputs-excel-release/Excel_1_14/excel.d.ts
@@ -581,6 +581,7 @@ export declare namespace Excel {
/**
*
* Creates and opens a new workbook. Optionally, the workbook can be pre-populated with a Base64-encoded .xlsx file.
+ * The `extensionHardening` Windows registry key affects the `base64File` param. The file extension defined by the param must match the real file type of the file. If `extensionHardening` is set to deny mismatches and the file extension does not match the real file type, this API throws the following error: "This operation is not allowed due to the extension hardening policy."
* Note: Macros can be a security risk. If this API is used to create a workbook that includes a macro, the add-in user will be prompted with a "Trust this add-in?" dialog in the Excel UI. The user must select the "Trust add-in" button to proceed.
*
* [Api set: ExcelApi 1.8]
@@ -3609,11 +3610,12 @@ export declare namespace Excel {
getSelectedRanges(): Excel.RangeAreas;
/**
* Inserts the specified worksheets from a source workbook into the current workbook.
-
- **Note**: This API is currently only supported for Office on Windows, Mac, and the web.
+ * The `extensionHardening` Windows registry key affects this API. The file extension defined by the `base64File` param must match the real file type of the inserted file. If `extensionHardening` is set to deny mismatches and the file extension does not match the real file type, this API throws the following error: "This operation is not allowed due to the extension hardening policy."
*
* @remarks
* [Api set: ExcelApi 1.13]
+ *
+ * This API is currently only supported for Office on Windows, Mac, and the web.
*
* @param base64File - Required. The Base64-encoded string representing the source workbook file.
* @param options - Optional. The options that define which worksheets to insert and where in the workbook the new worksheets will be inserted. By default, all the worksheets from the source workbook are inserted at the end of the current workbook.
@@ -5362,7 +5364,7 @@ export declare namespace Excel {
*/
getEntireRow(): Excel.Range;
/**
- * Returns a range object that includes the current range and up to the edge of the range, based on the provided direction. This matches the Ctrl+Shift+Arrow key behavior in the Excel on Windows UI.
+ * Returns a range object that includes the current range and up to the edge of the range, based on the provided direction. This matches the Ctrl+Shift+Arrow key behavior in the Excel on Windows UI.
*
* @remarks
* [Api set: ExcelApi 1.13]
@@ -5372,7 +5374,7 @@ export declare namespace Excel {
*/
getExtendedRange(direction: Excel.KeyboardDirection, activeCell?: Range | string): Excel.Range;
/**
- * Returns a range object that includes the current range and up to the edge of the range, based on the provided direction. This matches the Ctrl+Shift+Arrow key behavior in the Excel on Windows UI.
+ * Returns a range object that includes the current range and up to the edge of the range, based on the provided direction. This matches the Ctrl+Shift+Arrow key behavior in the Excel on Windows UI.
*
* @remarks
* [Api set: ExcelApi 1.13]
@@ -5467,7 +5469,7 @@ export declare namespace Excel {
*/
getPrecedents(): Excel.WorkbookRangeAreas;
/**
- * Returns a range object that is the edge cell of the data region that corresponds to the provided direction. This matches the Ctrl+Arrow key behavior in the Excel on Windows UI.
+ * Returns a range object that is the edge cell of the data region that corresponds to the provided direction. This matches the Ctrl+Arrow key behavior in the Excel on Windows UI.
*
* @remarks
* [Api set: ExcelApi 1.13]
@@ -5477,7 +5479,7 @@ export declare namespace Excel {
*/
getRangeEdge(direction: Excel.KeyboardDirection, activeCell?: Range | string): Excel.Range;
/**
- * Returns a range object that is the edge cell of the data region that corresponds to the provided direction. This matches the Ctrl+Arrow key behavior in the Excel on Windows UI.
+ * Returns a range object that is the edge cell of the data region that corresponds to the provided direction. This matches the Ctrl+Arrow key behavior in the Excel on Windows UI.
*
* @remarks
* [Api set: ExcelApi 1.13]
diff --git a/generate-docs/api-extractor-inputs-excel-release/Excel_1_15/excel.d.ts b/generate-docs/api-extractor-inputs-excel-release/Excel_1_15/excel.d.ts
index 83a32424b..481cf89fd 100644
--- a/generate-docs/api-extractor-inputs-excel-release/Excel_1_15/excel.d.ts
+++ b/generate-docs/api-extractor-inputs-excel-release/Excel_1_15/excel.d.ts
@@ -581,6 +581,7 @@ export declare namespace Excel {
/**
*
* Creates and opens a new workbook. Optionally, the workbook can be pre-populated with a Base64-encoded .xlsx file.
+ * The `extensionHardening` Windows registry key affects the `base64File` param. The file extension defined by the param must match the real file type of the file. If `extensionHardening` is set to deny mismatches and the file extension does not match the real file type, this API throws the following error: "This operation is not allowed due to the extension hardening policy."
* Note: Macros can be a security risk. If this API is used to create a workbook that includes a macro, the add-in user will be prompted with a "Trust this add-in?" dialog in the Excel UI. The user must select the "Trust add-in" button to proceed.
*
* [Api set: ExcelApi 1.8]
@@ -3634,11 +3635,12 @@ export declare namespace Excel {
getSelectedRanges(): Excel.RangeAreas;
/**
* Inserts the specified worksheets from a source workbook into the current workbook.
-
- **Note**: This API is currently only supported for Office on Windows, Mac, and the web.
+ * The `extensionHardening` Windows registry key affects this API. The file extension defined by the `base64File` param must match the real file type of the inserted file. If `extensionHardening` is set to deny mismatches and the file extension does not match the real file type, this API throws the following error: "This operation is not allowed due to the extension hardening policy."
*
* @remarks
* [Api set: ExcelApi 1.13]
+ *
+ * This API is currently only supported for Office on Windows, Mac, and the web.
*
* @param base64File - Required. The Base64-encoded string representing the source workbook file.
* @param options - Optional. The options that define which worksheets to insert and where in the workbook the new worksheets will be inserted. By default, all the worksheets from the source workbook are inserted at the end of the current workbook.
@@ -5394,7 +5396,7 @@ export declare namespace Excel {
*/
getEntireRow(): Excel.Range;
/**
- * Returns a range object that includes the current range and up to the edge of the range, based on the provided direction. This matches the Ctrl+Shift+Arrow key behavior in the Excel on Windows UI.
+ * Returns a range object that includes the current range and up to the edge of the range, based on the provided direction. This matches the Ctrl+Shift+Arrow key behavior in the Excel on Windows UI.
*
* @remarks
* [Api set: ExcelApi 1.13]
@@ -5404,7 +5406,7 @@ export declare namespace Excel {
*/
getExtendedRange(direction: Excel.KeyboardDirection, activeCell?: Range | string): Excel.Range;
/**
- * Returns a range object that includes the current range and up to the edge of the range, based on the provided direction. This matches the Ctrl+Shift+Arrow key behavior in the Excel on Windows UI.
+ * Returns a range object that includes the current range and up to the edge of the range, based on the provided direction. This matches the Ctrl+Shift+Arrow key behavior in the Excel on Windows UI.
*
* @remarks
* [Api set: ExcelApi 1.13]
@@ -5499,7 +5501,7 @@ export declare namespace Excel {
*/
getPrecedents(): Excel.WorkbookRangeAreas;
/**
- * Returns a range object that is the edge cell of the data region that corresponds to the provided direction. This matches the Ctrl+Arrow key behavior in the Excel on Windows UI.
+ * Returns a range object that is the edge cell of the data region that corresponds to the provided direction. This matches the Ctrl+Arrow key behavior in the Excel on Windows UI.
*
* @remarks
* [Api set: ExcelApi 1.13]
@@ -5509,7 +5511,7 @@ export declare namespace Excel {
*/
getRangeEdge(direction: Excel.KeyboardDirection, activeCell?: Range | string): Excel.Range;
/**
- * Returns a range object that is the edge cell of the data region that corresponds to the provided direction. This matches the Ctrl+Arrow key behavior in the Excel on Windows UI.
+ * Returns a range object that is the edge cell of the data region that corresponds to the provided direction. This matches the Ctrl+Arrow key behavior in the Excel on Windows UI.
*
* @remarks
* [Api set: ExcelApi 1.13]
diff --git a/generate-docs/api-extractor-inputs-excel-release/Excel_1_16/excel.d.ts b/generate-docs/api-extractor-inputs-excel-release/Excel_1_16/excel.d.ts
index 5fc47f25b..a3db684de 100644
--- a/generate-docs/api-extractor-inputs-excel-release/Excel_1_16/excel.d.ts
+++ b/generate-docs/api-extractor-inputs-excel-release/Excel_1_16/excel.d.ts
@@ -5661,7 +5661,7 @@ export declare namespace Excel {
provider?: CellValueProviderAttributes;
}
/**
- * Represents the value of a cell containing a #N/A! error.
+ * Represents the value of a cell containing a #N/A error.
*
* @remarks
* [Api set: ExcelApi 1.16]
@@ -5682,7 +5682,7 @@ export declare namespace Excel {
* @remarks
* [Api set: ExcelApi 1.16]
*/
- basicValue?: "#N/A!" | string;
+ basicValue?: "#N/A" | string;
/**
* Represents the value that would be returned by `Range.valueTypes` for a cell with this value.
*
@@ -6854,6 +6854,7 @@ export declare namespace Excel {
/**
*
* Creates and opens a new workbook. Optionally, the workbook can be pre-populated with a Base64-encoded .xlsx file.
+ * The `extensionHardening` Windows registry key affects the `base64File` param. The file extension defined by the param must match the real file type of the file. If `extensionHardening` is set to deny mismatches and the file extension does not match the real file type, this API throws the following error: "This operation is not allowed due to the extension hardening policy."
* Note: Macros can be a security risk. If this API is used to create a workbook that includes a macro, the add-in user will be prompted with a "Trust this add-in?" dialog in the Excel UI. The user must select the "Trust add-in" button to proceed.
*
* [Api set: ExcelApi 1.8]
@@ -9929,11 +9930,12 @@ export declare namespace Excel {
getSelectedRanges(): Excel.RangeAreas;
/**
* Inserts the specified worksheets from a source workbook into the current workbook.
-
- **Note**: This API is currently only supported for Office on Windows, Mac, and the web.
+ * The `extensionHardening` Windows registry key affects this API. The file extension defined by the `base64File` param must match the real file type of the inserted file. If `extensionHardening` is set to deny mismatches and the file extension does not match the real file type, this API throws the following error: "This operation is not allowed due to the extension hardening policy."
*
* @remarks
* [Api set: ExcelApi 1.13]
+ *
+ * This API is currently only supported for Office on Windows, Mac, and the web.
*
* @param base64File - Required. The Base64-encoded string representing the source workbook file.
* @param options - Optional. The options that define which worksheets to insert and where in the workbook the new worksheets will be inserted. By default, all the worksheets from the source workbook are inserted at the end of the current workbook.
@@ -11705,7 +11707,7 @@ export declare namespace Excel {
*/
getEntireRow(): Excel.Range;
/**
- * Returns a range object that includes the current range and up to the edge of the range, based on the provided direction. This matches the Ctrl+Shift+Arrow key behavior in the Excel on Windows UI.
+ * Returns a range object that includes the current range and up to the edge of the range, based on the provided direction. This matches the Ctrl+Shift+Arrow key behavior in the Excel on Windows UI.
*
* @remarks
* [Api set: ExcelApi 1.13]
@@ -11715,7 +11717,7 @@ export declare namespace Excel {
*/
getExtendedRange(direction: Excel.KeyboardDirection, activeCell?: Range | string): Excel.Range;
/**
- * Returns a range object that includes the current range and up to the edge of the range, based on the provided direction. This matches the Ctrl+Shift+Arrow key behavior in the Excel on Windows UI.
+ * Returns a range object that includes the current range and up to the edge of the range, based on the provided direction. This matches the Ctrl+Shift+Arrow key behavior in the Excel on Windows UI.
*
* @remarks
* [Api set: ExcelApi 1.13]
@@ -11810,7 +11812,7 @@ export declare namespace Excel {
*/
getPrecedents(): Excel.WorkbookRangeAreas;
/**
- * Returns a range object that is the edge cell of the data region that corresponds to the provided direction. This matches the Ctrl+Arrow key behavior in the Excel on Windows UI.
+ * Returns a range object that is the edge cell of the data region that corresponds to the provided direction. This matches the Ctrl+Arrow key behavior in the Excel on Windows UI.
*
* @remarks
* [Api set: ExcelApi 1.13]
@@ -11820,7 +11822,7 @@ export declare namespace Excel {
*/
getRangeEdge(direction: Excel.KeyboardDirection, activeCell?: Range | string): Excel.Range;
/**
- * Returns a range object that is the edge cell of the data region that corresponds to the provided direction. This matches the Ctrl+Arrow key behavior in the Excel on Windows UI.
+ * Returns a range object that is the edge cell of the data region that corresponds to the provided direction. This matches the Ctrl+Arrow key behavior in the Excel on Windows UI.
*
* @remarks
* [Api set: ExcelApi 1.13]
diff --git a/generate-docs/api-extractor-inputs-excel-release/Excel_1_17/excel.d.ts b/generate-docs/api-extractor-inputs-excel-release/Excel_1_17/excel.d.ts
index 5bf16bea8..7b390b6ee 100644
--- a/generate-docs/api-extractor-inputs-excel-release/Excel_1_17/excel.d.ts
+++ b/generate-docs/api-extractor-inputs-excel-release/Excel_1_17/excel.d.ts
@@ -5661,7 +5661,7 @@ export declare namespace Excel {
provider?: CellValueProviderAttributes;
}
/**
- * Represents the value of a cell containing a #N/A! error.
+ * Represents the value of a cell containing a #N/A error.
*
* @remarks
* [Api set: ExcelApi 1.16]
@@ -5682,7 +5682,7 @@ export declare namespace Excel {
* @remarks
* [Api set: ExcelApi 1.16]
*/
- basicValue?: "#N/A!" | string;
+ basicValue?: "#N/A" | string;
/**
* Represents the value that would be returned by `Range.valueTypes` for a cell with this value.
*
@@ -6854,6 +6854,7 @@ export declare namespace Excel {
/**
*
* Creates and opens a new workbook. Optionally, the workbook can be pre-populated with a Base64-encoded .xlsx file.
+ * The `extensionHardening` Windows registry key affects the `base64File` param. The file extension defined by the param must match the real file type of the file. If `extensionHardening` is set to deny mismatches and the file extension does not match the real file type, this API throws the following error: "This operation is not allowed due to the extension hardening policy."
* Note: Macros can be a security risk. If this API is used to create a workbook that includes a macro, the add-in user will be prompted with a "Trust this add-in?" dialog in the Excel UI. The user must select the "Trust add-in" button to proceed.
*
* [Api set: ExcelApi 1.8]
@@ -10062,11 +10063,12 @@ export declare namespace Excel {
getSelectedRanges(): Excel.RangeAreas;
/**
* Inserts the specified worksheets from a source workbook into the current workbook.
-
- **Note**: This API is currently only supported for Office on Windows, Mac, and the web.
+ * The `extensionHardening` Windows registry key affects this API. The file extension defined by the `base64File` param must match the real file type of the inserted file. If `extensionHardening` is set to deny mismatches and the file extension does not match the real file type, this API throws the following error: "This operation is not allowed due to the extension hardening policy."
*
* @remarks
* [Api set: ExcelApi 1.13]
+ *
+ * This API is currently only supported for Office on Windows, Mac, and the web.
*
* @param base64File - Required. The Base64-encoded string representing the source workbook file.
* @param options - Optional. The options that define which worksheets to insert and where in the workbook the new worksheets will be inserted. By default, all the worksheets from the source workbook are inserted at the end of the current workbook.
@@ -11878,7 +11880,7 @@ export declare namespace Excel {
*/
getEntireRow(): Excel.Range;
/**
- * Returns a range object that includes the current range and up to the edge of the range, based on the provided direction. This matches the Ctrl+Shift+Arrow key behavior in the Excel on Windows UI.
+ * Returns a range object that includes the current range and up to the edge of the range, based on the provided direction. This matches the Ctrl+Shift+Arrow key behavior in the Excel on Windows UI.
*
* @remarks
* [Api set: ExcelApi 1.13]
@@ -11888,7 +11890,7 @@ export declare namespace Excel {
*/
getExtendedRange(direction: Excel.KeyboardDirection, activeCell?: Range | string): Excel.Range;
/**
- * Returns a range object that includes the current range and up to the edge of the range, based on the provided direction. This matches the Ctrl+Shift+Arrow key behavior in the Excel on Windows UI.
+ * Returns a range object that includes the current range and up to the edge of the range, based on the provided direction. This matches the Ctrl+Shift+Arrow key behavior in the Excel on Windows UI.
*
* @remarks
* [Api set: ExcelApi 1.13]
@@ -11983,7 +11985,7 @@ export declare namespace Excel {
*/
getPrecedents(): Excel.WorkbookRangeAreas;
/**
- * Returns a range object that is the edge cell of the data region that corresponds to the provided direction. This matches the Ctrl+Arrow key behavior in the Excel on Windows UI.
+ * Returns a range object that is the edge cell of the data region that corresponds to the provided direction. This matches the Ctrl+Arrow key behavior in the Excel on Windows UI.
*
* @remarks
* [Api set: ExcelApi 1.13]
@@ -11993,7 +11995,7 @@ export declare namespace Excel {
*/
getRangeEdge(direction: Excel.KeyboardDirection, activeCell?: Range | string): Excel.Range;
/**
- * Returns a range object that is the edge cell of the data region that corresponds to the provided direction. This matches the Ctrl+Arrow key behavior in the Excel on Windows UI.
+ * Returns a range object that is the edge cell of the data region that corresponds to the provided direction. This matches the Ctrl+Arrow key behavior in the Excel on Windows UI.
*
* @remarks
* [Api set: ExcelApi 1.13]
diff --git a/generate-docs/api-extractor-inputs-excel-release/Excel_1_18/excel.d.ts b/generate-docs/api-extractor-inputs-excel-release/Excel_1_18/excel.d.ts
index ff23b3054..d3e120a2d 100644
--- a/generate-docs/api-extractor-inputs-excel-release/Excel_1_18/excel.d.ts
+++ b/generate-docs/api-extractor-inputs-excel-release/Excel_1_18/excel.d.ts
@@ -5702,7 +5702,7 @@ export declare namespace Excel {
provider?: CellValueProviderAttributes;
}
/**
- * Represents the value of a cell containing a #N/A! error.
+ * Represents the value of a cell containing a #N/A error.
*
* @remarks
* [Api set: ExcelApi 1.16]
@@ -5723,7 +5723,7 @@ export declare namespace Excel {
* @remarks
* [Api set: ExcelApi 1.16]
*/
- basicValue?: "#N/A!" | string;
+ basicValue?: "#N/A" | string;
/**
* Represents the value that would be returned by `Range.valueTypes` for a cell with this value.
*
@@ -6907,6 +6907,7 @@ export declare namespace Excel {
/**
*
* Creates and opens a new workbook. Optionally, the workbook can be pre-populated with a Base64-encoded .xlsx file.
+ * The `extensionHardening` Windows registry key affects the `base64File` param. The file extension defined by the param must match the real file type of the file. If `extensionHardening` is set to deny mismatches and the file extension does not match the real file type, this API throws the following error: "This operation is not allowed due to the extension hardening policy."
* Note: Macros can be a security risk. If this API is used to create a workbook that includes a macro, the add-in user will be prompted with a "Trust this add-in?" dialog in the Excel UI. The user must select the "Trust add-in" button to proceed.
*
* [Api set: ExcelApi 1.8]
@@ -10153,11 +10154,12 @@ export declare namespace Excel {
getSelectedRanges(): Excel.RangeAreas;
/**
* Inserts the specified worksheets from a source workbook into the current workbook.
-
- **Note**: This API is currently only supported for Office on Windows, Mac, and the web.
+ * The `extensionHardening` Windows registry key affects this API. The file extension defined by the `base64File` param must match the real file type of the inserted file. If `extensionHardening` is set to deny mismatches and the file extension does not match the real file type, this API throws the following error: "This operation is not allowed due to the extension hardening policy."
*
* @remarks
* [Api set: ExcelApi 1.13]
+ *
+ * This API is currently only supported for Office on Windows, Mac, and the web.
*
* @param base64File - Required. The Base64-encoded string representing the source workbook file.
* @param options - Optional. The options that define which worksheets to insert and where in the workbook the new worksheets will be inserted. By default, all the worksheets from the source workbook are inserted at the end of the current workbook.
@@ -11990,7 +11992,7 @@ export declare namespace Excel {
*/
getEntireRow(): Excel.Range;
/**
- * Returns a range object that includes the current range and up to the edge of the range, based on the provided direction. This matches the Ctrl+Shift+Arrow key behavior in the Excel on Windows UI.
+ * Returns a range object that includes the current range and up to the edge of the range, based on the provided direction. This matches the Ctrl+Shift+Arrow key behavior in the Excel on Windows UI.
*
* @remarks
* [Api set: ExcelApi 1.13]
@@ -12000,7 +12002,7 @@ export declare namespace Excel {
*/
getExtendedRange(direction: Excel.KeyboardDirection, activeCell?: Range | string): Excel.Range;
/**
- * Returns a range object that includes the current range and up to the edge of the range, based on the provided direction. This matches the Ctrl+Shift+Arrow key behavior in the Excel on Windows UI.
+ * Returns a range object that includes the current range and up to the edge of the range, based on the provided direction. This matches the Ctrl+Shift+Arrow key behavior in the Excel on Windows UI.
*
* @remarks
* [Api set: ExcelApi 1.13]
@@ -12095,7 +12097,7 @@ export declare namespace Excel {
*/
getPrecedents(): Excel.WorkbookRangeAreas;
/**
- * Returns a range object that is the edge cell of the data region that corresponds to the provided direction. This matches the Ctrl+Arrow key behavior in the Excel on Windows UI.
+ * Returns a range object that is the edge cell of the data region that corresponds to the provided direction. This matches the Ctrl+Arrow key behavior in the Excel on Windows UI.
*
* @remarks
* [Api set: ExcelApi 1.13]
@@ -12105,7 +12107,7 @@ export declare namespace Excel {
*/
getRangeEdge(direction: Excel.KeyboardDirection, activeCell?: Range | string): Excel.Range;
/**
- * Returns a range object that is the edge cell of the data region that corresponds to the provided direction. This matches the Ctrl+Arrow key behavior in the Excel on Windows UI.
+ * Returns a range object that is the edge cell of the data region that corresponds to the provided direction. This matches the Ctrl+Arrow key behavior in the Excel on Windows UI.
*
* @remarks
* [Api set: ExcelApi 1.13]
diff --git a/generate-docs/api-extractor-inputs-excel-release/Excel_1_19/excel.d.ts b/generate-docs/api-extractor-inputs-excel-release/Excel_1_19/excel.d.ts
index 61560ea69..39ed95bbf 100644
--- a/generate-docs/api-extractor-inputs-excel-release/Excel_1_19/excel.d.ts
+++ b/generate-docs/api-extractor-inputs-excel-release/Excel_1_19/excel.d.ts
@@ -6061,7 +6061,7 @@ export declare namespace Excel {
provider?: CellValueProviderAttributes;
}
/**
- * Represents the value of a cell containing a #N/A! error.
+ * Represents the value of a cell containing a #N/A error.
*
* @remarks
* [Api set: ExcelApi 1.16]
@@ -6082,7 +6082,7 @@ export declare namespace Excel {
* @remarks
* [Api set: ExcelApi 1.16]
*/
- basicValue?: "#N/A!" | string;
+ basicValue?: "#N/A" | string;
/**
* Represents the value that would be returned by `Range.valueTypes` for a cell with this value.
*
@@ -7294,6 +7294,7 @@ export declare namespace Excel {
/**
*
* Creates and opens a new workbook. Optionally, the workbook can be pre-populated with a Base64-encoded .xlsx file.
+ * The `extensionHardening` Windows registry key affects the `base64File` param. The file extension defined by the param must match the real file type of the file. If `extensionHardening` is set to deny mismatches and the file extension does not match the real file type, this API throws the following error: "This operation is not allowed due to the extension hardening policy."
* Note: Macros can be a security risk. If this API is used to create a workbook that includes a macro, the add-in user will be prompted with a "Trust this add-in?" dialog in the Excel UI. The user must select the "Trust add-in" button to proceed.
*
* [Api set: ExcelApi 1.8]
@@ -10561,11 +10562,12 @@ export declare namespace Excel {
getSelectedRanges(): Excel.RangeAreas;
/**
* Inserts the specified worksheets from a source workbook into the current workbook.
-
- **Note**: This API is currently only supported for Office on Windows, Mac, and the web.
+ * The `extensionHardening` Windows registry key affects this API. The file extension defined by the `base64File` param must match the real file type of the inserted file. If `extensionHardening` is set to deny mismatches and the file extension does not match the real file type, this API throws the following error: "This operation is not allowed due to the extension hardening policy."
*
* @remarks
* [Api set: ExcelApi 1.13]
+ *
+ * This API is currently only supported for Office on Windows, Mac, and the web.
*
* @param base64File - Required. The Base64-encoded string representing the source workbook file.
* @param options - Optional. The options that define which worksheets to insert and where in the workbook the new worksheets will be inserted. By default, all the worksheets from the source workbook are inserted at the end of the current workbook.
@@ -12414,7 +12416,7 @@ export declare namespace Excel {
*/
getEntireRow(): Excel.Range;
/**
- * Returns a range object that includes the current range and up to the edge of the range, based on the provided direction. This matches the Ctrl+Shift+Arrow key behavior in the Excel on Windows UI.
+ * Returns a range object that includes the current range and up to the edge of the range, based on the provided direction. This matches the Ctrl+Shift+Arrow key behavior in the Excel on Windows UI.
*
* @remarks
* [Api set: ExcelApi 1.13]
@@ -12424,7 +12426,7 @@ export declare namespace Excel {
*/
getExtendedRange(direction: Excel.KeyboardDirection, activeCell?: Range | string): Excel.Range;
/**
- * Returns a range object that includes the current range and up to the edge of the range, based on the provided direction. This matches the Ctrl+Shift+Arrow key behavior in the Excel on Windows UI.
+ * Returns a range object that includes the current range and up to the edge of the range, based on the provided direction. This matches the Ctrl+Shift+Arrow key behavior in the Excel on Windows UI.
*
* @remarks
* [Api set: ExcelApi 1.13]
@@ -12519,7 +12521,7 @@ export declare namespace Excel {
*/
getPrecedents(): Excel.WorkbookRangeAreas;
/**
- * Returns a range object that is the edge cell of the data region that corresponds to the provided direction. This matches the Ctrl+Arrow key behavior in the Excel on Windows UI.
+ * Returns a range object that is the edge cell of the data region that corresponds to the provided direction. This matches the Ctrl+Arrow key behavior in the Excel on Windows UI.
*
* @remarks
* [Api set: ExcelApi 1.13]
@@ -12529,7 +12531,7 @@ export declare namespace Excel {
*/
getRangeEdge(direction: Excel.KeyboardDirection, activeCell?: Range | string): Excel.Range;
/**
- * Returns a range object that is the edge cell of the data region that corresponds to the provided direction. This matches the Ctrl+Arrow key behavior in the Excel on Windows UI.
+ * Returns a range object that is the edge cell of the data region that corresponds to the provided direction. This matches the Ctrl+Arrow key behavior in the Excel on Windows UI.
*
* @remarks
* [Api set: ExcelApi 1.13]
diff --git a/generate-docs/api-extractor-inputs-excel-release/Excel_1_8/excel.d.ts b/generate-docs/api-extractor-inputs-excel-release/Excel_1_8/excel.d.ts
index 4a357a8b3..68fd8681c 100644
--- a/generate-docs/api-extractor-inputs-excel-release/Excel_1_8/excel.d.ts
+++ b/generate-docs/api-extractor-inputs-excel-release/Excel_1_8/excel.d.ts
@@ -102,6 +102,7 @@ export declare namespace Excel {
/**
*
* Creates and opens a new workbook. Optionally, the workbook can be pre-populated with a Base64-encoded .xlsx file.
+ * The `extensionHardening` Windows registry key affects the `base64File` param. The file extension defined by the param must match the real file type of the file. If `extensionHardening` is set to deny mismatches and the file extension does not match the real file type, this API throws the following error: "This operation is not allowed due to the extension hardening policy."
* Note: Macros can be a security risk. If this API is used to create a workbook that includes a macro, the add-in user will be prompted with a "Trust this add-in?" dialog in the Excel UI. The user must select the "Trust add-in" button to proceed.
*
* [Api set: ExcelApi 1.8]
diff --git a/generate-docs/api-extractor-inputs-excel-release/Excel_1_9/excel.d.ts b/generate-docs/api-extractor-inputs-excel-release/Excel_1_9/excel.d.ts
index eccd70415..f4b82d910 100644
--- a/generate-docs/api-extractor-inputs-excel-release/Excel_1_9/excel.d.ts
+++ b/generate-docs/api-extractor-inputs-excel-release/Excel_1_9/excel.d.ts
@@ -581,6 +581,7 @@ export declare namespace Excel {
/**
*
* Creates and opens a new workbook. Optionally, the workbook can be pre-populated with a Base64-encoded .xlsx file.
+ * The `extensionHardening` Windows registry key affects the `base64File` param. The file extension defined by the param must match the real file type of the file. If `extensionHardening` is set to deny mismatches and the file extension does not match the real file type, this API throws the following error: "This operation is not allowed due to the extension hardening policy."
* Note: Macros can be a security risk. If this API is used to create a workbook that includes a macro, the add-in user will be prompted with a "Trust this add-in?" dialog in the Excel UI. The user must select the "Trust add-in" button to proceed.
*
* [Api set: ExcelApi 1.8]
diff --git a/generate-docs/api-extractor-inputs-excel-release/Excel_online/excel.d.ts b/generate-docs/api-extractor-inputs-excel-release/Excel_online/excel.d.ts
index 55cb28de5..216103776 100644
--- a/generate-docs/api-extractor-inputs-excel-release/Excel_online/excel.d.ts
+++ b/generate-docs/api-extractor-inputs-excel-release/Excel_online/excel.d.ts
@@ -6061,7 +6061,7 @@ export declare namespace Excel {
provider?: CellValueProviderAttributes;
}
/**
- * Represents the value of a cell containing a #N/A! error.
+ * Represents the value of a cell containing a #N/A error.
*
* @remarks
* [Api set: ExcelApi 1.16]
@@ -6082,7 +6082,7 @@ export declare namespace Excel {
* @remarks
* [Api set: ExcelApi 1.16]
*/
- basicValue?: "#N/A!" | string;
+ basicValue?: "#N/A" | string;
/**
* Represents the value that would be returned by `Range.valueTypes` for a cell with this value.
*
@@ -7294,6 +7294,7 @@ export declare namespace Excel {
/**
*
* Creates and opens a new workbook. Optionally, the workbook can be pre-populated with a Base64-encoded .xlsx file.
+ * The `extensionHardening` Windows registry key affects the `base64File` param. The file extension defined by the param must match the real file type of the file. If `extensionHardening` is set to deny mismatches and the file extension does not match the real file type, this API throws the following error: "This operation is not allowed due to the extension hardening policy."
* Note: Macros can be a security risk. If this API is used to create a workbook that includes a macro, the add-in user will be prompted with a "Trust this add-in?" dialog in the Excel UI. The user must select the "Trust add-in" button to proceed.
*
* [Api set: ExcelApi 1.8]
@@ -10958,11 +10959,12 @@ export declare namespace Excel {
getSelectedRanges(): Excel.RangeAreas;
/**
* Inserts the specified worksheets from a source workbook into the current workbook.
-
- **Note**: This API is currently only supported for Office on Windows, Mac, and the web.
+ * The `extensionHardening` Windows registry key affects this API. The file extension defined by the `base64File` param must match the real file type of the inserted file. If `extensionHardening` is set to deny mismatches and the file extension does not match the real file type, this API throws the following error: "This operation is not allowed due to the extension hardening policy."
*
* @remarks
* [Api set: ExcelApi 1.13]
+ *
+ * This API is currently only supported for Office on Windows, Mac, and the web.
*
* @param base64File - Required. The Base64-encoded string representing the source workbook file.
* @param options - Optional. The options that define which worksheets to insert and where in the workbook the new worksheets will be inserted. By default, all the worksheets from the source workbook are inserted at the end of the current workbook.
@@ -12900,7 +12902,7 @@ export declare namespace Excel {
*/
getEntireRow(): Excel.Range;
/**
- * Returns a range object that includes the current range and up to the edge of the range, based on the provided direction. This matches the Ctrl+Shift+Arrow key behavior in the Excel on Windows UI.
+ * Returns a range object that includes the current range and up to the edge of the range, based on the provided direction. This matches the Ctrl+Shift+Arrow key behavior in the Excel on Windows UI.
*
* @remarks
* [Api set: ExcelApi 1.13]
@@ -12910,7 +12912,7 @@ export declare namespace Excel {
*/
getExtendedRange(direction: Excel.KeyboardDirection, activeCell?: Range | string): Excel.Range;
/**
- * Returns a range object that includes the current range and up to the edge of the range, based on the provided direction. This matches the Ctrl+Shift+Arrow key behavior in the Excel on Windows UI.
+ * Returns a range object that includes the current range and up to the edge of the range, based on the provided direction. This matches the Ctrl+Shift+Arrow key behavior in the Excel on Windows UI.
*
* @remarks
* [Api set: ExcelApi 1.13]
@@ -13005,7 +13007,7 @@ export declare namespace Excel {
*/
getPrecedents(): Excel.WorkbookRangeAreas;
/**
- * Returns a range object that is the edge cell of the data region that corresponds to the provided direction. This matches the Ctrl+Arrow key behavior in the Excel on Windows UI.
+ * Returns a range object that is the edge cell of the data region that corresponds to the provided direction. This matches the Ctrl+Arrow key behavior in the Excel on Windows UI.
*
* @remarks
* [Api set: ExcelApi 1.13]
@@ -13015,7 +13017,7 @@ export declare namespace Excel {
*/
getRangeEdge(direction: Excel.KeyboardDirection, activeCell?: Range | string): Excel.Range;
/**
- * Returns a range object that is the edge cell of the data region that corresponds to the provided direction. This matches the Ctrl+Arrow key behavior in the Excel on Windows UI.
+ * Returns a range object that is the edge cell of the data region that corresponds to the provided direction. This matches the Ctrl+Arrow key behavior in the Excel on Windows UI.
*
* @remarks
* [Api set: ExcelApi 1.13]
diff --git a/generate-docs/api-extractor-inputs-excel/excel.d.ts b/generate-docs/api-extractor-inputs-excel/excel.d.ts
index 7d73000ee..f751a4db0 100644
--- a/generate-docs/api-extractor-inputs-excel/excel.d.ts
+++ b/generate-docs/api-extractor-inputs-excel/excel.d.ts
@@ -6773,7 +6773,7 @@ export declare namespace Excel {
cachedUid: string;
}
/**
- * Represents types of #N/A! errors.
+ * Represents types of #N/A errors.
*
* @remarks
* [Api set: ExcelApi BETA (PREVIEW ONLY)]
@@ -6781,7 +6781,7 @@ export declare namespace Excel {
*/
enum NotAvailableErrorCellValueSubType {
/**
- * An unknown type of error. Displays as error type #N/A! in Excel.
+ * An unknown type of error. Displays as error type #N/A in Excel.
*
* @remarks
* [Api set: ExcelApi BETA (PREVIEW ONLY)]
@@ -6789,7 +6789,7 @@ export declare namespace Excel {
*/
unknown = "Unknown",
/**
- * An error caused by `VLOOKUP` not finding its `lookup_value` in the search range. Displays as error type #N/A! in Excel.
+ * An error caused by `VLOOKUP` not finding its `lookup_value` in the search range. Displays as error type #N/A in Excel.
*
* @remarks
* [Api set: ExcelApi BETA (PREVIEW ONLY)]
@@ -6797,7 +6797,7 @@ export declare namespace Excel {
*/
vlookupValueNotFound = "VlookupValueNotFound",
/**
- * An error caused by `HLOOKUP` not finding its `lookup_value` in the search range. Displays as error type #N/A! in Excel.
+ * An error caused by `HLOOKUP` not finding its `lookup_value` in the search range. Displays as error type #N/A in Excel.
*
* @remarks
* [Api set: ExcelApi BETA (PREVIEW ONLY)]
@@ -6805,7 +6805,7 @@ export declare namespace Excel {
*/
hlookupValueNotFound = "HlookupValueNotFound",
/**
- * An error caused by an invalid property argument to `STOCKHISTORY`. Displays as error type #N/A! in Excel.
+ * An error caused by an invalid property argument to `STOCKHISTORY`. Displays as error type #N/A in Excel.
*
* @remarks
* [Api set: ExcelApi BETA (PREVIEW ONLY)]
@@ -6813,7 +6813,7 @@ export declare namespace Excel {
*/
stockHistoryInvalidProperty = "StockHistoryInvalidProperty",
/**
- * An error caused by no data being available for a `STOCKHISTORY` function. Displays as error type #N/A! in Excel.
+ * An error caused by no data being available for a `STOCKHISTORY` function. Displays as error type #N/A in Excel.
*
* @remarks
* [Api set: ExcelApi BETA (PREVIEW ONLY)]
@@ -6821,7 +6821,7 @@ export declare namespace Excel {
*/
stockHistoryNoData = "StockHistoryNoData",
/**
- * An error caused by an external code service returning an unknown object. Displays as error type #N/A! in Excel.
+ * An error caused by an external code service returning an unknown object. Displays as error type #N/A in Excel.
*
* @remarks
* [Api set: ExcelApi BETA (PREVIEW ONLY)]
@@ -6829,7 +6829,7 @@ export declare namespace Excel {
*/
pythonObjectUnknown = "PythonObjectUnknown",
/**
- * No match was found for the pattern in the text provided. Displays as error type #N/A! in Excel.
+ * No match was found for the pattern in the text provided. Displays as error type #N/A in Excel.
*
* @remarks
* [Api set: ExcelApi BETA (PREVIEW ONLY)]
@@ -6837,7 +6837,7 @@ export declare namespace Excel {
*/
eRegexMatchNoResult = "ERegexMatchNoResult",
/**
- * Occurrence is greater than the total number of matches. Displays as error type #N/A! in Excel.
+ * Occurrence is greater than the total number of matches. Displays as error type #N/A in Excel.
*
* @remarks
* [Api set: ExcelApi BETA (PREVIEW ONLY)]
@@ -6845,7 +6845,7 @@ export declare namespace Excel {
*/
eRegexReplaceOccurrenceNoResult = "ERegexReplaceOccurrenceNoResult",
/**
- * No capture groups were matched. Displays as error type #N/A! in Excel.
+ * No capture groups were matched. Displays as error type #N/A in Excel.
*
* @remarks
* [Api set: ExcelApi BETA (PREVIEW ONLY)]
@@ -6854,7 +6854,7 @@ export declare namespace Excel {
eRegexMatchNoCapture = "ERegexMatchNoCapture"
}
/**
- * Represents the value of a cell containing a #N/A! error.
+ * Represents the value of a cell containing a #N/A error.
*
* @remarks
* [Api set: ExcelApi 1.16]
@@ -6875,7 +6875,7 @@ export declare namespace Excel {
* @remarks
* [Api set: ExcelApi 1.16]
*/
- basicValue?: "#N/A!" | string;
+ basicValue?: "#N/A" | string;
/**
* Represents the value that would be returned by `Range.valueTypes` for a cell with this value.
*
@@ -8956,6 +8956,7 @@ export declare namespace Excel {
/**
*
* Creates and opens a new workbook. Optionally, the workbook can be pre-populated with a Base64-encoded .xlsx file.
+ * The `extensionHardening` Windows registry key affects the `base64File` param. The file extension defined by the param must match the real file type of the file. If `extensionHardening` is set to deny mismatches and the file extension does not match the real file type, this API throws the following error: "This operation is not allowed due to the extension hardening policy."
* Note: Macros can be a security risk. If this API is used to create a workbook that includes a macro, the add-in user will be prompted with a "Trust this add-in?" dialog in the Excel UI. The user must select the "Trust add-in" button to proceed.
*
* [Api set: ExcelApi 1.8]
@@ -14561,11 +14562,12 @@ export declare namespace Excel {
getSelectedRanges(): Excel.RangeAreas;
/**
* Inserts the specified worksheets from a source workbook into the current workbook.
-
- **Note**: This API is currently only supported for Office on Windows, Mac, and the web.
+ * The `extensionHardening` Windows registry key affects this API. The file extension defined by the `base64File` param must match the real file type of the inserted file. If `extensionHardening` is set to deny mismatches and the file extension does not match the real file type, this API throws the following error: "This operation is not allowed due to the extension hardening policy."
*
* @remarks
* [Api set: ExcelApi 1.13]
+ *
+ * This API is currently only supported for Office on Windows, Mac, and the web.
*
* @param base64File - Required. The Base64-encoded string representing the source workbook file.
* @param options - Optional. The options that define which worksheets to insert and where in the workbook the new worksheets will be inserted. By default, all the worksheets from the source workbook are inserted at the end of the current workbook.
@@ -16563,7 +16565,7 @@ export declare namespace Excel {
*/
getEntireRow(): Excel.Range;
/**
- * Returns a range object that includes the current range and up to the edge of the range, based on the provided direction. This matches the Ctrl+Shift+Arrow key behavior in the Excel on Windows UI.
+ * Returns a range object that includes the current range and up to the edge of the range, based on the provided direction. This matches the Ctrl+Shift+Arrow key behavior in the Excel on Windows UI.
*
* @remarks
* [Api set: ExcelApi 1.13]
@@ -16573,7 +16575,7 @@ export declare namespace Excel {
*/
getExtendedRange(direction: Excel.KeyboardDirection, activeCell?: Range | string): Excel.Range;
/**
- * Returns a range object that includes the current range and up to the edge of the range, based on the provided direction. This matches the Ctrl+Shift+Arrow key behavior in the Excel on Windows UI.
+ * Returns a range object that includes the current range and up to the edge of the range, based on the provided direction. This matches the Ctrl+Shift+Arrow key behavior in the Excel on Windows UI.
*
* @remarks
* [Api set: ExcelApi 1.13]
@@ -16668,7 +16670,7 @@ export declare namespace Excel {
*/
getPrecedents(): Excel.WorkbookRangeAreas;
/**
- * Returns a range object that is the edge cell of the data region that corresponds to the provided direction. This matches the Ctrl+Arrow key behavior in the Excel on Windows UI.
+ * Returns a range object that is the edge cell of the data region that corresponds to the provided direction. This matches the Ctrl+Arrow key behavior in the Excel on Windows UI.
*
* @remarks
* [Api set: ExcelApi 1.13]
@@ -16678,7 +16680,7 @@ export declare namespace Excel {
*/
getRangeEdge(direction: Excel.KeyboardDirection, activeCell?: Range | string): Excel.Range;
/**
- * Returns a range object that is the edge cell of the data region that corresponds to the provided direction. This matches the Ctrl+Arrow key behavior in the Excel on Windows UI.
+ * Returns a range object that is the edge cell of the data region that corresponds to the provided direction. This matches the Ctrl+Arrow key behavior in the Excel on Windows UI.
*
* @remarks
* [Api set: ExcelApi 1.13]
diff --git a/generate-docs/script-inputs/office.d.ts b/generate-docs/script-inputs/office.d.ts
index b52e16cc7..8c2781eca 100644
--- a/generate-docs/script-inputs/office.d.ts
+++ b/generate-docs/script-inputs/office.d.ts
@@ -30805,7 +30805,7 @@ declare namespace Excel {
provider?: CellValueProviderAttributes;
}
/**
- * Represents the value of a cell containing a #N/A! error.
+ * Represents the value of a cell containing a #N/A error.
*
* @remarks
* [Api set: ExcelApi 1.16]
@@ -30826,7 +30826,7 @@ declare namespace Excel {
* @remarks
* [Api set: ExcelApi 1.16]
*/
- basicValue?: "#N/A!" | string;
+ basicValue?: "#N/A" | string;
/**
* Represents the value that would be returned by `Range.valueTypes` for a cell with this value.
*
@@ -32038,6 +32038,7 @@ declare namespace Excel {
/**
*
* Creates and opens a new workbook. Optionally, the workbook can be pre-populated with a Base64-encoded .xlsx file.
+ * The `extensionHardening` Windows registry key affects the `base64File` param. The file extension defined by the param must match the real file type of the file. If `extensionHardening` is set to deny mismatches and the file extension does not match the real file type, this API throws the following error: "This operation is not allowed due to the extension hardening policy."
* Note: Macros can be a security risk. If this API is used to create a workbook that includes a macro, the add-in user will be prompted with a "Trust this add-in?" dialog in the Excel UI. The user must select the "Trust add-in" button to proceed.
*
* [Api set: ExcelApi 1.8]
@@ -35680,11 +35681,12 @@ declare namespace Excel {
getSelectedRanges(): Excel.RangeAreas;
/**
* Inserts the specified worksheets from a source workbook into the current workbook.
-
- **Note**: This API is currently only supported for Office on Windows, Mac, and the web.
+ * The `extensionHardening` Windows registry key affects this API. The file extension defined by the `base64File` param must match the real file type of the inserted file. If `extensionHardening` is set to deny mismatches and the file extension does not match the real file type, this API throws the following error: "This operation is not allowed due to the extension hardening policy."
*
* @remarks
* [Api set: ExcelApi 1.13]
+ *
+ * This API is currently only supported for Office on Windows, Mac, and the web.
*
* @param base64File Required. The Base64-encoded string representing the source workbook file.
* @param options Optional. The options that define which worksheets to insert and where in the workbook the new worksheets will be inserted. By default, all the worksheets from the source workbook are inserted at the end of the current workbook.
@@ -37622,7 +37624,7 @@ declare namespace Excel {
*/
getEntireRow(): Excel.Range;
/**
- * Returns a range object that includes the current range and up to the edge of the range, based on the provided direction. This matches the Ctrl+Shift+Arrow key behavior in the Excel on Windows UI.
+ * Returns a range object that includes the current range and up to the edge of the range, based on the provided direction. This matches the Ctrl+Shift+Arrow key behavior in the Excel on Windows UI.
*
* @remarks
* [Api set: ExcelApi 1.13]
@@ -37632,7 +37634,7 @@ declare namespace Excel {
*/
getExtendedRange(direction: Excel.KeyboardDirection, activeCell?: Range | string): Excel.Range;
/**
- * Returns a range object that includes the current range and up to the edge of the range, based on the provided direction. This matches the Ctrl+Shift+Arrow key behavior in the Excel on Windows UI.
+ * Returns a range object that includes the current range and up to the edge of the range, based on the provided direction. This matches the Ctrl+Shift+Arrow key behavior in the Excel on Windows UI.
*
* @remarks
* [Api set: ExcelApi 1.13]
@@ -37727,7 +37729,7 @@ declare namespace Excel {
*/
getPrecedents(): Excel.WorkbookRangeAreas;
/**
- * Returns a range object that is the edge cell of the data region that corresponds to the provided direction. This matches the Ctrl+Arrow key behavior in the Excel on Windows UI.
+ * Returns a range object that is the edge cell of the data region that corresponds to the provided direction. This matches the Ctrl+Arrow key behavior in the Excel on Windows UI.
*
* @remarks
* [Api set: ExcelApi 1.13]
@@ -37737,7 +37739,7 @@ declare namespace Excel {
*/
getRangeEdge(direction: Excel.KeyboardDirection, activeCell?: Range | string): Excel.Range;
/**
- * Returns a range object that is the edge cell of the data region that corresponds to the provided direction. This matches the Ctrl+Arrow key behavior in the Excel on Windows UI.
+ * Returns a range object that is the edge cell of the data region that corresponds to the provided direction. This matches the Ctrl+Arrow key behavior in the Excel on Windows UI.
*
* @remarks
* [Api set: ExcelApi 1.13]
diff --git a/generate-docs/script-inputs/office_preview.d.ts b/generate-docs/script-inputs/office_preview.d.ts
index ad4a63670..5babeff85 100644
--- a/generate-docs/script-inputs/office_preview.d.ts
+++ b/generate-docs/script-inputs/office_preview.d.ts
@@ -31880,7 +31880,7 @@ declare namespace Excel {
cachedUid: string;
}
/**
- * Represents types of #N/A! errors.
+ * Represents types of #N/A errors.
*
* @remarks
* [Api set: ExcelApi BETA (PREVIEW ONLY)]
@@ -31888,7 +31888,7 @@ declare namespace Excel {
*/
enum NotAvailableErrorCellValueSubType {
/**
- * An unknown type of error. Displays as error type #N/A! in Excel.
+ * An unknown type of error. Displays as error type #N/A in Excel.
*
* @remarks
* [Api set: ExcelApi BETA (PREVIEW ONLY)]
@@ -31896,7 +31896,7 @@ declare namespace Excel {
*/
unknown = "Unknown",
/**
- * An error caused by `VLOOKUP` not finding its `lookup_value` in the search range. Displays as error type #N/A! in Excel.
+ * An error caused by `VLOOKUP` not finding its `lookup_value` in the search range. Displays as error type #N/A in Excel.
*
* @remarks
* [Api set: ExcelApi BETA (PREVIEW ONLY)]
@@ -31904,7 +31904,7 @@ declare namespace Excel {
*/
vlookupValueNotFound = "VlookupValueNotFound",
/**
- * An error caused by `HLOOKUP` not finding its `lookup_value` in the search range. Displays as error type #N/A! in Excel.
+ * An error caused by `HLOOKUP` not finding its `lookup_value` in the search range. Displays as error type #N/A in Excel.
*
* @remarks
* [Api set: ExcelApi BETA (PREVIEW ONLY)]
@@ -31912,7 +31912,7 @@ declare namespace Excel {
*/
hlookupValueNotFound = "HlookupValueNotFound",
/**
- * An error caused by an invalid property argument to `STOCKHISTORY`. Displays as error type #N/A! in Excel.
+ * An error caused by an invalid property argument to `STOCKHISTORY`. Displays as error type #N/A in Excel.
*
* @remarks
* [Api set: ExcelApi BETA (PREVIEW ONLY)]
@@ -31920,7 +31920,7 @@ declare namespace Excel {
*/
stockHistoryInvalidProperty = "StockHistoryInvalidProperty",
/**
- * An error caused by no data being available for a `STOCKHISTORY` function. Displays as error type #N/A! in Excel.
+ * An error caused by no data being available for a `STOCKHISTORY` function. Displays as error type #N/A in Excel.
*
* @remarks
* [Api set: ExcelApi BETA (PREVIEW ONLY)]
@@ -31928,7 +31928,7 @@ declare namespace Excel {
*/
stockHistoryNoData = "StockHistoryNoData",
/**
- * An error caused by an external code service returning an unknown object. Displays as error type #N/A! in Excel.
+ * An error caused by an external code service returning an unknown object. Displays as error type #N/A in Excel.
*
* @remarks
* [Api set: ExcelApi BETA (PREVIEW ONLY)]
@@ -31936,7 +31936,7 @@ declare namespace Excel {
*/
pythonObjectUnknown = "PythonObjectUnknown",
/**
- * No match was found for the pattern in the text provided. Displays as error type #N/A! in Excel.
+ * No match was found for the pattern in the text provided. Displays as error type #N/A in Excel.
*
* @remarks
* [Api set: ExcelApi BETA (PREVIEW ONLY)]
@@ -31944,7 +31944,7 @@ declare namespace Excel {
*/
eRegexMatchNoResult = "ERegexMatchNoResult",
/**
- * Occurrence is greater than the total number of matches. Displays as error type #N/A! in Excel.
+ * Occurrence is greater than the total number of matches. Displays as error type #N/A in Excel.
*
* @remarks
* [Api set: ExcelApi BETA (PREVIEW ONLY)]
@@ -31952,7 +31952,7 @@ declare namespace Excel {
*/
eRegexReplaceOccurrenceNoResult = "ERegexReplaceOccurrenceNoResult",
/**
- * No capture groups were matched. Displays as error type #N/A! in Excel.
+ * No capture groups were matched. Displays as error type #N/A in Excel.
*
* @remarks
* [Api set: ExcelApi BETA (PREVIEW ONLY)]
@@ -31961,7 +31961,7 @@ declare namespace Excel {
eRegexMatchNoCapture = "ERegexMatchNoCapture"
}
/**
- * Represents the value of a cell containing a #N/A! error.
+ * Represents the value of a cell containing a #N/A error.
*
* @remarks
* [Api set: ExcelApi 1.16]
@@ -31982,7 +31982,7 @@ declare namespace Excel {
* @remarks
* [Api set: ExcelApi 1.16]
*/
- basicValue?: "#N/A!" | string;
+ basicValue?: "#N/A" | string;
/**
* Represents the value that would be returned by `Range.valueTypes` for a cell with this value.
*
@@ -34063,6 +34063,7 @@ declare namespace Excel {
/**
*
* Creates and opens a new workbook. Optionally, the workbook can be pre-populated with a Base64-encoded .xlsx file.
+ * The `extensionHardening` Windows registry key affects the `base64File` param. The file extension defined by the param must match the real file type of the file. If `extensionHardening` is set to deny mismatches and the file extension does not match the real file type, this API throws the following error: "This operation is not allowed due to the extension hardening policy."
* Note: Macros can be a security risk. If this API is used to create a workbook that includes a macro, the add-in user will be prompted with a "Trust this add-in?" dialog in the Excel UI. The user must select the "Trust add-in" button to proceed.
*
* [Api set: ExcelApi 1.8]
@@ -39646,11 +39647,12 @@ declare namespace Excel {
getSelectedRanges(): Excel.RangeAreas;
/**
* Inserts the specified worksheets from a source workbook into the current workbook.
-
- **Note**: This API is currently only supported for Office on Windows, Mac, and the web.
+ * The `extensionHardening` Windows registry key affects this API. The file extension defined by the `base64File` param must match the real file type of the inserted file. If `extensionHardening` is set to deny mismatches and the file extension does not match the real file type, this API throws the following error: "This operation is not allowed due to the extension hardening policy."
*
* @remarks
* [Api set: ExcelApi 1.13]
+ *
+ * This API is currently only supported for Office on Windows, Mac, and the web.
*
* @param base64File Required. The Base64-encoded string representing the source workbook file.
* @param options Optional. The options that define which worksheets to insert and where in the workbook the new worksheets will be inserted. By default, all the worksheets from the source workbook are inserted at the end of the current workbook.
@@ -41648,7 +41650,7 @@ declare namespace Excel {
*/
getEntireRow(): Excel.Range;
/**
- * Returns a range object that includes the current range and up to the edge of the range, based on the provided direction. This matches the Ctrl+Shift+Arrow key behavior in the Excel on Windows UI.
+ * Returns a range object that includes the current range and up to the edge of the range, based on the provided direction. This matches the Ctrl+Shift+Arrow key behavior in the Excel on Windows UI.
*
* @remarks
* [Api set: ExcelApi 1.13]
@@ -41658,7 +41660,7 @@ declare namespace Excel {
*/
getExtendedRange(direction: Excel.KeyboardDirection, activeCell?: Range | string): Excel.Range;
/**
- * Returns a range object that includes the current range and up to the edge of the range, based on the provided direction. This matches the Ctrl+Shift+Arrow key behavior in the Excel on Windows UI.
+ * Returns a range object that includes the current range and up to the edge of the range, based on the provided direction. This matches the Ctrl+Shift+Arrow key behavior in the Excel on Windows UI.
*
* @remarks
* [Api set: ExcelApi 1.13]
@@ -41753,7 +41755,7 @@ declare namespace Excel {
*/
getPrecedents(): Excel.WorkbookRangeAreas;
/**
- * Returns a range object that is the edge cell of the data region that corresponds to the provided direction. This matches the Ctrl+Arrow key behavior in the Excel on Windows UI.
+ * Returns a range object that is the edge cell of the data region that corresponds to the provided direction. This matches the Ctrl+Arrow key behavior in the Excel on Windows UI.
*
* @remarks
* [Api set: ExcelApi 1.13]
@@ -41763,7 +41765,7 @@ declare namespace Excel {
*/
getRangeEdge(direction: Excel.KeyboardDirection, activeCell?: Range | string): Excel.Range;
/**
- * Returns a range object that is the edge cell of the data region that corresponds to the provided direction. This matches the Ctrl+Arrow key behavior in the Excel on Windows UI.
+ * Returns a range object that is the edge cell of the data region that corresponds to the provided direction. This matches the Ctrl+Arrow key behavior in the Excel on Windows UI.
*
* @remarks
* [Api set: ExcelApi 1.13]