──────────────────────────────────────
    設定の解説書：　ソフトウェア「ボルボックス」
──────────────────────────────────────
                                                      ２０１０年　７月２４日
　　　　　　　　　　　　　　　　　　　───────────────────
                                                            有限会社アゼロス
　　　　　　　　　　　　　　　　　　　───────────────────

●  フォルダ構造：

    次の構成で、ライブラリ／ＣＧＩ／ユーザの各種ファイルを設定します（カッコ
    内は、必要なアクセス権です［※１］）：

○  フォルダ構造：ライブラリ＆ＣＧＩ：

----------------------------------------------------------------------------
- bin   (sysmgr.sysmgr 755) ... プログラム（コマンド・ユーティリティ用）
- cnf   (sysmgr.sysmgr 644) ... 個別設定ファイル
- etc   (sysmgr.sysmgr 644) ... 共通の雛形
- lib   (sysmgr.sysmgr 644) ... 共有ライブラリ（pm, xsl）
- web_bin -> /var/www/bin/xmlcms
  - bin (webmgr.apache 755) ... プログラム（ＣＧＩ用）
- web_doc -> /var/www/doc/xmlcms
  - doc (webmgr.apache 644) ... ウェブ用文書
  - img (webmgr.apache 644) ... イメージ・ファイル
  - css (webmgr.apache 644) ... 共有スタイルシート（css）
  - lib (webmgr.apache 644) ... 共有スクリプト（js）
----------------------------------------------------------------------------

○  フォルダ構造：ユーザ（例）：

※  各ユーザのフォルダは（設定ファイルで個別に指定するので）自由に構成できま
    す。

----------------------------------------------------------------------------
- xsl   (sysmgr.sysmgr 644) ... ＸＳＬ文書
- xml   (apache.apache 664) ... ＸＭＬ文書
- etc   (sysmgr.sysmgr 644) ... 個別の雛形
- bin   (sysmgr.sysmgr 755) ... 個別のプログラム
- var   (apache.apache 664) ... 遅延生成用日時ファイル、等
- web_doc -> /var/www/doc/sample ... ウェブ用公開文書
  - doc (apache.apache 664)
  - img (apache.apache 664)
  - arc (apache.apache 664)
  - css (webmgr.apache 664)
  - lib (webmgr.apache 664)
----------------------------------------------------------------------------

１］それぞれのユーザ／グループは、次のように位置づけられます：

○  ユーザ：
・  sysmgr ... アプリケーションの管理ユーザ
・  webmgr ... ウェブ・コンテンツの管理ユーザ
・  apache ... ウェブ・サーバの実行ユーザ
○  グループ：
・  sysmgr ... アプリケーションの管理グループ
・  apache ... ウェブ・サーバの実行グループ
○  各ユーザの第一所属グループ：
・  sysmgr: sysmgr
・  webmgr: apache
・  apache: apache

●  入出力：

○  入出力：入力フォーム

    入力内容をＸＭＬ形式に変換するための入力フォームは、次の書式となります：

・  ノードの場合：

----------------------------------------------------------------------------
<input ... name="xmlitm_/XXX/XXX_NNN.NNN" value="()" type="hidden"/>
----------------------------------------------------------------------------

・  テキスト・ノードの場合（テキストを値に持つノード）：

----------------------------------------------------------------------------
<input|textarea| ... name="xmlitm_/XXX/XXX_NNN.NNN"/>
----------------------------------------------------------------------------

・  テキスト・ノードの文字列を変換したい場合：

----------------------------------------------------------------------------
<input name="xmlcnv_/XXX/XXX" value="CONVERSION" type="hidden"/>
----------------------------------------------------------------------------

※  ノードは、第１階層のノードから順に作成する必要があります（これは、シリア
    ル番号を階層に沿って付ける必要がある、ということです）。
※  このとき必要なのは、始端ノード名のみです（終端ノード名は必要ありません）。

●  データ構造：

○  データ構造：入力フォーム

    編集画面の入力フォームは、次の書式で定義します：

----------------------------------------------------------------------------
<......>
  <recfrm> ... 入力フォームの定義
    <k> ... ノードのパス（キー）
    <n> ... ノードのパス（表示させたい場合に［1 ］）
    <d> ... このノードで入れ子表示を止めたいときに［1 ］
            デフォルトの深さ指定より浅いノードに適用される
    <s> ... 項目名（本来のノード名を表示させたいなら［1 ］）
    <v> ... 入力フォームの見せ方
            i ... 一行フォーム
            p ... 暗号フォーム（パスワード入力）
            h ... 編集させない（表示のみ）
    <h> ... 入力項目の高さ
    <c> ... 内容の文字列変換指示
    <u> ... アップロード先のディレクトリ。アップロードの指示を兼ねる
    <g> ... その画像素材に至るＵＲＬ（編集画面における画像のプレビュー用）
    <r> ... 画像のリサイズ指示（横サイズ、単位：ピクセル）
    <m> ... 項目の複製／削除
            c ... 複製（書式の複製）
            d ... 削除
    <o> ... 選択項目
      <s> ... 項目
        <n> ... 名前
        <v> ... 値
