Skip to content

Commit c44ecad

Browse files
committed
Additional notes on the asset provisioning article
1 parent f4c12a1 commit c44ecad

File tree

2 files changed

+27
-1
lines changed

2 files changed

+27
-1
lines changed

docs/spfx/toolchain/provision-sharepoint-assets.md

Lines changed: 27 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,13 @@
22

33
At times, you may need to provision a SharePoint list or a document library along with your client-side solution package so that that list or library is available for your client-side components, such as web parts. SharePoint Framework toolchain allows you to package and deploy SharePoint items with your client-side solution package. These items are then provisioned when the client-side solution is installed on a site.
44

5+
You can also find details on the provisioning options from a SharePoint PnP webcast available from [SharePoint PnP YouTube Channel](https://www.youtube.com/watch?v=r-UdJhhHlEQ&list=PLR9nK3mnD-OUnJytlXlO84fQnYt50iTmS).
6+
7+
<a href="https://www.youtube.com/watch?v=r-UdJhhHlEQ&list=PLR9nK3mnD-OUnJytlXlO84fQnYt50iTmS">
8+
<img src="../../../images/spfx-webcast-youtube-provision-feature-elements.png" alt="Screenshot of the YouTube video player for this tutorial" />
9+
</a>
10+
11+
512
## Provisioning items using JavaScript code
613

714
While it is possible to create SharePoint items using JavaScript code in your component, such as web parts, it is limited to context of the current user using that component. If the user doesn't have sufficient permissions to create or modify SharePoint items, the JavaScript code will not provision those items. In such cases, when you want to provision SharePoint items in an elevated context, you will need to package and deploy the items along with your solution package.
@@ -262,6 +269,8 @@ You may include new SharePoint items or update existing SharePoint items when yo
262269

263270
The `upgradeActions` JSON object array in the `package-solution.json` references the feature XML file(s) associated with the upgrade actions for your feature. At the least, an upgrade action file will define the element manifest XML file that will be executed when upgrading the feature.
264271

272+
When you are upgrading a SharePoint Framework solution, you will need to update also version attributes for both solution and feature, where the upgrade actions have been included. Solution version increase will indicate SharePoint and end users that there is a new version of the package available. Feature element version increase will ensure that the tasks defined in the upgrade actions are being processed as part of the solution upgrade.
273+
265274
Below is an example of an upgrade action file that applies an element manifest file during the upgrade:
266275

267276
```xml
@@ -306,4 +315,21 @@ Adds a new element to an existing Feature. When a Feature is upgraded, provision
306315

307316
**VersionRange**
308317

309-
Specifies a version range to which specified upgrade actions apply.
318+
Specifies a version range to which specified upgrade actions apply.
319+
320+
## Additional resources
321+
<a name="bk_addresources"> </a>
322+
323+
- [SharePoint PnP Webcast - Provisioning SharePoint assets for your SPFx solution](https://www.youtube.com/watch?v=r-UdJhhHlEQ&list=PLR9nK3mnD-OUnJytlXlO84fQnYt50iTmS)
324+
325+
- [Tutorial - Provisioning SharePoint assets from your SharePoint client-side web part](https://dev.office.com/sharepoint/docs/spfx/web-parts/get-started/provision-sp-assets-from-package)
326+
327+
- [SharePoint Building Block: Features](https://msdn.microsoft.com/en-us/library/ee537350.aspx)
328+
329+
- [Feature Framework - UpgradeAcctions element usage](https://msdn.microsoft.com/en-us/library/office/ee537575.aspx)
330+
331+
- [Feature Framework - Field Element](https://msdn.microsoft.com/en-us/library/aa979575.aspx)
332+
333+
- [Feature Framework - ContentType Element](https://msdn.microsoft.com/en-us/library/aa544268.aspx).aspx)
334+
335+
- [Feature Framework - ListInstance Element](https://msdn.microsoft.com/en-us/library/office/ms476062.aspx)
Loading

0 commit comments

Comments
 (0)