[テンプレ]外部IF ファイル連携仕様

関連テンプレ構成
テンプレート
# IF-003: マスタデータ取込

**概要:**
マスタ管理システムから商品マスタや分類マスタ等の基礎データをCSVファイル形式で日次バッチ処理により取り込むファイル連携インターフェース。毎日深夜に最新のマスタデータを取得し、本システムのデータベースを更新することで、マスタデータの同期を実現する。

**連携方式:**
- プロトコル: SFTP
- 連携頻度: 日次(毎日 AM 2:00- ファイル形式: CSVUTF-8BOM無し)

**ファイル配置:**
```
/data/import/master_YYYYMMDD.csv
```

**ファイル命名規則:**
```
{ファイル種別}_{YYYYMMDD}.csv
例: master_20251120.csv
```

**CSV仕様:**
```csv
product_id,product_name,category,price,stock
P001,商品A,カテゴリ1,1000,50
P002,商品B,カテゴリ2,2000,30
```

**列定義:**
| 列No | 項目名 || 桁数 | 必須 | 備考 |
|------|-------|-----|-----|-----|------|
| 1 | product_id | 文字列 | 10 || 商品ID |
| 2 | product_name | 文字列 | 100 || 商品名 |
| 3 | category | 文字列 | 50 || カテゴリ |
| 4 | price | 数値 | 10 || 価格 |
| 5 | stock | 数値 | 5 || 在庫数 |

**処理フロー:**
1. ファイル取得
2. バリデーション(形式チェック、必須チェック)
3. データ取込(トランザクション処理)
4. 処理結果ログ出力
5. 完了ファイル作成(`master_YYYYMMDD.done`**エラーハンドリング:**
- バリデーションエラー: エラーログ出力、管理者通知
- ファイル不存在: リトライ(最大3回、10分間隔)
- 取込エラー: ロールバック、エラーファイル出力

**ファイル保管:**
- 処理済みファイルは7日間保管後削除
- エラーファイルは30日間保管

---
プレビュー

IF-003: マスタデータ取込

概要:
マスタ管理システムから商品マスタや分類マスタ等の基礎データをCSVファイル形式で日次バッチ処理により取り込むファイル連携インターフェース。毎日深夜に最新のマスタデータを取得し、本システムのデータベースを更新することで、マスタデータの同期を実現する。

連携方式:

  • プロトコル: SFTP
  • 連携頻度: 日次(毎日 AM 2:00)
  • ファイル形式: CSV(UTF-8、BOM無し)

ファイル配置:

/data/import/master_YYYYMMDD.csv

ファイル命名規則:

{ファイル種別}_{YYYYMMDD}.csv
: master_20251120.csv

CSV仕様:

product_id,product_name,category,price,stock
P001,商品A,カテゴリ1,1000,50
P002,商品B,カテゴリ2,2000,30

列定義:

列No 項目名 桁数 必須 備考
1 product_id 文字列 10 商品ID
2 product_name 文字列 100 商品名
3 category 文字列 50 カテゴリ
4 price 数値 10 価格
5 stock 数値 5 在庫数

処理フロー:

  1. ファイル取得
  2. バリデーション(形式チェック、必須チェック)
  3. データ取込(トランザクション処理)
  4. 処理結果ログ出力
  5. 完了ファイル作成(master_YYYYMMDD.done

エラーハンドリング:

  • バリデーションエラー: エラーログ出力、管理者通知
  • ファイル不存在: リトライ(最大3回、10分間隔)
  • 取込エラー: ロールバック、エラーファイル出力

ファイル保管:

  • 処理済みファイルは7日間保管後削除
  • エラーファイルは30日間保管