تبدیل شناسه‌های بیماران به نمادهای قابل خواندن توسط ماشین یک نیاز روزانه برای سیستم‌های مدرن فناوری سلامت است، به‌ویژه هنگام ردیابی بسته‌های دارویی یا نمونه‌های آزمایشگاهی. Aspose.HTML Cloud SDK for Node.js کتابخانه‌ای قدرتمند فراهم می‌کند که به شما امکان می‌دهد بارکدهای با کیفیت بالا را مستقیماً از کد سمت سرور خود تولید کنید. این راهنما شما را از تنظیم محیط تا بهینه‌سازی عملکرد، در تولید بارکد برای برنامه‌های بهداشتی در Node.JS همراهی می‌کند.

پیش‌نیازها و راه‌اندازی

قبل از شروع، مطمئن شوید که موارد زیر را دارید:

  • Node.js 14 یا بالاتر که بر روی ماشین توسعه شما نصب شده باشد.
  • یک حساب Aspose Cloud با شناسه مشتری (client ID) و رمز مشتری (client secret). می‌توانید این‌ها را در داشبورد Aspose Cloud ایجاد کنید.
  • دسترسی به اینترنت تا کتابخانه بتواند به نقاط انتهایی Aspose.HTML Cloud REST دسترسی پیدا کند.

SDK را از طریق npm نصب کنید:

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

آخرین بسته را از صفحه رسمی انتشار دانلود کنید: Aspose.HTML Cloud SDK for Node.js دانلود. پس از نصب، آماده‌اید تا کدی بنویسید که 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 مراجعه کنید.

مرحله ۲: ایجاد نمونه 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 - برای بسته‌بندی سازگار با HL7، gs1-128 را انتخاب کنید.
  • resolution - برای برچسب‌های آماده چاپ، به 300 DPI تنظیم کنید.
  • showText - برای نمایش رشته قابل خواندن توسط انسان زیر نوارها، فعال کنید.
  • margin - منطقه آرام (quiet zone) را تنظیم کنید تا الزامات فاصله‌گذاری قانونی را برآورده سازید.

مثال برای تغییر وضوح و رنگ‌ها:

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 reference مستند شده‌اند.

بهینه‌سازی عملکرد تولید بارکد

هنگام تولید دسته‌های بزرگ بارکد، این نکات را در نظر بگیرید:

  1. Reuse the BarcodeApi instance - ایجاد یک نمونه جدید برای هر فراخوانی باعث اضافه بار می‌شود.
  2. Stream the response - اگر نیاز به پردازش تعداد زیادی تصویر دارید، Buffer را مستقیماً به یک جریان بنویسید به جای بارگذاری کل فایل در حافظه.
  3. Adjust resolution wisely - DPI بالاتر اندازه فایل و زمان پردازش را افزایش می‌دهد؛ از حداقل DPI که نیازهای چاپگر شما را برآورده می‌کند استفاده کنید.
  4. Parallelise safely - Node.js می‌تواند تماس‌های API همزمان را مدیریت کند، اما برای جلوگیری از محدودیت سرعت، محدودیت‌های نرخ سرویس را رعایت کنید.

به‌کارگیری این شیوه‌ها، برنامه شما را پاسخگو نگه می‌دارد و در عین حال با الزامات مراقبت‌های بهداشتی مطابقت می‌کند.

نتیجه‌گیری

در این آموزش نحوه ایجاد بارکد برای برنامه‌های بهداشتی در Node.JS را با استفاده از قدرتمند Aspose.HTML Cloud SDK for Node.js نشان دادیم. شما کد کامل، یک جایگزین cURL، گزینه‌های پیکربندی و ترفندهای عملکردی که به شما کمک می‌کند استانداردهای HL7 و GS1‑128 را برآورده کنید، مشاهده کردید. به یاد داشته باشید که اعتبارهای مشتری خود را ایمن کنید، یک مجوز تجاری مناسب برای تولید دریافت کنید، و حتی می‌توانید یک مجوز موقت را از صفحه مجوز موقت امتحان کنید. با این ابزارها می‌توانید با اطمینان بارکدهای سازگار را در هر راه‌حل فناوری‑بهداشتی جاسازی کنید.

سوالات متداول

  • چگونه می‌توانم بارکد برای برنامه‌های بهداشتی در Node.JS با استفاده از Aspose.HTML Cloud SDK تولید کنم؟
    راهنمای گام‌به‌گام بالا را دنبال کنید: SDK را نصب کنید، اعتبارنامه‌های خود را پیکربندی کنید، یک barcodeRequest با داده‌های GS1‑128 بسازید، generateBarcode را فراخوانی کنید و تصویر بازگشتی را ذخیره کنید.

  • آیا می‌توانم فرمت بارکد را به QR یا DataMatrix برای سایر سناریوهای مراقبت‌های بهداشتی تغییر دهم؟
    بله. ویژگی symbology را به qr یا datamatrix تنظیم کنید. همان فراخوانی API کار می‌کند و می‌توانید اندازه و سطح تصحیح خطا را در صورت نیاز تنظیم کنید.

  • آیا راهی برای تولید بارکدها بدون نوشتن کد وجود دارد؟
    بخش Barcode Creation with cURL and the REST API نشان می‌دهد که چگونه می‌توان همان عملیات را از خط فرمان یا هر کلاینت HTTP انجام داد.

  • برای استقرارهای تولیدی چه مجوزی نیاز دارم؟
    برای استفاده تجاری، یک مجوز پرداختی Aspose.HTML Cloud لازم است. می‌توانید با یک مجوز موقت برای ارزیابی شروع کنید و زمانی که آماده راه‌اندازی هستید، ارتقا دهید.

بیشتر بخوانید