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

# Salesforce External Services

> このページでは、OpenAPI を使用して Salesforce External Services を Connect AI に接続する手順を説明します。ワークスペースと OpenAPI 仕様ファイルの使用が必要です。

## 前提条件

Salesforce に外部サービスを追加する前に、Salesforce で名前付き認証情報を作成する必要があります。Salesforce Setup で **Settings** > **Security** > **Named Credentials** を選択して名前付き認証情報を作成してください。

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

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

## OpenAPI 経由で接続する

OpenAPI を介して Salesforce External Services から Connect AI への接続を確立するには、以下の手順に従ってください。

<Steps>
  <Step>
    Connect AI の **Workspaces** 画面でワークスペースを選択し、ワークスペースの OpenAPI 仕様をダウンロードします。詳細については、[OpenAPI](/ja/API/OpenAPI) を参照してください。

    <Note>
      OpenAPI バージョン 3.0 を選択します。**Convert array types to strings** はオフのままにしてください。
    </Note>
  </Step>

  <Step>
    Salesforce にログインします。
    Salesforce Setup で **Platform Tools** > **Integrations** > **External Services** を選択します。

    <Frame>
      <img src="https://mintcdn.com/cdata/6pGFG61-t-b5cPZl/ja/images/sfl_externalservices.png?fit=max&auto=format&n=6pGFG61-t-b5cPZl&q=85&s=258ca55b7d6bc91b6586612c8bbe1e4d" alt="" width="346" height="542" data-path="ja/images/sfl_externalservices.png" />
    </Frame>
  </Step>

  <Step>
    **Add an External Service** をクリックします。
  </Step>

  <Step>
    **Select an API source from API Specification** をクリックし、**Next** をクリックします。
  </Step>

  <Step>
    **Provide Registration Details** で以下を入力します：

    * **External Service Name**—外部サービスの識別名を入力します。
    * **Description**—外部サービスの説明を入力します。
    * **Service Schema**—**Upload from local** を選択します。
    * **Select a Named Credential**—作成した名前付き認証情報を選択します。
  </Step>

  <Step>
    Connect AI からダウンロードした JSON ファイルをアップロードします。
  </Step>

  <Step>
    スキーマの検証が成功した場合は、**Save & Next** をクリックします。
  </Step>

  <Step>
    次のステップは **Select Operations** です。これらの操作は OpenAPI 仕様ファイルに含まれるコネクタのすべてのアクションです。アクションには、レコードの一覧表示、取得、作成、更新、削除など、テーブルに必要なすべての機能が含まれます。アクションには説明、入力パラメータ、出力パラメータが含まれます。

    <Frame>
      <img src="https://mintcdn.com/cdata/6pGFG61-t-b5cPZl/ja/images/sfl_externaloperations.png?fit=max&auto=format&n=6pGFG61-t-b5cPZl&q=85&s=2da317f67bdfdbdcb9cb9660cc279e5f" alt="" width="1425" height="559" data-path="ja/images/sfl_externaloperations.png" />
    </Frame>

    入力パラメータは `$top`、`$filter`、`$orderby` などの URL に追加されます。完全なパラメータリファレンスについては、[API Operations](/ja/API/OpenAPI#api-operations) を参照してください。入力パラメータは OData フィルタリングに基づいています。
    外部サービスに含める操作を選択します。
  </Step>

  <Step>
    外部サービスのアクション（入力パラメータと出力パラメータを含む）を確認します。入力または出力パラメータを変更する必要がある場合は、OpenAPI 仕様ファイルを編集する必要があります。

    <Frame>
      <img src="https://mintcdn.com/cdata/6pGFG61-t-b5cPZl/ja/images/sfl_reviewactions.png?fit=max&auto=format&n=6pGFG61-t-b5cPZl&q=85&s=d62762241204267c9ca7a26456543880" alt="" width="979" height="614" data-path="ja/images/sfl_reviewactions.png" />
    </Frame>
  </Step>

  <Step>
    **Finish** をクリックします。外部サービスが Salesforce の外部サービスリストに表示され、フローの構築に使用できるようになりました。
  </Step>
</Steps>