----------------------------------------------------------------------------

○  データ構造：生成マップ

    ＸＭＬにＸＳＬを適用し、指定の処理を行う生成マップは、次の書式で記述しま
    す：

----------------------------------------------------------------------------
<......>
  <recsmp>
    <colxml> ... 参照ＸＭＬファイル群（正規表現）（複数可）
      p: ... 文字列を読み出し（これにＸＭＬヘッダ＋<entity>〜</entity>が付く）
      f: ... ファイルを読み出し
      r: ... ファイルを読み出し（正規表現）……初期値
      v: ... ファイルを読み出し（一時ファイル）
      x: ... プログラムを呼び出し（評価）
      o: ... プログラムを呼び出し（シェル）
    <colxsl> ... 参照ＸＳＬファイル
      f: ... ファイルを読み出し
      s: ... ファイルを読み出し〜ファイル内の指定文字列（perl式）を置き換え……初期値
    <colgen> ... 生成するファイル
      f: ... ファイルに書き出し……初期値
      v: ... ファイルに書き出し（一時ファイル）
      g: ... 生成マップ処理
      x: ... プログラムを呼び出し（評価）
    <colarg> ... 生成前に実行するプログラム・コード（perl形式）
                 例えばＸＳＬに与える引数（perlの連想配列形式）等（複数可）
      x: ... プログラムを呼び出し（評価）……初期値
----------------------------------------------------------------------------

※  ＣＧＩでの処理モード指定（prcmod=?????? ）は、指定されたＸＳＬファイル内
    で、次の変数から取り出すことができます：

    $$entity{status}

※  一時ファイルは、次の形で取り出すことができます：

    $handle.\'_??????.xml\'

○  データ構造：メタマップ（サイトマップの生成マップ）

    メタマップは、次の書式で記述します：

※  いまのところ、このＸＭＬ形式を使うことはありません。現在の実装では、それ
    ぞれの値は、設定ファイル内の次の変数に与えることになります：

    $cmsgen::filgnx ... マップ生成用ＸＭＬファイル群（正規表現）
    $cmsgen::filgns ... マップ生成用ＸＳＬファイル（ＸＳＬ形式）

※  マップ生成用ＸＳＬファイルが空のときは、指定のＸＭＬファイルのみが使われ
    ます。このとき指定のＸＭＬファイルは、（正規表現ではなく）単一のファイル
    として指定する必要があります。

----------------------------------------------------------------------------
<......>
  <recpmp>
    <colxml> ... マップ生成用ＸＭＬファイル群（正規表現）
    <colxsl> ... マップ生成用ＸＳＬファイル（ＸＳＬ形式）
----------------------------------------------------------------------------

○  提供される関数

・  xmlgen::sinput ... 標準入力から読み込み
・  xmlgen::output ... 標準出力に書き出し
・  cmsprc::xinptt ... ウェブ・ブラウザから読み込み（二項版／項目〜値の組み）
・  cmsprc::xinput ... ウェブ・ブラウザから読み込み（多層版／ツリー構造）
・  cmsprc::output ... ウェブ・ブラウザに出力（ＨＴＴＰヘッダ）
・  cmsprc::outptt ... ウェブ・ブラウザに出力（テキストヘッダ）
・  subrdb::sqladm ... ＸＭＬによるＲＤＢ操作（追加）
・  subrdb::sqlmdm ... ＸＭＬによるＲＤＢ操作（変更）
・  subrdb::sqlrmm ... ＸＭＬによるＲＤＢ操作（削除）
・  subrdb::sqlrfm ... ＸＭＬによるＲＤＢ操作（参照）

○  データ構造：メール送信

    メール送信のための生成ファイルは、次の書式で記述します：

・  ファイル名：??????.mailto

----------------------------------------------------------------------------
<......>
  <recmsg>
    <colsvr> ... 接続ＳＭＴＰサーバ
    <colsnd> ... 送信者
    <colrcp> ... 受信者
    <colttl> ... 題名
    <colcmm> ... 内容
----------------------------------------------------------------------------
※  内容は、改行文字をそのまま使えます（<br/> で記さなくてよい）。
※  特殊文字（<>& ）については、記号で記す必要があります。
※  これらを実現するため、次を設定するようにしてください：
    設定ファイル上で、すべての項目に指定する場合：
    $xmledt::flgcnv = 'aqt'
    入力フォーム上で、項目ごとに指定する場合：
    <input type="hidden" name="xmlcnv_ITEM_PATH" value="aqt"/>

●  プロセスの遷移：

