SDA ドキュメント

SDA ドキュメントの基本的な XML 構造

SDA ドキュメントの主要セクションは以下のようになっています。

<Container>
  <Patient/>
  <Encounters/>
  <AdvanceDirectives/>
  <Alerts/>
  <Allergies/>
  <Appointments/>
  <Problems/>
  <Diagnoses/>
  <Documents/>
  <LabOrders/>
  <RadOrders/>
  <OtherOrders/>
  <Medications/>
  <Vaccinations/>
  <Observations/>
  <PhysicalExams/>
  <Procedures/>
  <FamilyHistories/>
  <IllnessHistories/>
  <SocialHistories/>
  <CustomObjects/>
  <Referrals/>
  <ClinicalRelationships/>
  <ProgramMemberships/>
  <MemberEnrollments/>
  <MedicalClaims/>
  <GenomicsOrders/>
  <CarePlans/>
  <HealthConcerns/>
  <Goals/>
  <SocialDeterminants/>
</Container>

SDA ドキュメントには以下の規則が適用されます。

1. <Patient> は 1 つだけです。

2. <Patient> は必須で、最初に記述するセクションである必要があります (<Action>、<EventDescription>、<SendingFacility> などの <Container> のプロパティの後に記述します。具体的な詳細は、クラス・リファレンスを参照してください)。

3. <Patient> 以外のセクションはすべてオプションです。

4. <Patient> 以外のすべてのセクションには、複数のエントリを含めることができます。以下に例を示します。

   <Procedures>
   
      <Procedure>
           ...
      </Procedure>
   
      <Procedure>
           ...
      </Procedure>
   
   </Procedures>

   

5. <Encounters> セクション (存在する場合) は、<Patient> セクションの直後に記述する必要があります。

6. その他のセクションはすべて任意の順番で記述できます。

7. いずれのエントリも、オプションで Encounter 番号を参照できます。この場合、<Encounters> を含め、そこに <Encounter> とその <EncounterNumber> を含める必要があります。

8. 一部のセクションでは、<ActionCode> または <ActionScope> を含めて、永続性に関して何らかのアクションを実行するよう指定することもできます。HealthShare Unified Care Record では、これらの要素によって、SDA の保存時にアクションを実行するようシステムに指示しますが、InterSystems IRIS for Health では、永続化された SDA に対してアクションを実行するようユーザが指示できます。例えば、<ActionCode> の D は、Unified Care Record から、一致するエントリを削除します。SDA の各セクションに関する具体的な詳細は、クラスリファレンスを参照してください。

SDA オブジェクトからの SDA ストリームの作成

複数の SDA オブジェクトがあり、それらをまとめて 1 つの SDA ストリームを生成する場合は、以下の手法を使用します。

1. 新規ストリームをインスタンス化します。

2. <Container> 開始タグをストリームに記述します。

3. Patient オブジェクトは最初に記述する必要があり、SDA オブジェクトの ToQuickXML()Opens in a new tab メソッドを使用して、XML としてストリームに記述します。

4. 以降のオブジェクトはタイプ別 (Encounter、LabOrder など) にグループにする必要があり、SDA オブジェクトの StartXMLList()Opens in a new tab メソッドを使用して、そのコレクションの開始タグを記述します。例 ： <Encounters>。<Encounters> を含める場合、<Patient> の直後に配置する必要があることに注意してください。

5. ToQuickXML()Opens in a new tab メソッドを使用して、そのタイプの各オブジェクトをストリームに記述します。

6. 特定のタイプのコレクションの記述が完了したら、EndXMLList()Opens in a new tab メソッドを使用して、コレクションの終了タグを記述します。

7. その他のコレクションに対して上記の手順を繰り返します。

8. 完了したら、</Container> 終了タグを記述します。

ストリームレット・マッチング

各ストリームレット・クラスには、そのクラスの MATCHINGS パラメータで定義された、それぞれ異なる一致条件があります。このパラメータは HS.SDA3.Streamlet.Abstract から継承されます。ストリームレット・マッチング・ロジックにより、HealthShare はストリームレットが新規なのか、既存データの更新なのかを判断できます。2 つのストリームレットを比較してマッチングと重複除去を行うかどうかは、EncounterNumber プロパティによって決まります。

• 2 つのストリームレットの EncounterNumber が異なる場合や、一方のストリームレットには EncounterNumber の値があるのに他方にはない場合、ストリームレットは比較の対象になりません。

• 両方のストリームレットの EncounterNumber が同じ場合、ストリームレットは比較の対象になります。

• いずれのストリームレットにも EncounterNumber の値がない場合、ストリームレットは比較の対象になります。

適切なストリームレットがある場合、マッチング・プロセスは 3 つのフェーズで実行されます。

1. まず、Edge Gateway でストリームレットが取り込まれると、そのデータが同じ MRN を持つ同じタイプのストリームレットと比較されます。複数の Edge Gateway が存在するシステムでは、比較は Access Gateway の集約キャッシュによって処理されます。このプロセスの詳細は、HS.SDA3.Streamlet.Abstract.Aggregate() メソッドのクラス・リファレンスを参照してください。

2. ストリームレットに外部 ID が含まれる場合は、この外部 ID を使用して、その ID を持つ同じタイプの他のストリームレットと照合します。

3. 上記のどのチェックでも一致が見つからない場合、HealthShare は各ストリームレット固有の MATCHINGS のキーと値のペアを、同じストリームレット・タイプの他のレコードと照合します。

どのチェックでも一致が見つからない場合、ストリームレットは新規と認識されます。いずれかのチェックで一致が見つかった場合、ストリームレットは既存のストリームレットの更新と認識され、既存のストリームレットと共に集約されます。これを重複除去と呼びます。後述する “SDA のカスタマイズ” に示すように、MATCHINGS パラメータは変更できます。

MATCHINGS パラメータは、MatchList1 || MatchList2 という形式を取ります。各 MatchList 項目は MatchType/MatchProp1,MatchProp2,.../NullProp1,NullProp2,... という形式を取ります。

これらの要素は、以下のように定義されます。

• MatchType は、マッチングするタイプの任意の名前です。

• MatchProp は、マッチングに使用する SDA ストリームレット・クラスのプロパティの名前です。複雑なケースでは、一時プロパティまたは計算プロパティにすることができます。MatchProp 要素が 2 つ以上ある場合は、そのすべてに対してマッチングを実行する必要があります。

• NullProp はマッチングに使用するプロパティの名前です (オプション)。空の NullProp は、すべてにマッチングすると見なされます。NullProp 要素が 2 つ以上ある場合は、そのすべての組み合わせに対してマッチングが実行されます。

• MatchProp または NullProp の後のアスタリスクは、その要素が、Code および SDACodingStandard に対してマッチングされる CodeTableDetail であることを示します。

架空のカスタム Allergy ストリームレットの以下のコードを考えてみましょう。

Parameter MATCHINGS = "ALG/Allergy*/FromTime,AllergyCategory* || 
ZATC/ATCCode*/FromTime";

この場合、Unified Care Record は、以下の条件に従って順番にマッチングを試みます。

1. Allergy に対してマッチングします。これは CodeTableDetail です。オプションで、FromTime または AllergyCategory に対してマッチングします。いずれかが存在する場合、これも CodeTableDetail です。

2. ATCCode に対してマッチングします。これは CodeTableDetail です。オプションで、FromTime が存在する場合は、これに対してマッチングします。