Перетворення ідентифікаторів пацієнтів у машиночитані символи є щоденною вимогою сучасних систем health‑tech, особливо при відстежуванні упаковок медикаментів або лабораторних зразків. Aspose.HTML Cloud SDK for Node.js надає потужну бібліотеку, яка дозволяє генерувати високоякісні штрихкоди безпосередньо з вашого серверного коду. У цьому посібнику розглядаються всі необхідні кроки для генерації штрихкоду для медичних застосувань у Node.JS, від налаштування середовища до оптимізації продуктивності.

Вимоги та налаштування

Перш ніж розпочати, переконайтеся, що у вас є наступне:

  • Node.js 14 або новішу версію, встановлену на вашій машині розробки.
  • Обліковий запис Aspose Cloud з client ID та client secret. Ви можете створити їх у панелі управління Aspose Cloud.
  • Доступ до інтернету, щоб бібліотека могла підключатися до REST‑кінцевих точок Aspose.HTML Cloud.

Встановіть SDK за допомогою npm:

npm install @asposecloud/aspose-html-cloud --save

Завантажте останній пакет з офіційної сторінки випуску: Aspose.HTML Cloud SDK for Node.js Download. Після встановлення ви готові писати код, який викликає API генерації штрих‑кодів.

Покроковий посібник зі створення штрих‑коду для медичних застосувань у Node.JS

Нижче наведено докладний покроковий огляд. Кожен крок витягує невеликий фрагмент з повної програми, щоб ви могли точно бачити, що відбувається на кожному етапі.

Крок 1: Завантажте необхідні модулі та ініціалізуйте конфігурацію

SDK потребує ваших облікових даних, щоб отримати токен доступу.

const fs = require('fs');
const path = require('path');
const { Configuration, BarcodeApi, ApiException } = require('@asposecloud/aspose-html-cloud');

const config = new Configuration({
    clientId: 'YOUR_CLIENT_ID',
    clientSecret: 'YOUR_CLIENT_SECRET'
});

Для отримання докладнішої інформації про клас Configuration, перегляньте довідку API.

Крок 2: Створіть екземпляр BarcodeApi

Об’єкт BarcodeApi надає метод generateBarcode.

const barcodeApi = new BarcodeApi(config);

Крок 3: Визначте специфічне для охорони здоров’я навантаження GS1‑128

GS1‑128 широко використовується в медичній упаковці. Дані включають GTIN, серійний номер та чисту вагу.

const barcodeRequest = {
    text: '(01)01234567890128(21)SN123456(3103)00123',
    symbology: 'gs1-128',
    format: 'png',
    resolution: 300,
    showText: true,
    width: 500,
    height: 200,
    margin: 10,
    backgroundColor: '#FFFFFF',
    foregroundColor: '#000000'
};

Крок 4: Виклик методу generateBarcode

Метод повертає Buffer, що містить зображення PNG.

try {
    const barcodeImage = await barcodeApi.generateBarcode(barcodeRequest);

Крок 5: Зберегти зображення штрих‑коду на диск

Запишіть повернутий буфер у файл.

    const outputPath = path.resolve(__dirname, 'healthcare_barcode.png');
    fs.writeFileSync(outputPath, barcodeImage);
    console.log(`Healthcare barcode saved to ${outputPath}`);
} catch (error) {
    if (error instanceof ApiException) {
        console.error('Aspose.HTML Cloud API error:', error.response.body);
    } else {
        console.error('Unexpected error:', error);
    }
}

За допомогою цих п’яти кроків ви успішно згенерували штрих-код для медичних застосунків у Node.JS.

Повний робочий приклад генерації штрих‑коду охорони здоров’я в Node.JS

Наступний код об’єднує всі фрагменти в одну, готову до виконання програму.

const fs = require('fs');
const path = require('path');
const { Configuration, BarcodeApi, ApiException } = require('@asposecloud/aspose-html-cloud');

(async () => {
    // Initialize Aspose.HTML Cloud configuration
    const config = new Configuration({
        clientId: 'YOUR_CLIENT_ID',
        clientSecret: 'YOUR_CLIENT_SECRET'
    });

const barcodeApi = new BarcodeApi(config);

// Healthcare‑specific barcode (GS1‑128) payload
    const barcodeRequest = {
        // Example GS1‑128 data: (01)GTIN (21)Serial (3103)Net weight
        text: '(01)01234567890128(21)SN123456(3103)00123',
        symbology: 'gs1-128',          // GS1‑128 is widely used in medical packaging
        format: 'png',                 // Output image format
        resolution: 300,               // DPI for high‑quality printing
        showText: true,                // Human‑readable text below the barcode
        width: 500,                    // Desired image width in pixels
        height: 200,                   // Desired image height in pixels
        margin: 10,                    // Quiet zone around the barcode
        backgroundColor: '#FFFFFF',    // White background
        foregroundColor: '#000000'     // Black bars
    };

try {
        // Generate the barcode; response is a Buffer containing PNG data
        const barcodeImage = await barcodeApi.generateBarcode(barcodeRequest);

// Save the generated barcode to disk
        const outputPath = path.resolve(__dirname, 'healthcare_barcode.png');
        fs.writeFileSync(outputPath, barcodeImage);
        console.log(`Healthcare barcode saved to ${outputPath}`);
    } catch (error) {
        if (error instanceof ApiException) {
            console.error('Aspose.HTML Cloud API error:', error.response.body);
        } else {
            console.error('Unexpected error:', error);
        }
    }
})();

