Skip to content

Commit 5308886

Browse files
[excel] (File storage) Conditional Access policies and Office Scripts (#643)
* Conditional Access * Add links from file article * Adding additional error message and fixing typo * Remove error message that won't surface * Update docs/overview/script-storage.md missing a period --------- Co-authored-by: Linda Cannon <[email protected]>
1 parent 0d76b21 commit 5308886

File tree

4 files changed

+23
-11
lines changed

4 files changed

+23
-11
lines changed

docs/overview/script-storage.md

Lines changed: 5 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: Office Scripts file storage and ownership
33
description: Information about how Office Scripts are stored in Microsoft OneDrive and transferred between owners.
4-
ms.date: 08/29/2023
4+
ms.date: 09/08/2023
55
ms.localizationpriority: medium
66
---
77

@@ -11,6 +11,9 @@ Office Scripts are stored as **.osts** files in your Microsoft OneDrive or a Sha
1111

1212
Excel only recognizes and runs a script if it's in your OneDrive folder, a Sharepoint folder, or shared with the workbook. This means Excel needs internet connectivity to access Office Scripts.
1313

14+
> [!NOTE]
15+
> Admin settings for Conditional Access in OneDrive and SharePoint affect Office Scripts. For more information, see the [Conditional Access section of Platform limits and requirements with Office Scripts](../testing/platform-limits.md#conditional-access).
16+
1417
## OneDrive
1518

1619
The default behavior is that Office Scripts are stored in your OneDrive. The **.osts** files are found in the **/Documents/Office Scripts/** folder. Any edits made to these **.osts** files, such as renaming or deleting files, will be reflected in the Code Editor and Script Gallery.
@@ -37,7 +40,7 @@ To save a copy of a script to SharePoint, go to the **More options (…)** menu
3740
3841
## Restore deleted scripts
3942

40-
When you delete a script in Excel, it goes to your OneDrive or SharePoint recycle bin. To restore a deleted script, follow the steps listed in [How to recover missing, deleted or corrupted items in SharePoint and OneDrive for work or school](https://support.microsoft.com/office/how-to-recover-missing-deleted-or-corrupted-items-in-sharepoint-and-onedrive-for-work-or-school-3d748edf-c072-46c9-81a4-4989056ebc87). Restoring an **.osts** file returns it to the **All scripts** list.
43+
When you delete a script in Excel, it goes to your OneDrive or SharePoint recycle bin. To restore a deleted script, follow the steps listed in [How to recover missing, deleted or corrupted items in SharePoint and OneDrive for work or school](https://support.microsoft.com/office/3d748edf-c072-46c9-81a4-4989056ebc87). Restoring an **.osts** file returns it to the **All scripts** list.
4144

4245
A deleted script is unshared with the workbook. When you restore a script, it does **not** retain its script access. You will need to share the script again.
4346

docs/testing/platform-limits.md

Lines changed: 10 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: Platform limits and requirements with Office Scripts
33
description: Resource limits and browser support for Office Scripts when used with Excel.
44
ms.topic: limits-and-quotas
5-
ms.date: 04/20/2023
5+
ms.date: 09/08/2023
66
ms.localizationpriority: medium
77
---
88

@@ -76,6 +76,15 @@ Your browser needs third-party cookies enabled to show the **Automate** tab in E
7676
- [Firefox](https://support.mozilla.org/kb/disable-third-party-cookies)
7777
- [Safari](https://support.apple.com/guide/safari/manage-cookies-and-website-data-sfri11471/mac)
7878

79+
## Conditional Access
80+
81+
[Conditional Access](/azure/active-directory/conditional-access/overview) policies can restrict access to SharePoint and OneDrive for [unmanaged devices](/sharepoint/control-access-from-unmanaged-devices). If your device isn't managed by the tenant, you may not have access to specific scripts, or may only be able to access them through the browser.
82+
83+
If you script is blocked by Conditional Access policies, you'll receive one of two error messages. These messages also surface in Power Automate if your flow is run from an unmanaged device.
84+
85+
- "Due to organizational policies, you can’t access this resource from this untrusted device."
86+
- "We can't find this script. It may have been deleted by another user." (If your version of Excel is older.)
87+
7988
## API support on older Excel versions
8089

8190
Some Office Scripts APIs may not be supported by Excel for Windows or Excel for Mac, especially older builds. These include newer APIs and APIs for web-only features. If a script contains unsupported APIs, the Code Editor displays a warning. If you try to run such a script, it won't run. Instead, the **Script Run Status** task pane displays a warning message that says, "This script currently must be run on Excel for the web. Open the workbook in the browser then try again, or contact the script owner for help."

docs/testing/power-automate-troubleshooting.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -2,13 +2,13 @@
22
title: Troubleshoot Office Scripts running in Power Automate
33
description: Tips, platform information, and known issues with the integration between Office Scripts and Power Automate.
44
ms.topic: troubleshooting-general
5-
ms.date: 04/20/2023
5+
ms.date: 09/08/2023
66
ms.localizationpriority: medium
77
---
88

99
# Troubleshoot Office Scripts running in Power Automate
1010

11-
Power Automate lets you take your Office Script automation to the next level. However, because Power Automate runs scripts on your behalf in independent Excel sessions, there are a few important things to note.
11+
Power Automate runs scripts on your behalf in independent Excel sessions. This causes some behavioral changes that may create issues with certain scripts or scenarios. There are also limitations and behaviors from the Power Automate platform script writers should know. Be sure to read the articles [Troubleshoot Office Scripts](troubleshooting.md) and [Platform limits and requirements with Office Scripts](platform-limits.md), as much of that information also applies to scripts in flows.
1212

1313
> [!TIP]
1414
> If you're just starting to use Office Scripts with Power Automate, please start with [Run Office Scripts with Power Automate](../develop/power-automate-integration.md) to learn about the platforms.

docs/testing/troubleshooting.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: Troubleshoot Office Scripts
33
description: Debugging tips and techniques for Office Scripts, as well as help resources.
44
ms.topic: troubleshooting-general
5-
ms.date: 02/24/2023
5+
ms.date: 09/08/2023
66
ms.localizationpriority: medium
77
---
88

@@ -13,7 +13,11 @@ As you develop Office Scripts, you may make mistakes. It's okay. You have the to
1313
> [!NOTE]
1414
> For troubleshooting advice specific to Office Scripts with Power Automate, see [Troubleshoot Office Scripts running in Power Automate](power-automate-troubleshooting.md).
1515
16-
## Types of errors
16+
## Platform limits and requirements
17+
18+
For a detailed list of limitations on the Office Scripts platform due to Excel, Power Automate, or other technologies, see [Platform limits and requirements with Office Scripts](platform-limits.md).
19+
20+
## Script errors
1721

1822
Office Scripts errors fall into one of two categories:
1923

@@ -82,10 +86,6 @@ The following steps should help troubleshoot any problems related to the **Autom
8286
> [!NOTE]
8387
> There is a known issue that prevents scripts stored in SharePoint from always appearing in the recently used list. This occurs when your admin turns off Exchange Web Services (EWS). Your SharePoint-based scripts are still accessible and usable through the file dialog.
8488
85-
## Platform limits
86-
87-
For a detailed list of limitations on the Office Scripts platform due to Excel, Power Automate, or other tools, see [Platform limits and requirements with Office Scripts](./platform-limits.md).
88-
8989
## Help resources
9090

9191
[Stack Overflow](https://stackoverflow.com/questions/tagged/office-scripts) is a community of developers willing to help with coding problems. Often, you'll be able to find the solution to your problem through a quick Stack Overflow search. If not, ask your question and tag it with the "office-scripts" tag. Be sure to mention you're creating an Office *Script*, not an Office *Add-in*.

0 commit comments

Comments
 (0)