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