Ничего не заливается: сначала покажем план построчно.
Шаг 2
Проверка и согласование
Сети
Одна задача на всю сеть. Проверьте, на кого она уходит.
Шаг 3
Создать в CRM
Строки из шага 2 создаются задачами через API
от вашей учётки. Созданное помнит журнал: повторный запуск не заведёт задачу второй раз.
По новому шаблону начните с одной строки и проверьте карточку.
Запись в CRM выключена (crm_write в настройках) — остаётся файл для мастера.
Выгрузить файлом для мастера импорта — запасной путь
Настройка закрыта
Раздел доступен только администратору.
Шаблоны заливок
С чего начать
Скопировать похожий
и поменять то, что отличается
Удаления нет: шаблон снимается с витрины,
файл остаётся под git с историей правок.
Команды
Состав в одном месте — config/teams.yaml.
Шаблон ссылается на команду по имени, три шаблона на одну команду не расходятся.
Справочные данные
Журнал заливок
Пользователи
Имя идёт в журнал и в план (кто собрал, кто утвердил).
Контакт в CRM - им подписываются созданные записи. Удаления нет: только выключить.
Кто что менял
Что делает этот шаблон
Собрано из настроек — это не описание, а их пересказ. Если фраза
читается неверно, неверна настройка.
Готов к автозапуску?
Триггерная заливка идёт без человека. Всё, что требует ответа
или решения, должно быть задано заранее.
Как шаблон называется
Его видно в списке на витрине.
Ляжет в config/recipes/. После создания не меняется.
Одна-две строки: что это за заливка и когда её делают.
Что и где заводим
Откуда берутся строки
Сейчас — файл от бизнеса. Написаний заголовка можно несколько
через запятую: выгрузки приезжают по-разному, и падать из-за этого не нужно.
Как зовём колонку
Какие заголовки ищем в файле
Обязательна
Выгрузка бывает понедельной, и один ВПИД встречается в ней
пять раз. Оставим первую строку, остальные снимем как повтор — если так
велит правило «повтор ключа в файле».
Связи с CRM
Поля, которые ссылаются на запись в CRM: значение из файла →
поиск записи → что делать, если не нашли. Целевая запись либо нашлась, либо строки
нет; там же настраиваются сети. У людей — лестница кандидатов. После опознания
поля записи доступны в шаблонах как {заведение.название}, в лестницах —
«с карточки», в правилах — «заведение ведёт живой менеджер».
Связью может стать справочное поле, у объекта которого описаны
способы поиска: Заведение, Контакт.
Что делаем со строкой, когда инструмент что-то знает о ней
Слева — факт, который инструмент умеет установить. Справа —
реакция. «Снять» и «ошибка» попадают в отчёт той же фразой. Список фактов
закрытый: это то, что можно объяснить одной фразой в отчёте.
Факт
Уточнение
Реакция
Целевая запись не опознана
всегда: без записи нечего заводить
снять строку
Поля записи
Порядок полей — порядок колонок в файле импорта.
Колонка в файле названа отдельно только тогда, когда её имя отличается от имени поля.
Поле-связь показывает итог лестницы; настраивается в «Связях с CRM».
Что значит каждый вариант в колонке «Откуда берётся»Как устроены переменные в шаблонах
{row.роль} — значение из колонки файла. Роль — как колонку зовём мы в разделе «Источник». {заведение.название}, {заведение.ответственный}, {контакт.имя} — атрибуты
опознанной записи, по имени связи. {account.name} — старое имя целевой связи, работает как раньше. {params.ключ} — ответ бизнеса на вопрос. {date} — сегодняшняя дата. {account.members} — список заведений сети, если строки схлопываются. У обычной строки пуст.
Строка, в которой все переменные пустые, в текст не попадает. Заголовок пишите
в той же строке, что и переменную.
Что решает шаблон, а что — бизнес перед сборкой
У каждого значения есть тот, кто за него отвечает.
«Спрашивается» — без человека прогон не соберётся; для триггерной заливки таких быть не должно.
Чтобы ответ куда-то попал, поле берёт его источником «вопрос бизнесу» или подставляет
в шаблон как {params.ключ}.
Тег прогона
Обязателен у каждого шаблона. До OData-пути пишется в журнал и
участвует в сравнении «такая же задача»; в CRM проставится на OData-пути.
Мастер импорта вешает свой — «Загрузка данных <дата>».
Проверка шаблона
Колонки файла импорта, в этом порядке
Справочник: что будет, если
Те же тексты открываются по значку «?» рядом с настройкой. Примеры — из
реальных прогонов, обезличенные.