La préparation d’une requête ou d’une réponse DICOMweb commence par le choix de la représentation du contenu attendue par votre point de terminaison. Vous pouvez avoir besoin d’un contenu généré à partir d’un fichier DICOM, ou d’un jeu de données sérialisé en DICOM JSON. Ces représentations utilisent différents types de médias, de sorte que le choix doit correspondre à l’opération que vous implémentez.

Dans ce tutoriel, vous utiliserez Aspose.Medical for .NET pour générer les deux représentations en C#. Vous chargerez un fichier DICOM local, créerez le contenu avec DicomWebContent.FromDicomFile, et utiliserez DicomWebContent.FromDataset pour créer du contenu DICOM JSON à partir de son jeu de données. Chaque exemple affiche le type de contenu résultant afin que vous puissiez l’inspecter avant d’intégrer le contenu dans un flux de travail HTTP.

Installer Aspose.Medical pour .NET

Ajoutez Aspose.Medical for .NET à votre projet en utilisant la console du Gestionnaire de packages de Visual Studio :

Install-Package Aspose.Medical

Alternativement, exécutez la commande suivante depuis le répertoire de votre projet :

dotnet add package Aspose.Medical

Utilisez une version du package qui inclut les API Aspose.Medical.Dicom.Web présentées ci-dessous. Vérifiez votre framework cible par rapport aux exigences de cette version du package plutôt que de supposer que chaque version prend en charge les mêmes frameworks.

Avant d’exécuter l’un ou l’autre exemple, placez un fichier DICOM lisible nommé image.dcm dans le répertoire de travail de votre application, ou remplacez le chemin relatif par le chemin complet de votre fichier. Ces exemples fonctionnent localement ; vous n’avez pas besoin d’un serveur DICOMweb pour créer les objets de contenu.

Si vous devez évaluer l’API avec une licence, vous pouvez demander une licence temporaire. Les extraits se concentrent sur la génération de contenu et n’incluent pas l’initialisation de la licence.

Créer du contenu DICOMweb à partir d’un fichier DICOM

Utilisez DicomWebContent.FromDicomFile lorsque vous avez besoin d’une représentation du contenu d’un fichier DICOM chargé.

  1. Ouvrez le fichier source avec DicomFile.Open.
  2. Passez le DicomFile résultant à DicomWebContent.FromDicomFile.
  3. Lisez ContentType pour inspecter le type de média du contenu généré.
using System.Net.Http.Headers;
using Aspose.Medical.Dicom;
using Aspose.Medical.Dicom.Web;

// Create content from a single DICOM file
DicomFile file = DicomFile.Open("image.dcm");
DicomWebContent fileContent = DicomWebContent.FromDicomFile(file);
System.Console.WriteLine($"Content type: {fileContent.ContentType}");

DicomFile.Open("image.dcm") charge le fichier source. FromDicomFile(file) crée ensuite sa représentation binaire du contenu DICOM. Le type de média pour cette représentation est application/dicom.

Cet exemple crée l’objet de contenu et écrit son type de contenu dans la console. Il ne sauvegarde pas un nouveau fichier DICOM ni n’envoie le contenu à un serveur.

Générer le contenu JSON DICOMweb à partir d’un jeu de données

Utilisez DicomWebContent.FromDataset lorsque vous souhaitez créer du contenu à partir d’un jeu de données en mémoire. Pour le JSON DICOM, spécifiez application/dicom+json en utilisant DicomWebMediaTypes.ApplicationDicomJson.

L’entrée est un Dataset, pas une chaîne JSON déjà sérialisée. Dans cet exemple, le jeu de données provient du même fichier DICOM local :

  1. Chargez image.dcm et accédez à file.Dataset.
  2. Créez un MediaTypeHeaderValue pour le JSON DICOM.
  3. Transmettez le dataset et le type de média à DicomWebContent.FromDataset.
  4. Inspectez le ContentType résultant.
using System.Net.Http.Headers;
using Aspose.Medical.Dicom;
using Aspose.Medical.Dicom.Web;

// Assume 'file' is a DicomFile loaded earlier
DicomFile file = DicomFile.Open("image.dcm");
Dataset dataset = file.Dataset;

// Create content from a dataset serialized as DICOM JSON
DicomWebContent jsonContent = DicomWebContent.FromDataset(
    dataset,
    new MediaTypeHeaderValue(DicomWebMediaTypes.ApplicationDicomJson));
System.Console.WriteLine($"JSON content type: {jsonContent.ContentType}");

file.Dataset fournit le jeu de données utilisé pour créer la représentation JSON. L’appel à FromDataset fournit à la fois ce jeu de données et le type de média demandé ; vous n’avez pas besoin d’une étape de sérialisation JSON séparée dans cet exemple.

Les deux extraits sont indépendants. Chacun charge son propre fichier et déclare une variable nommée file. Si vous les combinez en un seul programme, conservez les directives using en haut et réutilisez la variable file existante.

