> ## 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.

# SuiteCRM

export const title_2 = "SuiteCRM";

export const title_1 = "SuiteCRM";

export const title_0 = "SuiteCRM";

## 前提条件

SuiteCRM V8 API は認証に OAuth を使用するため、**OAuthClient** および **OAuthPassword** の認証方法ではカスタム OAuth アプリケーションが必要です。**Basic** 認証方法で SuiteCRM V4.1 API に接続する場合は、本セクションをスキップできます。

カスタム OAuth アプリケーションは SuiteCRM の管理者が作成・登録する必要があります。SuiteCRM でカスタム OAuth アプリケーションを作成するには、以下の手順に従います：

<Steps>
  <Step>
    管理者クレデンシャルで SuiteCRM アカウントにログインします。
  </Step>

  <Step>
    **Profile** ドロップダウンで **Admin > OAuth2 Clients and Tokens** を選択します。
  </Step>

  <Step>
    **OAuthClient** メソッドの場合は **New Client Credentials Client**、**OAuthPassword** メソッドの場合は **New Password Client** をクリックします。
  </Step>

  <Step>
    アプリケーションの **Name** と **Secret** を入力し、**Save** をクリックします。
  </Step>

  <Step>
    生成されたクライアント ID とクライアントシークレットを取得します。これらの値を以下のセットアップ手順で **OAuth Client Id** と **OAuth Client Secret** として入力します。
  </Step>
</Steps>

<Note>
  **OAuthClient**（クライアントクレデンシャル）グラントタイプで認証するユーザーは、API へのフルアクセスを持ちます。**OAuthPassword** グラントタイプで認証するユーザーは、アクセスする各モジュールまたはテーブルに対する権限が必要です。
</Note>

## セットアップガイド

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

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

  <Step>
    右上の **+ Add Connection** をクリックします。
  </Step>

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

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

  <Step>
    SuiteCRM アカウントの **URL** を入力します（例： *[http://your-suitecrm-instance.com](http://your-suitecrm-instance.com)* ）。
  </Step>

  <Step>
    SuiteCRM API バージョンに合った **Schema** を選択します：SuiteCRM V4.1 API の場合は **suitecrmv4**、SuiteCRM V8 API の場合は **suitecrmv8** です。
  </Step>

  <Step>
    SuiteCRM への接続時に使用する **Auth Scheme** を選択し、以下の該当するセクションの手順に従います。
  </Step>
</Steps>

## 認証

<Tabs>
  <Tab title="Basic">
    <Steps>
      <Step>
        **Schema** が **suitecrmv4** に設定されていることを確認します。**Basic** 認証方法は SuiteCRM V4.1 API でのみサポートされています。
      </Step>

      <Step>
        認証ユーザーの Id である **User** を入力します。
      </Step>

      <Step>
        そのユーザーの **Password** を入力します。
      </Step>

      <Step>
        Connect AI **Add {title_0} Connection** ページ上部の、**Save & Test** をクリックします。

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

  <Tab title="OAuthClient">
    <Steps>
      <Step>
        **Schema** が **suitecrmv8** に設定されていることを確認します。**OAuthClient** 認証方法は SuiteCRM V8 API でのみサポートされています。
      </Step>

      <Step>
        カスタム OAuth アプリケーションに割り当てられた **OAuth Client Id**（コンシューマーキーとも呼ばれます）を入力します。
      </Step>

      <Step>
        カスタム OAuth アプリケーションに割り当てられた **OAuth Client Secret** を入力します。
      </Step>

      <Step>
        Connect AI **Add {title_1} Connection** ページ上部の、**Save & Test** をクリックします。

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

  <Tab title="OAuthPassword">
    <Steps>
      <Step>
        **Schema** が **suitecrmv8** に設定されていることを確認します。**OAuthPassword** 認証方法は SuiteCRM V8 API でのみサポートされています。
      </Step>

      <Step>
        カスタム OAuth アプリケーションに割り当てられた **OAuth Client Id**（コンシューマーキーとも呼ばれます）を入力します。
      </Step>

      <Step>
        カスタム OAuth アプリケーションに割り当てられた **OAuth Client Secret** を入力します。
      </Step>

      <Step>
        認証ユーザーの Id である **User** を入力します。
      </Step>

      <Step>
        そのユーザーの **Password** を入力します。
      </Step>

      <Step>
        Connect AI **Add {title_2} Connection** ページ上部の、**Save & Test** をクリックします。

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

## 詳細について

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