SAP Lumira でFHIR のOData Feeds を取り込み

こんにちは！ドライバー周りのヘルプドキュメントを担当している古川です。

CData API Server を使って、SAP Lumira でFHIR に基づくビジュアライゼーションを作成できます。API Server により、リアルタイムデータへの接続が可能になります。ダッシュボードとレポートはオンデマンドで更新できます。この記事では、常に最新であるグラフを作成する方法を説明します。

CData API Server とは？

CData API Server は、以下のような特徴を持ったAPI 開発ツールです。

• あらゆるデータソースからAPI を生成：SQL Server、MySQL、Oracle、PostgreSQL、DB2 などのRDB、Excel、CSV、Google スプレッドシートなどCData の充実したコネクタライブラリを利用できます。
• 主要なデータ形式に対応：OData、REST、JSON、CSV / TSV など、主要な形式に対応しています。
• 一元管理でAPI を効率運用：単一の管理プラットフォーム上でAPI の更新、停止、共有が可能です。
• ノーコードでシンプルな設定：GUI ベースのインターフェースを使用して、複雑なコーディングなしでAPI を作成・セキュアに公開できます。

詳しくは、こちらの製品資料をご確認ください。

API Server の設定

以下のリンクからAPI Server の無償トライアルをスタートしたら、セキュアなFHIR OData サービスを作成していきましょう。

デプロイ

API Server は内蔵のJetty サーバー上で動作します。Windows をお使いの場合は、スタンドアロンサーバーとして起動するか、IIS に組み込んで使用することが可能です。また、お使いのJava サーブレットコンテナにAPI Server のWAR ファイルを配置して実行することもできます。具体的なセットアップ方法については、こちらのヘルプドキュメントをご覧ください。

FHIR への接続

Salesforce Connect からFHIR のデータを操作するには、まずFHIR への接続を作成・設定します。

1. API Server にログインして、「Connections」をクリック、さらに「接続を追加」をクリックします。
2. 「接続を追加」をクリックして、データソースがAPI Server に事前にインストールされている場合は、一覧から「FHIR」を選択します。
3. 事前にインストールされていない場合は、コネクタを追加していきます。コネクタ追加の手順は以下の記事にまとめてありますので、ご確認ください。
   CData コネクタの追加方法はこちら >>
4. それでは、FHIR への接続設定を行っていきましょう！

5. URL をFHIR サーバーのService Base URL に設定します。これは接続したいFHIR サーバーでリソースが定義されているアドレスです。ConnectionType をサポートされている接続タイプに設定します。ContentType をドキュメントのフォーマットに設定します。AuthScheme をFHIR サーバーの認証要件に基づいて設定します。

   汎用、Azure ベース、AWS ベース、およびGoogle ベースのFHIR サーバー実装がサポートされます。

   Service Base URL のサンプル

   • 汎用：http://my_fhir_server/r4b/
   • Azure：https://MY_AZURE_FHIR.azurehealthcareapis.com/
   • AWS：https://healthlake.REGION.amazonaws.com/datastore/DATASTORE_ID/r4/
   • Google：https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStores/FHIR_STORE_ID/fhir/

   汎用FHIR インスタンス

   CData 製品はFHIR のカスタムインスタンスへの接続をサポートします。カスタムFHIR サーバーへの認証はOAuth で行います（OAuth の詳細はヘルプドキュメントを参照してください）。カスタムFHIR インスタンスに接続する前に、ConnectionType をGenericに設定する必要があります。

6. 接続情報の入力が完了したら、「保存およびテスト」をクリックします。

URL をFHIR サーバーのService Base URL に設定します。これは接続したいFHIR サーバーでリソースが定義されているアドレスです。ConnectionType をサポートされている接続タイプに設定します。ContentType をドキュメントのフォーマットに設定します。AuthScheme をFHIR サーバーの認証要件に基づいて設定します。

