Format-Group

特定の文字を情報に追加して、情報の特定のグループをフォーマットします。たとえば、この Webject を使用して、給与額のグループの各アイテムの先頭にドルマークを付けることができます。この Webject を使用して、フォーマットを目的として複数の属性を 1 つの長い属性に結合することもできます。

<ie:webject name=Format-Group type=GRP>
  <ie:param name="ATTRIBUTE" data="attribute_name"/>
  <ie:param name="CLASS" data="class"/>
  <ie:param name="FORMAT" data="format_specifier"/>
  <ie:param name="GROUP_IN" data="input_group_name"/>
  <ie:param name="GROUP_OUT" data="output_group"/>
  <ie:param name="LOCALE" data="language"/>
</ie:webject>

フォーマットするグループのデータ文字列を識別します。GROUP_OUT の作成時に使用する属性を定義します。GROUP_OUT の作成時には、ATTRIBUTE パラメータで明示的に指定された属性のみを使用します。

GROUP_OUT パラメータによって指定された出力グループに含まれているオブジェクトのタイプを指定します。たとえば、Webject が CLASS=MyClassName と GROUP_OUT=data_1 を指定する場合、出力グループの XML 表現には以下のタグが含まれます。

ATTRIBUTE パラメータで指定されたデータ文字列をフォーマットする方法を指定します。FORMAT パラメータの値は、Java クラス java.text.MessageFormat で有効である必要があります。GROUP_OUT の各行には FORMAT パラメータと同数の属性があります。

各 FORMAT パラメータは、{n} などの置換文字列を含めることができます。ここで、n は負ではない整数です。これらの文字列は、n によって定義されたオフセットを持つ未使用の次の属性によって GROUP_OUT 内で置き換えられます。オフセットは、FORMAT パラメータの処理を開始した時点で、未使用の最初の ATTRIBUTE 値を基準としています。

たとえば、n が 0 の場合は、すぐ次の未使用の ATTRIBUTE 値が置換され、n が 1 の場合は、2 番目の未使用の属性値が置換され、n が 2 の場合は、3 番目の未使用の属性値が置換されるというように処理が行われます。FORMAT パラメータの処理が完了すると、すべての置換された ATTRIBUTE 値が使用済みとしてマークされます。

en-US (ISO 言語名、ダッシュ、ISO 国コード) などの、Java クラスロケールの文字列表現です。指定していない場合は、一般的に Info*Engine を実行しているプラットフォームに定義されたデフォルトのロケールをデフォルトに設定します。このパラメータはオプションです。

以下の例は、置換文字列を使用して現在の VDB グループのデータをフォーマットします。フォーマットされたデータを en-US の特定の Java クラスロケールを持つ "formatted results" という名前の出力グループに配置します。

<%@page language="java" session="false"%>
<%@taglib uri="http://www.ptc.com/infoengine/taglib/core"
                                               prefix="ie"%>

<ie:task uri="com/company/CreateGroup.xml"/>
<ie:webject name="Format-Group" type="GRP">
  <ie:param name="GROUP_IN" data="createdgroup"/>
  <ie:param name="ATTRIBUTE" data="NAME"/>
  <ie:param name="ATTRIBUTE" data="EMAIL"/>
  <ie:param name="ATTRIBUTE" data="NAME"/>
  <ie:param name="ATTRIBUTE" data="EMAIL"/>
  <ie:param name="ATTRIBUTE" data="EMAIL"/>
  <ie:param name="ATTRIBUTE" data="NAME"/>
  <ie:param name="FORMAT" data="{0}"/>
  <ie:param name="FORMAT" data="{0}"/>
  <ie:param name="FORMAT" data="Name: {0} lives at {1}"/>
  <ie:param name="FORMAT" data="Email: {0} --- Name: {1}"/>
  <ie:param name="CLASS" data="resultGroup"/>
  <ie:param name="GROUP_OUT" data="formatted results"/>
  <ie:param name="LOCALE" data="en-US"/>
</ie:webject>

必須	選択	オプション
ATTRIBUTE		CLASS
FORMAT		LOCALE
GROUP_IN
GROUP_OUT