翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。 # HealthImaging での DICOM データの検索 AWS HealthImaging は、[DICOMweb の "DO-RS](https://www.dicomstandard.org/using/dicomweb/query-qido-rs) APIs の表現を提供し、患者 ID で検査、シリーズ、インスタンスを検索し、さらに使用するための一意の識別子を受け取ります。HealthImaging の DICOMweb "DO-RS APIsは、HealthImaging に保存されているデータを検索する方法に柔軟性を提供し、レガシーアプリケーションとの相互運用性を提供します。 **[重要]** HealthImaging の DICOMweb APIs を使用して、画像セット情報を "DO-RS で返すことができます。HealthImaging DICOMweb APIs、特に明記されていない限り、プライマリ[イメージセット](getting-started-concepts.md#concept-image-set)のみを参照します。HealthImaging [クラウドネイティブアクション、](https://docs.aws.amazon.com/healthimaging/latest/APIReference/API_Operations.html)または DICOMweb アクションのオプションの画像セットパラメータを使用して、非プライマリ画像セットを取得します。HealthImaging の DICOMweb APIs を使用して、DICOMweb 準拠のレスポンスで画像セット情報を返すことができます。 HealthImaging DICOMweb "DO-RS アクションは、最大 10,000 件のレコードを返すことができます。10,000 を超えるリソースが存在する場合、これらは "DO-RS アクションでは取得できませんが、DICOMweb WADO-RS アクションまたは[クラウドネイティブアクション](https://docs.aws.amazon.com/healthimaging/latest/APIReference/API_Operations.html)で取得できます。 このセクションに記載されている APIs は、ウェブベースの医療画像用の DICOMweb ("DO-RS) 標準に準拠して構築されています。 AWS CLI および AWS SDKs では提供されません。 ## HealthImaging の DICOMweb 検索 APIs 次の表は、HealthImaging でデータを検索するために使用できる DICOMweb の "DO-RS APIs のすべての HealthImaging 表現を示しています。 **HealthImaging による DICOMweb "DO-RS APIsの表現** | 名前 | 説明 | | --- | --- | | 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)」を参照してください。 | ## HealthImaging でサポートされている DICOMweb クエリタイプ HealthImaging は、治験、シリーズ、SOP インスタンスレベルで "DO-RS 階層型リソースクエリをサポートしています。HealthImaging に "DO-RS 階層検索を使用する場合: + スタディを検索すると、スタディのリストが返されます。 + 研究のシリーズを検索するには、既知の が必要`StudyInstanceUID`で、シリーズのリストを返します。 + インスタンスのリストを検索するには、既知の `StudyInstanceUID`と `SeriesInstanceUID` 次の表は、HealthImaging でデータを検索するためにサポートされている "DO-RS 階層クエリタイプを示しています。 **HealthImaging でサポートされている "DO-RS クエリタイプ** | クエリタイプ | 例 | | --- | --- | | 属性値クエリ | 「」のスタディ内のすべてのシリーズを検索します`modality=CT`。
`.../studies/1.3.6.1.4.1.14519.5.2.1.6279.6001.101370605276577556143013894866/series?00080060=CT`
患者 ID と検査日がそれぞれこれらの値であるすべての検査を検索します。
`…/studies?PatientID=11235813&StudyDate=20130509` | | キーワードクエリ | `SeriesInstanceUID` キーワードを使用してすべてのシリーズを検索します。
`.../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` | | タグクエリ | グループ/要素フォームで渡されたクエリパラメータを使用してタグを検索します。
0020000D のような {group}{element} | | 範囲クエリ | `...?Modality=CT&StudyDate=AABBYYYY-BBCCYYYY` | | limit および を使用した結果のページング offset | `.../studies?limit=1&offset=0&00080020=20000101`
制限パラメータとオフセットパラメータを使用して、検索レスポンスをページ分割できます。制限のデフォルト値は 1000 です。最大値[AWS HealthImagingエンドポイントとクォータ](endpoints-quotas.md)については、「」を参照してください。
最大制限 = 1000、最大オフセット = 9000 | | ワイルドカードクエリ | ワイルドカードクエリは、「\*」と「？」を使用した検索の柔軟性を高めます。「\*」は、任意の文字シーケンス (長さがゼロの値を含む) と「？」と一致します。 は任意の 1 文字に一致します。
StudyDescription に「Nuclear」が含まれているデータストア内のすべての研究を検索します。
`.../studies?StudyDescription=*Nuclear*`
StudyDescription が「Nuclear」で終わるすべての研究を検索します。
`.../studies?StudyDescription=*Nuclear`
StudyDescription が「Nuclear」で始まるすべての研究を検索します。
`.../studies?StudyDescription=Nuclear*`
PatientID が 200965981 の後に 3 文字のみを持つすべての検査を検索します。
`.../studies?PatientID=200965981???` | | FuzzyMatching クエリ | fuzzymatching オプションクエリパラメータを追加して、名前 DICOM 属性 (PatientName (0010,0010)、ReferringPhysicianName(0008,0090)) であいまい一致を有効にします。
`.../studies?fuzzymatching=true&PatientName="Thomas^Albert"`
このクエリは、 PatientName 値の任意の部分で大文字と小文字を区別しないプレフィックス単語マッチングを実行します。「thomas」、「Albert」、「Thomas Albert」、「Thomas^Albert」などの PatientName 値の結果を返しますが、「hom」や「ber」は返しません。 | | IncludeField クエリ | `includefield` クエリパラメータを使用して、デフォルトのレスポンスセット以外の追加の DICOM 属性をリクエストします。
タグで特定の属性を返します。
`.../studies?PatientID=11235813&includefield=00101081&includefield=PatientWeight`
使用可能なすべての属性を返します。
`.../studies?PatientID=11235813&includefield=all`
ドット表記を使用してシーケンス (SQ) サブ属性を返します。
`.../studies?PatientID=11235813&includefield=00080096.00080100`
プライベートデータ要素を返します。
`.../instances?includefield=00191001&00190010=Philips` | ## "DO-RS クエリでの IncludeField の使用 `includefield` クエリパラメータを使用すると、HealthImaging の "DO-RS クエリのデフォルトレスポンスセットを超える追加の DICOM 属性をリクエストできます。は、調査`includefield`、シリーズ、インスタンスレベルで使用できます。 ### 構文 次の GET リクエスト形式を使用して、OktaDO-RS クエリに追加のフィールドを含めます。 ``` GET .../studies?&includefield= GET .../studies//series?&includefield= GET .../studies//series//instances?&includefield= ``` 1 つのリクエストで複数の`includefield`パラメータを指定できます。 ``` GET .../studies?PatientID=11235813&includefield=00101081&includefield=00101030&includefield=00101010 ``` ### includefield でサポートされている値 次の表に、 `includefield`パラメータでサポートされている値を示します。 **サポートされているインクルードフィールド値** | 値の型 | 説明 | 例 | | --- | --- | --- | | DICOM タグ (8 進数文字) | GGGGEEEE 形式のタグで特定の DICOM 属性をリクエストします。 | includefield=00081030 | | all | リソースレベルで使用可能なすべての DICOM 属性をリクエストします。 | includefield=all | | ドット付き SQ パス | ドット表記: . を使用して Sequence (SQ) 属性内の特定のサブ属性をリクエストします。 | includefield=00080096.00080100 | | プライベートデータ要素タグ | プライベートタグ (odd-group 要素) をリクエストします。privateCreatorElement パラメータが必要です。 | includefield=00191001 | | bulkdata を含む標準 DICOM 属性 | タグまたはキーワードで特定の単一または複数の属性をリクエストします。 | includefield=00102201 | ### 動作とルール `includefield` クエリには、次のルールが適用されます。 + **デフォルトのレスポンス** – がない場合`includefield`、 の "DO-RS レスポンスは標準の属性セットのみを返します。 + **includefield=all** – リクエストされたレベルで使用可能なすべての属性を返します。`all` が他の`includefield`値と組み合わせると、 が優先`all`されます。 + **最大タグ** – リクエストには最大 50 個の`includefield`パラメータを含めることができます。 + **重複タグ** – 重複した`includefield`値は重複排除され、単一のリクエストとして扱われます。 + **無効なタグまたは欠落**しているタグ – リクエストされたタグが DICOM データに存在しないか、無効である場合、レスポンスからサイレントに省略されます。その他の有効な`includefield`属性は引き続き返されます。 ### シーケンス (SQ) 属性 ドット表記を使用して、シーケンス (SQ) 属性内のネストされた属性をリクエストします。 ``` includefield=. ``` 例えば、 ReferringPhysicianIdentificationSequence (0008,0096) 内で CodeValue (0008,0100) を取得するには: ``` GET .../studies?PatientID=11235813&includefield=00080096.00080100 ``` マルチレベルネストがサポートされています。例えば、次のようになります。 ``` includefield=00081115.00081199.00081150 ``` ### プライベートタグ プライベート DICOM データ要素 (odd-group タグ) は、すべてのリソースレベルでサポートされています。プライベートタグをリクエストするには、 `privateCreatorElement`クエリパラメータを含めます。 次の構文を使用します。 ``` GET .../instances?includefield=&= ``` 例えば、次のようになります。 ``` GET .../instances?includefield=00191001&00190010=Philips ``` プライベートタグには、次のルールが適用されます。 + プライベート`privateCreatorElement`タグがリクエストされた場合は、タグと作成者名を一致パラメータとして指定する必要があります。 + 指定された `privateCreatorElement`が見つからない場合、プライベートタグはサイレントに省略されます。 + プライベートデータ要素のない`privateCreatorElement`タグのみをリクエストすると、作成者要素の名前と値のみが返されます。その作成者の ブロックに属するすべてのタグを返すわけではありません。 ### バルクデータタグ の一部としてリクエストされたバイナリ値が 1 MB を超えるバルクデータ VRs (OB、OD、OF、OL、UN、OW、OV) を持つ DICOM 属性`includefield`は、raw バイナリ値`bulkdataURI`の代わりに として返されます。バルクデータの取得の詳細については、[HealthImaging での DICOM バルクデータの取得](https://docs.aws.amazon.com/healthimaging/latest/devguide/dicom-retrieve-bulkdata.html)」を参照してください。 ### includefield=all は各レベルで何を返しますか? `includefield=all` を指定すると、レスポンスには特定のリソースレベルのすべての属性が含まれます。 #### 研究レベル (includefield=all) 次の表は、 が指定されているときに治験レベルで返されるすべての属性の一覧`includefield=all`です。 **includefield=all の治験レベルの属性** | タグ | 名前 | VR | | --- | --- | --- | | 00080005 | SpecificCharacterSet | CS | | 00080020 | StudyDate | DA | | 00080030 | StudyTime | TM | | 00080050 | AccessionNumber | SH | | 00080051 | IssuerOfAccessionNumberSequence | SQ | | 00080056 | InstanceAvailability | CS | | 00080061 | ModalitiesInStudy | CS | | 00080062 | SOPClassesInStudy | UI | | 00080090 | ReferringPhysicianName | PN | | 0008009C | ConsultingPhysicianName | PN | | 00080201 | TimezoneOffsetFromUTC | SH | | 00081030 | StudyDescription | LO | | 00081048 | PhysiciansOfRecord | PN | | 00081060 | NameOfPhysiciansReadingStudy | PN | | 00081080 | AdmittingDiagnosesDescription | LO | | 00081190 | RetrieveURL | UR | | 00100010 | PatientName | PN | | 00100020 | PatientID | LO | | 00100021 | IssuerOfPatientID | LO | | 00100022 | TypeOfPatientID | CS | | 00100026 | SourcePatientGroupIdentificationSequence | SQ | | 00100027 | GroupOfPatientsIdentificationSequence | SQ | | 00100028 | SubjectRelativePositionInImage | 米国 | | 00100030 | PatientBirthDate | DA | | 00100032 | PatientBirthTime | TM | | 00100033 | PatientBirthDateInAlternativeCalendar | LO | | 00100034 | PatientDeathDateInAlternativeCalendar | LO | | 00100035 | PatientAlternativeCalendar | CS | | 00100040 | PatientSex | CS | | 00100050 | PatientInsurancePlanCodeSequence | SQ | | 00100101 | PatientPrimaryLanguageCodeSequence | SQ | | 00100102 | PatientPrimaryLanguageModifierCodeSequence | SQ | | 00100200 | QualityControlSubject | CS | | 00100201 | QualityControlSubjectTypeCodeSequence | SQ | | 00100213 | StrainNomenclature | LO | | 00100214 | StrainStockNumber | LO | | 00100215 | StrainSourceRegistryCodeSequence | SQ | | 00100217 | StrainSource | LO | | 00100219 | StrainCodeSequence | SQ | | 00100223 | GeneticModificationsNomenclature | LO | | 00100229 | GeneticModificationsCodeSequence | SQ | | 00101001 | OtherPatientNames | PN | | 00101005 | PatientBirthName | PN | | 00101010 | PatientAge | AS | | 00101020 | PatientSize | DS | | 00101021 | PatientSizeCodeSequence | SQ | | 00101022 | PatientBodyMassIndex | DS | | 00101023 | MeasuredAPDimension | DS | | 00101024 | MeasuredLateralDimension | DS | | 00101030 | PatientWeight | DS | | 00101040 | PatientAddress | LO | | 00101060 | PatientMotherBirthName | PN | | 00101080 | MilitaryRank | LO | | 00101081 | BranchOfService | LO | | 00102000 | MedicalAlerts | LO | | 00102110 | アラート | LO | | 00102150 | CountryOfResidence | LO | | 00102152 | RegionOfResidence | LO | | 00102154 | PatientTelephoneNumbers | SH | | 00102160 | EthnicGroup | SH | | 00102180 | 占領 | SH | | 001021A0 | SmokingStatus | CS | | 001021C0 | PregnancyStatus | 米国 | | 001021D0 | LastMenstrualDate | DA | | 001021F0 | PatientReligiousPreference | LO | | 00102201 | PatientSpeciesDescription | LO | | 00102202 | PatientSpeciesCodeSequence | SQ | | 00102203 | PatientSexNeutered | CS | | 00102210 | AnatomicalOrientationType | CS | | 00102292 | PatientBreedDescription | LO | | 00102293 | PatientBreedCodeSequence | SQ | | 00102295 | BreedRegistrationNumber | LO | | 00102296 | BreedRegistryCodeSequence | SQ | | 00102297 | ResponsiblePerson | PN | | 00102298 | ResponsiblePersonRole | CS | | 00102299 | ResponsibleOrganization | LO | | 00109431 | ExaminedBodyThickness | FL | | 0020000D | StudyInstanceUID | UI | | 00200010 | StudyID | SH | | 00201206 | NumberOfStudyRelatedSeries | IS | | 00201208 | NumberOfStudyRelatedInstances | IS | | 00321032 | RequestingPhysician | PN | | 00321033 | RequestingService | LO | | 00321060 | RequestedProcedureDescription | LO | | 00321070 | RequestedContrastAgent | LO | | 00380010 | AdmissionID | LO | | 00380016 | RouteOfAdmissions | LO | | 00380020 | AdmittingDate | DA | | 00380021 | AdmittingTime | TM | | 00380050 | SpecialNeeds | LO | | 00380060 | ServiceEpisodeID | LO | | 00380062 | ServiceEpisodeDescription | LO | | 00380300 | CurrentPatientLocation | LO | | 00380400 | PatientInstitutionResidence | LO | | 00380500 | PatientState | LO | | 00400244 | PerformedProcedureStepStartDate | DA | | 00400245 | PerformedProcedureStepStartTime | TM | | 00400250 | PerformedProcedureStepEndDate | DA | | 00400251 | PerformedProcedureStepEndTime | TM | | 00400253 | PerformedProcedureStepID | SH | | 00081032 | ProcedureCodeSequence | SQ | | 00100024 | IssuerOfPatientIDQualifiersSequence | SQ | | 00321034 | RequestingServiceCodeSequence | SQ | | 00321064 | RequestedProcedureCodeSequence | SQ | | 00401012 | ReasonForPerformedProcedureCodeSequence | SQ | #### シリーズレベル (includefield=all) 次の表に、 を指定したときに返`includefield=all`されるシリーズレベルの属性を示します。シリーズレベルは、前の表にリストされているすべての治験レベルの属性も返します。 **includefield=all のシリーズレベルの属性** | タグ | 名前 | VR | | --- | --- | --- | | 00080021 | SeriesDate | DA | | 00080031 | SeriesTime | TM | | 00080060 | モダリティ | CS | | 00080064 | ConversionType | CS | | 00080068 | PresentationIntentType | CS | | 00080070 | Manufacturer | LO | | 00080080 | InstitutionName | LO | | 00080082 | InstitutionCodeSequence | SQ | | 00081010 | StationName | SH | | 0008103E | SeriesDescription | LO | | 0008103F | SeriesDescriptionCodeSequence | SQ | | 00081040 | InstitutionalDepartmentName | LO | | 00081041 | InstitutionalDepartmentTypeCodeSequence | SQ | | 00081050 | PerformingPhysicianName | PN | | 00081070 | OperatorsName | PN | | 00081090 | ManufacturerModelName | LO | | 00180010 | ContrastBolusAgent | LO | | 00180015 | BodyPartExamined | CS | | 00180050 | SliceThickness | DS | | 00180088 | SpacingBetweenSlices | DS | | 00181000 | DeviceSerialNumber | LO | | 00181016 | SecondaryCaptureDeviceManufacturer | LO | | 00181018 | SecondaryCaptureDeviceManufacturerModelName | LO | | 00181019 | SecondaryCaptureDeviceSoftwareVersions | LO | | 00181020 | SoftwareVersions | LO | | 00181030 | ProtocolName | LO | | 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 | #### インスタンスレベル (includefield=all) インスタンスレベルでは、 はインスタンスレベルの DICOM メタデータ全体`includefield=all`を返します。これには、HealthImaging ストレージのインスタンスメタデータに保存されているすべての属性が含まれます。ピクセルデータ属性を除く、そのインスタンスの元の DICOM ファイルに存在するすべての DICOM タグが返されます。 **Topics** + [HealthImaging の DICOMweb 検索 APIs](#dicomweb-search-services) + [HealthImaging でサポートされている DICOMweb クエリタイプ](#dicomweb-query-types) + ["DO-RS クエリでの IncludeField の使用](#dicomweb-includefield) + [HealthImaging での DICOM 検査の検索](dicomweb-search-studies.md) + [HealthImaging での DICOM シリーズの検索](dicomweb-search-series.md) + [HealthImaging での DICOM インスタンスの検索](dicomweb-search-instances.md)