Merge pull request #2391 from MicrosoftDocs/hwan-clientapi

Client API updates

Author: KumarVivek

powerapps-docs/developer/model-driven-apps/clientapi/TOC.yml

@@ -21,6 +21,8 @@
         href: ./reference/events/grid-onrecordselect.md
       - name: Grid OnSave event
         href: ./reference/events/grid-onsave.md
+      - name: OnLookupTagClick event
+        href: ./reference/events/onlookuptagclick.md
       - name: OnProcessStatusChange event
         href: ./reference/events/onprocessstatuschange.md
       - name: OnPreProcessStatusChange event
@@ -152,6 +154,8 @@
         href: reference/controls/addCustomView.md
       - name: addNotification
         href: reference/controls/addNotification.md
+      - name: addOnLookupTagClick
+        href: reference/controls/addOnLookupTagClick.md
       - name: addOnPostSearch
         href: reference/controls/addOnPostSearch.md
       - name: addOnResultOpened
@@ -214,6 +218,8 @@
         href: reference/controls/openSearchResult.md
       - name: refresh
         href: reference/controls/refresh.md
+      - name: removeOnLookupTagClick
+        href: reference/controls/removeOnLookupTagClick.md
       - name: removeOnPostSearch
         href: reference/controls/removeOnPostSearch.md
       - name: removeOnResultOpened

powerapps-docs/developer/model-driven-apps/clientapi/reference/Xrm-Utility/lookupObjects.md

@@ -35,6 +35,7 @@ search.app:
 |disableMru|Boolean|No|Decides whether to display the most recently used(MRU) item.<br />Available only for Unified Interface.|
 |entityTypes|Array|No|The entity types to display.|
 |filters|Array of objects|No|Used to filter the results. Each object in the array contains the following attributes:<br /><ul><li>**filterXml**: String. The FetchXML filter element to apply.</li><li>**entityLogicalName**: String. The entity type to which to apply this filter.</li></ul>|
