1

Параметры поиска Remote API

Topic: Параметры поиска Remote API

Здравствуйте! Выгружаю данные в exel таблицу посредством такого запроса:

svc=core/export_file&params={"spec":{
                "itemsType":"avl_unit",
                "propName":"sys_name",
                "propValueMask":"!(П)*",
                "sortType":"sys_name"
                },
                "force":0,
                "flags":"0x0045" 
}&sid=

Выгружаются поля "Имя, Учетная запись и Последнее сообщение" у объектов  в названии которых нет (П).
Нужно применить второй фильтр по названию группы в которой состоит объект. Предполагаю, что запрос должен выглядеть таким образом:

svc=core/export_file&params={"spec":{
                "itemsType":"avl_unit",
                "propName":"sys_name,ГРУППА",
                "propValueMask":"!(П)*,=Потеря*",
                "sortType":"sys_name,ГРУППА"
                },
                "force":0,
                "flags":"0x0045" 
}&sid=

Но параметра поиска который надо поставить вместо "ГРУППА" не нашел в документации. Подскажите пожалуйста название этого параметра.
Или же так отсортировать невозможно и надо в ItemsType указывать avl_unit_group, но тогда как делать выгрузку именно объектов, а не просто списка групп и какие флаги использовать для выгрузки нужных полей у объектов?

2

Параметры поиска Remote API

Re: Параметры поиска Remote API

Добрый день!

По названию группы нет, но можно указать id группы - параметр sys_unit_groups. Ниже пример запроса поиска и экспорт результата в excel
Тогда будут найдены объекты, которые находятся в группе с указанным id

svc=core/search_items

https://hst-api.wialon.com/wialon/ajax.html?svc=core/search_items&sid=02bd4c4ff46f4c72732c8dc02&params={"spec":{"itemsType":"avl_unit","propName":"sys_name,sys_unit_groups","propValueMask":"*,1954","sortType":"sys_name","propType":"property,list"},"force":1,"flags":1439,"from":0,"to":19}

svc=core/export_file

https://hst-api.wialon.com/wialon/ajax.html?svc=core/export_file&sid=02bd4cce0de2272732c8dc02&params={"spec":{"itemsType":"avl_unit","propName":"sys_name,sys_unit_groups","propValueMask":"*,1954","sortType":"sys_name","propType":"property,list"},"force":1,"flags":69}

"propValueMask" применяется маска имени к поиску самих элементов, которые указаны в  "itemsType" . В вашем случае это маски к имени объекта.

Флаги для экспорта в колонки Excel описаны тут. В вашем примере по сумме флагов и выходят колонки, которые вы получаете - "Имя, Учетная запись и Последнее сообщение"

Diana Cheley
Wialon Hosting Expert
Gurtam
3

Параметры поиска Remote API

Re: Параметры поиска Remote API

chdi wrote:

Добрый день!

По названию группы нет, но можно указать id группы - параметр sys_unit_groups. Ниже пример запроса поиска и экспорт результата в excel
Тогда будут найдены объекты, которые находятся в группе с указанным id

svc=core/search_items

https://hst-api.wialon.com/wialon/ajax.html?svc=core/search_items&sid=02bd4c4ff46f4c72732c8dc02&params={"spec":{"itemsType":"avl_unit","propName":"sys_name,sys_unit_groups","propValueMask":"*,1954","sortType":"sys_name","propType":"property,list"},"force":1,"flags":1439,"from":0,"to":19}

svc=core/export_file

https://hst-api.wialon.com/wialon/ajax.html?svc=core/export_file&sid=02bd4cce0de2272732c8dc02&params={"spec":{"itemsType":"avl_unit","propName":"sys_name,sys_unit_groups","propValueMask":"*,1954","sortType":"sys_name","propType":"property,list"},"force":1,"flags":69}

"propValueMask" применяется маска имени к поиску самих элементов, которые указаны в  "itemsType" . В вашем случае это маски к имени объекта.

Флаги для экспорта в колонки Excel описаны тут. В вашем примере по сумме флагов и выходят колонки, которые вы получаете - "Имя, Учетная запись и Последнее сообщение"

Огромное спасибо! А подскажите как узнать ID группы, да и вообще объектов, на будущее. Ссылки на возможно имеющийся мануал вполне достаточно.

4

Параметры поиска Remote API

Re: Параметры поиска Remote API

ID группы можно узнать через поиск этой группы по названию : в svc=core/search_items  поиск по "itemsType" как avl_unit_group
В JSON ответе по базовому  flags  = 1  будет возвращен id группы. Такой подход используется также для других элементов, например, id ресурса узнать. Подробнее о флагах тут

Diana Cheley
Wialon Hosting Expert
Gurtam