> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cloud.cdata.com/llms.txt
> Use this file to discover all available pages before exploring further.

# FHIR

## セットアップガイド

以下の手順で、FHIR をConnect AI アカウントに接続します：

**Step 1**

Connect AI のナビゲーションメニューから**Sources** ページを開きます。

**Step 2**

右上の **+ Add Connection** をクリックします。

**Step 3**

検索フィールドに*FHIR* と入力し、データソース名をクリックします。

**Step 4**

新しいコネクションの**Basic Settings** タブで、コネクション名を入力するかデフォルトの名前をそのまま使用します。

**Step 5**

**Connection Type** を設定します。コネクションタイプにより使用する認証方法が決まります。

## 汎用認証方法

> [tab] GenericOAuth
>
> **Callback URL**（リダイレクトURL）は、OAuth アプリを設定する際に必要なURL（`https://oauth.cdata.com/oauth/`）です。このURL をコピーしてOAuth アプリに貼り付けます。
>
> **Step 1**
>
> 以下の情報を入力します：
>
> * **OAuth Client Id**—FHIR アカウントを登録した際に割り当てられたId。
> * **OAuth Client Secret**—FHIR アカウントのクライアントシークレット。
> * **OAuth Authorization URL**—ユーザーがOAuth にログインしてアプリケーションに権限を付与するURL。
> * **OAuth Access Token URL**—認可トークンをアクセストークンと交換できるURL。
> * **URL**—FHIR サーバーのURL。汎用URL の例：`http://my_fhir_server/r4b/`。
>
> **Step 2**
>
> OAuth でセキュアに接続するには、**Sign in** をクリックします。これにより、FHIR のサインインページが新しいタブで開かれます。
>
> **Step 3**
>
> FHIR アカウントにログインし、リクエストされた権限を設定します（該当する場合）。
>
> **Step 4**
>
> Connect AI **Add FHIR Connection** ページ上部の、**Save & Test** をクリックします。
>
> * 接続テストに成功すると、コネクションが作成されたことを示す**Connection successfully saved** というメッセージが表示されます。**Edit Connection** ページの**Status** も**Authenticated** に変わります。**Edit Connection** ページの右ペインにある**Data Model** タブで、成功したコネクションのデータモデルを表示します。
> * 接続テストに失敗した場合は、入力したログイン情報に余分なスペースや文字がないかを確認してください。Connect AI は、データが不足している必須フィールドの下にエラーメッセージを表示します。一部のデータソースでは、ソースのWeb サイトに直接サインインする必要があります。サインインしていない場合は、**Sign in** ボタンの下にエラーメッセージが表示されます。エラーを修正し、もう一度試してください。
> * 失敗したコネクションは下書きとして保存され、**Status** は**Not Authenticated** になります。後でコネクションに戻って認証することができます。

> [tab] None
>
> **Step 1**
>
> 接続の**URL** を入力します。汎用URL の例：`http://my_fhir_server/r4b/`。
>
> **Step 2**
>
> Connect AI **Add FHIR Connection** ページ上部の、**Save & Test** をクリックします。
>
> * 接続テストに成功すると、コネクションが作成されたことを示す**Connection successfully saved** というメッセージが表示されます。**Edit Connection** ページの**Status** も**Authenticated** に変わります。**Edit Connection** ページの右ペインにある**Data Model** タブで、成功したコネクションのデータモデルを表示します。
> * 接続テストに失敗した場合は、入力したログイン情報に余分なスペースや文字がないかを確認してください。Connect AI は、データが不足している必須フィールドの下にエラーメッセージを表示します。一部のデータソースでは、ソースのWeb サイトに直接サインインする必要があります。サインインしていない場合は、**Sign in** ボタンの下にエラーメッセージが表示されます。エラーを修正し、もう一度試してください。
> * 失敗したコネクションは下書きとして保存され、**Status** は**Not Authenticated** になります。後でコネクションに戻って認証することができます。

## Azure 認証方法

> [tab] AzureAD
>
> **Step 1**
>
> FHIR サーバーのURL を入力します。Azure URL の例：`https://MY_AZURE_FHIR.azurehealthcareapis.com/`。
>
> **Step 2**
>
> OAuth でセキュアに接続するには、**Sign in** をクリックします。これにより、FHIR のサインインページが新しいタブで開かれます。
>
> **Step 3**
>
> FHIR アカウントにログインし、リクエストされた権限を設定します（該当する場合）。
>
> **Step 4**
>
> Connect AI **Add FHIR Connection** ページ上部の、**Save & Test** をクリックします。
>
> * 接続テストに成功すると、コネクションが作成されたことを示す**Connection successfully saved** というメッセージが表示されます。**Edit Connection** ページの**Status** も**Authenticated** に変わります。**Edit Connection** ページの右ペインにある**Data Model** タブで、成功したコネクションのデータモデルを表示します。
> * 接続テストに失敗した場合は、入力したログイン情報に余分なスペースや文字がないかを確認してください。Connect AI は、データが不足している必須フィールドの下にエラーメッセージを表示します。一部のデータソースでは、ソースのWeb サイトに直接サインインする必要があります。サインインしていない場合は、**Sign in** ボタンの下にエラーメッセージが表示されます。エラーを修正し、もう一度試してください。
> * 失敗したコネクションは下書きとして保存され、**Status** は**Not Authenticated** になります。後でコネクションに戻って認証することができます。

