Merge pull request #701 from OfficeDev/main

[admin] Publish

Author: AlexJerabek

docs/develop/power-automate-integration.md

@@ -10,6 +10,8 @@ ms.localizationpriority: medium
 
 [Power Automate](https://make.powerautomate.com) lets you add Office Scripts to a larger, automated workflow. You can use Power Automate to do things like add the contents of an email to a worksheet's table or create actions in your project management tools based on workbook comments.
 
+[!INCLUDE [Power Automate needs a business license](../includes/power-automate-needs-business.md)]
+
 ## Get started
 
 If you are new to Power Automate, we recommend visiting [Get started with Power Automate](/power-automate/getting-started). There, you can learn more about all the automation possibilities available to you. The documents here focus on how Office Scripts work with Power Automate and how that can help improve your Excel experience.

docs/includes/platform-requirements.md

@@ -1,5 +1,7 @@
 To use Office Scripts, you'll need the following.
 
+# [For business and education](#tab/business)
+
 1. Excel for Windows (version 2210 or higher), Excel for Mac, or Excel on the web.
     - *The [Action Recorder](../overview/excel.md#action-recorder) is not yet available in the [Semi-Annual Enterprise Channel](/deployoffice/updates/overview-update-channels#semi-annual-enterprise-channel-overview).*
 1. OneDrive for Business.
@@ -14,5 +16,12 @@ To use Office Scripts, you'll need the following.
     - Office 365 A5
 1. Internet connectivity with [connected experiences](/deployoffice/privacy/connected-experiences) enabled.
 
-> [!NOTE]
-> If you meet these requirements and are still not seeing the **Automate** tab, it's possible that your admin has disabled the feature or there's some other problem with your environment. Please follow the steps under [Automate tab not appearing or Office Scripts unavailable](../testing/troubleshooting.md#automate-tab-not-appearing-or-office-scripts-unavailable) to start using Office Scripts.
+# [For personal and family](#tab/home)
+
+> [!IMPORTANT]
+> Office Scripts is in preview for personal and family Microsoft 365 subscriptions. If you encounter any issues, please report them through the Feedback button in Excel.
+
+1. Excel for Microsoft 365 or Excel on the web.
+1. Internet connectivity with [connected experiences](/deployoffice/privacy/connected-experiences) enabled.
+
+---

docs/includes/power-automate-needs-business.md

@@ -0,0 +1,2 @@
+> [!IMPORTANT]
+> To use Office Scripts in [Power Automate](https://make.powerautomate.com), you must have a [business license of Microsoft 365](../testing/platform-limits.md?tabs=business).

docs/includes/tutorial-prerequisites.md

@@ -1 +1 @@
-You'll need access to Office Scripts for this tutorial. Please review the [Platform support](/office/dev/scripts/testing/platform-limits#platform-support) if the Automate tab doesn't appear.
+You'll need access to Office Scripts for this tutorial. Please review the [Platform support](/office/dev/scripts/testing/platform-limits#platform-support) if the Automate tab doesn't appear.

docs/overview/excel.md

@@ -16,9 +16,6 @@ This series of documents teaches you how to use these tools. You'll find a wealt
 
 > [!VIDEO https://www.microsoft.com/videoplayer/embed/RE4qdFF]
 
-> [!NOTE]
-> Office Scripts requires a commercial or educational Microsoft 365 license. The complete requirement list is described under [Platform support](../testing/platform-limits.md#platform-support).
-
 ## When to use Office Scripts
 
 Scripts allow you to record and replay your Excel actions on different workbooks and worksheets. If you find yourself doing the same things over and over again, you can turn all that work into an easy-to-run Office Script. Run your script with a button in Excel or combine it with Power Automate to streamline your entire workflow.
@@ -48,7 +45,7 @@ Our [tutorials](../tutorials/excel-tutorial.md) provide a guided and structured
 
 ## Share Office Scripts
 
-Office Scripts can be shared with other users of an Excel workbook. When you share a script in a shared workbook, everyone with access to the workbook can also view and run your script. For more details about sharing and unsharing scripts, see [Sharing Office Scripts in Excel](https://support.microsoft.com/office/226eddbc-3a44-4540-acfe-fccda3d1122b).
+Office Scripts can be shared with other users in your organization. When you share a script in a shared workbook, team members with access to the workbook can also view and run your script. For more details about sharing and unsharing scripts, see [Sharing Office Scripts in Excel](https://support.microsoft.com/office/226eddbc-3a44-4540-acfe-fccda3d1122b).
 
 Add buttons that run scripts to help your colleagues discover your valuable solutions and let them run scripts straight from the workbook. Learn more about script buttons in [Run Office Scripts with buttons](../develop/script-buttons.md).
 

docs/overview/script-storage.md

@@ -1,28 +1,30 @@
 ---
 title: Office Scripts file storage and ownership
 description: Information about how Office Scripts are stored in Microsoft OneDrive and transferred between owners.
-ms.date: 09/08/2023
+ms.date: 01/10/2024
 ms.localizationpriority: medium
 ---
 
 # Office Scripts file storage and ownership
 
-Office Scripts are stored as **.osts** files in your Microsoft OneDrive or a SharePoint folder. They are stored separately from a workbook. To give users who are outside of the SharePoint site access to the script, [share the script with an Excel workbook](excel.md#share-office-scripts). This means you're linking the script with the file, not attaching it. Whoever has access to the Excel file will also be able to view, run, or make a copy of the script.
+The details of how scripts are stored and shared depend on your Microsoft 365 subscription. Select the relevant tab to learn more.
 
-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.
+> [!IMPORTANT]
+> Office Scripts is in preview for personal and family Microsoft 365 subscriptions. If you encounter any issues, please report them through the Feedback button in Excel.
 
-> [!NOTE]
-> 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).
+## File storage
+
+# [For business and education](#tab/business)
 
-## OneDrive
+Office Scripts are stored in your OneDrive by default. 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. 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.
 
-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.
+### OneDrive
 
 Scripts that are shared with one of your workbooks remain in the script creator's OneDrive. They are not copied to any of your local or OneDrive folders when you run the shared script in Excel. The **Move** button shown when renaming a script moves the script to a new location. The **Make a Copy** button of the Code Editor saves a separate copy of the script in your OneDrive. Changes to the copy don't affect the original script.
 
 Unless you share your personal scripts, no one else can access them. Your OneDrive settings control the shared access and permissions for all script **.osts** files, independent of any Excel settings. Scripts can't be linked from a local disk or custom cloud locations.
 
-## SharePoint
+### SharePoint
 
 Office Scripts that are saved to a SharePoint site are owned by your team. You and members of your organization with the appropriate access can run and edit scripts from SharePoint. You'll also see these scripts appear in the **Automate** tab's Script Gallery.
 
@@ -38,20 +40,61 @@ To save a copy of a script to SharePoint, go to the **More options (…)** menu
 > [!NOTE]
 > Power Automate supports running scripts stored on SharePoint with the **Run script from SharePoint library (Preview)** action. This action is currently in preview and is subject to change based on feedback. If you encounter any issues with this action, please report them through the **Help** > **Give Feedback** option in Power Automate.
 
+# [For personal and family](#tab/home)
+
+Scripts are stored in your local Office cache. The cache is in the following folder.
+
+```
+%LOCALAPPDATA%\Microsoft\Office\16.0\Wef\
+```
+
+---
+
+## Share scripts
+
+# [For business and education](#tab/business)
+
+To give users who are outside of the SharePoint site access to the script, [share the script with an Excel workbook](excel.md#share-office-scripts). This means you're linking the script with the file, not attaching it. Whoever has access to the Excel file will also be able to view, run, or make a copy of the script.
+
+> [!NOTE]
+> 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).
+
+# [For personal and family](#tab/home)
+
+Scripts can't be shared through workbooks with a home or family account. You can manually share the code, but it's not possible to share a script in Excel or receive notifications when it has been changed or updated.
+
+---
+
 ## Restore deleted scripts
 
+# [For business and education](#tab/business)
+
 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.
 
 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.
 
 Restored scripts still work as expected with Power Automate flows. You don't need to recreate the flow connector.
 
+# [For personal and family](#tab/home)
+
+Office Scripts are deleted permanently when removed in Excel. This behavior will change before the feature leaves the preview phase.
+
+---
+
 ## File ownership and retention
 
+# [For business and education](#tab/business)
+
 Office Scripts follow the retention and deletion policies specified by Microsoft OneDrive and Microsoft SharePoint. To learn how to handle scripts that were created and shared by a user being removed from your organization, see [Learn about retention for SharePoint and OneDrive](/microsoft-365/compliance/retention-policies-sharepoint?view=o365-worldwide&preserve-view=true).
 
 During editing, files are temporarily stored in the browser. You must save the script before closing the Excel window to save it to the OneDrive location. Don't forget to save the file after edits, or else those edits will only be in the browser's version of the file.
 
+# [For personal and family](#tab/home)
+
+Clearing the Office cache will remove all your scripts. Be sure to manually save your scripts elsewhere if the cache needs to be cleared.
+
+---
+
 ## Audit Office Scripts usage at the admin level
 
 Discover who is using Office Scripts in your organization with the compliance center audit log. Details about the audit log are found in [Search the audit log in the Security & Compliance Center](/microsoft-365/compliance/search-the-audit-log-in-security-and-compliance?view=o365-worldwide&preserve-view=true#search-the-audit-log).

docs/testing/platform-limits.md

@@ -14,6 +14,11 @@ There are some platform limitations of which you should be aware when developing
 
 [!INCLUDE [Platform requirements](../includes/platform-requirements.md)]
 
+> [!NOTE]
+> If you meet these requirements and are still not seeing the **Automate** tab, it's possible that your admin has disabled the feature or there's some other problem with your environment. Please follow the steps under [Automate tab not appearing or Office Scripts unavailable](../testing/troubleshooting.md#automate-tab-not-appearing-or-office-scripts-unavailable) to start using Office Scripts.
+
+To use Office Scripts in [Power Automate](https://make.powerautomate.com), you must have a business license of Microsoft 365.
+
 ## Data limits
 
 There are limits on how much Excel data can be transferred at once and how many individual Power Automate transactions can be conducted.

docs/testing/power-automate-troubleshooting.md

@@ -13,6 +13,8 @@ Power Automate runs scripts on your behalf in independent Excel sessions. This c
 > [!TIP]
 > 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.
 
+[!INCLUDE [Power Automate needs a business license](../includes/power-automate-needs-business.md)]
+
 ## Avoid relative references
 
 Power Automate runs your script in the chosen Excel workbook on your behalf. The workbook might be closed when this happens. Any API that relies on the user's current state, such as `Workbook.getActiveWorksheet`, may behave differently in Power Automate. This is because the APIs are based on a relative position of the user's view or cursor and that reference doesn't exist in a Power Automate flow.