Skip to content

Commit 594fef1

Browse files
Clare Zheng (Shanghai Wicresoft Co Ltd)Clare Zheng (Shanghai Wicresoft Co Ltd)
authored andcommitted
Update details and add difference section
1 parent 3827c0e commit 594fef1

File tree

1 file changed

+20
-27
lines changed

1 file changed

+20
-27
lines changed

articles/data-factory/connector-servicenow.md

Lines changed: 20 additions & 27 deletions
Original file line numberDiff line numberDiff line change
@@ -112,14 +112,19 @@ To copy data from ServiceNow, set the type property of the dataset to **ServiceN
112112
| type | The type property of the dataset must be set to: **ServiceNowV2Object** | Yes |
113113
| tableName | Name of the table. | No (if "expression" in activity source is specified) |
114114

115+
> [!Note]
116+
> In copy activities, the tableName in dataset will be the name of the table instead of the label in ServiceNow.
117+
115118
**Example**
116119

117120
```json
118121
{
119122
"name": "ServiceNowDataset",
120123
"properties": {
121124
"type": "ServiceNowV2Object",
122-
"typeProperties": {},
125+
"typeProperties": {
126+
"tableName": "<table name>"
127+
},
123128
"schema": [],
124129
"linkedServiceName": {
125130
"referenceName": "<ServiceNow linked service name>",
@@ -140,15 +145,13 @@ To copy data from ServiceNow, set the source type in the copy activity to **Serv
140145
| Property | Description | Required |
141146
|:--- |:--- |:--- |
142147
| type | The type property of the copy activity source must be set to: **ServiceNowV2Source** | Yes |
143-
| expression| Use the expression to read data. You can configure the expression in **Query builder**. | No (if "tableName" in dataset is specified) |
148+
| 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). | No (if "tableName" in dataset is specified) |
144149
| *Under `expression`* | | |
145150
| type | The expression type. Values can be Constant (default), Unary, Binary, and Field. | No |
146151
| value | The constant value. | Required when the expression type is Constant or Field |
147-
| operators | The operator value. For more information about available operators, see [Supported operators](#supported-operators).| Required when the expression type is Unary or Binary |
152+
| operators | The operator value. For more information about operators, see this [article](https://docs.servicenow.com/bundle/vancouver-platform-user-interface/page/use/common-ui-elements/reference/r_OpAvailableFiltersQueries.html).| Required when the expression type is Unary or Binary |
148153
| operands | List of expressions on which operator is applied.| Required when the expression type is Unary or Binary |
149154

150-
**Query builder** 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).
151-
152155

153156
**Example:**
154157

@@ -181,27 +184,6 @@ To copy data from ServiceNow, set the source type in the copy activity to **Serv
181184
]
182185
```
183186

184-
#### Supported operators
185-
186-
The supported operators in **Query builder** are shown in the table below:
187-
188-
| Operator name | Unary/Binary| Values required |
189-
|:--- |:--- |:--- |
190-
| is | Binary | low |
191-
| isnot | Binary | low |
192-
| contains | Binary | low |
193-
| starts with | Binary | low |
194-
| ends with | Binary | low |
195-
| is empty | Unary | NIL |
196-
| is not empty | Unary | NIL |
197-
| before | Binary | Low |
198-
| after | Binary | Low |
199-
| does not contain | Binary | low |
200-
| greater than | Binary | low |
201-
| less than | Binary | low |
202-
| is anything | Unary | NIL |
203-
| between | Binary | Low and High |
204-
205187
## Performance tips
206188

207189
### Schema to use
@@ -223,8 +205,19 @@ To learn details about the properties, check [Lookup activity](control-flow-look
223205
Here are the steps that help you to upgrade your ServiceNow linked service:
224206

225207
1. Create a new linked service by referring to [Linked service properties](#linked-service-properties).
226-
2. **Query** in source is changed to **Query builder**, which has the same usage as the condition builder in ServiceNow. Learn how to configure it referring to [ServiceNow as source](#servicenow-as-source) and [Condition builder](https://docs.servicenow.com/bundle/vancouver-platform-user-interface/page/use/common-ui-elements/concept/c_ConditionBuilder.html).
208+
2. **Query** in source is upgraded to **Query builder**, which has the same usage as the condition builder in ServiceNow. Learn how to configure it referring to [ServiceNow as source](#servicenow-as-source).
209+
210+
## Differences between ServiceNow and ServiceNow (legacy)
211+
212+
The ServiceNow connector offers new functionalities and is compatible with most features of ServiceNow (legacy) connector. The table below shows the feature differences between ServiceNow and ServiceNow (legacy).
227213

214+
| ServiceNow | ServiceNow (legacy) |
215+
|:--- |:--- |
216+
| useEncryptedEndpoints, useHostVerification, and usePeerVerification are not supported in the linked service. | Support useEncryptedEndpoints, useHostVerification and usePeerVerification in the linked service. |
217+
| Supports **Query builder** in the source. | **Query builder** is not supported in the source. |
218+
| SQL-based queries are not supported. | Support SQL-based queries. |
219+
| sortBy queries are not supported in **Query builder**. | Support sortBy queries in **Query**. |
220+
| You can view the schema in the dataset. | You can't view the schema in the dataset. |
228221

229222
## Related content
230223
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).

0 commit comments

Comments
 (0)