Merge pull request #8696 from MicrosoftDocs/jdaly-main-4739

Model-driven App client API cleanup

Author: JimDaly

powerapps-docs/developer/model-driven-apps/client-scripting.md

@@ -53,7 +53,7 @@ Model-driven apps provides you a rich set of **client APIs** to interact with fo
 [Client API reference](clientapi/reference.md)
 
 
-### Related topics
+### Related articles
 
 [Web resources for model-driven apps](web-resources.md)<br/>
 [Customize commands and the ribbon](customize-commands-ribbon.md)<br/>

powerapps-docs/developer/model-driven-apps/clientapi/clientapi-execution-context.md

@@ -37,13 +37,10 @@ The execution context is passed in one of the following ways:
 The execution context object provides a number of methods to further work with the context. More information: [Execution context (Client API reference)](reference/execution-context.md)
 
 
-### Related topics
+### Related articles
 
  [Client API form context](clientapi-form-context.md)<br>
  [Client API grid context](clientapi-grid-context.md)<br>
  [Form and grid context in ribbon actions](../pass-data-page-parameter-ribbon-actions.md#form-and-grid-context-in-ribbon-actions)
 
-
-
-
 [!INCLUDE[footer-include](../../../includes/footer-banner.md)]

powerapps-docs/developer/model-driven-apps/clientapi/clientapi-form-context.md

@@ -70,9 +70,9 @@ Provides properties and methods to work with the data on a form, including table
 
 | Object   | Description|
 |----------|-------------------------------------------------------------------------------------------------------------------|
-|attributes|Collection of non-table data on the form. Items in this collection are of the same type as the column collection, but they are not columns of the form table. <br/>More information: [Collections](reference/collections.md)|
-|entity    |Provides methods to retrieve information specific to the record displayed on the page, the save method, and a collection of all the columns included on the form. Column data is limited to columns represented on the form. <br/>More information: [formContext.data.entity](reference/formContext-data-entity.md)|
-|process   |Provides objects and methods to interact with the business process flow data on a form.<br/>More information: [formContext.data.process](reference/formContext-data-process.md)|
+|`attributes`|Collection of non-table data on the form. Items in this collection are of the same type as the column collection, but they are not columns of the form table. <br/>More information: [Collections](reference/collections.md)|
+|`entity`|Provides methods to retrieve information specific to the record displayed on the page, the save method, and a collection of all the columns included on the form. Column data is limited to columns represented on the form. <br/>More information: [formContext.data.entity](reference/formContext-data-entity.md)|
+|`process`|Provides objects and methods to interact with the business process flow data on a form.<br/>More information: [formContext.data.process](reference/formContext-data-process.md)|
 
 It also provides an **attributes** collection for accessing non-table bound control. See the **Collections in the formContext object model** section later in this topic.
 
@@ -84,9 +84,9 @@ Provides methods to retrieve information about the user interface, in addition t
 
 | Object          | Description|
 |-----------------|----------------|
-|formSelector     |Provides an items collection that provides capabilities to query the forms available for the current user. Use the navigate method to close the current form and open a different one.|
-|navigation       |Does not contain any methods. Provides access to navigation items through the items collection. See the next section on collections for more information.|
-|process          |Provides methods to interact with the business process flow control on a form.|
+|`formSelector`|Provides an items collection that provides capabilities to query the forms available for the current user. Use the navigate method to close the current form and open a different one.|
+|`navigation`|Does not contain any methods. Provides access to navigation items through the items collection. See the next section on collections for more information.|
+|`process`|Provides methods to interact with the business process flow control on a form.|
 
 More information: [formContext.ui](reference/formContext-ui.md)
 
@@ -108,16 +108,13 @@ information about the methods available for collections in general, see [Collect
 
 
 
-### Related topics
+### Related articles
 
-[getFormContext method](reference/executioncontext/getFormContext.md)<br/>
-[getGlobalContext method](reference/xrm-utility/getGlobalContext.md)<br/>
-[getAttribute method](reference/attributes.md)<br/>
-[getControl method](reference/controls/getcontrol.md)<br/>
+[getFormContext method](reference/executioncontext/getFormContext.md)   
+[getGlobalContext method](reference/xrm-utility/getGlobalContext.md)   
+[getAttribute method](reference/attributes.md)   
+[getControl method](reference/controls/getcontrol.md)   
 [Execution context methods](reference/execution-context.md) 
 
- 
-
-
 
 [!INCLUDE[footer-include](../../../includes/footer-banner.md)]

powerapps-docs/developer/model-driven-apps/clientapi/clientapi-grid-context.md

@@ -36,11 +36,11 @@ function doSomething(executionContext) {
 }
 ```
 
-## Related topics
+## Related articles
 
-[Client API form context](clientapi-form-context.md)<br/>
-[Client API execution context](clientapi-execution-context.md)<br/>
-[Understand the Client API object model](understand-clientapi-object-model.md)<br/>
+[Client API form context](clientapi-form-context.md)   
+[Client API execution context](clientapi-execution-context.md)   
+[Understand the Client API object model](understand-clientapi-object-model.md)  
 [Grids and subgrids](reference/grids.md)
 
 

powerapps-docs/developer/model-driven-apps/clientapi/clientapi-xrm.md

@@ -29,13 +29,13 @@ The following illustration displays the Xrm object model:
 
 Here is the information about each of the namespaces in the Xrm object:
 
-| Namespace                                     | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
-| --------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| [Xrm.Device](reference/xrm-device.md)         | Provides methods to use native device capabilities.                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
-| [Xrm.Encoding](reference/xrm-encoding.md)     | Provides methods to encode strings.                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
-| [Xrm.Navigation](reference/xrm-navigation.md) | Provides methods for navigating forms and items in model-driven apps.                                                                                                                                                                                                                                                                                                                                                                                                                                 |
-| [Xrm.Panel](reference/xrm-panel.md)           | Provides a method to display a web page in the side pane of model-driven apps form.                                                                                                                                                                                                                                                                                                                                                                                                                   |
-| [Xrm.Utility](reference/xrm-utility.md)       | Provides a container for useful methods.                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
+| Namespace| Description|
+| ---| ---|
+| [Xrm.Device](reference/xrm-device.md)| Provides methods to use native device capabilities. |
+| [Xrm.Encoding](reference/xrm-encoding.md)     | Provides methods to encode strings.|
+| [Xrm.Navigation](reference/xrm-navigation.md) | Provides methods for navigating forms and items in model-driven apps.|
+| [Xrm.Panel](reference/xrm-panel.md)           | Provides a method to display a web page in the side pane of model-driven apps form.|
+| [Xrm.Utility](reference/xrm-utility.md)       | Provides a container for useful methods.|
 | [Xrm.WebApi](reference/xrm-webapi.md)         | Provides methods to use Web API to create and manage records and execute Web API actions and functions.<br/><br/>[Xrm.WebApi.offline](reference/xrm-webapi/offline.md): Provides methods to create and manage records in the model-driven apps in mobile clients while working in _offline_ mode.<br/><br/>[Xrm.WebApi.online](reference/xrm-webapi/online.md): Provides methods to use Web API to create and manage records and execute Web API actions and functions when connected to the server. |
 
 ## Client API global context
@@ -47,7 +47,7 @@ Use the **Xrm.Utility**.[getGlobalContext](reference/xrm-utility/getGlobalContex
 
 To access the global context information in a standalone HTML Web resource, you should include a reference to **ClientGlobalContext.js.aspx** in the web resource, and then use the **GetGlobalContext** function. More information: [GetGlobalContext function and ClientGlobalContext.js.aspx](reference/GetGlobalContext-ClientGlobalContext.js.aspx.md)
 
-### Related topics
+### Related articles
 
 [Understand the Client API object model](understand-clientapi-object-model.md)<br/>
 [Deprecated client APIs](/dynamics365/get-started/whats-new/customer-engagement/important-changes-coming#some-client-apis-are-deprecated)

powerapps-docs/developer/model-driven-apps/clientapi/create-app-side-panes.md

@@ -146,6 +146,6 @@ By switching to use `createPane`, both limitations can be avoided by providing a
 
 ### Related articles
 
-[sidePanes (Client API reference)](reference/xrm-app-sidepanes.md)<br />
-[loadPanel (Client API Reference)](reference/xrm-panel/loadpanel.md)<br />
+[sidePanes (Client API reference)](reference/xrm-app-sidepanes.md)   
+[loadPanel (Client API Reference)](reference/xrm-panel/loadpanel.md)   
 [Walkthrough: Write your first client script](walkthrough-write-your-first-client-script.md)

powerapps-docs/developer/model-driven-apps/clientapi/debug-JavaScript-code.md

@@ -152,10 +152,10 @@ Use the **Run command** (shortcut is `Windows + R`) and use the following deep l
 
 1. Click **inspect** and the DevTools will open.
 
-### See also
+### Related articles
 
-[JavaScript web resources](../script-jscript-web-resources.md)<br />
-[Debug a model-driven app with Monitor](../../../maker/monitor-modelapps.md)<br />
+[JavaScript web resources](../script-jscript-web-resources.md)   
+[Debug a model-driven app with Monitor](../../../maker/monitor-modelapps.md)   
 [Troubleshoot issues in the Power Apps mobile app](../../../mobile/powerapps-mobile-troubleshoot.md)
 
 [!INCLUDE[footer-include](../../../includes/footer-banner.md)]

powerapps-docs/developer/model-driven-apps/clientapi/events-forms-grids.md

@@ -80,15 +80,16 @@ Using the following methods to add and remove event handler for events that cann
 >The execution context is automatically passed as the first parameter to functions that are set using the code. More information: [Client API execution context](clientapi-execution-context.md) 
 
 ## Form event pipeline
+
 You can define up to 50 event handlers for each event. Each event handler is executed in the order that it is displayed in the **Event Handlers** section in the **Events** tab of the **Form Properties** dialog box.
 
 Use the [setSharedVariable](reference/executioncontext/setSharedVariable.md) and [getSharedVariable](reference/executioncontext/getSharedVariable.md) methods to pass a common variable between event handlers (functions). Use the execution context [getDepth](reference/executioncontext/getDepth.md) method to know the sequence that an event handler is being executed in relative to other event handlers. 
 
-### Related topics
+### Related articles
 
-[Understand the Client API object model](understand-clientapi-object-model.md)<br/>
-[Client API execution context](clientapi-execution-context.md)<br/>
-[Events (Client API reference)](reference/events.md)<br/>
+[Understand the Client API object model](understand-clientapi-object-model.md)   
+[Client API execution context](clientapi-execution-context.md)   
+[Events (Client API reference)](reference/events.md)   
 
 
 

powerapps-docs/developer/model-driven-apps/clientapi/get-update-setting-value-using-code.md

@@ -22,19 +22,23 @@ Settings are solution components that enable developers to quickly configure app
 The following functions can be used to get or update a setting value using client API.
 
 ### getCurrentAppSetting
+
 Gets the value of a setting for the current app.
 
 #### Syntax
+
 ```JavaScript
 var settingValue = Xrm.Utility.getGlobalContext().getCurrentAppSetting(settingName);
 ```
 
 #### Parameters
+
 | Name | Type | Required | Description |
 |:--------------|:--------------|:--------------|:-------------------------|
-|**settingName** | String | Yes | The name of the setting to get the value for. |
+|`settingName` | String | Yes | The name of the setting to get the value for. |
 
 #### Return value
+
 **Type:** Same as the type of the setting: *Number*, *String*, or *Yes/No*<br><br>
 **Description:** 
 - If the setting is *Overridable* and *Value can be overridden* is set to *Environment and app* the setting app value is returned. If a setting app value does not exist, then the setting environment value is returned. If a setting environment value does not exist, the default value as specified in the setting definition is returned.
@@ -44,33 +48,39 @@ var settingValue = Xrm.Utility.getGlobalContext().getCurrentAppSetting(settingNa
 - If the setting name is incorrect or the setting could not be found, the return value is null.
 
 ### saveSettingValue
+
 Adds or updates the setting app value for the current app or the setting environment value for the current environment.
 
 #### Syntax
+
 ```JavaScript
 var appOverrideScope = 2; // Add or update a setting app value
 var saveSettingOptions = {overrideScope: appOverrideScope, solutionUniqueName: mySolutionName};
 Xrm.Utility.getGlobalContext().saveSettingValue(settingName, value, saveSettingOptions).then(successCallback, errorCallback);
 ```
 
 #### Parameters
+
 | Name | Type | Required | Description |
 |:--------------|:--------------|:--------------|:-------------------------|
-|**settingName** | String | Yes | The name of the setting to update the value of. |
-|**value** | *Number*, *String*, or *Yes/No* | Yes | The value to update the setting to. |
-|**saveSettingOptions** | String | No | Options when updating the value. It contains two parameters <ul><li><b>overrideScope</b><ul><li>Use **1** to add or update a setting environment value</li><li>Use **2** to add or update a setting app value.</li><li>If not specified it is set to environment.</li></ul></li><li><b>solutionUniqueName</b><ul><li>The solution to which the setting environment value or setting app value should be added.</li><li>If not specified the default solution is used.</li></ul></li></ul>|
-|**successCallback** | String | Yes | A function to call if the update is successful. |
-|**errorCallback** | String | Yes | A function to call if the update fails. |
+|`settingName` | String | Yes | The name of the setting to update the value of. |
+|`value` | *Number*, *String*, or *Yes/No* | Yes | The value to update the setting to. |
+|`saveSettingOptions` | String | No | Options when updating the value. It contains two parameters <ul><li><b>overrideScope</b><ul><li>Use **1** to add or update a setting environment value</li><li>Use **2** to add or update a setting app value.</li><li>If not specified it is set to environment.</li></ul></li><li><b>solutionUniqueName</b><ul><li>The solution to which the setting environment value or setting app value should be added.</li><li>If not specified the default solution is used.</li></ul></li></ul>|
+|`successCallback` | String | Yes | A function to call if the update is successful. |
+|`errorCallback`| String | Yes | A function to call if the update fails. |
 
 #### Return value
+
 On success, returns a promise object.
 
 ### Web APIs
+
 You can also use the following Web APIs to get or update a setting value
-- [RetrieveSetting Function](/dynamics365/customer-engagement/web-api/retrievesetting)
-- [SaveSettingValue Action](/dynamics365/customer-engagement/web-api/savesettingvalue)
 
-## See also
+- [RetrieveSetting function](xref:Microsoft.Dynamics.CRM.RetrieveSetting)
+- [SaveSettingValue action](xref:Microsoft.Dynamics.CRM.SaveSettingValue)
+
+## Related articles
 
 [Solutions overview](../../../maker/data-platform/solutions-overview.md)
 

powerapps-docs/developer/model-driven-apps/clientapi/navigate-to-custom-page-examples.md

@@ -281,9 +281,7 @@ Editable grid can be used to trigger [OnRecordSelect](reference/events/grid-onre
 
 ## Related articles
 
-[Model-driven app custom page overview](../../../maker/model-driven-apps/model-app-page-overview.md)
-
-[Add a custom page to your model-driven app](../../../maker/model-driven-apps/add-page-to-model-app.md)
-
+[Model-driven app custom page overview](../../../maker/model-driven-apps/model-app-page-overview.md)   
+[Add a custom page to your model-driven app](../../../maker/model-driven-apps/add-page-to-model-app.md)   
 [navigateTo (client API reference)](reference/xrm-navigation/navigateto.md)