各製品の資料を入手。
詳細はこちら →
Lightning Connect で Bitbucket External オブジェクトと連携
CData Connect Server をつかって、Bitbucket のデータ の仮想SQL Server として接続し、スマートデバイスやクラウドアプリケーションで利用。Connect Server と Salesforce Lightning Connect を使ってBitbucket オブジェクトを作成して、アプリケーションやダッシュボードでデータを使用。
最終更新日：2022-11-25
こんにちは！ウェブ担当の加藤です。マーケ関連のデータ分析や整備もやっています。
CData Connect Server を使ってSalesforce コンソールやSalesforce Mobile App からBitbucket のデータ に接続することができます。 この記事では、CData Connect Server およびSalesforce Lightning Connect をつかって、Bitbucket 外部オブジェクトを作成します。
CData Connect Server は、ピュアSQL のクラウドインターフェースをBitbucket に提供し、データを複製せずにSalesforce Lightning Connect からリアルタイムBitbucket のデータとの統合を手軽に実現します。Salesforce Lightning Connect はCData Connect Server をSQL Server データベースとして認識し、最適化されたデータ処理を使用してサポートされているすべてのSQL 操作（フィルタ、JOIN など）をBitbucket に直接プッシュして、サーバー側の処理を利用して、Bitbucket のデータを素早く返します。
- Connect Server にログインし、［DATA MODEL］をクリックします。
- ［Available Data Sources］から［Bitbucket］を選択します。
-
必要な認証プロパティを入力し、Bitbucket に接続します。
ほとんどのクエリでは、ワークスペースを設定する必要があります。唯一の例外は、Workspacesテーブルです。このテーブルはこのプロパティの設定を必要とせず、クエリを実行すると、Workspaceの設定に使用できるワークスペーススラッグのリストが提供されます。このテーブルにクエリを実行するには、スキーマを'Information'に設定し、SELECT * FROM Workspacesクエリを実行する必要があります。
Schemaを'Information'に設定すると、一般的な情報が表示されます。Bitbucketに接続するには、以下のパラメータを設定してください。
- Schema: ワークスペースのユーザー、リポジトリ、プロジェクトなどの一般的な情報を表示するには、これを'Information'に設定します。それ以外の場合は、クエリを実行するリポジトリまたはプロジェクトのスキーマに設定します。利用可能なスキーマの完全なセットを取得するには、sys_schemasテーブルにクエリを実行してください。
- Workspace: Workspacesテーブルにクエリを実行する場合を除き、必須です。Workspacesテーブルへのクエリにはこのプロパティは必要ありません。そのクエリはWorkspaceの設定に使用できるワークスペーススラッグのリストのみを返すためです。
Bitbucketでの認証
BitbucketはOAuth認証のみをサポートしています。すべてのOAuthフローからこの認証を有効にするには、カスタムOAuthアプリケーションを作成し、AuthSchemeをOAuthに設定する必要があります。
特定の認証ニーズ（デスクトップアプリケーション、Webアプリケーション、ヘッドレスマシン）に必要な接続プロパティについては、ヘルプドキュメントを必ず確認してください。
カスタムOAuthアプリケーションの作成
Bitbucketアカウントから、以下のステップを実行します。
- 設定（歯車アイコン）に移動し、ワークスペース設定を選択します。
- アプリと機能セクションで、OAuthコンシューマーを選択します。
- コンシューマーを追加をクリックします。
- カスタムアプリケーションの名前と説明を入力します。
- コールバックURLを設定します。
- デスクトップアプリケーションとヘッドレスマシンの場合、http://localhost:33333または任意のポート番号を使用します。ここで設定するURIがCallbackURLプロパティになります。
- Webアプリケーションの場合、信頼できるリダイレクトURLにコールバックURLを設定します。このURLは、ユーザーがアプリケーションにアクセスが許可されたことを確認するトークンを持って戻るWebの場所です。
- クライアント認証情報を使用して認証する予定の場合、これはプライベートコンシューマーですを選択する必要があります。ドライバーでは、AuthSchemeをclientに設定する必要があります。
- OAuthアプリケーションに与える権限を選択します。これにより、読み取りおよび書き込みできるデータが決まります。
- 新しいカスタムアプリケーションを保存するには、保存をクリックします。
- アプリケーションが保存された後、それを選択して設定を表示できます。アプリケーションのKeyとSecretが表示されます。これらを将来の使用のために記録してください。Keyを使用してOAuthClientIdを設定し、Secretを使用してOAuthClientSecretを設定します。
- Create & Test をクリックします。
- Edit Bitbucket Connection ページのPermissions タブに移動し、ユーザーベースのアクセス許可を更新します。
- USERS タブでAuthToken を取得します。
コネクションが構成されたら、Salesforce Lightning Connect からBitbucket に接続できるようになります。
Bitbucket データ にOData データソースとして接続
次の手順で、Connect Server からのフィードに接続する設定を行います。
- セールスフォースにログインして、［設定］→［開発］→［外部データソース］をクリックします。
- ［新規外部データソース］をクリックします。
- 以下のプロパティにデータを入力します。:
- 外部データソース: リストビューやレポートで使われるラベル名を入力。
- 名前: ユニークな識別子を入力。
- 種別: SQL Server を選択。
- 認証には、次のプロパティを設定します:
- 認証プロトコル: パスワード認証を選択します。OAuth 2.0 も選択可能です。
- Certificate: Enter or browse to the certificate to be used to encrypt and authenticate communications from Salesforce to your server.
- 管理者ユーザ名: Connect Server で設定したユーザー名を入力。
- 管理者パスワード: ユーザーのauth トークンを入力。
Bitbucket データ と同期したオブジェクトの作成
外部データソース作成後、次の手順で Bitbucket のデータを反映する外部オブジェクトを作成します。 Bitbucket 外部オブジェクトとBitbucket テーブルの定義を同期する必要があります。
- 作成した外部データソースを選択します。
- ［検証して同期］をクリックします。
- Bitbucket テーブルをクリックして、外部オブジェクトとします。
Salesforce オブジェクトとして Bitbucket データ にアクセス
Bitbucket のデータ を外部データソースとして追加し、Bitbucket テーブルをBitbucket 外部データソースとして同期すると、標準のSalesforce オブジェクトとして外部オブジェクトを使用することができます。
-
フィルターリストビュー付で新しいタブを作成する:
-
標準Salesforce オブジェクトと並べて Bitbucket 外部オブジェクトをディスプレイできます:
