test

N1 Grid Service Provisioning System 5.0 XML スキーマリファレンスガイド

第 6 章 プラグインユーザーインタフェーススキーマ

この章では、プラグインのユーザーインタフェースの定義に使用する、XML スキーマを説明します。この章の内容は、次のとおりです。

<pluginUI> 要素の概要

<pluginUI> 要素を使用すると、プラグインの作成者は、カスタムのショートカットページで表示される機能の制限付きセットを記述できます。機能セットはショートカットを介して表示されます。また、次のカテゴリに分類されています。

<pluginUI> 要素属性

<pluginUI> 要素には次の属性があります。

<pluginUI> 子要素

<pluginUI> 要素には次の要素が含まれます。

<icon> 要素

<icon> 要素は <pluginUI> 要素の子です。<icon> 要素は、プラグインアイコンの位置を宣言します。アイコンは GIF または JPEG ファイル形式であることが想定されています。アイコンの次元は、幅 32 ピクセル、高さ 26 ピクセルである必要があります。

<icon> 要素属性

<icon> 要素には 1 つの必須属性 jarPath があります。jarPath 属性は、プラグイン JAR ファイルのルートに相対的な、プラグインアイコンの位置を指定します。先頭の / または . 文字は使用できません。

<customPage> 要素

<customPage> 要素は <pluginUI> 要素の子で、ブラウザインタフェースのメニュー項目のリンク先カスタムページのコンテンツを定義します。 <customPage> 要素は、1 つ以上の <section> 要素を含み、name 属性を持っています。

<customPage> 要素属性

<customPage> 要素には、1 つの必須属性 name があります。name 属性は、カスタムページのブレッドクラムおよびタイトルセクションで使用されます。

<section> 要素

<section> 要素は <customPage> 要素の子で、カスタムページのセクションを定義します。<section> 要素には 1 つ以上の <entry> 要素があり、2 つの属性を持っています。

<entry> 要素

<entry> 要素は <section> 要素の子で、ユーザー操作のエントリポイントを定義します。<entry> 要素は 0 個以上の <action> 要素があり、次の属性を持っています。

<action> 要素

<action> 要素は <entry> 要素の子で、ユーザー操作を定義します。各 <action> 要素は、必ず 1 つの子要素を含む必要があります。

<action> 要素には次の 2 つの属性があります。

各 <action> 要素には、次の子要素のいずれかが含まれている必要があります。

<compCreate>

<compCreate> 要素は <action> 要素の子で、名前が指定されたコンポーネント型の「component create」ページへのリンクを定義します。

<compCreate> 要素には次の 1 つの必須属性があります。

  • typeName – コンポーネント型の名前。コンポーネント型は、当該プラグイン、または当該プラグインが直接依存するプラグインに含まれている必要があります。コンポーネント型を hidden として定義することはできません。pluginName は、fullPluginName#componentTypeName のように、コンポーネント型名の接頭辞である必要があります。

<compDetails>

<compDetails> 要素は <action> 要素の子で、名前付きコンポーネントの最新バージョンに関する「component details」ページへのリンクを定義します。

<compDetails> 要素には次の 2 つの必須属性があります。

  • path – コンポーネントの絶対パス。

  • name – コンポーネントの名前。コンポーネントは、当該プラグイン、または当該プラグインが直接依存するプラグインに含まれている必要があります。

<compList>

<compList> 要素は <action> 要素の子で、名前が指定されたコンポーネント型によりフィルタリングされる「component list」ページへのリンクを定義します。

<compList> 要素には次の 1 つの必須属性があります。

  • typeName – コンポーネント型の名前。コンポーネント型は、当該プラグイン、または当該プラグインが直接依存するプラグインに含まれている必要があります。コンポーネント型を hidden として定義することはできません。pluginName は、fullPluginName#componentTypeName のように、コンポーネント型名の接頭辞である必要があります。

<compWhereInstalled>

<compWhereInstalled> 要素は <action> 要素の子で、名前付きコンポーネントの最新バージョンに関する「Component Where Installed」ページへのリンクを定義します。

<compWhereInstalled> 要素には次の 2 つの必須属性があります。

  • path – コンポーネントの絶対パス。

  • name – コンポーネントの名前。コンポーネントは、当該プラグイン、または当該プラグインが直接依存するプラグインに含まれている必要があります。

<hostList>