○  プロセスの遷移：モードの指定

    とくにＣＭＳでは、処理モードをハード・コーディングしています。ＣＧＩ呼出
    では、次の形式でモードを呼び出します：

・  呼び出し方：xmlcms.cgi?prcmod=??????

※  モードの一覧：

----------------------------------------------------------------------------
- lstxml ... ＸＭＬファイル一覧を閲覧
  > adpxml
  > mdpxml
  > dlpxml
  > gennod
- adpxml ... ＸＭＬファイルを追加（準備）
  > mdxxml
- mdpxml ... ＸＭＬファイルを変更（準備）
  > mdxxml
- dlpxml ... ＸＭＬファイル／生成ファイルを削除（準備）
  > dlxxml
- mdxxml ... ＸＭＬファイルを追加／変更（実行）
- mdcxml ... ＸＭＬファイルの内容を確認
  > mdxxml
- dlxxml ... ＸＭＬファイル／生成ファイルを削除（実行）
- gennod ... ＸＭＬ＋ＸＳＬからファイルを生成
- synxml ... 生成したファイルを転送
----------------------------------------------------------------------------

●  プロセスの挙動：

○  プロセスの遷移：設定ファイル

    ＣＧＩ呼出では、次の形式でその挙動を定義します：

・  呼び出し方：xmlcms.cgi?config=??????
・  ファイル名：config_??????.txt

※  とくに次の変数には、次の置換指定を記述できます：

・  $xmledt::strxnm ... $$entity{sysyer}, $$entity{sysmon}, ...
・  $cmsgen::filgnx ... $$entity{nodsdi}

----------------------------------------------------------------------------
############################################################################
# 準備：
############################################################################

  my $dirtop = '/opt/cmssmp';

############################################################################
# 全般：
############################################################################

  $cmscmm::dirxml = $dirtop.'/xml'; # ＸＭＬ文書のディレクトリ
  $cmscmm::urlweb = 'http://192.168.1.1/'; # 公開ドキュメントのＵＲＬ（終端は”/ ”で終わること）
  $cmscmm::urlcgi = "$cmscmm::urlweb".'cgi-bin/'; # ＣＧＩのＵＲＬ（終端は”/ ”で終わること）

############################################################################
# 認証：
############################################################################

  $cmsath::pwdcfo = 'abcd1234'; # パスワード
# $cmsath::filspw = ''; # パスワード入力の雛形（ＸＳＬ形式）

############################################################################
# 一覧：
############################################################################

  $cmslst::filsln = $dirtop.'/etc/frmlst.xsl'; # 一覧画面の雛形（ＸＳＬ形式）
  $cmslst::fillsx = '^arcdat_.*\.xml.*$'; # 一覧表示時の参照ノード群（正規表現）
  $cmslst::fillsy = '^arcdat_.*\.xml.*$'; # 一覧表示時の参照データ群（正規表現）

############################################################################
# 編集：
############################################################################

# $xmledt::filsip = ; # 編集画面の雛形（ＸＳＬ形式）
  $xmledt::filfrm = $dirtop.'/etc/frmifm.xml'; # 入力フォーム定義：全体（ＸＭＬ形式）
  $xmledt::urlipr = 'file://'.$dirtop.'/etc/frmipr.xml'; # 入力フォーム定義：個別（ＸＭＬ形式）
  $xmledt::flgsav = ''; # 保存時のスイッチ（gs）
  $xmledt::strxnm = 'arcdat_<cmd:pl $$entity{sysyer}>_<cmd:pl $$entity{sysmon}>_<cmd:pl $$entity{sysday}>_<cmd:pl $$entity{syshur}><cmd:pl $$entity{sysmin}><cmd:pl $$entity{syssec}><cmd:pl $$entity{syspid}>.xml'; # ＸＭＬファイル保存時のデフォルト・ファイル名

############################################################################
# 生成：
############################################################################

  $cmsgen::filgnx = $dirtop.'/xml/.*.xml$'; # マップ生成用ＸＭＬファイル群（正規表現）
  $cmsgen::filgns = $dirtop.'/etc/makeup.xsl'; # マップ生成用ＸＳＬファイル（ＸＳＬ形式）

############################################################################
# 遅延：
############################################################################

  $cmsdly::dirdly = $dirtop.'/var'; # 遅延生成のディレクトリ
# $cmsdly::filsdl = $dirtop.'/etc/frmdly.xsl'; # 遅延生成編集ページの雛形（ＸＳＬ形式）
# $cmsdly::extdly = '.notuse'; # ファイルの目印（遅延生成用）
# $cmsdly::extcls = '.closed'; # ファイルの目印（閉鎖指定用）

############################################################################
# 送信：
############################################################################

# $cmssmt::extmsg = '.mailto'; # ファイルの目印（メール送信用）
----------------------------------------------------------------------------

    以上