atg - ATGコンポーネントに簡単な説明を追加するには?

Question

ATG でコンポーネント プロパティの短い説明を追加する方法。例: Nucleus コンポーネントに loggingDebug プロパティがある場合、短い説明は として表示されTrue if debug log events should be generatedます。コンポーネントで私のプロパティのそのような説明を作成する方法>

Answer 1

簡単な答え:

個々のプロパティの説明を追加することはできません。

ファイル$descriptionでを指定することにより、コンポーネントの説明を追加できます。.properties

より複雑な答え:

画面で表示するために、各 Nucleus コンポーネントはAdmin Servletdyn/adminに関連付けられています。管理画面をレンダリングするのは、コンポーネントの管理サーブレットです (JSP または JHTML ページではありません)。

特定のコンポーネントについて、管理インターフェースは、コンポーネントにクエリを実行して、画面のレンダリングに使用する管理サーブレットを決定します。

ATG は、多数の管理サーブレットをプラットフォームにパッケージ化します。デフォルトのものはServiceAdminServletであり、 に関連付けられていGenericServiceます。したがって、そこから拡張されるものGenericService(作成するほとんどのコンポーネント) は、ServiceAdminServlet によってレンダリングされる管理画面を取得します。リポジトリ クラスには別のものがあります。これが、リポジトリ コンポーネントの管理画面が他のほとんどのコンポーネントの管理画面と異なって見える理由です。

独自のクラスを実装し、カスタム管理サーブレットのインスタンスを返すようにコンポーネントのメソッド (インターフェースで定義)AdminServletを上書きすることで、コンポーネントに独自の管理インターフェースを実装できます。getAdminService()AdminableService

ただし、GenericServiceすでにインターフェースを実装しており、便利な拡張可能なフック メソッドを提供しており、独自の AdminServlet をゼロから作成するよりもcreateAdminServlet()拡張することをお勧めします。ServiceAdminServlet

このServiceAdminServletクラスは、printAdmin(...)必要なカスタム HTML を出力するためにオーバーライドするメソッドを定義します。

警告:

私の最初の回答では、より複雑なセクションを見逃していました。ただし、より完全になるように回答を更新しました。

私は 1998 年以来、ATG プラットフォームで非常に実践的に作業してきましたが、独自の管理インターフェイスを作成する理由は一度もありませんでした。