getService

getService タグは、JSP ページ上で Info*Engine カスタムタグによって使用されている Info*Engine オブジェクト (com.infoengine.jsp.InfoEngine) への変数参照を設定します。

変数を定義すると、Info*Engine の Server Access Kit (SAK) のメソッドを使用するコード内でその変数を使用できます。たとえば、VDB 情報へのアクセス、グループの読み込み、行および列の書式設定などが可能です。

このタグは、ページ (com.infoengine.object.factory.Group) 内でタグによって使用されるコンテキストグループへの暗黙の変数参照も設定します。インスタンス化される変数は以下のとおりです。

CGI 照会仕様データから取得される属性を保持します。このデータは、テンプレートへのアクセスに使用される URL で受け取ります。また、Web ブラウザの POST リクエストの結果として受け取った HTML 形式データも保持します。この情報は、FORM コンテキストグループに保存されている情報と同じです。

Web ブラウザから Web サーバーへの通信に使用されるプロトコルから派生した属性を保持します。accept-language や auth-user などの属性を保持できます。このグループ内にある個々の属性の詳細については、現在の Web ブラウザと Web サーバー間のプロトコル仕様書を参照してください。この情報は、SERVER コンテキストグループに保存されている情報と同じです。

JSP ページへの接続時に処理される各クッキーの属性を持つ 1 つの要素を保持します。この情報は、COOKIE コンテキストグループに保存されている情報と同じです。

Webject が実行するタスクの資格証明マップを提供する属性を保持します。このマップには、バックエンドの情報システムとの接続を確立する際にアダプタによって使用される認証情報が含まれています。資格証明マップの各要素は、特定のバックエンドシステムへの接続に使用するユーザー名および関連付けられている資格証明を提供します。この情報は、Auth-Map コンテキストグループに保存されている情報と同じです。

このタグは JSP ページでのみ使用してください。スタンドアロン Info*Engine タスクでは使用しないでください。

各ページには getService タグを 1 つしか指定できません。

このタグはほかの Info*Engine タグに組み込むことができません。

Info*Engine オブジェクトの Java 変数名を指定します。このタグは変数を定義します。この属性に名前を指定する前に変数を定義する必要はありません。

以下の例は、ページが Info*Engine の core タグライブラリのタグを使用し、タグに ie プリフィックスを使用することを宣言します。この例では照会によって EMPLOYEEdata グループを作成し、グループ内の行数を表示します。この例では、行数を取得するために、getService タグを使用してサービスを ieObj として識別し、com.infoengine.object.factory.Group クラスの getElementCount メソッドを使用して行数を取得します。

<%@page language="java" session="true" errorPage="../IEError.jsp"%>
<%@ taglib uri="http://www.ptc.com/infoengine/taglib/core"
prefix="ie" %>
<html>
<body>

<ie:webject name="Query-Objects" type="OBJ">
<ie:param name="INSTANCE" data="com.myCompany.jdbcAdapter"/>
<ie:param name="CLASS" data="EMP"/>
<ie:param name="WHERE" data="()"/>
<ie:param name="GROUP_OUT" data="EMPLOYEEdata"/>
</ie:webject>

<ie:getService varName="ieObj"/>
<P>Search returned
<b><%=ieObj.getElementCount()%> employees. employees.>
</body>
</html>