Интеграция с Dadata.ru
Материал из Planfix
Интеграция с сервисом DaData позволяет дополнить информацию в ПланФиксе проверенными данными о компаниях и контактах
Настройка интеграции
Настроить интеграцию можно следующим образом: Управление аккаунтом — Интеграции — Сервисы автозаполнения данных:
Затем кликаете на значок Dadata - кнопка добавления новой интеграции:
Открывается окно добавления новой интеграции:
В ней нужно заполнить следующие поля:
- Название интеграции — его вы указываете самостоятельно, ориентироваться можно на справочник, по которому будет осуществляться поиск;
- Ключ API — копируете из личного кабинета сервиса Dadata после регистрации:
- Справочник / База данных для интеграции — это справочник сервиса Dadata, по которому интеграция будет производить отбор.
- Применение автозаполнения — выбираете, к контакту или к задаче будет производиться автозаполнение.
- Ключевое поле в ПланФиксе — это поле, при изменении значения которого, интеграция начинает работу.
- Соответствие полей для заполнения — это блок, в котором производится сопоставление полей из справочника Dadata с полями ПланФикса. Источник данных — это поле справочника Dadata, Поле для заполнения — поле задачи или контакта в ПланФиксе, в которое должна быть помещена информация из справочника Dadata.
Особенности работы ключевых полей и поиска
Ключевыми могут быть как системные, так и пользовательские поля. Однако в ходе тестирования было выявлено, что не все типы пользовательских и системных полей могут содержать данные пригодные для поиска в справочниках Dadata. Особенности чтения значений остальных полей:
Системные поля задач:
- Название — интеграция считает значением название задачи, очищенное от пробелов, если они есть;
- Надзадача — интеграция считает значением название надзадачи той задачи, для которой запущена интеграция; Если надзадача не указана — значение будет пустым;
- Описание — считывает описание задачи, очищенное от пробельных символов, если они есть;
- Проект — считывает название проекта, в который входит изменяемая задача. Если проект не указан — значение будет пустым.
Системные поля контактов:
- Телефоны — интеграция выбирает первый телефон, который найдет в базе данных у изменяемого контакта, независимо от того какой телефон менялся фактически. Очищает его от всего, кроме цифр;
- Дополнительная информация — считывает дополнительную информацию контакта, очищенное от пробельных символов, если они есть;
- ФИО — берет имя, отчество, фамилию контакта, через пробел соединяет их в одну строку, эта строка становится значением ключевого поля. Изменением поля считается изменение любого из трех составляющих ФИО;
- Остальные поля в качестве ключевого значения берут текстовое представление значения поля, в том виде, в каком его видит пользователь ПланФикса.