必要に応じて，業務編集画面に表示される［Plugins］パレットおよびプラグインパーツのアイコンを変更します。［Plugins］パレットおよびプラグインパーツのアイコンの位置を次の図に示します。

図3-1　［Plugins］パレットおよびプラグインパーツのアイコンの位置

ひな形プラグイン作成コマンドを実行すると，uCosminexus Navigation Developerがデフォルトで提供しているアイコンが［Plugins］パレットおよびプラグインパーツに表示されます。

複数のプラグインを開発する場合，プラグインごとに異なるアイコンを作成すると，表示されるアイコンによってプラグインを区別できるようになります。作成したアイコンは次に示すディレクトリに格納してください。

uCosminexus Navigation Developerインストールディレクトリ\pluginSDK\plugin\プラグインID\images

アイコンは次の表に示す形式で作成してください。

表3-1　アイコンの作成形式

注意事項

Windows XP以外でプラグイン開発を実施する場合，アイコンをOSのインストールドライブ:\Program Filesディレクトリ以下などに作成する（ファイルを新規作成またはコピーする）ときに，Windowsの管理者権限がないユーザが作成すると，ファイルがユーザフォルダにリダイレクトされてしまうことがあります。そのため，Windowsの管理者権限があるユーザで追加してください。

入出力プラグイン用XMLファイル（ioaction.xml）は，ひな形プラグインの作成時に生成されます。入出力プラグイン用XMLファイルを編集して，次の内容を変更してください。

• 入出力プラグインの実行順序
• 入出力パラメタ定義
• 業務編集画面に表示される［Plugins］パレット，プラグインパーツ，およびツールチップの表示内容

入出力プラグイン用XMLファイルと業務編集画面の表示内容との対応を次の図に示します。

図3-2　入出力プラグイン用XMLファイルと業務編集画面の表示内容との対応

入出力プラグイン用XMLファイルの編集方法を説明します。入出力プラグイン用XMLファイル（ioaction.xml）の格納ディレクトリは，次のとおりです。

uCosminexus Navigation Developerインストールディレクトリ\pluginSDK\plugin\プラグインID\WEB-INF\conf

なお，Windows XP以外で入出力プラグイン用XMLファイルを編集する場合，エディタを［管理者として実行］で起動して，ファイルを編集してください。

入出力プラグイン用XMLファイル（ioaction.xml）の編集例を次に示します。太字の部分を編集します。

 
<?xml version="1.0" encoding="UTF-8"?>
<ioaction xmlns="http://model.xml.ioaction.navi.plugin.ucnp.soft.hitachi.co.jp" id="sample.IoAction" name="IoAction" version="2.0">
  <iopart id="io_part_1">
    <iotype name="sample.IoAction" />
    <iconURL url="/IoAction/images/sample_icon.gif"/>
    <priority value="700" />
    <execConfirm value="false" />
    <execPreview value="true" />
    <disableButtonType value="show_next_page" />
    <parameters type="title">
      <param name="IoAction" description="description of IoAction"/>
    </parameters>
    <parameters type="input">
      <param name="inputItemName1" description="description of inputItemName1"/>
      <param name="inputItemName2" description="description of inputItemName2"/>
      <param name="inputItemName3" description="description of inputItemName3"/>
    </parameters>
    <parameters type="output">
      <param name="outputItemName1" description="description of outputItemName1"/>
      <param name="outputItemName2" description="description of outputItemName2"/>
      <param name="outputItemName3" description="description of outputItemName3"/>
    </parameters>
  </iopart>
</ioaction>
 

入出力プラグイン用XMLファイル（ioaction.xml）の編集方法を次の表に示します。次の表に示した個所だけを修正してください。

表3-2　入出力プラグイン用XMLファイル（ioaction.xml）の編集方法

（凡例）

−：該当しない。

注※1

プレビュー画面で入出力プラグインを実行するかどうかは，サーバ処理実装インタフェース（IIoPluginController）のinputFromNodeメソッド，およびoutputToNodeメソッドのucnp.screen.ispreviewキーの値を使って実装することもできます。ただし，ucnp.screen.ispreviewキーによる設定は，サーバ処理実装インタフェース（IIoPluginController）で特殊な処理を設定する場合に利用します。そのため，処理をスキップするだけの場合は入出力プラグイン用XMLファイル（ioaction.xml）で指定してください。サーバ処理実装インタフェース（IIoPluginController）の詳細は，「5.3　IIoPluginController（サーバ処理実装インタフェース）」を参照してください。

注※2

ボタンの種別によって入出力プラグインの実行を抑止するかどうかは，サーバ処理実装インタフェース（IIoPluginController）のinputFromNodeメソッド，およびoutputToNodeメソッドのucnp.button.typeキーの値を使って実装することもできます。ただし，ucnp.button.typキーによる設定は，サーバ処理実装インタフェース（IIoPluginController）で特殊な処理を設定する場合に利用します。そのため，処理をスキップするだけの場合は入出力プラグイン用XMLファイル（ioaction.xml）で指定してください。サーバ処理実装インタフェース（IIoPluginController）の詳細は，「5.3　IIoPluginController（サーバ処理実装インタフェース）」を参照してください。