+|searchText|String|No|Indicates the default search term for the lookup control. This is supported only on [Unified Interface](https://docs.microsoft.com/power-platform/admin/about-unified-interface).|
 |showBarcodeScanner|Boolean|No|Indicates whether the lookup control should show the barcode scanner in mobile clients.|
 |viewIds|Array|No|The views to be available in the view picker. Only system views are supported.|
 |successCallback |Function |Yes |A function to call when the lookup control is invoked. An array of objects with the following properties is passed:<br/><ul><li>**entityType**: String. Entity type of the record selected in the lookup control.</li><li>**id**: String. ID of the record selected in the lookup control.</li><li>**name**: String. Name of the record selected in the lookup control.</li>|

powerapps-docs/developer/model-driven-apps/clientapi/reference/controls.md

@@ -161,28 +161,30 @@ These are the methods available for a lookup control.
 <li><a href="controls/addCustomFilter.md" data-raw-source="[addCustomFilter](controls/addCustomFilter.md)">addCustomFilter</a></li>
 <li><a href="controls/addCustomView.md" data-raw-source="[addCustomView](controls/addCustomView.md)">addCustomView</a></li>
 <li><a href="controls/addNotification.md" data-raw-source="[addNotification](controls/addNotification.md)">addNotification</a></li>
+<li><a href="controls/addOnLookupTagClick.md" data-raw-source="[addOnLookupTagClick](controls/addOnLookupTagClick.md)">addOnLookupTagClick</a></li>
 <li><a href="controls/addPreSearch.md" data-raw-source="[addPreSearch](controls/addPreSearch.md)">addPreSearch</a></li>
 <li><a href="controls/clearNotification.md" data-raw-source="[clearNotification](controls/clearNotification.md)">clearNotification</a></li>
 <li><a href="controls/getAttribute.md" data-raw-source="[getAttribute](controls/getAttribute.md)">getAttribute</a></a></li>
 <li><a href="controls/getControlType.md" data-raw-source="[getControlType](controls/getControlType.md)">getControlType</a></li>
-<li><a href="controls/getDefaultView.md" data-raw-source="[getDefaultView](controls/getDefaultView.md)">getDefaultView</a></li>
+
 </ul>
 </td>
 <td>
 <ul>
+<li><a href="controls/getDefaultView.md" data-raw-source="[getDefaultView](controls/getDefaultView.md)">getDefaultView</a></li>
 <li><a href="controls/getDisabled.md" data-raw-source="[getDisabled](controls/getDisabled.md)">getDisabled</a></li>
 <li><a href="controls/getEntityTypes.md" data-raw-source="[getEntityTypes](controls/getEntityTypes.md)">getEntityTypes</a></li>
 <li><a href="controls/getLabel.md" data-raw-source="[getLabel](controls/getLabel.md)">getLabel</a></li>
 <li><a href="controls/getName.md" data-raw-source="[getName](controls/getName.md)">getName</a></li>
 <li><a href="controls/getParent.md" data-raw-source="[getParent](controls/getParent.md)">getParent</a></li>
 <li><a href="controls/getVisible.md" data-raw-source="[getVisible](controls/getVisible.md)">getVisible</a></li>
-<li><a href="controls/removePreSearch.md" data-raw-source="[removePreSearch](controls/removePreSearch.md)">removePreSearch</a></li>
-<li><a href="controls/setDefaultView.md" data-raw-source="[setDefaultView](controls/setDefaultView.md)">setDefaultView</a></li>
-
+<li><a href="controls/removeOnLookupTagClick.md" data-raw-source="[removeOnLookupTagClick](controls/removeOnLookupTagClick.md)">removeOnLookupTagClick</a></li>
 </ul>
 </td>
 <td>
 <ul>
+<li><a href="controls/removePreSearch.md" data-raw-source="[removePreSearch](controls/removePreSearch.md)">removePreSearch</a></li>
+<li><a href="controls/setDefaultView.md" data-raw-source="[setDefaultView](controls/setDefaultView.md)">setDefaultView</a></li>
 <li><a href="controls/setDisabled.md" data-raw-source="[setDisabled](controls/setDisabled.md)">setDisabled</a></li>
 <li><a href="controls/setEntityTypes.md" data-raw-source="[setEntityTypes](controls/setEntityTypes.md)">setEntityTypes</a></li>
 <li><a href="controls/setFocus.md" data-raw-source="[setFocus](controls/setFocus.md)">setFocus</a></li>

powerapps-docs/developer/model-driven-apps/clientapi/reference/controls/addOnLookupTagClick.md

@@ -0,0 +1,40 @@
+---
+title: "addOnLookupTagClick (Client API reference) in model-driven apps| MicrosoftDocs"
+ms.date: 02/24/2020
+ms.service: powerapps
+ms.topic: "reference"
+author: "KumarVivek"
+ms.author: "kvivek"
+manager: "annbe"
+search.audienceType: 
+  - developer
+search.app: 
+  - PowerApps
+  - D365CE
+---
+# addOnLookupTagClick (Client API reference)
+
+Adds an event handler to the [OnLookupTagClick](../events/onlookuptagclick.md) event.
+
+## Control types supported
+
+Lookup
+
+## Syntax
+
+`formContext.getControl(arg).addOnLookupTagClick(myFunction);`
+
+## Parameter
+
+|Name|Type|Required|Description|
+|--|--|--|--|
+|myFunction|Function reference|Yes|The function to add to the **OnLookupTagClick** event. The [execution context](../../clientapi-execution-context.md) is automatically passed as the first parameter to this function along with eventArgs that contain the tag value. More information: [OnLookupTagClick event](../events/onlookuptagclick.md).<br/><br/>You should use a reference to a named function rather than an anonymous function if you later want to remove the event handler.|
+
+### Related topics
+ 
+[removeOnLookupTagClick](removeOnLookupTagClick.md)
+
+[OnLookupTagClick event](../events/onlookuptagclick.md)
+ 
+
+

powerapps-docs/developer/model-driven-apps/clientapi/reference/controls/removeOnLookupTagClick.md

@@ -0,0 +1,41 @@
+---
+title: "removeOnLookupTagClick (Client API reference) in model-driven apps| MicrosoftDocs"
+ms.date: 10/31/2018
+ms.service: powerapps
+ms.topic: "reference"
+ms.assetid: 649fe7b0-016d-409f-ba3c-b14e0f1953e0
+author: "KumarVivek"
+ms.author: "kvivek"
+manager: "annbe"
+search.audienceType: 
+  - developer
+search.app: 
+  - PowerApps
+  - D365CE
+---
+# removeOnLookupTagClick (Client API reference)
+
+Removes an event handler from the [OnLookupTagClick](../events/onlookuptagclick.md) event.
+
+## Control types supported
+
+Lookup
+
+## Syntax
+
+`formContext.getControl(arg).removeOnLookupTagClick(myFunction);`
+
+## Parameter
+
+|Name|Type|Required|Description|
+|--|--|--|--|
+|myFunction|Function reference|Yes|The function to be removed from the [OnLookupTagClick](../events/onlookuptagclick.md) event.|
+
+### Related topics
+
+[addOnLookupTagClick](addOnLookupTagClick.md)
+ 
+[OnLookupTagClick event](../events/onlookuptagclick.md)
+ 
+
+

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

@@ -45,8 +45,10 @@ Events occur in Custom Engagement forms and grids whenever a form or grid loads,
 - [PostSearch](events/postsearch.md)
 
 ## Lookup control event
+- [OnLookupTagClick](events/onlookuptagclick.md)
 - [PreSearch](events/presearch.md)
 
+
 ## Process events
 - [OnProcessStatusChange](events/onprocessstatuschange.md)
 - [OnStageChange](events/onstagechange.md)

powerapps-docs/developer/model-driven-apps/clientapi/reference/events/onlookuptagclick.md

@@ -0,0 +1,33 @@
+---
+title: "OnLookupTagClick Event (Client API reference) in model-driven apps| MicrosoftDocs"
+ms.date: 02/11/2020
+ms.service: powerapps
+ms.topic: "reference"
+ms.assetid: e291973b-9634-4442-995c-37fd49a10571
+author: "KumarVivek"
+ms.author: "kvivek"
+manager: "annbe"
+search.audienceType: 
+  - developer
+search.app: 
+  - PowerApps
+  - D365CE
+---
+
+# OnLookupTagClick Event (Client API reference)
+
+This event occurs when the user clicks the tag in a lookup control. 
+
+An execution context object is passed to event handlers for this event. You can use the [getEventArgs](../executioncontext/getEventArgs.md) method to retrieve an object that has the **getTagValue** method. 
+
+The **getTagValue** method returns an object with the following properties:
+
+- **name**. String. Name of the tag.
+- **id**: String. ID of the tag.
+- **entityType**. String. Entity type of the tag.
+- **fieldName**. String. The originating lookup field that raised the event.
+
+## Methods supported for this event
+- [addOnLookupTagClick](../controls/addOnLookupTagClick.md) method to add event handlers for this event.
+- [removeOnLookupTagClick](../controls/removeOnLookupTagClick.md) method to remove event handlers for this event. 
+