Trovare gli studi di imaging di un paziente è spesso il primo passo in un flusso di lavoro DICOM. Con una query DICOMweb QIDO‑RS, la tua applicazione può cercare i metadati dello studio e identificare gli studi pertinenti prima di scaricare le istanze di immagine.
In questo tutorial, utilizzerai Aspose.Medical for .NET per cercare studi DICOM per nome del paziente in C#. Configurerai l’SDK, creerai un client DICOMweb, imposterai un modello di ricerca e un limite di risultati, e leggerai gli studi corrispondenti. L’esempio completo della console visualizza il Patient Name e il Study Instance UID di ogni studio.
Per seguire, avrai bisogno di un endpoint QIDO‑RS accessibile contenente studi da interrogare.
Installa Aspose.Medical for .NET
Questo esempio è destinato a .NET 10 e utilizza Aspose.Medical 26.10.0. Installa il SDK .NET 10, quindi crea un progetto console e aggiungi il pacchetto bloccato:
dotnet new console -n DicomStudySearch -f net10.0
cd DicomStudySearch
dotnet add package Aspose.Medical --version 26.10.0
Il file di progetto dovrebbe contenere le seguenti impostazioni. Gli usings impliciti forniscono gli spazi dei nomi standard utilizzati dall’esempio, mentre i tipi di riferimento nullable supportano i valori opzionali delle variabili d’ambiente.
<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>
Se utilizzi la Console di Gestione Pacchetti di Visual Studio, installa la stessa versione con:
Install-Package Aspose.Medical -Version 26.10.0
L’esempio utilizza gli spazi dei nomi Aspose.Medical.Dicom, Aspose.Medical.Dicom.Tags e Aspose.Medical.Dicom.Web. Le loro direttive using sono incluse nel programma completo di seguito.
Configura la licenza e l’accesso all’endpoint
Il programma verifica ASPOSE_MEDICAL_LICENSE per un percorso del file di licenza e carica quel file quando la variabile è impostata. Se hai bisogno di una licenza per la valutazione, puoi richiedere una licenza temporanea.
Per un servizio che accetta l’autenticazione bearer, impostare DICOMWEB_TOKEN sul token di accesso. Lasciare non impostato se il tuo endpoint non richiede un token bearer. I servizi che utilizzano un altro metodo di autenticazione richiedono le modifiche corrispondenti alla configurazione del client HTTP.
Ad esempio, in PowerShell:
$env:ASPOSE_MEDICAL_LICENSE = "C:\Licenses\Aspose.Medical.lic"
$env:DICOMWEB_TOKEN = "your-access-token"
Sostituisci questi segnaposto con i tuoi valori e imposta solo le variabili di cui hai bisogno.
Cerca studi DICOM per nome del paziente in C#
Sostituisci Program.cs con il seguente codice. Il programma accetta l’URI base DICOMweb come primo argomento e un modello opzionale di nome paziente come secondo argomento. Se ometti il modello, utilizza 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;
}
Le sezioni seguenti spiegano come la configurazione del client, le opzioni di ricerca e l’elaborazione dei risultati lavorano insieme.
Crea un client DICOMweb
Il programma crea un HttpClient e, quando viene fornito un token, aggiunge un’intestazione di autorizzazione bearer. Quindi passa quel client HTTP a DicomWebClient insieme a DicomWebClientOptions.
Imposta BaseUri sull’URL di base DICOMweb del tuo servizio. Il codice lo legge da args[0] e richiede un URI assoluto. Usa l’URL di base fornito dall’amministratore del tuo server invece di presumere che ogni servizio utilizzi lo stesso percorso.
Configura la query del nome del paziente
DicomWebSearchOptions contiene i criteri di ricerca dello studio. In questo esempio, MatchingParameters associa PatientName al modello fornito sulla riga di comando.
Le altre impostazioni controllano la corrispondenza e la pagina dei risultati richiesta:
| Impostazione | Valore di esempio | Scopo |
|---|---|---|
FuzzyMatching | false | Non richiede corrispondenza fuzzy. |
Limit | 10 | Richiede al massimo dieci studi. |
Offset | 0 | Richiede risultati a partire dall’offset iniziale. |
Il pattern wildcard Doe* è separato dall’opzione fuzzy-matching. Verifica il comportamento di corrispondenza del nome paziente supportato dal tuo endpoint prima di fare affidamento su un risultato specifico. L’abilitazione del fuzzy matching non garantisce di per sé un comportamento case-insensitive o wildcard.
Il programma legge una pagina di risultati. Non richiede automaticamente le pagine successive.
Esegui la ricerca e leggi i metadati dello studio
client.Studies.SearchAsync esegue la query e restituisce un DicomWebClientStream<Dataset>. Il programma utilizza await foreach per leggere i dataset restituiti e await using per rilasciare lo stream al termine dell’elaborazione.
Per ogni studio, GetValueOrDefault<string> legge il primo valore di Tag.PatientName e Tag.StudyInstanceUID. Se un valore è assente, il programma visualizza (non restituito) al posto.
Un token di cancellazione di 30 secondi viene passato sia alla chiamata di ricerca sia all’iterazione dei risultati. Il programma conta i set di dati che legge e stampa il conteggio dopo il ciclo. Se si verifica un’eccezione, scrive il tipo di eccezione e il messaggio su standard error e imposta il codice di uscita del processo su 1.
Esegui l’esempio e controlla i risultati
Dalla directory del progetto, esegui:
dotnet run -- "https://dicom.example.com/dicomweb" "Doe*"
Sostituisci l’URL di esempio con l’URL del tuo servizio DICOMweb accessibile. Usa un modello di nome paziente che corrisponda agli studi memorizzati su quel servizio.
L’output seguente è illustrativo; i nomi, gli UID e il conteggio dipendono dai dati del tuo endpoint e dalle regole di corrispondenza:
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
Se la query termina senza corrispondenze, il programma stampa:
Studies returned: 0
Un conteggio zero significa che non sono stati restituiti dataset per quella query. Un messaggio di eccezione e il codice di uscita 1 indicano che l’operazione non è stata completata con successo. Questo esempio recupera i metadati dello studio; non scarica le istanze di immagini DICOM.
Conclusione
Esegui l’esempio contro il tuo endpoint QIDO‑RS con un nome paziente noto, quindi regola il modello di ricerca e il limite dei risultati per la tua applicazione. Se hai bisogno di più di una pagina di studi, estendi l’esempio per richiedere le pagine successive utilizzando il comportamento di paginazione supportato dal tuo server.
Per le API correlate e le indicazioni di configurazione, vedere la documentazione di Aspose.Medical for .NET e il riferimento API.
Domande frequenti
- Cos’è QIDO-RS?
QIDO-RS è il servizio DICOMweb utilizzato per cercare risorse DICOM tramite query HTTP. Questo esempio lo utilizza per trovare studi per nome del paziente e leggere i loro metadati.
- Quale pacchetto fornisce il client DICOMweb?
L’esempio fornito utilizza il pacchetto NuGet Aspose.Medical, versione 26.10.0, e importa il suo namespace Aspose.Medical.Dicom.Web per il client e le opzioni di ricerca.
- La ricerca di studi scarica le immagini DICOM?
No. Questo esempio legge i metadati restituiti da una ricerca di studio. Il download delle istanze di immagine richiede un’operazione di recupero separata.
- Posso limitare il numero di studi restituiti?
Sì. Imposta Limit su DicomWebSearchOptions. L’esempio utilizza Limit = 10 e Offset = 0 per richiedere la prima pagina di un massimo di dieci studi.
- Cosa fa l’opzione FuzzyMatching?
Richiede il fuzzy matching dal server. L’esempio lo imposta su false. I pattern wildcard come Doe* vengono forniti separatamente in MatchingParameters, e l’endpoint determina il comportamento di matching supportato.
- Come leggo il nome del paziente e lo Study Instance UID?
Usa GetValueOrDefault<string> con Tag.PatientName e Tag.StudyInstanceUID su ogni dataset restituito. L’esempio fornisce (not returned) come valore di fallback per un valore assente.
Leggi di più
- Crea richieste DICOMweb personalizzate in C#
- Crea un server DICOMweb personalizzato con Aspose.Medical in C#
- Crea un file DICOM in C# con Aspose.Medical for .NET
- Leggi e modifica valori di elementi DICOM ad alte prestazioni in C#
- Configura le liste di lavoro DICOMweb UPS in C#
- Leggi e visualizza un file DICOM in C# - Visualizzatore di file DCM
