本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 在中搜索 DICOM 数据 HealthImaging
<a name="dicomweb-search"></a>

AWS HealthImaging 提供 [DicomWeb QIDO-RS](https://www.dicomstandard.org/using/dicomweb/query-qido-rs) API 的表示形式，用于按患者 ID 搜索研究、系列和实例，并接收其唯一标识符以供进一步使用。 HealthImaging的 DicomWeb QIDO-RS API 可以灵活地搜索存储在中的数据， HealthImaging 并提供与传统应用程序的互操作性。

**重要提示**  
HealthImaging的 dicomWeb API 可用于返回图像集信息。 QIDO-RS HealthImaging 除非另有说明，否则 DicomWeb API 仅引用主[图像集](getting-started-concepts.md#concept-image-set)。使用 HealthImaging[云原生操作](https://docs.aws.amazon.com/healthimaging/latest/APIReference/API_Operations.html)或 DicomWeb 操作的可选图像集参数来检索非主图像集。 HealthImaging的 dicomWeb API 可用于返回带有 DICOMweb-conformant 响应的图像集信息。  
本节中列出的 API 符合基于 Web 的医学成像的 dicomWeb (QIDO-RS) 标准。它们不是通过 AWS CLI 和 AWS SDK 提供的。

## 适用于 dicomWeb 的搜索 API HealthImaging
<a name="dicomweb-search-services"></a>

下表描述了可用于在中搜索数据的 DicomWeb QIDO-RS API 的所有 HealthImaging 表示形式。 HealthImaging


**HealthImaging dicomWeb API QIDO-RS 的表示形式**  

| Name | 说明 | 
| --- | --- | 
| SearchDICOMStudies | 使用 GET 请求指定搜索查询元素，在中 HealthImaging 搜索 DICOM 研究。研究搜索结果以 JSON 格式返回，按上次更新排序，日期降序（从最新到最旧）。请参阅[搜索研究](dicomweb-search-studies.md)。 | 
| SearchDICOMSeries | 使用 GET 请求指定搜索查询元素，在中 HealthImaging 搜索 DICOM 系列。系列搜索结果以 JSON 格式返回，按Series Number (0020, 0011)升序排序（从最旧到最新）。请参阅[搜索系列](dicomweb-search-series.md)。 | 
| SearchDICOMInstances | 使用 GET 请求指定搜索查询元素，在中 HealthImaging 搜索 DICOM 实例。实例搜索结果以 JSON 格式返回，按Instance Number (0020, 0013)升序排序（从最旧到最新）。请参阅[搜索实例](dicomweb-search-instances.md)。 | 
| SearchDICOMStudyInstances | 使用 GET 请求指定搜索查询元素，搜索研究中的 HealthImaging 所有 DICOM 实例。API 以 JSON 格式返回实例搜索结果，按上次更新日期降序（从最新到最旧）排序。请参阅[搜索研究的实例](dicomweb-search-study-instances.md)。 | 
| SearchDICOMAllSeries |  HealthImaging 通过使用 GET 请求指定搜索查询元素，在数据存储中搜索所有 DICOM 系列。API 以 JSON 格式返回系列搜索结果，按Series Number (0020,0011)升序排序（从最旧到最新）。请参阅[搜索所有系列](dicomweb-search-all-series.md)。 | 
| SearchDICOMAllInstances |  HealthImaging 通过使用 GET 请求指定搜索查询元素，搜索数据存储中的所有 DICOM 实例。API 以 JSON 格式返回实例搜索结果，按Instance Number (0020,0013)升序排序（从最旧到最新）。请参阅[搜索所有实例](dicomweb-search-all-instances.md)。 | 

## 支持的 DicomWeb 查询类型 HealthImaging
<a name="dicomweb-query-types"></a>

HealthImaging 支持研究、系列和 SOP 实例级别的 QIDO-RS 分层资源查询。使用 QIDO-RS 分层搜索时 HealthImaging：
+ 搜索研究会返回研究列表
+ 搜索研究系列需要已知序列`StudyInstanceUID`并返回系列列表
+ 搜索实例列表需要已知`StudyInstanceUID`和 `SeriesInstanceUID`

使用 HealthImaging，您无需在资源层次结构中指定所有父级 UID 即可运行 QIDO-RS 关系查询：
+ 搜索研究的实例不需要`SeriesInstanceUID`.
+ 在数据存储中搜索所有系列不需要`StudyInstanceUID`.
+ 搜索数据存储中的所有实例不需要`StudyInstanceUID`或`SeriesInstanceUID`。

下表描述了支持在中搜索数据的 QIDO-RS 查询类型 HealthImaging。


**HealthImaging 支持的 QIDO-RS 查询类型**  

| 查询类型 | 示例 | 
| --- | --- | 
| 属性值查询 | 在 “研究” 中搜索所有系列，其中`modality=CT`.<br />`.../studies/1.3.6.1.4.1.14519.5.2.1.6279.6001.101370605276577556143013894866/series?00080060=CT`<br />搜索所有分别以患者身份和研究日期为这些值的研究。<br />`…/studies?PatientID=11235813&StudyDate=20130509` | 
| 关键字查询 | 使用`SeriesInstanceUID`关键字搜索所有系列。<br />`.../studies/1.3.6.1.4.1.14519.5.2.1.6279.6001.101370605276577556143013894866/series?SeriesInstanceUID=1.3.6.1.4.1.14519.5.2.1.6279.6001.101370605276577556143013894868` | 
| 标记查询 | 使用 group/element 表单中传递的查询参数搜索标签。<br />{group} {element} 比如 0020000D | 
| 范围查询 | `...?Modality=CT&StudyDate=AABBYYYY-BBCCYYYY` | 
| 使用和进行分页的limit结果 offset | `.../studies?limit=1&offset=0&00080020=20000101`<br />您可以使用限制和偏移参数对搜索响应进行分页。限制的默认值为 1000，[AWS HealthImaging 终端节点和配额](endpoints-quotas.md)有关最大值，请参阅。<br />最大限制 = 1000，最大偏移量 = 1,000,000 | 
| 通配符查询 | 通配符查询为使用 “\*” 和 “？” 进行搜索提供了更大的灵活性。 “\*” 匹配任何字符序列（包括零长度值）和 “？” 匹配任何单个字符。<br />在 StudyDescription 包含 “Nuclear” 的数据存储中搜索所有研究：<br />`.../studies?StudyDescription=*Nuclear*`<br />搜索所有以 “核” StudyDescription 结尾的研究：<br />`.../studies?StudyDescription=*Nuclear`<br />搜索所有以 “核” StudyDescription 开头的研究：<br />`.../studies?StudyDescription=Nuclear*`<br />搜索所有在 200965981 之后的 patienTid 完全包含任意 3 个字符的研究：<br />`.../studies?PatientID=200965981???` | 
| FuzzyMatching 查询 | 通过添加模糊匹配可选查询参数，启用名称 DICOM 属性（PatientName (0010,0010)、 ReferringPhysicianName (0008,0090)）的模糊匹配：<br />`.../studies?fuzzymatching=true&PatientName="Thomas^Albert"`<br />此查询对值的任何部分执行不区分大小写的前缀字匹配。 PatientName 它返回的结果 PatientName 值包括 “thomas”、“Albert”、“Thomas Albert”、“Thomas^Albert”，但不是 “hom” 或 “ber”。 | 
| IncludeField 查询 | 使用`includefield`查询参数请求默认响应集之外的其他 DICOM 属性。<br />按标签返回特定属性：<br />`.../studies?PatientID=11235813&includefield=00101081&includefield=PatientWeight`<br />返回所有可用属性：<br />`.../studies?PatientID=11235813&includefield=all`<br />使用虚线表示法返回序列 (SQ) 子属性：<br />`.../studies?PatientID=11235813&includefield=00080096.00080100`<br />返回私有数据元素：<br />`.../instances?includefield=00191001&00190010=Philips` | 
| 关系查询 | 在模态为 CT 的数据存储中搜索所有系列：<br />`.../series?Modality=CT`<br />在研究中搜索研究日期为特定值的所有实例：<br />`.../studies/{{StudyInstanceUID}}/instances?StudyDate=20240101` | 

## IncludeField 在 QIDO-RS 查询中使用
<a name="dicomweb-includefield"></a>

`includefield`查询参数允许您请求 HealthImaging QIDO-RS 查询中设置的默认响应之外的其他 DICOM 属性。您可以在研究、系列和实例级别`includefield`上使用。

### 语法
<a name="dicomweb-includefield-syntax"></a>

使用以下 GET 请求格式在 QIDO-RS查询中添加其他字段：

```
GET .../studies?<query_params>&includefield=<tag_or_keyword>
GET .../studies/<StudyInstanceUID>/series?<query_params>&includefield=<tag_or_keyword>
GET .../studies/<StudyInstanceUID>/series/<SeriesInstanceUID>/instances?<query_params>&includefield=<tag_or_keyword>
```

你可以在一个请求中指定多个`includefield`参数：

```
GET .../studies?PatientID=11235813&includefield=00101081&includefield=00101030&includefield=00101010
```

### 包含字段支持的值
<a name="dicomweb-includefield-values"></a>

下表描述了该`includefield`参数支持的值。


**支持的包含字段值**  

| 值类型 | 说明 | 示例 | 
| --- | --- | --- | 
| DICOM 标签（8 个十六进制字符） | 通过 GGGGEEEE 格式的标签请求特定的 DICOM 属性。 | includefield=00081030 | 
| all | 请求资源级别的所有可用的 DICOM 属性。 | includefield=all | 
| 虚线 SQ 路径 | <parent\_tag>使用点表示法请求序列 (SQ) 属性中的特定子属性：。 <child\_tag>。 | includefield=00080096.00080100 | 
| 私有数据元素标签 | 请求私有标签（奇数组元素）。需要privateCreatorElement参数。 | includefield=00191001 | 
| 标准 DICOM 属性，包括批量数据 | 按标签或关键字请求特定的单个或多个属性。 | includefield=00102201 | 

### 行为和规则
<a name="dicomweb-includefield-behavior"></a>

以下规则适用于`includefield`查询：
+ **默认响应**-如果没有`includefield`，则 QIDO-RS 响应仅返回标准属性集。
+ **includefield=al** l — 返回请求级别的所有可用属性。与其他`all``includefield`值组合使用时，`all`优先考虑。
+ **最大标签数**-一个请求最多可以包含 50 个`includefield`参数。
+ **重复标记**-重复`includefield`值会被删除并视为单个请求。
+ **标签无效或缺失**-如果请求的标签在 DICOM 数据中不存在或无效，则会在响应中默默省略该标签。其他有效`includefield`属性仍会返回。

### 序列 (SQ) 属性
<a name="dicomweb-includefield-sq"></a>

使用点表示法请求序列 (SQ) 属性中的嵌套属性：

```
includefield=<parent_SQ_tag>.<child_tag>
```

例如，要在 (0008,0096) 范围内检索 CodeValue (0008,0100)，请执行以下 ReferringPhysicianIdentificationSequence 操作：

```
GET .../studies?PatientID=11235813&includefield=00080096.00080100
```

Multi-level 支持嵌套。例如：

```
includefield=00081115.00081199.00081150
```

### 私有标签
<a name="dicomweb-includefield-private"></a>

所有资源级别都支持私有 DICOM 数据元素（奇数组标签）。要请求私有标签，请添加`privateCreatorElement`查询参数。

使用以下语法：

```
GET .../instances?includefield=<private_tag>&<creator_tag>=<creator_name>
```

例如：

```
GET .../instances?includefield=00191001&00190010=Philips
```

以下规则适用于私有标签：
+ 如果请求私有`privateCreatorElement`标签，则必须将标签和创建者姓名作为匹配参数提供。
+ 如果未找到指定`privateCreatorElement`的，则会默默省略私有标签。
+ 仅请求没有私有数据元素的`privateCreatorElement`标签只会返回创建者元素的名称和值。它不会返回属于该创建者区块的所有标签。

### 批量数据标签
<a name="dicomweb-includefield-bulkdata"></a>

请求的二进制值大于 1 MB 的批量数据 VR（OB、OD、OF、OL、UN、OW、OV）的 DICOM 属性将`includefield`作为原始二进制值`bulkdataURI`而不是原始二进制值返回。[有关检索批量数据的更多信息，请参阅中的检索 DICOM 批量数据。 HealthImaging](https://docs.aws.amazon.com/healthimaging/latest/devguide/dicom-retrieve-bulkdata.html)

### includefield=all 在每个级别返回什么？
<a name="dicomweb-includefield-all-levels"></a>

指定后`includefield=all`，响应将包括特定资源级别的所有属性。

#### 学习等级（包括字段=全部）
<a name="dicomweb-includefield-all-study"></a>

下表列出了指定时`includefield=all`在研究级别返回的所有属性。


**includefield=all 的研究级别属性**  

| Tag | Name | VR | 
| --- | --- | --- | 
| 00080005 | SpecificCharacterSet | CS | 
| 00080020 | StudyDate | DA | 
| 00080030 | StudyTime | TM | 
| 00080050 | AccessionNumber | SH | 
| 00080051 | IssuerOfAccessionNumberSequence | 平方米 | 
| 00080056 | InstanceAvailability | CS | 
| 00080061 | ModalitiesInStudy | CS | 
| 00080062 | SOPClassesInStudy | UI | 
| 00080090 | ReferringPhysicianName | PN | 
| 0008009C | ConsultingPhysicianName | PN | 
| 00080201 | TimezoneOffsetFromUTC | SH | 
| 00081030 | StudyDescription | 哈哈 | 
| 00081048 | PhysiciansOfRecord | PN | 
| 00081060 | NameOfPhysiciansReadingStudy | PN | 
| 00081080 | AdmittingDiagnosesDescription | 哈哈 | 
| 00081190 | 检索网址 | 你的 | 
| 00100010 | PatientName | PN | 
| 00100020 | patienTid | 哈哈 | 
| 00100021 | IssuerOfPatientID | 哈哈 | 
| 00100022 | TypeOfPatientID | CS | 
| 00100026 | SourcePatientGroupIdentificationSequence | 平方米 | 
| 00100027 | GroupOfPatientsIdentificationSequence | 平方米 | 
| 00100028 | SubjectRelativePositionInImage | 美国 | 
| 00100030 | PatientBirthDate | DA | 
| 00100032 | PatientBirthTime | TM | 
| 00100033 | PatientBirthDateInAlternativeCalendar | 哈哈 | 
| 00100034 | PatientDeathDateInAlternativeCalendar | 哈哈 | 
| 00100035 | PatientAlternativeCalendar | CS | 
| 00100040 | PatientSex | CS | 
| 00100050 | PatientInsurancePlanCodeSequence | 平方米 | 
| 00100101 | PatientPrimaryLanguageCodeSequence | 平方米 | 
| 00100102 | PatientPrimaryLanguageModifierCodeSequence | 平方米 | 
| 00100200 | QualityControlSubject | CS | 
| 00100201 | QualityControlSubjectTypeCodeSequence | 平方米 | 
| 00100213 | StrainNomenclature | 哈哈 | 
| 00100214 | StrainStockNumber | 哈哈 | 
| 00100215 | StrainSourceRegistryCodeSequence | 平方米 | 
| 00100217 | StrainSource | 哈哈 | 
| 00100219 | StrainCodeSequence | 平方米 | 
| 00100223 | GeneticModificationsNomenclature | 哈哈 | 
| 00100229 | GeneticModificationsCodeSequence | 平方米 | 
| 00101001 | OtherPatientNames | PN | 
| 00101005 | PatientBirthName | PN | 
| 00101010 | PatientAge | AS | 
| 00101020 | PatientSize | DS | 
| 00101021 | PatientSizeCodeSequence | 平方米 | 
| 00101022 | PatientBodyMassIndex | DS | 
| 00101023 | 测量的 dap 维度 | DS | 
| 00101024 | MeasuredLateralDimension | DS | 
| 00101030 | PatientWeight | DS | 
| 00101040 | PatientAddress | 哈哈 | 
| 00101060 | PatientMotherBirthName | PN | 
| 00101080 | MilitaryRank | 哈哈 | 
| 00101081 | BranchOfService | 哈哈 | 
| 00102000 | MedicalAlerts | 哈哈 | 
| 00102110 | 过敏 | 哈哈 | 
| 00102150 | CountryOfResidence | 哈哈 | 
| 00102152 | RegionOfResidence | 哈哈 | 
| 00102154 | PatientTelephoneNumbers | SH | 
| 00102160 | EthnicGroup | SH | 
| 00102180 | 职业 | SH | 
| 001021A0 | SmokingStatus | CS | 
| 001021C0 | PregnancyStatus | 美国 | 
| 001021D0 | LastMenstrualDate | DA | 
| 001021F0 | PatientReligiousPreference | 哈哈 | 
| 00102201 | PatientSpeciesDescription | 哈哈 | 
| 00102202 | PatientSpeciesCodeSequence | 平方米 | 
| 00102203 | PatientSexNeutered | CS | 
| 00102210 | AnatomicalOrientationType | CS | 
| 00102292 | PatientBreedDescription | 哈哈 | 
| 00102293 | PatientBreedCodeSequence | 平方米 | 
| 00102295 | BreedRegistrationNumber | 哈哈 | 
| 00102296 | BreedRegistryCodeSequence | 平方米 | 
| 00102297 | ResponsiblePerson | PN | 
| 00102298 | ResponsiblePersonRole | CS | 
| 001022999 | ResponsibleOrganization | 哈哈 | 
| 00109431 | ExaminedBodyThickness | FL | 
| 0020000D | StudyInstanceUID | UI | 
| 00200010 | StudyID | SH | 
| 00201206 | NumberOfStudyRelatedSeries | IS | 
| 00201208 | NumberOfStudyRelatedInstances | IS | 
| 00321032 | RequestingPhysician | PN | 
| 00321033 | RequestingService | 哈哈 | 
| 00321060 | RequestedProcedureDescription | 哈哈 | 
| 00321070 | RequestedContrastAgent | 哈哈 | 
| 00380010 | 入学证件 | 哈哈 | 
| 00380016 | RouteOfAdmissions | 哈哈 | 
| 00380020 | AdmittingDate | DA | 
| 00380021 | AdmittingTime | TM | 
| 00380050 | SpecialNeeds | 哈哈 | 
| 00380060 | ServiceEpisode身份证 | 哈哈 | 
| 00380062 | ServiceEpisodeDescription | 哈哈 | 
| 00380300 | CurrentPatientLocation | 哈哈 | 
| 00380400 | PatientInstitutionResidence | 哈哈 | 
| 00380500 | PatientState | 哈哈 | 
| 00400244 | PerformedProcedureStepStartDate | DA | 
| 00400245 | PerformedProcedureStepStartTime | TM | 
| 00400250 | PerformedProcedureStepEndDate | DA | 
| 00400251 | PerformedProcedureStepEndTime | TM | 
| 00400253 | PerformedProcedureStepID | SH | 
| 00081032 | ProcedureCodeSequence | 平方米 | 
| 00100024 | IssuerOfPatientIDQualifiersSequence | 平方米 | 
| 00321034 | RequestingServiceCodeSequence | 平方米 | 
| 00321064 | RequestedProcedureCodeSequence | 平方米 | 
| 00401012 | ReasonForPerformedProcedureCodeSequence | 平方米 | 

#### 系列级别（包含字段=全部）
<a name="dicomweb-includefield-all-series"></a>

下表列出了指定时`includefield=all`返回的系列级属性。系列级别还会返回上表中列出的所有学习级别属性。


**includefield=all 的系列级别属性**  

| Tag | Name | VR | 
| --- | --- | --- | 
| 00080021 | SeriesDate | DA | 
| 00080031 | SeriesTime | TM | 
| 00080060 | 模式 | CS | 
| 00080064 | ConversionType | CS | 
| 00080068 | PresentationIntentType | CS | 
| 00080070 | Manufacturer | 哈哈 | 
| 00080080 | InstitutionName | 哈哈 | 
| 00080082 | InstitutionCodeSequence | 平方米 | 
| 00081010 | StationName | SH | 
| 0008103E | SeriesDescription | 哈哈 | 
| 0008103F | SeriesDescriptionCodeSequence | 平方米 | 
| 00081040 | InstitutionalDepartmentName | 哈哈 | 
| 00081041 | InstitutionalDepartmentTypeCodeSequence | 平方米 | 
| 00081050 | PerformingPhysicianName | PN | 
| 00081070 | OperatorsName | PN | 
| 00081090 | ManufacturerModelName | 哈哈 | 
| 00180010 | ContrastBolusAgent | 哈哈 | 
| 00180015 | BodyPartExamined | CS | 
| 00180050 | SliceThickness | DS | 
| 00180088 | SpacingBetweenSlices | DS | 
| 00181000 | DeviceSerialNumber | 哈哈 | 
| 00181016 | SecondaryCaptureDeviceManufacturer | 哈哈 | 
| 00181018 | SecondaryCaptureDeviceManufacturerModelName | 哈哈 | 
| 00181019 | SecondaryCaptureDeviceSoftwareVersions | 哈哈 | 
| 00181020 | SoftwareVersions | 哈哈 | 
| 00181030 | ProtocolName | 哈哈 | 
| 00181050 | SpatialResolution | DS | 
| 00181200 | DateOfLastCalibration | DA | 
| 00181201 | TimeOfLastCalibration | TM | 
| 00185100 | PatientPosition | CS | 
| 0020000D | StudyInstanceUID | UI | 
| 0020000E | SeriesInstanceUID | UI | 
| 00200011 | SeriesNumber | IS | 
| 00200052 | FrameOfReferenceUID | UI | 
| 00200060 | 横向性 | CS | 
| 00201209 | NumberOfSeriesRelatedInstances | IS | 
| 00540081 | NumberOfSlices | 美国 | 
| 00540101 | NumberOfTimeSlices | 美国 | 
| 00541000 | SeriesType | CS | 

#### 实例级别（包含字段=全部）
<a name="dicomweb-includefield-all-instance"></a>

在实例级别，`includefield=all`返回完整的实例级 DICOM 元数据。这包括存储在实例元数据中的 HealthImaging所有属性。返回该实例的原始 DICOM 文件中存在的每个 DICOM 标签，但像素数据属性除外。

**Topics**
+ [适用于 dicomWeb 的搜索 API HealthImaging](#dicomweb-search-services)
+ [支持的 DicomWeb 查询类型 HealthImaging](#dicomweb-query-types)
+ [IncludeField 在 QIDO-RS 查询中使用](#dicomweb-includefield)
+ [正在搜索 DICOM 的研究 HealthImaging](dicomweb-search-studies.md)
+ [正在搜索 DICOM 系列 HealthImaging](dicomweb-search-series.md)
+ [正在中搜索 DICOM 实例 HealthImaging](dicomweb-search-instances.md)
+ [在中搜索研究的 DICOM 实例 HealthImaging](dicomweb-search-study-instances.md)
+ [正在搜索所有 DICOM 系列 HealthImaging](dicomweb-search-all-series.md)
+ [正在搜索中的所有 DICOM 实例 HealthImaging](dicomweb-search-all-instances.md)