Подготовить QR-код PNG из переданного текста

Робот «Подготовить QR-код PNG из переданного текста» кодирует указанную строку в изображение QR для последующего сохранения или вложения.

Видимая часть формы настройки в Битрикс24. Скриншот показывает поля действия; он не подтверждает выполнение учебного примера.

Для кого и какую задачу решает

Администратору автоматизации и сотруднику, который готовит QR с точным текстом, номером документа или заранее проверенной ссылкой.

Когда QR нужно включить в следующий документ, ручная генерация и прикрепление мешают автоматизации. Робот создаёт PNG и возвращает его в Base64 вместе с размером и контрольной суммой. Отправка изображения или загрузка в хранилище выполняется отдельным действием.

Параметры и подготовка

Поле	Как заполнить
Точный текст для кодирования (QR_CONTENT)	Обязательное поле
Пикселей на модуль, от 1 до 16 (SCALE)	Обязательное поле. по умолчанию 4

Перед настройкой выберите, откуда процесс получит каждое значение: постоянная настройка, поле карточки или результат предыдущего шага. Подписи в таблице соответствуют полям робота. Коды в скобках помогают различать похожие параметры при передаче данных между шагами.

Как использовать

1. В QR_CONTENT передайте точный непустой текст. Если кодируется ссылка, заранее проверьте её адрес и право получателя на доступ.
2. Выберите SCALE от 1 до 16 пикселей на модуль; по умолчанию 4. Чем больше масштаб, тем крупнее PNG, но он не увеличивает вместимость текста.
3. Сохраните пробелы и переносы только если они должны попасть в QR: текст кодируется без автоматической очистки.
4. После успешного статуса используйте PNG_BASE64 в действии, принимающем изображение Base64. MIME должен передаваться как image/png; параметры ширины и высоты помогут разместить картинку.

Учебный пример и ожидаемый результат

Передайте QR_CONTENT=ORDER-DEMO-001, SCALE=4. Ожидается непустой результат PNG_BASE64, MIME image/png, положительные ширина, высота и размер. После декодирования учебного QR должен получиться ровно текст ORDER-DEMO-001. Размер в пикселях зависит от вместимости кода, поэтому фиксированное число заранее не обещается.

Пример показывает подготовленные учебные данные. Фактический результат зависит от переданных значений и доступных данных вашего процесса.

Что возвращает и как продолжить процесс

• «Изображение PNG Base64» (PNG_BASE64).
• «Тип файла» (mime).
• «Ширина в пикселях» (width).
• «Высота в пикселях» (height).
• «Размер PNG в байтах» (size).
• «SHA-256 изображения» (sha256).

SHA-256 относится к байтам созданного PNG и помогает сверять изображение при передаче. Base64 представляет содержимое файла, а не ссылку для просмотра. Для вставки в систему, которая ждёт URL или ID файла, потребуется отдельный шаг загрузки.

Выход «Статус выполнения» проверяйте перед передачей результата дальше. При отрицательном статусе прочитайте «Пояснение ошибки» и направьте процесс на исправление исходных данных. Успешный статус подтверждает выполнение действия; содержательные признаки результата проверяйте отдельно.

Ограничения и разбор ошибок

Принимает непустой QR_CONTENT до 2048 байт UTF-8 и SCALE: целое число пикселей на модуль от 1 до 16, по умолчанию 4. Текст сохраняется точно, включая пробелы; служебные символы кроме переноса строки и табуляции не допускаются. Использует обычный QR, коррекцию M, черно-белое PNG, белую рамку четыре модуля и UTF-8 с обозначением кодировки. Размер не более 2048 пикселей по стороне и 1 МБ PNG; слишком большой результат отклоняется. Возвращает PNG_BASE64, размер, MIME image/png и SHA-256 изображения. Не открывает ссылки, не отправляет файл и не проверяет банковские или платежные форматы. QR содержит переданный текст: храните и передавайте изображение с теми же ограничениями доступа.

QR не открывает и не проверяет закодированную ссылку. Он также не подтверждает корректность банковских и платёжных форматов. Человек, получивший изображение, сможет прочитать содержащийся в нём текст; соблюдайте ограничения доступа к самим данным.