מציאת מחקרי ההדמיה של המטופל היא לעתים הצעד הראשון בתהליך עבודה של DICOM. באמצעות שאילתת DICOMweb QIDO‑RS, היישום שלך יכול לחפש מטא‑נתוני מחקר ולזהות מחקרים רלוונטיים לפני הורדת מופעי תמונה.

במדריך זה, תשתמשו ב-Aspose.Medical for .NET כדי לחפש מחקרים של DICOM לפי שם המטופל ב‑C#. תגדירו את ה‑SDK, תיצרו לקוח DICOMweb, תגדירו תבנית חיפוש והגבלת תוצאות, ותקריאו את המחקרים המתאימים. הדוגמה המלאה של הקונסול מציגה את שם המטופל ו‑Study Instance UID של כל מחקר.

כדי לעקוב, תצטרך נקודת קצה של QIDO‑RS נגישה המכילה מחקרים לשאילתה.

התקן Aspose.Medical for .NET

דוגמה זו ממקדת .NET 10 ומשתמשת ב-Aspose.Medical 26.10.0. התקן את ה‑SDK של .NET 10, ולאחר מכן צור פרויקט קונסול והוסף את החבילה המוצמדת:

dotnet new console -n DicomStudySearch -f net10.0
cd DicomStudySearch
dotnet add package Aspose.Medical --version 26.10.0

קובץ הפרויקט שלך צריך להכיל את ההגדרות הבאות. שימושים מרומזים מספקים את המרחבים הסטנדרטיים המשמשים בדוגמה, בעוד שסוגי הפניות ניתנים לאפס תומכים בערכי משתני הסביבה האופציונליים.

<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>

אם אתה משתמש בקונסול מנהל החבילות של Visual Studio, התקן את אותה גרסה עם:

Install-Package Aspose.Medical -Version 26.10.0

הדוגמה משתמשת במרחבי השמות Aspose.Medical.Dicom, Aspose.Medical.Dicom.Tags ו-Aspose.Medical.Dicom.Web. ההוראות using שלהם נכללות בתוכנית המלאה שלהלן.

הגדר את הרישיון והגישה לנקודת הקצה

התוכנית בודקת את ASPOSE_MEDICAL_LICENSE בשביל נתיב קובץ רישיון וטוענת את הקובץ כאשר המשתנה מוגדר. אם אתה צריך רישיון להערכה, אתה יכול לבקש רישיון זמני.

בשירות שמקבל אימות Bearer, הגדר את DICOMWEB_TOKEN לטוקן הגישה שלך. השאר אותו ללא הגדרה אם הקצה שלך אינו דורש טוקן Bearer. שירותים שמשתמשים בשיטת אימות אחרת דורשים שינויים מתאימים בתצורת לקוח ה‑HTTP.

לדוגמה, ב-PowerShell:

$env:ASPOSE_MEDICAL_LICENSE = "C:\Licenses\Aspose.Medical.lic"
$env:DICOMWEB_TOKEN = "your-access-token"

החלף את מצייני המיקום האלה בערכים שלך והגדר רק את המשתנים שאתה צריך.

חיפוש מחקרים של DICOM לפי שם המטופל ב‑C#

החלף את Program.cs בקוד הבא. התוכנית מקבלת את כתובת הבסיס של DICOMweb כפרמטר הראשון שלה ואת תבנית שם‑המטופל האופציונלית כפרמטר השני. אם אתה משמיט את התבנית, היא משתמשת ב‑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 ובמקרה שמסופק אסימון, מוסיפה כותרת הרשאה מסוג bearer. לאחר מכן היא מעבירה את לקוח ה‑HTTP הזה ל‑DicomWebClient יחד עם DicomWebClientOptions.

הגדר את BaseUri לכתובת הבסיס של DICOMweb של השירות שלך. הקוד קורא אותה מ-args[0] ודורש URI מוחלט. השתמש בכתובת הבסיס שסופקה על ידי מנהל השרת שלך במקום להניח שכל שירות משתמש באותו הנתיב.

הגדרת שאילתת שם המטופל

DicomWebSearchOptions מכיל את קריטריוני החיפוש של המחקר. בדוגמה זו, MatchingParameters משייך את PatientName לתבנית שסופקה בשורת הפקודה.

ההגדרות האחרות שולטות בהתאמה ובדף התוצאה המבוקש:

הגדרהערך לדוגמהמטרה
FuzzyMatchingfalseלא מבקש התאמה מעורפלת.
Limit10מבקש לכל היותר עשר מחקרים.
Offset0מבקש תוצאות המתחילות מההיסט ההתחלתי.