> [tab] AzureServicePrincipal
>
> **Step 1**
>
> 以下の情報を入力します：
>
> * **OAuth Client Id**—FHIR アカウントを登録した際に割り当てられたId。
> * **OAuth Client Secret**—FHIR アカウントのクライアントシークレット。
> * **URL**—FHIR サーバーのURL。Azure URL の例：`https://MY_AZURE_FHIR.azurehealthcareapis.com/`。
>
> **Step 2**
>
> Connect AI **Add FHIR Connection** ページ上部の、**Save & Test** をクリックします。
>
> * 接続テストに成功すると、コネクションが作成されたことを示す**Connection successfully saved** というメッセージが表示されます。**Edit Connection** ページの**Status** も**Authenticated** に変わります。**Edit Connection** ページの右ペインにある**Data Model** タブで、成功したコネクションのデータモデルを表示します。
> * 接続テストに失敗した場合は、入力したログイン情報に余分なスペースや文字がないかを確認してください。Connect AI は、データが不足している必須フィールドの下にエラーメッセージを表示します。一部のデータソースでは、ソースのWeb サイトに直接サインインする必要があります。サインインしていない場合は、**Sign in** ボタンの下にエラーメッセージが表示されます。エラーを修正し、もう一度試してください。
> * 失敗したコネクションは下書きとして保存され、**Status** は**Not Authenticated** になります。後でコネクションに戻って認証することができます。

## AWS 認証方法

**AWS Region** を入力し、次に**Auth Scheme** を選択します。

> [tab] AwsRootKeys
>
> **Step 1**
>
> 以下の情報を入力します：
>
> * **AWS Access Key**—AWS アカウントのアクセスキー。この値はAWS セキュリティ認証情報ページで確認できます。
> * **AWS Secret Key**—AWS アカウントのシークレットキー。この値はAWS セキュリティ認証情報ページで確認できます。
> * **URL**—FHIR サーバーのURL。AWS URL の例：`https://healthlake.REGION.amazonaws.com/datastore/DATASTORE_ID/r4/`。
>
> **Step 2**
>
> Connect AI **Add FHIR Connection** ページ上部の、**Save & Test** をクリックします。
>
> * 接続テストに成功すると、コネクションが作成されたことを示す**Connection successfully saved** というメッセージが表示されます。**Edit Connection** ページの**Status** も**Authenticated** に変わります。**Edit Connection** ページの右ペインにある**Data Model** タブで、成功したコネクションのデータモデルを表示します。
> * 接続テストに失敗した場合は、入力したログイン情報に余分なスペースや文字がないかを確認してください。Connect AI は、データが不足している必須フィールドの下にエラーメッセージを表示します。一部のデータソースでは、ソースのWeb サイトに直接サインインする必要があります。サインインしていない場合は、**Sign in** ボタンの下にエラーメッセージが表示されます。エラーを修正し、もう一度試してください。
> * 失敗したコネクションは下書きとして保存され、**Status** は**Not Authenticated** になります。後でコネクションに戻って認証することができます。

> [tab] AwsIAMRoles
>
> **Step 1**
>
> 以下の情報を入力します：
>
> * **AWS Access Key**—AWS アカウントのアクセスキー。この値はAWS セキュリティ認証情報ページで確認できます。
> * **AWS Secret Key**—AWS アカウントのシークレットキー。この値はAWS セキュリティ認証情報ページで確認できます。
> * **AWS Role ARN**—認証時に使用するロールのAmazon リソース名。
> * **URL**—FHIR サーバーのURL。AWS URL の例：`https://healthlake.REGION.amazonaws.com/datastore/DATASTORE_ID/r4/`。
>
> **Step 2**
>
> Connect AI **Add FHIR Connection** ページ上部の、**Save & Test** をクリックします。
>
> * 接続テストに成功すると、コネクションが作成されたことを示す**Connection successfully saved** というメッセージが表示されます。**Edit Connection** ページの**Status** も**Authenticated** に変わります。**Edit Connection** ページの右ペインにある**Data Model** タブで、成功したコネクションのデータモデルを表示します。
> * 接続テストに失敗した場合は、入力したログイン情報に余分なスペースや文字がないかを確認してください。Connect AI は、データが不足している必須フィールドの下にエラーメッセージを表示します。一部のデータソースでは、ソースのWeb サイトに直接サインインする必要があります。サインインしていない場合は、**Sign in** ボタンの下にエラーメッセージが表示されます。エラーを修正し、もう一度試してください。
> * 失敗したコネクションは下書きとして保存され、**Status** は**Not Authenticated** になります。後でコネクションに戻って認証することができます。

## Google 認証方法

