1. ダウンロードと起動
- 購入案内メールからWindows用アプリのZIPと購入した版のライセンスを、それぞれダウンロードします。
- ZIPを右クリックし、「すべて展開」で書き込みできる場所に展開します。ZIP内のファイルを直接起動せず、展開先を開いてください。
- 展開したフォルダーのMasterNote.exeを起動します。
- 右上の「ライセンスを読み込む」から、メールで取得した
MasterNote-Personal.mnlicenseまたはMasterNote-Team.mnlicenseを選びます。 - 完了通知と右上の版表示を確認します。読み込みに成功すると、次回起動時は保存済みライセンスを自動で読み込みます。
保存先の役割
| フォルダー | 用途 |
|---|---|
| app | アプリ本体。通常は中のファイルを操作しません。 |
| user-data | 読み込んだライセンスと利用設定。 |
| data | 登録したシステムの管理データとバックアップ。 |
| output | 出力したSQL・CSV・レビュー・共有用ファイル。 |
| docs | この操作ガイド。 |
アプリを移すときは、終了してからフォルダー全体を移してください。更新前には現在のフォルダー全体を別の場所へ保管してください。
2. 画面と作業の流れ
| 項目 | 意味 |
|---|---|
| システム | 販売管理など、マスタをまとめて管理する単位。対象DBもここで設定します。 |
| 正式マスタ | Master Note内で統合済みのデータ。外部DBの状態は別に確認します。 |
| 案件 | 初期構築・価格改定など、変更作業のまとまり。正式マスタとは別に下書きを持ちます。 |
| テーブル(TBL) | 商品などのデータを入れる表。列の定義とレコードを扱います。 |
3. 最初のマスタを作る
システムを登録する
- 「システム」タブの「システムを登録」を押します。
- システム名を入力し、実際に使う対象DB(MySQL/PostgreSQL/Oracle)を選びます。
- 「登録して初期構築を始める」を押します。「初期構築」案件が作成されます。
テーブルと列を作る
- 「初期構築」案件を選び、「テーブル操作」→「新規TBLを作成」を押します。
- 「空のテーブルを作成(列を設定して入力)」を選びます。
- テーブル名と列を設定します。物理名はSQLで使用する名前、論理名は画面で使う表示名です。
- 主キーにする列を指定し、画面の作成ボタンで案件へ追加します。
| 例:PRODUCT | 型 | 設定例 |
|---|---|---|
| CODE(商品コード) | text | 主キー・必須。文字列なら001の先頭ゼロを保持できます。 |
| NAME(商品名) | text | 必要な文字数の長さを指定。 |
| PRICE(価格) | decimal | 必要な精度と小数桁数を指定。 |
レコードを入力・保存する
- 案件内のテーブルを選び、「行を追加」で行を作ります。
- 商品コード・商品名・価格を入力します。例:001/商品A/1200、002/商品B/3400。
- 「保存」を押し、エラーがないことを確認します。下書きは保存されますが、正式マスタはまだ変わりません。
- 「SQL出力とマスタ統合」の手順へ進みます。
4. 既存CSVから始める
- 対象DBから必要なテーブルのCSVを出力します。どの時点のデータか分かるよう保管します。
- システムを登録し、初期構築案件で「新規TBLを作成」→「CSVから取り込む(列とレコードを作成)」を選びます。
- CSVを選び、文字コード・区切り文字・見出しの有無・NULL識別文字を確認します。
- 列の型・主キー・長さなどを設定し、取り込んだ値が意図どおりであることを確認します。
- 保存・比較へ進みます。既存DBのマスタ登録では、初期構築用SQLをそのまま実行せず、登録元DBとの一致を確認してください。
CSVで案件のレコードを更新する
編集案件のテーブルを選び、「テーブル操作」→「CSVでレコードを更新」を使います。主キーが同じ行は更新、新しいキーの行は追加されます。CSVにない行は残ります。 削除したい行は、画面で確認して削除してください。
空文字とNULLは別の値です。NULL識別文字を指定しない場合、CSVの空欄は文字列として扱われます。設定と取込み後の値を確認してください。
5. 日々の変更作業
- 対象システムを選び、「案件を作る」から「価格改定」などの案件名を入力します。
- 案件内の対象テーブルを選び、セルを編集します。正式マスタの表示と取り違えないよう、左の選択位置を確認します。
- 追加は「行を追加」、削除は行のチェックを付けて「選択行を削除」です。削除確認の件数を確認します。
- 列の変更は「テーブル操作」→「列設定」です。既存の値が新しい桁数や必須条件に合うことを確認します。
- 保存してから「比較」へ進み、追加・削除・変更前後を確認します。
型ごとの入力
- フラグ:チェックボックスで変更します。NULL許可の場合はNULLも扱います。
- JSON:値の編集画面で項目・配列・値の種類を確認します。文字列の「null」とJSONのnull、SQLのNULLは区別してください。
- NULL・空文字・DB既定値:セルの右クリックから必要な状態を明示します。DB既定値の操作は、定義に既定値がある列で使います。
表示を絞り込む
「フィルタ・並び替え」で条件を設定し、「表示条件を解除」で戻します。これは表示条件です。表示されていない行も保存検査・比較・SQL出力の対象に含まれます。
途中で別案件へ切り替えても、登録済みシステムでは入力を検査して保存します。不正な入力で切替が止まった場合は、その入力を修正してから進めます。
6. SQL出力とマスタ統合
- 案件を保存し、「比較」を押します。
- 比較画面で対象テーブルと、追加・削除・変更前後を確認します。意図しない差分があれば戻って修正します。
- 「SQLを出力」を押します。通知に表示された出力先を開き、出力ファイルと対象DBを確認します。
- お使いのDB操作ツールでSQLを確認して実行し、結果を照合します。定義変更がある場合は出力されたSQLの段階・順序を確認してください。
- 必要に応じて「反映成功を記録」または「反映失敗を記録」を使います。成功の記録だけでDBとの一致が保証されるわけではありません。
- 反映・照合を確認できたら、「必要なSQL反映・照合を完了しました(登録のみの場合は差分なしを確認)」にチェックします。
- 「マスタ統合」を押します。案件の内容がMaster Note内の正式マスタへ統合されます。
実DBのCSVで照合する
案件の「案件の出力・引継ぎ・DB反映確認」、または「設定」のシステム全体の操作からCSV照合を使います。DBから取得したCSVと、案件の反映予定または正式マスタを比較します。照合ではマスタやDBを書き換えません。
7. 履歴とチームの受け渡し
| Personal | Team | |
|---|---|---|
| マスタ編集・保存・SQL出力 | 利用できます | 利用できます |
| 履歴の保持・閲覧/チーム共有 | Teamの機能です | 利用できます |
| 利用範囲 | 購入者本人 | 同一法人・組織内 |
変更履歴を確認する(Team)
「履歴」タブで案件を選びます。詳細画面で変更前後やDB反映結果・メモを確認できます。過去のSQLを再出力しても、現在のDBへ安全に再実行できるとは限りません。戻す場合も現在の状態を確認し、変更案件として扱ってください。
正式マスタと案件を受け渡す(Team)
- 正式マスタを共有:「設定」→「正式マスタを共有」。作業途中の案件を含めず、正式マスタの共有ファイルを出力します。
- 案件を引き継ぐ:案件の「案件の出力・引継ぎ・DB反映確認」から引継ぎ出力を使います。受取側は「設定」→「案件を引継ぎ受取」を使います。
- 分岐した正式マスタを統合:「設定」→「共有された正式マスタを統合」。比較して、競合がある場合は採用する値を確認します。
受取・統合前に現在の作業を保存してください。ライセンスを共有ファイルへ入れたり、組織外へ配布したりしないでください。
8. バックアップと復旧
保存時に世代バックアップを保持します。保持数は「設定」→「バックアップ世代数」で設定できます。バックアップは同じアプリフォルダー内にあるため、PCや保存媒体の故障に備えるにはフォルダー全体を別の場所へ保管してください。
- 対象システムを選び、「設定」→「世代バックアップから開く」を押します。
- 日時・案件・テーブル内容を確認して世代を選びます。
- 確認用案件の画面で対象案件・テーブルを選び、当時の下書きと列定義を確認します。
- 戻したい内容なら復旧操作へ進み、確認画面で案件名を確認して「この案件を復旧する」を押します。
- 復旧後の案件を確認し、必要な変更作業を続けます。
9. 困ったとき
ライセンスが読み込めない
購入した版の.mnlicenseを選んでいるか、ダウンロードが完了しているかを確認してください。ファイルの内容は書き換えず、案内メールのリンクから取得し直します。失敗通知と現在の版表示を確認してください。
入力エラーで保存や切替が止まる
表示された列・値を確認します。主キーの空欄や重複、必須列のNULL、文字数・数値の精度、JSONの構文などを修正して再度保存します。表示フィルターで隠れている行も検査対象です。
正式マスタに編集結果が出ない
保存とマスタ統合は別です。案件を保存し、比較・SQL出力・外部DBへの反映と照合を済ませてから「マスタ統合」します。
操作ボタンが見つからない
左側の「システム/履歴/設定」と、折りたたまれている「テーブル操作」「案件の出力・引継ぎ・DB反映確認」を確認してください。「☰ メニュー」で左側を表示できます。
保存に失敗した、外部更新のエラーが出る
保存先の書込み権限や空き容量、他のMaster Noteで同じ管理ファイルを操作していないかを確認してください。原因を確認せず管理ファイルを上書きしないでください。
アプリを初期化したい
「設定」→「アプリを初期化(ライセンスを含む)」は、登録システム・管理データ・バックアップ・出力・設定・保存済みライセンスを削除します。必要なフォルダーと元のライセンスをアプリの外へ保管してから実行してください。通常の再起動や更新のために初期化する必要はありません。
問い合わせる
toolkobako.contact@gmail.com 宛てに、アプリのバージョン、Personal/Team、対象DB、押したボタン、表示されたエラーをお知らせください。スクリーンショットは実データや個人情報が写っていないか確認してください。ライセンスファイルやカード情報を添付する必要はありません。