Doe* תבנית ה‑wildcard נפרדת מאפשרת את אפשרות ההתאמה המטושטשת. בדוק את התנהגות ההתאמה של patient-name הנתמכת על‑ידי הקצה שלך לפני שאתה סומך על תוצאה מסוימת. הפעלת התאמה מטושטשת אינה בעצמה מבטיחה התנהגות של חוסר רגישות לאותיות גדולות/קטנות או wildcard.

התוכנית קוראת דף תוצאות אחד. היא אינה מבקשת באופן אוטומטי דפים נוספים.

הפעל את החיפוש וקרא את מטא-נתוני המחקר

client.Studies.SearchAsync מבצע את השאילתה ומחזיר DicomWebClientStream<Dataset>. התוכנית משתמשת ב-await foreach כדי לקרוא את מערכי הנתונים שהוחזרו וב-await using כדי לשחרר את הזרם כאשר העיבוד מסתיים.

לכל מחקר, GetValueOrDefault<string> קורא את הערך הראשון של Tag.PatientName ו‑Tag.StudyInstanceUID. אם ערך חסר, התוכנית מציגה (not returned) במקום.

טוקן ביטול של 30 שניות מועבר גם לקריאת החיפוש וגם לאיטרציה של התוצאה. התוכנית סופרת את מערכי הנתונים שהיא קוראת ומדפיסה את הספירה לאחר הלולאה. אם מתרחשת חריגה, היא כותבת את סוג החריגה וההודעה לשגיאה הסטנדרטית ומגדירה את קוד היציאה של התהליך ל-1.

הפעל את הדוגמה ובדוק את התוצאות

מתיקיית הפרויקט, הפעל:

dotnet run -- "https://dicom.example.com/dicomweb" "Doe*"

החלף את כתובת ה‑URL לדוגמה בכתובת ה‑URL של שירות DICOMweb הזמין שלך. השתמש בתבנית שם‑מטופל המתאימה למחקרים המאוחסנים בשירות זה.

הפלט הבא הוא לדוגמה; השמות, מזהי ה‑UID והספירה תלויות בנתוני הקצה שלך ובכללי ההתאמה:

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 שלך עם שם מטופל ידוע, ואז התאם את תבנית החיפוש ואת מגבלת התוצאות עבור היישום שלך. אם אתה צריך יותר מדף אחד של מחקרים, הרחב את הדוגמה כדי לבקש דפים נוספים באמצעות התנהגות הדפדוף הנתמכת על ידי השרת שלך.

ל‑APIs הקשורים והכוונת תצורה, ראה את תיעוד Aspose.Medical for .NET ותיעוד API.

שאלות נפוצות

  1. מהו QIDO-RS?

QIDO-RS הוא שירות DICOMweb המשמש לחיפוש משאבי DICOM דרך שאילתות HTTP. דוגמה זו משתמשת בו כדי למצוא מחקרים לפי שם המטופל ולקרוא את המטא‑נתונים שלהם.

  1. איזה חבילה מספקת את לקוח DICOMweb?

הדוגמה המסופקת משתמשת בחבילת NuGet Aspose.Medical, גרסה 26.10.0, ומייבאת את המרחב השמות Aspose.Medical.Dicom.Web עבור הלקוח ואפשרויות החיפוש.

  1. האם חיפוש מחקרים מוריד תמונות DICOM?

לא. דוגמה זו קוראת את המטא‑נתונים שהוחזרו בחיפוש מחקר. הורדת מופעי תמונה דורשת פעולה נפרדת של אחזור.

  1. האם ניתן להגביל את מספר המחקרים המוחזרים?

כן. הגדר Limit ב‑DicomWebSearchOptions. הדוגמה משתמשת ב‑Limit = 10 וב‑Offset = 0 כדי לבקש את העמוד הראשון של עד עשר מחקרים.

  1. מה עושה האפשרות FuzzyMatching?

זה מבקש התאמה מעורפלת מהשרת. בדוגמה זה מוגדר ל-false. תבניות עם תו כללי כגון Doe* מסופקות בנפרד ב-MatchingParameters, והקצה קובע את התנהגות ההתאמה הנתמכת.

  1. איך אני קורא את שם המטופל ואת מזהה מופע המחקר?

השתמש ב-GetValueOrDefault<string> עם Tag.PatientName ו-Tag.StudyInstanceUID על כל מערך נתונים שהוחזר. הדוגמה מספקת (not returned) כערך ברירת מחדל במקרה של ערך חסר.

קרא עוד