การแปลงตัวระบุผู้ป่วยให้เป็นสัญลักษณ์ที่เครื่องอ่านได้เป็นความต้องการประจำวันสำหรับระบบเทคโนโลยีสุขภาพสมัยใหม่ โดยเฉพาะเมื่อทำการติดตามบรรจุภัณฑ์ยา หรือ ตัวอย่างห้องปฏิบัติการ Aspose.HTML Cloud SDK for Node.js ให้ไลบรารีที่แข็งแกร่งซึ่งช่วยให้คุณสร้างบาร์โค้ดคุณภาพสูงโดยตรงจากโค้ดฝั่งเซิร์ฟเวอร์ของคุณ คู่มือนี้จะพาคุณผ่านทุกอย่างที่คุณต้องรู้เพื่อ สร้างบาร์โค้ดสำหรับแอปพลิเคชันด้านสุขภาพใน Node.JS ตั้งแต่การตั้งค่าสภาพแวดล้อมจนถึงการปรับประสิทธิภาพ

ข้อกำหนดเบื้องต้นและการตั้งค่า

ก่อนที่คุณจะเริ่มต้น โปรดตรวจสอบว่าคุณมีสิ่งต่อไปนี้:

  • Node.js 14 หรือใหม่กว่า ติดตั้งบนเครื่องพัฒนาของคุณ
  • บัญชี Aspose Cloud พร้อม client ID และ client secret คุณสามารถสร้างได้ในแดชบอร์ดของ Aspose Cloud
  • การเข้าถึงอินเทอร์เน็ตเพื่อให้ไลบรารีสามารถเชื่อมต่อกับ Aspose.HTML Cloud REST endpoints

ติดตั้ง 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.

ขั้นตอนที่ 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: บันทึกรูปภาพบาร์โค้ดลงดิสก์

เขียน Buffer ที่ส่งคืนไปยังไฟล์.

    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. 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 แบบชำระเงินสำหรับการใช้งานเชิงพาณิชย์ คุณสามารถเริ่มต้นด้วยใบอนุญาตชั่วคราวเพื่อการประเมินและอัปเกรดเมื่อพร้อมที่จะเปิดใช้งานจริง.

อ่านเพิ่มเติม