第6章 FHIR への接続

手順

1. Fuse Online の左パネルで Connections をクリックし、利用可能なコネクションを表示します。
2. 右上の Create Connection をクリックしてコネクターを表示します。

3. FHIR コネクターをクリックし、以下のようにコネクションを設定します。

   1. FHIR version フィールドで必要となる DSTU3 を許可します。
   2. アクセスする FHIR サーバーの URL を FHIR server URL フィールドに入力します。インテグレーションの作成中、デフォルトテストサーバー http://fhirtest.uhn.ca/baseDstu3 を許可することがあります。
   3. FHIR server username フィールドにユーザー名を入力します。これは、Basic 認証を使用する FHIR サーバーで必要になります。
   4. FHIR server password フィールドにパスワードを入力します。これも Basic 認証を使用する FHIR サーバーで必要になります。
   5. FHIR server bearer token フィールドにトークンを入力します。これは、OAuth 認証を使用する FHIR サーバーで必要になります。
4. Validate をクリックします。Fuse Online は即座にコネクションを検証しようとし、検証の成功または失敗を示すメッセージを表示します。検証に失敗した場合は、入力パラメーターを訂正し、再度検証を行います。
5. 検証に成功した場合は Next をクリックします。
6. Name フィールドに、このコネクションを別のコネクションと区別するために使用する名前を入力します。たとえば、FHIR West を入力します。
7. Description は任意のフィールドで、このコネクションに関する便利な情報を入力します。
8. Save をクリックし、作成したコネクションが利用可能になったことを確認します。上記の例の名前を入力した場合は、インテグレーションに追加できるコネクションとして FHIR West が表示されます。

手順

1. Add to Integration ページで、コネクションの追加先のプラス記号をクリックします。
2. 取得するリソースにアクセスできる FHIR コネクションをクリックします。
3. Choose an action ページで Read を選択します。
4. Resource Type フィールドをクリックし、FHIR リソースタイプのリストを表示します。取得するリソースのタイプを選択または入力します。

5. 取得するリソースタイプに他のリソースタイプが含まれている場合、Contained Resource Types フィールドで含まれているタイプを選択します。複数のタイプを選択する必要がある場合は Ctrl キーを使用します。

   含まれるリソースタイプを特定すると、データマッパーは含まれるリソースにあるフィールドを表示できるようになります。含まれるリソースタイプを指定しないと、含まれるリソースにあるフィールドからマッピングを行うことができません。実際に含まれないリソースを選択しても問題はありません。

6. Resource Id フィールドにリソースの ID を入力します。ただし、フローの初期のステップからマップする予定である場合は、このフィールドを空白のままにしておきます。
7. Resource version フィールドには、リソースのバージョン ID を任意で指定します。最新バージョンのリソースを取得する場合や、以前のステップからリソースのバージョン ID をマップする場合は、このフィールドを空白のままにしておきます。
8. Next をクリックして、このコネクションをフローに追加します。

手順

1. Add to Integration ページで、コネクションの追加先のプラス記号をクリックします。
2. 取得するリソースを持つ FHIR コネクションをクリックします。
3. Choose an action ページで Search を選択します。
4. Resource Type フィールドをクリックし、FHIR リソースタイプのリストを表示します。取得するリソースのタイプを選択または入力します。
5. Query フィールドに FHIR クエリーを指定するか、このフィールドを空白のままにして以前のステップからクエリーをマッピングします。FHIR クエリーの作成に関する詳細は、「FHIR Release 3 Search」を参照してください。
6. Next をクリックして、このコネクションをフローに追加します。

手順

1. Add to Integration ページで、コネクションの追加先のプラス記号をクリックします。Fuse Online が最後のコネクションを選択するよう要求する場合は、このステップをスキップします。
2. リソースを追加するサーバーへの FHIR コネクションをクリックします。
3. Choose an action ページで Create を選択します。
4. Resource Type フィールドをクリックし、FHIR リソースタイプのリストを表示します。作成するリソースのタイプを選択または入力します。

