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

Материал из Planfix
Перейти к: навигация, поиск
Нет описания правки
Нет описания правки
 
(не показано 19 промежуточных версий 3 участников)
Строка 2: Строка 2:
|title=Интеграция с DaData.ru
|title=Интеграция с DaData.ru
|titlemode=append
|titlemode=append
|keywords=планфикс, planfix, dadata.ru, дадата, интеграция
|keywords=планфикс, planfix, dadata.ru, дадата, интеграция дадата, интеграция
|description=Интеграция с сервисом DaData позволяет дополнить информацию в ПланФиксе проверенными данными о компаниях и контактах
|description=Интеграция с сервисом DaData позволяет дополнить информацию в ПланФиксе проверенными данными о компаниях и контактах
}}
}}
Интеграция с сервисом [https://dadata.ru/ DaData] позволяет дополнить информацию в ПланФиксе проверенными данными о компаниях и контактах.


Интеграция с сервисом [https://dadata.ru/ DaData] позволяет дополнить информацию в ПланФиксе проверенными данными о компаниях и контактах
== Настройка интеграции ==
== Настройка интеграции ==
*Перейдите в раздел: '''Управление аккаунтом''' — '''Интеграции''' — '''Сервисы автозаполнения данных''':


Настроить интеграцию можно следующим образом: Управление аккаунтом — Интеграции — Сервисы автозаполнения данных:
https://p.pfx.so/pf/2l/0PsESV.png


https://p.pfx.so/pf/o5/3HeI81.png


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


https://p.pfx.so/pf/mA/WzQmdK.png
https://p.pfx.so/pf/mA/WzQmdK.png




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


https://p.pfx.so/pf/EU/TyI9P6.png
https://p.pfx.so/pf/EU/TyI9P6.png




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


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


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


https://p.pfx.so/pf/LK/aa15Ik.png


== Особенности работы ключевых полей и поиска ==


Ключевыми могут быть как системные, так и пользовательские поля. Однако в ходе тестирования было выявлено, что не все типы пользовательских и системных полей могут содержать данные пригодные для поиска в справочниках Dadata. Для чтения значений остальных полей существуют некоторые особенности.
== Дополнительная информация ==
 
*[https://planfix.com/ru/blog/integraciya-s-dadata-ru/ Запись в блоге: Интеграция с Dadata.ru]
'''Системные поля задач:'''
*Название — интеграция считает значением название задачи, очищенное от пробелов, если они есть;
*Надзадача — интеграция считает значением название надзадачи той задачи, для которой запущена интеграция; Если надзадача не указана — значение будет пустым;
*Описание — считывает описание задачи, очищенное от пробельных символов, если они есть;
*Проект — считывает название проекта, в который входит изменяемая задача. Если проект не указан — значение будет пустым.
 
'''Системные поля контактов:'''
*Телефоны — интеграция выбирает первый телефон, который найдет в базе данных у изменяемого контакта, независимо от того какой телефон менялся фактически. Очищает его от всего, кроме цифр;
*Дополнительная информация — считывает дополнительную информацию контакта, очищенное от пробельных символов, если они есть;
*ФИО — берет имя, отчество, фамилию контакта, через пробел соединяет их в одну строку, эта строка становится значением ключевого поля. Изменением поля считается изменение любого из трех составляющих ФИО;
*Остальные поля в качестве ключевого значения берут текстовое представление значения поля, в том виде, в каком его видит пользователь ПланФикса.
 
'''Пользовательские поля:'''
*Справочник — значением считается текстовое значение первого поля справочника из той записи, которая стоит в поле;
*Задача – название задачи, указанной в поле;
*Остальные поля в качестве значения берут текстовое значение представление в том виде, в каком его видит пользователь ПланФикса.
 
== Особенности работы полей при заполнении ==
На этапе тестирования было установлено, что часть системных полей задач, системных полей контактов и некоторые типы пользовательских полей заполнить в Dadata нечем. Для чтения значений остальных полей существуют некоторые особенности.


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

Текущая версия от 06:31, 23 апреля 2024

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

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

  • Перейдите в раздел: Управление аккаунтомИнтеграцииСервисы автозаполнения данных:

0PsESV.png


  • Кликните на значок Dadata — затем на кнопку добавления новой интеграции:

WzQmdK.png


  • Откроется окно настроек интеграции:

TyI9P6.png


Заполните следующие поля:

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

j0V7eB.png


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

aa15Ik.png


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

Перейти