ツールこばこ / MASTER NOTE

Master Note 操作ガイド

マスタを登録し、案件ごとの変更を比較して、SQLの出力とマスタ統合まで進めるための手順です。

Windows版 · v1.0.0 向け

画面例は検証版で撮影しています。アプリのバージョン表示やサンプルデータは、お使いの環境によって異なります。

1. ダウンロードと起動

  1. 購入案内メールからWindows用アプリのZIPと購入した版のライセンスを、それぞれダウンロードします。
  2. ZIPを右クリックし、「すべて展開」で書き込みできる場所に展開します。ZIP内のファイルを直接起動せず、展開先を開いてください。
  3. 展開したフォルダーのMasterNote.exeを起動します。
  4. 右上の「ライセンスを読み込む」から、メールで取得した MasterNote-Personal.mnlicense または MasterNote-Team.mnlicense を選びます。
  5. 完了通知と右上の版表示を確認します。読み込みに成功すると、次回起動時は保存済みライセンスを自動で読み込みます。
アプリのバージョンはタイトルバーと「設定」で確認できます。Personal/Teamの表示はライセンスの種類です。
画像01:展開済みのフォルダー
起動するのは直下のMasterNote.exe。ライセンスはメールの別リンクから取得します。
画像02:ライセンス読込み完了
右上の版表示と読込み完了通知を確認します。

保存先の役割

フォルダー用途
appアプリ本体。通常は中のファイルを操作しません。
user-data読み込んだライセンスと利用設定。
data登録したシステムの管理データとバックアップ。
output出力したSQL・CSV・レビュー・共有用ファイル。
docsこの操作ガイド。

アプリを移すときは、終了してからフォルダー全体を移してください。更新前には現在のフォルダー全体を別の場所へ保管してください。

2. 画面と作業の流れ

項目意味
システム販売管理など、マスタをまとめて管理する単位。対象DBもここで設定します。
正式マスタMaster Note内で統合済みのデータ。外部DBの状態は別に確認します。
案件初期構築・価格改定など、変更作業のまとまり。正式マスタとは別に下書きを持ちます。
テーブル(TBL)商品などのデータを入れる表。列の定義とレコードを扱います。
案件で編集→保存・比較→SQL出力→外部DBへ反映・照合→マスタ統合
Master NoteはDBに接続しません。 SQLはファイルに出力します。DBでの実行と結果確認は、お使いのDB操作ツールで行います。保存だけでは正式マスタへ統合されません。
画像03:メイン画面
左側の「システム/履歴/設定」、正式マスタ・案件・テーブルの位置を確認します。

3. 最初のマスタを作る

システムを登録する

  1. 「システム」タブの「システムを登録」を押します。
  2. システム名を入力し、実際に使う対象DB(MySQL/PostgreSQL/Oracle)を選びます。
  3. 「登録して初期構築を始める」を押します。「初期構築」案件が作成されます。
画像04:システム登録
例:システム名「操作ガイド用」、対象DBは利用するDBを選択。

テーブルと列を作る

  1. 「初期構築」案件を選び、「テーブル操作」→「新規TBLを作成」を押します。
  2. 「空のテーブルを作成(列を設定して入力)」を選びます。
  3. テーブル名と列を設定します。物理名はSQLで使用する名前、論理名は画面で使う表示名です。
  4. 主キーにする列を指定し、画面の作成ボタンで案件へ追加します。
例:PRODUCT型設定例
CODE(商品コード)text主キー・必須。文字列なら001の先頭ゼロを保持できます。
NAME(商品名)text必要な文字数の長さを指定。
PRICE(価格)decimal必要な精度と小数桁数を指定。
画像05:新規TBLの定義
テーブル名、物理名・論理名、型、主キーが見える状態。

レコードを入力・保存する

  1. 案件内のテーブルを選び、「行を追加」で行を作ります。
  2. 商品コード・商品名・価格を入力します。例:001/商品A/1200、002/商品B/3400。
  3. 「保存」を押し、エラーがないことを確認します。下書きは保存されますが、正式マスタはまだ変わりません。
  4. 「SQL出力とマスタ統合」の手順へ進みます。
画像06:2行を入力した案件
左の案件名とテーブル、入力した2行を確認します。
登録済みシステムでは自動保存も行われます。区切りのよいところで「保存」を押し、入力エラーや保存失敗がないことを確認してください。

4. 既存CSVから始める

  1. 対象DBから必要なテーブルのCSVを出力します。どの時点のデータか分かるよう保管します。
  2. システムを登録し、初期構築案件で「新規TBLを作成」→「CSVから取り込む(列とレコードを作成)」を選びます。
  3. CSVを選び、文字コード・区切り文字・見出しの有無・NULL識別文字を確認します。
  4. 列の型・主キー・長さなどを設定し、取り込んだ値が意図どおりであることを確認します。
  5. 保存・比較へ進みます。既存DBのマスタ登録では、初期構築用SQLをそのまま実行せず、登録元DBとの一致を確認してください。
画像07:CSVの取込み設定
CSVを選択して見出しを読み込んだ設定途中の画面。テーブル名を入力し、列の型・長さ・主キーを設定してから作成します。

CSVで案件のレコードを更新する

編集案件のテーブルを選び、「テーブル操作」→「CSVでレコードを更新」を使います。主キーが同じ行は更新、新しいキーの行は追加されます。CSVにない行は残ります。 削除したい行は、画面で確認して削除してください。

空文字とNULLは別の値です。NULL識別文字を指定しない場合、CSVの空欄は文字列として扱われます。設定と取込み後の値を確認してください。

5. 日々の変更作業

  1. 対象システムを選び、「案件を作る」から「価格改定」などの案件名を入力します。
  2. 案件内の対象テーブルを選び、セルを編集します。正式マスタの表示と取り違えないよう、左の選択位置を確認します。
  3. 追加は「行を追加」、削除は行のチェックを付けて「選択行を削除」です。削除確認の件数を確認します。
  4. 列の変更は「テーブル操作」→「列設定」です。既存の値が新しい桁数や必須条件に合うことを確認します。
  5. 保存してから「比較」へ進み、追加・削除・変更前後を確認します。

型ごとの入力

  • フラグ:チェックボックスで変更します。NULL許可の場合はNULLも扱います。
  • JSON:値の編集画面で項目・配列・値の種類を確認します。文字列の「null」とJSONのnull、SQLのNULLは区別してください。
  • NULL・空文字・DB既定値:セルの右クリックから必要な状態を明示します。DB既定値の操作は、定義に既定値がある列で使います。
画像08:列設定
型に応じた設定と論理名、詳細設定の位置。
画像09:フラグ・JSONを含む入力
フラグの状態とJSON編集画面。説明用に作成したデータを使用します。

表示を絞り込む

「フィルタ・並び替え」で条件を設定し、「表示条件を解除」で戻します。これは表示条件です。表示されていない行も保存検査・比較・SQL出力の対象に含まれます。

画像10:フィルタ・並び替え
表示だけを絞り込む操作です。

途中で別案件へ切り替えても、登録済みシステムでは入力を検査して保存します。不正な入力で切替が止まった場合は、その入力を修正してから進めます。

6. SQL出力とマスタ統合

  1. 案件を保存し、「比較」を押します。
  2. 比較画面で対象テーブルと、追加・削除・変更前後を確認します。意図しない差分があれば戻って修正します。
  3. 「SQLを出力」を押します。通知に表示された出力先を開き、出力ファイルと対象DBを確認します。
  4. お使いのDB操作ツールでSQLを確認して実行し、結果を照合します。定義変更がある場合は出力されたSQLの段階・順序を確認してください。
  5. 必要に応じて「反映成功を記録」または「反映失敗を記録」を使います。成功の記録だけでDBとの一致が保証されるわけではありません。
  6. 反映・照合を確認できたら、「必要なSQL反映・照合を完了しました(登録のみの場合は差分なしを確認)」にチェックします。
  7. 「マスタ統合」を押します。案件の内容がMaster Note内の正式マスタへ統合されます。
画像11:変更の比較
変更前後とSQL出力・反映結果記録・マスタ統合の位置。
画像12:SQL出力完了
出力先と「DBへの反映は行っていない」ことを確認します。
DBへの反映が失敗した、結果が一致しない、反映済みか不明な場合は、完了チェックを付けて統合せず、DBの状態と案件の差分を確認してください。SQLの再実行が安全かはDBの現在の状態によって変わります。

実DBのCSVで照合する

案件の「案件の出力・引継ぎ・DB反映確認」、または「設定」のシステム全体の操作からCSV照合を使います。DBから取得したCSVと、案件の反映予定または正式マスタを比較します。照合ではマスタやDBを書き換えません。

