Navigation Menu

Skip to content

Commit

Permalink
[All] Scrub Office 365 platforms (#995)
Browse files Browse the repository at this point in the history
* [All] Scrub Office 365 platforms

* Add link to See also

* update based on feedback

Co-Authored-By: Michelle Scharlock <mischarl@microsoft.com>
  • Loading branch information
ElizabethSamuel-MSFT and Michelle Scharlock committed May 9, 2019
1 parent 81a4291 commit f188015
Show file tree
Hide file tree
Showing 41 changed files with 164 additions and 163 deletions.
6 changes: 3 additions & 3 deletions docs/concepts/privacy-and-security.md
@@ -1,7 +1,7 @@
---
title: Privacy and security for Office Add-ins
description: ''
ms.date: 03/19/2019
ms.date: 05/08/2019
localization_priority: Priority
---

Expand Down Expand Up @@ -32,7 +32,7 @@ The following sections briefly describe how the runtime architecture supports ru
> [!NOTE]
> To learn about using WIP and Intune with Office Add-ins, see [Use WIP and Intune to protect enterprise data in documents running Office Add-ins](/microsoft-365/enterprise/office-add-ins-wip).
### Clients for Windows and OS X devices
### Clients on Windows and OS X devices

In supported clients for desktop and tablet devices, such as Excel, Outlook, and Outlook for Mac, Office Add-ins are supported by integrating an in-process component, the Office Add-ins runtime, which manages the add-in lifecycle and enables interoperability between the add-in and the client application. The add-in webpage itself is hosted out-of-process. As shown in figure 1, on a Windows desktop or tablet device, the add-in webpage is hosted inside an Internet Explorer control which, in turn, is hosted inside an add-in runtime process that provides security and performance isolation.

Expand Down Expand Up @@ -87,7 +87,7 @@ The add-in platform addresses end users' privacy concerns in the following ways:

- When sharing a document, users also share add-ins that have been inserted in or associated with that document. If a user opens a document that contains an add-in that the user hasn't used before, the host application prompts the user to grant permission for the add-in to run in the document. In an organizational environment, the Office host application also prompts the user if the document comes from an external source.

- Users can enable or disable the access to AppSource. For content and task pane add-ins, users manage access to trusted add-ins and catalogs from the **Trust Center** on the host Office client (opened from **File** > **Options** > **Trust Center** > **Trust Center Settings** > **Trusted Add-in Catalogs**). For Outlook add-ins, uses can manage add-ins by choosing the **Manage Add-ins** button: in Outlook for Windows, choose **File** > **Manage Add-ins**. In Outlook for Mac, choose the **Manage Add-ins** button on the add-in bar. In Outlook Web App choose the **Settings** menu (gear icon) > **Manage add-ins**. Administrators can also manage this access [by using group policy](/previous-versions/office/office-2013-resource-kit/jj219429(v=office.15)#using-group-policy-to-manage-how-users-can-install-and-use-apps-for-office).
- Users can enable or disable the access to AppSource. For content and task pane add-ins, users manage access to trusted add-ins and catalogs from the **Trust Center** on the host Office client (opened from **File** > **Options** > **Trust Center** > **Trust Center Settings** > **Trusted Add-in Catalogs**). For Outlook add-ins, uses can manage add-ins by choosing the **Manage Add-ins** button: in Outlook on Windows, choose **File** > **Manage Add-ins**. In Outlook for Mac, choose the **Manage Add-ins** button on the add-in bar. In Outlook Web App choose the **Settings** menu (gear icon) > **Manage add-ins**. Administrators can also manage this access [by using group policy](/previous-versions/office/office-2013-resource-kit/jj219429(v=office.15)#using-group-policy-to-manage-how-users-can-install-and-use-apps-for-office).

- The design of the add-in platform provides security and performance for end users in the following ways:

Expand Down
10 changes: 5 additions & 5 deletions docs/design/add-in-commands.md
@@ -1,7 +1,7 @@
---
title: Add-in commands for Excel, Word, and PowerPoint
description: ''
ms.date: 04/29/2019
ms.date: 05/08/2019
localization_priority: Priority
---

Expand Down Expand Up @@ -49,10 +49,10 @@ The following command capabilities are currently supported.

Add-in commands are currently supported on the following platforms:

- Outlook 2016 for Windows (build 16.0.4678.1000+)
- Office 365 for Windows (build 16.0.6769+)
- Office 2019 for Windows
- Office 365 for Mac (build 15.33+)
- Outlook 2016 on Windows (build 16.0.4678.1000+)
- Office on Windows connected to Office 365 (build 16.0.6769+)
- Office 2019 on Windows
- Office for Mac connected to Office 365 (build 15.33+)
- Office 2019 for Mac
- Office Online

Expand Down
@@ -1,7 +1,7 @@
---
title: Automatically open a task pane with a document
description: ''
ms.date: 03/19/2019
ms.date: 05/08/2019
localization_priority: Priority
---

Expand All @@ -25,7 +25,7 @@ The autoopen feature is currently <!-- in **developer preview** and it is only -

|**Products**|**Platforms**|
|:-----------|:------------|
|<ul><li>Word</li><li>Excel</li><li>PowerPoint</li></ul>|Supported platforms for all products:<ul><li>Office for Windows Desktop. Build 16.0.8121.1000+</li><li>Office for Mac. Build 15.34.17051500+</li><li>Office Online</li></ul>|
|<ul><li>Word</li><li>Excel</li><li>PowerPoint</li></ul>|Supported platforms for all products:<ul><li>Office on Windows Desktop. Build 16.0.8121.1000+</li><li>Office for Mac. Build 15.34.17051500+</li><li>Office Online</li></ul>|


## Best practices
Expand Down
@@ -1,7 +1,7 @@
---
title: Create and debug Office Add-ins in Visual Studio
description: 'Use Visual Studio to create and debug Office Add-ins on the Office desktop client for Windows'
ms.date: 03/19/2019
description: 'Use Visual Studio to create and debug Office Add-ins in the Office desktop client on Windows'
ms.date: 05/08/2019
localization_priority: Priority
---

Expand Down Expand Up @@ -205,7 +205,7 @@ If your add-in isn't visible within the document that's displayed in the host ap

1. In Excel, PowerPoint, or Word, choose the **Insert** tab and then choose the down-arrow located to the right of **My Add-ins**.

![Insert ribbon in Excel for Windows with the My Add-ins arrow highlighted](../images/excel-cf-register-add-in-1b.png)
![Insert ribbon in Excel on Windows with the My Add-ins arrow highlighted](../images/excel-cf-register-add-in-1b.png)

2. In the list of available add-ins, find the **Developer Add-ins** section and select the your add-in to register it.

Expand Down
4 changes: 2 additions & 2 deletions docs/develop/develop-office-add-ins-for-the-ipad.md
@@ -1,7 +1,7 @@
---
title: Develop Office Add-ins for the iPad
description: ''
ms.date: 03/19/2019
ms.date: 05/08/2019
localization_priority: Normal
---

Expand Down Expand Up @@ -34,7 +34,7 @@ Apply the following best practices for developing add-ins that run on iOS:

- **Use Visual Studio to develop your add-in.**

If you develop your add-in with Visual Studio, you can [set breakpoints and debug its code](../develop/create-and-debug-office-add-ins-in-visual-studio.md) in an Office host application running on Windows, before sideloading your add-in on the iPad or Mac. Because an add-in that runs in Office for iOS or Office for Mac supports the same APIs as an add-in running in Office for Windows, your add-in's code should run the same way on both platforms.
If you develop your add-in with Visual Studio, you can [set breakpoints and debug its code](../develop/create-and-debug-office-add-ins-in-visual-studio.md) in an Office host application running on Windows, before sideloading your add-in on the iPad or Mac. Because an add-in that runs in Office for iOS or Office for Mac supports the same APIs as an add-in running in Office on Windows, your add-in's code should run the same way on both platforms.

- **Specify API requirements in your add-in's manifest or with runtime checks.**

Expand Down
4 changes: 2 additions & 2 deletions docs/develop/office-versions-and-requirement-sets.md
@@ -1,7 +1,7 @@
---
title: Office versions and requirement sets
description: ''
ms.date: 05/01/2019
ms.date: 05/08/2019
localization_priority: Priority
---

Expand All @@ -10,7 +10,7 @@ localization_priority: Priority
There are many versions of Office on several platforms, and they don't all support every API in Office JavaScript API (Office.js). You may not always have control over the version of Office your users have installed. To handle this situation, we provide a system called requirement sets to help you determine whether an Office host supports the capabilities you need in your Office Add-in.

> [!NOTE]
> - Office runs across multiple platforms, including Office for Windows, Office Online, Office for the Mac, and Office for the iPad.
> - Office runs across multiple platforms, including Office on Windows, Office Online, Office for Mac, and Office for iPad.
> - Examples of Office hosts are Office Products: Excel, Word, PowerPoint, Outlook, OneNote, and so forth.
> - A requirement set is a named group of API members e.g., `ExcelApi 1.5`, `WordApi 1.3`, and so on.
Expand Down
22 changes: 11 additions & 11 deletions docs/develop/specify-office-hosts-and-api-requirements.md
@@ -1,7 +1,7 @@
---
title: Specify Office hosts and API requirements
description: ''
ms.date: 03/19/2019
ms.date: 05/08/2019
localization_priority: Priority
---

Expand Down Expand Up @@ -65,7 +65,7 @@ When you specify Office hosts or API requirements, there are several factors to

To make your add-in run in one Office host application, use the **Hosts** and **Host** elements in the manifest. If you don't specify the **Hosts** element, your add-in will run in all hosts.

For example, the following **Hosts** and **Host** declaration specifies that the add-in will work with any release of Excel, which includes Excel for Windows, Excel Online, and Excel for iPad.
For example, the following **Hosts** and **Host** declaration specifies that the add-in will work with any release of Excel, which includes Excel on Windows, Excel Online, and Excel for iPad.

```xml
<Hosts>
Expand All @@ -75,14 +75,14 @@ For example, the following **Hosts** and **Host** declaration specifies that th

The **Hosts** element can contain one or more **Host** elements. The **Host** element specifies the Office host your add-in requires. The **Name** attribute is required and can be set to one of the following values.

| Name | Office host applications |
|:--------------|:----------------------------------------------|
| Database | Access web apps |
| Document | Word for Windows, Mac, iPad and Online |
| Mailbox | Outlook for Windows, Mac, Web and Outlook.com |
| Presentation | PowerPoint for Windows, Mac, iPad and Online |
| Project | Project |
| Workbook | Excel Windows, Mac, iPad and Online |
| Name | Office host applications |
|:--------------|:--------------------------------------------------------------------------------------|
| Database | Access web apps |
| Document | Word on Windows, word for Mac, Word for iPad, and Word Online |
| Mailbox | Outlook on Windows, Outlook for Mac, Outlook on the web, and Outlook.com |
| Presentation | PowerPoint on Windows, PowerPoint for Mac, PowerPoint for iPad, and PowerPoint Online |
| Project | Project |
| Workbook | Excel on Windows, Excel for Mac, Excel for iPad, and Excel Online |

> [!NOTE]
> The `Name` attribute specifies the Office host application that can run your add-in. Office hosts are supported on different platforms and run on desktops, web browsers, tablets, and mobile devices. You can't specify which platform can be used to run your add-in. For example, if you specify `Mailbox`, both Outlook and Outlook Web App can be used to run your add-in.
Expand All @@ -93,7 +93,7 @@ The **Hosts** element can contain one or more **Host** elements. The **Host** e
The **Requirements** element specifies the minimum requirement sets or API members that must be supported by the Office host to run your add-in. The **Requirements** element can specify both requirement sets and individual methods used in your add-in. In version 1.1 of the add-in manifest schema, the **Requirements** element is optional for all add-ins, except for Outlook add-ins.

> [!WARNING]
> Only use the **Requirements** element to specify critical requirement sets or API members that your add-in must use. If the Office host or platform doesn't support the requirement sets or API members specified in the **Requirements** element, the add-in won't run in that host or platform, and won't display in **My Add-ins**. Instead, we recommend that you make your add-in available on all platforms of an Office host, such as Excel for Windows, Excel Online, and Excel for iPad. To make your add-in available on _all_ Office hosts and platforms, use runtime checks instead of the **Requirements** element.
> Only use the **Requirements** element to specify critical requirement sets or API members that your add-in must use. If the Office host or platform doesn't support the requirement sets or API members specified in the **Requirements** element, the add-in won't run in that host or platform, and won't display in **My Add-ins**. Instead, we recommend that you make your add-in available on all platforms of an Office host, such as Excel on Windows, Excel Online, and Excel for iPad. To make your add-in available on _all_ Office hosts and platforms, use runtime checks instead of the **Requirements** element.
The following code example shows an add-in that loads in all Office host applications that support the following:

Expand Down
8 changes: 4 additions & 4 deletions docs/excel/co-authoring-in-excel-add-ins.md
@@ -1,7 +1,7 @@
---
title: Coauthoring in Excel add-ins
description: ''
ms.date: 03/19/2019
ms.date: 05/08/2019
localization_priority: Normal
---

Expand All @@ -17,9 +17,9 @@ Coauthoring is available on the following platforms:

- Excel Online
- Excel for Android
- Excel for iOS
- Excel Mobile for Windows 10
- Excel for Windows Desktop for Office 365 customers (Windows desktop build 16.0.8326.2076 or later, which is available to current channel customers effective August 2017)
- Excel for iPad
- Excel Mobile on Windows 10
- Excel on Windows Desktop for Office 365 customers (Windows desktop build 16.0.8326.2076 or later, which is available to current channel customers effective August 2017)

## Coauthoring overview

Expand Down
4 changes: 2 additions & 2 deletions docs/excel/custom-functions-best-practices.md
@@ -1,5 +1,5 @@
---
ms.date: 05/06/2019
ms.date: 05/08/2019
description: Learn best practices for developing custom functions in Excel.
title: Custom functions best practices
localization_priority: Normal
Expand Down Expand Up @@ -94,7 +94,7 @@ The following sample shows the JSON metadata that corresponds to the functions d

## Additional considerations

Avoid accessing the Document Object Model (DOM) directly or indirectly (for example, using jQuery) from your custom function. On Excel for Windows, where custom functions use the [JavaScript runtime](custom-functions-runtime.md), custom functions cannot access the DOM.
Avoid accessing the Document Object Model (DOM) directly or indirectly (for example, using jQuery) from your custom function. In Excel on Windows, where custom functions use the [JavaScript runtime](custom-functions-runtime.md), custom functions cannot access the DOM.

## Next steps
Learn how to [perform web requests with custom functions](custom-functions-web-reqs.md).
Expand Down
4 changes: 2 additions & 2 deletions docs/excel/custom-functions-overview.md
@@ -1,5 +1,5 @@
---
ms.date: 05/03/2019
ms.date: 05/08/2019
description: Create custom functions in Excel using JavaScript.
title: Create custom functions in Excel
localization_priority: Priority
Expand Down Expand Up @@ -136,7 +136,7 @@ The following basic XML markup shows an example of the `<ExtensionPoint>` and `<
## Coauthoring

Excel Online and Excel for Windows with an Office 365 subscription allow you to coauthor documents and this feature works with custom functions. If your workbook uses a custom function, your colleague will be prompted to load the custom function's add-in. Once you both have loaded the add-in, the custom function will share results through coauthoring.
Excel Online and Excel on Windows with an Office 365 subscription allow you to coauthor documents and this feature works with custom functions. If your workbook uses a custom function, your colleague will be prompted to load the custom function's add-in. Once you both have loaded the add-in, the custom function will share results through coauthoring.

For more information on coauthoring, see [About coauthoring in Excel](/office/vba/excel/concepts/about-coauthoring-in-excel).

Expand Down
8 changes: 4 additions & 4 deletions docs/excel/custom-functions-requirements.md
@@ -1,5 +1,5 @@
---
ms.date: 05/03/2019
ms.date: 05/08/2019
description: Learn how to use custom functions on different platforms.
title: Custom functions requirements
localization_priority: Priority
Expand All @@ -9,14 +9,14 @@ localization_priority: Priority
Custom functions are currently available on the following platforms:

- Excel Online
- Excel for Windows (64-bit version 1810 or later)
- Excel on Windows (64-bit version 1810 or later)
- Excel for Mac (version 13.329 or later)

## Excel Online
To use custom functions within Excel Online, login by using either your Office 365 subscription or a [Microsoft account](https://account.microsoft.com/account).

## Excel for Windows and Excel for Mac
To use custom functions within Excel for Windows or Excel for Mac, you must have an Office 365 subscription, join the [Office Insider](https://products.office.com/office-insider) program (**Insider** level -- formerly called "Insider Fast"), and use a sufficiently recent build of Excel (as specified previously).
## Excel on Windows and Excel for Mac
To use custom functions within Excel on Windows or Excel for Mac, you must have an Office 365 subscription, join the [Office Insider](https://products.office.com/office-insider) program (**Insider** level -- formerly called "Insider Fast"), and use a sufficiently recent build of Excel (as specified previously).

If you are using a version of Office on your desktop which you downloaded from the Windows Store, you must be part of the [Windows Insider](https://insider.windows.com/) program at the **Insider** level (formerly called "Insider Fast"), running the April 2018 Update version or later to use custom functions. This is a new change as of January 2019.

Expand Down
4 changes: 2 additions & 2 deletions docs/excel/custom-functions-runtime.md
@@ -1,5 +1,5 @@
---
ms.date: 05/06/2019
ms.date: 05/08/2019
description: Understand key scenarios in developing Excel custom functions that use the new JavaScript runtime.
title: Runtime for Excel custom functions
localization_priority: Normal
Expand Down Expand Up @@ -110,7 +110,7 @@ function StoreValue(key, value) {

## Additional considerations

In order to create an add-in that will run on multiple platforms (one of the key tenants of Office Add-ins), you should not access the Document Object Model (DOM) in custom functions or use libraries like jQuery that rely on the DOM. On Excel for Windows, where custom functions use the JavaScript runtime, custom functions cannot access the DOM.
In order to create an add-in that will run on multiple platforms (one of the key tenants of Office Add-ins), you should not access the Document Object Model (DOM) in custom functions or use libraries like jQuery that rely on the DOM. In Excel on Windows, where custom functions use the JavaScript runtime, custom functions cannot access the DOM.

## Next steps
Learn some crucial [best practices for custom functions](custom-functions-best-practices.md).
Expand Down
4 changes: 2 additions & 2 deletions docs/excel/custom-functions-save-state.md
@@ -1,13 +1,13 @@
---
ms.date: 05/03/2019
ms.date: 05/08/2019
description: Use `OfficeRuntime.storage` to save state with custom functions.
title: Save and share state in custom functions
localization_priority: Priority
---

## Save and share state in custom functions

Use the `OfficeRuntime.storage` object to save state related to custom functions or the task pane in your add-in. Storage is limited to 10 MB per domain (which may be shared across multiple add-ins). On Excel for Windows, the `storage` object is a separate location within the custom functions runtime, but for Excel Online and Excel for Mac, the `storage` object is the same as the browser's `localStorage`.
Use the `OfficeRuntime.storage` object to save state related to custom functions or the task pane in your add-in. Storage is limited to 10 MB per domain (which may be shared across multiple add-ins). In Excel on Windows, the `storage` object is a separate location within the custom functions runtime, but for Excel Online and Excel for Mac, the `storage` object is the same as the browser's `localStorage`.

[!include[Excel custom functions note](../includes/excel-custom-functions-note.md)]

Expand Down

0 comments on commit f188015

Please sign in to comment.