Sugar DB Pro Ver.2.0 (2008/07/01)
インストールマニュアル

導入簡単をめざしたテキストベースのWeb用データベースCGIです。

対象：
・CGIを設置＆運用できる人。本ドキュメントの内容を理解し、守ることができる人。
・perl5を利用できる環境

クイックインストラクション：
・解凍ファイルをそのままアップロードする。
・パーミッションを設定する。
・/data/ディレクトリに、操作したいcsvファイルを入れる。動作テスト用にサンプル添付済み。
・entry.html にアクセスする。

設置方法：
・ファイル構成を示します。数字はパーミッションの推奨値です。
　まずは、解凍したファイルをディレクトリ構造そのままにアップロードしてください。
・cgiファイルの一行目は環境に応じて書き換えて下さい。例：#! user/local/perl
・紫はサンプルです。  
/dbspro(775)/ /data(755)/ /サンプルフォルダ全て (777)/ サンプルファイル全て(666)
  /pictures(755)/ -green.jpg (644)など
  aboutsort.html(644)
  entry.cgi (755)
  entry.html (644)
  getnum.cgi (755)
  index.html(644)
  jcode.pl (755)
  kanri.pl (755)
  passw.cgi(755)
  tempdata.csv(666)
  undefined.txt(644)
  users.csv(666)

動作テストとアカウント設定：
・entry.html にアクセスして下さい。
・デフォルトで5つのIDが設定されています。
　ID=administrator, manager, member, user, guest
　Password=「不要」
・「それぞれのID」＋「パスワード無」でログインし、パスワードを設定してください。
　一度ログインすると、パスワード「new」が自動生成されます。
・管理者権限でログインすると、アカウント編集ボタンが表示されます。
　パスワードを忘れた時：
　　　該当パスワード欄を空白にして下さい。
　　　パスワード無しでログイン可能になり、一度ログインすると、パスワード「new」が自動生成されます。

設定ファイル：
・kanri.plを開いてカスタマイズしてください。
・デフォルトで十分動きます。 やりたいことがあったら変更するのが良いでしょう。


データベース作成：

・データのルートディレクトリは/data/です。この下には 自由なディレクトリ構造を持つことができます。

・CSV形式（★）のデータを作成し、ディレクトリ /data/下の自由な場所 へアップロードして下さい。
 一行目は「見出し」、二行目以降が「データ」です。→サンプルデータ参照
 一行目はデータベースにおけるフィールドに相当します。ブラウザからは編集できません。
 二行目以降はブラウザから編集可能です。
 ★CSV形式のファイルとは、「test, 123, 名前, などなど」のようにカンマで区切られたデータのことです。
 CSVデータは、EXCELなどの表計算ソフトや、メモ帳などのテキストエディタで編集できます。

