Создание кодогенератора для Postman

13.03.22

Интеграция - WEB-интеграция

+11 –

Опишу порядок разработки кодогенератора для Postman c использованием OneScript и HTTPКоннектор.

Вводные

Нужно из коллекции postman создать код для 1С:Предприятие

Вариант реализации

1. Нужно зайти в проект postman-code-generators, внимательно почитать contributing guide

2. Создать issue с описанием варианта кодогенератора https://github.com/postmanlabs/postman-code-generators/issues/546

3. Сделать форк репозитория https://github.com/malikov-pro/postman-code-generators, склонировать на рабочее место.

4. Разобраться в коде на NodeJS, запустить окружение на nix, потому что тесты запускаются через .sh.

5. Установить на эту же машину onescript, потому что его удобнее запускать под консолью, синтаксис библиотек 1connector отличается только получением текста запроса ответа.

5. Посмотреть как сделано для других языков, у меня получилось понять с 3 раза, в итоге за основу взял python-requests, потому что изучаю python и относительно просто получилось запустить тесты.

6. Написать генератор.

7. Запустить тесты, увидеть что половина заваливается.

8. Сделать файл генерации .bsl, положить его в корень.

test.js, с примером теста который так и не осилил, возможно косяк в самом тесте,

var codegen = require('./'), // require postman-code-generators in your project
  sdk = require('postman-collection'), // require postman-collection in your project
  // using postman sdk to create request
  language = 'onescript',
   variant = '1connector'
  // language = 'python',
  // variant = 'requests'

let postRequest = {
  "method": "POST",
  "header": [],
  "body": {
    "mode": "formdata",
    "formdata": [
      {
        "key": "pl",
        "value": "'a'",
        "type": "text"
      },
      {
        "key": "qu",
        "value": "\"b\"",
        "type": "text"
      },
      {
        "key": "sa",
        "value": "d",
        "type": "text"
      },
      {
        "key": "Special",
        "value": "!@#$%&*()^_+=`~",
        "type": "text"
      },
      {
        "key": "Not Select",
        "value": "Disabled",
        "type": "text",
        "disabled": true
      },
      {
        "key": "more",
        "value": ",./';[]}{\":?><|\\\\",
        "type": "text"
      }
    ]
  },
  "url": {
    "raw": "https://postman-echo.com/post",
    "protocol": "https",
    "host": [
      "postman-echo",
      "com"
    ],
    "path": [
      "post"
    ]
  }
},
  request = new sdk.Request(postRequest),
  options = {
    requestTimeout: 5,
    followRedirect: false,
  };

codegen.convert(language, variant, request, options, function (error, snippet) {
  if (error) {
    //  handle error
  }

  let fs = require('fs');
  fs.writeFileSync('test.bsl', snippet);
});

Результат

test.bsl

#Использовать 1connector

ДополнительныеПараметры = Новый Структура;
ДополнительныеПараметры.Вставить("Таймаут", 5);
ДополнительныеПараметры.Вставить("РазрешитьПеренаправление", Ложь);

URL = "https://postman-echo.com/post";

Данные = Новый Структура;
Данные.Вставить("pl", "'a'");
Данные.Вставить("qu", """b""");
Данные.Вставить("sa", "d");
Данные.Вставить("Special", "!@#$%&*()^_+=`~");
Данные.Вставить("more", ",./';[]}{"":?><|\\");
ДополнительныеПараметры.Вставить("Данные", Данные);

Заголовки = Новый Соответствие;

ДополнительныеПараметры.Вставить("Заголовки", Заголовки);

Ответ = КоннекторHTTP.ВызватьМетод("POST", URL, ДополнительныеПараметры);

Сообщить(Ответ.Текст());

8.1 Настроить отладку, работаю чз VSCode, с подключением по SSH, по умолчанию запускает index.js, решается созданием конфигурационного файла и правки на test.js.

8.2 Запустить тесты еще десяток раз, исправить ошибки, получить "@postman/codegen-onescript-1connector: ok!"