5. 作成するリソースタイプに他のリソースタイプが含まれている場合、Contained Resource Types フィールドで含まれているタイプを選択します。複数のタイプを選択する必要がある場合は Ctrl キーを使用します。

   含まれるリソースタイプを特定すると、データマッパーは含まれるリソースにあるフィールドを表示できるようになります。含まれるリソースタイプを指定しないと、含まれるリソースにあるフィールドをマップ元またはマップ先としてマッピングすることができません。実際に含まれないリソースを選択しても問題はありません。

6. Next をクリックして、このコネクションをフローに追加します。

手順

1. Add to Integration ページで、コネクションの追加先のプラス記号をクリックします。Fuse Online が最後のコネクションを選択するよう要求する場合は、このステップをスキップします。
2. FHIR サーバーでリソースの更新に使用する FHIR コネクションをクリックします。
3. Choose an action ページで Update を選択します。
4. Resource Type フィールドをクリックし、FHIR リソースタイプのリストを表示します。更新または作成するリソースのタイプを選択または入力します。

5. 更新または作成するリソースタイプに他のリソースタイプが含まれている場合、Contained Resource Types フィールドで含まれているタイプを選択します。複数のタイプを選択する必要がある場合は Ctrl キーを使用します。

   含まれるリソースタイプを特定すると、データマッパーは含まれるリソースにあるフィールドを表示できるようになります。含まれるリソースタイプを指定しないと、含まれるリソースにあるフィールドをマップ元またはマップ先としてマッピングすることができません。実際に含まれないリソースを選択しても問題はありません。

6. Next をクリックして、このコネクションをフローに追加します。
7. 更新されたリソースに含まれるデータを取得する追加のステップがフローに必要な場合は、この FHIR コネクションの前に追加します。
8. インテグレーションビジュアライゼーションで、リソースを更新する FHIR コネクションの前にあるプラス記号をクリックします。
9. Data Mapper をクリックします。

10. データマッパーで以下を行います。

    1. リソース ID をターゲットリソース ID にマップします。これは、新しいリソースのリソース ID を指定する唯一の方法になります。
    2. 更新されたリソースまたは新しいリソースに含める各リソースフィールドにマップします。値が変更しないフィールドおよび値を更新する必要があるフィールドにマップするようにしてください。
    3. Done をクリックして、データマッパーステップをフローに追加します。

手順

1. Add to Integration ページで、コネクションの追加先のプラス記号をクリックします。Fuse Online が最後のコネクションを選択するよう要求する場合は、このステップをスキップします。
2. リソースの更新に使用する FHIR コネクションをクリックします。
3. Choose an action ページで Patch を選択します。
4. Resource Type フィールドをクリックし、FHIR リソースタイプのリストを表示します。更新するフィールドを持つリソースのタイプを選択または入力します。
5. Number of Operations フィールドに、更新するフィールドの数を指定します。
6. フローの以前のステップから値をマップする場合は Resource id フィールドを空白のままにしておきます。これが通常の作業になります。その他の場合は、更新するフィールドが含まれるリソースのリソース ID を指定します。

7. 更新が記述された JSON パッチを指定します。JSON パッチは What is a JSON Patch? に記述されている形式である必要があります。

   Patient リソースのパッチ例:

   active フィールドを true に設定します。

   Copy to Clipboard Toggle word wrap

   [{ "op":"replace", "path":"/active", "value": true }]

   患者の名前の配列である name フィールドの値を置き換えます。この例では、患者の名前は 1 つです。患者に複数の名前がある場合は、同様の形式のパッチで患者の名前をすべて置き換えることができます。

   Copy to Clipboard Toggle word wrap

   [{ "op":"replace", "path":"/name", "value": [{"given": ["Bob"]}] }]

   患者の名を置き換えます。

   Copy to Clipboard Toggle word wrap

   [{ "op":"replace", "path":"/name/0/given/0", "value": "John" }]

   名の前に別の名前を患者に追加します。

   Copy to Clipboard Toggle word wrap

   [{ "op":"add", "path":"/name/0", "value": {"given": ["Anthony"]} }]

   更新によっては、Patch アクションの設定時に JSON パッチを指定する必要があります。たとえば、リソースフィールドの値を別のフィールドにコピーすることがあります。その他の更新では、JSON Patch フィールドを空白のままにし、代わりに各更新を定義する値をマップすることができます。

