マスタデータ同期・テストデータ作成 利用マニュアル

目次

1. 概要
2. マスタデータの同期
3. ダミーテストデータの作成
4. テストデータ作成時のデフォルト値
5. トラブルシューティング

概要

関連ドキュメント

• 概要設計書（GitHub）

実行環境

• Sandbox環境でのみ実行可能です。本番環境では実行できません。
• 2026/1/9以降に作成したSandboxが必要です。それ以前のSandboxには本機能がデプロイされていません。
• 「システム管理」アプリケーションから実行します。

アクセス方法

1. Salesforceにログイン
2. アプリケーションランチャーから「システム管理」を選択
3. 「マスタデータ作成」タブを開く

マスタデータの同期

概要

本番環境のマスタデータをSandbox環境に同期する機能です。

利用手順

1. 「マスタデータ作成」を開く
   

2. 同期対象のオブジェクトを選択
   

3. 同期方法を確認（現在は「更新または追加（Upsert）」のみ）

4. 「同期実行」ボタンをクリック

5. 処理完了まで待機（進捗状況が表示されます）
   
   同期完了
   

同期対象オブジェクト一覧

同期方法

補足: 現在は「更新または追加（Upsert）」モードのみ提供されています。

注意点

重要: 以下の制限事項を必ず確認してください。

1. レコード件数の上限

• 1オブジェクトあたり20,000件が上限です
• 上限を超えるデータは同期されません

2. UPSERT時のデータ更新について

• 同期方法が「UPSERT」の場合、過去に同期したデータがSandbox上に存在すると、本番環境の最新値で上書き更新されます
• キー項目は UpsertKey__c 項目（本番環境のレコードID）です
• Sandbox上で手動変更したデータも上書きされる可能性があるため、注意してください

3. 同期実行時間

• データ量により処理時間が異なります
• 大量データの同期は数分〜数十分かかる場合があります

ダミーテストデータの作成

テスト用のダミーデータを作成する機能です。

不動産会社の作成

1. 「システム管理」アプリケーションを開く
2. 「マスタデータ作成」タブを開く
3. 「不動産会社作成」ボタンをクリック
4. 必要に応じて件数を指定
5. 「作成」を実行

📷 スクリーンショット必要: マスタデータ作成タブの不動産会社作成フォーム

入居データの作成

入居データは3つの方法で作成できます。

アクセス方法:

1. 「システム管理」アプリケーションを開く
2. 「不動産会社」を開く
3. 画面右側の「テストデータの作成」タブをクリック

方法1: CSVテキストから作成する

1. 「入居作成」セクションで「CSVテキストから作成」を選択
2. 以下のフォーマットでCSVテキストを入力（複数行入力可能）:
   コピー

   郵便番号,都道府県,市区町村,町名,丁目,番地,号,建物名,建物名カナ,部屋番号,姓,名,姓カナ,名カナ
   

   入力例（複数件）:

   コピー

   540-0010,大阪府,大阪市中央区,材木町,,1,8,SRビル本町東,エスアールビルホンマチヒガシ,101,山田,太郎,ヤマダ,タロウ
   530-0001,大阪府,大阪市北区,梅田,1,1,1,グランフロント大阪,グランフロントオオサカ,2001,鈴木,花子,スズキ,ハナコ
   

3. 「作成」を実行
   

方法2: カスタムメタデータから作成する

1. 「入居作成」セクションで「カスタムメタデータから作成」を選択
2. 「作成」を実行
   
   補足:

• カスタムメタデータ irregularAddress__mdt に登録された住所情報から入居を作成します
• 入居の「名」項目には、カスタムメタデータの**表示ラベル（MasterLabel）**が設定されます

方法3: 都道府県を選択して作成

1. 「入居作成」セクションで「都道府県を選択して作成」を選択
2. 対象の都道府県を選択
3. 「作成」を実行
   

サービス案内の作成について

利用方法

『サービス案内も同時に作成する』にチェックして作成するサービスを選択すると入居データ作成時に、自動的にサービス案内も作成されます。

サービス案内作成時のエラー対処

サービス案内の作成で入力規則エラーが発生した場合、システムは以下の処理を自動的に行います：

1. 「入力規則無効_動的マニュアル」項目を True に設定して、強制的にレコードを作成
2. エラーメッセージを「備考」項目に記録

⚠️ 重要: 作成されたサービス案内は入力規則をバイパスした状態のため、データ修正が必要です。

作成後の対応手順（必須）

📷 スクリーンショット必要: エラーメッセージの表示例

1. 作成されたサービス案内レコードを開く
2. 「備考」項目に記録されたエラーメッセージを確認
3. エラー内容に従ってデータを修正
4. 「入力規則無効_動的マニュアル」項目を False に戻す
5. レコードを保存

ルール: 入力規則無効フラグが True のままのレコードは、正常なデータとして扱わないでください。必ず上記の手順でデータを修正してください。

テストデータ作成時のデフォルト値

テストデータ作成時に自動設定されるデフォルト値の一覧です。

不動産会社（Account）のデフォルト値

関連クラス: CreateTestData.cls - CreateEstateTestData() メソッド

入居（MoveIn__c）のデフォルト値

現住所のデフォルト値

関連クラス: MoveInCreationBatch.cls

サービス案内（ServiceGuide__c）のデフォルト値

関連クラス: MoveInCreationBatch.cls, CreateTestData.cls

補足: 入力規則エラー発生時の動作については、「サービス案内作成時のエラー対処」を参照してください。

トラブルシューティング

入居・不動産会社・サービス案内が作成できない場合

症状

入力規則の追加などにより、テストデータが作成できなくなった。

原因

CreateTestData クラスまたは MoveInCreationBatch クラスで設定しているベースデータが、新しい入力規則の条件を満たしていない可能性があります。

対処方法

1. 以下のクラスを開く:
   • force-app/main/default/classes/CreateTestData.cls
   • force-app/main/default/classes/MoveInCreationBatch.cls
2. 該当するメソッド/定数を特定:
   • 入居作成: MoveInCreationBatch.cls の定数（DEFAULT_*）
   • サービス案内作成: CreateTestData.cls - CreateServiceGuideTestData() メソッド
   • 不動産会社作成: CreateTestData.cls - CreateEstateTestData() メソッド
3. ベースデータの入力値を入力規則に合うよう修正
4. 変更をデプロイ

修正例

// CreateTestData.cls の修正例

// 修正前
moveIn.Status__c = '未対応';

// 修正後（入力規則で必須になった項目を追加）
moveIn.Status__c = '未対応';
moveIn.RequiredField__c = '必須値';  // 新しい入力規則に対応