Интеграция с Dadata.ru: различия между версиями

Материал из Planfix
Перейти к: навигация, поиск
Нет описания правки
Нет описания правки
Строка 37: Строка 37:
*Соответствие полей для заполнения — это блок, в котором производится сопоставление полей из справочника Dadata с полями ПланФикса. '''Источник данных''' — это поле справочника Dadata, '''Поле для заполнения''' — поле задачи или контакта в ПланФиксе, в которое должна быть помещена информация из справочника Dadata.
*Соответствие полей для заполнения — это блок, в котором производится сопоставление полей из справочника Dadata с полями ПланФикса. '''Источник данных''' — это поле справочника Dadata, '''Поле для заполнения''' — поле задачи или контакта в ПланФиксе, в которое должна быть помещена информация из справочника Dadata.


== Особенности работы ключевых полей и поиска ==
Ключевыми могут быть как системные, так и пользовательские поля. Однако в ходе тестирования было выявлено, что не все типы пользовательских и системных полей могут содержать данные пригодные для поиска в справочниках Dadata. Для чтения значений остальных полей существуют некоторые особенности.
'''Системные поля задач:'''
*Название — интеграция считает значением название задачи, очищенное от пробелов, если они есть;
*Надзадача — интеграция считает значением название надзадачи той задачи, для которой запущена интеграция; Если надзадача не указана — значение будет пустым;
*Описание — считывает описание задачи, очищенное от пробельных символов, если они есть;
*Проект — считывает название проекта, в который входит изменяемая задача. Если проект не указан — значение будет пустым.
'''Системные поля контактов:'''
*Телефоны — интеграция выбирает первый телефон, который найдет в базе данных у изменяемого контакта, независимо от того какой телефон менялся фактически. Очищает его от всего, кроме цифр;
*Дополнительная информация — считывает дополнительную информацию контакта, очищенное от пробельных символов, если они есть;
*ФИО — берет имя, отчество, фамилию контакта, через пробел соединяет их в одну строку, эта строка становится значением ключевого поля. Изменением поля считается изменение любого из трех составляющих ФИО;
*Остальные поля в качестве ключевого значения берут текстовое представление значения поля, в том виде, в каком его видит пользователь ПланФикса.
'''Пользовательские поля:'''
*Справочник — значением считается текстовое значение первого поля справочника из той записи, которая стоит в поле;
*Задача – название задачи, указанной в поле;
*Остальные поля в качестве значения берут текстовое значение представление в том виде, в каком его видит пользователь ПланФикса.
== Особенности работы полей при заполнении ==
На этапе тестирования было установлено, что часть системных полей задач, системных полей контактов и некоторые типы пользовательских полей заполнить в Dadata нечем. Для чтения значений остальных полей существуют некоторые особенности.
'''Системные поля задач:'''
*Название — изменит название задачи на значение из справочника Dadata;
*Надзадача — изменяемой задаче в поле «Надзадача» устанавливается задача, название которой совпадает с данными, пришедшими из Dadata. Если ее нет, поле не изменится;
*Проект — аналогично Надзадаче, но поиск происходит по названию проекта;
*Остальные поля заполняются текстовыми значениями из справочников Dadata, аналогично вводу этих значений вручную.
'''Системные поля контактов:'''
*Дополнительная информация — считывает дополнительную информацию контакта, очищенную от пробелов;
*Остальные поля заполняются текстовыми значениями из справочников Dadata, аналогично вводу этих значений вручную.
'''Пользовательские поля:'''
*Список — присланные Dadata данные добавляются как новый (и единственный) пункт списка;
*Набор значений — аналогично «Списку»;
*Проект — изменяемой задаче в поле «Проект» устанавливается проект, название которого совпадает с данными, пришедшими из Dadata;
*Справочник — значением поля становится первая найденная запись в справочнике, с которым связано поле, у которой значение первого поля совпадет с теми данными, которые прислала Dadata (кроме типа «Файлы);
*Набор записей справочника – аналогично типу «Справочник», но значением будет не первая найденная запись, а все найденные записи.
*Остальные поля в качестве значения берут текстовое значение представление в том виде, в каком его видит пользователь ПланФикса.


== Дополнительная информация ==
== Дополнительная информация ==
*[https://planfix.com/ru/blog/integraciya-s-dadata-ru/ Интеграция с Dadata.ru]
*[https://planfix.com/ru/blog/integraciya-s-dadata-ru/ Блог: Интеграция с Dadata.ru]




Версия от 12:31, 17 июня 2021

Интеграция с сервисом DaData позволяет дополнить информацию в ПланФиксе проверенными данными о компаниях и контактах

Настройка интеграции

Настроить интеграцию можно следующим образом: Управление аккаунтом — Интеграции — Сервисы автозаполнения данных:

3HeI81.png


Затем кликаете на значок Dadata - кнопка добавления новой интеграции:

WzQmdK.png


Открывается окно добавления новой интеграции:

TyI9P6.png


В ней нужно заполнить следующие поля:

  • Название интеграции — его вы указываете самостоятельно, ориентироваться можно на справочник, по которому будет осуществляться поиск;
  • Ключ API — копируете из личного кабинета сервиса Dadata после регистрации:

j0V7eB.png


  • Справочник / База данных для интеграции — это справочник сервиса Dadata, по которому интеграция будет производить отбор.
  • Применение автозаполнения — выбираете, к контакту или к задаче будет производиться автозаполнение.
  • Ключевое поле в ПланФиксе — это поле, при изменении значения которого, интеграция начинает работу.
  • Соответствие полей для заполнения — это блок, в котором производится сопоставление полей из справочника Dadata с полями ПланФикса. Источник данных — это поле справочника Dadata, Поле для заполнения — поле задачи или контакта в ПланФиксе, в которое должна быть помещена информация из справочника Dadata.


Дополнительная информация


Перейти

Источник — http://planfix.com/ru/help/index.php?title=Интеграция_с_Dadata.ru&oldid=33494