<hostList> 要素は <action> 要素の子で、名前が指定されたホスト型によりフィルタリングされる「host list」ページへのリンクを定義します。

<hostList> 要素には次の 1 つの必須属性があります。

  • typeName – ホスト型の名前。ホスト型は、当該プラグイン、または当該プラグインが直接依存するプラグインに含まれている必要があります。ホスト型を hidden として定義することはできません。pluginName は、 fullPluginName#hostTypeName のように、ホスト型名の接頭辞である必要があります。

<planDetails>

<planDetails> 要素は <action> 要素の子で、名前付きプランの最新バージョンに関する「plan details」ページへのリンクを定義します。

<planDetails> 要素には次の 2 つの必須属性があります。

  • path – プランの絶対パス。

  • name – プランの名前。プランは、当該プラグイン、または当該プラグインが直接依存するプラグインに含まれている必要があります。

<pluginUI> 要素のサンプル XML

例 6–1 サンプル <pluginUI> 記述子ファイル

<?xml version="1.0" encoding="UTF-8"?>
<pluginUI menuItem="pluginName" 
          tooltip="view wl server pages"
          xmlns="http://www.sun.com/schema/SPS"
          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
          xsi:schemaLocation="http://www.sun.com/schema/SPS
                              pluginUI.xsd"
          schemaVersion="5.0">
  <icon jarPath="custom/gui/img/WLicon-small.gif"/>
  <customPage name="WebLogic">
    <section title="WebLogic application tasks" 
             description="capture and edit your WebLogic applications...">
      <entry title="enterprise applications (EARs)" 
             description="capture, edit and deploy your enterprise applications">
        <action text="view all" toolTip="view all EARs">
          <compList typeName="com.bigCo.logic.pluginName.WebLogic enterprise application"/>
        </action>
        <action text="create new" toolTip="create new enterprise application">
          <compCreate typeName="com.bigCo.logic.pluginName.WebLogic enterprise application"/>
        </action>
      </entry>
      <entry title="web applications (WARs)" 
             description="capture, edit and deploy web applications">
        <action text="view all" toolTip="view all WARs">
          <compList typeName="com.bigCo.logic.pluginName.WebLogic web application"/>
        </action>
        <action text="create new" toolTip="create new webapp">
          <compCreate typeName="com.bigCo.logic.pluginName.WebLogic web application"/>
        </action>
      </entry>
      <entry title="java archives containing EJBs (JARs)" 
             description="capture, edit and deploy your JARS containing EJBs">
        <action text="view all" toolTip="view all JARs">
          <compList typeName="com.bigCo.logic.pluginName.WebLogic EJB"/>
        </action>
        <action text="create new" toolTip="create new java archive containing EJBs">
          <compCreate typeName="com.bigCo.logic.pluginName.WebLogic EJB"/>
        </action>
      </entry>
    </section>
    <section title="WebLogic infrastructure" 
             description="create and edit your WebLogic infrastructure...">
      <entry title="admin servers" 
             description="WebLogic domains / administration servers">
        <action text="manage admin servers" toolTip="manage WebLogic admin servers">
          <compDetails path="/com/bea/weblogic" name="WL Admin Server 7.0"/>
        </action>
        <action text="view admin servers" toolTip="list of WebLogic admin servers">
          <compWhereInstalled path="/com/bea/weblogic" name="WL Admin Server 7.0"/>
        </action>
      </entry>
      <entry title="clusters" 
             description="WebLogic clusters">
        <action text="manage clusters" toolTip="manage WebLogic clusters">
          <compDetails path="/com/bea/weblogic" name="WL Cluster"/>
        </action>
        <action text="view clusters" toolTip="list of WebLogic clusters">
          <compWhereInstalled path="/com/bea/weblogic" name="WL Cluster"/>
        </action>
      </entry>
      <entry title="managed servers" 
             description="WebLogic server instances">
        <action text="manage server instances" toolTip="WebLogic managed servers">
          <compDetails path="/com/bea/weblogic" name="WL Managed Server"/>
        </action>
        <action text="view managed servers" toolTip="list of WebLogic managed servers">
          <compWhereInstalled path="/com/bea/weblogic" name="WL Managed Server"/>
        </action>
         <action text="update managed servers" toolTip="run a plan on managed servers">
          <planDetails path="/com/bea/weblogic/updates" name="updatePlan"/>
        </action>
     </entry>
    </section>
  </customPage>
</pluginUI>