การค้นหาการศึกษาอิมเมจของผู้ป่วยมักเป็นขั้นตอนแรกในกระบวนการทำงานของ DICOM. ด้วยการสืบค้น DICOMweb QIDO‑RS, แอปพลิเคชันของคุณสามารถค้นหาเมตาดาต้าการศึกษาและระบุการศึกษาที่เกี่ยวข้องก่อนที่จะดาวน์โหลด image instances.
ในบทแนะนำนี้ คุณจะใช้ Aspose.Medical for .NET เพื่อค้นหาการศึกษา DICOM ตามชื่อผู้ป่วยใน C# คุณจะตั้งค่า SDK, สร้างไคลเอนต์ DICOMweb, กำหนดรูปแบบการค้นหาและขีดจำกัดผลลัพธ์, และอ่านการศึกษาที่ตรงกัน ตัวอย่างคอนโซลเต็มจะแสดง Patient Name และ Study Instance UID ของแต่ละการศึกษา.
เพื่อทำตามขั้นตอน คุณจะต้องมี endpoint QIDO‑RS ที่เข้าถึงได้ซึ่งมีการศึกษาให้ค้นหา.
ติดตั้ง Aspose.Medical for .NET
ตัวอย่างนี้มุ่งเป้าไปที่ .NET 10 และใช้ Aspose.Medical 26.10.0. ติดตั้ง .NET 10 SDK, จากนั้นสร้างโครงการคอนโซลและเพิ่มแพ็กเกจที่ระบุไว้:
dotnet new console -n DicomStudySearch -f net10.0
cd DicomStudySearch
dotnet add package Aspose.Medical --version 26.10.0
ไฟล์โครงการของคุณควรมีการตั้งค่าต่อไปนี้ Implicit usings ให้เนมสเปซมาตรฐานที่ใช้ในตัวอย่าง ในขณะที่ nullable reference types รองรับค่าตัวแปรสภาพแวดล้อมที่เป็นตัวเลือก.
<Project Sdk="Microsoft.NET.Sdk">
<PropertyGroup>
<OutputType>Exe</OutputType>
<TargetFramework>net10.0</TargetFramework>
<ImplicitUsings>enable</ImplicitUsings>
<Nullable>enable</Nullable>
</PropertyGroup>
<ItemGroup>
<PackageReference Include="Aspose.Medical" Version="26.10.0" />
</ItemGroup>
</Project>
หากคุณใช้ Package Manager Console ของ Visual Studio ให้ติดตั้งเวอร์ชันเดียวกันด้วยคำสั่ง:
Install-Package Aspose.Medical -Version 26.10.0
ตัวอย่างนี้ใช้เนมสเปซ Aspose.Medical.Dicom, Aspose.Medical.Dicom.Tags และ Aspose.Medical.Dicom.Web คำสั่ง using ของพวกมันถูกรวมไว้ในโปรแกรมเต็มด้านล่าง.
กำหนดค่าใบอนุญาตและการเข้าถึง endpoint
โปรแกรมตรวจสอบ ASPOSE_MEDICAL_LICENSE สำหรับเส้นทางไฟล์ใบอนุญาตและโหลดไฟล์นั้นเมื่อค่าตัวแปรถูกตั้งค่า หากคุณต้องการใบอนุญาตสำหรับการประเมินผล คุณสามารถ ขอใบอนุญาตชั่วคราว ได้.
สำหรับบริการที่รับการรับรองแบบ bearer ให้ตั้งค่า DICOMWEB_TOKEN เป็นโทเค็นการเข้าถึงของคุณ หากจุดสิ้นสุดของคุณไม่ต้องการโทเค็นแบบ bearer ให้ปล่อยค่าไว้ไม่ได้ตั้งค่า บริการที่ใช้วิธีการรับรองอื่นต้องทำการเปลี่ยนแปลงที่สอดคล้องในการกำหนดค่าของ HTTP client configuration.
ตัวอย่างเช่นใน PowerShell:
$env:ASPOSE_MEDICAL_LICENSE = "C:\Licenses\Aspose.Medical.lic"
$env:DICOMWEB_TOKEN = "your-access-token"
แทนที่ตัวแสดงตำแหน่งเหล่านี้ด้วยค่าของคุณเองและตั้งค่าเฉพาะตัวแปรที่คุณต้องการเท่านั้น.
ค้นหาการศึกษา DICOM ตามชื่อผู้ป่วยใน C#
แทนที่ Program.cs ด้วยโค้ดต่อไปนี้ โปรแกรมรับ DICOMweb base URI เป็นอาร์กิวเมนต์แรกและรูปแบบ patient-name แบบเลือกเป็นอาร์กิวเมนต์ที่สอง หากคุณละเว้นรูปแบบ จะใช้ Doe*
using System.Net.Http.Headers;
using Aspose.Medical.Dicom;
using Aspose.Medical.Dicom.Tags;
using Aspose.Medical.Dicom.Web;
if (args.Length < 1)
{
Console.Error.WriteLine("Usage: dotnet run -- <dicomweb-base-uri> [patient-name-pattern]");
Environment.ExitCode = 1;
return;
}
try
{
string? licensePath = Environment.GetEnvironmentVariable("ASPOSE_MEDICAL_LICENSE");
if (!string.IsNullOrWhiteSpace(licensePath))
new Aspose.Medical.License().SetLicense(licensePath);
using var httpClient = new HttpClient();
string? token = Environment.GetEnvironmentVariable("DICOMWEB_TOKEN");
if (!string.IsNullOrWhiteSpace(token))
httpClient.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", token);
var client = new DicomWebClient(httpClient, new DicomWebClientOptions
{
BaseUri = new Uri(args[0], UriKind.Absolute)
});
string pattern = args.Length > 1 ? args[1] : "Doe*";
var searchOptions = new DicomWebSearchOptions
{
MatchingParameters = [new DicomWebQueryParameter("PatientName", pattern)],
FuzzyMatching = false,
Limit = 10,
Offset = 0
};
using var timeout = new CancellationTokenSource(TimeSpan.FromSeconds(30));
await using DicomWebClientStream<Dataset> results =
await client.Studies.SearchAsync(searchOptions, timeout.Token);
int count = 0;
await foreach (Dataset study in results.WithCancellation(timeout.Token))
{
string name = study.GetValueOrDefault<string>(Tag.PatientName, 0, "(not returned)");
string uid = study.GetValueOrDefault<string>(Tag.StudyInstanceUID, 0, "(not returned)");
Console.WriteLine($"Patient: {name}, Study UID: {uid}");
count++;
}
Console.WriteLine($"Studies returned: {count}");
}
catch (Exception ex)
{
Console.Error.WriteLine($"{ex.GetType().Name}: {ex.Message}");
Environment.ExitCode = 1;
}
ส่วนต่อไปนี้อธิบายว่าการกำหนดค่าไคลเอนท์, ตัวเลือกการค้นหา, และการประมวลผลผลลัพธ์ทำงานร่วมกันอย่างไร
สร้างไคลเอนต์ DICOMweb
โปรแกรมสร้าง HttpClient และเมื่อมีการให้ token จะเพิ่มหัวข้อการอนุญาตแบบ bearer จากนั้นโปรแกรมจะส่ง HTTP client นั้นไปยัง DicomWebClient พร้อมกับ DicomWebClientOptions
ตั้งค่า BaseUri ให้เป็น URL พื้นฐานของ DICOMweb ของบริการของคุณ โค้ดจะอ่านค่าจาก args[0] และต้องการ URI แบบเต็ม ใช้ URL พื้นฐานที่ผู้ดูแลเซิร์ฟเวอร์ของคุณจัดหาให้ แทนที่จะสมมติว่าบริการทุกตัวใช้เส้นทางเดียวกัน
กำหนดค่าการค้นหาชื่อผู้ป่วย
DicomWebSearchOptions มีเกณฑ์การค้นหาการศึกษา ในตัวอย่างนี้ MatchingParameters จับคู่ PatientName กับรูปแบบที่ระบุในบรรทัดคำสั่ง.
การตั้งค่าอื่น ๆ ควบคุมการจับคู่และหน้าผลลัพธ์ที่ร้องขอ:
| การตั้งค่า | ค่าตัวอย่าง | วัตถุประสงค์ |
|---|---|---|
FuzzyMatching | false | ไม่ได้ขอการจับคู่แบบฟัซซี |
Limit | 10 | ขอไม่เกินสิบการศึกษา |
Offset | 0 | ขอผลลัพธ์โดยเริ่มจากออฟเซ็ตเริ่มต้น |
รูปแบบไวลด์การ์ด Doe* แยกจากตัวเลือกการจับคู่แบบ fuzzy. ตรวจสอบพฤติกรรมการจับคู่ชื่อผู้ป่วยที่ endpoint ของคุณรองรับก่อนพึ่งพาผลลัพธ์เฉพาะ. การเปิดใช้งานการจับคู่แบบ fuzzy ไม่ได้รับประกันว่าจะเป็นการไม่สนใจตัวพิมพ์ใหญ่/เล็กหรือการทำงานของไวลด์การ์ด.
โปรแกรมอ่านหน้าผลลัพธ์หนึ่งหน้าเท่านั้น มันไม่ทำการร้องขอหน้าถัดไปโดยอัตโนมัติ
ดำเนินการค้นหาและอ่านข้อมูลเมตาของการศึกษา
client.Studies.SearchAsync ทำการดำเนินการค้นหาและส่งคืน DicomWebClientStream<Dataset> โปรแกรมใช้ await foreach เพื่ออ่านชุดข้อมูลที่ส่งคืนและใช้ await using เพื่อทำลายสตรีมเมื่อการประมวลผลเสร็จสิ้น.
สำหรับการศึกษาแต่ละรายการ, GetValueOrDefault<string> จะอ่านค่าตัวแรกของ Tag.PatientName และ Tag.StudyInstanceUID. หากค่าหายไป, โปรแกรมจะแสดง (not returned) แทน.
โทเค็นการยกเลิก 30 วินาทีจะถูกส่งไปยังการเรียกค้นและการวนซ้ำผลลัพธ์ทั้งสอง โปรแกรมจะนับจำนวนชุดข้อมูลที่อ่านและพิมพ์จำนวนหลังจากลูป หากเกิดข้อยกเว้น จะเขียนประเภทของข้อยกเว้นและข้อความไปยัง standard error และตั้งค่าโค้ดการออกของกระบวนการเป็น 1.
เรียกใช้ตัวอย่างและตรวจสอบผลลัพธ์
จากไดเรกทอรีของโครงการ ให้เรียกใช้:
dotnet run -- "https://dicom.example.com/dicomweb" "Doe*"
แทนที่ URL ตัวอย่างด้วย URL ของบริการ DICOMweb ที่คุณสามารถเข้าถึงได้ ใช้รูปแบบ patient-name ที่ตรงกับการศึกษา (studies) ที่จัดเก็บไว้ในบริการนั้น
ผลลัพธ์ต่อไปนี้เป็นเพียงตัวอย่าง; ชื่อ, UID, และจำนวนขึ้นอยู่กับข้อมูลและกฎการจับคู่ของ endpoint ของคุณ:
Patient: Doe^Jane, Study UID: 1.2.826.0.1.3680043.10.543.1001
Patient: Doe^John, Study UID: 1.2.826.0.1.3680043.10.543.1002
Studies returned: 2
หากการค้นหาเสร็จสิ้นโดยไม่มีผลลัพธ์ โปรแกรมจะพิมพ์:
Studies returned: 0
จำนวนศูนย์หมายถึงไม่มีชุดข้อมูลที่ส่งกลับสำหรับคิวรีนั้น ข้อความข้อยกเว้นและรหัสออก 1 บ่งบอกว่าการดำเนินการไม่สำเร็จอย่างสมบูรณ์ ตัวอย่างนี้ดึงข้อมูลเมตาดาต้าของการศึกษา; ไม่ได้ดาวน์โหลดอินสแตนซ์ภาพ DICOM.
สรุป
เรียกใช้ตัวอย่างกับ QIDO‑RS endpoint ของคุณโดยใช้ชื่อผู้ป่วยที่ทราบแล้ว จากนั้นปรับรูปแบบการค้นหาและขีดจำกัดผลลัพธ์สำหรับแอปพลิเคชันของคุณ หากคุณต้องการมากกว่าหนึ่งหน้าของการศึกษา ให้ขยายตัวอย่างเพื่อขอหน้าถัดไปโดยใช้พฤติกรรมการแบ่งหน้า (pagination) ที่เซิร์ฟเวอร์ของคุณรองรับ
สำหรับ API ที่เกี่ยวข้องและคำแนะนำการกำหนดค่า ดูที่เอกสาร Aspose.Medical for .NET documentation และ API reference.
คำถามที่พบบ่อย
- QIDO-RS คืออะไร?
QIDO-RS คือบริการ DICOMweb ที่ใช้ในการค้นหาแหล่งข้อมูล DICOM ผ่านการสอบถาม HTTP ตัวอย่างนี้ใช้เพื่อค้นหาการศึกษาโดยใช้ชื่อผู้ป่วยและอ่านเมตาดาต้าของการศึกษา
- แพคเกจใดให้บริการ DICOMweb client?
ตัวอย่างที่จัดเตรียมมานี้ใช้แพคเกจ NuGet Aspose.Medical เวอร์ชัน 26.10.0 และนำเข้าเนมสเปซ Aspose.Medical.Dicom.Web สำหรับไคลเอนต์และตัวเลือกการค้นหา.
- การค้นหา studies จะดาวน์โหลดภาพ DICOM หรือไม่?
ไม่. ตัวอย่างนี้อ่านเมตาดาต้าที่ส่งกลับโดยการค้นหาการศึกษา การดาวน์โหลดอินสแตนซ์ของภาพต้องดำเนินการเรียกคืนแยกต่างหาก.
- ฉันสามารถจำกัดจำนวนการศึกษาที่ส่งคืนได้หรือไม่?
ใช่. ตั้งค่า Limit บน DicomWebSearchOptions. ตัวอย่างใช้ Limit = 10 และ Offset = 0 เพื่อขอหน้าที่หนึ่งของการศึกษาไม่เกินสิบรายการ.
- ตัวเลือก FuzzyMatching ทำอะไร?
มันขอการจับคู่แบบ fuzzy จากเซิร์ฟเวอร์ ตัวอย่างตั้งค่าเป็น false รูปแบบไวล์การ์ดเช่น Doe* จะถูกจัดหาแยกต่างหากใน MatchingParameters และ endpoint จะกำหนดพฤติกรรมการจับคู่ที่รองรับ.
- ฉันจะอ่านชื่อผู้ป่วยและ Study Instance UID อย่างไร?
ใช้ GetValueOrDefault<string> กับ Tag.PatientName และ Tag.StudyInstanceUID ในแต่ละชุดข้อมูลที่ส่งกลับ ตัวอย่างให้ค่า (not returned) เป็นค่าเริ่มต้นสำหรับค่าที่ไม่มีอยู่
