Managing Data from External Systems
ご覧のページは、お客様の利便性のために一部機械翻訳されています。また、ドキュメントは頻繁に更新が加えられており、翻訳は未完成の部分が含まれることをご了承ください。最新情報は都度公開されておりますため、必ず英語版をご参照ください。翻訳に問題がある場合は、 こちら までご連絡ください。

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インスタンスに接続するために必要な情報を収集します。

接続を確立したら、SugarCRMオブジェクトに関する情報を収集します。

SugarCRMオブジェクトに関する情報の収集

Liferayオブジェクトを作成する前に、SugarCRMオブジェクトに必要なフィールドがすべて含まれていることを確認してください。 Liferayオブジェクトフィールドとリンクする前に、不足しているフィールドをすべて定義してください。

さらに、SugarCRM APIを使用してオブジェクトとそのフィールドを検査します。 LiferayオブジェクトをSugarCRMオブジェクトにマッピングするには、以下の情報を取得する必要があります。

Liferayインスタンスの設定

  1. グローバルメニュー (Global Menu) を開き、 コントロールパネル → インスタンス設定 に移動します。

  2. サードパーティ をクリックし、 SugarCRM 統合 のエントリに移動します。

  3. SugarCRMインスタンスから取得した詳細情報を使用して、設定フォームに記入してください。

    アクセストークンURL: インスタンスのルートAPIエンドポイントへのURL

    ベースURL: OAuthトークンを取得するためのエンドポイントのURL

    クライアントID: OAuthキーへのコンシューマーキー

    許可タイプ: パスワード

    パスワード: SugarCRMへの認証権限を持つ適切なユーザーのパスワード

    ユーザー名: SugarCRMへの認証に必要な適切な権限を持つユーザーのユーザー名

    SugarCRMの詳細情報を入力してください。

  4. をクリックして保存します。

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 を使用する必要があります。

{
   "名前": "ヴォルデモート卿"、
   "名": "トム"、
   "姓": "なぞなぞ"、
   "タイトル": "領主"
}

外部参照コードには、SugarCRMのフィールド名を使用してください。

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