Merge pull request #1 from SharePoint/master

merging changers

Author: rk-menon

docs/apis/export-amr-api.md

@@ -120,7 +120,7 @@ During incremental migration, instead of query everything again, by populating S
 
 Below is a sample of how the *startChangeToken* might work. This example uses the optional feature setting for initial call and the parameter setting for incremental passes.  
 
-![AMR flow](media/async-read-api-flow.png)
+![Export API process](../images/async-read-api-flow.png)
 
 #### Invalid Value
 
@@ -153,8 +153,12 @@ This function returns the changeToken associates with this query. By specifying
 
 #### Manifest Output
 
-After the asyncMigrationRead function finishes execution, the final manifest will be placed in the container specified, with naming convention of “<jobid>/<filename>”.  Manifest export package structure will be like the *createMigration* Import Package structure. The general output structure is summarized in table below.
+After the asyncMigrationRead function finishes execution, the final manifest will be placed in the container specified, under a folder named **JobId**. Manifest export package structure will be like the *createMigration* Import Package structure. The general output structure is summarized in table below.
 
+Below is an example on how to query the folder:
+
+    CloudBlobDirectory folder = blobContainerObj.GetDirectoryReference(jobid);
+    CloudBlockBlob blob = folder.GetBlockBlobReference(manifestFileName);
 
 |**XML file**|**Schema File**|**Description**|
 |:-----|:-----|:-----|
@@ -188,7 +192,7 @@ It returns the AES256CBC encryption key used to decrypt the message in azureMani
 ## Set up Guidelines
 The following provides high level guidelines for implementing the asynchronous metadata migration function. This documentation does not go into details on how to interact with SharePoint RESTful service. It is assumed that the ISV has prior knowledge and will be able to access the target website with proper permission. </br>,</br>For more information on how to access the Sharepoint website, refer to [Get to Know the SharePoint Rest Service](https://docs.microsoft.com/en-us/sharepoint/dev/sp-add-ins/get-to-know-the-sharepoint-rest-service).
 
-1. Install and update the latest Microsoft.SharePointOnline.CSOM version. The minimum version requirement is V16.1.8600 or later.
+1. Install and update the latest Microsoft.SharePointOnline.CSOM version. The minimum version requirement is V16.1.9119.1200 or later.
 2. ISVs figure out the folder, document library or files of interested to be query and issued with CreateSPAsyncReadJob function. 
 3. Once successfully created, query the job status using the *jobQueueUri*. It provides the job process status and any error logging. After job completion, parse the Manifest to retrieve the metadata.
 

docs/apis/migration-api-overview.md

@@ -1438,6 +1438,23 @@ There is no change from current published full 2013 [full 2013 package schema](h
 
 There is no change from current published [full 2013 package schema](https://docs.microsoft.com/en-us/sharepoint/dev/schema/content-migration-schemas).
 
+## Sample: Using REST to call the API
+
+
+https://<spam><spam>yourtenanthere.sharepoint.com/sites/importSite/_api/site/CreateMigrationJobEncrypted<spam><spam>
+ 
+{
+    "options": {
+        "AES256CBCKey": "000000000000000000000000000000000000000000000000000000="
+    },
+    "gWebId": "00000000-0000-0000-0000-000000000000",
+    "azureContainerSourceUri": "https://<spam><spam>tenant.blob.core.windows.net:443/00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000<spam><spam>=rw",
+    "azureContainerManifestUri": "https://<spam><spam>tenant.blob.core.windows.net:443/00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000<spam><spam>=rw"
+}
+ 
+For the container
+https://<spam><spam>yourtenanthere.sharepoint.com/sites/importSite/_api/site/ProvisionMigrationContainers<spam><spam>
+ 
 
 >[!NOTE]
 >The **Migration API** is not available for users of Office 365 operated by 21Vianet in China. It is also not available for users of Office 365 with the German cloud using the data trustee, *German Telekom*. However, it is supported for users in Germany whose data ___location is not in the German data center. 

docs/apis/migration-isv-guidance.md

@@ -78,7 +78,7 @@ A new migration API, Asynchronous Metadata Read API (Export API) is currently be
 
 - [Asynchronous Metadata Read (Export API)](https://docs.microsoft.com/en-us/sharepoint/dev/apis/export-amr-api)
 
-The *AsynchronousMetadataRead* helps the ISVs export content from SharePoint and OneDrive.  Once the new API becomes available, we recommend that you transition to the new API to avoid throttling.
+The *AsynchronousMetadataRead* helps the ISVs export content from SharePoint and OneDrive.
 
 ## Switch to the Microsoft Graph API 
 If a feature is not supported by the migration API, we recommend that you use the Graph API.  If the Graph API does not support the needed migration feature, then use CSOM. However, using CSOM increases the likelihood of being throttled. 

docs/declarative-customization/column-formatting.md

@@ -1171,6 +1171,13 @@ Operators specify the type of operation to perform. The following operators are
 - length
 - abs
 - loopIndex
+- floor
+- ceiling
+- pow
+- substring
+- getDate
+- getMonth
+- getYear
 
 **Binary arthmetic operators** - The following are the standard arithmetic binary operators that expect two operands: 
 
@@ -1224,6 +1231,21 @@ Operators specify the type of operation to perform. The following operators are
   - `"txtContent":"=length(45)"` results in _1_
   - `"txtContent":"=length(0)"` results in _0_
 
+- **floor**: returns the largest integer les than or equal to a given number. - _Only available in SharePoint Online_
+  - `"txtContent":"=floor(45.5)"` results in _45_ 
+  
+- **ceiling**: rounds the given number up to the next largest whole number or integer. - _Only available in SharePoint Online_
+  - `"txtContent":"=ceiling(45.5)"` results in _46_ 
+  
+- **getDate**: returns the day of the month of the given date. - _Only available in SharePoint Online_
+  - `"txtContent":"=getDate(Date('12/26/1981'))"` results in _26_ 
+  
+- **getMonth**:  returns the month in the specified date according to local time, as a zero-based value (where zero indicates the first month of the year). - _Only available in SharePoint Online_
+  - `"txtContent":"=getMonth(Date('12/26/1981'))"` results in _11_ 
+
+- **getYear**: returns the year of the given date. - _Only available in SharePoint Online_
+  - `"txtContent":"=getYear(Date('12/26/1981'))"` results in _1981_ 
+  
 **Binary operators** - The following are operators that expect two operands:
 
 - **indexOf**: takes 2 operands. The first is the text you would like to search within, the second is the text you would like to search for. Returns the index value of the first occurence of the search term within the string. Indexes start at 0. If the search term is not found within the text, -1 is returned. This operator is case-sensitive. - _Only available in SharePoint Online_
@@ -1235,7 +1257,22 @@ Operators specify the type of operation to perform. The following operators are
 - **join**: takes 2 operands. The first is an array (multi-select person or choice field) and the second is the separating string. Returns a string concatenation of the array values separated by the separating string. - _Only available in SharePoint Online_
   - `"txtContent": "=join(@currentField, ', ')"` might result in _"Apple, Orange, Cherry"_ (depending on the selected values)
   - `"txtContent": "=join(@currentField.title, '|')"` might result in _"Chris Kent|Vesa Juvonen|Jeff Teper"_ (depending on the selected persons)
+  
+- **pow**: returns the base to the exponent power. - _Only available in SharePoint Online_
+  - `"txtContent":"=pow(2,3)"` results in _8_
 
+**Ternary operators** - The following are operators that expect three operands:
+
+- **subString**: returns the part of the string between the start and end indicies. - _Only available in SharePoint Online_
+  - `"txtContent":"=subString('DogFood', 3, 4)"` results in _Fo_
+  - `"txtContent":"=subString('DogFood', 4, 3)"` results in _Fo_
+  - `"txtContent":"=subString('DogFood', 3, 6)"` results in _Food_
+  - `"txtContent":"=subString('DogFood', 6, 3)"` results in _Food_
+
+  The substring() method returns the part of the string between the start and end indexes, or to the end of the string.
+
+  
+  
 **Conditional operator** - The conditional operator is:
 
 - **?**: Conditional operations written in Abstract Tree Syntax use `?` as the operator. This is to achieve an expression equivalent to a ? b : c, where if the expression a evaluates to true, then the result is b, else the result is c. For Excel style expressions you write these with an `if` statement. Regardless, there are 3 operands. The first is the condition to evaluate. The second is the result when the condition is true. The third is the result when the condition is false.