As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
Atualização dos metadados do conjunto de imagens
Use a UpdateImageSetMetadata
ação para atualizar os metadados do conjunto de imagens em AWS HealthImaging. Você pode usar esse processo assíncrono para adicionar, atualizar e remover atributos de metadados do conjunto de imagens, que são manifestações de elementos de DICOM normalização criados durante a importação. Usando a UpdateImageSetMetadata
ação, você também pode remover séries e SOP instâncias para manter os conjuntos de imagens sincronizados com sistemas externos e para desidentificar os metadados do conjunto de imagens. Para obter mais informações, consulte UpdateImageSetMetadata
na AWS HealthImaging APIReferência.
nota
DICOMAs importações do mundo real exigem atualização, adição e remoção de atributos dos metadados do conjunto de imagens. Lembre-se dos seguintes pontos ao atualizar os metadados do conjunto de imagens:
-
A atualização dos metadados do conjunto de imagens cria uma nova versão no histórico do conjunto de imagens. Para obter mais informações, consulte Listando versões do conjunto de imagens. Para reverter para um ID de versão anterior do conjunto de imagens, use o
revertToVersionId
parâmetro opcional. -
A atualização de metadados do conjunto de imagens é um processo assíncrono. Portanto, elementos
imageSetState
deimageSetWorkflowStatus
resposta estão disponíveis para fornecer o respectivo estado e status de um conjunto de imagens em atualização. Você não pode realizar outras operações de gravação em um conjunto deLOCKED
imagens. -
Se a
UpdateImageSetMetadata
ação não for bem-sucedida, ligue e revise o elemento demessage
resposta para vercommon errors
. -
DICOMrestrições de elementos são aplicadas às atualizações de metadados. O parâmetro de
force
solicitação permite que você atualize elementos nos casos em que você deseja DICOMrestrições de metadados substituí-los. Defina o parâmetro de
force
solicitação para forçar a conclusão daUpdateImageSetMetadata
ação. A configuração desse parâmetro permite as seguintes atualizações em um conjunto de imagens:-
Atualizando
Tag.StudyInstanceUID
osTag.StudyID
atributosTag.SeriesInstanceUID
Tag.SOPInstanceUID
,, e -
Adicionar, remover ou atualizar elementos de DICOM dados privados no nível da instância
-
O diagrama a seguir representa os metadados do conjunto de imagens que estão sendo atualizados em HealthImaging.
Para atualizar metadados de um conjunto de imagens
Escolha uma guia com base na sua preferência de acesso AWS HealthImaging a.
- CLI
-
- AWS CLI
-
Exemplo 1: Para inserir ou atualizar um atributo nos metadados do conjunto de imagens
O
update-image-set-metadata
exemplo a seguir insere ou atualiza um atributo nos metadados do conjunto de imagens.aws medical-imaging update-image-set-metadata \ --datastore-id
12345678901234567890123456789012
\ --image-set-idea92b0d8838c72a3f25d00d13616f87e
\ --latest-version-id1
\ --cli-binary-formatraw-in-base64-out
\ --update-image-set-metadata-updatesfile://metadata-updates.json
Conteúdo de
metadata-updates.json
{ "DICOMUpdates": { "updatableAttributes": "{\"SchemaVersion\":1.1,\"Patient\":{\"DICOM\":{\"PatientName\":\"MX^MX\"}}}" } }
Saída:
{ "latestVersionId": "2", "imageSetWorkflowStatus": "UPDATING", "updatedAt": 1680042257.908, "imageSetId": "ea92b0d8838c72a3f25d00d13616f87e", "imageSetState": "LOCKED", "createdAt": 1680027126.436, "datastoreId": "12345678901234567890123456789012" }
Exemplo 2: Para remover um atributo dos metadados do conjunto de imagens
O
update-image-set-metadata
exemplo a seguir remove um atributo dos metadados do conjunto de imagens.aws medical-imaging update-image-set-metadata \ --datastore-id
12345678901234567890123456789012
\ --image-set-idea92b0d8838c72a3f25d00d13616f87e
\ --latest-version-id1
\ --cli-binary-formatraw-in-base64-out
\ --update-image-set-metadata-updatesfile://metadata-updates.json
Conteúdo de
metadata-updates.json
{ "DICOMUpdates": { "removableAttributes": "{\"SchemaVersion\":1.1,\"Study\":{\"DICOM\":{\"StudyDescription\":\"CHEST\"}}}" } }
Saída:
{ "latestVersionId": "2", "imageSetWorkflowStatus": "UPDATING", "updatedAt": 1680042257.908, "imageSetId": "ea92b0d8838c72a3f25d00d13616f87e", "imageSetState": "LOCKED", "createdAt": 1680027126.436, "datastoreId": "12345678901234567890123456789012" }
Exemplo 3: Para remover uma instância dos metadados do conjunto de imagens
O
update-image-set-metadata
exemplo a seguir remove uma instância dos metadados do conjunto de imagens.aws medical-imaging update-image-set-metadata \ --datastore-id
12345678901234567890123456789012
\ --image-set-idea92b0d8838c72a3f25d00d13616f87e
\ --latest-version-id1
\ --cli-binary-formatraw-in-base64-out
\ --update-image-set-metadata-updatesfile://metadata-updates.json
Conteúdo de
metadata-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\": {}}}}}}" } }
Saída:
{ "latestVersionId": "2", "imageSetWorkflowStatus": "UPDATING", "updatedAt": 1680042257.908, "imageSetId": "ea92b0d8838c72a3f25d00d13616f87e", "imageSetState": "LOCKED", "createdAt": 1680027126.436, "datastoreId": "12345678901234567890123456789012" }
Exemplo 4: Para reverter um conjunto de imagens para uma versão anterior
O
update-image-set-metadata
exemplo a seguir mostra como reverter um conjunto de imagens para uma versão anterior. CopyImageSet e UpdateImageSetMetadata as ações criam novas versões dos conjuntos de imagens.aws medical-imaging update-image-set-metadata \ --datastore-id
12345678901234567890123456789012
\ --image-set-id53d5fdb05ca4d46ac7ca64b06545c66e
\ --latest-version-id3
\ --cli-binary-formatraw-in-base64-out
\ --update-image-set-metadata-updates '{"revertToVersionId": "1"}
'Saída:
{ "datastoreId": "12345678901234567890123456789012", "imageSetId": "53d5fdb05ca4d46ac7ca64b06545c66e", "latestVersionId": "4", "imageSetState": "LOCKED", "imageSetWorkflowStatus": "UPDATING", "createdAt": 1680027126.436, "updatedAt": 1680042257.908 }
Exemplo 5: Para adicionar um elemento DICOM de dados privado a uma instância
O
update-image-set-metadata
exemplo a seguir mostra como adicionar um elemento privado a uma instância especificada em um conjunto de imagens. O DICOM padrão permite elementos de dados privados para comunicação de informações que não podem estar contidas em elementos de dados padrão. Você pode criar, atualizar e excluir elementos de dados privados com a UpdateImageSetMetadata ação.aws medical-imaging update-image-set-metadata \ --datastore-id
12345678901234567890123456789012
\ --image-set-id53d5fdb05ca4d46ac7ca64b06545c66e
\ --latest-version-id1
\ --cli-binary-formatraw-in-base64-out
\ --force \ --update-image-set-metadata-updatesfile://metadata-updates.json
Conteúdo de
metadata-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\"}}}}}}}" } }
Saída:
{ "latestVersionId": "2", "imageSetWorkflowStatus": "UPDATING", "updatedAt": 1680042257.908, "imageSetId": "53d5fdb05ca4d46ac7ca64b06545c66e", "imageSetState": "LOCKED", "createdAt": 1680027126.436, "datastoreId": "12345678901234567890123456789012" }
Exemplo 6: Para atualizar um elemento DICOM de dados privado em uma instância
O
update-image-set-metadata
exemplo a seguir mostra como atualizar o valor de um elemento de dados privado pertencente a uma instância em um conjunto de imagens.aws medical-imaging update-image-set-metadata \ --datastore-id
12345678901234567890123456789012
\ --image-set-id53d5fdb05ca4d46ac7ca64b06545c66e
\ --latest-version-id1
\ --cli-binary-formatraw-in-base64-out
\ --force \ --update-image-set-metadata-updatesfile://metadata-updates.json
Conteúdo de
metadata-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\"}}}}}}}" } }
Saída:
{ "latestVersionId": "2", "imageSetWorkflowStatus": "UPDATING", "updatedAt": 1680042257.908, "imageSetId": "53d5fdb05ca4d46ac7ca64b06545c66e", "imageSetState": "LOCKED", "createdAt": 1680027126.436, "datastoreId": "12345678901234567890123456789012" }
Exemplo 7: Para atualizar a SOPInstanceUID com o parâmetro force
O
update-image-set-metadata
exemplo a seguir mostra como atualizar umSOPInstanceUID, usando o parâmetro force para substituir as restrições de DICOM metadados.aws medical-imaging update-image-set-metadata \ --datastore-id
12345678901234567890123456789012
\ --image-set-id53d5fdb05ca4d46ac7ca64b06545c66e
\ --latest-version-id1
\ --cli-binary-formatraw-in-base64-out
\ --force \ --update-image-set-metadata-updatesfile://metadata-updates.json
Conteúdo de
metadata-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\"}}}}}}}" } }
Saída:
{ "latestVersionId": "2", "imageSetWorkflowStatus": "UPDATING", "updatedAt": 1680042257.908, "imageSetId": "53d5fdb05ca4d46ac7ca64b06545c66e", "imageSetState": "LOCKED", "createdAt": 1680027126.436, "datastoreId": "12345678901234567890123456789012" }
Para obter mais informações, consulte Atualização dos metadados do conjunto de imagens no Guia do AWS HealthImaging desenvolvedor.
-
Para API obter detalhes, consulte UpdateImageSetMetadata
na Referência de AWS CLI Comandos.
-
- Java
-
- SDKpara 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; } }
Caso de uso #1: insira ou atualize um atributo.
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);
Caso de uso #2: Remova um atributo.
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);
Caso de uso #3: remova uma instância.
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);
Caso de uso #4: reverta para uma versão anterior.
// 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);
-
Para API obter detalhes, consulte UpdateImageSetMetadataem AWS SDK for Java 2.x APIReferência.
nota
Tem mais sobre GitHub. Encontre o exemplo completo e saiba como configurar e executar no Repositório de exemplos de código da AWS
. -
- JavaScript
-
- SDKpara 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); } };
Caso de uso #1: insira ou atualize um atributo e force a atualização.
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, );
Caso de uso #2: Remova um atributo.
// 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, );
Caso de uso #3: remova uma instância.
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, );
Caso de uso #4: reverta para uma versão anterior.
const updateMetadata = { revertToVersionId: "1", }; await updateImageSetMetadata( datastoreID, imageSetID, versionID, updateMetadata, );
-
Para API obter detalhes, consulte UpdateImageSetMetadataem AWS SDK for JavaScript APIReferência.
nota
Tem mais sobre GitHub. Encontre o exemplo completo e saiba como configurar e executar no Repositório de exemplos de código da AWS
. -
- Python
-
- SDKpara 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
O código a seguir instancia o MedicalImagingWrapper objeto.
client = boto3.client("medical-imaging") medical_imaging_wrapper = MedicalImagingWrapper(client)
Caso de uso #1: insira ou atualize um atributo.
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 )
Caso de uso #2: Remova um atributo.
# 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 )
Caso de uso #3: remova uma instância.
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 )
Caso de uso #4: reverta para uma versão anterior.
metadata = {"revertToVersionId": "1"} self.update_image_set_metadata( data_store_id, image_set_id, version_id, metadata, force )
-
Para API obter detalhes, consulte a UpdateImageSetMetadataReferência AWS SDK do Python (Boto3). API
nota
Tem mais sobre GitHub. Encontre o exemplo completo e saiba como configurar e executar no Repositório de exemplos de código da AWS
. -
Exemplo de disponibilidade
Você não consegue encontrar o que precisa? Solicite um exemplo de código usando o link Fornecer feedback na parte inferior desta página.