Skip to content

Commit 8cc36a9

Browse files
authored
Merge pull request #206907 from Clare-Zheng82/0804-Update_Office_365_docs_name
Update Office 365 name in Office 365 docs
2 parents fe4b4ab + db0e288 commit 8cc36a9

File tree

4 files changed

+57
-57
lines changed

4 files changed

+57
-57
lines changed

articles/data-factory/TOC.yml

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -74,7 +74,7 @@ items:
7474
displayName: polybase
7575
- name: From SAP BW to Azure Data Lake Storage Gen2
7676
href: load-sap-bw-data.md
77-
- name: From Office 365 to Azure Blob storage
77+
- name: From Microsoft 365 to Azure Blob storage
7878
href: load-office-365-data.md
7979
- name: Multiple tables in bulk
8080
items:
@@ -468,6 +468,9 @@ items:
468468
href: connector-mariadb.md
469469
- name: Marketo
470470
href: connector-marketo.md
471+
- name: Microsoft 365
472+
href: connector-office-365.md
473+
displayName: active directory
471474
- name: Microsoft Access
472475
href: connector-microsoft-access.md
473476
- name: MongoDB
@@ -486,9 +489,6 @@ items:
486489
displayName: timeout
487490
- name: ODBC
488491
href: connector-odbc.md
489-
- name: Office 365
490-
href: connector-office-365.md
491-
displayName: active directory
492492
- name: Oracle
493493
href: connector-oracle.md
494494
- name: Oracle Cloud Storage

articles/data-factory/connector-office-365.md

Lines changed: 36 additions & 36 deletions
Original file line numberDiff line numberDiff line change
@@ -1,55 +1,55 @@
11
---
2-
title: Copy data from Office 365
2+
title: Copy data from Microsoft 365 (Office 365)
33
titleSuffix: Azure Data Factory & Azure Synapse
4-
description: Learn how to copy data from Office 365 to supported sink data stores by using copy activity in an Azure Data Factory or Synapse Analytics pipeline.
4+
description: Learn how to copy data from Microsoft 365 (Office 365) to supported sink data stores by using copy activity in an Azure Data Factory or Synapse Analytics pipeline.
55
author: jianleishen
66
ms.service: data-factory
77
ms.subservice: data-movement
88
ms.custom: synapse
99
ms.topic: conceptual
10-
ms.date: 03/04/2022
10+
ms.date: 08/04/2022
1111
ms.author: jianleishen
1212
---
13-
# Copy data from Office 365 into Azure using Azure Data Factory or Synapse Analytics
13+
# Copy data from Microsoft 365 (Office 365) into Azure using Azure Data Factory or Synapse Analytics
1414
[!INCLUDE[appliesto-adf-asa-md](includes/appliesto-adf-asa-md.md)]
1515

