Skip to content

Commit bb16844

Browse files
PaoloPiaPaoloPia
committed
Merge branch 'main' of https://github.com/SharePoint/sp-dev-docs into bot-powered-articles
2 parents a9f1cfd + 67d18c2 commit bb16844

File tree

130 files changed

+2984
-835
lines changed

Some content is hidden

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

130 files changed

+2984
-835
lines changed

‎.openpublishing.redirection.json

Lines changed: 0 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -144,11 +144,6 @@
144144
"source_path": "docs/embedded/terms-of-service.md",
145145
"redirect_url": "/sharepoint/dev/embedded/overview",
146146
"redirect_document_id": false
147-
},
148-
{
149-
"source_path": "docs/embedded/tutorials/metadata.md",
150-
"redirect_url": "/sharepoint/dev/embedded/overview",
151-
"redirect_document_id": false
152147
}
153148
]
154149
}

‎README.md

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
# Welcome to the SharePoint Framework!
1+
# Welcome to the SharePoint Framework!
22

33
The SharePoint Framework (SPFx) is a page and part model that enables client-side development for building SharePoint experiences. It facilitates easy integration with the SharePoint data, and provides support for open source tooling development.
44

@@ -22,7 +22,6 @@ Review all the SPFx releases here from the [initial GA release in February 2017]
2222
* [Setup your Machine](https://learn.microsoft.com/sharepoint/dev/spfx/set-up-your-development-environment)
2323
* [Go build your first web part](https://learn.microsoft.com/sharepoint/dev/spfx/web-parts/get-started/build-a-hello-world-web-part)
2424

25-
2625
## Learn More
2726

2827
* [Background and Philosophy](https://learn.microsoft.com/sharepoint/dev/spfx/sharepoint-framework-overview)

‎docs/apis/csom-methods-for-applying-retention-labels.md

Lines changed: 92 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,18 +1,18 @@
11
---
2-
title: CSOM methods for applying retention labels
3-
description: CSOM methods are available to apply (set) a retention label (ComplianceTag) on one or many items (ListItems) in SharePoint.
2+
title: CSOM methods for retention labels
3+
description: CSOM methods are available to apply (set) a retention label (ComplianceTag) on one or many items (ListItems) in SharePoint. Also includes settings of retention labels in ODB and SPO.
44
author: kyracatwork
55
ms.author: kyrachurney
6-
ms.date: 4/18/2023
6+
ms.date: 9/30/2024
77
---
88

9-
# CSOM methods for applying retention labels (setting ComplianceTags)
9+
# CSOM methods for applying retention labels and managing settings of record labels
1010

1111
Retention labels let you apply retention settings for governance control at the item level, and are part of the Microsoft Purview compliance solutions. [Learn more about retention labels.](/microsoft-365/compliance/retention#retention-labels)
1212

1313
Retention labels may classify contents as records, which place restrictions on what actions are allowed or blocked. [Learn more about declaring records by using retention labels](/microsoft-365/compliance/declare-records)
1414

15-
CSOM methods are available to apply (set) a retention label (ComplianceTag) on one or many items (ListItems) in SharePoint. Retention labels can be applied using this method without being published to the ___location by an existing label policy.
15+
CSOM methods are available to apply (set) a retention label (ComplianceTag) on one or many items (ListItems) in SharePoint, and change retention labels settings for deleting, versioning, and changing properties of records. Retention labels can be applied using this method without being published to the ___location by an existing label policy.
1616

1717
## SetComplianceTagOnBulkItems
1818

@@ -34,6 +34,93 @@ public List<int> SetComplianceTagOnBulkItems(
3434

3535
Attribute [RemoteAttribute](/dotnet/api/microsoft.sharepoint.client.remoteattribute)
3636

37+
## GetAllowFilesWithKeepLabelToBeDeletedODB
38+
39+
Get whether files with Keep Label can be deleted in ODB.
40+
41+
42+
```c#
43+
44+
public static bool GetAllowFilesWithKeepLabelToBeDeletedODB()
45+
```
46+
47+
## SetAllowFilesWithKeepLabelToBeDeletedODB
48+
49+
Set whether files with Keep Label can be deleted in ODB
50+
51+
52+
```c#
53+
public static void SetAllowFilesWithKeepLabelToBeDeletedODB(bool allowDeletion)
54+
```
55+
56+
Parameters
57+
58+
- 'allowDeletion' [Boolean](/dotnet/api/system.boolean)
59+
60+
## GetAllowFilesWithKeepLabelToBeDeletedSPO
61+
Get whether files with Keep Label can be deleted in SPO.
62+
63+
```c#
64+
65+
public static bool GetAllowFilesWithKeepLabelToBeDeletedSPO()
66+
```
67+
68+
## SetAllowFilesWithKeepLabelToBeDeletedSPO
69+
70+
Set whether files with Keep Label can be deleted in SPO.
71+
72+
```c#
73+
public static void SetAllowFilesWithKeepLabelToBeDeletedSPO(bool allowDeletion)
74+
```
75+
76+
Parameters
77+
78+
- 'allowDeletion' [Boolean](/dotnet/api/system.boolean)
79+
80+
## GetAdvancedRecordVersioningDisabled
81+
82+
Get whether advanced record versioning is disabled.
83+
84+
```c#
85+
86+
public static bool GetAdvancedRecordVersioningDisabled()
87+
```
88+
89+
## SetAdvancedRecordVersioningDisabled
90+
91+
Set to enable or disable the advanced record versioning.
92+
93+
```c#
94+
public static void SetAdvancedRecordVersioningDisabled(bool disabled)
95+
```
96+
97+
Parameters
98+
99+
- 'disabled' [Boolean](/dotnet/api/system.boolean)
100+
101+
## GetMetadataEditBlockingEnabled
102+
103+
Get whether metadata edit blocking is enabled.
104+
105+
```c#
106+
107+
public static bool GetMetadataEditBlockingEnabled()
108+
109+
```
110+
111+
## SetMetadataEditBlockingEnabled
112+
113+
Set metadata edit blocking enabled setting.
114+
115+
116+
```c#
117+
public static void SetMetadataEditBlockingEnabled(bool enabled)
118+
```
119+
120+
Parameters
121+
122+
- 'enabled' [Boolean](/dotnet/api/system.boolean)
123+
37124
### Applies to
38125

39126
|Product|Versions|

‎docs/apis/migration-api-overview.md

Lines changed: 12 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: "SharePoint Import Migration API"
33
description: "This article provides overview information on how to use the SharePoint Migration API."
4-
ms.date: 04/28/2024
4+
ms.date: 07/03/2024
55
ms.author: ranren
66
author: underreview
77
manager: dapodean
@@ -21,6 +21,10 @@ Use Migration API to migrate content from file shares, SharePoint Server, and ot
2121

2222
## What's new
2323

24+
### July 2024
25+
26+
We started enforcing HTTPS connection to SharePoint provided Azure Blob Storage Containers by adding a `spr=https` field in SAS tokens. This enforcement is fully effective on July 21, 2024. Check [Use Azure Blob Storage Containers and Azure Queues with SharePoint Migration API](migration-azure.md) for details.
27+
2428
### April 2024
2529

2630
We added new fields in ``JobEnd`` events to indicate the count and bytes imported for files. Check [Migration events in Azure Queue](migration-events.md#jobend-import) for details.
@@ -61,7 +65,7 @@ Migration API generates logs in the manifest container. Check the log entries fo
6165

6266
### Use app-based authentication
6367

64-
Migration generates workload to the SPO backend differently from end user-generated traffic. To properly allocate resources with our elastic capability, only use app-based authentication in your migration solution.
68+
Migration generates workload to the SharePoint backend differently from end user-generated traffic. To properly allocate resources with our elastic capability, only use app-based authentication in your migration solution.
6569

6670
Don't use user mode in your migration solution. Running migration in user mode triggers increased throttling, resulting in poor performance.
6771

@@ -82,28 +86,28 @@ For service-based migration tools that run without a signed-in user present, suc
8286

8387
You can choose to share a single App ID to cover multiple migration solutions created or create individual App ID for each of the products. Make sure to register App IDs. Sharing App IDs doesn't affect performance or throttling.
8488

85-
### Keep destination SPO site unactivated
89+
### Keep destination SharePoint Site unactivated
8690

87-
To avoid migration issues, deactivate the target site for users until the migration completion. The source could remain active, allowing read and write to keep productivity. Switch users to the new SPO destination sites after migration completion.
91+
To avoid migration issues, deactivate the target site for users until the migration completion. The source could remain active, allowing read and write to keep productivity. Switch users to the new SharePoint destination sites after migration completion.
8892

8993
## Performance
9094

91-
Migration API processes jobs through a queue mechanism with pre-configured workload management settings. Migration API processes the jobs on a best-effort basis, without Service Level Agreement (SLA) or guaranteed performance.
95+
Migration API processes jobs through a queue mechanism with preconfigured workload management settings. Migration API processes the jobs on a best-effort basis, without Service Level Agreement (SLA) or guaranteed performance.
9296

9397
### Optimize migration performance
9498

9599
In order to ensure optimal performance for your migration projects, it's important to plan carefully, especially when dealing with large-scale migrations. For more information on how to estimate timespans and optimize performance, see our [performance guide](/sharepointmigration/sharepoint-online-and-onedrive-migration-speed).
96100

97101
### I'm seeing throttling messages
98102

99-
To ensure good user experiences for all Microsoft 365 customers, SharePoint uses throttling to protect the SharePoint Online infrastructure. Avoid getting throttled by following [throttling guidance](https://aka.ms/spo429).
103+
To ensure good user experiences for all Microsoft 365 customers, SharePoint uses throttling to protect the SharePoint infrastructure. Avoid getting throttled by following [throttling guidance](https://aka.ms/spo429).
100104

101-
## Special topics
105+
## Special articles
102106

103107
### Migrating sharing events of files and folders
104108

105109
Check [Sharing events](/sharepoint/dev/apis/migration-api-shared) article for instructions when migrating shared events metadata with files and folders.
106110

107111
### Web Parts
108112

109-
Use SPMT's Web Part serializer DLL to migrate Web Parts into SharePoint. Check [Migrate Web Parts](/sharepoint/dev/apis/migrate-webparts-with-migrationapi) for instructions.
113+
Use SharePoint Migration Tool (SPMT)'s Web Part serializer DLL to migrate Web Parts into SharePoint. Check [Migrate Web Parts](/sharepoint/dev/apis/migrate-webparts-with-migrationapi) for instructions.

‎docs/apis/migration-azure.md

Lines changed: 9 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: "Use Azure Blob Storage Containers and Azure Queues with SharePoint Migration API"
33
description: "This article provides in-depth information on how to use the SharePoint Migration API with Azure Containers and Queues."
4-
ms.date: 05/08/2024
4+
ms.date: 07/03/2024
55
ms.author: ranren
66
author: underreview
77
manager: dapodean
@@ -32,9 +32,9 @@ Migration API provisions the containers in the same datacenter of the SharePoint
3232

3333
Migration API destroys Used containers 30-90 days after completing migration jobs.
3434

35-
#### Decorate the traffic to avoid throttling
35+
#### Avoid throttling by decorating the traffic
3636

37-
[Decorate your HTTP traffic](/sharepoint/dev/general-development/how-to-avoid-getting-throttled-or-blocked-in-sharepoint-online#how-to-decorate-your-http-traffic) to avoid throttling.
37+
Avoid throttling by [decorating your HTTP traffic](/sharepoint/dev/general-development/how-to-avoid-getting-throttled-or-blocked-in-sharepoint-online#how-to-decorate-your-http-traffic).
3838

3939
#### Encryption
4040

@@ -76,6 +76,8 @@ Pass this value to `CreateMigrationJob` method as `azureContainerSourceUri` para
7676

7777
The SAS access token contains `Read` and `Write` permissions only. It doesn't contain `List`.
7878

79+
SharePoint enforces HTTPS connections to containers by setting `spr=https` field in SAS tokens.
80+
7981
###### MetadataContainer value
8082

8183
A **Uri** value containing the URI of the newly created container for storing **manifest** files, along with the SAS access token.
@@ -84,6 +86,8 @@ Pass this value to `CreateMigrationJob` method as `azureContainerManifestUri` pa
8486

8587
The SAS access token contains `Read` and `Write` permissions only. It doesn't contain `List`.
8688

89+
SharePoint enforces HTTPS connections to containers by setting `spr=https` field in SAS tokens.
90+
8791
###### EncryptionKey
8892

8993
A **Byte Array** value containing the AES256CBC encryption key for both containers provisioned.
@@ -102,9 +106,9 @@ Alternatively, use user-provided Azure Queues if desired. Check the requirement
102106

103107
### Azure Queue Encryption
104108

105-
When using `CreateMigrationJobEncrypted` method, Migration API encrypts the messages written to the Azure Queue.
109+
`CreateMigrationJobEncrypted` method encrypts the messages written to the Azure Queue.
106110

107-
Make sure you preserve `JobId` and the `IV` values returned by `CreateMigrationJobEncrypted` method, to decrypt the message.
111+
To decrypt the messages, make sure you preserve `JobId` and the `IV` values returned by `CreateMigrationJobEncrypted` method.
108112

109113
#### Encrypted message sample
110114

‎docs/business-apps/power-automate/guidance/working-with-send-sp-http-request.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -16,6 +16,8 @@ To work effectively with the SharePoint Send HTTP Request action, see the follow
1616

1717
> [!NOTE]
1818
> This is a developer-focused action. You must understand how SharePoint REST API works and also how to parse JSON strings in Power Automate.
19+
>
20+
> Additionally, this action only supports SharePoint REST APIs (excluding any deprecated APIs), if you need to access another Microsoft service, you will need to leverage the "HTTP with Microsoft Entra ID" connector.
1921
2022
## Get to know the SharePoint REST/OData APIs
2123

‎docs/business-apps/power-automate/sharepoint-connector-actions-triggers.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: Microsoft SharePoint Connector for Power Automate
33
description: In Power Automate, Microsoft SharePoint Connector supports the following flow triggers and actions.
4-
ms.date: 06/22/2023
4+
ms.date: 10/23/2024
55
ms.service: power-automate
66
search.app:
77
- Flow
@@ -32,7 +32,7 @@ For more info about how to use this trigger, see this tutorial video: [Introduci
3232

3333
### When an item is deleted
3434

35-
Triggers the flow when you delete an item in a list. To get the properties of a deleted item, you must connect this trigger to the associated SharePoint site on which it is expected to run, using a site collection user account.
35+
Triggers the flow when you delete an item in a list. To get the properties of a deleted item, you must connect this trigger to the associated SharePoint site on which it is expected to run, using a site collection admin account.
3636

3737
### For a selected item
3838

@@ -59,7 +59,7 @@ Triggers the flow when you create a file in a SharePoint folder. This trigger do
5959

6060
### When a file is created or modified (properties only)
6161

62-
Triggers the flow when you create a file, and each time you modify the file properties in a library. Specify a value in the "Folder" property to target a specific folder; otherwise the trigger applies to the entire library. Returns only the custom file properties associated with that file.
62+
Triggers the flow when you create a file, and each time you modify the file properties in a library. Specify a value in the "Folder" property to target a specific folder; otherwise, the trigger applies to the entire library. Returns only the custom file properties associated with that file.
6363

6464
### When a file is created or modified in a folder [deprecated]
6565

@@ -70,7 +70,7 @@ Triggers when a file is created, and also each time it is modified in a SharePoi
7070

7171
### When a file is deleted
7272

73-
Triggers the flow when you delete a file in a document library. You can optionally specify a folder to watch. When you delete a folder, the trigger activates only once for the deleted folder, including its subfolders. To get the properties of the deleted file, you must connect this trigger to the associated SharePoint site on which the trigger is expected to run, using a site collection user account.
73+
Triggers the flow when you delete a file in a document library. You can optionally specify a folder to watch. When you delete a folder, the trigger activates only once for the deleted folder, including its subfolders. To get the properties of the deleted file, you must connect this trigger to the associated SharePoint site on which the trigger is expected to run, using a site collection admin account.
7474

7575
### For a selected file
7676

‎docs/community/open-source-projects.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@ There are numerous open-source projects that are coordinated by the SharePoint P
1212
| Repository | Description |
1313
|--------|--------|
1414
| [SharePoint Starter kit](https://github.com/SharePoint/sp-starter-kit) | A starter kit for showing how to extend modern experiences in SharePoint Online by extending them with modern extensibility options. |
15-
| [SharePoint Provisioning Service templates](https://github.com/SharePoint/sp-dev-provisioning-templates) | Tenant templates used by the [SharePoint Provisioning Service](https://lookbook.microsoft.com/service-description) to easily provision sample content and structures demonstrating what's possible with modern SharePoint experiences. |
15+
| [SharePoint Provisioning Service templates](https://github.com/SharePoint/sp-dev-provisioning-templates) | Tenant templates previously used by the Look Book Services to easily provision sample content and structures demonstrating what's possible with modern SharePoint experiences. |
1616
| [CLI for Microsoft 365](https://pnp.github.io/cli-microsoft365/) | A cross-platform command-line interface (CLI) that allows users on any platform to manage their Microsoft 365 and SharePoint Framework projects. |
1717
| [Office 365 Developer PnP Core Component](https://github.com/SharePoint/PnP-Sites-Core) | An extension component that encapsulates commonly used remote CSOM/REST operations as reusable extension methods on out-of-the box CSOM objects. |
1818
| [PnP PowerShell cmdlets](/powershell/sharepoint/sharepoint-pnp/sharepoint-pnp-cmdlets) | Allow you to perform complex provisioning and artifact management actions for SharePoint. The commands use CSOM and can work against both SharePoint Online as well as SharePoint on-premises. |

0 commit comments

Comments
 (0)