DOS/V Power Report 2000 July/VPR0007A.BIN/OLS/WFC/wfc.lzh/Ver1.01/WFC利用マニュアル.txt

Text File | 2000-04-19 | 10KB | 268 lines

　　　　 Web File Converter

　　　　　　　　　＜＜　利用マニュアル　＞＞


　　　　　　　（有）ヒューテック　　URL    : http://www.h-tech.co.jp
　　　　　　　　　　　　　　　　　　E-Mail : [e-mail]

　　　　　　　2000年 3月21日　　Ver : 1.00



－－－　第1章　はじめに　－－－

　　WebFileConverterは、HTML/XMLファイルから異なる形式のHTML/XMLファイルまたは、
  CSVを含めた一般テキストに変換するツールです。
　異なるシステム間のデータ変換や、インターネット／イントラネットのデータを保存する
　場合に使用して下さい。
　インストールせずに実行できますので、既存の環境が変更されることはありません。


1.1　概要

　　WebFileConverterは、指定のHTML/XMLファイルを解析し、あらかじめ設定した変換先の定義
  ファイルに従い、データの自動変換を行います。変換先のファイルはCSV形式を始め、あらゆる
　テキストファイルを対象とします。タグ名やファイル内の発生順指定、読替変換指定ができるため、
　異なるシステム間のデータ交換が可能である。また、複数の入力ファイルからの混合出力ファイル
　を作成することも可能です。
　　新規にプログラムを開発すること無くCSV,SQLファイル等に変更できるので、各アプリケーション
　に標準添付のツールにて、Excel/Accessはもとより、Oracle等の商用データベースに出力すること
　も可能です。
　　また、付属ツールの入力ファイル解析ツール（ToolWfcInput.exe）を使用することにより、
　HTML/XMLファイル内のタグ情報やプロパティ、内容といった解析結果をCSVファイルに出力する事が
　できます。ファイル解析のみ行う場合や、変換先定義を作成する際の設定情報に使用して下さい。


1.2　動作可能な環境

1.2.1　ハードウェア

　　Windows95/98/NT4.0が動作する環境
　　（変換元ファイル＋変換先ファイル）の３倍以上の空きメモリを確保して下さい。

1.2.2　ソフトウェア

　　特に必要なし

1.2.3　文字コード

　　　S-JIS,EUC,JISの文字コードを対象に自動変換します。
　　内部処理は S-JISコード を使用していますので各定義ファイルと出力ファイルはS-JISになります。


－－－　第2章　使用する上での手順概要　－－－

2.1　入力ファイルの解析
　　　　まずは変換対象のファイルを、付属ツールにて解析します。
　　　解析した結果のタグ名（タグのフルパス）、同一タグ内の連番、値がCSVファイルに出力されま
　　　すので、出力定義ファイルの情報として下さい。
　　　/D  /K  オプションを付けると分かりやすいでしょう。
　　　CSVファイルなので、ExcelやAccessに取込むときちんと整列します。（拡張子はCSVとして下さい。）
　　　　次項以降に説明していますので、参照してください。

2.2　関連ファイルの設定
　　　　次項以降に説明していますので、参照してください。

2.3　変換処理の実行
　　　　次項以降に説明していますので、参照してください。

2.4　実行結果の確認
　　　　正しく変換できたことを確認して下さい。
　　　正しく変換できない場合は、INIファイルの WARLOGOUT=yes を設定してみて下さい。
　　　詳細のログが出力されます。


－－－　第3章　関連ファイル設定　－－－

3.1　INIファイル設定

3.1.1　ロギング
　　　・エラー情報等を出力するファイル名をフルパスで指定します。
　　　　（未設定の場合は、カレントディレクトリに ERRLOG.LOG というファイルを作成し、
　　　　　そちらにメッセージを出力します。）
　　　・致命的エラー以外のメッセージを出力する場合は、WARLOGOUT=yes を設定します。
3.1.2　変換指定文字
　　　・変換対象文字列の開始文字と終了文字を指定します。
　　　　（出力定義ファイルで使用します。この文字列間に変換対象を記述します。）
3.1.3　入力ファイル
　　　・入力ファイル種別を指定します。(xml or html)
　　　・入力ファイル数を記述します。(1～9)
　　　・入力ファイル名をフルパスで指定します。
3.1.4　出力ファイル
　　　・入力ファイル種別を指定します。
　　　　（Normal:通常 or NoCrLf:改行／タブをスペースに置換えます。)
　　　・出力ファイル名をフルパスで指定します。
3.1.5　出力定義ファイル
　　　・出力定義ファイル名をフルパスで指定します。
3.1.6　読替定義ファイル
　　　・読替定義ファイル名をフルパスで指定します。

3.2　出力定義ファイル設定
　　・出力したいテキストをそのまま記述します。入力ファイルから取得する個所のみを変換
　　　対象文字列と仕手記述します。
　　　見やすいように、改行／タブ／スペースで区切っても結構です。
      [変換対象文字列の設定例]
          @@@                ･･････開始文字列
          1                    ･･････入力ファイル番号（1～9）
          <ADDLESS><LINE>    ･･････入力ファイル内のタグのフルパス
          0001                ･･････入力ファイル内のタグの出力順
          000                ･･････読替番号（000は読替無し）
          000                ･･････最大バイト数（000はデータの最後まで）
          ###                ･･････終了文字列

3.3　読替定義ファイル設定
　　・入力ファイルの文字列を別の文字列に置換える場合に指定します。
　　　読替しない場合は設定不要です。（ファイルも不要です。）
　　　タブで区切って下さい。
      [読替定義の設定例]
          001    JP    JAPAN    ･･････読替番号:001でJPが出てきたらJAPANに置換える
          001    US    USA        ･･････読替番号:001でUSが出てきたらUSAに置換える

　　　※読替指定文字と一致しない場合は、入力データの文字をそのまま出力します。
　　　※読替番号が一致しない場合は、? を出力します。


－－－　第4章　起動方法　－－－

　　インストールは一切しませんので、コマンドラインから直接起動します。

　　起動方法 :   実行ディレクトリ\WebFileConv.exe    INIファイル（フルパス指定）
　　　　例       C:\TEST\WebFileConv.exe  C:\TEST\WFC.INI

　　　実行後、INIファイルで指定した出力ファイルが正しく作成されていれば完了です。
　　正しく作成されない場合は、INIファイルの WARLOGOUT=yes を指定して再実行して
　　下さい。原因が出力されます。
　　ロギングファイルが作成できない場合は、実行ディレクトリに ERRLOG.LOG という
　　ファイルが作成されますので、そちらを参照して下さい。

　　　出力ファイルは、確認メッセージを表示せずに上書きしますので、待避等が必要な場合は利用者が
　　待避して下さい。
　　また、ロギングファイルは追加書きしますので、必要に応じてクリアをして下さい。



－－－　第5章　各種関連ツール　－－－

5.1　入力ファイル解析

　　　入力ファイルを解析し、解析結果をCSVファイルに出力します。タグ情報やプロパティ、内容を
　　調べたい時に使用します。

　　　HTML版起動方法 :   実行ディレクトリ\ToolWfcInputH.exe    入力ファイル  出力ファイル  オプション
　　　　　　　　例       C:\TEST\ToolWfcInputH.exe  C:\TEST\InFile.htm  C:\TEST\OutFile.csv  /D /K /P,
　　　XML版起動方法  :   実行ディレクトリ\ToolWfcInputH.exe    入力ファイル  出力ファイル
　　　　　　　　例       C:\TEST\ToolWfcInputX.exe  C:\TEST\InFile.xml  C:\TEST\OutFile.csv  /D /K

　　　　オプション
　　　　　　/D  データが設定されていないタグは出力しません。
　　　　　　　　未指定：全データ出力
　　　　　　/K  解析ファイルに項目タイトルを付けます。
　　　　　　　　未指定：項目名無し
　　　　　　/P  出力CSVファイルの区切り文字を指定します。(スペースを入れないで文字を入力)
　　　　　　　　未指定：タブ区切り

　　　出力内容
　　　　FileNo            No            SeaNo                TagName                Value
　　　　ファイル番号    解析番号    同一タグ内の連番    タグ名（フルパス）    設定値

　　　解析結果は、出力ファイルに出力されます。出力ファイルが存在する場合、確認メッセージを表示
　　します。

5.2　コード変換

　　　指定ファイルの文字コード（SJIS/EUC/JIS）を別コードに変換します。

　　　起動方法 :   実行ディレクトリ\ToolDeCode.exe  入力ファイル 出力ファイル        オプション
　　　　　例       C:\TEST\ToolDeCode.exe     C:\TEST\InFile.htm C:\TEST\OutFile.csv /CEUC

　　　　オプション
　　　　　　/C  変換先文字コードを指定します。/Cに続いて(スペースを入れない)文字コードを指定します。
　　　　　　　　文字コード：SJIS or EUC or JIS
　　　　　　　　未指定：SJIS

　　　変換結果は、出力ファイルに出力されます。出力ファイルが存在する場合、確認メッセージを表示
　　します。


－－－　第6章　注意事項　－－－

6.1　XMLのDTDについて
　　DTD解析は行いません。DTDデータは読み飛ばしますので、設定確認は利用者が行って下さい。

6.2　タグ内のオプションについて
　　タグ内のオプションは<< >>で指定します。入力ファイル解析の結果に表示されています。

6.3　解析機能について
　　　全てのタグやオプションの属性／機能を解析しているわけではありません。解析できないものが
　　あるかもしれません。製品サポート係（E-Mail）まで連絡して下されば可能なものについては対処
　　します。


－－－　第7章　サポートについて　－－－

7.1　サポート方法
　　製品サポート：E-Mail     [e-mail]

　　　試用版の使用者は、障害等の発生を連絡いただければ、Webにて、障害内容
　　および対策を公開する予定です。なお、ライセンス購入者に対しては、最新版
　　送付等の個別対応をいたします。
　　サポート契約を申し込まれた購入者に対しては、電話／FAXによるサポートも
　　行います。

7.2　トラブル報告
　　　発生状況・再現性などの調査を行った後、製品サポート係（E-Mail）まで連絡
　　してください。なお、そのとき以下の情報の添付をお願いします。

　　　(1)WebFileConverterの入手元、バージョン
　　　(2)関連ファイル（INI／入力／出力／出力定義／読替定義）
　　　(3)OSのバージョン、サービスパックの情報

7.3　サポート契約
　　　サポート契約をご希望の場合は、製品サポート係（E-Mail）まで連絡して下さい。

7.4　カスタマイズサポート
　　　個別にカスタマイズする場合は、製品サポート係（E-Mail）まで連絡して下さい。
　　別途お見積いたします。

7.5　出力定義作成サポート
　　　出力定義の作成を弊社にご用命する場合は、製品サポート係（E-Mail）まで連絡
　　して下さい。別途お見積いたします。



－－－　第8章　転載について　－－－

8.1　本ソフトウェアの扱い
　　　本ソフトウェアの著作権は（有）ヒューテックにあります。
　　実行パソコン1台で1ライセンスが必要です。

8.2　無保証
　　　本システムを利用した事によって発生した、いかなる損害についても責任を負いません。
　　重要データは必ずバックアップを取ってから利用してください。

8.3　配布条件
　　試用版は自由に再配布していただいて構いません。製品版はご遠慮下さい。

8.4　出力定義作成等のアプリケーション開発について
　　　出力定義を作成するためのアプリケーション等は自由に作っていただいてかまいません。
　　フリーフェア／シェアウェア登録もかまいません。
　　事前に連絡を頂けている方には、こちらの仕様変更情報もお送りします。



－－－　第9章　その他　－－－

9.1　改善提案・要望
　　　改善提案・要望などがありましたら、製品サポート係（E-Mail）まで連絡して下されば
　　可能なものについては対処します。

9.2　マニュアル・ヘルプ機能について
　　　完成して間も無いものですから、まだまだ不備があると思います。徐々に充実していきたいと
　　考えています。


　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　以　　上