ПланФикс API: Фильтры контактов: различия между версиями

Материал из Planfix
Перейти к: навигация, поиск
Нет описания правки
Нет описания правки
 
(не показано 13 промежуточных версий 3 участников)
Строка 1: Строка 1:
{{#seo:
|title=ПланФикс API: Фильтры контактов
|titlemode=append
|keywords=планфикс, контакты, фильтры, апи, api
|description=ПланФикс API: Фильтры контактов
}}
Фильтры контактов задаются следующим набором параметров:
Фильтры контактов задаются следующим набором параметров:
* type - числовой идентификатор фильтра
* type - числовой идентификатор фильтра
Строка 57: Строка 64:


|-
|-
|4011 || Дата рождения
|4223 || Дата рождения (с учетом года)
|-
|4011 || Дата рождения (без учета года)
|-
|-
|4213 || Контрагент в задачах с последней активностью
|4213 || Контрагент в задачах с последней активностью
Строка 90: Строка 99:
|-
|-
|4006  || Является компанией
|4006  || Является компанией
| rowspan="7" |   
| rowspan="13" |   
*equal  
*equal  
| rowspan="7" |  int - 1
| rowspan="13" |  int - 1
|-
|-
|4007 || Является контактом
|4007 || Является контактом
Строка 106: Строка 115:
|4018 || Не может быть контрагентом задач
|4018 || Не может быть контрагентом задач
|-
|-
|4001  || Имя контакта / название компании
|4201 || Контрагент без активных задач
| rowspan="6" |   
|-
|4202 || Не участвует в активных задачах
|-
|4203 || Контрагент с активными задачами
|-
|4204 || Участвует в активных задачах
|-
|4205 || Контрагент в просроченных задачах
|-
|4206 || Участвует в просроченных задачах
|-
|4001  || Имя или фамилия контакта / название компании
| rowspan="9" |   
*equal  
*equal  
*notequal  
*notequal  
| rowspan="6" |  string - осуществляется фильтр содержит / не содержит
| rowspan="9" |  string - осуществляется фильтр содержит / не содержит
|-
|-
|4002|| Должность
|4002|| Должность
Строка 119: Строка 140:
|-
|-
|4005|| Email
|4005|| Email
|-
|4221|| Дополнительный email
|-
|4014|| Имя контакта / Название компании
|-
|4015|| Фамилия контакта
|-
|-
|4101 || Пользовательское поле типа Строка
|4101 || Пользовательское поле типа Строка
Строка 148: Строка 175:
| int - идентификатор записи
| int - идентификатор записи
|-
|-
|4114  || Пользовательское поле типа Набор записей справочника
|
*equal
*notequal
| int - идентификатор записи, для условия по нескольким записям - идентификаторы через ; (точку с запятой)
|-
|4111  || Пользовательское поле типа Набор значений
|
*equal
*notequal
| string - значение, для условия по нескольким значениям - значения через ; (точку с запятой)
|-
|4008  || Группа контактов
|
*equal
*notequal
| int - идентификатор группы, можно получить методом [[ПланФикс API contact.getGroupList | contact.getGroupList]]
|-
|4016 || Шаблон контакта
|
*equal
*notequal
| int - номер шаблона, general в ответе метода [[ПланФикс API contact.getList | contact.getList]] с target = template
|}
== Перейти ==
*[[ПланФикс API:Контакты]]
*[[Коды ошибок]]
*[[Список функций]]

Текущая версия от 04:09, 18 июня 2022

Фильтры контактов задаются следующим набором параметров:

  • type - числовой идентификатор фильтра
  • operator - оператор фильтра, одно из значений из списка (equal, notequal, gt, lt) у разных фильтров могут быть разные допустимые операторы.
  • value - значение фильтра, может быть строкой, числом или сложным объектом, в зависимости от типа фильтра
  • field - идентификатор пользовательского поля, для фильтров по пользовательским полям
Тип Название Операторы Формат value
12 Дата создания
  • equal
  • notequal
  • gt
  • lt

объект : 

<value>
  <datetype></datetype>
  <datevalue></datevalue>
  <datefrom></datefrom>
  <dateto></dateto>
</value>

datetype принимает следующие значения:

  • today - сегодня
  • yesterday - вчера
  • tomorrow - завтра
  • thisweek - текущая неделя
  • lastweek
  • nextweek
  • thismonth
  • lastmonth
  • nextmonth
  • last - последние n дней, n передается в datevalue
  • next - следующие n дней, n передается в datevalue
  • in - через n дней, n передается в datevalue
  • anotherdate - точная дата, дата передается в формате дд-мм-гггг в datefrom
  • anotherperiod - точный период, даты передаются в формате дд-мм-гггг в datefrom и dateto

примеры: 

<value>
  <datetype>thisweek</datetype>
</value>
<value>
  <datetype>anotherperiod</datetype>
  <datefrom>01-01-2015</datefrom>
  <dateto>01-02-2015</dateto>
</value>
4223 Дата рождения (с учетом года)
4011 Дата рождения (без учета года)
4213 Контрагент в задачах с последней активностью
4219 Контрагент без задач с последней активностью
4214 Участвует в задачах с последней активностью
4220 Не участвует в задачах с последней активностью
4103 Пользовательское поле типа Дата
1 Добавил
  • equal
  • notequal
 int : идентификатор сотрудника
2 Ответственный
47 Доступен пользователю
48 Может редактироваться пользователем
4108 Пользовательское поле типа Контакт
4109 Пользовательское поле типа Сотрудник
4112 Пользовательское поле типа Группа, сотрудник, контакт
4113 Пользовательское поле типа Список сотрудников
4006 Является компанией
  • equal
 int - 1
4007 Является контактом
4010 С доступом в ПланФикс
4012 Может быть участником задач
4017 Не может быть участником задач
4013 Может быть контрагентом задач
4018 Не может быть контрагентом задач
4201 Контрагент без активных задач
4202 Не участвует в активных задачах
4203 Контрагент с активными задачами
4204 Участвует в активных задачах
4205 Контрагент в просроченных задачах
4206 Участвует в просроченных задачах
4001 Имя или фамилия контакта / название компании
  • equal
  • notequal
 string - осуществляется фильтр содержит / не содержит
4002 Должность
4003 Телефон
4004 Адрес
4005 Email
4221 Дополнительный email
4014 Имя контакта / Название компании
4015 Фамилия контакта
4101 Пользовательское поле типа Строка
4102 Пользовательское поле типа Число
  • equal
  • notequal
  • gt
  • lt
 int
4105 Пользовательское поле типа Чекбокс
  • equal
  • notequal
 int - 1 / 0
4106 Пользовательское поле типа Список
  • equal
  • notequal
 string
4107 Пользовательское поле типа Справочник
  • equal
  • notequal
 int - идентификатор записи
4114 Пользовательское поле типа Набор записей справочника
  • equal
  • notequal
 int - идентификатор записи, для условия по нескольким записям - идентификаторы через ; (точку с запятой)
4111 Пользовательское поле типа Набор значений
  • equal
  • notequal
 string - значение, для условия по нескольким значениям - значения через ; (точку с запятой)
4008 Группа контактов
  • equal
  • notequal
 int - идентификатор группы, можно получить методом contact.getGroupList
4016 Шаблон контакта
  • equal
  • notequal
 int - номер шаблона, general в ответе метода contact.getList с target = template


Перейти

Источник — http://planfix.com/ru/help/index.php?title=ПланФикс_API:Фильтры_контактов&oldid=39620