注※3

descriptionに指定した文字列が，そのままツールチップを表示させるときのHTML属性として使用されます。このためツールチップに表示する文字列を改行させたい場合は「
」を指定してください。「
」以外の制御文字を指定した場合の表示は保証されません。

注※4

長い文字列を指定した場合，プラグインパーツ上では後ろの方の文字が切れて表示されることがあります。入出力アクションコントローラクラス上では，ここで指定した文字列がそのまま使用されます。

参考

<parameters type="input">および<parameters type="output">の下位の<param>タグのname属性に指定した値は，サーバ処理実装インタフェース（IIoPluginController）のinputFromNodeメソッド，およびoutputToNodeメソッドのparamパラメタと戻り値に使用されます。

name属性に指定した値が使用される個所を次に示します。

paramパラメタ

• inputFromNodeメソッドの，名前ucnp.current.params.mapに対応する値のMapオブジェクトの名前
• outputToNodeメソッドの，名前ucnp.next.params.mapに対応する値のMapオブジェクトの名前

戻り値

• inputFromNodeメソッドの，名前ucnp.current.params.mapに対応する値のMapオブジェクトの名前
• outputToNodeメソッドの，名前ucnp.next.params.mapに対応する値のMapオブジェクトの名前

name属性に指定した値とサーバ処理実装インタフェース（IIoPluginController）との対応を次の図に示します。

図3-3　name属性に指定した値とサーバ処理実装インタフェース（IIoPluginController）との対応

サーバ処理実装インタフェース（IIoPluginController）の詳細は，「5.3　IIoPluginController（サーバ処理実装インタフェース）」を参照してください。

入出力プラグイン用XMLファイル（ioaction.xml）にツールチップの説明文を設定すると，業務編集画面でプラグインパーツをポイントしたときに説明が表示されます。設定できるツールチップを次に示します。

• 入出力プラグインの説明文
  プラグインパーツのタイトルに表示されるツールチップです。
  
• 入力パラメタの説明文
  プラグインパーツの入力パラメタに表示されるツールチップです。
  
• 出力パラメタの説明文
  プラグインパーツの出力パラメタに表示されるツールチップです。
  

設定する方法および値の詳細は「(2)　入出力プラグイン用XMLファイルの編集」を参照してください。

入出力プラグイン用XMLファイル（ioaction.xml）でプラグインの実行順序を変更できます。実行順序に指定できる値を次に示します。

• 100〜500
• 600〜900

同じノードに複数の入出力プラグインを配置した場合，実行順序に指定した値の昇順で入出力プラグインが実行されます。また，複数の入出力プラグインに同じ実行順序が指定されている場合，実行順序は不定となります。

値の詳細は「(2)　入出力プラグイン用XMLファイルの編集」を参照してください。

入出力プラグイン用XMLファイル（ioaction.xml）で入出力プラグインの実行時に確認ダイアログを表示するかどうかを指定できます。指定できる値を次に示します。

• true
• false

ノードに配置しているプラグインに，「true」を指定しているプラグインが含まれている場合は，inputFromNodeメソッドの実行時に入出力プラグインの確認ダイアログが表示されます。なお，設定値が「true」のプラグインが複数配置されていても，確認ダイアログは1回だけ表示されます。確認ダイアログで［キャンセル］を選択した場合は，KDCZ00266-Qメッセージが出力され，ノードに設定しているすべてのプラグインの処理が実行されません。

値の詳細は「(2)　入出力プラグイン用XMLファイルの編集」を参照してください。

プレビュー画面で入出力プラグインを実行するかどうかを，入出力プラグイン用XMLファイル（ioaction.xml）で指定できます。指定できる値を次に示します。

• true
• false

ノードに複数の入出力プラグインを配置している場合，「true」を指定している入出力プラグインだけが実行されます。

値の詳細は「(2)　入出力プラグイン用XMLファイルの編集」を参照してください。

入出力プラグインの実行を抑止するボタン種別を，入出力プラグイン用XMLファイル（ioaction.xml）で指定できます。指定できる値を次に示します。

• start
• show_next_page
• show_previous_page
• show_complete_page

ノードに複数の入出力プラグインを配置している場合，実行を抑止する設定になっている入出力プラグインは実行されません。

値の詳細は「(2)　入出力プラグイン用XMLファイルの編集」を参照してください。

次に示すファイルを変更して，プラグインが実行する処理を実装します。

uCosminexus Navigation Developerインストールディレクトリ\pluginSDK\plugin\プラグインID\WEB-INF\src\Javaパッケージ階層\controller\入出力アクションコントローラクラス.java

サーバ処理実装インタフェース（IIoPluginController）の詳細は，「5.3　IIoPluginController（サーバ処理実装インタフェース）」を参照してください。