Merge branch 'pnp:dev' into dev

Author: wuxiaojun514

.yo-rc.json

@@ -5,8 +5,15 @@
     "libraryId": "92b1e52c-a5fa-490a-bcf4-76080f39442c",
     "environment": "spo",
     "isDomainIsolated": false,
-    "isCreatingSolution": true,
+    "isCreatingSolution": false,
     "packageManager": "npm",
-    "componentType": "webpart"
+    "plusBeta": false,
+    "nodeVersion": "16.15.0",
+    "sdksVersions": {
+      "@microsoft/microsoft-graph-client": "3.0.2",
+      "@microsoft/teams-js": "2.4.1"
+    },
+    "componentType": "extension",
+    "extensionType": "ApplicationCustomizer"
   }
 }

CHANGELOG.json

@@ -14,20 +14,28 @@
           "`DynamicForm`: Add `respectETag` option to `DynamicForm` [#1395](https://github.com/pnp/sp-dev-fx-controls-react/issues/1395)",
           "`MonacoEditor`: Fixed minor typos and misleading instructions [#1415](https://github.com/pnp/sp-dev-fx-controls-react/pull/1415)",
           "SharePoint Framework v1.16.1 support [#1427](https://github.com/pnp/sp-dev-fx-controls-react/issues/1427)",
