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

# Collaboflow

export const title_1 = "Collaboflow";

export const title_0 = "Collaboflow";

## 前提条件

コネクションを追加する前に、Collaboflow アカウントから以下の情報を収集する必要があります。

<Steps>
  <Step>
    Collaboflow に管理者としてログインします。
  </Step>

  <Step>
    **システム管理エリア** > **アプリケーション管理** を開き、接続したいワークフローアプリケーションの **アプリCd**（アプリコード）をメモします。
  </Step>

  <Step>
    **Instance**（インスタンス）をメモします。これは Collaboflow API URL 内のインスタンス名です。URL の形式は `https://cloud.collaboflow.com/{instance}/api/index.cfm` で、Instance はドメインと `/api/index.cfm` の間のセグメントです（例： `https://cloud.collaboflow.com/mycompany/api/index.cfm` の *mycompany* 部分）。
  </Step>
</Steps>

## セットアップガイド

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

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

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

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

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

  <Step>
    Collaboflow で取得した **App Cd** を入力します。
  </Step>

  <Step>
    Collaboflow URL のインスタンス部分である **Instance** を入力します。
  </Step>

  <Step>
    Collaboflow API エンドポイントの **URL** を、*[https://cloud.collaboflow.com/\{instance}/api/index.cfm](https://cloud.collaboflow.com/\{instance}/api/index.cfm)* の形式で入力します（例： *[https://cloud.collaboflow.com/mycompany/api/index.cfm](https://cloud.collaboflow.com/mycompany/api/index.cfm)* ）。
  </Step>

  <Step>
    **Auth Scheme** を選択し、該当セクションに進んで手順に従います。
  </Step>
</Steps>

## 認証方式

<Tabs>
  <Tab title="APIKey">
    API キー認証を使用するには、Collaboflow 管理者アカウントから API キーを生成する必要があります：

    <Steps>
      <Step>
        **システム管理エリア** > **環境設定** を開きます。
      </Step>

      <Step>
        **REST API** セクションまでスクロールします。クライアント名を入力し、**HTTPヘッダー認証** を選択して **+ APIキー発行** をクリックします。**API キー** をコピーし、安全に保管してください。
      </Step>
    </Steps>

    Connect AI で以下の手順を行います：

    <Steps>
      <Step>
        Collaboflow 管理者アカウントで生成した **API Key** を入力します。
      </Step>

      <Step>
        認証に使用する Collaboflow のユーザー名である **User** を入力します。
      </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="Basic">
    <Steps>
      <Step>
        Collaboflow のユーザー名である **User** を入力します。
      </Step>

      <Step>
        Collaboflow の認証に使用する **Password** を入力します。
      </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>
</Tabs>