9. Сделать коммит, отправить изменения в репозиторий, сделать Pull Request. привязать к исходной задаче.

https://github.com/postmanlabs/postman-code-generators/pull/592

Итог

Рабочий генератор кода который можно пользовать пока что из JS, после принятия PR думаю появится в приложении.

Благодарю за внимание.

+11 –

См. также

Service Desk Online – веб-портал для 1С ITIL, 1С ITILIUM и Управление IT-отделом 8

WEB-интеграция Администрирование веб-серверов Платные (руб)

Веб-портал обеспечивает удобный доступ к конфигурации 1С:ITIL(ИТИЛ), 1С:ITILIUM, Управление IT-отделом 8 через интернет с любого устройства посредством браузера, увеличивая эффективность работы пользователей и снижая нагрузку на сервер. Быстрая инсталляция портала за пару часов, удобный и интуитивно понятный интерфейс и безопасность данных помогут упростить работу с порталом и ускорить выполнение бизнес-процессов компании.

128000 руб.

19.12.2023 2604 3 0

Amocrm: интеграция с 1С

WEB-интеграция Анализ продаж Системный администратор Программист Пользователь Платформа 1С v8.3 1С:ERP Управление предприятием 2 1С:Управление торговлей 11 1С:Комплексная автоматизация 2.х Управленческий учет Платные (руб)

Модуль "Подсистема интеграции AmoCRM с 1С" позволяет обеспечить единое информационное пространство, в котором пользователи могут эффективно управлять клиентской базой, следить за статусами сделок и поддерживать актуальность данных как в AmoCRM, так и в 1С.

60000 руб.

07.05.2019 34677 68 45

Веб-портал "Онлайн-заказ" для 1С

Оптовая торговля Розничная торговля WEB-интеграция 1С:Управление торговлей 10 1С:Управление производственным предприятием 1С:Управление нашей фирмой 1.6 1С:Управление торговлей 11 1С:Комплексная автоматизация 2.х 1С:Управление нашей фирмой 3.0 Платные (руб)

Онлайн-заказ - это решение для автоматизации процесса оформления заказов на сайте в торговых организациях. Продукт обеспечивает легкое взаимодействие между компанией и клиентами через веб-интерфейс, интегрированный с 1С:Предприятие. Система позволяет снизить операционные расходы, повысить лояльность клиентов и оптимизировать работу отдела продаж.

57600 руб.

26.11.2024 2375 2 2

Интеграция Альфа Авто 5 / Альфа Авто 6 и AUTOCRM / Инфотек

Сайты и интернет-магазины WEB-интеграция Системный администратор Программист Пользователь Платформа 1С v8.3 1C:Бухгалтерия 1С:Управление торговлей 11 Автомобили, автосервисы Россия Управленческий учет Платные (руб)

Интеграционный модуль обмена между конфигурацией Альфа Авто 5 и Альфа Авто 6 и порталом AUTOCRM. Данный модуль универсален. Позволяет работать с несколькими обменами AUTOCRM разных брендов в одной информационной базе в ручном и автоматическом режиме.

36000 руб.

03.08.2020 19077 22 22

Интеграция с сервисом vetmanager в 1С: Бухгалтерия 3.0

WEB-интеграция Программист Платформа 1С v8.3 Бухгалтерский учет 1С:Бухгалтерия 3.0 Бытовые услуги, сервис Платные (руб)

Внешняя обработка разрабатывалась для загрузки документов из Ветменеджер в 1С: Бухгалтерия 3.0

12000 руб.

02.02.2021 18843 54 50

Экспортер — автоматизация выгрузки данных из 1С в Spot2D

WEB-интеграция Программист Бизнес-аналитик Платформа 1С v8.3 1С:ERP Управление предприятием 2 1С:Бухгалтерия 3.0 1С:Управление торговлей 11 1С:Комплексная автоматизация 2.х 1С:Управление нашей фирмой 3.0 1С:Розница 3.0 Оптовая торговля, дистрибуция, логистика ИТ-компания Платные (руб)

