Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

In Power BI Connector the most of OData (Power query) operators are supported: $top, $skip, $select, $count, $search, $orderby, $filter.

...

  • $select - allows users to request a specific set of properties for each entity (fields that were added in the export config are available for selection)

  • $top - requests the number of items in the queried collection to be included in the result 

  • $skip+$top(as a Keep Range of Rows) - allows users to set the range of items, skip top and limit the number of requested items:

  • $orderby - allows users to request resources in a particular order (fields that were added in the export config are available for selection). Multiple ordering is supported, in this case, the next $orderby will be applied to the previous order results:

  • $filter - allows users to return a collection of items filtered by logical parameters for Text type ('eq'
    'and','or','gt','ge','lt','le',''contains','startswith' etc.) and Date type ('after', ‘before', 'today’ etc.) for each column:

    and Date fields:

Starting with version 1.6.15 of Power BI Connector for ServiceNow, $filter with the IN operator supports multiple single strings and does not support the following field types:

  • Date

  • DateTime

  • Boolean

  • Duration (in any view: seconds, OData, string)

  • ID (use sys_id to filter by item ID)

Info

The Use display value option is not supported for the fields above.

Examples

How to run for sc_req_item table with Direct fields:

$filter=number IN RITM0000001, RITM0000002, RITM0000003
$filter=sys_mod_count IN 1,2,3
$filter=cmdb_ci IN <sys_id>, <sys_id>,<sys_id>

https://ven05067.service-now.com/api/x_acsof_power_bi_s/v1/power_bi_connector/72199e9c47485a10126bd677746d4389/sc_req_item?$filter=number%20IN%20RITM0010009,RITM0010006

https://ven05067.service-now.com/api/x_acsof_power_bi_s/v1/power_bi_connector/72199e9c47485a10126bd677746d4389/sc_req_item?$filter=sys_mod_count%20IN%200,2

https://ven05067.service-now.com/api/x_acsof_power_bi_s/v1/power_bi_connector/72199e9c47485a10126bd677746d4389/sc_req_item?$filter=cmdb_ci%20IN%20a9a2d111c611227601fb37542399caa8,%2029c175213784200044e0bfc8bcbe5d1f

with Referenced fields:

$filter=cmdb_ci.sys_class_name IN cmdb_ci_computer, laptop
$filter=cmdb_ci.sys_mod_count IN 1,2,3
$filter=cmdb_ci.location IN <sys_id>, <sys_id>,<sys_id>

https://ven05067.service-now.com/api/x_acsof_power_bi_s/v1/power_bi_connector/72199e9c47485a10126bd677746d4389/sc_req_item?$filter=cmdb_ci.sys_class_name IN cmdb_ci_computer

https://ven05067.service-now.com/api/x_acsof_power_bi_s/v1/power_bi_connector/72199e9c47485a10126bd677746d4389/sc_req_item?$filter=cmdb_ci.sys_mod_count IN 7,15

https://ven05067.service-now.com/api/x_acsof_power_bi_s/v1/power_bi_connector/72199e9c47485a10126bd677746d4389/sc_req_item?$filter=cmdb_ci.location IN 8225b668ac1d55eb679878e192fca315,f90aa2f50a0a0b9100576930575aa596

The next 3 OData operators are easy to check directly from browser, write correct HTTP request with parameters. Please see the example below:

  1. only with whole words, no half words supported

  2. no chars, (no numbers, boolean, referenced fields, special symbols)

  3. no OR/AND operator supported

To check $search parameter enter in your browser URL:

https://ven05068.service-now.com/api/x_716979_powerbi_c/v1/powerbi_connector/[datasource_id]/[table_name]?$search={T},
where T - is Text or Numbers types, lower/upper cases are supported

...

NOTE: $expand operator is not supported.