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

См. также

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

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

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

36000 руб.

03.08.2020 22203 32 24

SALE! 15%

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

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

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

~~17280~~ 14688 руб.

20.12.2024 4384 22 4

REST API для интеграции 1С:Бухгалтерия предприятие 3.0 (3.0.177.30) с внешними системами через HTTP-запросы. Создание контрагента, счёта и реализации (услуг). Получение этих сущностей в виде JSON, и печатных форма счета и акта

WEB-интеграция 1С:Предприятие 8 1С:Бухгалтерия 3.0 Платные (руб)

Мощная интеграция ваших систем с 1С:Бухгалтерия предприятия 3.0 через современный HTTP-интерфейс

90000 руб.

31.07.2025 1654 1 2

Интеграция 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 129005 444 143

246

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

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

Расширение значительно упрощает написание API на 1С. Веб программисты получают простой и понятный доступ к 1С. Описание API создаётся автоматически и представляется в виде удобном как для человека, так и для программной обработки. Основные преимущества: 1. Документация API создаётся автоматически. Удобна для программной обработки. 2. Изменить API столь же просто как настроить отчёт. Можно опубликовать существующий вариант отчёта. 3. Отчёты в API поддерживают параметры (Период, ДатаНачала и др.) 4. При создании простых методов не требуется изменять конфигурацию. 5. Поддерживается работа с планами обмена.<br/> 6. Возможно настроить отправку из 1С данных корреспондирующей системе, для случаев когда 1С сама "знает" какие данные нужно отправить. 7. После записи в 1С Ле Мурр может возвращать соответствие полученных идентификаторов созданным в 1С объектам данных.

36000 руб.

27.09.2024 10152 7 5

Обмен данными с Порталом поставщиков Москвы и МО через 1С

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

Обмен данными с "Порталом поставщиков" zakupki.mos.ru Москвы и Московской области с целью создания оферт для закупок государственными учреждениями. Модуль устраняет рутину, минимизирует ошибки и помогает выигрывать больше закупок. Работает строго по требованиям 44-ФЗ.

14400 руб.

13.12.2016 41740 54 39

Интеграция Vetmanager с 1С: автоматизация учета для ветеринарных клиник. Синхронизация документов, справочников и оплат через API

WEB-интеграция Программист 1С:Предприятие 8 1С:Бухгалтерия 3.0 Бытовые услуги, сервис Платные (руб)

Внешняя обработка разработана для автоматизации передачи данных между сервисом Vetmanager с 1С: Бухгалтерия 3.0. Решение позволяет загружать документы и справочники из Ветменеджер в 1С:Бухгалтерию, сокращая время на ручной ввод данных и минимизируя ошибки.

12000 руб.

02.02.2021 20959 60 52

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

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

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

6000 руб.

30.01.2019 26784 99 5

Комментарии

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

Свернуть все

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

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

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

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

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

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

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

(3) Думаю да

Для отправки сообщения требуется регистрация/авторизация

Автор:

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

Рейтинг: 1352

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

Публикация:

№ 1549736

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

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

Статистика:

Просмотры 3114

Загрузки 0

Рейтинг 11

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

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

Код открыт Да

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

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

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

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

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

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

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

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

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

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

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