Merge pull request #5065 from OfficeDev/main

[Admin] Publish

Author: davidchesnut

docs/images/script-lab-error-exchange-token.png

@@ -1,7 +1,7 @@
 ---
 title: Implement shared folders and shared mailbox scenarios in an Outlook add-in
 description: Discusses how to configure Outlook add-in support for shared folders (also known as delegate access) and shared mailboxes.
-ms.date: 10/29/2024
+ms.date: 02/20/2025
 ms.topic: how-to
 ms.localizationpriority: medium
 ---
@@ -18,15 +18,17 @@ This article describes how to implement shared folders (also known as delegate a
 The following table shows supported client-server combinations for this feature, including the minimum required Cumulative Update where applicable. Excluded combinations aren't supported.
 
 | Client | Exchange Online | Exchange 2019 on-premises<br>(Cumulative Update 1 or later) | Exchange 2016 on-premises<br>(Cumulative Update 6 or later) |
-|---|:---:|:---:|:---:|
-|**Web browser (modern Outlook UI)**|Supported|Not applicable|Not applicable|
-|**Web browser (classic Outlook UI)**|Not applicable|Not applicable|Not applicable|
+|---|---|---|---|
+|**Web browser (modern Outlook UI)**|Supported<sup>1</sup>|Not applicable|Not applicable|
+|**Web browser (classic Outlook UI)**|Not applicable|<ul><li>**Shared folders**: Supported</li><li>**Shared mailboxes**: Not applicable</li></ul>|<ul><li>**Shared folders**: Supported</li><li>**Shared mailboxes**: Not applicable</li></ul>|
 |[new Outlook on Windows](https://support.microsoft.com/office/656bb8d9-5a60-49b2-a98b-ba7822bc7627)|Supported|Not applicable|Not applicable|
-|**Windows (classic)**<br>**Shared folders**: Version 1910 (Build 12130.20272) or later<br><br>**Shared mailboxes**: Version 2304 (Build 16327.20248) or later|Supported|Supported\*|Supported\*|
+|**Windows (classic)**<br>**Shared folders**: Version 1910 (Build 12130.20272) or later<br><br>**Shared mailboxes**: Version 2304 (Build 16327.20248) or later|Supported|Supported<sup>2</sup>|Supported<sup>2</sup>|
 |**Mac**<br>Version 16.47 or later|Supported|Supported|Supported|
 
 > [!NOTE]
-> \* Support for this feature in an on-premises Exchange environment is available starting in classic Outlook on Windows Version 2206 (Build 15330.20000) for the Current Channel and Version 2207 (Build 15427.20000) for the Monthly Enterprise Channel.
+> <sup>1</sup>In Outlook on the web, if you open a shared mailbox in a separate browser tab or window using the **Open another mailbox** option, you may encounter issues when accessing add-ins from the mailbox. We recommend opening the mailbox in the same panel as your primary mailbox instead. This ensures that add-ins work as expected in your shared mailbox. If you prefer to open the shared mailbox using the **Open another mailbox** option, we recommend deploying the add-in to both your primary user and shared mailboxes.
+>
+> <sup>2</sup>Support for this feature in an on-premises Exchange environment is available starting in classic Outlook on Windows Version 2206 (Build 15330.20000) for the Current Channel and Version 2207 (Build 15427.20000) for the Monthly Enterprise Channel.
 
 ## Supported setups
 
@@ -48,7 +50,7 @@ The mailbox owner must first provide access to a delegate.
 
   - An administrator can configure access through the Exchange admin center. To learn more, see [Manage permissions for recipients](/exchange/recipients/mailbox-permissions).
 
-Once access is provided, the delegate must then follow the instructions outlined in the "Add another person’s mailbox to your folder list in Outlook Web App" section of the article [Access another person's mailbox](https://support.microsoft.com/office/a909ad30-e413-40b5-a487-0ea70b763081).
+Once access is provided, the delegate must then follow the instructions outlined in [Access another person's mailbox](https://support.microsoft.com/office/a909ad30-e413-40b5-a487-0ea70b763081).
 
 #### Shared mailboxes
 
@@ -234,7 +236,7 @@ In Message Compose mode, [getSharedPropertiesAsync](/javascript/api/outlook/offi
     1. They save the message then move it from their own **Drafts** folder to a folder shared with the delegate.
     1. The delegate opens the draft from the shared folder then continues composing.
 
-- **Shared mailbox (applies to classic Outlook on Windows only)**
+- **Shared mailbox**
 
     1. A shared mailbox user starts a message. This can be a new message, a reply, or a forward.
     1. They save the message then move it from their own **Drafts** folder to a folder in the shared mailbox.

docs/images/script-lab-menu.png

@@ -4,7 +4,7 @@ description: Nested app authentication and Outlook legacy tokens deprecation FAQ
 ms.service: microsoft-365
 ms.subservice: add-ins
 ms.topic: faq
-ms.date: 02/05/2025
+ms.date: 02/21/2025
 ---
 
 # Nested app authentication and Outlook legacy tokens deprecation FAQ
@@ -122,6 +122,7 @@ Some widely used Outlook add-in publishers have already updated their add-ins as
 - [Clickup for Outlook](https://appsource.microsoft.com/product/office/WA104382026)
 - [iEnterprises® - Outlook Connector](https://ienterprises.com/connector/outlook-connector)
 - [HubStar Connect](https://www.hubstar.com/solutions/connect/)
+- [SalesForce for Outlook](https://appsource.microsoft.com/product/office/wa104379334)
 - [LawToolBox](https://lawtoolbox.com/lawtoolbox-for-copilot/)
 - [OnePlace Solutions](https://www.oneplacesolutions.com/oneplacemail-sharepoint-app-for-outlook.html)
 - [Set-OutlookSignatures Benefactor Circle](https://explicitconsulting.at/open-source/set-outlooksignatures/)
@@ -135,6 +136,50 @@ Some widely used Outlook add-in publishers have already updated their add-ins as
 
 If the publisher updated their manifest, and the add-in is deployed through the Microsoft store, you'll be prompted as an administrator to upgrade and deploy the updates. If the publisher updated their manifest, and the add-in is deployed through central deployment, you'll need to deploy the new manifest as an administrator. In some cases the publisher may have an admin consent URI you need to use to consent to new scopes for the add-in. Reach out to publishers if you need more information about updating an add-in.
 
+### Some add-ins are breaking. Can I tell if this is because Exchange tokens were turned off?
+
+Beginning February 17, 2025, Microsoft is rolling out an update to gradually turn off legacy Exchange Online tokens for all users. The update won't turn off Exchange tokens in your tenant if you already [turned legacy Exchange Online tokens on](turn-exchange-tokens-on-off.md).
+
+If your tenant uses an add-in that still relies on Exchange tokens, the add-in will break or lose functionality. The update is rolled out **per user**. This means that one or more users may have an add-in affected when Exchange tokens are off, but other users would still have a working add-in. If you notice that an add-in has issues and suspect it may be affected by Exchange tokens turned off, please take the following actions.
+
+#### Check the list of known add-ins
+
+We posted a list of add-ins that were known to be using legacy Exchange tokens as of October 2024. If an add-in is on this list, you should reach out to the publisher to see if there are updates available. For more information, see [Find Outlook add-ins that use legacy Exchange Online tokens](https://github.com/OfficeDev/office-js/tree/release/add-in-ids)
+
+#### Check if tokens are off by using Script Lab
+
+Check if legacy Exchange Online tokens are off for a user by using the Script Lab add-in.
+
+1. Install [Script Lab for Outlook](https://appsource.microsoft.com/en-us/product/office/WA200001603).
+1. Sign in to Outlook with the user account/mailbox that is affected. Exchange tokens can be off for one user, but not another until the rollout is complete.
+1. From an existing or new email, open Script Lab from the **Apps** menu, and choose **Code** from the Script Lab menu.
+
+    ![Screen shot of the Script Lab menu.](../images/script-lab-menu.png)
+
+1. In the Script Lab task pane, select the backstage icon (it has three lines).
+
+    ![Screen shot of the backstage icon.](../images/script-lab-select-backstage-icon.png)
+
+1. Select **Samples** and then search for the **Get a user identity token** sample. Select this sample to open it in the code editor.
+
+    ![Screen shot of the Script Lab menu and search box to find the get a user identity token sample.](../images/script-lab-select-user-identity-token-snippet.png)
+
+1. After the code for the sample is loaded, select **Run** > **Run in this pane**.
+
+    ![Screen shot of the Run menu option in Script Lab.](../images/script-lab-run-code.png)
+
+1. After the code runs, select **Get token**.
+
+If legacy Exchange Online tokens are on, you'll see a token displayed in the console as a Base64-encoded string.
+
+![Screen shot of a token shown in the console window.](../images/script-lab-successful-exchange-token.png)
+
+If legacy Exchange Online tokens are off, you'll see an error displayed in the console as shown below.
+
+![Screen shot of an error in the console window.](../images/script-lab-error-exchange-token.png)
+
+If an add-in is affected by Exchange tokens turned off, you can turn them back on. For more information, see [Can I turn Exchange Online legacy tokens back on?](#can-i-turn-exchange-online-legacy-tokens-back-on).
+
 ## Outlook add-in migration FAQ
 
 ### Why is Microsoft making Outlook add-ins migrate?

docs/images/script-lab-run-code.png

@@ -1,7 +1,7 @@
 ---
 title: Explore Office JavaScript API using Script Lab
 description: Use Script Lab to explore the Office JS API and to prototype functionality.
-ms.date: 09/05/2024
+ms.date: 02/20/2025
 ms.topic: concept-article
 ms.custom: scenarios:getting-started
 ms.localizationpriority: high
@@ -68,6 +68,14 @@ Script Lab for Outlook is available on the following clients.
 > [!IMPORTANT]
 > \* Script Lab no longer works with combinations of platform and Office version that use the Trident (Internet Explorer) webview to host add-ins. This includes perpetual versions of Office through Office 2019. For more information, see [Browsers and webview controls used by Office Add-ins](../concepts/browsers-used-by-office-web-add-ins.md).
 
+## Limitations
+
+Script Lab is designed for you to play with small code samples. Generally, a snippet should be at most a few hundred lines and a few thousand characters.
+
+Your snippet can use hard-coded data. A small amount of data (say, a few hundred characters) is OK to hard code in Script Lab. However, for larger pieces of data, we recommend that you store those externally then load them at runtime with a command like `fetch`.
+
+Keep your snippets and hard-coded data small since storing several large snippets could exceed Script Lab's storage and cause issues when loading Script Lab.
+
 ## Next steps
 
 > [!div class="nextstepaction"]