Skip to content

Commit 4e81c13

Browse files
[all hosts] (VSTO) Add diagram showing relationship to Office Add-ins (#3899)
* [all hosts] (VSTO) Add diagram showing relationship to Office Add-ins * Updates based on feedback * formatting
1 parent 4d87160 commit 4e81c13

File tree

3 files changed

+15
-13
lines changed

3 files changed

+15
-13
lines changed

Diff for: docs/images/office-programmability-diagram.png

36.6 KB
Loading

Diff for: docs/images/office-programmability-diagram.pptx

37 KB
Binary file not shown.

Diff for: docs/overview/office-add-ins.md

+15-13
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: Office Add-ins platform overview
33
description: Use familiar web technologies such as HTML, CSS, and JavaScript to extend and interact with Word, Excel, PowerPoint, OneNote, Project, and Outlook.
4-
ms.date: 02/07/2023
4+
ms.date: 03/14/2023
55
ms.topic: overview
66
ms.custom: scenarios:getting-started
77
ms.localizationpriority: high
@@ -21,21 +21,23 @@ Office Add-ins can do almost anything a webpage can do inside a browser. Use the
2121

2222
## How are Office Add-ins different from COM and VSTO add-ins?
2323

24-
COM or VSTO add-ins are earlier Office integration solutions that run only in Office on Windows. Unlike COM add-ins, Office Add-ins don't involve code that runs on the user's device or in the Office client. For an Office Add-in, the application (for example, Excel), reads the add-in manifest and hooks up the add-ins custom ribbon buttons and menu commands in the UI. When needed, it loads the add-in's JavaScript and HTML code, which executes in the context of a browser in a sandbox.
24+
COM and VSTO add-ins are earlier Office integration solutions that run only in Office on Windows. Unlike COM and VSTO add-ins, Office Add-ins are web add-ins and don't involve code that runs on the user's device or in the Office client. For an Office Add-in, the application (for example, Excel), reads the add-in manifest and hooks up the add-in's custom ribbon buttons and menu commands in the UI. When needed, it loads the add-in's JavaScript and HTML code, which executes in the context of a browser in a sandbox.
2525

26-
![The reasons to use Office Add-ins: cross-platform, centralized deployment, easy access via AppSource, and built on standard web technologies.](../images/why.png)
27-
28-
[!INCLUDE [new-outlook-vsto-com-support](../includes/new-outlook-vsto-com-support.md)]
26+
![A four-quadrant diagram showing the focus areas for different Office extensibility solutions. Office Web Add-ins along with COM and VSTO add-ins target professional developers, while VBA targets end users. Office Web Add-ins are focused on cross-platform experiences and collaboration while COM and VSTO add-ins and VBA cater to the individual's experience on Windows.](../images/office-programmability-diagram.png)
2927

3028
Office Add-ins provide the following advantages over add-ins built using VBA, COM, or VSTO.
3129

32-
- Cross-platform support. Office Add-ins run in Office on the web, Windows, Mac, and iPad.
30+
- Cross-platform support: Office Add-ins run in Office on the web, Windows, Mac, and iPad.
31+
32+
- Centralized deployment and distribution: Admins can deploy Office Add-ins centrally across an organization.
3333

34-
- Centralized deployment and distribution. Admins can deploy Office Add-ins centrally across an organization.
34+
- Easy access via AppSource: You can make your solution available to a broad audience by submitting it to AppSource.
3535

36-
- Easy access via AppSource. You can make your solution available to a broad audience by submitting it to AppSource.
36+
- Based on standard web technology: You can use any library you like to build Office Add-ins.
3737

38-
- Based on standard web technology. You can use any library you like to build Office Add-ins.
38+
![The reasons to use Office Add-ins: cross-platform, centralized deployment, easy access via AppSource, and built on standard web technologies.](../images/why.png)
39+
40+
[!INCLUDE [new-outlook-vsto-com-support](../includes/new-outlook-vsto-com-support.md)]
3941

4042
## Components of an Office Add-in
4143

@@ -69,9 +71,9 @@ Office Add-ins can do the following within an Office client application.
6971

7072
You can add new functionality to Office applications via the following:  
7173

72-
- Custom ribbon buttons and menu commands (collectively called add-in commands”)
74+
- Custom ribbon buttons and menu commands (collectively called "add-in commands").
7375

74-
- Insertable task panes
76+
- Insertable task panes.
7577

7678
Custom UI and task panes are specified in the add-in manifest.  
7779

@@ -103,11 +105,11 @@ You can embed web-based objects called content add-ins within Excel and PowerPoi
103105

104106
## Office JavaScript APIs
105107

106-
The Office JavaScript APIs contain objects and members for building add-ins and interacting with Office content and web services. There is a common object model that is shared by Excel, Outlook, Word, PowerPoint, OneNote, and Project. There are also more extensive application-specific object models for Excel and Word. These APIs provide access to well-known objects such as paragraphs and workbooks, which makes it easier to create an add-in for a specific application.
108+
The Office JavaScript APIs contain objects and members for building add-ins and interacting with Office content and web services. There's a common object model that's shared by Excel, Outlook, Word, PowerPoint, OneNote, and Project. There are also more extensive application-specific object models for Excel and Word. These APIs provide access to well-known objects such as paragraphs and workbooks, which makes it easier to create an add-in for a specific application.
107109

108110
## Code samples
109111

110-
Learn how to build the simplest Office Add-in with only a manifest, HTML web page, and a logo. The following samples will help you get started in the Office host you are interested in.
112+
Learn how to build the simplest Office Add-in with only a manifest, HTML web page, and a logo. The following samples will help you get started in the Office application you're interested in.
111113

112114
- [Excel "Hello world" add-in](https://github.com/OfficeDev/Office-Add-in-samples/tree/main/Samples/hello-world/excel-hello-world)
113115
- [Outlook "Hello world" add-in](https://github.com/OfficeDev/Office-Add-in-samples/tree/main/Samples/hello-world/outlook-hello-world)

0 commit comments

Comments
 (0)