7. 履歴とチームの受け渡し

PersonalTeam
マスタ編集・保存・SQL出力利用できます利用できます
履歴の保持・閲覧/チーム共有Teamの機能です利用できます
利用範囲購入者本人同一法人・組織内

変更履歴を確認する(Team)

「履歴」タブで案件を選びます。詳細画面で変更前後やDB反映結果・メモを確認できます。過去のSQLを再出力しても、現在のDBへ安全に再実行できるとは限りません。戻す場合も現在の状態を確認し、変更案件として扱ってください。

画像13:履歴の詳細
案件名・変更前後・DB反映結果を確認します。

正式マスタと案件を受け渡す(Team)

  • 正式マスタを共有:「設定」→「正式マスタを共有」。作業途中の案件を含めず、正式マスタの共有ファイルを出力します。
  • 案件を引き継ぐ:案件の「案件の出力・引継ぎ・DB反映確認」から引継ぎ出力を使います。受取側は「設定」→「案件を引継ぎ受取」を使います。
  • 分岐した正式マスタを統合:「設定」→「共有された正式マスタを統合」。比較して、競合がある場合は採用する値を確認します。

受取・統合前に現在の作業を保存してください。ライセンスを共有ファイルへ入れたり、組織外へ配布したりしないでください。

8. バックアップと復旧

保存時に世代バックアップを保持します。保持数は「設定」→「バックアップ世代数」で設定できます。バックアップは同じアプリフォルダー内にあるため、PCや保存媒体の故障に備えるにはフォルダー全体を別の場所へ保管してください。

  1. 対象システムを選び、「設定」→「世代バックアップから開く」を押します。
  2. 日時・案件・テーブル内容を確認して世代を選びます。
  3. 確認用案件の画面で対象案件・テーブルを選び、当時の下書きと列定義を確認します。
  4. 戻したい内容なら復旧操作へ進み、確認画面で案件名を確認して「この案件を復旧する」を押します。
  5. 復旧後の案件を確認し、必要な変更作業を続けます。
画像14:世代バックアップの選択
日時だけでなく、案件と内容を確認します。
画像15:確認用案件の下書き
正式マスタではなく、選択した世代の案件の下書きを確認します。
この復旧操作は選択した案件の下書きを戻します。正式マスタや他の案件を戻す操作ではありません。外部DBの状態も変わりません。戻す必要がなければ「確認用案件を破棄して戻る」で閉じます。

9. 困ったとき

ライセンスが読み込めない

購入した版の.mnlicenseを選んでいるか、ダウンロードが完了しているかを確認してください。ファイルの内容は書き換えず、案内メールのリンクから取得し直します。失敗通知と現在の版表示を確認してください。

入力エラーで保存や切替が止まる

表示された列・値を確認します。主キーの空欄や重複、必須列のNULL、文字数・数値の精度、JSONの構文などを修正して再度保存します。表示フィルターで隠れている行も検査対象です。

正式マスタに編集結果が出ない

保存とマスタ統合は別です。案件を保存し、比較・SQL出力・外部DBへの反映と照合を済ませてから「マスタ統合」します。

操作ボタンが見つからない

左側の「システム/履歴/設定」と、折りたたまれている「テーブル操作」「案件の出力・引継ぎ・DB反映確認」を確認してください。「☰ メニュー」で左側を表示できます。

保存に失敗した、外部更新のエラーが出る

保存先の書込み権限や空き容量、他のMaster Noteで同じ管理ファイルを操作していないかを確認してください。原因を確認せず管理ファイルを上書きしないでください。

アプリを初期化したい

「設定」→「アプリを初期化(ライセンスを含む)」は、登録システム・管理データ・バックアップ・出力・設定・保存済みライセンスを削除します。必要なフォルダーと元のライセンスをアプリの外へ保管してから実行してください。通常の再起動や更新のために初期化する必要はありません。

画像16:システム全体の操作
SQL出力・共有・受渡し・DBとの照合。
画像16:復旧・利用設定
バックアップ・初期化・バージョン。

問い合わせる

toolkobako.contact@gmail.com 宛てに、アプリのバージョン、Personal/Team、対象DB、押したボタン、表示されたエラーをお知らせください。スクリーンショットは実データや個人情報が写っていないか確認してください。ライセンスファイルやカード情報を添付する必要はありません。

操作画面の拡大