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

DDMフォームのアノテーション

自動生成された構成インターフェース UI は、一部の構成では単純すぎる可能性があります。動的データマッピング（DDM）フォームのアノテーションを使用して、レイアウトのUIをカスタマイズできます。

サンプルの構成UIを参照する

新しいLiferay インスタンスを起動し、以下を実行します。

docker run -it -m 8g -p 8080:8080 liferay/portal:7.4.3.132-ga132

http://localhost:8080でLiferayにサインインします。メールアドレス test@liferay.com とパスワード testを使用してください。プロンプトが表示されたら、パスワードを learnに変更します。

次に、以下の手順に従います。

ダウンロードして解凍します DDM フォーム注釈

curl https://resources.learn.liferay.com/examples/liferay-v1d9.zip -O

unzip liferay-v1d9.zip

モジュールのルートから、ビルドおよびデプロイします。
```
./gradlew deploy -Ddeploy.docker.container.id=$(docker ps -lq)
```
注

このコマンドは、デプロイされたjarをDockerコンテナの/opt/liferay/osgi/modulesにコピーするのと同じです。
Liferay Dockerコンテナコンソールでデプロイを確認します。
```
STARTED com.acme.v1d9.impl_1.0.0 [1650]
```
ブラウザで https://localhost:8080 を開き、 コントロールパネル → 構成 → システム設定に移動します。プラットフォームの下で、 サードパーティをクリックします。左側の［V1D9 Configuration］をクリックします。

DDMフォームのアノテーションの仕組みを以下に示します。

構成フォームを作成する

設定UIのすべてのフォーム項目を含む構成フォームインターフェイスを作成します。フィールドごとに@DDMFormFieldアノテーションを使用します。各フィールドのlabel、properties、typeなどの属性を定義します。

@DDMFormField(label = "%checkbox", properties = "showAsSwitcher=true")
public boolean checkbox();

@DDMFormField(label = "%date", type = "date")
public String date();

@DDMFormField(
	label = "%numeric", properties = "placeholder=%seconds",
	type = "numeric",
	validationErrorMessage = "%please-enter-an-integer-between-0-and-60-seconds",
	validationExpression = "(numeric >= 0) && (numeric <= 60)"
)
public String numeric();

@DDMFormField(
	label = "%select", optionLabels = {"%foo", "%bar"},
	optionValues = {"foo", "bar"}, type = "select"
)
public String select();

@DDMFormField(label = "%text")
public String[] text();

利用可能なすべてのフィールドタイプの詳細については、フォームフィールドタイプリファレンスをご覧ください。各フィールドタイプの タイプ 変数名については、フィールドタイプ定数を参照してください。

各フォーム項目にアノテーションを付けた後、DDMFormLayoutアノテーションを使用してクラス宣言のすぐ上にフォームのレイアウトを定義します。

@DDMForm
@DDMFormLayout(
	paginationMode = com.liferay.dynamic.data.mapping.model.DDMFormLayout.SINGLE_PAGE_MODE,
	value = {
		@DDMFormLayoutPage(
			{
				@DDMFormLayoutRow(
					{
						@DDMFormLayoutColumn(size = 6, value = "text"),
						@DDMFormLayoutColumn(size = 6, value = "checkbox")
					}
				),
				@DDMFormLayoutRow(
					{
						@DDMFormLayoutColumn(size = 6, value = "select"),
						@DDMFormLayoutColumn(size = 6, value = "numeric")
					}
				),
				@DDMFormLayoutRow(
					{@DDMFormLayoutColumn(size = 12, value = "date")}
				)
			}
		)
	}
)

DDMFormLayoutRowアノテーションとDDMFormLayoutColumnを使用して、UIに必要な行と列にフォーム項目を配置します。

フォーム宣言を書く

ConfigurationDDMFormDeclarationの新しい実装を作成して、新しい構成フォームクラスを登録します。

@Component(
	property = "configurationPid=com.acme.v1d9.internal.configuration.V1D9Configuration",
	service = ConfigurationDDMFormDeclaration.class
)
public class V1D9ConfigurationDDMFormDeclaration
	implements ConfigurationDDMFormDeclaration {

	@Override
	public Class<?> getDDMFormClass() {
		return V1D9ConfigurationForm.class;
	}

}

ComponentアノテーションのconfigurationPidは、構成インターフェイスの完全修飾クラス名と一致する必要があることに注意してください。

Capability: