Merge pull request MicrosoftDocs#3248 from MicrosoftDocs/master

taking changes to live

Author: mduelae

powerapps-docs/developer/model-driven-apps/clientapi/reference/Xrm-WebApi/online/execute.md

@@ -1,6 +1,6 @@
 ---
 title: "Xrm.WebApi.online.execute (Client API reference) in model-driven apps| MicrosoftDocs"
-ms.date: 10/28/2019
+ms.date: 08/11/2020
 ms.service: powerapps
 ms.topic: "reference"
 applies_to: "Dynamics 365 (online)"
@@ -108,26 +108,26 @@ var Sdk = window.Sdk || {};
  * @param {Object} opportunityClose - The opportunity close activity associated with this state change.
  * @param {number} status - Status of the opportunity.
  */
-Sdk.WinOpportunityRequest = function (opportunityClose, status) {
+Sdk.WinOpportunityRequest = function(opportunityClose, status) {
     this.OpportunityClose = opportunityClose;
     this.Status = status;
 };
 
 // NOTE: The getMetadata property should be attached to the function prototype instead of the
-//       function object itself.
+// function object itself.
 Sdk.WinOpportunityRequest.prototype.getMetadata = function () {
     return {
         boundParameter: null,
         parameterTypes: {
             "OpportunityClose": {
                 "typeName": "mscrm.opportunityclose",
                 "structuralProperty": 5 // Entity Type
-                },
+            },
             "Status": {
                 "typeName": "Edm.Int32",
                 "structuralProperty": 1 // Primitive Type
-                }
-            },
+            }
+        },
         operationType: 0, // This is an action. Use '1' for functions and '2' for CRUD
         operationName: "WinOpportunity",
     };
@@ -144,13 +144,13 @@ var winOpportunityRequest = new Sdk.WinOpportunityRequest(opportunityClose, 3);
 
 // Use the request object to execute the function
 Xrm.WebApi.online.execute(winOpportunityRequest).then(
-    function (result) {
+    function(result) {
         if (result.ok) {
             console.log("Status: %s %s", result.status, result.statusText);
             // perform other operations as required;
         }
     },
-    function (error) {
+    function(error) {
         console.log(error.message);
         // handle error conditions
     }
@@ -202,25 +202,149 @@ Xrm.WebApi.online.execute(whoAmIRequest).then(
 );
 ```
 
+The following example demonstrates how to execute the <xref:Microsoft.Dynamics.CRM.CalculateRollupField> function:
+
+```JavaScript
+var Sdk = window.Sdk || {};
+
+Sdk.CalculateRollupFieldRequest = function(target, fieldName) {
+    this.Target = target;
+    this.FieldName = fieldName;
+};
+
+// NOTE: The getMetadata property should be attached to the function prototype instead of the
+//       function object itself.
+Sdk.CalculateRollupFieldRequest.prototype.getMetadata = function() {
+    return {
+        boundParameter: null,
+        parameterTypes: {
+            "Target": {
+                "typeName": "mscrm.crmbaseentity",
+                "structuralProperty": 5
+            },
+            "FieldName": {
+                "typeName": "Edm.String",
+                "structuralProperty": 1
+            }
+        },
+        operationType: 1, // This is a function. Use '0' for actions and '2' for CRUD
+        operationName: "CalculateRollupField"
+    };
+};
+
+// Create variables to point to a quote record and to a specific field
+var quoteId = {
+    "@odata.type": "Microsoft.Dynamics.CRM.quote",
+    "quoteid": "7bb01e55-2394-ea11-a811-000d3ad97943"
+};
+
+// The roll-up field for which we want to force a re-calculation
+var fieldName = "new_test_rollup";
+
+// Create variable calculateRollupFieldRequest and pass those variables created above
+var calculateRollupFieldRequest = new Sdk.CalculateRollupFieldRequest(quoteId, fieldName);
+
+// Use the request object to execute the function
+Xrm.WebApi.online.execute(calculateRollupFieldRequest).then(
+    function(result) {
+        if (result.ok) { // If the result was retrieved
+            result.json().then( // Convert the result to Json
+                function(response) { //Do something with the response
+                    console.log("The response is: %s", response);
+                });
+        }
+    },
+    function(error) {
+        console.log(error.message);
+        // handle error conditions
+    });
+```
+
+The following example demonstrates how to execute the <xref:Microsoft.Dynamics.CRM.RetrieveDuplicates> function:
+
+```JavaScript
+var Sdk = window.Sdk || {};
+
+Sdk.RetrieveDuplicatesRequest = function(businessEntity, matchingEntityName, pagingInfo) {
+    this.BusinessEntity = businessEntity;
+    this.MatchingEntityName = matchingEntityName;
+    this.PagingInfo = pagingInfo;
+
+};
+
+Sdk.RetrieveDuplicatesRequest.prototype.getMetadata = function() {
+    return {
+        boundParameter: null,
+        parameterTypes: {
+            "BusinessEntity": {
+                "typeName": "mscrm.crmbaseentity",
+                "structuralProperty": 5 // Entity Type
+            },
+            "MatchingEntityName": {
+                "typeName": "Edm.String",
+                "structuralProperty": 1 // Primitive Type
+            },
+            "PagingInfo": {
+                "typeName:": "mscrm.PagingInfo", // Complex Type
+                "structuralProperty": 5
+            }
+        },
+        operationType: 1, // This is a function. Use '0' for actions and '2' for CRUD
+        operationName: "RetrieveDuplicates",
+    };
+};
+
+// Create a variable to point to a contact record and with specific data in the needed fields
+var contactRecord = {
+    "@odata.type": "Microsoft.Dynamics.CRM.contact",
+    "firstname": "Test",
+    "lastname": "Account"
+};
+
+// Create a paging object to keep track of the current page and how many records we get per page
+var pagingInfo = {
+    "PageNumber": 1,
+    "Count": 10
+};
+
+// Create the variable retrieveDuplicatesRequest to build the request
+var retrieveDuplicatesRequest = new Sdk.RetrieveDuplicatesRequest(contactRecord, "contact", pagingInfo);
+
+// Use the request object to execute the function
+Xrm.WebApi.online.execute(retrieveDuplicatesRequest).then(
+    function(result) {
+        if (result.ok) {
+            result.json().then(
+                function(response) {
+                    console.log("The response is: %s", response);
+                });
+        }
+    },
+    function(error) {
+        console.log(error.message);
+        // handle error conditions
+    });
+```
+
 ### Perform CRUD operations
 
 #### Create a record
 
-The following example demonstrates how to perform a Create operation.
+The following example demonstrates how to perform a create operation.
 
 ```JavaScript
 var Sdk = window.Sdk || {};
 
 /**
  * Request to execute a create operation
  */
-Sdk.CreateRequest = function (entityName, payload) {
+Sdk.CreateRequest = function(entityName, payload) {
     this.etn = entityName;
     this.payload = payload;
 };
 
 // NOTE: The getMetadata property should be attached to the function prototype instead of the
-//       function object itself.
+// function object itself.
 Sdk.CreateRequest.prototype.getMetadata = function () {
     return {
         boundParameter: null,
@@ -237,13 +361,13 @@ var createRequest = new Sdk.CreateRequest("account", payload);
 
 // Use the request object to execute the function
 Xrm.WebApi.online.execute(createRequest).then(
-    function (result) {
+    function(result) {
         if (result.ok) {
             console.log("Status: %s %s", result.status, result.statusText);
             // perform other operations as required;
         }
     },
-    function (error) {
+    function(error) {
         console.log(error.message);
         // handle error conditions
     }
@@ -252,21 +376,20 @@ Xrm.WebApi.online.execute(createRequest).then(
 
 #### Retrieve a record
 
-The following example demonstrates how to perform a Retrieve operation.
+The following example demonstrates how to perform a retrieve operation.
 
 ```JavaScript
 var Sdk = window.Sdk || {};
 
 /**
  * Request to execute a retrieve operation
  */
-Sdk.RetrieveRequest = function (entityReference, columns) {
+Sdk.RetrieveRequest = function(entityReference, columns) {
     this.entityReference = entityReference;
     this.columns = columns;
 };
-
 // NOTE: The getMetadata property should be attached to the function prototype instead of the
-//       function object itself.
+// function object itself.
 Sdk.RetrieveRequest.prototype.getMetadata = function () {
     return {
         boundParameter: null,
@@ -285,27 +408,26 @@ var retrieveRequest = new Sdk.RetrieveRequest(entityReference, ["name"]);
 
 // Use the request object to execute the function
 Xrm.WebApi.online.execute(retrieveRequest).then(
-    function (result) {
+    function(result) {
         if (result.ok) {
             console.log("Status: %s %s", result.status, result.statusText);
             result.json().then(
-                function (response) {
+                function(response) {
                     console.log("Name: %s", response.name);
                     // perform other operations as required;
                 });
         }
     },
-    function (error) {
+    function(error) {
         console.log(error.message);
         // handle error conditions
     }
 );
-
 ```
 
 #### Update a record
 
-The following example demonstrates how to perform a Update operation.
+The following example demonstrates how to perform a update operation.
 
 ```JavaScript
 var Sdk = window.Sdk || {};
@@ -314,14 +436,14 @@ var Sdk = window.Sdk || {};
 /**
  * Request to execute an update operation
  */
-Sdk.UpdateRequest = function (entityName, entityId, payload) {
+Sdk.UpdateRequest = function(entityName, entityId, payload) {
     this.etn = entityName;
     this.id = entityId;
     this.payload = payload;
 };
 
 // NOTE: The getMetadata property should be attached to the function prototype instead of the
-//       function object itself.
+// function object itself.
 Sdk.UpdateRequest.prototype.getMetadata = function () {
     return {
         boundParameter: null,
@@ -339,13 +461,13 @@ var updateRequest = new Sdk.UpdateRequest("account", "d2b6c3f8-b0fa-e911-a812-00
 
 // Use the request object to execute the function
 Xrm.WebApi.online.execute(updateRequest).then(
-    function (result) {
+    function(result) {
         if (result.ok) {
             console.log("Status: %s %s", result.status, result.statusText);
             // perform other operations as required;
         }
     },
-    function (error) {
+    function(error) {
         console.log(error.message);
         // handle error conditions
     }
@@ -354,20 +476,20 @@ Xrm.WebApi.online.execute(updateRequest).then(
 
 #### Delete a record
 
-The following example demonstrates how to perform a Delete operation.
+The following example demonstrates how to perform a delete operation.
 
 ```JavaScript
 var Sdk = window.Sdk || {};
 
 /**
  * Request to execute a delete operation
  */
-Sdk.DeleteRequest = function (entityReference) {
+Sdk.DeleteRequest = function(entityReference) {
     this.entityReference = entityReference;
 };
 
 // NOTE: The getMetadata property should be attached to the function prototype instead of the
-//       function object itself.
+// function object itself.
 Sdk.DeleteRequest.prototype.getMetadata = function () {
         return {
             boundParameter: null,
@@ -377,6 +499,7 @@ Sdk.DeleteRequest.prototype.getMetadata = function () {
         };
     };
 };
+};
 
 // Construct request object from the metadata
 var entityReference = {
@@ -387,13 +510,13 @@ var deleteRequest = new Sdk.DeleteRequest(entityReference);
 
 // Use the request object to execute the function
 Xrm.WebApi.online.execute(deleteRequest).then(
-    function (result) {
+    function(result) {
         if (result.ok) {
             console.log("Status: %s %s", result.status, result.statusText);
             // perform other operations as required;
         }
     },
-    function (error) {
+    function(error) {
         console.log(error.message);
         // handle error conditions
     }

powerapps-docs/maker/TOC.yml

@@ -1804,6 +1804,8 @@
     href: ./canvas-apps/get-sessionid.md
   - name: Troubleshoot startup issues for Power Apps
     href: troubleshooting-startup-issues.md
+  - name: Troubleshoot sign-in issues for Power Apps mobile
+    href: ../user/powerapps_mobile_troubleshoot.md
   - name: Troubleshoot Power Query
     href: ./common-data-service/data-platform-cds-newentity-troubleshooting-mashup.md
   - name: Support