Модуль "Экспортер" — это расширение для 1С, предназначенное для автоматизации процессов выгрузки данных. Оно позволяет эффективно извлекать, преобразовывать и передавать данные из систем 1С в интеграционную платформу Spot2D. Подсистема упрощает настройку, снижает количество ручных операций и обеспечивает удобный контроль данных.

14400 руб.

20.12.2024 845 4 1

Конструктор API для обмена базы 1С 8.3 с другими системами по протоколу http в формате JSON

WEB-интеграция Программист Руководитель проекта Платформа 1С v8.3 1C:Бухгалтерия 1С:Франчайзи, автоматизация бизнеса Платные (руб)

Расширение значительно упрощает написание API на 1С. Веб программисты получают простой и понятный доступ к 1С. Описание API создаётся автоматически и представляется в виде удобном как для человека, так и для программной обработки.

24000 руб.

27.09.2024 4060 3 2

Заполнение контрагента по ИНН или наименованию реквизитов по данным сайта ФНС в 1С: 8.3

Обмен с ГосИС WEB-интеграция Бухгалтер Пользователь Платформа 1С v8.3 Управляемые формы 1С:Комплексная автоматизация 1.х 1С:Бухгалтерия 2.0 1С:Управление торговлей 10 1С:Управление производственным предприятием 1С:Управление нашей фирмой 1.6 1С:Бухгалтерия государственного учреждения 1С:Документооборот 1С:ERP Управление предприятием 2 1С:Бухгалтерия 3.0 1С:Управление торговлей 11 1С:Комплексная автоматизация 2.х Платные (руб)

Обработка является альтернативой механизму, разработанному фирмой 1С и заполняющему реквизиты контрагента по ИНН или наименованию. Не требуется действующей подписки ИТС. Вызывается как внешняя дополнительная обработка, т.е. используется, непосредственно, из карточки контрагента. Заполнение по ИНН или наименованию реквизитов контрагента по данным сайта ФНС (egrul.nalog.ru) для БП 2.0, БП 3.0, БГУ 1.0, БГУ 2.0, УТ 10.3, УТ 11.x, КА 1.1, КА 2.x, УПП 1.x, ERP 2.x, УНФ 1.5, УНФ 1.6, УНФ 3.0, ДО 2.1

2400 руб.

28.04.2016 93034 191 217

343

Комментарии

Подписаться на ответы Инфостарт бот

Свернуть все

1. Bublik2011 9 03.10.22 17:08 Сейчас в теме

Отличная идея в статье! У меня что-то похожее было , из UML генерировался код 1С http запроса с параметрами.

2. malikov_pro 1330 03.10.22 18:19 Сейчас в теме

(1) PR забраковали, не собрался, нужно заново разворачивать окружение и пробовать собирать, при этом основная ветка ушла вперед.

3. untru 14 30.05.23 03:57 Сейчас в теме

(2)есть шанс вопрос добить?)

4. malikov_pro 1330 30.05.23 12:20 Сейчас в теме

(3) Думаю да

Оставьте свое сообщение

E-mail:

Автор:

Александр Маликов (malikov_pro)

Рейтинг: 1330

Для получения уведомлений о новых публикациях автора подключите телеграм бот: Инфостарт бот

Публикация:

№ 1549736

Создание 13.03.22 14:30

Обновление 13.03.22 14:30

Статистика:

Просмотры 2533

Загрузки 0

Рейтинг 11

Комментарии 4

Характеристики:

Код открыт Да

Рубрики WEB-интеграция

Кому Программист

Тип файла Нет файла

Платформа Платформа 1С v8.3

Конфигурация Универсальные

Операционная система Не имеет значения

Страна Не имеет значения

Отрасль Не имеет значения

Налоги Не имеет значения

Вид учета Не имеет значения

Доступ к файлу Бесплатно (free)