Коннектор - это сервис, созданный для интеграции различных систем с ПланФиксом. Например, можно отслеживать состояние посылок по их трек-кодам прямо в справочнике ПланФикс или получать в ПланФикс свежие курсы валют. А можно при создании задачи в ПланФикс получать сообщение в Телеграм-канал.
Это лишь небольшая часть того, что уже умеет Коннектор. Если вы хотите интегрировать ПланФикс с каким-либо внешним сервисом, обращайтесь - мы обязательно поможем реализовать ваши идеи.
Для начала работы, необходимо выбрать подключения, которые вы будете использовать и объединить их в коннектор.
Подключения - это кирпичики, из которых собирается коннектор. Каждый модуль хранит в себе настройки подключения к сервису. Для модуля Planfix - это настройки доступа к Planfix API, а для модуля курсов валют - настройки не нужны.
В Коннекторе уже есть встроенный набор модулей, который можно использовать в работе.
Для этого перейдите на страницу Мои подключения и нажмите на иконку шестерёнки. Откроется окно управления модулями. Дальше выберите нужные подключения. Например, вы хотите получать в ПланФикс курсы валют ЦБРФ. Для этого включите подключения Planfix и CurrencyRu. Нажмите кнопку [Закрыть]. Страница обновится и вы увидите эти подключения в списке. Нажатие на кнопку [Настроить] откроет окно настройки модуля, в котором вы можете указать настройки в формате JSON. Для модуля CurrencyRu никакие настройки не нужны, а для модуля Planfix нужно указать настройки подключения к Planfix API.
Выглядеть это должно так:
{
"api_key": "7009d5d15610ba4fdcd42ca5276ffe2b",
"api_url":
"https://api.planfix.ru/xml",
"api_token":
"f12d0dfb4632812c14685fc8ba49a11cf",
"account_name": "moyaccount"
}
Разумеется, вы должны указать свои настройки.
Нажмите [Сохранить изменения].
Настройка модуля завершена.
Для этого перейдите на страницу Коннекторы и нажмите иконку с плюсом. Откроется окно, в котором нужно указать название коннектора, источник данных (модуль) - в нашем примере CurrencyRu, настройку cron (расписание запуска коннектора) и, по желанию, описание. После нажатия на кнопку [Сохранить изменения] новый коннектор появится в списке. Теперь можно его настроить.
Прежде чем настраивать коннектор, необходимо подготовить ПланФикс.
Рассмотрим на примере получения Курсов валют от ЦБРФ в ПланФикс. Для этого нужно создать в ПланФикс новый справочник с полями "Название", "Код", "RUB", "Дата обновления".
Теперь внесите в созданный справочник записи с кодами валют. Например, добавьте запись с кодами USD, EUR и GBP. Остальные поля заполнять не нужно - они подтянутся с сайта ЦБРФ. Когда справочник создан, переходим в Коннектор и выбираем тот, который хотим настроить.
У каждого коннектора есть кнопка включения/выключения и кнопки в виде иконок [Скопировать Webhook-Token] и [Настроить]. Сейчас нас интересует кнопка [Настроить] - нажимаем. Открывается окно настроек. В списке "Справочник ПланФикс" выбираем наш справочник. В списки "Поля справочника" из ПланФикс подгрузятся поля выбранного справочника. Теперь нужно указать соответствия полей. Для поля "Название валюты" выбираем из списка поле "Название", для поля "Код" - код валюты и т.д. В поле JSON появятся настройки (это поле информационное - его нельзя редактировать). Далее в поле cron настраиваем расписание.
После настройки нажмите на [Сохранить изменения]. Для того, чтобы включить коннектор, переведите переключатель в положение "Подключён".
Всё, коннектор включён и работает. Данные в справочнике будут обновляться согласно расписанию.