$member-remove HealthLake の オペレーション - AWS HealthLake
前提条件オペレーションの詳細パラメータリクエストの例応答行動エラー処理ベストプラクティス

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

$member-remove HealthLake の オペレーション

$member-remove オペレーションでは、FHIR メンバー属性リスト (グループリソース) からメンバーを削除できます AWS HealthLake。このオペレーションは DaVinci メンバー属性実装ガイドの一部であり、メンバー属性を管理するための調整プロセスをサポートしています。

前提条件

  • AWS HealthLake FHIR データストア

  • HealthLake オペレーションの適切な IAM アクセス許可

  • ドラフトステータスまたはオープンステータスのメンバー属性リスト (グループリソース)

オペレーションの詳細

Endpoint

POST /Group/{id}/$member-remove

コンテンツタイプ

application/fhir+json

パラメータ

オペレーションは、以下のオプションパラメータを持つ FHIR Parameters リソースを受け入れます。

パラメータ カーディナリティ 型 説明
memberId 0..1 識別子 削除するメンバーのビジネス識別子
providerNpi 0..1 識別子 属性プロバイダーの NPI
patientReference 0..1 リファレンス 患者リソースへの直接参照
providerReference 0..1 リファレンス プロバイダーリソース (Practitioner、PractitionerRole、または Organization) への直接参照
coverageReference 0..1 リファレンス カバレッジリソースへの参照

サポートされているパラメータの組み合わせ

以下のパラメータの組み合わせがサポートされています。

  • memberId only - 指定されたメンバーのすべての属性を削除します

  • memberId + providerNpi - 特定のメンバーとプロバイダーの組み合わせの属性を削除します

  • patientReference のみ - 指定された患者のすべての属性を削除します

  • patientReference + providerReference - 特定の患者とプロバイダーの組み合わせの属性を削除します

  • patientReference + providerReference + coverageReference - 患者、プロバイダー、カバレッジに基づいて特定の属性を削除します

リクエストの例

{
  "resourceType": "Parameters",
  "parameter": [
    {
      "name": "patientReference",
      "valueReference": {
        "reference": "Patient/12345"
      }
    },
    {
      "name": "providerReference",
      "valueReference": {
        "reference": "Practitioner/67890"
      }
    }
  ]
}

応答

成功したレスポンス

{
  "resourceType": "Parameters",
  "parameter": [
    {
      "name": "result",
      "valueBoolean": true
    },
    {
      "name": "effectiveDate",
      "valueDate": "2024-06-30"
    },
    {
      "name": "status",
      "valueCode": "inactive"
    },
    {
      "name": "message",
      "valueString": "Member successfully removed from attribution list"
    }
  ]
}

行動

ステータス要件

オペレーションは、ステータスが draftまたは の属性リストでのみ機能します。 open

final ステータスが のリストは、422 エラーのオペレーションを拒否します

メンバーの削除プロセス

ステータスリストのドラフト: メンバーは非アクティブ (inactive: true) としてマークされ、changeType拡張機能は に更新されます changed

オープンステータスリスト: ドラフトステータスと同様の動作

最終ステータスリスト: オペレーションが拒否されました

検証

リファレンスはHealthLake データストアに存在することを確認するために検証されます。

識別子と参照の両方が同じリソースタイプに提供される場合、それらは同じリソースに対応する必要があります

パラメータの組み合わせは、サポートされているパターンに従って検証されます。

エラー処理

一般的なエラーレスポンス

リソースが見つかりません (404)
{
  "resourceType": "OperationOutcome",
  "issue": [
    {
      "severity": "error",
      "code": "not-found",
      "details": {
        "text": "Patient with identifier 'http://example.org/fhir/identifiers|99999' not found in system"
      },
      "diagnostics": "Cannot remove member from attribution list. Verify patient identifier and try again.",
      "expression": ["memberId"]
    }
  ]
}
属性リストの最終ステータス (422)
{
  "resourceType": "OperationOutcome",
  "issue": [
    {
      "severity": "error",
      "code": "business-rule",
      "details": {
        "coding": [
          {
            "system": "http://hl7.org/fhir/us/davinci-atr/CodeSystem/atr-error-codes",
            "code": "list-final",
            "display": "Attribution list is final and cannot be modified"
          }
        ]
      },
      "diagnostics": "Cannot modify attribution list with status 'final'. List modifications are not permitted after finalization.",
      "expression": ["Group.status"]
    }
  ]
}
無効なオペレーション (400)

パラメータの組み合わせが無効または形式が正しくない場合に返されます。

複数の一致が見つかりました (412)

指定されたパラメータが属性リスト内の複数のメンバーと一致する場合に返されます。

{
  "resourceType": "OperationOutcome",
  "issue": [
    {
      "severity": "error",
      "code": "processing",
      "diagnostics": "Multiple members found matching the criteria"
    }
  ]
}

ベストプラクティス

  • 特定のパラメータを使用する: 可能な場合は、最も具体的なパラメータの組み合わせを使用して、意図しない削除を回避します。

  • リストステータスのチェック: 削除を試みる前に属性リストのステータスを確認します

  • エラーを適切に処理する: 考えられるすべてのエラー条件に対して適切なエラー処理を実装する

  • リファレンスの検証: リクエストを実行する前に、参照されるすべてのリソースが存在することを確認します。