Примітка: Цей приклад коду демонструє основну функціональність. Перш ніж використовувати його у вашому проєкті, переконайтеся, що оновили шляхи до файлів (input.pdf, output.png тощо), щоб вони відповідали фактичним розташуванням ваших файлів, перевірте, що всі необхідні залежності встановлені правильно, і ретельно протестуйте у вашому середовищі розробки. Якщо ви зіткнетеся з будь-якими проблемами, будь ласка, зверніться до офіційної документації або зв’яжіться з командою підтримки для отримання допомоги.

Створення штрих‑кодів за допомогою cURL та REST API

Якщо ви віддаєте перевагу підходу, незалежному від мови, ви можете викликати той самий сервіс за допомогою простих HTTP‑запитів.

Спочатку отримайте токен доступу:

curl -X POST "https://api.aspose.cloud/connect/token" \
     -H "Content-Type: application/x-www-form-urlencoded" \
     -d "grant_type=client_credentials&client_id=YOUR_CLIENT_ID&client_secret=YOUR_CLIENT_SECRET"

Припускаючи, що відповідь містить access_token, використайте його для генерації штрихкоду:

curl -X POST "https://api.aspose.cloud/v4.0/html/barcode/generate" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
           "text": "(01)01234567890128(21)SN123456(3103)00123",
           "symbology": "gs1-128",
           "format": "png",
           "resolution": 300,
           "showText": true,
           "width": 500,
           "height": 200,
           "margin": 10,
           "backgroundColor": "#FFFFFF",
           "foregroundColor": "#000000"
         }' --output healthcare_barcode.png

Команда зберігає PNG‑зображення безпосередньо у файл healthcare_barcode.png. Для отримання докладнішої інформації про параметри запиту дивіться довідку API.

Налаштування параметрів генерації штрих‑кодів

SDK надає кілька властивостей, які дозволяють налаштувати вихідні дані відповідно до стандартів охорони здоров’я.

  • symbology - Виберіть gs1-128 для упаковки, сумісної з HL7.
  • resolution - Встановіть 300 DPI для етикеток, готових до друку.
  • showText - Увімкніть, щоб відображати людсько‑читабельний рядок під смугами.
  • margin - Налаштуйте тиху зону, щоб відповідати вимогам щодо відстані.

Приклад зміни роздільної здатності та кольорів:

barcodeRequest.resolution = 600;          // Higher DPI for detailed prints
barcodeRequest.backgroundColor = '#F0F0F0'; // Light gray background for contrast
barcodeRequest.foregroundColor = '#003366'; // Dark blue bars for branding

Усі властивості задокументовані у документації BarcodeApi.

Оптимізація продуктивності генерації штрих-кодів

При генерації великих партій штрих‑кодів, враховуйте наступні поради:

  1. Повторно використовуйте екземпляр BarcodeApi - Створення нового екземпляра для кожного виклику додає накладних витрат.
  2. Потокове передавання відповіді - Якщо потрібно обробляти багато зображень, записуйте Buffer безпосередньо у потік замість завантаження всього файлу в пам’ять.
  3. Розумно налаштовуйте роздільну здатність - Вищий DPI збільшує розмір файлу та час обробки; використовуйте мінімальний DPI, який задовольняє вимоги вашого принтера.
  4. Безпечно паралелізуйте - Node.js може обробляти одночасні виклики API, але дотримуйтесь обмежень швидкості сервісу, щоб уникнути обмеження.

Застосування цих практик зберігає реактивність вашого застосунку, одночасно відповідаючи вимогам медичної відповідності.

Висновок

У цьому підручнику ми продемонстрували, як генерувати штрих‑код для медичних застосувань у Node.JS за допомогою потужного Aspose.HTML Cloud SDK for Node.js. Ви побачили повний код, альтернативу cURL, параметри конфігурації та прийоми підвищення продуктивності, які допомагають відповідати стандартам HL7 і GS1‑128. Пам’ятайте про захист ваших клієнтських облікових даних, отримання належної комерційної ліцензії для продакшн‑середовища, а також ви можете спробувати тимчасову ліцензію на сторінці тимчасової ліцензії. За допомогою цих інструментів ви з упевненістю можете вбудовувати відповідні штрих‑коди у будь‑яке рішення у сфері health‑tech.

Часті питання

  • Як згенерувати штрих‑код для медичних застосувань у Node.JS за допомогою Aspose.HTML Cloud SDK?
    Дотримуйтесь покрокового посібника вище: встановіть SDK, налаштуйте свої облікові дані, створіть barcodeRequest з даними GS1‑128, викличте generateBarcode і збережіть отримане зображення.

  • Чи можу я змінити формат штрихкоду на QR або DataMatrix для інших сценаріїв охорони здоров’я?
    Так. Встановіть властивість symbology у qr або datamatrix. Той самий виклик API працює, і ви можете налаштувати розмір та рівень корекції помилок за потреби.

  • Чи є спосіб генерувати штрих‑коди без написання коду?
    Розділ Створення штрих‑кодів за допомогою cURL та REST API показує, як виконати ту ж операцію з командного рядка або будь‑якого HTTP‑клієнта.

  • Яке ліцензування потрібне для виробничих розгортань?
    Для комерційного використання потрібна платна ліцензія Aspose.HTML Cloud. Ви можете розпочати з тимчасової ліцензії для оцінки та оновити її, коли будете готові перейти в режим живого використання.

Читати далі