スクリプトのポップアップ・メニューに独自のオプションを作成する

uf_um835.xml という xml ファイルを作成して区画の実行ディレクトリに配置することで、スクリプトのポップアップ・メニューに独自のオプションを追加できます。この処理はメモ帳を使って行うことができます。

以下は作成する uf_um835.xml の例です。

 
<?xml version="1.0"?>
<EXTRACT>
<MENUITEM>
  <PROPERTY NAME="CAPTION" VALUE="My user defined options" />
  <SUBMENUS>
    <SUBMENUITEM>
      <PROPERTY NAME="CAPTION" VALUE="My caption for option 1" />
      <PROPERTY NAME="STRING" VALUE="My returned text for option 1" />
    </SUBMENUITEM>
    <SUBMENUITEM>
      <PROPERTY NAME="CAPTION" VALUE="My caption for option 2 (multiple lines returned)" />
      <PROPERTY NAME="STRING" VALUE="My returned line 1 for option 2" />
      <PROPERTY NAME="STRING" VALUE="My returned line 2 for option 2" />
      <PROPERTY NAME="STRING" VALUE="My returned line 3 for option 2" />
    </SUBMENUITEM>
    <SUBMENUITEM>
      <PROPERTY NAME="CAPTION" VALUE="My caption for option 3 (handling quotes in the text)" />
      <PROPERTY NAME="STRING" VALUE="Quotes and greater than and less than need special handling" />
      <PROPERTY NAME="STRING" VALUE="Quote - &quot;" />
      <PROPERTY NAME="STRING" VALUE="Less than - &lt;" />
      <PROPERTY NAME="STRING" VALUE="Greater than - &gt;" />
    </SUBMENUITEM>
  </SUBMENUS>  
</MENUITEM>
</EXTRACT>

uf_um835.xml というファイルを作成して上記のテキストを貼り付け、uf_um835.xml を区画の実行ディレクトリに配置すると、RAMP スクリプトを編集するときに次の新しいオプションを表示できるようになります。

 
オプション 1 を選択すると、次のテキストがスクリプトに追加されます。

My returned text for option 1

 
オプション 2 を選択すると、次のテキストがスクリプトに追加されます。

My returned line 1 for option 2
My returned line 2 for option 2
My returned line 3 for option 2

 
オプション 3 を選択すると、次のテキストがスクリプトに追加されます。

Quotes and greater than and less than need special handling
Quote - "
Less than - <
Greater than - >

上記の xml では、1 番目のサブメニューに表示されるキャプションは caption プロパティから取得され、ユーザーがこのサブメニューをクリックした時にスクリプトに戻される値は String プロパティから取得されることを確認できます。

<SUBMENUITEM>
   <PROPERTY NAME="CAPTION" VALUE="My caption for option 1" />
   <PROPERTY NAME="STRING" VALUE="My returned text for option 1" />
</SUBMENUITEM>

オプション 2 からは、ユーザーがサブメニューをクリックした時に複数行がどのように返されるかを確認できます。

<SUBMENUITEM>
   <PROPERTY NAME="CAPTION" VALUE="My caption for option 2 (multiple lines returned)" />
   <PROPERTY NAME="STRING" VALUE="My returned line 1 for option 2" />
   <PROPERTY NAME="STRING" VALUE="My returned line 2 for option 2" />
   <PROPERTY NAME="STRING" VALUE="My returned line 3 for option 2" />
</SUBMENUITEM>

オプション 3 からは、スクリプトに返される値に引用符 （または大なり記号や小なり記号） を組み込む場合の特殊処理を確認できます。

<SUBMENUITEM>
  <PROPERTY NAME="CAPTION" VALUE="My caption for option 3 (handling quotes in the text)" />
  <PROPERTY NAME="STRING" VALUE="Quotes and greater than and less than need special handling" />
  <PROPERTY NAME="STRING" VALUE="Quote - &quot;" />
  <PROPERTY NAME="STRING" VALUE="Less than - &lt;" />
  <PROPERTY NAME="STRING" VALUE="Greater than - &gt;" />
</SUBMENUITEM>

作成した xml が有効で上記例の構造 (EXTRACT、MENUITEM、SUBMENUS、およびSUBMENUITEM) に従っている限り、この xml は正しく動作するはずです。