こんにちは!ウェブ担当の加藤です。マーケ関連のデータ分析や整備もやっています。
CData Connect Cloud を使えば、Salesforce のようなクラウドベースのアプリケーションや、Salesforce Mobile App のようなモバイルアプリケーションからConfluence データにアクセスできます。この記事では、CData Connect Cloud とSalesforce Connect を使用して標準のSalesforce オブジェクトとともに外部のConfluence オブジェクトにアクセスします。
Connect Cloud アカウントの取得
以下のステップを実行するには、CData Connect Cloud のアカウントが必要になります。こちらから製品の詳しい情報とアカウント作成、30日間無償トライアルのご利用を開始できますので、ぜひご利用ください。
Connect Cloud を構成する
Salesforce Connect でConfluence データをリアルタイムで操作するには、Connect Cloud からConfluence に接続し、コネクションにユーザーアクセスを提供してConfluence データのOData エンドポイントを作成する必要があります。
(オプション)新しいConnect Cloud ユーザーの追加
必要であれば、Connect Cloud 経由でConfluence に接続するユーザーを作成します。
- ユーザーページに移動し、 Invite Users をクリックします。
- 新しいユーザーのE メールアドレスを入力して、 Send to invite the user をクリックします。
- ユーザーページからユーザーを確認および編集できます。
パーソナルアクセストークンの追加
OAuth 認証をサポートしていないサービス、アプリケーション、プラットフォーム、またはフレームワークから接続する場合は、認証に使用するパーソナルアクセストークン(PAT)を作成できます。きめ細かなアクセス管理を行うために、サービスごとに個別のPAT を作成するのがベストプラクティスです。
- Connect Cloud アプリの右上にあるユーザー名をクリックし、User Profile をクリックします。
- User Profile ページでPersonal Access Token セクションにスクロールし、 Create PAT をクリックします。
- PAT の名前を入力して Create をクリックします。
- パーソナルアクセストークンは作成時にしか表示されないため、必ずコピーして安全に保存してください。
Connect Cloud からConfluence に接続
CData Connect Cloud では、簡単なクリック操作ベースのインターフェースでデータソースに接続できます。
- Connect Cloud にログインし、 Add Connection をクリックします。
- Add Connection パネルから「Confluence」を選択します。
-
必要な認証プロパティを入力し、Confluence に接続します。
API Token を取得する方法
API token は、アカウントへの認証に必須です。トークンの生成には、Atlassian アカウントでサービスにログインし、API tokens > Create API token
に進みます。生成されたトークンが表示されます。
Confluence Cloud Account への接続
Cloud アカウントへの接続には、以下のプロパティを設定します(Password は、Server Instance への接続時のみ必要で、Cloud Account
への接続には不要になりました。):
- User: Confluence サーバーに認証するユーザー名。
- APIToken: 認証するユーザーに紐付けられたAPI Token。
- Url: JIRA エンドポイントのURL。例: https://yoursitename.atlassian.net
Confluence Server Instance への接続
Server instance への接続には以下を設定します:
- User: Confluence Instance に接続するユーザー名。
- Password: Confluence Instance に接続するユーザーのパスワード。
- Url: JIRA エンドポイントのURL。例: https://yoursitename.atlassian.net
- Create & Test をクリックします。
- Edit Confluence Connection ページのPermissions タブに移動し、ユーザーベースのアクセス許可を更新します。
Connect Cloud にConfluence OData エンドポイントを追加する
Confluence に接続したら、目的のテーブルのOData エンドポイントを作成します。
- OData ページに移動し、 Add to create new OData endpoints をクリックします。
- Confluence 接続(例:Confluence1)を選択し、Next をクリックします。
- 使用するテーブルを選択し、Confirm をクリックします。
コネクションとOData エンドポイントを設定したら、Salesforce Connect からConfluence データに接続できます。
外部データソースとしてConfluence データに接続する
以下のステップに従って、Connect Cloud に生成されたフィードに接続します。
- Salesforce にログインし、「Setup」->「Integrations」->「External Data Sources」とクリックします。
- 「New External Data Source」をクリックします。
- 以下のプロパティに値を入力します。
- External Data Sources:リストビューおよびレポートで使用するラベルを入力します。
- Name:個別の識別子を入力します。
- Type:「Salesforce Connect: OData 4.0」オプションを選択します。
- URL:Connect Cloud OData エンドポイントのURL(https://cloud.cdata.com/api/odata/service) を入力します。
- 「Format」メニューから「JSON」を選択します。
- 「Authentication」セクションでは、以下のプロパティを設定します。
- Identity Type:組織のすべてのメンバーが同じ認証情報を使用してConnect Cloud にアクセスする場合は、「Named Principal」を選択します。
各自の認証情報で接続する場合は、「Per User」を選択します。
- Authentication Protocol:基本認証を使用するには、「Password Authentication」を選択します。
- Certificate:Salesforce からサーバーへの通信を暗号化および認証するために使用する証明書を入力または参照します。
- Username:Connect Cloud のユーザー名を入力します。(例:user@mydomain.com)
- Password:ユーザーのPAT を入力します。
Confluence オブジェクトを同期する
外部データソースを作成したら、以下のステップに従って、データソースへの変更を反映するConfluence 外部オブジェクトを作成します。Confluence 外部オブジェクトの定義をConfluence テーブルの定義と同期します。
- 作成した外部データソースのリンクをクリックします。
- 「Validate and Scan」をクリックします。
- 外部オブジェクトとして使用するConfluence テーブルを選択します。
Confluence データにSalesforce オブジェクトとしてアクセスする
Confluence データを外部データソースとして追加し、Confluence テーブルを外部オブジェクトとして同期すると、標準のSalesforce オブジェクトと同じように外部Confluence オブジェクトを使用できるようになります。
クラウドアプリケーションからConfluence データへのアクセスを簡単に
これで、Salesforce からConfluence データへリアルタイムでクラウドベースの接続が可能です。Salesforce のようなクラウドアプリケーションから簡単に100を超えるSaaS、ビッグデータ、NoSQL ソースのデータにアクセスする方法の詳細については、Connect Cloud ページを参照してください。