org.opengion.hayabusa.taglib

## クラス ExcelFileTag

- java.lang.Object
- - javax.servlet.jsp.tagext.TagSupport
  - - javax.servlet.jsp.tagext.BodyTagSupport
    - - org.opengion.hayabusa.taglib.CommonTagSupport
      - - org.opengion.hayabusa.taglib.ExcelFileTag

- すべての実装されたインタフェース:
    Serializable, BodyTag, IterationTag, JspTag, Tag, TryCatchFinally

      public class ExcelFileTag
      extends CommonTagSupport

       ExcelFileTag は、各種パラメータを指定して、Excelファイルの操作をおこなうタグです。

       主に、ExcelModel、POIUtil 、JacobUtil の各機能をJSP上で使用できるようにしました。
       入力の file1 を加工して、file2 を出力するというのが、基本パターンになります。
       file1 と、file2 を同じ値に指定した場合は、上書き保存されます。

       ※ (saveAs,toPrint)属性は、JACOB(Java COM Bridge)の使用が前提です。
          これは、JavaからのCOMオートメーションコンポーネント呼び出しを可能とする
          JAVA-COMブリッジです。COMライブラリのネイティブな呼び出しにJNIを使います。
          JACOBは、32bitおよび64bitのJVMをサポートするX86およびx64環境で動作します。
          http://sourceforge.jp/projects/sfnet_jacob-project/  (日本語プロジェクト)
          http://sourceforge.net/projects/jacob-project/       (本家)

          設定：
             jacob-1.18-M2.zip をダウンロードし、
               ①jacob-1.18-M2-x64.dll または、jacob-1.18-M2-x86.dll を、
                 Windowsのシステムディレクトリにコピーします。 （例：C:\Windows\System32）
               ②jacob.jar を、クラスパスに登録します。
                 ここでは、名称を、jacob-1.18-M2.jar に変更し、jre\lib\ext にコピーしています。

  関連項目:
    直列化された形式
  形式サンプル:

         ●形式：<og:excelFile action="…" fileURL="…" >･･･</og:file>
         ●body：なし

         ●Tag定義：
           <og:excelFile
               fileURL            【TAG】操作するファイルのディレクトリを指定します (初期値:FILE_URL[=filetemp/])
               file1            ○【TAG】入力ファイル名を指定します(必須)
               file2              【TAG】出力ファイル名を指定します
               sheetName          【TAG】EXCELファイルを読み込むときのシート名を設定します(初期値:指定なし)
               sheetNos           【TAG】EXCELファイルを読み込むときのシート番号を複数設定できます(初期値:0)
               sheetConstKeys     【TAG】EXCELファイルを読み込むときの固定値となるカラム名(CSV形式)
               sheetConstAdrs     【TAG】EXCELファイルを読み込むときの固定値となるアドレス(行-列,行-列,・・・)
               useActiveWorkbook  【TAG】EXCEL出力時に、セルの有効範囲を設定するかどうかを指定します(初期値:false)
               addTitleSheet      【TAG】EXCEL出力時に、存在するSheet名一覧を作成する場合に、そのSheet名を指定します。
               addImageFile       【TAG】画像ファイルを挿入します(画像ファイル名 シート番号 行 列)
               valueType          【TAG】sheetConstXXX,readXXXX のパラメータに登録する方法を指定します(CSV,LIST,MAP)
               readText           【TAG】ファイルを読み込んで、内容を 引数の変数にセットします。
               readSheet          【TAG】ファイルを読み込んで、シート一覧を 引数の変数にセットします。
               readName           【TAG】ファイルを読み込んで、名前一覧を 引数の変数にセットします。
               readStyle          【TAG】ファイルを読み込んで、スタイル名を 引数の変数にセットします。
               useConverter       【TAG】file1 のシート、セル、オブジェクトのテキストを変換します。
               convFile           【TAG】useConverter=true 時に、変換対応表をファイルから読み取ります。
               convMap            【TAG】useConverter=true 時に、変換対応表をMapから読み取ります。
           ※  saveAs             【TAG】file1 を指定のファイルの拡張子に合わせた変換を行って保存します(xls,xlsx,pdf)。
           ※  toPrint            【TAG】file1 を指定のプリンタに印刷します。
               scope              【TAG】キャッシュする場合のスコープ(request,session)を指定します(初期値:request)
               caseKey            【TAG】このタグ自体を利用するかどうかの条件キーを指定します(初期値:null) 5.7.7.2 (2014/06/20)
               caseVal            【TAG】このタグ自体を利用するかどうかの条件値を指定します(初期値:null) 5.7.7.2 (2014/06/20)
               caseNN             【TAG】指定の値が、null/ゼロ文字列 でない場合(Not Null=NN)は、このタグは使用されます(初期値:判定しない) 5.7.7.2 (2014/06/20)
               caseNull           【TAG】指定の値が、null/ゼロ文字列 の場合は、このタグは使用されます(初期値:判定しない) 5.7.7.2 (2014/06/20)
               caseIf             【TAG】指定の値が、true/TRUE文字列の場合は、このタグは使用されます(初期値:判定しない)
               debug              【TAG】デバッグ情報を出力するかどうか[true/false]を指定します(初期値:false)
           />

         ●使用例
            ・EXCEL を読み取って、シート名の一覧の目次を、先頭シートに追加します。
                <og:excelFile  file1="input.xls" file2="input.xls" addTitleSheet="Title" />

  変更履歴:

    6.2.6.0 (2015/06/19) 新規作成

  機能分類
    その他部品
  バージョン
    6.2
  作成者
    Kazuhiko Hasegawa
  導入されたバージョン:
    JDK8.0,

- - ### フィールドのサマリー

    - ### クラスから継承されたフィールド org.opengion.hayabusa.taglib.CommonTagSupport

      `BR, BUFFER_MIDDLE, CR`

    - ### クラスから継承されたフィールド javax.servlet.jsp.tagext.BodyTagSupport

      `bodyContent`

    - ### クラスから継承されたフィールド javax.servlet.jsp.tagext.TagSupport

      `id, pageContext`

    - ### インタフェースから継承されたフィールド javax.servlet.jsp.tagext.BodyTag

      `EVAL_BODY_BUFFERED, EVAL_BODY_TAG`

    - ### インタフェースから継承されたフィールド javax.servlet.jsp.tagext.IterationTag

      `EVAL_BODY_AGAIN`

    - ### インタフェースから継承されたフィールド javax.servlet.jsp.tagext.Tag

      `EVAL_BODY_INCLUDE, EVAL_PAGE, SKIP_BODY, SKIP_PAGE`

  - ### コンストラクタのサマリー

    コンストラクタ
    コンストラクタと説明
    `ExcelFileTag()` デフォルトコンストラクター

  - ### メソッドのサマリー

    すべてのメソッド インスタンス・メソッド concreteメソッド
    修飾子とタイプ | メソッドと説明
    --- | ---
    `int` | `doEndTag()` Taglibの終了タグが見つかったときに処理する doEndTag() を オーバーライドします。
    `protected void` | `release2()` タグリブオブジェクトをリリースします。
    `void` | `setAddImageFile(String imgFile)` 【TAG】指定のシートの行・列の箇所に、イメージファイルを挿入します。
    `void` | `setAddTitleSheet(String sheetName)` 【TAG】EXCEL出力時に、Sheet一覧を作成する場合のSheet名を指定します。
    `void` | `setConvFile(String cfile)` 【TAG】useConverter=true 時に、変換対応表をファイルから読み取ります。
    `void` | `setConvMap(String cmap)` 【TAG】useConverter=true 時に、変換対応表をMapから読み取ります。
    `void` | `setFile1(String fname)` 【TAG】基準となるファイル名を指定します(コマンドの左辺のファイル名です)。
    `void` | `setFile2(String fname)` 【TAG】内部 Workbook オブジェクトをファイルに書き出します。
    `void` | `setFileURL(String url)` 【TAG】操作するファイルのディレクトリを指定します (初期値:FILE_URL[=filetemp/])。
    `void` | `setReadName(String read)` 【TAG】ファイルを読み込んで、名前一覧を 引数の変数にセットします。
    `void` | `setReadSheet(String read)` 【TAG】ファイルを読み込んで、シート一覧を引数の変数にセットします。
    `void` | `setReadStyle(String read)` 【TAG】ファイルを読み込んで、スタイル名を 引数の変数にセットします。
    `void` | `setReadText(String read)` 【TAG】ファイルを読み込んで、内容を引数の変数にセットします。
    `void` | `setSaveAs(String name)` 【TAG】file1 を指定のファイルの拡張子に合わせた変換を行って保存します(xls,xlsx,pdf)。
    `void` | `setScope(String scp)` 【TAG】キャッシュする場合のスコープ(request,session)を指定します(初期値:request)。
    `void` | `setSheetConstAdrs(String constAdrs)` 【TAG】EXCELファイルを読み込むときのシート単位の固定値を設定するためのキーに対応するアドレスをCSV形式で指定します。
    `void` | `setSheetConstKeys(String constKeys)` 【TAG】EXCELファイルを読み込むときのシート単位の固定値を設定するためのキーをCSV形式で指定します。
    `void` | `setSheetName(String sheet)` 【TAG】EXCELファイルを読み込むときのシート名を設定します(初期値:指定なし)。
    `void` | `setSheetNos(String sheet)` 【TAG】EXCELファイルを読み込むときのシート番号を指定します(初期値:0)。
    `void` | `setToPrint(String printer)` 【TAG】file1 を指定のプリンタに印刷します。
    `void` | `setUseActiveWorkbook(String useActWB)` 【TAG】EXCEL出力時に、セルの有効範囲を設定するかどうかを指定します(初期値:false)。
    `void` | `setUseConverter(String useConv)` 【TAG】シート名、セル、オブジェクトのテキストを変換するかどうか指定します(初期値:false)。
    `void` | `setValueType(String type)` 【TAG】sheetConstXXX,readXXXX のパラメータに登録する方法を指定します(CSV/LIST/MAP)。
    `String` | `toString()` このオブジェクトの文字列表現を返します。

    - ### クラスから継承されたメソッド org.opengion.hayabusa.taglib.CommonTagSupport

      `add, add, addEventColumn, addEventColumn, check, commitTableObject, debugPrint, doAfterBody, doCatch, doFinally, doStartTag, get, getApplicationInfo, getAttributes, getBodyRawString, getBodyString, getContextAttribute, getContextPath, getCookie, getCSVParameter, getCSVParameter, getDataCondition, getDateFormat, getDBColumn, getDBFunctionName, getDocumentLink, getGUIInfo, getGUIInfoAttri, getHostName, getLabel, getLabelInterface, getLanguage, getLASTAttri, getLongLabel, getMsg, getMsglbl, getNVLAttri, getObject, getParameterNames, getParameterRows, getRequest, getRequestAttribute, getRequestCacheData, getRequestParameter, getRequestParameterValues, getRequestValue, getRequestValue, getRequestValues, getReservedParameter, getReservedValue, getResource, getSanitizedBodyString, getScope, getSessionAttribute, getSumRequestValue, getTagName, getTransaction, getUser, getUserEditInfo, getUserInfo, isAjaxSubmitRequest, isDebug, isNoTransitionRequest, isNull, jspPrint, makeUrl, removeContextAttribute, removeObject, removeRequestAttribute, removeSessionAttribute, set, setAjaxSubmitRequest, setCaseIf, setCaseKey, setCaseNN, setCaseNull, setCaseVal, setContextAttribute, setCookie, setDebug, setLanguage, setLbl, setNoTransitionRequest, setObject, setObject, setParameterNames, setParameterRows, setRequestAttribute, setRequestCacheData, setSessionAttribute, setUserInfo, startQueryTransaction, sys, sysBool, sysInt, useMainTrans, useQuotCheck, useTag, useXssCheck`

    - ### クラスから継承されたメソッド javax.servlet.jsp.tagext.BodyTagSupport

      `doInitBody, getBodyContent, getPreviousOut, release, setBodyContent`

    - ### クラスから継承されたメソッド javax.servlet.jsp.tagext.TagSupport

      `findAncestorWithClass, getId, getParent, getValue, getValues, removeValue, setId, setPageContext, setParent, setValue`

    - ### クラスから継承されたメソッド java.lang.Object

      `clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait`

    - ### インタフェースから継承されたメソッド javax.servlet.jsp.tagext.Tag

      `getParent, setPageContext, setParent`

- - ### コンストラクタの詳細

    - #### ExcelFileTag

          public ExcelFileTag()

      デフォルトコンストラクター
      変更履歴:

        6.4.2.0 (2016/01/29) PMD refactoring. Each class should declare at least one constructor.

  - ### メソッドの詳細

    - #### doEndTag

          public int doEndTag()

      Taglibの終了タグが見つかったときに処理する doEndTag() を オーバーライドします。
      定義:
        `doEndTag` インタフェース内 `Tag`
      オーバーライド:
        `doEndTag` クラス内 `CommonTagSupport`
      戻り値:
        後続処理の指示
      変更履歴:

        6.2.6.0 (2015/06/19) 新規作成
        6.3.1.0 (2015/06/28) readText の取得方法を変更する。

    - #### release2

          protected void release2()

      タグリブオブジェクトをリリースします。 キャッシュされて再利用されるので、フィールドの初期設定を行います。
      オーバーライド:
        `release2` クラス内 `CommonTagSupport`
      変更履歴:

        6.2.6.0 (2015/06/19) 新規作成

    - #### setFileURL

          public void setFileURL(String url)

      【TAG】操作するファイルのディレクトリを指定します (初期値:FILE_URL[=filetemp/])。
      パラメータ:
        `url` - ファイルURL
      関連項目:
        `SystemData.FILE_URL`
      説明:

             この属性で指定されるディレクトリのファイルを操作します。
             指定方法は、通常の fileURL 属性と同様に、先頭が、'/' (UNIX) または、２文字目が、
             ":" (Windows)の場合は、指定のURLそのままのディレクトリに、そうでない場合は、
             (初期値:システム定数のFILE_URL[=filetemp/])。

      変更履歴:

        6.2.6.0 (2015/06/19) 新規作成
        6.4.2.1 (2016/02/05) URLの最後に、"/" を追加する処理を廃止。

    - #### setFile1

          public void setFile1(String fname)

      【TAG】基準となるファイル名を指定します(コマンドの左辺のファイル名です)。
      パラメータ:
        `fname` - ファイル名１
      説明:

             コマンドの左辺のファイル名です。

      変更履歴:

        6.2.6.0 (2015/06/19) 新規作成

    - #### setFile2

          public void setFile2(String fname)

      【TAG】内部 Workbook オブジェクトをファイルに書き出します。
      パラメータ:
        `fname` - ファイル名２
      説明:

             この属性を指定しない場合は、ファイルに出力されません。
             また、file1 と同じファイルを指定することは可能です。その場合は、
             元のファイルが上書き保存されます。
             Excelの形式は、ここで指定する出力ファイルの拡張子ではなく、file1で
             指定したファイルの拡張子で決まります。
             異なる形式の拡張子を持つファイルを指定した場合、強制的に、オープンした
             Workbook の形式の拡張子を追加します。

             拡張子は、Excel 2007以降の形式(.xlsx)か、Excel 2003以前の形式(.xls) が指定できます。
             拡張子が未設定の場合は、オープンした Workbook の形式に合わせた拡張子を付与します。

      変更履歴:

        6.2.6.0 (2015/06/19) 新規作成

    - #### setSheetName

          public void setSheetName(String sheet)

      【TAG】EXCELファイルを読み込むときのシート名を設定します(初期値:指定なし)。
      パラメータ:
        `sheet` - EXCELファイルのシート名
      関連項目:
        `setSheetNos( String )`
      説明:

             EXCELファイルを読み込む時に、シート名を指定します。
             sheetNos と sheetName が同時に指定された場合は、sheetNos が優先されます。
             エラーにはならないのでご注意ください。
             初期値は、指定なしです。

      変更履歴:

        6.2.6.0 (2015/06/19) 新規作成

    - #### setSheetNos

          public void setSheetNos(String sheet)

      【TAG】EXCELファイルを読み込むときのシート番号を指定します(初期値:0)。
      パラメータ:
        `sheet` - EXCELファイルのシート番号（0から始まる）
      関連項目:
        `setSheetName( String )`
      説明:

             EXCEL読み込み時に複数シートをマージして取り込みます。
             シート番号は、0 から始まる数字で表します。

             シート番号の指定は、CSV形式で、複数指定できます。また、N-M の様にハイフンで繋げることで、
             N 番から、M 番のシート範囲を一括指定可能です。また、"*" による、全シート指定が可能です。
             これらの組み合わせも可能です。（ 0,1,3,5-8,10-* ）
             ただし、"*" に関しては例外的に、一文字だけで、すべてのシートを表すか、N-* を最後に指定するかの
             どちらかです。途中には、"*" は、現れません。
             シート番号は、重複(1,1,2,2)、逆転(3,2,1) での指定が可能です。これは、その指定順で、読み込まれます。
             sheetNos と sheetName が同時に指定された場合は、sheetNos が優先されます。
             エラーにはならないのでご注意ください。

             初期値は、0（第一シート） です。

      変更履歴:

        6.2.6.0 (2015/06/19) 新規作成

    - #### setSheetConstKeys

          public void setSheetConstKeys(String constKeys)

      【TAG】EXCELファイルを読み込むときのシート単位の固定値を設定するためのキーをCSV形式で指定します。
      パラメータ:
        `constKeys` - 固定値となるキー(CSV形式)
      関連項目:
        `setSheetConstAdrs( String )`
      説明:

             カラム名は、CSV形式で指定します。
             これにより、シートの一か所に書かれている情報を、固定値として取得することができます。
             sheetConstAdrs 属性で指定したセル位置から取得した値を、sheetConstKeys で指定したキーに
             設定します。
             値の設定方法は、valueType 属性で指定します。

      変更履歴:

        6.2.6.0 (2015/06/19) 新規作成

    - #### setSheetConstAdrs

          public void setSheetConstAdrs(String constAdrs)

      【TAG】EXCELファイルを読み込むときのシート単位の固定値を設定するためのキーに対応するアドレスをCSV形式で指定します。
      パラメータ:
        `constAdrs` - 固定値となるアドレス (行-列,行-列,・・・)
      関連項目:
        `setSheetConstKeys( String )`
      説明:

             アドレスは、EXCEL上の行-列形式か、EXCEL表記に準拠した、A1,A2,B1形式が使用できます。
             また、特殊な文字として、"SHEET" という記号が使用できます。
               ①行-列形式
                 行列は、EXCELオブジェクトに準拠するため、０から始まる整数です。
                 0-0 ⇒ A1 , 1-0 ⇒ A2 , 0-1 ⇒ B1 になります。
               ②EXCEL表記
                 EXCEL表記に準拠した、A1,A2,B1 の記述も処理できるように対応します。
                 なお、A1,A2,B1 の記述は、必ず、英字1文字＋数字 にしてください。(A～Zまで)
               ③EXCELシート名をキーに割り当てるために、"SHEET" という記号に対応します。
                 readSheet 属性で、同等のことが出来まが、統一的に処理できるようにします。

             例えば、sheetConstKeys="CLM,LANG,NAME" とし、sheetConstAdrs="0-0,A2,SHEET" とすると、
             NAMEカラムには、シート名を読み込むことができます。
             これは、内部処理の簡素化のためです。

             ちなみに、EXCELのセルに、シート名を表示させる場合の関数は、下記の様になります。
             =RIGHT(CELL("filename",$A$1),LEN(CELL("filename",$A$1))-FIND("]",CELL("filename",$A$1)))

             これにより、シートの一か所に書かれている情報を、固定値として取得することができます。
             sheetConstAdrs 属性で指定したセル位置から取得した値を、sheetConstKeys で指定したキーに
             設定します。
             値の設定方法は、valueType 属性で指定します。

      変更履歴:

        6.2.6.0 (2015/06/19) 新規作成

    - #### setUseActiveWorkbook

          public void setUseActiveWorkbook(String useActWB)

      【TAG】EXCEL出力時に、セルの有効範囲を設定するかどうかを指定します(初期値:false)。
      パラメータ:
        `useActWB` - 有効範囲の設定 [true:する/false:しない]
      説明:

             セルの有効範囲というのは、EXCELでの 空行、空列の存在しない範囲を指します(初期値:false)。
             通常、空行でも、データとして残っている場合は、EXCELのセルオブジェクトは存在します。
             ここで、useActiveWorkbook="true" とすると、空行、空列を削除します。
             初期値は、false:しない です。

      変更履歴:

        6.2.6.0 (2015/06/19) 新規作成

    - #### setAddTitleSheet

          public void setAddTitleSheet(String sheetName)

      【TAG】EXCEL出力時に、Sheet一覧を作成する場合のSheet名を指定します。
      パラメータ:
        `sheetName` - タイトルシート名
      説明:

             これは、Workbook に含まれる Sheet 一覧を作成する場合に、ここに指定した
             シート名で、目次を作成します。

      変更履歴:

        6.2.6.0 (2015/06/19) 新規作成

    - #### setAddImageFile

          public void setAddImageFile(String imgFile)

      【TAG】指定のシートの行・列の箇所に、イメージファイルを挿入します。
      パラメータ:
        `imgFile` - (画像ファイル名 シート番号 開始行 開始列 [終了行 終了列 開始セルのX軸ﾏｰｼﾞﾝ 開始セルのY軸ﾏｰｼﾞﾝ 終了セルのX軸ﾏｰｼﾞﾝ 終了セルのY軸ﾏｰｼﾞﾝ])
      説明:

             ここでは、セル範囲ではなく、指定の行列の箇所に、アンカーを設定して、画像ファイルを
             挿入します。一応、リサイズして、元の大きさ近くに戻しますが、縦横比が変わってしまいます。
             正確に挿入する場合は、セル範囲の指定と、マージンを指定しなければなりませんが、
             微調整が必要です。
             引数は、スペース区切りで、下記の順番で指定します。

                imgFile   挿入するイメージファイル名
                shtNo     シート番号
                row1      挿入する行(開始)
                col1      挿入する列(開始)
               [row2]     挿入する行(終了-含まず)      (未指定時は、row1)
               [col2]     挿入する列(終了-含まず)      (未指定時は、col1)
               [dx1 ]     開始セルのX軸座標(マージン)  (未指定時は、0)
               [dy1 ]     開始セルのY軸座標(マージン)  (未指定時は、0)
               [dx2 ]     終了セルのX軸座標(マージン)  (未指定時は、0)
               [dy2 ]     終了セルのY軸座標(マージン)  (未指定時は、0)

      変更履歴:

        6.2.6.0 (2015/06/19) 新規作成

    - #### setValueType

          public void setValueType(String type)

      【TAG】sheetConstXXX,readXXXX のパラメータに登録する方法を指定します(CSV/LIST/MAP)。
      パラメータ:
        `type` - 保管方法(CSV/LIST/MAP)
      説明:

             キーに対して、値は複数存在する場合があります。
             その値を、設定する場合の、３つの方法を指定できます。

               CSV : キーに対して、値をCSV形式でセットします。valueタグや、{@XXX} で、取り出せます。
                     キーが複数ある場合は、個別に指定する必要があります。
               LIST: キーに対して、値をListオブジェクトにセーブします。
                     キーが複数ある場合は、個別に指定する必要があります。
               MAP : キー自体を、Mapオブジェクトに設定します。値は、CSV形式の文字列です。

             初期値は、CSV です。

      変更履歴:

        6.2.6.0 (2015/06/19) 新規作成

    - #### setReadText

          public void setReadText(String read)

      【TAG】ファイルを読み込んで、内容を引数の変数にセットします。
      パラメータ:
        `read` - 書き込む変数名
      説明:

             EXCELのセルと、テキストボックスオブジェクトの値を取得します。
             引数に、キーとなるパラメータを指定します。
             テキストは、一つのキーに設定されます。
             valueType 属性の指定とは無関係にパラメータに登録されます。

      変更履歴:

        6.2.6.0 (2015/06/19) 新規作成

    - #### setReadSheet

          public void setReadSheet(String read)

      【TAG】ファイルを読み込んで、シート一覧を引数の変数にセットします。
      パラメータ:
        `read` - 書き込む変数名
      説明:

             EXCELのシート一覧を取得します。
             引数に、キーとなるパラメータを指定します。
             値の設定方法は、valueType 属性で指定します。

      変更履歴:

        6.2.6.0 (2015/06/19) 新規作成

    - #### setReadName

          public void setReadName(String read)

      【TAG】ファイルを読み込んで、名前一覧を 引数の変数にセットします。
      パラメータ:
        `read` - 書き込む変数名
      説明:

             EXCELの名前一覧を取得します。
             名前一覧に、不正な値や、他のファイルのリンク等が設定されていると、
             EXCELを開くのに時間がかかる場合があります。EXCEL帳票などでは、問題になります。
             そこで、この名前が不正かどうか判別するのに、名前一覧を使用します。
             引数に、キーとなるパラメータを指定します。
             値の設定方法は、valueType 属性で指定します。

      変更履歴:

        6.2.6.0 (2015/06/19) 新規作成

    - #### setReadStyle

          public void setReadStyle(String read)

      【TAG】ファイルを読み込んで、スタイル名を 引数の変数にセットします。
      パラメータ:
        `read` - 書き込む変数名
      説明:

             EXCELのスタイル名を取得します。
             スタイル名に、不正な値が設定されていると、EXCELを開くのに
             時間がかかる場合があります。EXCEL帳票などでは、問題になります。
             そこで、このスタイル名が不正かどうか判別するのに、使用します。
             引数に、キーとなるパラメータを指定します。
             値の設定方法は、valueType 属性で指定します。

      変更履歴:

        6.2.6.0 (2015/06/19) 新規作成

    - #### setUseConverter

          public void setUseConverter(String useConv)

      【TAG】シート名、セル、オブジェクトのテキストを変換するかどうか指定します(初期値:false)。
      パラメータ:
        `useConv` - コンバータ処理を行うかどうか [true:行う/false:行わない]
      説明:

             この属性では、テキスト変換を行うかどうかを指定します。例え、convFile属性や
             convMap属性が指定されていても、この属性を true にしないと、変換は行われません。
             また、convFile属性と、convMap属性がどちらも指定されていない場合も、実行されません。
             初期値は、false:行わない です。

      変更履歴:

        6.2.6.0 (2015/06/19) 新規作成

    - #### setConvFile

          public void setConvFile(String cfile)

      【TAG】useConverter=true 時に、変換対応表をファイルから読み取ります。
      パラメータ:
        `cfile` - コンバータ処理の変換対応表ファイル
      説明:

             この属性は、useConverter=true を指定しないと、無視されます。
             テキスト変換を行う変換対応表を、ファイルで指定します。
             このテキストファイルは、変換元と変換先の文字列をタブ区切りで定義された、UTF-8ファイルです。

      変更履歴:

        6.2.6.0 (2015/06/19) 新規作成

    - #### setConvMap

          public void setConvMap(String cmap)

      【TAG】useConverter=true 時に、変換対応表をMapから読み取ります。
      パラメータ:
        `cmap` - コンバータ処理の変換対応表Mapの取得キー
      説明:

             この属性は、useConverter=true を指定しないと、無視されます。
             テキスト変換を行う変換対応表を、Mapオブジェクトで指定します。
             メモリ上のMapオブジェクトの取得キーを、指定します。
             スコープは、scope 属性を使います。

      変更履歴:

        6.2.6.0 (2015/06/19) 新規作成

    - #### setSaveAs

          public void setSaveAs(String name)

      【TAG】file1 を指定のファイルの拡張子に合わせた変換を行って保存します(xls,xlsx,pdf)。
      パラメータ:
        `name` - セーブするファイル名
      説明:

             この属性は、JACOB(Java COM Bridge)の使用が前提です。
             file2と同時に指定する事はできません。
             file2 属性と異なり、拡張子が異なるケースで、使用します。
             また、xslx拡張子の場合でも、EXCELのバージョンや、設定によっては、POIでは
             読み取ることが出来ない場合があり、JACOBで変換することで、読み取ることが
             できる形式に変換できます。
             また、拡張子に、pdf を指定すると、PDFファイルに変換できます。
             ※ この属性は単独でしか使用できません。(fileURL,file1 以外)

      変更履歴:

        6.2.6.0 (2015/06/19) 新規作成

    - #### setToPrint

          public void setToPrint(String printer)

      【TAG】file1 を指定のプリンタに印刷します。
      パラメータ:
        `printer` - プリンタ名
      説明:

             この属性は、JACOB(Java COM Bridge)の使用が前提です。
             サーバーから使用できるプリンタ名を指定してEXCELを印刷します。
             ※ この属性は単独でしか使用できません。(fileURL,file1 以外)

      変更履歴:

        6.2.6.0 (2015/06/19) 新規作成

    - #### setScope

          public void setScope(String scp)

      【TAG】キャッシュする場合のスコープ(request,session)を指定します(初期値:request)。
      オーバーライド:
        `setScope` クラス内 `CommonTagSupport`
      パラメータ:
        `scp` - スコープ
      関連項目:
        `CommonTagSupport.getScope()`
      説明:

             "request","session" が指定できます。
             初期値は、 "request" です。

    - #### toString

          public String toString()

      このオブジェクトの文字列表現を返します。 基本的にデバッグ目的に使用します。
      オーバーライド:
        `toString` クラス内 `CommonTagSupport`
      戻り値:
        このクラスの文字列表現
      このメソッドは、nullを返しません

Webアプリケーションフレームワーク openGion
Copyright (c) 2009 The openGion Project.