diff --git a/docs/develop/get-the-whole-document-from-an-add-in-for-powerpoint-or-word.md b/docs/develop/get-the-whole-document-from-an-add-in-for-powerpoint-or-word.md index fbf7bc5ee..97b877882 100644 --- a/docs/develop/get-the-whole-document-from-an-add-in-for-powerpoint-or-word.md +++ b/docs/develop/get-the-whole-document-from-an-add-in-for-powerpoint-or-word.md @@ -22,7 +22,7 @@ This article assumes that you are using a text editor to create the task pane ad - A CSS file (**Program.css**) to contain the styles and formatting for the add-in. -- An add-in only manifest file (**GetDoc_App.xml**) for the add-in, available on a shared network folder or add-in catalog. The manifest file must point to the location of the HTML file mentioned previously. +- A manifest file (**GetDoc_App.xml** or **GetDoc_App.json**) for the add-in, available on a shared network folder or add-in catalog. The manifest file must point to the location of the HTML file mentioned previously. Alternatively, you can create an add-in for your Office application using one of the following options. You won't have to create new files as the equivalent of each required file will be available for you to update. For example, the Yeoman generator options include **./src/taskpane/taskpane.html**, **./src/taskpane/taskpane.js**, **./src/taskpane/taskpane.css**, and **./manifest.xml**. @@ -41,33 +41,114 @@ Before you begin creating this add-in for PowerPoint or Word, you should be fami The manifest file for an Office Add-in provides important information about the add-in: what applications can host it, the location of the HTML file, the add-in title and description, and many other characteristics. -1. In a text editor, add the following code to the manifest file. - - ```xml - - - [Replace_With_Your_GUID] - 1.0 - [Provider Name] - EN-US - - - - - - - - - - - - ReadWriteDocument - - ``` +In a text editor, add the following code to the manifest file. If you're using a Visual Studio project, select the "Add-in only manifest" option. + +# [Unified manifest for Microsoft 365](#tab/jsonmanifest) + +> [!NOTE] +> The unified manifest is generally available for production Outlook add-ins. It's available only for preview in Excel, PowerPoint, and Word add-ins. + +```json +{ + "$schema": "https://developer.microsoft.com/json-schemas/teams/vDevPreview/MicrosoftTeams.schema.json#", + "manifestVersion": "devPreview", + "version": "1.0.0.0", + "id": "[Replace_With_Your_GUID]", + "localizationInfo": { + "defaultLanguageTag": "en-us" + }, + "developer": { + "name": "[Provider Name e.g., Contoso]", + "websiteUrl": "[Insert the URL for the app e.g., https://www.contoso.com]", + "privacyUrl": "[Insert the URL of a page that provides privacy information for the app e.g., https://www.contoso.com/privacy]", + "termsOfUseUrl": "[Insert the URL of a page that provides terms of use for the app e.g., https://www.contoso.com/servicesagreement]" + }, + "name": { + "short": "Get Doc add-in", + "full": "Get Doc add-in" + }, + "description": { + "short": "My get PowerPoint or Word document add-in.", + "full": "My get PowerPoint or Word document add-in." + }, + "icons": { + "outline": "_layouts/images/general/office_logo.jpg", + "color": "_layouts/images/general/office_logo.jpg" + }, + "accentColor": "#230201", + "validDomains": [ + "https://www.contoso.com" + ], + "showLoadingIndicator": false, + "isFullScreen": false, + "defaultBlockUntilAdminAction": false, + "authorization": { + "permissions": { + "resourceSpecific": [ + { + "name": "Document.ReadWrite.User", + "type": "Delegated" + } + ] + } + }, + "extensions": [ + { + "requirements": { + "scopes": [ + "document", + "presentation" + ] + }, + "alternates": [ + { + "alternateIcons": { + "icon": { + "size": 32, + "url": "http://officeimg.vo.msecnd.net/_layouts/images/general/office_logo.jpg" + }, + "highResolutionIcon": { + "size": 64, + "url": "http://officeimg.vo.msecnd.net/_layouts/images/general/office_logo.jpg" + } + } + } + ] + } + ] +} +``` -1. Save the file as **GetDoc_App.xml** using UTF-8 encoding to a network location or to an add-in catalog. +# [Add-in only manifest](#tab/xmlmanifest) + +```xml + + + [Replace_With_Your_GUID] + 1.0 + [Provider Name] + EN-US + + + + + + + + + + + + + ReadWriteDocument + +``` + +Save the file as **GetDoc_App.xml** using UTF-8 encoding to a network location or to an add-in catalog. + +--- ## Create the user interface for the add-in