Salesforce Connect で外部Linear オブジェクトを作成する方法

加藤龍彦
加藤龍彦
デジタルマーケティング
CData Connect AI とSalesforce Connect を使用して、アプリやダッシュボードからアクセスできるLinear オブジェクトを作成します。



CData Connect AI を使えば、Salesforce のようなクラウドベースのアプリケーションや、Salesforce Mobile App のようなモバイルアプリケーションからLinear のデータにアクセスできます。この記事では、CData Connect AI とSalesforce Connect を使用して標準のSalesforce オブジェクトとともに外部のLinear オブジェクトにアクセスします。

Connect AI を構成する

Salesforce Connect でLinear のデータをリアルタイムで操作するには、Connect AI からLinear に接続し、コネクションにユーザーアクセスを提供してLinear のデータのOData エンドポイントを作成する必要があります。

パーソナルアクセストークンの追加

OAuth 認証をサポートしていないサービス、アプリケーション、プラットフォーム、またはフレームワークから接続する場合は、認証に使用するパーソナルアクセストークン（PAT）を作成できます。きめ細かなアクセス管理を行うために、サービスごとに個別のPAT を作成するのがベストプラクティスです。

  1. Connect AI アプリの右上にあるユーザー名をクリックし、User Profile をクリックします。
  2. User Profile ページでPersonal Access Token セクションにスクロールし、 Create PAT をクリックします。
  3. PAT の名前を入力して Create をクリックします。 Creating a new PAT
  4. パーソナルアクセストークンは作成時にしか表示されないため、必ずコピーして安全に保存してください。

Connect AI からLinear に接続

CData Connect AI では、簡単なクリック操作ベースのインターフェースでデータソースに接続できます。

  1. Connect AI にログインし、 Add Connection をクリックします。 Adding a Connection
  2. Add Connection パネルから「Linear」を選択します。 データソースを選択
  3. 必要な認証プロパティを入力し、Linear に接続します。

    Linear への認証には、個人用 API キーまたは OAuth 2.0 を使用できます。ご自身の Linear アカウントで接続する場合は、API キーを使うのが最も手軽です。

    API キーによる認証

    以下の接続プロパティを設定します。

    • AuthScheme：APIKey に設定します。
    • APIKey：Linear の個人用 API キー。

    個人用 API キーを作成するには、Linear にログインして Settings > Security & access > Personal API keys を開き、New API key を選択して作成します。キーは一度しか表示されないため、すぐにコピーしておきましょう。

    OAuth による認証

    OAuth を使用するには、Linear にカスタム OAuth アプリケーションを登録する必要があります（Settings > API > OAuth applications）。登録すると OAuthClientId と OAuthClientSecret が発行されます。対応しているフローは以下の 2 つです。

    • Authorization code：AuthScheme を OAuth、InitiateOAuth を GETANDREFRESH に設定し、OAuthClientId、OAuthClientSecret、およびアプリケーションで定義した CallbackURL（例：http://localhost:33333）を指定します。ドライバーがブラウザで Linear を開くので、アクセスを許可してください。
    • Client credentials：AuthScheme を OAuthClient に設定し、OAuthClientId と OAuthClientSecret を指定します。アプリケーション自体を認証するためブラウザ操作は不要で、マシン間（M2M）連携に適しています。

    デフォルトでは、ドライバーは read,write スコープをリクエストします。アクセストークンは有効期限が切れると自動で更新されます。

    接続の設定（Salesforce の例）
  4. Create & Test をクリックします。
  5. Edit Linear Connection ページのPermissions タブに移動し、ユーザーベースのアクセス許可を更新します。 権限を更新

Connect AI にLinear OData エンドポイントを追加する

Linear に接続したら、目的のテーブルのOData エンドポイントを作成します。

  1. OData ページに移動し、 Add to create new OData endpoints をクリックします。
  2. Linear 接続（例：Linear1）を選択し、Next をクリックします。
  3. 使用するテーブルを選択し、Confirm をクリックします。 テーブルを選択（NetSuite の例）

コネクションとOData エンドポイントを設定したら、Salesforce Connect からLinear のデータに接続できます。

外部データソースとしてLinear のデータに接続する

以下のステップに従って、Connect AI に生成されたフィードに接続します。

  1. Salesforce にログインし、「Setup」->「Integrations」->「External Data Sources」とクリックします。
  2. 「New External Data Source」をクリックします。
  3. 以下のプロパティに値を入力します。
    • External Data Sources：リストビューおよびレポートで使用するラベルを入力します。
    • Name：個別の識別子を入力します。
    • Type：「Salesforce Connect: OData 4.0」オプションを選択します。
    • URL：Connect AI OData エンドポイントのURL（https://cloud.cdata.com/api/odata/service） を入力します。
  4. 「Format」メニューから「JSON」を選択します。
  5. 「Authentication」セクションでは、以下のプロパティを設定します。
    • Identity Type：組織のすべてのメンバーが同じ認証情報を使用してConnect AI にアクセスする場合は、「Named Principal」を選択します。 各自の認証情報で接続する場合は、「Per User」を選択します。
    • Authentication Protocol：基本認証を使用するには、「Password Authentication」を選択します。
    • Certificate：Salesforce からサーバーへの通信を暗号化および認証するために使用する証明書を入力または参照します。
    • Username：Connect AI のユーザー名を入力します。（例：[email protected]）
    • Password：ユーザーのPAT を入力します。
Configuration settings for the data source (NetSuite の例)

Linear オブジェクトを同期する

外部データソースを作成したら、以下のステップに従って、データソースへの変更を反映するLinear 外部オブジェクトを作成します。Linear 外部オブジェクトの定義をLinear テーブルの定義と同期します。

  1. 作成した外部データソースのリンクをクリックします。
  2. 「Validate and Scan」をクリックします。
  3. 外部オブジェクトとして使用するLinear テーブルを選択します。
Select external objects （NetSuite の例）

Linear のデータにSalesforce オブジェクトとしてアクセスする

Linear のデータを外部データソースとして追加し、Linear テーブルを外部オブジェクトとして同期すると、標準のSalesforce オブジェクトと同じように外部Linear オブジェクトを使用できるようになります。

  • フィルタリストビューを使用して新しいタブを作成します。

    Viewing external objects from Salesforce （NetSuite の例）

  • 外部オブジェクトのレポートを作成します。

    Reporting on external objects from Salesforce （NetSuite の例）

クラウドアプリケーションからLinear のデータへのアクセスを簡単に

これで、Salesforce からLinear のデータへリアルタイムでクラウドベースの接続が可能です。Salesforce のようなクラウドアプリケーションから簡単に350を超えるSaaS、ビッグデータ、NoSQL ソースのデータにアクセスする方法の詳細については、Connect AI ページを参照してください。

はじめる準備はできましたか？

CData Connect AI の詳細、または無料トライアルにお申し込みください：

無料トライアル

この記事の内容

関連記事