自動化を小さく始めるなら、「一つのファイルに何行書くか」より、一つの業務の入力から出力までを説明できる範囲へ絞ります。複数の部門や外部送信まで一度に結ばない形にします。
1業務1スクリプトは責任範囲を明確にする目安です。何でも別ファイルにする規則ではなく、失敗したときにどの処理を止め、何を確認するかが分かる単位を選びます。
最初の業務を入出力で書く
たとえば「受け取ったCSVの列をそろえ、確認用の別CSVを出す」を最初の範囲にします。メール送信や共有データの更新は、別の作業として後から判断します。
| 決めること | 例 |
|---|---|
| 入力 | コピーしたCSV、必須列、文字コード |
| 処理 | 列名を定めた対応表でそろえる |
| 出力 | 元データと別の確認用CSV |
| 成功条件 | 件数と主要列が入力と対応する |
| 停止条件 | 必須列不足、重複キー、読込失敗 |
| 戻し方 | 元データを使った手作業へ戻す |
列名の変換と、値の内容を判断して変える処理も区別します。ルールが曖昧な例外は自動補完せず、確認待ちへ分けます。
小さな入力で結果を照合する
実データのコピーや架空データで、通常、空、必須列不足、重複のケースを試します。元の入力を上書きせず、出力の件数と値を比べます。
失敗時に途中の出力を完成品として扱わないことが必要です。出力ファイルができたことだけで成功とせず、処理終了の状態と確認結果を分けて残してください。
CSVなら単純なカンマ分割ではなく、引用符や改行を扱うライブラリを使います。入力の仕様と適用できない条件をREADMEへ書き、次の利用者が判断できる形にします。
広げる前に運用を確認する
必要な読み取り先と書き込み先、利用ユーザー、実行方法を整理し、権限は必要な範囲へ絞ります。定期実行へ移す場合も、失敗を誰が何で知るかを先に決めます。
手作業の時間と、自動化後の準備・確認・保守時間を測ります。処理の速さだけで対象を増やさず、例外対応と復旧が追えることを確認します。
範囲を広げるときは一つの出力を次の入力として引き継ぎ、失敗地点が分かるようにします。この記事は設計例で、社内データの更新や外部送信は実行していません。
