
GASで『全銀フォーマット』生成の設計全書。Shift_JIS・バイト計算・外部マスタ連携の手順
銀行振込の自動化において、最大の難所となるのが「全銀フォーマット」の作成です。 前回、「銀行振込の裏側を解剖!」についての記事を書きましたが、今回はその第2弾。
「どうやってGASで、あの厳格な固定長ファイルを組み上げるのか?」という実装設計にスポットを当てて解説します。
1. GASの「文字数」と全銀の「バイト数」の乖離
最初につまずくのが、「120バイト固定長」というルールです。 GASの string.length は「文字数」を返しますが、全銀フォーマットが求めているのは「Shift_JISにおけるバイト数」です。
UTF-8(GAS): 「ア」も「亜」も3バイト(または文字数として1)
Shift_JIS(銀行): 「ア」は1バイト、「亜」は2バイト
この乖離を埋めるために、1文字ずつ文字コードを判定してバイト数を計算するロジックが不可欠になります。
function getByteCount(str) {
let count = 0;
for (let i = 0; i < str.length; i++) {
let c = str.charCodeAt(i);
// 半角英数および半角カナ(FF61-FF9F)は1バイト、それ以外は2バイト
if ((c >= 0x0020 && c <= 0x007e) || (c >= 0xff61 && c <= 0xff9f)) count += 1;
else count += 2;
}
return count;
}この計算を基に、足りない分を半角スペースで埋める(右パディング)、あるいは0で埋める(左パディング)という共通関数を自作するのが、設計の第一歩です。
2. GitHubマスタ(ZenginCode)による「表記ゆれ」の根絶
スプレッドシート上の銀行名や支店名は、人間が入力する以上必ず「三菱UFJ」「三菱UFJ銀行」といった表記ゆれが発生します。しかし、銀行システムは半角カナ一択な上、1文字のズレも許してくれません。
そこで活用したのが、有志によりメンテナンスされているzengin-codeです。
実装の工夫:キャッシュ機構
毎行外部へフェッチ(UrlFetchApp)に行くと処理が重くなり、GASの制限時間に引っかかります。 zenginCache というオブジェクトを用意し、一度取得した銀行・支店データは使い回す設計にしました。
「コード(番号)さえ合っていれば、名称はマスタから正解の半角カナを引っ張ってくる」という逆引きロジックを組むことで、入力ミスによるエラーを未然に防いでいます。
3. 鉄壁の「半角カナ変換」と「サニタイズ」
全銀フォーマットのデータレコードにおいて、漢字や全角記号が1文字でも混入すると、その行以降のバイト数がすべてズレる致命的なエラーになります。
今回は、以下の2段構えで「データの清浄化」を行いました。
マッピング変換: アイウエオ → アイウエオ のように、独自のマップ関数で徹底的に半角へ変換。
正規表現のフィルター: 最後に以下の正規表現を通し、半角英数カナ以外の文字をすべて除去します。
res.replace(/[^\u0020-\u007E\uFF61-\uFF9F]/g, "");
この「絶対に想定外の文字を外に出さない」というガードが、フォーマットチェック一発合格の最大の要因です。
4. GASでShift_JISの「Blob」を生成する魔法
GASの標準はUTF-8ですが、銀行が求めているのはShift_JISのバイナリデータです。 普通に出力すると文字化けしますが、GASにはこの変換を一行でやってのけるメソッドが存在します。
const blob = Utilities.newBlob("")
.setDataFromString(output, "Shift_JIS")
.setName(fileName);この setDataFromString でエンコーディングを明示することで、Googleの世界のデータを、銀行の世界の言葉(Shift_JIS)へと正しく翻訳できます。
まとめ:正確なコードは、経理の安心に繋がる
全銀フォーマットの作成は、まるで「1ミリのズレも許さないレンガ積み」のような作業です。
しかし、一度正確なロジックを組んでしまえば、これまで数十分かけていた手入力の作業が、わずか数秒〜数十秒、ノーミスで完了します。GASによる自動化の本質は時短だけでなく、「ミスが許されない作業からの解放」という心理的安全性にあると、改めて実感しました。
もし皆さんの会社で「全銀ファイル作成に苦労している」という方がいれば、ぜひこの「バイト数管理」と「マスタ連携」の視点を取り入れてみてください!
今回解説したコードの全文はこちらから確認できます👇
https://gist.github.com/sawahotaru/6eaffb07685f61c532b09ecd11ed4083