第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. Connection Name フィールドに、このコネクションを別のコネクションと区別するために使用する名前を入力します。たとえば、FHIR West を入力します。
7. Description は任意のフィールドで、このコネクションに関する便利な情報を入力します。
8. 右上にある Create をクリックし、作成したコネクションが利用可能になったことを確認します。上記の例の名前を入力した場合は、インテグレーションに追加できるコネクションとして FHIR West が表示されます。

手順

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

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

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

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

手順

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

手順

1. リソースを追加するサーバーへの FHIR コネクションをクリックします。
2. Choose an Action ページで Create をクリックします。
3. Resource Type フィールドをクリックし、FHIR リソースタイプのリストを表示します。作成するリソースのタイプを選択または入力します。

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

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

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

手順

1. FHIR サーバーでリソースの更新に使用する FHIR コネクションをクリックします。
2. Choose an Action ページで Update をクリックします。
3. Resource Type フィールドをクリックし、FHIR リソースタイプのリストを表示します。更新または作成するリソースのタイプを選択または入力します。

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

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

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

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

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

手順

1. リソースの更新に使用する FHIR コネクションをクリックします。
2. Choose an Action ページで Patch をクリックします。
3. Resource Type フィールドをクリックし、FHIR リソースタイプのリストを表示します。更新するフィールドを持つリソースのタイプを選択または入力します。
4. Number of Operations フィールドに、更新するフィールドの数を指定します。
5. フローの以前のステップから値をマップする場合は Resource id フィールドを空白のままにしておきます。これが通常の作業になります。その他の場合は、更新するフィールドが含まれるリソースのリソース ID を指定します。
6. 更新が記述された JSON パッチを指定します。JSON パッチは What is a JSON Patch? に記述されている形式である必要があります。更新によっては、Patch アクションの設定時に JSON パッチを指定する必要があります。たとえば、リソースフィールドの値を別のフィールドにコピーすることがあります。その他の更新では、JSON Patch フィールドを空白のままにし、代わりに各更新を定義する値をマップすることができます。
7. Done をクリックして、このコネクションをフローに追加します。

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

   1. フロー可視化パネルで、追加したばかりの FHIR コネクションの前にあるプラス記号をクリックします。

   2. Choose a Step ページで 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. 新しいリソースを作成し、FHIR サーバーに追加するために使用する FHIR コネクションをクリックします。
2. Choose an Action ページで Transaction をクリックします。
3. Included Resource Types フィールドに、このコネクションが作成するリソースタイプを選択します。Ctrl キーを使用して複数のリソースタイプを選択します。コネクションは、選択した各タイプのリソースを 1 つ作成します。
4. Next をクリックして、このコネクションをフローに追加します。

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

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

手順

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