汎用、Azure ベース、AWS ベース、およびGoogle ベースのFHIR サーバー実装がサポートされます。

Service Base URL のサンプル

• 汎用：http://my_fhir_server/r4b/
• Azure：https://MY_AZURE_FHIR.azurehealthcareapis.com/
• AWS：https://healthlake.REGION.amazonaws.com/datastore/DATASTORE_ID/r4/
• Google：https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStores/FHIR_STORE_ID/fhir/

汎用FHIR インスタンス

CData 製品はFHIR のカスタムインスタンスへの接続をサポートします。カスタムFHIR サーバーへの認証はOAuth で行います（OAuth の詳細はヘルプドキュメントを参照してください）。カスタムFHIR インスタンスに接続する前に、ConnectionType をGenericに設定する必要があります。

API Server のユーザー設定

次に、API Server 経由でFHIR にアクセスするユーザーを作成します。「Users」ページでユーザーを追加・設定できます。やってみましょう。

1. 「Users」ページで ユーザーを追加をクリックすると、「ユーザーを追加」ポップアップが開きます。
2. 次に、「ロール」、「ユーザー名」、「権限」プロパティを設定し、「ユーザーを追加」をクリックします。
3. その後、ユーザーの認証トークンが生成されます。各ユーザーの認証トークンとその他の情報は「Users」ページで確認できます。

FHIR 用のAPI エンドポイントの作成

ユーザーを作成したら、FHIR のデータ用のAPI エンドポイントを作成していきます。

1. まず、「API」ページに移動し、 「 テーブルを追加」をクリックします。
2. アクセスしたい接続を選択し、次へをクリックします。
3. 接続を選択した状態で、各テーブルを選択して確認をクリックすることでエンドポイントを作成します。

OData のエンドポイントを取得

以上でFHIR への接続を設定してユーザーを作成し、API Server でFHIR データのAPI を追加しました。これで、OData 形式のFHIR データをREST API で利用できます。API Server の「API」ページから、API のエンドポイントを表示およびコピーできます。

SAP Lumira からFHIR への接続

以下のステップに従って、FHIR をSAP Lumira に取得します。SQL クエリを実行するか、UI を使用できます。

1. SAP Lumira で［File］->［New］->［Query with SQL］とクリックします。Add New Dataset ダイアログが表示されます。
2. ［Generic］セクションを展開し、［Generic OData 2.0 Connector］オプションをクリックします。
3. ［Service Root URI］ボックスに、API Server のOData エンドポイントを入力します。URL は次の例のようになります。 https://your-server:8032/api.rsc
4. ［User Name］と［Password］のボックスにAPI ユーザーのユーザー名と認証トークンを入力します。これらの資格情報は、HTTP 基本認証で使用されます。

5. ツリーでエンティティを選択するか、SQL クエリを入力します。この記事では、FHIR Patient エンティティをインポートします。

   

6. ［Connect］をクリックすると、SAP Lumira は対応するOData 要求を生成し、結果をメモリにロードします。その後、フィルタ、集計、要約関数など、SAP Lumira で使用可能な任意のデータ処理ツールを使用できます。

   

データのビジュアライゼーションを作成

データをインポートした後、［Visualize］ルームでデータのビジュアライゼーションを作成できます。以下のステップに従って、基本グラフを作成します。

1. ［Measures and Dimensions］ペインで、メジャーとディメンションを［Visualization Tools］ペインの［x-axis］フィールドと［y-axis］フィールドにドラッグします。SAP Lumira は、API Server のメタデータサービスからディメンションとメジャーを自動的に検出します。

   デフォルトでは、SUM 関数はすべてのメジャーに適用されます。メジャーの横にある歯車のアイコンをクリックしてデフォルトの要約を変更します。

2. ［Visualization Tools］ペインで、グラフの種類を選択します。
3. ［Chart Canvas］ペインで、フィルタを適用し、メジャーで並べ替え、ランキングを追加して現在のFHIR でグラフを更新します。