SugarCRMでオブジェクトを使用する
SugarCRMを外部ストレージシステムとして利用することで、SugarCRMのオブジェクト(例:リード)に対応するオブジェクトを作成することができます。 統合が完了すると、LiferayオブジェクトのデータはSugarCRMにのみ保存されます。 どちらのシステムも、ユーザーがいずれかの状況でエントリを追加、更新、または削除するたびに自動的に更新されます。
- この機能を使用するには、プロキシオブジェクト(LPS-135430) 機能フラグを有効にします。
- アカウント制限はSugarCRMのプロキシオブジェクトでは機能しません。
SugarCRMの準備
SugarCRMでは、LiferayとのAPI統合を設定するために、 OAuthキー を生成する必要があります。 その後、LiferayをSugarCRMに接続できます。
Liferay は OAuth2 を使用します。 SugarCRMでOAuthキーを生成する際は、OAuthバージョンフィールドで OAuth 2.0 を選択してください。
SugarCRMとLiferayを接続するための情報収集
Liferayがアクセストークンを取得し、OAuthパスワード認証を使用してSugarCRMインスタンスに接続するために必要な情報を収集します。
- インスタンスのルート API エンドポイント への URL
- OAuthトークンを取得するためのエンドポイントへのURL
- 生成された OAuth キー へのコンシューマー キー
- SugarCRM 管理者ユーザー のユーザー名とパスワード
接続を確立したら、SugarCRMオブジェクトに関する情報を収集します。
SugarCRMオブジェクトに関する情報の収集
Liferayオブジェクトを作成する前に、SugarCRMオブジェクトに必要なフィールドがすべて含まれていることを確認してください。 Liferayオブジェクトフィールドとリンクする前に、不足しているフィールドをすべて定義してください。
さらに、SugarCRM APIを使用してオブジェクトとそのフィールドを検査します。 LiferayオブジェクトをSugarCRMオブジェクトにマッピングするには、以下の情報を取得する必要があります。
- REST APIへの認証済みリクエストを行うための OAuthトークン
- オブジェクト (SugarCRM ではモジュールとして知られています) の GET エンドポイントを、Liferay の外部参照コード (ERC) オブジェクト定義として使用します。
- オブジェクトのGET APIエンドポイントから返される各フィールド名。Liferayオブジェクトの対応するフィールドのERCとして使用します。
Liferayインスタンスの設定
-
グローバルメニュー (
) を開き、 コントロールパネル → インスタンス設定 に移動します。 -
サードパーティ をクリックし、 SugarCRM 統合 のエントリに移動します。
-
SugarCRMインスタンスから取得した詳細情報を使用して、設定フォームに記入してください。
アクセストークンURL: インスタンスのルートAPIエンドポイントへのURL
ベースURL: OAuthトークンを取得するためのエンドポイントのURL
クライアントID: OAuthキーへのコンシューマーキー
許可タイプ:
パスワードパスワード: SugarCRMへの認証権限を持つ適切なユーザーのパスワード
ユーザー名: SugarCRMへの認証に必要な適切な権限を持つユーザーのユーザー名

-
をクリックして保存します。
SugarCRMストレージタイプを使用したオブジェクトの作成
SugarCRM にデータを保存するためのプロキシオブジェクトを作成するには、通常の手順に従いますが、保存タイプとして「SugarCRM」を選択してください。 これにより、オブジェクトが外部ストレージシステムとしてSugarCRMを使用するように設定されます。

Liferayオブジェクトのドラフトを作成する際に、ERCを編集してSugarCRMオブジェクトのRESTエンドポイントリソースパスの最後の部分と一致するようにします。 例えば、エンドポイントが /Contactsで終わる場合、ERC として Contacts を使用する必要があります。
データ損失を防ぐため、SugarCRM オブジェクトのすべてのフィールドにオブジェクト フィールド を追加します。 各フィールドがSugarCRMオブジェクトのフィールドに対応していることを確認してください。 次に、各フィールドを編集し、目的のSugarCRMフィールドにリンクする外部参照コードを追加します。 各 ERC に対して、対応するカスタム SugarCRM フィールドの名前を使用します (例: last_nameなど)。
各LiferayオブジェクトフィールドのERCが、対応するオブジェクトに対してSugarCRM REST APIから返されるフィールド名と一致していることを確認する必要があります。 例えば、Liferay オブジェクトの First Name フィールドでは、この理論上の SugarCRM オブジェクト JSON の first name にマッピングするために、ERC として first_name を使用する必要があります。
{
"名前": "ヴォルデモート卿"、
"名": "トム"、
"姓": "なぞなぞ"、
"タイトル": "領主"
}

公開されたLiferayオブジェクトのデータは、SugarCRMにのみ保存されます。 両システムは、ユーザーが関係の両側でエントリを追加、更新、または削除するたびに自動的に更新されます。