> [tab] OAuth
>
> **Step 1**
>
> FHIR サーバーの**URL** を入力します。Google URL の例：`https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStores/FHIR_STORE_ID/fhir/`。
>
> **Step 2**
>
> OAuth でセキュアに接続するには、**Sign in with Google** をクリックします。これにより、FHIR のサインインページが新しいタブで開かれます。
>
> **Step 3**
>
> FHIR アカウントにログインします。
>
> **Step 4**
>
> Connect AI **Add FHIR Connection** ページ上部の、**Save & Test** をクリックします。
>
> * 接続テストに成功すると、コネクションが作成されたことを示す**Connection successfully saved** というメッセージが表示されます。**Edit Connection** ページの**Status** も**Authenticated** に変わります。**Edit Connection** ページの右ペインにある**Data Model** タブで、成功したコネクションのデータモデルを表示します。
> * 接続テストに失敗した場合は、入力したログイン情報に余分なスペースや文字がないかを確認してください。Connect AI は、データが不足している必須フィールドの下にエラーメッセージを表示します。一部のデータソースでは、ソースのWeb サイトに直接サインインする必要があります。サインインしていない場合は、**Sign in** ボタンの下にエラーメッセージが表示されます。エラーを修正し、もう一度試してください。
> * 失敗したコネクションは下書きとして保存され、**Status** は**Not Authenticated** になります。後でコネクションに戻って認証することができます。

> [tab] OAuthJWT
>
> **Step 1**
>
> 以下の情報を入力します：
>
> * **OAuth JWT Cert**—Google が提供する証明書ファイルの内容。サンプル形式が提供されています。
> * **OAuth JWT Subject**—（オプション）データにアクセスするユーザーのメールアドレス。サービスアカウントがGSuite ドメインに属していて委任を有効にする場合にのみ設定します。
> * **URL**—FHIR サーバーのURL。Google URL の例：`https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStores/FHIR_STORE_ID/fhir/`。
>
> **Step 2**
>
> Connect AI **Add FHIR Connection** ページ上部の、**Save & Test** をクリックします。
>
> * 接続テストに成功すると、コネクションが作成されたことを示す**Connection successfully saved** というメッセージが表示されます。**Edit Connection** ページの**Status** も**Authenticated** に変わります。**Edit Connection** ページの右ペインにある**Data Model** タブで、成功したコネクションのデータモデルを表示します。
> * 接続テストに失敗した場合は、入力したログイン情報に余分なスペースや文字がないかを確認してください。Connect AI は、データが不足している必須フィールドの下にエラーメッセージを表示します。一部のデータソースでは、ソースのWeb サイトに直接サインインする必要があります。サインインしていない場合は、**Sign in** ボタンの下にエラーメッセージが表示されます。エラーを修正し、もう一度試してください。
> * 失敗したコネクションは下書きとして保存され、**Status** は**Not Authenticated** になります。後でコネクションに戻って認証することができます。

## InterSystems 認証方法

> [tab] ApiKey
>
> **Step 1**
>
> FHIR アカウントの**API Key** を入力します。
>
> **Step 2**
>
> FHIR サーバーの**URL** を入力します。
>
> **Step 3**
>
> Connect AI **Add FHIR Connection** ページ上部の、**Save & Test** をクリックします。
>
> * 接続テストに成功すると、コネクションが作成されたことを示す**Connection successfully saved** というメッセージが表示されます。**Edit Connection** ページの**Status** も**Authenticated** に変わります。**Edit Connection** ページの右ペインにある**Data Model** タブで、成功したコネクションのデータモデルを表示します。
> * 接続テストに失敗した場合は、入力したログイン情報に余分なスペースや文字がないかを確認してください。Connect AI は、データが不足している必須フィールドの下にエラーメッセージを表示します。一部のデータソースでは、ソースのWeb サイトに直接サインインする必要があります。サインインしていない場合は、**Sign in** ボタンの下にエラーメッセージが表示されます。エラーを修正し、もう一度試してください。
> * 失敗したコネクションは下書きとして保存され、**Status** は**Not Authenticated** になります。後でコネクションに戻って認証することができます。

> [tab] None
>
> **Step 1**
>
> FHIR サーバーの**URL** を入力します。
>
> **Step 2**
>
> Connect AI **Add FHIR Connection** ページ上部の、**Save & Test** をクリックします。
>
> * 接続テストに成功すると、コネクションが作成されたことを示す**Connection successfully saved** というメッセージが表示されます。**Edit Connection** ページの**Status** も**Authenticated** に変わります。**Edit Connection** ページの右ペインにある**Data Model** タブで、成功したコネクションのデータモデルを表示します。
> * 接続テストに失敗した場合は、入力したログイン情報に余分なスペースや文字がないかを確認してください。Connect AI は、データが不足している必須フィールドの下にエラーメッセージを表示します。一部のデータソースでは、ソースのWeb サイトに直接サインインする必要があります。サインインしていない場合は、**Sign in** ボタンの下にエラーメッセージが表示されます。エラーを修正し、もう一度試してください。
> * 失敗したコネクションは下書きとして保存され、**Status** は**Not Authenticated** になります。後でコネクションに戻って認証することができます。

## 詳細について

Connect AI とFHIR の連携の詳細動作については、[こちらのページ](https://cdn.cdata.com/help/KIM/jp/cloud/default.htm#default)を参照してください。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.