翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
画像セットメタデータの更新
UpdateImageSetMetadata アクションを使用して、 のイメージセットメタデータを更新しますAWS HealthImaging。この非同期プロセスを使用して、インポート中に作成されるDICOM正規化要素の兆候であるイメージセットメタデータ属性を追加、更新、削除できます。UpdateImageSetMetadata アクションを使用して、シリーズとSOPインスタンスを削除して、イメージセットを外部システムと同期させ、イメージセットメタデータの識別を解除することもできます。詳細については、 リファレンスUpdateImageSetMetadataの「」を参照してください。 AWS HealthImaging API
注記
実際のDICOMインポートでは、イメージセットメタデータから属性を更新、追加、削除する必要があります。イメージセットメタデータを更新するときは、次の点に注意してください。
-
画像セットのメタデータを更新すると、画像セット履歴に新しいバージョンが作成されます。詳細については、「画像セットのバージョンを一覧表示する」を参照してください。以前のイメージセットバージョン ID に戻すには、オプションの
revertToVersionIdパラメータを使用します。 -
画像セットのメタデータの更新は非同期プロセスです。したがって、
imageSetStateおよびimageSetWorkflowStatusレスポンス要素は、更新中のイメージセットのそれぞれの状態とステータスを提供するために使用できます。LOCKEDイメージセットに対して他の書き込みオペレーションを実行することはできません。 -
UpdateImageSetMetadataアクションが成功しない場合は、 を呼び出してmessageレスポンス要素を確認して、 を確認しますcommon errors。 -
DICOM 要素の制約はメタデータの更新に適用されます。
forceリクエストパラメータを使用すると、 を上書きする場合に要素を更新できますDICOM メタデータの制約。 UpdateImageSetMetadataアクションを強制的に完了するようにforceリクエストパラメータを設定します。このパラメータを設定すると、イメージセットに対する次の更新が可能になります。-
Tag.StudyInstanceUID、Tag.SeriesInstanceUID、Tag.SOPInstanceUID、およびTag.StudyID属性の更新 -
インスタンスレベルのプライベートDICOMデータ要素の追加、削除、更新
-
次の図は、 で更新されているイメージセットメタデータを示しています HealthImaging。
画像セットのメタデータを更新するには
へのアクセス設定に基づいてタブを選択しますAWS HealthImaging。
- CLI
-
- AWS CLI
-
例 1: イメージセットメタデータに属性を挿入または更新するには
次の
update-image-set-metadata例では、イメージセットメタデータに 属性を挿入または更新します。aws medical-imaging update-image-set-metadata \ --datastore-id12345678901234567890123456789012\ --image-set-idea92b0d8838c72a3f25d00d13616f87e\ --latest-version-id1\ --cli-binary-formatraw-in-base64-out\ --update-image-set-metadata-updatesfile://metadata-updates.jsonmetadata-updates.jsonの内容{ "DICOMUpdates": { "updatableAttributes": "{\"SchemaVersion\":1.1,\"Patient\":{\"DICOM\":{\"PatientName\":\"MX^MX\"}}}" } }出力:
{ "latestVersionId": "2", "imageSetWorkflowStatus": "UPDATING", "updatedAt": 1680042257.908, "imageSetId": "ea92b0d8838c72a3f25d00d13616f87e", "imageSetState": "LOCKED", "createdAt": 1680027126.436, "datastoreId": "12345678901234567890123456789012" }例 2: イメージセットメタデータから属性を削除するには
次の
update-image-set-metadata例では、イメージセットメタデータから属性を削除します。aws medical-imaging update-image-set-metadata \ --datastore-id12345678901234567890123456789012\ --image-set-idea92b0d8838c72a3f25d00d13616f87e\ --latest-version-id1\ --cli-binary-formatraw-in-base64-out\ --update-image-set-metadata-updatesfile://metadata-updates.jsonmetadata-updates.jsonの内容{ "DICOMUpdates": { "removableAttributes": "{\"SchemaVersion\":1.1,\"Study\":{\"DICOM\":{\"StudyDescription\":\"CHEST\"}}}" } }出力:
{ "latestVersionId": "2", "imageSetWorkflowStatus": "UPDATING", "updatedAt": 1680042257.908, "imageSetId": "ea92b0d8838c72a3f25d00d13616f87e", "imageSetState": "LOCKED", "createdAt": 1680027126.436, "datastoreId": "12345678901234567890123456789012" }例 3: イメージセットメタデータからインスタンスを削除するには
次の
update-image-set-metadata例では、イメージセットメタデータからインスタンスを削除します。aws medical-imaging update-image-set-metadata \ --datastore-id12345678901234567890123456789012\ --image-set-idea92b0d8838c72a3f25d00d13616f87e\ --latest-version-id1\ --cli-binary-formatraw-in-base64-out\ --update-image-set-metadata-updatesfile://metadata-updates.jsonmetadata-updates.jsonの内容{ "DICOMUpdates": { "removableAttributes": "{\"SchemaVersion\": 1.1,\"Study\": {\"Series\": {\"1.1.1.1.1.1.12345.123456789012.123.12345678901234.1\": {\"Instances\": {\"1.1.1.1.1.1.12345.123456789012.123.12345678901234.1\": {}}}}}}" } }出力:
{ "latestVersionId": "2", "imageSetWorkflowStatus": "UPDATING", "updatedAt": 1680042257.908, "imageSetId": "ea92b0d8838c72a3f25d00d13616f87e", "imageSetState": "LOCKED", "createdAt": 1680027126.436, "datastoreId": "12345678901234567890123456789012" }例 4: イメージセットを以前のバージョンに戻すには
次の
update-image-set-metadata例は、イメージセットを以前のバージョンに戻す方法を示しています。 CopyImageSet UpdateImageSetMetadata アクションは新しいバージョンのイメージセットを作成します。aws medical-imaging update-image-set-metadata \ --datastore-id12345678901234567890123456789012\ --image-set-id53d5fdb05ca4d46ac7ca64b06545c66e\ --latest-version-id3\ --cli-binary-formatraw-in-base64-out\ --update-image-set-metadata-updates '{"revertToVersionId": "1"}'出力:
{ "datastoreId": "12345678901234567890123456789012", "imageSetId": "53d5fdb05ca4d46ac7ca64b06545c66e", "latestVersionId": "4", "imageSetState": "LOCKED", "imageSetWorkflowStatus": "UPDATING", "createdAt": 1680027126.436, "updatedAt": 1680042257.908 }例 5: インスタンスにプライベートDICOMデータ要素を追加するには
次の
update-image-set-metadata例は、イメージセット内の指定されたインスタンスにプライベート要素を追加する方法を示しています。このDICOM標準では、標準データ要素に含めることができない情報の通信にプライベートデータ要素を許可します。UpdateImageSetMetadata アクションを使用して、プライベートデータ要素を作成、更新、削除できます。aws medical-imaging update-image-set-metadata \ --datastore-id12345678901234567890123456789012\ --image-set-id53d5fdb05ca4d46ac7ca64b06545c66e\ --latest-version-id1\ --cli-binary-formatraw-in-base64-out\ --force \ --update-image-set-metadata-updatesfile://metadata-updates.jsonmetadata-updates.jsonの内容{ "DICOMUpdates": { "updatableAttributes": "{\"SchemaVersion\": 1.1,\"Study\": {\"Series\": {\"1.1.1.1.1.1.12345.123456789012.123.12345678901234.1\": {\"Instances\": {\"1.1.1.1.1.1.12345.123456789012.123.12345678901234.1\": {\"DICOM\": {\"001910F9\": \"97\"},\"DICOMVRs\": {\"001910F9\": \"DS\"}}}}}}}" } }出力:
{ "latestVersionId": "2", "imageSetWorkflowStatus": "UPDATING", "updatedAt": 1680042257.908, "imageSetId": "53d5fdb05ca4d46ac7ca64b06545c66e", "imageSetState": "LOCKED", "createdAt": 1680027126.436, "datastoreId": "12345678901234567890123456789012" }例 6: プライベートDICOMデータ要素をインスタンスに更新するには
次の
update-image-set-metadata例は、イメージセット内のインスタンスに属するプライベートデータ要素の値を更新する方法を示しています。aws medical-imaging update-image-set-metadata \ --datastore-id12345678901234567890123456789012\ --image-set-id53d5fdb05ca4d46ac7ca64b06545c66e\ --latest-version-id1\ --cli-binary-formatraw-in-base64-out\ --force \ --update-image-set-metadata-updatesfile://metadata-updates.jsonmetadata-updates.jsonの内容{ "DICOMUpdates": { "updatableAttributes": "{\"SchemaVersion\": 1.1,\"Study\": {\"Series\": {\"1.1.1.1.1.1.12345.123456789012.123.12345678901234.1\": {\"Instances\": {\"1.1.1.1.1.1.12345.123456789012.123.12345678901234.1\": {\"DICOM\": {\"00091001\": \"GE_GENESIS_DD\"}}}}}}}" } }出力:
{ "latestVersionId": "2", "imageSetWorkflowStatus": "UPDATING", "updatedAt": 1680042257.908, "imageSetId": "53d5fdb05ca4d46ac7ca64b06545c66e", "imageSetState": "LOCKED", "createdAt": 1680027126.436, "datastoreId": "12345678901234567890123456789012" }例 7: force パラメータSOPInstanceUIDを使用して を更新するには
次の
update-image-set-metadata例は、force パラメータを使用してDICOMメタデータの制約を上書きしSOPInstanceUID、 を更新する方法を示しています。aws medical-imaging update-image-set-metadata \ --datastore-id12345678901234567890123456789012\ --image-set-id53d5fdb05ca4d46ac7ca64b06545c66e\ --latest-version-id1\ --cli-binary-formatraw-in-base64-out\ --force \ --update-image-set-metadata-updatesfile://metadata-updates.jsonmetadata-updates.jsonの内容{ "DICOMUpdates": { "updatableAttributes": "{\"SchemaVersion\":1.1,\"Study\":{\"Series\":{\"1.3.6.1.4.1.5962.99.1.3633258862.2104868982.1369432891697.3656.0\":{\"Instances\":{\"1.3.6.1.4.1.5962.99.1.3633258862.2104868982.1369432891697.3659.0\":{\"DICOM\":{\"SOPInstanceUID\":\"1.3.6.1.4.1.5962.99.1.3633258862.2104868982.1369432891697.3659.9\"}}}}}}}" } }出力:
{ "latestVersionId": "2", "imageSetWorkflowStatus": "UPDATING", "updatedAt": 1680042257.908, "imageSetId": "53d5fdb05ca4d46ac7ca64b06545c66e", "imageSetState": "LOCKED", "createdAt": 1680027126.436, "datastoreId": "12345678901234567890123456789012" }詳細については、AWS HealthImaging 「 デベロッパーガイド」の「イメージセットメタデータの更新」を参照してください。
-
API 詳細については、AWS CLI 「 コマンドリファレンスUpdateImageSetMetadata
」の「」を参照してください。
-
- Java
-
- SDK Java 2.x 用
-
/** * Update the metadata of an AWS HealthImaging image set. * * @param medicalImagingClient - The AWS HealthImaging client object. * @param datastoreId - The datastore ID. * @param imageSetId - The image set ID. * @param versionId - The version ID. * @param metadataUpdates - A MetadataUpdates object containing the updates. * @param force - The force flag. * @throws MedicalImagingException - Base exception for all service exceptions thrown by AWS HealthImaging. */ public static void updateMedicalImageSetMetadata(MedicalImagingClient medicalImagingClient, String datastoreId, String imageSetId, String versionId, MetadataUpdates metadataUpdates, boolean force) { try { UpdateImageSetMetadataRequest updateImageSetMetadataRequest = UpdateImageSetMetadataRequest .builder() .datastoreId(datastoreId) .imageSetId(imageSetId) .latestVersionId(versionId) .updateImageSetMetadataUpdates(metadataUpdates) .force(force) .build(); UpdateImageSetMetadataResponse response = medicalImagingClient.updateImageSetMetadata(updateImageSetMetadataRequest); System.out.println("The image set metadata was updated" + response); } catch (MedicalImagingException e) { System.err.println(e.awsErrorDetails().errorMessage()); throw e; } }ユースケース #1: 属性を挿入または更新します。
final String insertAttributes = """ { "SchemaVersion": 1.1, "Study": { "DICOM": { "StudyDescription": "CT CHEST" } } } """; MetadataUpdates metadataInsertUpdates = MetadataUpdates.builder() .dicomUpdates(DICOMUpdates.builder() .updatableAttributes(SdkBytes.fromByteBuffer( ByteBuffer.wrap(insertAttributes .getBytes(StandardCharsets.UTF_8)))) .build()) .build(); updateMedicalImageSetMetadata(medicalImagingClient, datastoreId, imagesetId, versionid, metadataInsertUpdates, force);ユースケース #2: 属性を削除します。
final String removeAttributes = """ { "SchemaVersion": 1.1, "Study": { "DICOM": { "StudyDescription": "CT CHEST" } } } """; MetadataUpdates metadataRemoveUpdates = MetadataUpdates.builder() .dicomUpdates(DICOMUpdates.builder() .removableAttributes(SdkBytes.fromByteBuffer( ByteBuffer.wrap(removeAttributes .getBytes(StandardCharsets.UTF_8)))) .build()) .build(); updateMedicalImageSetMetadata(medicalImagingClient, datastoreId, imagesetId, versionid, metadataRemoveUpdates, force);ユースケース #3: インスタンスを削除します。
final String removeInstance = """ { "SchemaVersion": 1.1, "Study": { "Series": { "1.1.1.1.1.1.12345.123456789012.123.12345678901234.1": { "Instances": { "1.1.1.1.1.1.12345.123456789012.123.12345678901234.1": {} } } } } } """; MetadataUpdates metadataRemoveUpdates = MetadataUpdates.builder() .dicomUpdates(DICOMUpdates.builder() .removableAttributes(SdkBytes.fromByteBuffer( ByteBuffer.wrap(removeInstance .getBytes(StandardCharsets.UTF_8)))) .build()) .build(); updateMedicalImageSetMetadata(medicalImagingClient, datastoreId, imagesetId, versionid, metadataRemoveUpdates, force);ユースケース #4: 以前のバージョンに戻します。
// In this case, revert to previous version. String revertVersionId = Integer.toString(Integer.parseInt(versionid) - 1); MetadataUpdates metadataRemoveUpdates = MetadataUpdates.builder() .revertToVersionId(revertVersionId) .build(); updateMedicalImageSetMetadata(medicalImagingClient, datastoreId, imagesetId, versionid, metadataRemoveUpdates, force);-
API 詳細については、 リファレンスUpdateImageSetMetadataの「」を参照してください。 AWS SDK for Java 2.x API
注記
の詳細については、「」を参照してください GitHub。用例一覧を検索し、AWS コード例リポジトリ
での設定と実行の方法を確認してください。 -
- JavaScript
-
- SDK JavaScript (v3) の場合
-
import { UpdateImageSetMetadataCommand } from "@aws-sdk/client-medical-imaging"; import { medicalImagingClient } from "../libs/medicalImagingClient.js"; /** * @param {string} datastoreId - The ID of the HealthImaging data store. * @param {string} imageSetId - The ID of the HealthImaging image set. * @param {string} latestVersionId - The ID of the HealthImaging image set version. * @param {{}} updateMetadata - The metadata to update. * @param {boolean} force - Force the update. */ export const updateImageSetMetadata = async ( datastoreId = "xxxxxxxxxx", imageSetId = "xxxxxxxxxx", latestVersionId = "1", updateMetadata = "{}", force = false, ) => { try { const response = await medicalImagingClient.send( new UpdateImageSetMetadataCommand({ datastoreId: datastoreId, imageSetId: imageSetId, latestVersionId: latestVersionId, updateImageSetMetadataUpdates: updateMetadata, force: force, }), ); console.log(response); // { // '$metadata': { // httpStatusCode: 200, // requestId: '7966e869-e311-4bff-92ec-56a61d3003ea', // extendedRequestId: undefined, // cfId: undefined, // attempts: 1, // totalRetryDelay: 0 // }, // createdAt: 2023-09-22T14:49:26.427Z, // datastoreId: 'xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx', // imageSetId: 'xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx', // imageSetState: 'LOCKED', // imageSetWorkflowStatus: 'UPDATING', // latestVersionId: '4', // updatedAt: 2023-09-27T19:41:43.494Z // } return response; } catch (err) { console.error(err); } };ユースケース #1: 属性を挿入または更新し、強制的に更新します。
const insertAttributes = JSON.stringify({ SchemaVersion: 1.1, Study: { DICOM: { StudyDescription: "CT CHEST", }, }, }); const updateMetadata = { DICOMUpdates: { updatableAttributes: new TextEncoder().encode(insertAttributes), }, }; await updateImageSetMetadata( datastoreID, imageSetID, versionID, updateMetadata, true, );ユースケース #2: 属性を削除します。
// Attribute key and value must match the existing attribute. const remove_attribute = JSON.stringify({ SchemaVersion: 1.1, Study: { DICOM: { StudyDescription: "CT CHEST", }, }, }); const updateMetadata = { DICOMUpdates: { removableAttributes: new TextEncoder().encode(remove_attribute), }, }; await updateImageSetMetadata( datastoreID, imageSetID, versionID, updateMetadata, );ユースケース #3: インスタンスを削除します。
const remove_instance = JSON.stringify({ SchemaVersion: 1.1, Study: { Series: { "1.1.1.1.1.1.12345.123456789012.123.12345678901234.1": { Instances: { "1.1.1.1.1.1.12345.123456789012.123.12345678901234.1": {}, }, }, }, }, }); const updateMetadata = { DICOMUpdates: { removableAttributes: new TextEncoder().encode(remove_instance), }, }; await updateImageSetMetadata( datastoreID, imageSetID, versionID, updateMetadata, );ユースケース #4: 以前のバージョンに戻します。
const updateMetadata = { revertToVersionId: "1", }; await updateImageSetMetadata( datastoreID, imageSetID, versionID, updateMetadata, );-
API 詳細については、 リファレンスUpdateImageSetMetadataの「」を参照してください。 AWS SDK for JavaScript API
注記
の詳細については、「」を参照してください GitHub。用例一覧を検索し、AWS コード例リポジトリ
での設定と実行の方法を確認してください。 -
- Python
-
- SDK Python 用 (Boto3)
-
class MedicalImagingWrapper: def __init__(self, health_imaging_client): self.health_imaging_client = health_imaging_client def update_image_set_metadata( self, datastore_id, image_set_id, version_id, metadata, force=False ): """ Update the metadata of an image set. :param datastore_id: The ID of the data store. :param image_set_id: The ID of the image set. :param version_id: The ID of the image set version. :param metadata: The image set metadata as a dictionary. For example {"DICOMUpdates": {"updatableAttributes": "{\"SchemaVersion\":1.1,\"Patient\":{\"DICOM\":{\"PatientName\":\"Garcia^Gloria\"}}}"}} :param: force: Force the update. :return: The updated image set metadata. """ try: updated_metadata = self.health_imaging_client.update_image_set_metadata( imageSetId=image_set_id, datastoreId=datastore_id, latestVersionId=version_id, updateImageSetMetadataUpdates=metadata, force=force, ) except ClientError as err: logger.error( "Couldn't update image set metadata. Here's why: %s: %s", err.response["Error"]["Code"], err.response["Error"]["Message"], ) raise else: return updated_metadata次のコードは MedicalImagingWrapper オブジェクトをインスタンス化します。
client = boto3.client("medical-imaging") medical_imaging_wrapper = MedicalImagingWrapper(client)ユースケース #1: 属性を挿入または更新します。
attributes = """{ "SchemaVersion": 1.1, "Study": { "DICOM": { "StudyDescription": "CT CHEST" } } }""" metadata = {"DICOMUpdates": {"updatableAttributes": attributes}} self.update_image_set_metadata( data_store_id, image_set_id, version_id, metadata, force )ユースケース #2: 属性を削除します。
# Attribute key and value must match the existing attribute. attributes = """{ "SchemaVersion": 1.1, "Study": { "DICOM": { "StudyDescription": "CT CHEST" } } }""" metadata = {"DICOMUpdates": {"removableAttributes": attributes}} self.update_image_set_metadata( data_store_id, image_set_id, version_id, metadata, force )ユースケース #3: インスタンスを削除します。
attributes = """{ "SchemaVersion": 1.1, "Study": { "Series": { "1.1.1.1.1.1.12345.123456789012.123.12345678901234.1": { "Instances": { "1.1.1.1.1.1.12345.123456789012.123.12345678901234.1": {} } } } } }""" metadata = {"DICOMUpdates": {"removableAttributes": attributes}} self.update_image_set_metadata( data_store_id, image_set_id, version_id, metadata, force )ユースケース #4: 以前のバージョンに戻します。
metadata = {"revertToVersionId": "1"} self.update_image_set_metadata( data_store_id, image_set_id, version_id, metadata, force )-
API 詳細については、AWS SDK「 Python (Boto3) APIリファレンスUpdateImageSetMetadata」の「」を参照してください。
注記
の詳細については、「」を参照してください GitHub。用例一覧を検索し、AWS コード例リポジトリ
での設定と実行の方法を確認してください。 -
可用性の例
必要なものが見つからなかった場合。このページの下部にあるフィードバックを提供するリンクを使用して、コード例をリクエストします。
画像セットのバージョンを一覧表示する
画像セットのコピー