topic Re: Information about 'GetEntityList' service in ThingWorx Developers

Information about 'GetEntityList' service

amittal-3 — Thu, 25 Jul 2019 08:33:41 GMT

Hello,

I m trying to use the 'GetEntityList' service in Thingworx which can be found in 'EntityServices' resource. This service has couple of parameters as below:

// result: INFOTABLE dataShape: "RootEntityList"
var result =  Resources["EntityServices"].GetEntityList({
	maxItems: undefined /* NUMBER */,
	nameMask: "PART" /* STRING */,
	type: "Thing" /* STRING */,
	tags: "CMU_MT_IOTServer2.0:AUTO" /* TAGS */
});

I am not able to understand about 'nameMask'. How is this parameter used? Does it take Reg-Ex as input or does it work on 'contains' mechanism? Kindly share some information/samples/examples on how to use this parameter.

Thanks in advance.

-Aditya Mittal

Re: Information about 'GetEntityList' service

khayes1 — Thu, 25 Jul 2019 09:29:05 GMT

Hi yes it is like reg-ex, so you could use filters such as:

"*PART*" which would return anything that contains 'PART' in the name

"PART*" which would return anything that begins with 'PART' in the name

"*PART" which would return anything that ends with 'PART' in the name

so to get all Thing entities with 'PART' somewhere in the name you can use

var params = {
maxItems: undefined /* NUMBER */,
nameMask: "*PART*" /* STRING */,
type: "Thing" /* STRING */,
tags: "myTag" /* TAGS if required*/
};

// result: INFOTABLE dataShape: RootEntityList
var result = Resources["EntityServices"].GetEntityList(params);

Re: Information about 'GetEntityList' service

Constantine — Thu, 25 Jul 2019 09:46:59 GMT

Hello,

Just to epand on @khayes1 answer:

You can also use "?", which stands for a single character (analog of "." in regex)
It looks like you can also use regex character classes and quantifiers, e.g. "Device-[0-9]{4}" to find "Device-0001", etc.

/ Constantine

Re: Information about 'GetEntityList' service

amittal-3 — Thu, 25 Jul 2019 11:01:46 GMT

Thanks Guys for the quick response

Regards

Aditya