NAME データベースオープン

FORMAT {%DB_OPEN(識別名,DBファイル名)}

---

データベースをオープンします。ファイルがない場合は、作成されます。識別名には、任意の名前を指定します。オープン後のデータベース処理は識別名を指定します。ファイル名はフルパスで指定します。拡張子は.dbにしてください。

NAME データベースクローズ

FORMAT {%DB_CLOSE(識別名)}

---

データベースをクローズします。識別名はデータベースオープンで指定した識別名を指定します。

NAME トランザクション開始

FORMAT {%DB_BEGIN_TRANS(識別名[,ビジータイムアウト])}

---

トランザクションを開始します。識別名はデータベースオープンで指定した識別名を指定します。

データベースでは、複数の操作が全て完了するか、全てキャンセルされることを保証するトランザクション処理が利用できます。

トランザクション開始後に追加、更新されたデータは、コミットを行うまでデータベースに書き込みされず、コミットを実行した時にデータが書き込まれます。

コミットを行わない場合(ロールバックを実行した場合)は、トランザクション開始後に行われたデータベースへの書き込みはすべてキャンセルされます。

また、トランザクションを開始するとデータベースが排他ロックされます。コミット、または、ロールバックが行われるまで、他のプロセスはトランザクションを開始できません。

排他ロックを利用すると、複数の端末からプラグイン実行で、共有フォルダに配置したデータベースファイルを排他的に更新できます。連番取得マクロを使って、複数人で重複しない連番を利用できます。

ビジータイムアウトは、排他処理でロックされている場合のタイムアウト値でミリ秒で指定します。省略した場合は、3000ミリ秒となります。(ネットワークフォルダにDBファイルがある場合は、指定した秒数以上になる場合があります。)

トランザクションが正常に開始された場合は、戻り値にOKが返却されます。IFマクロを使って、OKの場合に処理を行うようにしてください。

NAME コミット

FORMAT {%DB_COMIT(識別名)}

---

トランザクションをコミットします。識別名はデータベースオープンで指定した識別名を指定します。

トランザクション開始後に追加、更新されたデータをデータベースに書き込みます。

コミットを行わない場合(ロールバックを実行した場合)は、トランザクション開始後に行われたデータベースへの書き込みはすべてキャンセルされます。

NAME ロールバック

FORMAT {%DB_ROLLBACK(識別名)}

---

トランザクションをロールバックします。識別名はデータベースオープンで指定した識別名を指定します。

トランザクション開始後に追加、更新されたデータをすべて取り消します。

NAME 連番取得とカウントアップ

FORMAT {%GET_SEQ_NO_AND_COUNT_UP(識別名)}

---

連番を取得後、カウントアップを行います。

本マクロは、データベースファイルを使用します。データベースオープン、トランザクション開始、コミット、データベースクローズ等のマクロと組み合わせて使用します。

識別名はデータベースオープンで指定した識別名を指定します。

内部的には、データベース内に以下のテーブルを作成し、識別名、番号、リセットキーを保持します。

create table if not exists SeqNumberTable (Name text, SeqNumber integer, ResetKey text, primary key (Name))

本マクロが呼び出されると、識別名で検索を行い、SeqNumberを取得します。その後、SeqNumberを+1した数値で更新します。

本マクロは、連番リセットマクロ(RESET_SEQ_NO)とセットで使用します。本マクロの直前にRESET_SEQ_NOを記述してください。

NAME 連番取得

FORMAT {%GET_SEQ_NO(識別名)}

---

連番を取得します。

本マクロは、データベースファイルを使用します。データベースオープン、トランザクション開始、コミット、データベースクローズ等のマクロと組み合わせて使用します。

識別名はデータベースオープンで指定した識別名を指定します。

連番取得のみ行う場合は、本マクロを使用します。通常は、連番取得とカウントアップをセットで行う、連番取得とカウントアップマクロ(GET_SEQ_NO_AND_COUNT_UP)を使用してください。

NAME 連番リセット

FORMAT {%RESET_SEQ_NO(識別名,比較対照(RESET_KEY|NUMBER),比較符号,比較データ,連番初期値[,リセットキー初期値])}

---

連番のリセット判定を行い、条件に合致した場合は初期値に更新します。

本マクロは、データベースファイルを使用します。データベースオープン、トランザクション開始、コミット、データベースクローズ等のマクロと組み合わせて使用します。

識別名はデータベースオープンで指定した識別名を指定します。

比較対照は、RESET_KEYまたは、NUMBERを指定します。条件の右辺にリセットキーの値をセットする場合は、RESET_KEYを、番号の値をセットする場合は、NUMBERを指定します。

比較符号は、>,<,=,>=,<=,!=が指定できます。比較データには、条件の左辺となる値を指定します。

連番初期値は、条件に合致した際に更新する番号の初期値を指定します。

リセットキー初期値は、条件に合致した際に更新するリセットキーの初期値を指定します。省略した場合、比較対照がRESET_KEYの場合は比較データが初期値として更新されます。比較対照がNUMBERの場合は、リセットキーの更新は行いません。

本マクロの実行時に、識別名に該当するレコードが存在しない場合は、無条件で初期値をセットし、レコードを追加します。

本マクロは、連番取得マクロの直前に記述してください。初回の初期値設定と、リセット判定、およびリセットを行います。

使用例は、連番取得とカウントアップマクロの例を参照してください。以下の例は、番号リセットマクロの記述のみ紹介します。