・見出しオプション・・見出し語後ろの#は、特別な意味を持ちます。
 #file・・データ編集時に、ファイル選択ボタン▼を表示します。kanri.plの設定により動作が異なります。
 #renban・・データ追加時に、末尾データの番号+1を自動採番します。
 #id・・データ追加時に、ログイン名を自動挿入
 #date・・データ追加時に、日付(0000/00/00)を自動挿入
 #datetime・・データ追加時に、日付時間（0000/00/00 00:00:00）を自動挿入
 #editedid・・データ更新時に、ログイン名を自動更新
 #editeddate・・データ更新時に、日付(0000/00/00)を自動更新
 #editedtime・・データ更新時に、日付時間（0000/00/00 00:00:00）を自動更新
 #文字列#default・・データ追加時に、文字列を自動挿入
 #文字列#noedit・・データ追加時に、文字列を自動挿入。その後、編集不可能。
 #A#A_B_C#radio・・データ変更時にラジオボタンを表示。#Aはデフォルト（省略可）、#A_B_Cは選択肢（_でつなぐ）。
 #A#A_B_C#select・・データ変更時にセレクトボックスを表示。#Aはデフォルト（省略可）、#A_B_Cは選択肢（_でつなぐ）。
 #A#A#checkbox・・データ変更時にチェックボックスを表示。前の#Aはデフォルト（省略可）、後ろの#Aはチェック時の表示値。
 #x#y#textarea・・複数行入力可能。#x#yはテキストエリアの行列数、省略可能。
 #A#B#C#join・・別csvファイルのデータを参照。#Cは別csvファイル名、#Bは#Cから読み出したいデータ列名、#Aは#Bを読み出すためのユニーク（2つのファイルをjoinする共通項）。
 A#calc・・四則演算。Aは計算元データになる列名を+-*/().及び半角数字でつないだ数式で、見出し語を兼ねる。例：単価*個数*1.05#calc。
 #permit1・・承認権1を持つ人が更新画面で承認できる。承認後の取り消しはできない。
 #permit2・・承認権2を持つ人が更新画面で承認できる。承認1の後に承認できる。承認後の取り消しはできない。
 #permit3・・承認権3を持つ人が更新画面で承認できる。承認2の後に承認できる。承認後の取り消しはできない。


フォルダ・ファイル名：
・CSVデータ名は日本語でも問題ありません。
・画像等のPCファイル名には半角英数文字を推奨します・・特にUNIXサーバーやインターネットを通すとき。
・Windowsサーバーを用いたLAN内では、あまり気にしなくても大丈夫です。

画像等PCファイル：
・CSVデータと同じフォルダに入れてください。
・CGIが持つアップロード機能を使っても、FTPやファイラーでアップしても同じ意味になります。

バージョンアップ：（データフォルダ以外の全てのファイルを入れ替えてください。）
・/data/フォルダを丸ごとバックアップしてください。データはそのまま使えます。
・現状のkanri.plを、名前を変えて保存してください（◎）。バックアップです。
・全てのファイルを最新のものに差し替えてください。
・/data/フォルダを元のデータに戻してください。
・kanri.plの内容を、◎を参考にしてカスタマイズしてください。


注意事項：
・データ量が増えると速度が低下し、サーバーに負担をかけます。サーバーの運営者や共有者に迷惑をかけないよう注意してください。
　速度低下が問題になる時は、CSVデータファイルを小さくして下さい。
　目安：【Pentium4サーバー】 + 【10列x10,000行（2MB）程度のcsvファイル】
・多重アクセスが起こった場合、データが破損または消滅する可能性があります（★）。
　頻繁にバックアップするなど管理者の責任でデータを保護してください。
　★ 対策は取っており必要以上に不安を煽るものではありませんが、可能性はゼロではありません。
・本CGIでは、機能相応の簡易認証機能 を採用しています。ユーザー様の責任でセキュリティーに関する必要な知識を習得し、ユーザー様の責任でサーバー＆データの安全性を確保して下さい。
・ 本スクリプトを使用した時点で、本ドキュメントの全ての項に同意したものとみなします。

著作権など：
・作者の許可無く、本スクリプトの設置代行や管理運営によって利益を得ることを禁止します。
・パッケージ内の"jcode.pl" は歌代和正氏によるPerlライブラリです。使用、改造等に関しては、氏のソース内メッセージをご覧下さい。
・パッケージ内の"jcode.pl"以外のファイルについて：
　フリーソフトです。しかし、作者は著作権を放棄しません。再配布は次の条件を満たせば自由です・・・条件：「オリジナルの著作権は作者（下記）にあること」を明示すること。改造は自由ですが、改造後の再配布は禁止します。尚、改造時には、ソース内およびWeb表示画面に「オリジナルの著作権は作者（下記）にあること」を明記してください。

その他：
・本パッケージ使用による損害について、作者は一切の責任を負いません。
・ご意見ご感想→shopmaster@sugawa.com ・・作者：（Sugar.T）

///　以上　///