Ох уж эти программисты — вечно всё путают, тормозят и вместо Латте создают Эспрессо! То ли дело аналитик: у него и ТЗ, и логика железная, и кофе пьётся как-то осмысленнее. Вот пишешь им ТЗ, согласовываешь, потом ждёшь, а в голове крутится: «Ну сколько можно? Я бы за это время уже три интеграции настроил!»
Пора взяться за дело настоящему Бармену-Аналитику! Он не ждёт, пока код напишут, он сам смешивает ингредиенты: щепотку JSON, каплю маппинга, пару кликов — и вот уже данные аккуратно оседают в 1С, как гуща на дне турки.
Привет, дружище, с тобой снова Ведущий программист 1С Антон Михеев. Сегодня мы с тобой создадим ядреную заливку данных в 1С из любой другой системы.
К вам прилетает вот такой JSON из другой системы:
{
"ЗаказыКлиента": [
{
"Клиент": "Татьяна",
"Заказ": "Капучино",
"Количество": 1,
"НомерЗаказа": "00001"
},
{
"Клиент": "Тимур",
"Заказ": "Латте",
"Количество": 2,
"НомерЗаказа": "00002"
}
]
}
Задача: Срочно посадить данные в 1С.
Сцена из жизни: классика жанра
Аналитик пишет красивую ТЗшку, вечером скидывает программисту: «Чисто поржать и сделать». Программист тратит полчаса, чтобы расшифровать юмор, ещё час — чтобы понять, какой кейс имелся в виду, потом разрабатывает интеграцию, тестирует, а потом выясняется, что не все кейсы работают. Отправляет на доработку ТЗ.
С утра аналитик выпивает свой кофеек, обсуждает с коллегами вчерашние новости, смотрит пару мемов про «сроки вчера» и начинает думать: «А какой кейс мы не учли?» Скорректирует ТЗ и снова отправляет разработчику.
На следующий день программист знакомится с новым ТЗ, вносит правки, заливает на тест, передаёт аналитику… И так по кругу, пока не кончится кофе.
Узнаёте этот сценарий? Мы решили убрать из него самый дорогой этап — постоянное участие разработчика в небольших изменениях. Вместо этого появился конструктор, который позволяет самостоятельно настраивать интеграцию, тестировать её и сразу применять изменения без очередного релиза.
Рецепт быстрой интеграции: готовим вместе
Записывай рецепт:
-
щепотку быстрых интеграций из моей предыдущей статейки;
-
один новый документ;
-
слегка перемешай с HTTP-сервисом;
-
добавь пару кликов по интерфейсу;
-
и все данные попадут в твою любимую кружку с надписью «1С».
А теперь за дело!
Три типа входящих интеграций (как три степени прожарки)
Все входящие интеграции можно разбить на 3 типа — как степени обжарки кофе: лёгкая, средняя, тёмная:
-
Создать объект в 1С — это как приготовить новый напиток с нуля: всё с чистого листа.
-
Найти объект, и если его нет — создать — будто гость говорит: «Хочу тот самый Латте, который я брал в прошлый раз». Ищем, не находим — создаём.
-
Только найти объект и изменить в нём что-то — это когда надо просто поменять температуру напитка или добавить сироп.
Объект — это обычно Документ или Справочник.
Искать объект мы можем по ссылке, любому другому реквизиту или сочетанию реквизитов. Но в основном поиск происходит по Наименованию, Коду или Ссылке — как искать любимый сорт кофе по этикетке.
Найдя основной объект, мы можем изменять или заполнять его реквизиты.
Заходим в разбор ключа и во вкладку JSON прикладываем наш JSONчик
{
“Пользователь” = “Татьяна”,
“Заказ” = “Капучино”,
“Количество” = 1,
“НомерЗаказа” = “00001”
}
Как думаешь, что здесь будет Основным объектом?
Правильно Документ.ЗаказНаКофе
(Он уже лежит в пробнике, можно не отрываться от своего кофеечка
Тут Кофе это ссылка на справочник Кофе.
Давай создадим там ручками 2 элемента
Теперь можно попробовать создать ЗаказНаКофе из JSON
Сначала вставим JSON и нажмем Маппинг, получим список полей.
Укажем основной ключ ЗаказыКлиента и тем самым как-бы провалимся в массив.
Нажимаем маппинг и видим изменения.
Теперь перейдем во вкладку Маппинг.
Искать наш Заказ мы будем по упрощенному полю НомерЗаказа (Число)
Для этого перетянем НомерЗаказа вправо и заполним также, указав реквизит связи НомерЗаказа
Получается что по ключу
Жмем Тест и смотрим.
Все получилось и тестовый документ создался. Можно даже сразу в него провалиться.
Болванка создана, но данные увы пустые. Ничего, наливай еще кружечку, сейчас заполним!
Снова идем в маппинг и заполняем, все легко Количество будем преобразовывать В Число, Клиента В Строку, а вот что делать с Кофе? Это же ссылка на справочник?
Программист бы написал НайтиПоНаименованию, а мы сделаем аналогично в действии укажем Найти (По умолчанию ищет по GUID) , а в реквизите связи укажем Наименование
Запускаем тест и смотрим…
Все получилось!Везде Результат Ок, Провалимся в документ и…
Все данные заполнены верно!
Теперь Бизнес-аналитик может настраивать интеграции! И не просто может, а с удовольствием — ведь это как собрать идеальный напиток: всё под контролем, всё по рецепту.
В следующей статье мы добавим HTTP сервис который будет разбирать входящие JSON, а также сможем грузить из файлика Excel! До следующей статьи, для тебя создавал кофейный разбор Ведущий специалист 1С Михеев Антон.
ссылка на оригинал статьи https://habr.com/ru/articles/1060074/