Skip to content

Commit

Permalink
update links so no longer redirect (#293)
Browse files Browse the repository at this point in the history
  • Loading branch information
ElizabethSamuel-MSFT committed Jul 10, 2018
1 parent 73f7022 commit 53d7a9b
Show file tree
Hide file tree
Showing 22 changed files with 41 additions and 41 deletions.
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@ ms.author: jasonjoh

You can use the [addFileAttachmentAsync](https://dev.office.com/reference/add-ins/outlook/1.5/Office.context.mailbox.item?product=outlook&version=v1.5) and [addItemAttachmentAsync](https://dev.office.com/reference/add-ins/outlook/1.5/Office.context.mailbox.item?product=outlook&version=v1.5) methods to attach a file and an Outlook item respectively to the item that the user is composing. Both are asynchronous methods, which means execution can go on without waiting for the action to complete. Depending on the original location and size of the attachment being added, the asynchronous call may take a while to complete. If there are tasks that depend on the action to complete, you should carry out those tasks in a callback method. This callback method is optional and is invoked when the uploading of the attachment is complete. The callback method takes an [AsyncResult](https://dev.office.com/reference/add-ins/outlook/1.5/simple-types?product=outlook&version=v1.5) object as an output parameter that provides any status, error, and returned value from adding the attachment. If the callback requires any extra parameters, you can specify them in the optional `options.aysncContext` parameter. `options.asyncContext` can be of any type that your callback method expects.

For example, you can define `options.asyncContext` as a JSON object that contains one or more key-value pairs. You can find more examples about passing optional parameters to asynchronous methods in the Office Add-ins platform in [Asynchronous programming in Office Add-ins](https://dev.office.com/docs/add-ins/develop/asynchronous-programming-in-office-add-ins#passing-optional-parameters-to-asynchronous-methods). The following example shows how to use the `asyncContext` parameter to pass 2 arguments to a callback method:
For example, you can define `options.asyncContext` as a JSON object that contains one or more key-value pairs. You can find more examples about passing optional parameters to asynchronous methods in the Office Add-ins platform in [Asynchronous programming in Office Add-ins](https://docs.microsoft.com/office/dev/add-ins/develop/asynchronous-programming-in-office-add-ins#passing-optional-parameters-to-asynchronous-methods). The following example shows how to use the `asyncContext` parameter to pass 2 arguments to a callback method:

```js
var options = { asyncContext: { var1: 1, var2: 2} };
Expand Down Expand Up @@ -139,4 +139,4 @@ function removeAttachment(attachmentId) {
## See also

- [Create Outlook Add-ins for compose forms](compose-scenario.md)
- [Asynchronous programming in Office Add-ins](https://dev.office.com/docs/add-ins/develop/asynchronous-programming-in-office-add-ins)
- [Asynchronous programming in Office Add-ins](https://docs.microsoft.com/office/dev/add-ins/develop/asynchronous-programming-in-office-add-ins)
4 changes: 2 additions & 2 deletions docs/add-ins/add-in-commands-for-outlook.md
Original file line number Diff line number Diff line change
Expand Up @@ -22,7 +22,7 @@ Outlook Add-in commands provide ways to initiate specific add-in actions from th
>
> Support for add-in commands in Exchange 2016 requires [Cumulative Update 5](https://support.microsoft.com/en-us/help/4012106/cumulative-update-5-for-exchange-server-2016).
Add-in commands are only available for add-ins that do not use [ItemHasAttachment, ItemHasKnownEntity, or ItemHasRegularExpressionMatch rules](activation-rules.md) to limit the types of items they activate on. However, contextual add-ins can present different commands depending on whether the currently selected item is a message or appointment, and can choose to appear in read or compose scenarios. Using add-in commands if possible is a [best practice](https://dev.office.com/docs/add-ins/overview/add-in-development-best-practices).
Add-in commands are only available for add-ins that do not use [ItemHasAttachment, ItemHasKnownEntity, or ItemHasRegularExpressionMatch rules](activation-rules.md) to limit the types of items they activate on. However, contextual add-ins can present different commands depending on whether the currently selected item is a message or appointment, and can choose to appear in read or compose scenarios. Using add-in commands if possible is a [best practice](https://docs.microsoft.com/office/dev/add-ins/concepts/add-in-development-best-practices).

## Creating the add-in command

Expand Down Expand Up @@ -105,5 +105,5 @@ When using a module extension, add-in commands appear on the extension's custom

## See also

- [Define add-in commands in your manifest](https://dev.office.com/docs/add-ins/develop/define-add-in-commands)
- [Define add-in commands in your manifest](https://docs.microsoft.com/office/dev/add-ins/develop/create-addin-commands)
- [Add-in Command Demo Outlook Add-in](https://github.com/officedev/outlook-add-in-command-demo)
2 changes: 1 addition & 1 deletion docs/add-ins/addin-tutorial.md
Original file line number Diff line number Diff line change
Expand Up @@ -717,7 +717,7 @@ Now we can work on the **Insert Gist** button. For this button we'll open a task
Create a folder in the root of the project called `msg-compose`. In this folder, create `insert-gist.html` and add the following markup.

> [!NOTE]
> The markup for the taskpane borrows heavily from the **Landing page** design pattern described in [UX design pattern templates for Office Add-ins](https://dev.office.com/docs/add-ins/design/ux-design-patterns).
> The markup for the taskpane borrows heavily from the **Landing page** design pattern described in [UX design pattern templates for Office Add-ins](https://docs.microsoft.com/office/dev/add-ins/design/ux-design-pattern-templates).
```html
<!DOCTYPE html>
Expand Down
4 changes: 2 additions & 2 deletions docs/add-ins/apis.md
Original file line number Diff line number Diff line change
Expand Up @@ -61,11 +61,11 @@ Your add-in requires the appropriate permissions to use the APIs that it needs.
| **Read/write** | In addition to what is allowed in **Read item**, it allows:<ul><li>full Outlook Add-in API access except `makeEwsRequestAsync`</li><li>setting the item properties</li></ul> |
| **Read/write mailbox** | In addition to what is allowed in **Read/write**, it allows:<ul><li>creating, reading, writing items and folders</li><li>sending items</li><li>calling [makeEwsRequestAsync](https://dev.office.com/reference/add-ins/outlook/1.5/Office.context.mailbox?product=outlook&version=v1.5#makeewsrequestasyncdata-callback-usercontext)</li></ul> |

In general, you should specify the minimum permission needed for your add-in. Permissions are declared in the `<Permissions>` element in the manifest. For more information, see [Outlook Add-in manifests](manifests.md). For information about security issues, see [Privacy, permissions, and security for Office add-ins](https://dev.office.com/docs/add-ins/develop/privacy-and-security?product=outlook).
In general, you should specify the minimum permission needed for your add-in. Permissions are declared in the `<Permissions>` element in the manifest. For more information, see [Outlook Add-in manifests](manifests.md). For information about security issues, see [Privacy, permissions, and security for Office add-ins](https://docs.microsoft.com/office/dev/add-ins/concepts/privacy-and-security).


## See also

- [Outlook Add-in manifests](manifests.md)
- [Understanding Outlook API requirement sets](https://dev.office.com/reference/add-ins/outlook/tutorial-api-requirement-sets?product=outlook&version=v1.5)
- [Privacy, permissions, and security for Office add-ins](https://dev.office.com/docs/add-ins/develop/privacy-and-security?product=outlook)
- [Privacy, permissions, and security for Office add-ins](https://docs.microsoft.com/office/dev/add-ins/concepts/privacy-and-security)
2 changes: 1 addition & 1 deletion docs/add-ins/authentication.md
Original file line number Diff line number Diff line change
Expand Up @@ -29,7 +29,7 @@ Using this method, your add-in can obtain an access token scoped to your server
- Complete the On-Behalf-Of flow to obtain an access token scoped to the Microsoft Graph API
- Use the identity information in the token to establish the user's identity and authenticate to your own back-end services

For a more detailed overview, see the [full overview of the SSO authentication method](https://dev.office.com/docs/add-ins/develop/sso-in-office-add-ins).
For a more detailed overview, see the [full overview of the SSO authentication method](https://docs.microsoft.com/office/dev/add-ins/develop/sso-in-office-add-ins).

For details on using the SSO token in an Outlook Add-in, see [Authenticate a user with an single-sign-on token in an Outlook Add-in](authenticate-a-user-with-an-sso-token.md).

Expand Down
2 changes: 1 addition & 1 deletion docs/add-ins/concepts.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,4 +11,4 @@ ms.author: jasonjoh

# Outlook Add-in conceptual documentation

Outlook Add-in conceptual documentation is hosted on <a href="https://dev.office.com/docs/add-ins/outlook/outlook-add-ins?product=outlook" target="_blank">dev.office.com</a> (Link opens in a new window). Visit that link for information on the Outlook Add-in platform and how-to articles.
Outlook Add-in conceptual documentation is hosted on <a href="https://docs.microsoft.com/outlook/add-ins" target="_blank">docs.microsoft.com</a> (Link opens in a new window). Visit that link for information on the Outlook Add-in platform and how-to articles.
2 changes: 1 addition & 1 deletion docs/add-ins/extension-module-outlook-add-ins.md
Original file line number Diff line number Diff line change
Expand Up @@ -145,5 +145,5 @@ The following is a section of a manifest file that defines a module extension.
## See also

- [Outlook Add-in manifests](manifests.md)
- [Define add-in commands in your manifest](https://dev.office.com/docs/add-ins/develop/define-add-in-commands)
- [Define add-in commands in your manifest](https://docs.microsoft.com/office/dev/add-ins/develop/define-add-in-commands)
- [Outlook module extensions Billable hours sample](https://github.com/OfficeDev/Outlook-Add-in-JavaScript-ModuleExtension)
4 changes: 2 additions & 2 deletions docs/add-ins/get-or-set-the-location-of-an-appointment.md
Original file line number Diff line number Diff line change
Expand Up @@ -29,7 +29,7 @@ item.location.getAsync(function(result){

The `location` property is available for write access in only compose forms of appointments, but not in read forms.

As with most asynchronous methods in the JavaScript API for Office, `getAsync` and `setAsync` take optional input parameters. For more information about specifying these optional input parameters, see [Asynchronous programming in Office Add-ins](https://dev.office.com/docs/add-ins/develop/asynchronous-programming-in-office-add-ins).
As with most asynchronous methods in the JavaScript API for Office, `getAsync` and `setAsync` take optional input parameters. For more information about specifying these optional input parameters, see [Asynchronous programming in Office Add-ins](https://docs.microsoft.com/office/dev/add-ins/develop/asynchronous-programming-in-office-add-ins).

## To get the location

Expand Down Expand Up @@ -115,4 +115,4 @@ function write(message){
## See also

- [Write your first Outlook Add-in](addin-tutorial.md)
- [Asynchronous programming in Office Add-ins](https://dev.office.com/docs/add-ins/develop/asynchronous-programming-in-office-add-ins)
- [Asynchronous programming in Office Add-ins](https://docs.microsoft.com/office/dev/add-ins/develop/asynchronous-programming-in-office-add-ins)
4 changes: 2 additions & 2 deletions docs/add-ins/get-or-set-the-subject.md
Original file line number Diff line number Diff line change
Expand Up @@ -33,7 +33,7 @@ item.subject.getAsync

The **subject** property is available for write access in only compose forms and not in read forms.

As with most asynchronous methods in the JavaScript API for Office, **getAsync** and **setAsync** take optional input parameters. For more information about specifying these optional input parameters, see "Passing optional parameters to asynchronous methods" in [Asynchronous programming in Office Add-ins](https://dev.office.com/docs/add-ins/develop/asynchronous-programming-in-office-add-ins?product=outlook).
As with most asynchronous methods in the JavaScript API for Office, **getAsync** and **setAsync** take optional input parameters. For more information about specifying these optional input parameters, see "Passing optional parameters to asynchronous methods" in [Asynchronous programming in Office Add-ins](https://docs.microsoft.com/office/dev/add-ins/develop/asynchronous-programming-in-office-add-ins).


## To get the subject
Expand Down Expand Up @@ -152,7 +152,7 @@ function write(message){

- [Create Outlook Add-ins for compose forms](compose-scenario.md)

- [Asynchronous programming in Office Add-ins](https://dev.office.com/docs/add-ins/develop/asynchronous-programming-in-office-add-ins?product=outlook)
- [Asynchronous programming in Office Add-ins](https://docs.microsoft.com/office/dev/add-ins/develop/asynchronous-programming-in-office-add-ins)

- [Get, set, or add recipients when composing an appointment or message in Outlook](get-set-or-add-recipients.md)

Expand Down
4 changes: 2 additions & 2 deletions docs/add-ins/get-or-set-the-time-of-an-appointment.md
Original file line number Diff line number Diff line change
Expand Up @@ -49,7 +49,7 @@ and:
item.end.getAsync
```

As with most asynchronous methods in the JavaScript API for Office, **getAsync** and **setAsync** take optional input parameters. For more information about specifying these optional input parameters, see [passing optional parameters to asynchronous methods](https://dev.office.com/docs/add-ins/develop/asynchronous-programming-in-office-add-ins?product=outlook#passing-optional-parameters-inline) in [Asynchronous programming in Office Add-ins](https://dev.office.com/docs/add-ins/develop/asynchronous-programming-in-office-add-ins?product=outlook).
As with most asynchronous methods in the JavaScript API for Office, **getAsync** and **setAsync** take optional input parameters. For more information about specifying these optional input parameters, see [passing optional parameters to asynchronous methods](https://docs.microsoft.com/office/dev/add-ins/develop/asynchronous-programming-in-office-add-ins#passing-optional-parameters-inline) in [Asynchronous programming in Office Add-ins](https://docs.microsoft.com/office/dev/add-ins/develop/asynchronous-programming-in-office-add-ins?product=outlook).


## To get the start or end time
Expand Down Expand Up @@ -165,7 +165,7 @@ function write(message){

- [Create Outlook Add-ins for compose forms](compose-scenario.md)

- [Asynchronous programming in Office Add-ins](https://dev.office.com/docs/add-ins/develop/asynchronous-programming-in-office-add-ins?product=outlook)
- [Asynchronous programming in Office Add-ins](https://docs.microsoft.com/office/dev/add-ins/develop/asynchronous-programming-in-office-add-ins)

- [Get, set, or add recipients when composing an appointment or message in Outlook](get-set-or-add-recipients.md)

Expand Down
4 changes: 2 additions & 2 deletions docs/add-ins/get-set-or-add-recipients.md
Original file line number Diff line number Diff line change
Expand Up @@ -34,7 +34,7 @@ item.cc.getAsync

These properties are available for write access in only compose forms and not read forms.

As with most asynchronous methods in the JavaScript API for Office, **getAsync**, **setAsync**, and **addAsync** take optional input parameters. For more information about specifying these optional input parameters, see [passing optional parameters to asynchronous methods](https://dev.office.com/docs/add-ins/develop/asynchronous-programming-in-office-add-ins?product=outlook#passing-optional-parameters-inline) in [Asynchronous programming in Office Add-ins](https://dev.office.com/docs/add-ins/develop/asynchronous-programming-in-office-add-ins?product=outlook).
As with most asynchronous methods in the JavaScript API for Office, **getAsync**, **setAsync**, and **addAsync** take optional input parameters. For more information about specifying these optional input parameters, see [passing optional parameters to asynchronous methods](https://docs.microsoft.com/office/dev/add-ins/develop/asynchronous-programming-in-office-add-ins#passing-optional-parameters-inline) in [Asynchronous programming in Office Add-ins](https://docs.microsoft.com/office/dev/add-ins/develop/asynchronous-programming-in-office-add-ins).


## To get recipients
Expand Down Expand Up @@ -320,7 +320,7 @@ function addAttendees() {

- [Create Outlook Add-ins for compose forms](compose-scenario.md)

- [Asynchronous programming in Office Add-ins](https://dev.office.com/docs/add-ins/develop/asynchronous-programming-in-office-add-ins?product=outlook)
- [Asynchronous programming in Office Add-ins](https://docs.microsoft.com/office/dev/add-ins/develop/asynchronous-programming-in-office-add-ins)

- [Get or set the subject when composing an appointment or message in Outlook](get-or-set-the-subject.md)

Expand Down
4 changes: 2 additions & 2 deletions docs/add-ins/insert-data-in-the-body.md
Original file line number Diff line number Diff line change
Expand Up @@ -28,7 +28,7 @@ In Outlook, a user can create a message in text, HTML, or Rich Text Format (RTF)

2. If your data to insert is HTML and **getTypeAsync** returns a text type for that item, reorganize your data as text and insert it with **Office.MailboxEnums.BodyType.Text** as _coercionType_. If you simply insert the HTML data with a text coercion type, the host would display the HTML tags as text. If you attempt to insert the HTML data with **Office.MailboxEnums.BodyType.Html** as _coercionType_, you will get an error.

In addition to _coercionType_, as with most asynchronous methods in the JavaScript API for Office, **getTypeAsync**, **prependAsync** and **setSelectedDataAsync** take other optional input parameters. For more information about specifying these optional input parameters, see [passing optional parameters to asynchronous methods](https://dev.office.com/docs/add-ins/develop/asynchronous-programming-in-office-add-ins?product=outlook#passing-optional-parameters-inline) in [Asynchronous programming in Office Add-ins](https://dev.office.com/docs/add-ins/develop/asynchronous-programming-in-office-add-ins?product=outlook).
In addition to _coercionType_, as with most asynchronous methods in the JavaScript API for Office, **getTypeAsync**, **prependAsync** and **setSelectedDataAsync** take other optional input parameters. For more information about specifying these optional input parameters, see [passing optional parameters to asynchronous methods](https://docs.microsoft.com/office/dev/add-ins/develop/asynchronous-programming-in-office-add-ins#passing-optional-parameters-inline) in [Asynchronous programming in Office Add-ins](https://docs.microsoft.com/office/dev/add-ins/develop/asynchronous-programming-in-office-add-ins).


## To insert data at the current cursor position
Expand Down Expand Up @@ -235,7 +235,7 @@ function write(message){

- [Create Outlook Add-ins for compose forms](compose-scenario.md)

- [Asynchronous programming in Office Add-ins](https://dev.office.com/docs/add-ins/develop/asynchronous-programming-in-office-add-ins?product=outlook)
- [Asynchronous programming in Office Add-ins](https://docs.microsoft.com/office/dev/add-ins/develop/asynchronous-programming-in-office-add-ins)

- [Get, set, or add recipients when composing an appointment or message in Outlook](get-set-or-add-recipients.md)

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -91,4 +91,4 @@ Aside from the preceding guidelines for activation rules, each of the Outlook ho
## See also

- [Deploy and install Outlook Add-ins for testing](testing-and-tips.md)
- [Privacy, permissions, and security for Outlook Add-ins](https://dev.office.com/docs/add-ins/develop/privacy-and-security)
- [Privacy, permissions, and security for Outlook Add-ins](https://docs.microsoft.com/office/dev/add-ins/develop/privacy-and-security)
Loading

0 comments on commit 53d7a9b

Please sign in to comment.