Skip to content

Commit 5103976

Browse files
author
Linda Caputo
authored
Fixed QA bugs (#381)
http://contentqacats/CheckResults/2018092000215/Report/
1 parent 0086752 commit 5103976

File tree

61 files changed

+185
-180
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

61 files changed

+185
-180
lines changed

ThirdPartyNotices

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
##Legal Notices
1+
## Legal Notices
22
Microsoft and any contributors grant you a license to the Microsoft documentation and other content
33
in this repository under the [Creative Commons Attribution 4.0 International Public License](https://creativecommons.org/licenses/by/4.0/legalcode),
44
see the [LICENSE](LICENSE) file, and grant you a license to any code in the repository under the [MIT License](https://opensource.org/licenses/MIT), see the
@@ -7,7 +7,7 @@ see the [LICENSE](LICENSE) file, and grant you a license to any code in the repo
77
Microsoft, Windows, Microsoft Azure and/or other Microsoft products and services referenced in the documentation
88
may be either trademarks or registered trademarks of Microsoft in the United States and/or other countries.
99
The licenses for this project do not grant you rights to use any Microsoft names, logos, or trademarks.
10-
Microsoft's general trademark guidelines can be found at http://go.microsoft.com/fwlink/?LinkID=254653.
10+
Microsoft's general trademark guidelines can be found at https://go.microsoft.com/fwlink/?LinkID=254653.
1111

1212
Privacy information can be found at https://privacy.microsoft.com/en-us/
1313

docs/actionable-messages/actionable-email-dev-dashboard.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,13 +1,13 @@
11
---
22
title: Actionable messages via email developer dashboard guide | Microsoft Docs
3-
description: Learn about the actionable message developer dashboard.
3+
description: The developer dashboard helps you submit and track status of your submission via the web portal.
44
author: jasonjoh
5-
65
ms.topic: article
76
ms.technology: o365-connectors
87
ms.date: 05/07/2018
98
ms.author: jasonjoh
109
---
10+
1111
# Register your service with the actionable email developer dashboard
1212

1313
To test and publish actionable messages from your service, you need to provide certain information to Microsoft to enable this functionality for emails from your service. The [developer dashboard](https://aka.ms/publishoam) helps you submit and track status of your submission via the web portal.
@@ -111,8 +111,8 @@ There are some things you need to keep in mind when you submit your solution for
111111
- The top-level domain (TLD) of the SPF check or DKIM signature must match the TLD of your `From:` email address. For example, if you use `From: [email protected]` the DKIM or SPF must be for `contoso.com` or `-.contoso.com`.
112112
- Emails must come from a static email address, e.g. `[email protected]`.
113113
- Emails must follow the email sender guidelines.
114-
- See [Sending mail to Office 365](https://technet.microsoft.com/en-us/library/mt706217(v=exchg.150).aspx) for Office 365.
115-
- See [Policies, Practices, and Guidelines](https://mail.live.com/mail/policies.aspx) for Outlook.com.
114+
- See [Sending mail to Office 365](https://docs.microsoft.com/office365/SecurityCompliance/sending-mail-to-office-365) for Office 365.
115+
- See [Policies, Practices, and Guidelines](https://sendersupport.olc.protection.outlook.com/pm/policies.aspx) for Outlook.com.
116116
- See [M3AAWG Sender Best Practices](https://www.m3aawg.org/sites/default/files/document/M3AAWG_Senders_BCP_Ver3-2015-02.pdf) and [ReturnPath Sending Best Practices](https://help.returnpath.com/hc/en-us/articles/221634867-Sending-Best-Practices-PDF-) for industry guidelines.
117117
- Consistent history of sending a high volume of mail from your domain (order of hundred emails a day minimum to Office 365) for a few weeks at least.
118118
- A very low rate of spam complaints from users.

docs/actionable-messages/actionable-messages-via-connectors.md

Lines changed: 16 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -1,13 +1,13 @@
11
---
22
title: Get started with actionable messages via connectors | Microsoft Docs
3-
description: Learn how to create an actionable message card and send it via connectors.
3+
description: Learn how to create an actionable message card and send it via Office 365 connectors.
44
author: jasonjoh
5-
65
ms.topic: get-started-article
76
ms.technology: o365-connectors
87
ms.date: 05/09/2017
98
ms.author: jasonjoh
109
---
10+
1111
# Post an actionable message card to an Office 365 group
1212

1313
## Create an actionable message card
@@ -18,7 +18,7 @@ Go to [Card Playground](https://messagecardplayground.azurewebsites.net/) and pa
1818

1919
```json
2020
{
21-
"@context": "http://schema.org/extensions",
21+
"@context": "https://schema.org/extensions",
2222
"@type": "MessageCard",
2323
"themeColor": "0072C6",
2424
"title": "Visit the Outlook Dev Portal",
@@ -83,20 +83,24 @@ You'll need an Office 365 subscription to proceed. If you do not have an Office
8383

8484
The webhook URL should look similar to the following:
8585

86-
https://outlook.office365.com/webhook/a1269812-6d10-44b1-abc5-b84f93580ba0@9e7b80c7-d1eb-4b52-8582-76f921e416d9/IncomingWebhook/3fdd6767bae44ac58e5995547d66a4e4/f332c8d9-3397-4ac5-957b-b8e3fc465a8c
86+
`https://outlook.office365.com/webhook/a1269812-6d10-44b1-abc5-b84f93580ba0@9e7b80c7-d1eb-4b52-8582-76f921e416d9/IncomingWebhook/3fdd6767bae44ac58e5995547d66a4e4/f332c8d9-3397-4ac5-957b-b8e3fc465a8c`
8787

8888
### Send the message
8989

9090
Use [Postman](https://www.getpostman.com/) to post an actionable message payload to the webhook URL. Open Postman. Create a new tab if needed and configure the tab as follows:
9191

92-
- Click the **GET** and change to **POST**.
93-
- In the text box labeled `Enter request URL` paste the webhook URL.
94-
- Click **Body** underneath the URL, then select the **raw** option.
95-
- Click **Text** and change to **JSON (application/json)**.
96-
- Enter the message card JSON in the text area below.
92+
1. Click the **GET** and change to **POST**.
93+
94+
2. In the text box labeled `Enter request URL` paste the webhook URL.
95+
96+
3. Click **Body** underneath the URL, then select the **raw** option.
97+
98+
4. Click **Text** and change to **JSON (application/json)**.
99+
100+
5. Enter the message card JSON in the text area below.
97101

98-
The Postman window should look like this when you are done:
102+
The Postman window should look like this when you are done:
99103

100-
![The Postman request window configured to post a sample actionable message to a webhook URL](images/get-started/postman-setup.PNG)
104+
![The Postman request window configured to post a sample actionable message to a webhook URL](images/get-started/postman-setup.PNG)
101105

102-
Click **Send** to post the message.
106+
6. Click **Send** to post the message.

docs/actionable-messages/actionable-messages-via-email.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,13 +1,13 @@
11
---
22
title: Get started with actionable messages via email | Microsoft Docs
3-
description: Learn how to create an actionable message card and send it via email.
3+
description: Learn how to create an actionable message card and send it via Outlook or Office 365 email.
44
author: jasonjoh
5-
65
ms.topic: get-started-article
76
ms.technology: o365-connectors
87
ms.date: 07/09/2018
98
ms.author: jasonjoh
109
---
10+
1111
# Send an actionable message via email in Office 365
1212

1313
## Supported scenarios
@@ -215,7 +215,7 @@ To embed an actionable message card in an email message, we need to wrap the car
215215

216216
For examples of sending messages, see the following.
217217

218-
- [Send Actionable Message via Microsoft Graph](https://github.com/jasonjoh/send-actionable-message): A sample console app written in C# that sends an actionable message using [Microsoft Graph](https://graph.microsoft.io/en-us/docs/api-reference/v1.0/api/message_send).
218+
- [Send Actionable Message via Microsoft Graph](https://github.com/jasonjoh/send-actionable-message): A sample console app written in C# that sends an actionable message using [Microsoft Graph](https://developer.microsoft.com/en-us/graph).
219219
- [Send Actionable Message via SMTP](https://github.com/tony-zhu/SendActionableMessage): A sample Python script that sends an actionable message using the Office 365 SMTP server. It also includes a sample HTML payload for the actionable message email body.
220220

221221
### Perform actions

docs/actionable-messages/adaptive-card.md

Lines changed: 17 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -2,12 +2,12 @@
22
title: Designing Outlook actionable message cards with the Adaptive Card format | Microsoft Docs
33
description: Learn about the available fields for Outlook actionable message cards using the Adaptive Card format and design guidelines for creating an effective card.
44
author: jasonjoh
5-
65
ms.topic: article
76
ms.technology: o365-connectors
87
ms.date: 05/07/2018
98
ms.author: jasonjoh
109
---
10+
1111
# Designing Outlook Actionable Message cards with the Adaptive Card format
1212

1313
Outlook Actionable Messages cards are designed using the Adaptive Card format. The Adaptive Card format is a simple yet powerful declarative layout format that provides a lot of flexibility, allowing for visually rich cards. In this topic we'll cover the Outlook-specific features of the Adaptive Card format.
@@ -19,7 +19,7 @@ Outlook Actionable Messages cards are designed using the Adaptive Card format. T
1919
2020
## Card Playground
2121

22-
Our [Card Playground tool](http://messagecardplayground.azurewebsites.net) has been updated to support the Adaptive Card format. There you will find Adaptive Card samples (including the one below) that can help you get started crafting your own cards and also allows you to send those cards to your own Office 365 email account to see how they look in Outlook.
22+
Our [Card Playground tool](https://messagecardplayground.azurewebsites.net) has been updated to support the Adaptive Card format. There you will find Adaptive Card samples (including the one below) that can help you get started crafting your own cards and also allows you to send those cards to your own Office 365 email account to see how they look in Outlook.
2323

2424
## Adaptive Cards Designer (preview)
2525

@@ -40,7 +40,7 @@ Here is how this card is crafted:
4040

4141
```json
4242
{
43-
"$schema": "http://adaptivecards.io/schemas/adaptive-card.json",
43+
"$schema": "https://adaptivecards.io/schemas/adaptive-card.json",
4444
"version": "1.0",
4545
"type": "AdaptiveCard",
4646
"speak": "<s>Your flight is confirmed for you and 3 other passengers from San Francisco to Amsterdam on Friday, October 10 8:30 AM</s>",
@@ -121,7 +121,7 @@ Here is how this card is crafted:
121121
},
122122
{
123123
"type": "Image",
124-
"url": "http://messagecardplayground.azurewebsites.net/assets/airplane.png",
124+
"url": "https://messagecardplayground.azurewebsites.net/assets/airplane.png",
125125
"size": "small",
126126
"spacing": "none"
127127
}
@@ -193,7 +193,7 @@ Here is how this card is crafted:
193193
},
194194
{
195195
"type": "Image",
196-
"url": "http://messagecardplayground.azurewebsites.net/assets/airplane.png",
196+
"url": "https://messagecardplayground.azurewebsites.net/assets/airplane.png",
197197
"size": "small",
198198
"spacing": "none"
199199
}
@@ -299,7 +299,7 @@ Use `ColumnSet` only when you need to align several elements on a single horizon
299299
Outlook introduces a set of additional Adaptive Card properties and features for use in the context of Actionable Messages.
300300

301301
> [!IMPORTANT]
302-
> Outlook-specific Adaptive Card properties and features **only work in the context of Actionable Messages**. They will NOT work in other Adaptive Card enabled applications and are therefore not documented on the [official Adaptive Cards site](http://adaptivecards.io/).
302+
> Outlook-specific Adaptive Card properties and features **only work in the context of Actionable Messages**. They will NOT work in other Adaptive Card enabled applications and are therefore not documented on the [official Adaptive Cards site](https://adaptivecards.io/).
303303
304304
### Adaptive Card features not supported with Outlook Actionable Messages
305305

@@ -663,7 +663,7 @@ Please refer to the previous example for an illustration of how to use `isVisibl
663663

664664
### Additional properties on the AdaptiveCard type
665665

666-
The following additional properties can be specified on an [AdaptiveCard object](http://adaptivecards.io/explorer/AdaptiveCard.html) in the context of Outlook Actionable Messages:
666+
The following additional properties can be specified on an [AdaptiveCard object](https://adaptivecards.io/explorer/AdaptiveCard.html) in the context of Outlook Actionable Messages:
667667

668668
| Property name | Type | Required | Description |
669669
|---------------|------|----------|-------------|
@@ -674,7 +674,7 @@ The following additional properties can be specified on an [AdaptiveCard object]
674674

675675
### Additional properties on the Column type
676676

677-
The following additional properties can be specified on a [Column object](http://adaptivecards.io/explorer/Column.html) in the context of Outlook Actionable Messages:
677+
The following additional properties can be specified on a [Column object](https://adaptivecards.io/explorer/Column.html) in the context of Outlook Actionable Messages:
678678

679679
| Property name | Type | Required | Description |
680680
|---------------|------|----------|-------------|
@@ -697,7 +697,7 @@ If `width` is expressed as a string, it can have the following values:
697697

698698
```json
699699
{
700-
"$schema": "http://adaptivecards.io/schemas/adaptive-card.json",
700+
"$schema": "https://adaptivecards.io/schemas/adaptive-card.json",
701701
"type": "AdaptiveCard",
702702
"version": "1.0",
703703
"body": [
@@ -709,7 +709,7 @@ If `width` is expressed as a string, it can have the following values:
709709
"items": [
710710
{
711711
"type": "Image",
712-
"url": "http://adaptivecards.io/content/cats/1.png",
712+
"url": "https://adaptivecards.io/content/cats/1.png",
713713
"size": "stretch"
714714
}
715715
]
@@ -754,7 +754,7 @@ If `width` is expressed as a string, it can have the following values:
754754

755755
### Additional properties on the Container type
756756

757-
The following additional properties can be specified on a [Container object](http://adaptivecards.io/explorer/Container.html) in the context of Outlook Actionable Messages:
757+
The following additional properties can be specified on a [Container object](https://adaptivecards.io/explorer/Container.html) in the context of Outlook Actionable Messages:
758758

759759
| Property name | Type | Required | Description |
760760
|---------------|------|----------|-------------|
@@ -765,7 +765,7 @@ These properties behave exactly like their counterpart on the `Column` type. Ple
765765

766766
### Additional properties on the Image type
767767

768-
The following additional properties can be specified on an [Image object](http://adaptivecards.io/explorer/Image.html) in the context of Outlook Actionable Messages:
768+
The following additional properties can be specified on an [Image object](https://adaptivecards.io/explorer/Image.html) in the context of Outlook Actionable Messages:
769769

770770
| Property name | Type | Required | Description |
771771
|---------------|------|----------|-------------|
@@ -777,7 +777,7 @@ The following additional properties can be specified on an [Image object](http:/
777777

778778
```json
779779
{
780-
"$schema": "http://adaptivecards.io/schemas/adaptive-card.json",
780+
"$schema": "https://adaptivecards.io/schemas/adaptive-card.json",
781781
"type": "AdaptiveCard",
782782
"version": "1.0",
783783
"body": [
@@ -788,14 +788,14 @@ The following additional properties can be specified on an [Image object](http:/
788788
{
789789
"type": "Image",
790790
"width": "64px",
791-
"url": "http://messagecardplayground.azurewebsites.net/assets/circleontransparentbackground.png",
791+
"url": "https://messagecardplayground.azurewebsites.net/assets/circleontransparentbackground.png",
792792
"backgroundColor": "#FF0000"
793793
},
794794
{
795795
"type": "Image",
796796
"style": "person",
797797
"width": "64px",
798-
"url": "http://messagecardplayground.azurewebsites.net/assets/circleontransparentbackground.png",
798+
"url": "https://messagecardplayground.azurewebsites.net/assets/circleontransparentbackground.png",
799799
"backgroundColor": "#0000FF"
800800
}
801801
]
@@ -804,6 +804,6 @@ The following additional properties can be specified on an [Image object](http:/
804804

805805
![A screenshot of the Image properties example card](images/adaptive-image-properties.png)
806806

807-
## Additional resources
807+
## See also
808808

809-
- [Adaptive Card portal](http://adaptivecards.io)
809+
- [Adaptive Card portal](https://adaptivecards.io)

docs/actionable-messages/connectors-dev-dashboard.md

Lines changed: 4 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,7 @@
11
---
22
title: Connectors developer dashboard | Microsoft Docs
3-
description: Learn about the connectors developer dashboard.
3+
description: Register your connector in our developer portal, add an integrated configuration experience to your application, and implement your connector.
44
author: jasonjoh
5-
65
ms.topic: article
76
ms.technology: o365-connectors
87
ms.date: 08/02/2018
@@ -28,14 +27,14 @@ Choose **New Connector** and fill out the form. Once you choose **Save**, new op
2827

2928
An integrated configuration experience allows the user to configure your connector without leaving Outlook. Your application exposes the configuration as a web page that utilizes the Microsoft Teams JavaScript library to communicate configuration status back to Outlook.
3029

31-
For details, see [Integrating the configuration experience](/microsoftteams/platform/concepts/connectors/connectors-creating#integrating-the-configuration-experience).
30+
For details, see [Integrating the configuration experience](https://docs.microsoft.com/microsoftteams/platform/concepts/connectors/connectors-creating#integrating-the-configuration-experience).
3231

3332
> [!NOTE]
34-
> The [Integrating the configuration experience](/microsoftteams/platform/concepts/connectors/connectors-creating#integrating-the-configuration-experience) document is Microsoft Teams-specific, but the documented methods work the same way in Outlook.
33+
> The **Integrating the configuration experience** document is Microsoft Teams-specific, but the documented methods work the same way in Outlook.
3534
3635
#### Outlook-specific configuration requirements
3736

38-
If your configuration experience requires authentication, there are additional requirements to enable the [authentication flow](/microsoftteams/platform/concepts/authentication/auth-flow-tab) in Outlook on Windows.
37+
If your configuration experience requires authentication, there are additional requirements to enable the [authentication flow](https://docs.microsoft.com/microsoftteams/platform/concepts/authentication/auth-flow-tab) in Outlook on Windows.
3938

4039
Outlook on Windows passes an additional query parameter to your connectors authentication start page.
4140

docs/actionable-messages/get-started.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,12 +2,12 @@
22
title: Get started with actionable messages | Microsoft Docs
33
description: Get started with actionable messages. Learn about the available delivery mechanisms and applicable scenarios.
44
author: jasonjoh
5-
65
ms.topic: get-started-article
76
ms.technology: o365-connectors
87
ms.date: 05/09/2017
98
ms.author: jasonjoh
109
---
10+
1111
# Get started with actionable messages in Office 365
1212

1313
Actionable messages can be posted via a group or inbox connector, or can be sent directly over email. Choosing the right delivery mechanism depends on your scenario.

docs/actionable-messages/index.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,22 +1,22 @@
11
---
22
title: What are actionable messages in Office 365? | Microsoft Docs
3-
description: Learn about actionable messages in Outlook email and Office 365 Groups.
3+
description: Actionable Messages enable you to take quick actions right from within Outlook.
44
author: jasonjoh
5-
65
ms.topic: article
76
ms.technology: o365-connectors
87
ms.date: 08/02/2018
98
ms.author: jasonjoh
109
nodes_to_expand: get-started
1110
---
11+
1212
# Actionable messages in Outlook and Office 365 Groups
1313

1414
Whether you are filling out a survey, approving an expense report, or updating a CRM sales opportunity, Actionable Messages enable you to take quick actions right from within Outlook. Developers can now embed actions in their emails or notifications, elevating user engagement with their services and increasing organizational productivity.
1515

1616
Office 365 provides two solutions to enhance productivity with Outlook Actionable Messages: actionable messages via email, and actionable messages via Office 365 Connectors.
1717

1818
> [!NOTE]
19-
> Actionable messages are also available in Microsoft Teams. See [Office 365 Connectors for Teams](/microsoftteams/platform/concepts/connectors/connectors) for more information.
19+
> Actionable messages are also available in Microsoft Teams. See [Office 365 Connectors for Teams](https://docs.microsoft.com/microsoftteams/platform/concepts/connectors/connectors) for more information.
2020
2121
## User Experience
2222

0 commit comments

Comments
 (0)