interMediaオブジェクトとしてOracleデータベースに格納されているイメージ・コンテンツを表示するHTML IMGタグを挿入します。
JSP構文
<jbo:EmbedImage
datasource="datasourceInstanceName"
mediaattr="mediaAttributeName"
[[ rowkey="rowKeyString" ] | [ whereclause="whereClause" ]]
[ retrievepath="customRetrievePath" ]
[ width="imageWidth" ]
[ height="imageHeight" ]
[ border="borderPixel" ]
[ align="alignOption" ]
[[ alt="alternateText" ] | [ altattr="alternateAttributeName" ]]
[ longdesc="longDescription" ]
/>
説明
<jbo:EmbedImage>データ・タグにより、interMediaオブジェクトとしてデータベースに格納されているイメージ・コンテンツを表示するHTML IMGタグを挿入できます。
このタグは、<jbo:Row>または<jbo:RowsetIterate>データ・タグ内にネストできます。これらの2つのタグ内で使用されている場合、そのいずれかのタグで定義されている行が使用され、rowkey
およびwhereclause
属性は無視されます。それ以外の場合は、行を検索する際にrowkey
またはwhereclause
属性が使用されます。rowkey
はwhereclause
より優先されます。いずれの属性も指定されていない場合、このタグはデータソース・オブジェクトの現在の行を使用します。データソース・オブジェクトの現在の行を変更する場合は、<jbo:RowsetNavigate>データ・タグを使用できます。
挿入されるURLリンク([mediaFetchingURL])の書式は次のとおりです。
[retrievepath]?appModId=[アプリケーション・モジュールID]&rowSetName=[Rowset名]&contentCol=[mediaAttributeName]&rowKey=[rowKeyString]
デフォルトでは、[retrievepath]はあらかじめ提供されているordPlayMedia.jsp
というJSPページです。必要に応じて、独自のメディア配信コンポーネントを作成し、独自の検索パスを指定できます。
属性
datasource: interMediaオブジェクトへのアクセスに使用するデータソースID。データソースは、<jbo:DataSource>データ・タグを使用して作成します。
mediaattr: interMediaオブジェクトを含む(データソース内の)特定のビュー・オブジェクト属性の名前。
rowkey: (オプション)行を一意に識別するために使用する行識別子のテキスト・エンコーディング。
whereclause: (オプション)行を一意に特定する問合せのWHERE句。
retrievepath: (オプション)メディア・コンテンツ配信コンポーネント用の独自の検索パス。デフォルト値はordPlayMedia.jsp
です。
width: (オプション)表示されるイメージの幅。この属性を指定しない場合、<jbo:EmbedImage>データ・タグでは、interMediaがイメージ・コンテンツから解析した実際の幅が使用されます。interMediaでイメージを解析できない場合、width
属性は設定されません。
height: (オプション)表示されるイメージの高さ。この属性を指定しない場合、<jbo:EmbedImage>データ・タグでは、interMediaがイメージ・コンテンツから解析した実際の高さが使用されます。interMediaでイメージを解析できない場合、height
属性は設定されません。
border: (オプション)境界線のピクセル数。この属性の使用方法は、HTML IMGタグのBORDER属性と同じです。
align: (オプション)位置合せのオプション。この属性の使用方法は、HTML IMGタグのALIGN属性と同じです。
alt: (オプション)イメージのかわりに表示されるテキスト。altattr
属性を指定した場合、この属性は使用しないでください。
altattr: (オプション)代替テキストを含む属性の名前。alt
属性を指定した場合、この属性は使用しないでください。
longdesc: (オプション)イメージの長い説明。この属性の使用方法は、HTML IMGタグのLONGDESC属性と同じです。
例1:
<jbo:EmbedImage datasource="ds" mediaattr="Pic" whereclause="id = 2" alt="family reunion picture" />
HTML出力
<IMG SRC="[mediaFetchingURL]" ALT="family reunion picture" WIDTH="400" HEIGHT="350">
例2:
<jbo:RowsetNavigate datasource="ds" action="First" />
<jbo:EmbedImage datasource="ds" mediaattr="Pic" altattr="Description" border="2" width="200" height="200" />
HTML出力
<IMG SRC="[mediaFetchingURL]" ALT="[description text]" BORDER="2" WIDTH="200" HEIGHT="200">