-          "`RichText`: `label` property is missing [#1375](https://github.com/pnp/sp-dev-fx-controls-react/issues/1375)"
+          "`RichText`: `label` property is missing [#1375](https://github.com/pnp/sp-dev-fx-controls-react/issues/1375)",
+          "`PeoplePicker`: PeopleSearch service should also find people by userPrincipalName when group transitive membership check is used. [#1446](https://github.com/pnp/sp-dev-fx-controls-react/pull/1446)",
+          "Update the SPFx source project to add an extension + form customizer [#1410](https://github.com/pnp/sp-dev-fx-controls-react/issues/1410)",
+          "`AdaptiveCardDesignerHost`: Add Sample Data to Adaptive Card Editor [#1425](https://github.com/pnp/sp-dev-fx-controls-react/pull/1425)",
+          "`AdaptiveCardHost`: Logic to prevent re-renders (flicker) [#1425](https://github.com/pnp/sp-dev-fx-controls-react/pull/1425)"
         ],
         "fixes": [
           "`DateTimePicker`: broken link for `getErrorMessage` property fixed [#1277](https://github.com/pnp/sp-dev-fx-controls-react/pull/1381)",
           "`ProgressStepsIndicator`: Fix missing image reference in Progress Steps Indicator [#1409](https://github.com/pnp/sp-dev-fx-controls-react/issues/1409)",
           "`DynamicForm`: Dynamicform is hanging on the loading screen if the list has a single value list lookup field [#1393](https://github.com/pnp/sp-dev-fx-controls-react/issues/1393)",
           "`ListView`: Update ListView control docs to use a valid field for the icon [#1398](https://github.com/pnp/sp-dev-fx-controls-react/pull/1398)",
           "`Accordion`: Fixing Accordion control documentation image issue [#1408](https://github.com/pnp/sp-dev-fx-controls-react/issues/1408)",
-          "`DynamicForm`: Cannot read properties of undefined (reading 'startsWith') when submitting the form with `contentType={undefined]` [#1431](https://github.com/pnp/sp-dev-fx-controls-react/issues/1431)"
+          "`DynamicForm`: Cannot read properties of undefined (reading 'startsWith') when submitting the form with `contentType={undefined]` [#1431](https://github.com/pnp/sp-dev-fx-controls-react/issues/1431)",
+          "`FilePicker`: Fix site breadcrumb navigation [#1368](https://github.com/pnp/sp-dev-fx-controls-react/issues/1368)"
         ]
       },
       "contributions": [
+        "[araver](https://github.com/araver)",
         "[Brian Krainer Jacobsen](https://github.com/krainer)",
         "[Edin Kapic](https://github.com/ekapic)",
+        "[Eduard Paul](https://github.com/eduardpaul)",
+        "[Fredrik Ekström](https://github.com/FredrikEkstroem)",
         "[Harminder Singh](https://github.com/HarminderSethi)",
         "[Hugo Bernier](https://github.com/hugoabernier)",
         "[João Mendes](https://github.com/joaojmendes)",

CHANGELOG.md

@@ -2,6 +2,10 @@
 
 ## 3.13.0
 
+### New control(s)
+
+- `UploadFiles`: New Upload Files control [#1388](https://github.com/pnp/sp-dev-fx-controls-react/pull/1388)
+
 ### Enhancements
 
 - `ListItemPicker`: use list name as well as GUID to point to list [#1355](https://github.com/pnp/sp-dev-fx-controls-react/issues/1355)
@@ -12,6 +16,8 @@
 - `MonacoEditor`: Fixed minor typos and misleading instructions [#1415](https://github.com/pnp/sp-dev-fx-controls-react/pull/1415)
 - SharePoint Framework v1.16.1 support [#1427](https://github.com/pnp/sp-dev-fx-controls-react/issues/1427)
 - `RichText`: `label` property is missing [#1375](https://github.com/pnp/sp-dev-fx-controls-react/issues/1375)
+- `PeoplePicker`: PeopleSearch service should also find people by userPrincipalName when group transitive membership check is used. [#1446](https://github.com/pnp/sp-dev-fx-controls-react/pull/1446)
+- Update the SPFx source project to add an extension + form customizer [#1410](https://github.com/pnp/sp-dev-fx-controls-react/issues/1410)
 
 ### Fixes
 
@@ -24,7 +30,7 @@
 
 ### Contributors
 
-Special thanks to our contributors (in alphabetical order): [Brian Krainer Jacobsen](https://github.com/krainer), [Edin Kapic](https://github.com/ekapic), [Harminder Singh](https://github.com/HarminderSethi), [Hugo Bernier](https://github.com/hugoabernier), [João Mendes](https://github.com/joaojmendes), [mgitta](https://github.com/mgitta), [Michaël Maillot](https://github.com/michaelmaillot), [mikezimm](https://github.com/mikezimm).
+Special thanks to our contributors (in alphabetical order): [Brian Krainer Jacobsen](https://github.com/krainer), [Edin Kapic](https://github.com/ekapic), [Eduard Paul](https://github.com/eduardpaul), [Harminder Singh](https://github.com/HarminderSethi), [Hugo Bernier](https://github.com/hugoabernier), [João Mendes](https://github.com/joaojmendes), [mgitta](https://github.com/mgitta), [Michaël Maillot](https://github.com/michaelmaillot), [mikezimm](https://github.com/mikezimm).
 
 ## 3.12.0
 

config/config.json

@@ -3,10 +3,12 @@
   "version": "2.0",
   "bundles": {
     "controls-test-web-part": {
-      "components": [{
-        "entrypoint": "./lib/webparts/controlsTest/ControlsTestWebPart.js",
-        "manifest": "./src/webparts/controlsTest/ControlsTestWebPart.manifest.json"
-      }]
+      "components": [
+        {
+          "entrypoint": "./lib/webparts/controlsTest/ControlsTestWebPart.js",
+          "manifest": "./src/webparts/controlsTest/ControlsTestWebPart.manifest.json"
+        }
+      ]
     },
     "ootb-fields-field-customizer": {
       "components": [
@@ -15,11 +17,29 @@
           "manifest": "./src/extensions/ootbFields/OotbFieldsFieldCustomizer.manifest.json"
         }
       ]
+    },
+    "controls-test-form-customizer": {
+      "components": [
+        {
+          "entrypoint": "./lib/extensions/testForm/TestFormCustomizer.js",
+          "manifest": "./src/extensions/testForm/TestFormCustomizer.manifest.json"
+        }
+      ]
+    },
+    "app-controls-test-application-customizer": {
+      "components": [
+        {
+          "entrypoint": "./lib/extensions/testApp/TestApplicationCustomizer.js",
+          "manifest": "./src/extensions/testApp/TestApplicationCustomizer.manifest.json"
+        }
+      ]
     }
   },
   "externals": {},
   "localizedResources": {
     "ControlStrings": "lib/loc/{locale}.js",
-    "ControlsTestWebPartStrings": "lib/webparts/controlsTest/loc/{locale}.js"
+    "ControlsTestWebPartStrings": "lib/webparts/controlsTest/loc/{locale}.js",
+    "ControlsTestFormCustomizerStrings": "lib/extensions/testForm/loc/{locale}.js",
+    "TestApplicationCustomizerStrings": "lib/extensions/testApp/loc/{locale}.js"
   }
 }

config/package-solution.json

@@ -13,7 +13,21 @@
       "termsOfUseUrl": "",
       "websiteUrl": "",
       "mpnId": "Undefined-1.13.0"
-    }
+    },
+    "features": [
+      {
+        "title": "sp-dev-fx-controls-react Feature",
+        "description": "The feature that activates elements of the sp-dev-fx-controls-react solution.",
+        "id": "d7493d69-72ce-4892-a4ae-643166acae22",
+        "version": "1.0.0.0",
+        "assets": {
+          "elementManifests": [
+            "elements.xml",
+            "ClientSideInstance.xml"
+          ]
+        }
+      }
+    ]
   },
   "paths": {
     "zippedPackage": "solution/sp-dev-fx-controls-react.sppkg"

config/serve.json

@@ -2,5 +2,64 @@
   "$schema": "https://developer.microsoft.com/json-schemas/core-build/serve.schema.json",
   "port": 4321,
   "initialPage": "https://enter-your-SharePoint-site/_layouts/workbench.aspx",
-  "https": true
+  "https": true,
+  "serveConfigurations": {
+    "default": {
+      "pageUrl": "https://enter-your-SharePoint-site.sharepoint.com/sites/mySite/_layouts/15/SPListForm.aspx",
+      "formCustomizer": {
+        "componentId": "f9c6b930-8d5d-4550-bfd9-ed5f6ca443a8",
+        "PageType": 8,
+        "RootFolder": "/sites/mySite/Lists/MyList",
+        "properties": {
+          "sampleText": "Value"
+        }
+      }
+    },
+    "testForm_NewForm": {
+      "pageUrl": "https://enter-your-SharePoint-site.sharepoint.com/sites/mySite/_layouts/15/SPListForm.aspx",
+      "formCustomizer": {
+        "componentId": "f9c6b930-8d5d-4550-bfd9-ed5f6ca443a8",
+        "PageType": 8,
+        "RootFolder": "/sites/mySite/Lists/MyList",
+        "properties": {
+          "sampleText": "Value"
+        }
+      }
+    },
+    "testForm_EditForm": {
+      "pageUrl": "https://enter-your-SharePoint-site.sharepoint.com/sites/mySite/_layouts/15/SPListForm.aspx",
+      "formCustomizer": {
+        "componentId": "f9c6b930-8d5d-4550-bfd9-ed5f6ca443a8",
+        "PageType": 6,
+        "RootFolder": "/sites/mySite/Lists/MyList",
+        "ID": 1,
+        "properties": {
+          "sampleText": "Value"
+        }
+      }
+    },
+    "testForm_ViewForm": {
+      "pageUrl": "https://enter-your-SharePoint-site.sharepoint.com/sites/mySite/_layouts/15/SPListForm.aspx",
+      "formCustomizer": {
+        "componentId": "f9c6b930-8d5d-4550-bfd9-ed5f6ca443a8",
+        "PageType": 4,
+        "RootFolder": "/sites/mySite/Lists/MyList",
+        "ID": 1,
+        "properties": {
+          "sampleText": "Value"
+        }
+      }
+    },
+    "testApp": {
+      "pageUrl": "https://enter-your-SharePoint-site.sharepoint.com/sites/mySite/SitePages/myPage.aspx",
+      "customActions": {
+        "ca9eac70-7343-4972-88d6-672d50e9cf38": {
+          "location": "ClientSideExtension.ApplicationCustomizer",
+          "properties": {
+            "testMessage": "Test message"
+          }
+        }
+      }
+    }
+  }
 }

docs/documentation/docs/about/release-notes.md

@@ -2,6 +2,10 @@
 
 ## 3.13.0
 
+### New control(s)
+
+- `UploadFiles`: New Upload Files control [#1388](https://github.com/pnp/sp-dev-fx-controls-react/pull/1388)
+
 ### Enhancements
 
 - `ListItemPicker`: use list name as well as GUID to point to list [#1355](https://github.com/pnp/sp-dev-fx-controls-react/issues/1355)
@@ -12,6 +16,8 @@
 - `MonacoEditor`: Fixed minor typos and misleading instructions [#1415](https://github.com/pnp/sp-dev-fx-controls-react/pull/1415)
 - SharePoint Framework v1.16.1 support [#1427](https://github.com/pnp/sp-dev-fx-controls-react/issues/1427)
 - `RichText`: `label` property is missing [#1375](https://github.com/pnp/sp-dev-fx-controls-react/issues/1375)
+- `PeoplePicker`: PeopleSearch service should also find people by userPrincipalName when group transitive membership check is used. [#1446](https://github.com/pnp/sp-dev-fx-controls-react/pull/1446)
+- Update the SPFx source project to add an extension + form customizer [#1410](https://github.com/pnp/sp-dev-fx-controls-react/issues/1410)
 
 ### Fixes
 
@@ -24,7 +30,7 @@
 
 ### Contributors
 
-Special thanks to our contributors (in alphabetical order): [Brian Krainer Jacobsen](https://github.com/krainer), [Edin Kapic](https://github.com/ekapic), [Harminder Singh](https://github.com/HarminderSethi), [Hugo Bernier](https://github.com/hugoabernier), [João Mendes](https://github.com/joaojmendes), [mgitta](https://github.com/mgitta), [Michaël Maillot](https://github.com/michaelmaillot), [mikezimm](https://github.com/mikezimm).
+Special thanks to our contributors (in alphabetical order): [Brian Krainer Jacobsen](https://github.com/krainer), [Edin Kapic](https://github.com/ekapic), [Eduard Paul](https://github.com/eduardpaul), [Harminder Singh](https://github.com/HarminderSethi), [Hugo Bernier](https://github.com/hugoabernier), [João Mendes](https://github.com/joaojmendes), [mgitta](https://github.com/mgitta), [Michaël Maillot](https://github.com/michaelmaillot), [mikezimm](https://github.com/mikezimm).
 
 ## 3.12.0
 

docs/documentation/docs/guides/mpa.md

@@ -6,14 +6,51 @@ The shortest way to prepare your local copy of the project for development and t
 
 Before you start contributing to this project, you will need Node.js. This project has been tested with the 10.x version of Node.js and the version of NPM that comes with it. You can use [Node Version Manager](https://github.com/nvm-sh/nvm) to switch between different versions of Node.js.
 
-## Get the local version of the CLI
+## Get the local version of the project
 
 - fork this repository
 - clone your fork
-- in the command line:
-  - run `npm install` to restore dependencies
-  - run `gulp serve` to serve your project
-  - Start making your changes
+- in the command line, run the following commands:
+    - `npm install` to restore dependencies
+    - `npm install -g gulp-cli` in order to run `gulp` commands (run `npm list -g gulp-cli` to check if already installed on your machine or not)
+    - `gulp serve` to serve your project (or `npm run serve` if you want to use [`spfx-fast-serve`](https://github.com/s-KaiNet/spfx-fast-serve))
+- Start making your changes
+
+### Run the project locally
+
+As this project embeds a SPFx solution, you have the ability to test all the controls on your machine.
+
+!!! warning
+    As long as you have access to a SharePoint Online environment (for v2 and after), you can test the components from your machine. But to test the web part as a Teams Tab, you have to first deploy the SPFx solution (and sync it to Teams). You also have to deploy the [SharePoint Framework library for Microsoft Graph Toolkit](https://learn.microsoft.com/en-us/graph/toolkit/get-started/mgt-spfx) v2.9.0. So be sure to be at least **SharePoint Administrator**.
+
+#### SPFx web part
+
+The web part is called *ControlsTest* and is available for both SharePoint Online and Teams. To test it on SharePoint, go to the workbench page (<https://[SHAREPOINT_SITE].sharepoint.com/_layouts/15/workbench.aspx>) and add the web part.
+
+To test it on Teams, once the project deployed on the tenant accordingly, add the web part as a Tab (from a team for example).
+
+To update the host component, open the *ControlsTest* React component located in the following project's relative path: *src\webparts\controlsTest\components\ControlsTest.tsx*.
+
+#### SPFx application customizer
+
+This extension is called *TestApplicationCustomizer*. To test it, go to the following URL (after updating the parameters):
+
+<https://[SHAREPOINT_SITE].sharepoint.com?loadSPFX=true&debugManifestsFile=https://localhost:4321/temp/manifests.js&customActions={"ca9eac70-7343-4972-88d6-672d50e9cf38":{"location":"ClientSideExtension.ApplicationCustomizer"}}>
+
+To update the host component, open the *TestApp* React component located in the following project's relative path: *src\extensions\testApp\TestApp.tsx*.
+
+#### SPFx form customizer
+
+This extension is called *TestForm*. To test it, you have to configure it first:
+
+1. Open the *serve.json* file (located in the *config* folder)
+2. Replace the `rootFolder` property (under `serveConfigurations` ==> `default` ==> `formCustomizer`), which contains a server relative URL, to target the list on which you want to test the extension
+
+Then go to the following URL (after updating the parameters):
+
+<https://[SHAREPOINT_SITE].sharepoint.com/_layouts/15/SPListForm.aspx?debugManifestsFile=https://localhost:4321/temp/manifests.js&loadSPFX=true&componentId=f9c6b930-8d5d-4550-bfd9-ed5f6ca443a8&PageType=8&RootFolder=[OPTIONAL_SERVER_RELATIVE_URL]/Lists/[LIST_NAME]>
+
+To update the host component, open the *TestForm* React component located in the following project's relative path: *src\extensions\testForm\components\TestForm.tsx*.
 
 ### Documentation