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

# Choreo

> このページでは、Choreo を Connect AI アカウントに接続する手順を説明します。

## 前提条件

接続する前に、以下の準備が必要です。

* Connect AI アカウントにデータソースを接続します。詳細については、[ソース](/ja/Sources) を参照してください。
* [設定](/ja/Settings#personal-access-tokens)ページでパーソナルアクセストークン（PAT）を生成します。認証時のパスワードとして使用するため、コピーして保管してください。

## Choreo で Connect AI に接続する

<Steps>
  <Step>
    [Choreo プラットフォーム](https://console.choreo.dev/)にサインインします。
  </Step>

  <Step>
    **Manual Trigger** をクリックして、手動で実行できるプログラムを作成します。

    <Frame>
      <img src="https://mintcdn.com/cdata/EE4HlkSQpbRlgqOq/ja/images/choreo_manualtrigger.png?fit=max&auto=format&n=EE4HlkSQpbRlgqOq&q=85&s=d9525c9bae2f086c08afced74104644c" alt="" width="2052" height="1002" data-path="ja/images/choreo_manualtrigger.png" />
    </Frame>
  </Step>

  <Step>
    マニュアルトリガーの **Name** と **Description** を入力し、**Create** をクリックします。

    <Frame>
      <img src="https://mintcdn.com/cdata/TfqVmUuBCnNRmW2K/ja/images/choreo_create.png?fit=max&auto=format&n=TfqVmUuBCnNRmW2K&q=85&s=5061efbda562f0abd4db740e1f4dd568" alt="" width="2052" height="1000" data-path="ja/images/choreo_create.png" />
    </Frame>
  </Step>

  <Step>
    マニュアルトリガーが **Develop** ビューで開きます。

    <Frame>
      <img src="https://mintcdn.com/cdata/EE4HlkSQpbRlgqOq/ja/images/choreo_developview.png?fit=max&auto=format&n=EE4HlkSQpbRlgqOq&q=85&s=1c81c3425a10bf125a5b0614449f76b6" alt="" width="2052" height="998" data-path="ja/images/choreo_developview.png" />
    </Frame>
  </Step>

  <Step>
    **Edit Code** をクリックしてローコードダイアグラムビューを開きます。

    <Frame>
      <img src="https://mintcdn.com/cdata/EE4HlkSQpbRlgqOq/ja/images/choreo_editcode.png?fit=max&auto=format&n=EE4HlkSQpbRlgqOq&q=85&s=06b3301ebee03c2902535158ed16b4cb" alt="" width="968" height="591" data-path="ja/images/choreo_editcode.png" />
    </Frame>
  </Step>

  <Step>
    Choreo はローコードダイアグラムビューに構成要素を自動生成します。この構成要素をハイライトして削除アイコンをクリックして削除します。

    <Frame>
      <img src="https://mintcdn.com/cdata/TfqVmUuBCnNRmW2K/ja/images/choreo_deleteconstruct.png?fit=max&auto=format&n=TfqVmUuBCnNRmW2K&q=85&s=2b6fcda339877d13718e0a9180ab16c2" alt="" width="1280" height="769" data-path="ja/images/choreo_deleteconstruct.png" />
    </Frame>
  </Step>

  <Step>
    Choreo が新しい構成要素の作成を促します。表示されたボタンをクリックしてオプションリストを開き、**Main** を選択します。

    <Frame>
      <img src="https://mintcdn.com/cdata/EE4HlkSQpbRlgqOq/ja/images/choreo_main.png?fit=max&auto=format&n=EE4HlkSQpbRlgqOq&q=85&s=b3440a134e3137132820144cdcda71bd" alt="" width="742" height="710" data-path="ja/images/choreo_main.png" />
    </Frame>
  </Step>

  <Step>
    表示された設定ペインで **Save** をクリックします。
  </Step>

  <Step>
    ダイアグラムビューにメイン構成要素が表示されます。**Start** の下に表示されるメニューで **Connector** をクリックします。

    <Frame>
      <img src="https://mintcdn.com/cdata/EE4HlkSQpbRlgqOq/ja/images/choreo_startconnector.png?fit=max&auto=format&n=EE4HlkSQpbRlgqOq&q=85&s=bf1f884a12020c73802a401bd0a7d19a" alt="" width="1076" height="1083" data-path="ja/images/choreo_startconnector.png" />
    </Frame>
  </Step>

  <Step>
    **Connectors** ダイアログで *CData* を検索します。**CData Connect** をクリックして **Connector** 設定ペインを開きます。

    <Frame>
      <img src="https://mintcdn.com/cdata/TfqVmUuBCnNRmW2K/ja/images/choreo_cdataconnect.png?fit=max&auto=format&n=TfqVmUuBCnNRmW2K&q=85&s=f1d1d47e40ffcef9d96cbe3fa4daaba9" alt="" width="1729" height="844" data-path="ja/images/choreo_cdataconnect.png" />
    </Frame>
  </Step>

  <Step>
    **Connector** 設定ペインで設定を入力します：

    * **Endpoint Name** を入力します。
    * **User** フィールドに Connect AI ユーザーのメールアドレスを引用符で囲んで入力します（例：*"[user@cdata.com](mailto:user@cdata.com)"*）。
    * **Password** フィールドに[前の手順で生成した PAT](#prerequisites) を引用符で囲んで入力します（例：*"SampleToken"*）。

    <Frame>
      <img src="https://mintcdn.com/cdata/EE4HlkSQpbRlgqOq/ja/images/choreo_logincredentials.png?fit=max&auto=format&n=EE4HlkSQpbRlgqOq&q=85&s=517a402e1e1fad5a8b3475703495707e" alt="" width="1724" height="1128" data-path="ja/images/choreo_logincredentials.png" />
    </Frame>
  </Step>

  <Step>
    **Save Connection** をクリックして設定を保存します。
  </Step>
</Steps>

Connect AI コネクタがコードエディターのローコードダイアグラムビューとソースコードビューの両方に表示されます。

<Frame>
  <img src="https://mintcdn.com/cdata/EE4HlkSQpbRlgqOq/ja/images/choreo_dualview.png?fit=max&auto=format&n=EE4HlkSQpbRlgqOq&q=85&s=69d75281b06034c2cc55d36484b94da2" alt="" width="1694" height="812" data-path="ja/images/choreo_dualview.png" />
</Frame>

アプリケーションロジックにコネクタアクションを追加できるようになりました。

## Choreo でコネクタアクションを使用する

アプリケーションロジックにアクションを追加するには、**new** ノードと **End** ノードの間にある **+** アイコンをクリックします。

<Frame>
  <img src="https://mintcdn.com/cdata/TfqVmUuBCnNRmW2K/ja/images/choreo_addbetween.png?fit=max&auto=format&n=TfqVmUuBCnNRmW2K&q=85&s=de7c9ab49b3814835bfb8eaf61226da5" alt="" width="857" height="776" data-path="ja/images/choreo_addbetween.png" />
</Frame>

表示されるメニューで **Action** をクリックします。

<Frame>
  <img src="https://mintcdn.com/cdata/TfqVmUuBCnNRmW2K/ja/images/choreo_addaction.png?fit=max&auto=format&n=TfqVmUuBCnNRmW2K&q=85&s=ab9a24a7d4c7e7e152ae0d46b9a9e2b6" alt="" width="1266" height="770" data-path="ja/images/choreo_addaction.png" />
</Frame>

Connect AI コネクタは以下の操作をサポートしています。

* **query**—データソースから[データをクエリ](#query-action)します
* **queryRow**—データソースの 1 行のデータをクエリします
* **execute**—DML および DDL 操作を実行します
* **batchExecute**—DML および DDL 操作のバッチを実行します
* **call**—ストアドプロシージャを実行します

これらの操作の詳細については、[CData Connect Ballerina ガイド](https://github.com/ballerina-platform/module-ballerinax-cdata.connect/blob/main/ballerina/Module.md#quickstart)を参照してください。

### クエリアクション

クエリアクションを設定するには、以下の手順に従ってください。

<Steps>
  <Step>
    コネクタの **Operation** で **query** を選択します。
  </Step>

  <Step>
    **SqlQuery** ボックスにクエリを入力します。

    * クエリを記述する際は、クエリするデータソースの **Connection Name** と **Data Source Name** を必ず指定してください。たとえば、`Salesforce1.Salesforce` のように指定します。
    * これらのパラメータは、Connect AI ダッシュボードの[ソース](/ja/Sources)ページに表示されます。

    <Frame>
      <img src="https://mintcdn.com/cdata/EE4HlkSQpbRlgqOq/ja/images/choreo_sqlquery.png?fit=max&auto=format&n=EE4HlkSQpbRlgqOq&q=85&s=c360ad447706cba2e71b807f284599a1" alt="" width="453" height="1005" data-path="ja/images/choreo_sqlquery.png" />
    </Frame>
  </Step>

  <Step>
    **Save** をクリックしてアクションを保存します。
  </Step>
</Steps>

## プログラムのデプロイ

プログラムに必要なアクションをすべて追加したら、以下の手順に従ってください。

<Steps>
  <Step>
    Web エディターで最終ソースコードをコミットしてプッシュし、変更を Choreo プラットフォームと同期します。
  </Step>

  <Step>
    Choreo コンソールの左ナビゲーションバーで **Deploy** をクリックします。
  </Step>

  <Step>
    **Build Area** の下で **Configure & Deploy** をクリックしてプログラムをデプロイします。
  </Step>

  <Step>
    プロンプトが表示されたら、以前に使用した Connect AI のユーザー名とパスワードを入力し、**Deploy** をクリックします。

    <Frame>
      <img src="https://mintcdn.com/cdata/EE4HlkSQpbRlgqOq/ja/images/choreo_deploy.png?fit=max&auto=format&n=EE4HlkSQpbRlgqOq&q=85&s=946f5f6ac7ac8041944174604c243561" alt="" width="2052" height="885" data-path="ja/images/choreo_deploy.png" />
    </Frame>
  </Step>
</Steps>

## 詳細について

Choreo と Connect AI の使用方法の詳細については、[CData Connect Ballerina ガイド](https://github.com/ballerina-platform/module-ballerinax-cdata.connect/blob/main/ballerina/Module.md#quickstart)を参照してください。