8. Next をクリックして、このコネクションをフローに追加します。

9. JSON パッチやリソース ID を指定しなかった場合は、データマッパーステップを追加します。

   1. フロービジュアライゼーションで、追加したばかりの FHIR コネクションの前にあるプラス記号をクリックします。

   2. Data Mapper をクリックします。

      Target パネルには、更新する各フィールド用の番号が付けられたフォルダーが表示されます。Patch アクションを設定するとき、更新するフィールドの数を指定します。データマッパーは、この数のフォルダーを Target パネルに表示します。たとえば、更新するフィールドの数として 3 を指定すると、1、2、および 3 のラベルが付いた 3 つのターゲットフォルダーが表示されます。

   3. 更新する各フィールドをいずれかのターゲットフォルダーのフィールドにマップします。

      1. Target パネルでフォルダーを展開し、op、path、および value の 3 つのフィールドを表示します。
      2. ソースフィールド、定数、またはプロパティーをターゲット path フィールドにマップします。パスは更新するリソースフィールドを識別します。パスの値では、数字はリストフィールドのインデックスを示し、スラッシュは子フィールドに通じます。たとえば、/name/1/given/1/value パスをマップし、指定の name フィールドの値を更新します。
      3. フィールドの現在の値を置き換えるデフォルトの更新操作を許可するか、ソースフィールド、定数、またはプロパティーを op フィールドにマップし、フィールドの更新方法を示します。可能な操作の詳細は、「JSON patch operations」を参照してください。
      4. フィールドを更新して新しい値を取得する場合は、ソースフィールド、定数、またはプロパティーをターゲット value にマップします。これは、フィールドに含まれるようにする新しい値になります。
   4. Patch アクションの設定時にリソース ID を指定しなかった場合は、リソース ID をターゲット id フィールドにマップします。
   5. Done をクリックして、データマッパーステップをフローに追加します。

手順

1. Add to Integration ページで、コネクションの追加先のプラス記号をクリックします。Fuse Online が最後のコネクションを選択するよう要求する場合は、このステップをスキップします。
2. 新しいリソースを作成し、FHIR サーバーに追加するために使用する FHIR コネクションをクリックします。
3. Choose an action ページで Transaction を選択します。
4. Included Resource Types フィールドに、このコネクションが作成するリソースタイプを選択します。Ctrl キーを使用して複数のリソースタイプを選択します。コネクションは、選択した各タイプのリソースを 1 つ作成します。
5. Next をクリックして、このコネクションをフローに追加します。

6. 新しいリソースにフィールドを入力するには、このコネクションの前にデータマッパーステップを追加します。

   1. フロービジュアライゼーションで、追加したばかりのコネクションの前にあるプラス記号をクリックします。
   2. Data Mapper をクリックします。
   3. データマッパーでソースフィールドをターゲットリソースフィールドにマップします。新しいリソースには、マップ先のターゲットフィールドのみが含まれます。
   4. Next をクリックして、データマッパーステップをフローに追加します。

手順

1. Add to Integration ページで、コネクションの追加先のプラス記号をクリックします。Fuse Online が最後のコネクションを選択するよう要求する場合は、このステップをスキップします。
2. リソースの削除に使用する FHIR コネクションをクリックします。
3. Choose an action ページで Delete を選択します。
4. Resource Type フィールドをクリックし、FHIR リソースタイプのリストを表示します。削除するリソースのタイプを選択または入力します。
5. Resource Id フィールドに、削除するリソースのリソース ID を指定します。インテグレーションの初期のステップからリソース ID をマップする予定である場合は、このフィールドを空白のままにしておきます。
6. Resource version フィールドには、リソースのバージョン ID を任意で指定します。最新バージョンのリソースを削除する場合や、以前のステップから削除するリソースのバージョン ID をマップする場合は、このフィールドを空白のままにしておきます。
7. Next をクリックして、このコネクションをフローに追加します。