Создание кодогенератора для 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 –

См. также

Интеграция системы Datamart завода Москвич и Альфа-Авто, редакции 5 и 6

WEB-интеграция Платформа 1С v8.3 Конфигурации 1cv8 Автомобили, автосервисы Россия Управленческий учет Платные (руб)

Обмен данными Datamart завода Москвич и автодилера на Альфа-Авто, ред.5 и 6

240000 руб.

01.08.2023 2557 2 0

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

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

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

36000 руб.

03.08.2020 17783 19 22

Интеграция 1С с OpenCart 2.x, 3x — модуль обмена данными

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

Модуль интеграции 1С с OpenCart 2.x, 3x позволяет обмениваться данными между OpenCart (самая популярная бесплатная cms для интернет-магазинов) и 1С:Предприятие 8.

6800 руб.

17.11.2015 120243 379 139

224

Интеграция 1С и Битрикс 24 — модуль синхронизации для обмена задачами

Сайты и интернет-магазины Интеграция WEB-интеграция Платформа 1С v8.3 Конфигурации 1cv8 Управленческий учет Платные (руб)

Интеграция 1С и Битрикс 24. Разработка имеет двухстороннюю синхронизацию 1С и Bitrix24 задачами. Решение позволяет создавать пользователя в 1С из Битрикс24 и наоборот. Данная разработка технически подходит под все основные конфигурации линейки продуктов 1С:Предприятие 8.3 (платформа начиная с 8.3.23). При приобретении предоставляется 1 месяц бесплатных обновлений разработки. Доступна демо-версия продукта с подключением Вашего Битрикс24

5040 руб.

04.05.2021 19849 13 17

Сервисы 1СПАРК Риски и 1С:Контрагент для «старых» конфигураций

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

Доступ к сервисам 1СПАРК Риски и 1С:Контрагент в «старых», но широко используемых конфигурациях.

6000 руб.

30.01.2019 25021 47 5

SALE! 15%

Все службы доставки в Вашей 1С! Без изменения конфигурации! 1С:УТ, 1С:ERP, 1С:КА, 1С:УНФ

WEB-интеграция Рабочее место Оптовая торговля Розничная торговля Логистика, склад и ТМЦ Программист Пользователь Платформа 1С v8.3 1С:ERP Управление предприятием 2 1С:Управление торговлей 11 Россия Управленческий учет Платные (руб)

40+ служб доставки для 1С в одном модуле! Внешняя обработка, которая НЕ изменяет Вашу конфигурацию! Подписная модель на 1 год.

~~16800~~ 14280 руб.

22.03.2017 38746 18 49

Модуль для обмена "1С:Предприятие 8. УАТ. ПРОФ" с FortMonitor

WEB-интеграция 8.3.8 Конфигурации 1cv8 Автомобили, автосервисы Беларусь Украина Россия Казахстан Управленческий учет Платные (руб)

Расширение предназначено для конфигурации "1С:Предприятие 8. Управление Автотранспортом. ПРОФ". Функционал модуля: 1. Заполнение регистров сведений по подсистеме "Мониторинг", а именно: события по мониторингу, координаты по мониторингу, пробег и расход по мониторингу, текущее местоположение ТС по мониторингу 2. Заполнение путевого листа: пробег по мониторингу, время выезда/заезда, табличная часть ГСМ, места стоянок по геозонам. 3. Отчеты по данным загруженным в регистры сведений. 4. Предусмотрена автоматическая загрузка данных в фоновом режиме (условия работы данной загрузке читайте в описании товара) Модуль работает без включенной константы по настройкам мониторинга. Модуль формы предоставляется с открытым кодом, общий модуль защищен. Любой заинтересованный пользователь, имеет возможность скачать демо-версию расширения.

22656 руб.

25.05.2021 14424 42 8

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

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

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

24000 руб.

27.09.2024 1172 1 0

Комментарии

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

Свернуть все

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

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

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

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

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

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

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

(3) Думаю да

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

E-mail:

Автор:

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

Рейтинг: 1324

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

Публикация:

№ 1549736

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

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

Статистика:

Просмотры 2354

Загрузки 0

Рейтинг 11

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

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

Код открыт Да

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

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

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

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

Конфигурация Не имеет значения

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

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

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

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

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

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