Choisissez la représentation du contenu pour votre flux de travail HTTP

Choisissez la méthode en fonction de la représentation requise par votre opération DICOMweb :

Entrée et représentation prévueMéthodeType de média
Fichier DICOM chargé en tant que contenu DICOM binaireDicomWebContent.FromDicomFile(file)application/dicom
Ensemble de données en mémoire en tant que contenu DICOM JSONDicomWebContent.FromDataset(dataset, mediaType)application/dicom+json

Créer l’un ou l’autre objet est une étape de préparation locale. Cela ne télécharge pas le fichier source, n’exécute pas de requête et ne complète pas une transaction DICOMweb.

Lors de l’intégration du contenu dans une requête ou une réponse HTTP, respectez les exigences d’API et de type de média de l’opération que vous implémentez. Les extraits ne démontrent pas la conversion en HttpContent, l’empaquetage multipart, l’authentification ou l’envoi d’une requête avec HttpClient.

Exécuter les exemples et vérifier les résultats

Exécutez l’un des extraits dans une application console C# après avoir installé le package et rendu image.dcm disponible. Si vous utilisez un projet console, placez un extrait dans Program.cs et exécutez :

dotnet run

L’exemple basé sur un fichier affiche une ligne commençant par Content type:. L’exemple de jeu de données affiche une ligne commençant par JSON content type:. Vérifiez les types de média affichés par rapport à la représentation que vous avez demandée :

ExempleType de média attendu
Contenu du fichier DICOMapplication/dicom
Ensemble de données sérialisé en JSON DICOMapplication/dicom+json

Voici les valeurs de type de média attendues, et non une transcription d’un test exécuté. Les exemples affichent les en‑têtes de contenu ; ils n’affichent pas la charge binaire ni le JSON sérialisé.

Dépannage de la génération de contenu DICOMweb

Vérifiez le chemin du fichier d’entrée

Le chemin relatif image.dcm est résolu à partir du répertoire de travail de l’application. Si le fichier ne peut pas être ouvert, vérifiez son emplacement, les permissions d’accès et qu’il s’agit d’un fichier DICOM lisible. Utilisez un chemin absolu si le répertoire de travail diffère entre votre IDE et les exécutions en ligne de commande.

Confirmez que le package installé expose les API requises

Si Aspose.Medical.Dicom.Web ou DicomWebContent ne peuvent pas être résolus, vérifiez la version du package installé et la disponibilité de son API. Ajouter une directive using ne rend pas une API disponible lorsque le package référencé ne la contient pas.

Gardez le jeu de données et les entrées JSON distincts

L’exemple de jeu de données transmet file.Dataset directement à FromDataset. Ne le remplacez pas par une chaîne JSON et ne supposez pas que la même surcharge accepte cette entrée. L’argument media-type spécifie la représentation qui est créée.

Vérifiez l’opération de destination avant d’envoyer le contenu

Un objet de contenu avec le type de média attendu n’est qu’une partie d’un flux de travail HTTP. Confirmez le point de terminaison de destination, la méthode de requête, les en‑têtes, l’authentification et toute exigence multipart avant d’ajouter une opération d’envoi. Un appel de génération de contenu local réussi ne confirme pas qu’un serveur acceptera la requête éventuelle.

Conclusion

Utilisez FromDicomFile pour le contenu généré à partir d’un fichier DICOM et FromDataset avec application/dicom+json pour une représentation JSON DICOM. Exécutez l’extrait pertinent avec votre propre fichier, inspectez ContentType, puis intégrez le contenu dans la requête ou la réponse requise par votre point de terminaison.

Voir la documentation Aspose.Medical et la référence API pour la configuration associée et les détails de l’API.

Questions fréquentes

Quelle est la différence entre les deux méthodes de génération de contenu ?

FromDicomFile crée du contenu à partir d’un fichier DICOM chargé. FromDataset crée une représentation de contenu à partir d’un jeu de données en mémoire en utilisant le type de média fourni. Ce tutoriel utilise ce dernier pour créer du contenu DICOM JSON.

Dois-je d’abord sérialiser le jeu de données en JSON ?

Non. L’exemple transmet un Dataset à FromDataset avec le type de média application/dicom+json. Il ne prend pas une chaîne JSON existante en entrée.

Quel type de média est utilisé pour le contenu JSON DICOM ?

Utilisez application/dicom+json, représenté dans l’exemple par DicomWebMediaTypes.ApplicationDicomJson.

Ces exemples téléchargent-ils un fichier DICOM sur un serveur ?

Non. Ils créent des objets de contenu localement et affichent leurs types de contenu. L’envoi du contenu nécessite du code d’intégration HTTP supplémentaire.

Puis-je combiner les deux exemples en un seul programme ?

Oui. Conservez les directives using en haut et réutilisez le DicomFile chargé au lieu de déclarer la variable file deux fois dans le même scope.

En savoir plus