16-
Azure Data Factory and Synapse Analytics pipelines integrate with [Microsoft Graph data connect](/graph/data-connect-concept-overview), allowing you to bring the rich organizational data in your Office 365 tenant into Azure in a scalable way and build analytics applications and extract insights based on these valuable data assets. Integration with Privileged Access Management provides secured access control for the valuable curated data in Office 365. Please refer to [this link](/graph/data-connect-concept-overview) for an overview on Microsoft Graph data connect and refer to [this link](/graph/data-connect-policies#licensing) for licensing information.
16+
Azure Data Factory and Synapse Analytics pipelines integrate with [Microsoft Graph data connect](/graph/data-connect-concept-overview), allowing you to bring the rich organizational data in your Microsoft 365 (Office 365) tenant into Azure in a scalable way and build analytics applications and extract insights based on these valuable data assets. Integration with Privileged Access Management provides secured access control for the valuable curated data in Microsoft 365 (Office 365). Please refer to [this link](/graph/data-connect-concept-overview) for an overview on Microsoft Graph data connect and refer to [this link](/graph/data-connect-policies#licensing) for licensing information.
1717

18-
This article outlines how to use the Copy Activity to copy data from Office 365. It builds on the [copy activity overview](copy-activity-overview.md) article that presents a general overview of copy activity.
18+
This article outlines how to use the Copy Activity to copy data from Microsoft 365 (Office 365). It builds on the [copy activity overview](copy-activity-overview.md) article that presents a general overview of copy activity.
1919

2020
## Supported capabilities
2121

22-
This Office 365 connector is supported for the following capabilities:
22+
This Microsoft 365 (Office 365) connector is supported for the following capabilities:
2323

2424
| Supported capabilities|IR |
2525
|---------| --------|
2626
|[Copy activity](copy-activity-overview.md) (source/-)|① ②|
2727

2828
<small>*&#9312; Azure integration runtime &#9313; Self-hosted integration runtime*</small>
2929

30-
ADF Office 365 connector and Microsoft Graph data connect enables at scale ingestion of different types of datasets from Exchange Email enabled mailboxes, including address book contacts, calendar events, email messages, user information, mailbox settings, and so on. Refer [here](/graph/data-connect-datasets) to see the complete list of datasets available.
30+
ADF Microsoft 365 (Office 365) connector and Microsoft Graph data connect enables at scale ingestion of different types of datasets from Exchange Email enabled mailboxes, including address book contacts, calendar events, email messages, user information, mailbox settings, and so on. Refer [here](/graph/data-connect-datasets) to see the complete list of datasets available.
3131

32-
For now, within a single copy activity you can only **copy data from Office 365 into [Azure Blob Storage](connector-azure-blob-storage.md), [Azure Data Lake Storage Gen1](connector-azure-data-lake-store.md), and [Azure Data Lake Storage Gen2](connector-azure-data-lake-storage.md) in JSON format** (type setOfObjects). If you want to load Office 365 into other types of data stores or in other formats, you can chain the first copy activity with a subsequent copy activity to further load data into any of the [supported ADF destination stores](copy-activity-overview.md#supported-data-stores-and-formats) (refer to "supported as a sink" column in the "Supported data stores and formats" table).
32+
For now, within a single copy activity you can only **copy data from Microsoft 365 (Office 365) into [Azure Blob Storage](connector-azure-blob-storage.md), [Azure Data Lake Storage Gen1](connector-azure-data-lake-store.md), and [Azure Data Lake Storage Gen2](connector-azure-data-lake-storage.md) in JSON format** (type setOfObjects). If you want to load Microsoft 365 (Office 365) into other types of data stores or in other formats, you can chain the first copy activity with a subsequent copy activity to further load data into any of the [supported ADF destination stores](copy-activity-overview.md#supported-data-stores-and-formats) (refer to "supported as a sink" column in the "Supported data stores and formats" table).
3333

3434
>[!IMPORTANT]
35-
>- The Azure subscription containing the data factory or Synapse workspace and the sink data store must be under the same Azure Active Directory (Azure AD) tenant as Office 365 tenant.
36-
>- Ensure the Azure Integration Runtime region used for copy activity as well as the destination is in the same region where the Office 365 tenant users' mailbox is located. Refer [here](concepts-integration-runtime.md#integration-runtime-location) to understand how the Azure IR location is determined. Refer to [table here](/graph/data-connect-datasets#regions) for the list of supported Office regions and corresponding Azure regions.
35+
>- The Azure subscription containing the data factory or Synapse workspace and the sink data store must be under the same Azure Active Directory (Azure AD) tenant as Microsoft 365 (Office 365) tenant.
36+
>- Ensure the Azure Integration Runtime region used for copy activity as well as the destination is in the same region where the Microsoft 365 (Office 365) tenant users' mailbox is located. Refer [here](concepts-integration-runtime.md#integration-runtime-location) to understand how the Azure IR location is determined. Refer to [table here](/graph/data-connect-datasets#regions) for the list of supported Office regions and corresponding Azure regions.
3737
>- Service Principal authentication is the only authentication mechanism supported for Azure Blob Storage, Azure Data Lake Storage Gen1, and Azure Data Lake Storage Gen2 as destination stores.
3838
3939
> [!Note]
4040
> Please use Azure integration runtime in both source and sink linked services. The self-hosted integration runtime and the managed virtual network integration runtime are not supported.
4141
4242
## Prerequisites
4343

44-
To copy data from Office 365 into Azure, you need to complete the following prerequisite steps:
44+
To copy data from Microsoft 365 (Office 365) into Azure, you need to complete the following prerequisite steps:
4545

46-
- Your Office 365 tenant admin must complete on-boarding actions as described [here](/events/build-may-2021/microsoft-365-teams/breakouts/od483/).
46+
- Your Microsoft 365 (Office 365) tenant admin must complete on-boarding actions as described [here](/events/build-may-2021/microsoft-365-teams/breakouts/od483/).
4747
- Create and configure an Azure AD web application in Azure Active Directory. For instructions, see [Create an Azure AD application](../active-directory/develop/howto-create-service-principal-portal.md#register-an-application-with-azure-ad-and-create-a-service-principal).
48-
- Make note of the following values, which you will use to define the linked service for Office 365:
48+
- Make note of the following values, which you will use to define the linked service for Microsoft 365 (Office 365):
4949
- Tenant ID. For instructions, see [Get tenant ID](../active-directory/develop/howto-create-service-principal-portal.md#get-tenant-and-app-id-values-for-signing-in).
5050
- Application ID and Application key. For instructions, see [Get application ID and authentication key](../active-directory/develop/howto-create-service-principal-portal.md#get-tenant-and-app-id-values-for-signing-in).
5151
- Add the user identity who will be making the data access request as the owner of the Azure AD web application (from the Azure AD web application > Settings > Owners > Add owner).
52-
- The user identity must be in the Office 365 organization you are getting data from and must not be a Guest user.
52+
- The user identity must be in the Microsoft 365 (Office 365) organization you are getting data from and must not be a Guest user.
5353

5454
## Approving new data access requests
5555

@@ -61,7 +61,7 @@ Refer [here](/graph/data-connect-faq#how-can-i-approve-pam-requests-via-microsof
6161
## Getting started
6262

6363
>[!TIP]
64-
>For a walkthrough of using Office 365 connector, see [Load data from Office 365](load-office-365-data.md) article.
64+
>For a walkthrough of using Microsoft 365 (Office 365) connector, see [Load data from Microsoft 365 (Office 365)](load-office-365-data.md) article.
6565
6666
You can create a pipeline with the copy activity by using one of the following tools or SDKs. Select a link to go to a tutorial with step-by-step instructions to create a pipeline with a copy activity.
6767

@@ -72,9 +72,9 @@ You can create a pipeline with the copy activity by using one of the following t
7272
- [REST API](quickstart-create-data-factory-rest-api.md)
7373
- [Azure Resource Manager template](quickstart-create-data-factory-resource-manager-template.md).
7474

75-
## Create a linked service to Office 365 using UI
75+
## Create a linked service to Microsoft 365 (Office 365) using UI
7676

77-
Use the following steps to create a linked service to Office 365 in the Azure portal UI.
77+
Use the following steps to create a linked service to Microsoft 365 (Office 365) in the Azure portal UI.
7878

7979
1. Browse to the Manage tab in your Azure Data Factory or Synapse workspace and select Linked Services, then click New:
8080

@@ -86,34 +86,34 @@ Use the following steps to create a linked service to Office 365 in the Azure po
8686

8787
:::image type="content" source="media/doc-common-process/new-linked-service-synapse.png" alt-text="Screenshot of creating a new linked service with Azure Synapse UI.":::
8888

89-
2. Search for Office and select the Office 365 connector.
89+
2. Search for Microsoft 365 (Office 365) and select the Microsoft 365 (Office 365) connector.
9090

91-
:::image type="content" source="media/connector-office-365/office-365-connector.png" alt-text="Screenshot of the Office 365 connector.":::
91+
:::image type="content" source="media/connector-office-365/office-365-connector.png" alt-text="Screenshot of the Microsoft 365 (Office 365) connector.":::
9292

9393
1. Configure the service details, test the connection, and create the new linked service.
9494

95-
:::image type="content" source="media/connector-office-365/configure-office-365-linked-service.png" alt-text="Screenshot of linked service configuration for Office 365.":::
95+
:::image type="content" source="media/connector-office-365/configure-office-365-linked-service.png" alt-text="Screenshot of linked service configuration for Microsoft 365 (Office 365).":::
9696

9797
## Connector configuration details
9898

99-
The following sections provide details about properties that are used to define Data Factory entities specific to Office 365 connector.
99+
The following sections provide details about properties that are used to define Data Factory entities specific to Microsoft 365 (Office 365) connector.
100100

101101
## Linked service properties
102102

103-
The following properties are supported for Office 365 linked service:
103+
The following properties are supported for Microsoft 365 (Office 365) linked service:
104104

105105
| Property | Description | Required |
106106
|:--- |:--- |:--- |
107107
| type | The type property must be set to: **Office365** | Yes |
108-
| office365TenantId | Azure tenant ID to which the Office 365 account belongs. | Yes |
108+
| office365TenantId | Azure tenant ID to which the Microsoft 365 (Office 365) account belongs. | Yes |
109109
| servicePrincipalTenantId | Specify the tenant information under which your Azure AD web application resides. | Yes |
110110
| servicePrincipalId | Specify the application's client ID. | Yes |
111111
| servicePrincipalKey | Specify the application's key. Mark this field as a SecureString to store it securely. | Yes |
112112
| connectVia | The Integration Runtime to be used to connect to the data store. If not specified, it uses the default Azure Integration Runtime. | No |
113113

114114
>[!NOTE]
115115
> The difference between **office365TenantId** and **servicePrincipalTenantId** and the corresponding value to provide:
116-
>- If you are an enterprise developer developing an application against Office 365 data for your own organization's usage, then you should supply the same tenant ID for both properties, which is your organization's AAD tenant ID.
116+
>- If you are an enterprise developer developing an application against Microsoft 365 (Office 365) data for your own organization's usage, then you should supply the same tenant ID for both properties, which is your organization's AAD tenant ID.
117117
>- If you are an ISV developer developing an application for your customers, then office365TenantId will be your customer's (application installer) AAD tenant ID and servicePrincipalTenantId will be your company's AAD tenant ID.
118118
119119
**Example:**
@@ -124,7 +124,7 @@ The following properties are supported for Office 365 linked service:
124124
"properties": {
125125
"type": "Office365",
126126
"typeProperties": {
127-
"office365TenantId": "<Office 365 tenant id>",
127+
"office365TenantId": "<Microsoft 365 (Office 365) tenant id>",
128128
"servicePrincipalTenantId": "<AAD app service principal tenant id>",
129129
"servicePrincipalId": "<AAD app service principal id>",
130130
"servicePrincipalKey": {
@@ -138,14 +138,14 @@ The following properties are supported for Office 365 linked service:
138138

139139
## Dataset properties
140140

141-
For a full list of sections and properties available for defining datasets, see the [datasets](concepts-datasets-linked-services.md) article. This section provides a list of properties supported by Office 365 dataset.
141+
For a full list of sections and properties available for defining datasets, see the [datasets](concepts-datasets-linked-services.md) article. This section provides a list of properties supported by Microsoft 365 (Office 365) dataset.
142142

143-
To copy data from Office 365, the following properties are supported:
143+
To copy data from Microsoft 365 (Office 365), the following properties are supported:
144144

145145
| Property | Description | Required |
146146
|:--- |:--- |:--- |
147147
| type | The type property of the dataset must be set to: **Office365Table** | Yes |
148-
| tableName | Name of the dataset to extract from Office 365. Refer [here](/graph/data-connect-datasets#datasets) for the list of Office 365 datasets available for extraction. | Yes |
148+
| tableName | Name of the dataset to extract from Microsoft 365 (Office 365). Refer [here](/graph/data-connect-datasets#datasets) for the list of Microsoft 365 (Office 365) datasets available for extraction. | Yes |
149149

150150
If you were setting `dateFilterColumn`, `startTime`, `endTime`, and `userScopeFilterUri` in dataset, it is still supported as-is, while you are suggested to use the new model in activity source going forward.
151151

@@ -157,7 +157,7 @@ If you were setting `dateFilterColumn`, `startTime`, `endTime`, and `userScopeFi
157157
"properties": {
158158
"type": "Office365Table",
159159
"linkedServiceName": {
160-
"referenceName": "<Office 365 linked service name>",
160+
"referenceName": "<Microsoft 365 (Office 365) linked service name>",
161161
"type": "LinkedServiceReference"
162162
},
163163
"schema": [],
@@ -170,18 +170,18 @@ If you were setting `dateFilterColumn`, `startTime`, `endTime`, and `userScopeFi
170170

171171
## Copy activity properties
172172

173-
For a full list of sections and properties available for defining activities, see the [Pipelines](concepts-pipelines-activities.md) article. This section provides a list of properties supported by Office 365 source.
173+
For a full list of sections and properties available for defining activities, see the [Pipelines](concepts-pipelines-activities.md) article. This section provides a list of properties supported by Microsoft 365 (Office 365) source.
174174

175-
### Office 365 as source
175+
### Microsoft 365 (Office 365) as source
176176

177-
To copy data from Office 365, the following properties are supported in the copy activity **source** section:
177+
To copy data from Microsoft 365 (Office 365), the following properties are supported in the copy activity **source** section:
178178

179179
| Property | Description | Required |
180180
|:--- |:--- |:--- |
181181
| type | The type property of the copy activity source must be set to: **Office365Source** | Yes |
182182
| allowedGroups | Group selection predicate. Use this property to select up to 10 user groups for whom the data will be retrieved. If no groups are specified, then data will be returned for the entire organization. | No |
183-
| userScopeFilterUri | When `allowedGroups` property is not specified, you can use a predicate expression that is applied on the entire tenant to filter the specific rows to extract from Office 365. The predicate format should match the query format of Microsoft Graph APIs, e.g. `https://graph.microsoft.com/v1.0/users?$filter=Department eq 'Finance'`. | No |
184-
| dateFilterColumn | Name of the DateTime filter column. Use this property to limit the time range for which Office 365 data is extracted. | Yes if dataset has one or more DateTime columns. Refer [here](/graph/data-connect-filtering#filtering) for list of datasets that require this DateTime filter. |
183+
| userScopeFilterUri | When `allowedGroups` property is not specified, you can use a predicate expression that is applied on the entire tenant to filter the specific rows to extract from Microsoft 365 (Office 365). The predicate format should match the query format of Microsoft Graph APIs, e.g. `https://graph.microsoft.com/v1.0/users?$filter=Department eq 'Finance'`. | No |
184+
| dateFilterColumn | Name of the DateTime filter column. Use this property to limit the time range for which Microsoft 365 (Office 365) data is extracted. | Yes if dataset has one or more DateTime columns. Refer [here](/graph/data-connect-filtering#filtering) for list of datasets that require this DateTime filter. |
185185
| startTime | Start DateTime value to filter on. | Yes if `dateFilterColumn` is specified |
186186
| endTime | End DateTime value to filter on. | Yes if `dateFilterColumn` is specified |
187187
| outputColumns | Array of the columns to copy to sink. | No |
@@ -195,7 +195,7 @@ To copy data from Office 365, the following properties are supported in the copy
195195
"type": "Copy",
196196
"inputs": [
197197
{
198-
"referenceName": "<Office 365 input dataset name>",
198+
"referenceName": "<Microsoft 365 (Office 365) input dataset name>",
199199
"type": "DatasetReference"
200200
}
201201
],

0 commit comments

Comments
 (0)