Merge pull request #298092 from Clare-Zheng82/0410-Add_Dispaly_value_for_ServiceNow_v2

[New feature] Add Display value for ServiceNow

Author: prmerger-automator[bot]

articles/data-factory/connector-servicenow.md

@@ -34,9 +34,6 @@ For a list of data stores that are supported as sources/sinks, see the [Supporte
 
 The service provides a built-in driver to enable connectivity. Therefore you don't need to manually install any driver using this connector.
 
-**Please use the actual value instead of the displayed value in ServiceNow.**
-
-
 ## Prerequisite
 
 To use this connector, you need to have a role with at least read access to *sys_db_object* and *sys_dictionary* tables in ServiceNow.
@@ -116,6 +113,7 @@ To copy data from ServiceNow, set the type property of the dataset to **ServiceN
 |:--- |:--- |:--- |
 | type | The type property of the dataset must be set to: **ServiceNowV2Object** | Yes |
 | tableName | Name of the table. | Yes |
+| valueType | The type of ServiceNow table values. The value of this property can be `display` or `actual` (default). You can look at it as the parameter of `sysparm_display_value` as true or false when calling [ServiceNow REST APIs](https://developer.servicenow.com/app.do#!/rest_api_doc?v=jakarta&id=r_AggregateAPI-GET). | No |
 
 **Example**
 
@@ -125,7 +123,8 @@ To copy data from ServiceNow, set the type property of the dataset to **ServiceN
     "properties": {
         "type": "ServiceNowV2Object",
         "typeProperties": {
-            "tableName": "<table name>"
+            "tableName": "<table name>",
+            "valueType": "actual"
         },
         "schema": [],
         "linkedServiceName": {
@@ -147,7 +146,7 @@ To copy data from ServiceNow, set the source type in the copy activity to **Serv
 | Property | Description | Required |
 |:--- |:--- |:--- |
 | type | The type property of the copy activity source must be set to: **ServiceNowV2Source** | Yes |
-| expression| Use the expression to read data. You can configure the expression in **Query builder**. It has the same usage as the condition builder in ServiceNow. For instructions on how to use it, see this [article](https://docs.servicenow.com/bundle/vancouver-platform-user-interface/page/use/common-ui-elements/concept/c_ConditionBuilder.html). You can also [use expression parameters](#using-expression-parameters).| No |
+| expression| Use the expression to read data. You can configure the expression in **Query builder**. It has the same usage as the condition builder in ServiceNow. For instructions on how to use it, see this [article](https://docs.servicenow.com/bundle/vancouver-platform-user-interface/page/use/common-ui-elements/concept/c_ConditionBuilder.html). You can also [use expression parameters](#using-expression-parameters). Note that you should use the actual value instead of the display value.| No |
 | *Under `expression`* |  |  |
 | type | The expression type. Values can be Constant (default), Unary, Binary, Field and Nary.  | No  |
 | value | The constant value. |Yes when the expression type is Constant or Field |
@@ -283,7 +282,8 @@ The ServiceNow V2 connector offers new functionalities and is compatible with mo
 | Support **Query builder** in the source. | **Query builder** is not supported in the source. | 
 | SQL-based queries are not supported. | Support SQL-based queries. | 
 | sortBy queries are not supported in **Query builder**. | Support sortBy queries in **Query**. | 
-| You can view the schema in the dataset. | You can't view the schema in the dataset. | 
+| You can view the schema in the dataset. | You can't view the schema in the dataset. |
+| You can configure `valueType` to `display` or `actual` in datasets. The display or actual table name is used as the value of `tableName`. <br><br>The column name is `[column name]` for both display and actual value.| The display or actual table name with "Display" or "Actual" prefix appended is used as the value of `tableName`.<br><br>The column name for actual value is `[column name]_value`, while for display value is `[column name]_display_value`.|  
 
 ## Related content
 For a list of data stores supported as sources and sinks by the copy activity, see [supported data stores](copy-activity-overview.md#supported-data-stores-and-formats).