カスタムオブジェクトからアカウントデータにアクセスする
Liferay 7.4 U35+/GA35+
いくつかのユースケースでは、カスタムオブジェクトからアカウントデータにアクセスしたい場合があります。 例えば、カスタム返品アプリケーションを構築している場合、返品リクエストを作成する際に、希望するアカウントと住所を選択するようユーザーに求めることができます。 このシナリオでは、ユーザーは返品アプリケーションで既存のアカウントとアドレスのエントリーにアクセスする必要があります。
これを実現するために、Liferayは[Objects]管理画面で[Account]と[Postal Address]のアプリケーションにアクセスできるようにしています。 ここでは、それらとカスタムオブジェクトの関連を定義することができます。 一度定義すれば、ユーザーはカスタムオブジェクトの生成された関連フィールドを使用して、希望するアカウントと住所のエントリーを選択することができます。

Accountオブジェクトには一般的なアカウントデータ(名前、メールアドレスなど)が格納され、Postal Addressオブジェクトにはアカウントの請求先住所と配送先住所が格納されます。 郵便番号の入力項目はアカウントUIで作成され、作成された個々のアカウントにのみ適用されます。
カスタムオブジェクトを[Accounts]および[Postal Address]システムオブジェクトに関連付ける場合、これらの関連はシステムオブジェクト側で定義し、1対多のタイプを使用する必要があります。 カスタムオブジェクトは、両方の関連の多数側である必要があります。
以下の手順に従って、カスタムオブジェクトからアカウントと住所のエントリーにアクセスする関連を設定してください。
-
グローバルメニュー (
) を開き、 コントロールパネル → オブジェクト に移動します。 -
Accounts オブジェクトの編集を開始します。
-
関係 タブに移動し、 追加 ボタン (
をクリックします。 -
ラベル と 名前 を入力してください。
-
タイプには、 1 対 多 を選択します。
-
オブジェクトには、カスタムオブジェクト を選択します。
![[Account]オブジェクトからカスタムオブジェクトへの一対多の関連を作成します。](https://resources.learn.liferay.com/images/dxp/latest/en/low-code/objects/creating-and-managing-objects/using-system-objects-with-custom-objects/accessing-accounts-data-from-custom-objects/images/02.png)
-
をクリックして保存します。
-
オブジェクト管理ページに戻り、 郵便住所 オブジェクトの編集を開始します。
-
関係 タブに移動し、 追加 (
をクリックします。 -
ラベル と 名前 を入力してください。
-
タイプには、 1 対 多 を選択します。
-
オブジェクトについては、前の関係で選択したのと同じカスタムオブジェクト を選択します。
-
パラメーターには、以前に作成したアカウントオブジェクト とのカスタムオブジェクト の関係を選択します。
これは、[Postal Address]のエントリーが特定のアカウントに限定されているために必要です。 このパラメーターは、利用可能なアドレスがアカウント関連のフィールド値に依存する従属リレーションシップを設定します。
![[Postal Address]オブジェクトからカスタムオブジェクトへの一対多のリレーションを作成し、カスタムオブジェクトの[Account]関連をパラメーターとして使用します。](https://resources.learn.liferay.com/images/dxp/latest/en/low-code/objects/creating-and-managing-objects/using-system-objects-with-custom-objects/accessing-accounts-data-from-custom-objects/images/03.png)
-
をクリックして保存します。
-
カスタムオブジェクトのデフォルトレイアウトとビューに、関連フィールドを追加します。 詳細な手順については、 オブジェクトレイアウトの設計 および オブジェクトビューの設計 を参照してください。

追加されると、ユーザーはカスタムオブジェクトで利用可能なアカウントとアドレスから選択できるようになります。 利用可能なアカウントオプションは、ユーザーのアカウントメンバーシップに依存し、利用可能なアドレスは、選択したアカウントに依存します。

デフォルトでは、オブジェクトのタイトルフィールドにはエントリIDが使用されます。 タイトルフィールドの値は、関係フィールドにおいて各入力オプションがエンドユーザーにどのように表示されるかを決定します。 必要に応じて、各オブジェクトのタイトルに異なるフィールドを使用するように設定することで、可読性を向上させることができます。
これを行うには、目的のオブジェクト定義の編集を開始し、 詳細 タブに移動し、 タイトルフィールドに別の値を選択します。 完了したら、 をクリックして保存 をクリックしてください。