【ITニュース解説】Processing ISO 20022 payment XML in Rust: detection, typed parsing and JSON

金融業界では、世界中の銀行や金融機関が日々、送金や決済といった多種多様な取引を行っている。これらの取引を円滑に進めるためには、情報伝達の方法が共通のルールに従っていることが不可欠である。この共通ルールの一つが「ISO 20022」と呼ばれる国際標準規格である。ISO 20022は、金融メッセージの形式をXML（Extensible Markup Language）という構造化されたデータ形式で定義しており、異なるシステム間での情報のやり取りを可能にしている。

今回紹介する記事は、このISO 20022規格の金融支払いXMLメッセージを、Rustというプログラミング言語を使ってどのように処理するかを具体的に解説している。システムエンジニアを目指す人にとって、このような国際標準規格を扱う技術は、金融システム開発の現場で非常に役立つ知識となるだろう。

Rustは、安全性と高性能を両立させることに強みを持つプログラミング言語である。特に、システム開発や高い信頼性が求められる金融分野で注目を集めている。記事では、「rust_iso20022」というRust製のライブラリ（特定の機能を提供するプログラムの集まり）を使って、ISO 20022のXMLメッセージを効率的に処理する手順が示されている。このライブラリは、Apache-2.0ライセンスで公開されており、Rustのバージョン1.85以降に対応している。

まず、XMLメッセージを処理する最初のステップとして、そのメッセージがどのような種類のISO 20022メッセージであるかを特定する必要がある。ISO 20022には様々な種類のメッセージがあり、それぞれが異なる目的（例えば、送金指示、取引明細など）を持っている。記事の最初の例では、XML文字列からメッセージの種類を自動的に検出するdetect関数と、XMLをツリー構造として解析し、特定の要素（タグ）から情報を抽出するMxNode::parse関数が使われている。

具体的なコードを見ると、cargo new iso20022-demoというコマンドで新しいRustプロジェクトを作成し、cargo add rust_iso20022@0.1.6でライブラリを追加している。これは、Rustでの開発においてプロジェクトの準備と外部ライブラリの組み込みを行う基本的な手順である。提供されたXMLサンプルでは、pacs.008.001.08という種類のメッセージが扱われている。これは、顧客による金融機関間送金指示を示す特定のメッセージバージョンである。

最初のコード例では、まずXML文字列全体からdetect関数を使ってメッセージの種類（pacs.008.001.08）を特定している。次に、MxNode::parseを使ってXMLを解析し、ツリー構造として扱う。このツリー構造の中から、find("MsgId")で「MsgId」というタグを探し、その中のテキスト内容をtext()で取得して「メッセージID」を取り出している。同様に、「IntrBkSttlmAmt」というタグを見つけ、その値と「Ccy」（通貨）という属性の値を取得して、金額と通貨を表示している。この方法は「モデルフリー」な処理と呼ばれ、XMLの構造を直接たどって必要な情報を取り出すため、柔軟だが、XMLの構造が少しでも変わるとコードの修正が必要になる可能性がある。

次に、記事はより高度なXMLメッセージの処理方法に進む。それは「型付けされた解析」と呼ばれるアプローチである。これは、XMLメッセージの構造に合わせて、事前にRustの「構造体」（関連するデータをまとめた型）を定義しておき、XMLをその構造体に自動的に変換する方法である。このアプローチでは、コードがより読みやすくなり、コンパイル時にデータの型に関するエラーを検出できるため、より安全で堅牢なプログラムを作成できる。

型付けされた解析を行うためには、rust_iso20022ライブラリの特定の機能（フィーチャー）を有効にする必要がある。cargo add rust_iso20022@0.1.6 --features model-pacs,serde,convertというコマンドで、model-pacs（pacs関連のメッセージモデル）、serde（JSON変換）、convert（数値・日付変換）といった機能を追加している。これにより、ライブラリが提供する事前定義された型を使ってXMLを処理できるようになる。

2番目のコード例では、from_xml関数を使ってXML文字列をRustのDocument構造体に変換している。このDocument構造体は、ISO 20022のpacs.008.001.08メッセージの構造を正確に反映しているため、document.fi_to_fi_cstmr_cdt_trf.grp_hdr.msg_id.0のように、.を使って直接、必要なデータにアクセスできる。これにより、コードはより直感的で理解しやすくなる。

また、金融取引では小数点以下の金額を正確に扱うことが非常に重要である。一般的な浮動小数点数（floatやdouble）では、計算誤差が生じる可能性があるため、rust_iso20022::convert::to_decimal関数を使って、金額を正確な十進数（Decimal）型に変換し、安全に計算を行っている。例では、金額を2倍にする計算が示されており、正確な2469.12という結果が得られる。

さらに、記事では、to_xml関数でRustの構造体を再度XML文字列に変換し、それが元のXMLと等しいかを確認する「XMLラウンドトリップ」のテストも行っている。これは、データが正しく往復変換できることを確認する重要な手順である。ただし、このテストは元のXMLの空白やバイト列まで完全に一致することを保証するものではなく、データの内容が一致することを意味している。

最後に、to_json関数を使ってRustの構造体をJSON形式に変換する例も示されている。JSONは、Webアプリケーションなどでよく使われる軽量なデータ形式であり、ISO 20022のXMLデータをJSONに変換することで、他のシステムとの連携や内部処理が容易になる場合がある。しかし、このJSONデータがそのまま銀行ネットワークでISO 20022 XMLの代わりに使えるわけではない点に注意が必要である。ISO 20022はXML形式を要求するため、JSONはあくまで内部的な用途に限られることが多い。

記事の注意点として、rust_iso20022ライブラリが提供する機能は、XMLメッセージの「解析」と「型付けされたアクセス」が中心であり、完全なXSD（XML Schema Definition）バリデーション（XMLが定義されたルールに厳密に従っているかを確認する処理）は実装されていないことが挙げられている。また、すべてのISO 20022モデルをまとめてコンパイルすると、コンパイル時間やメモリ消費が大きくなるため、必要なメッセージファミリー（例えばpacsだけ）を選んで有効にすることが推奨されている。

このように、この記事はISO 20022という金融業界の重要な標準規格を、Rustという先進的な言語でどのように効率的かつ安全に処理するかを、具体的なコード例を通して初心者にもわかりやすく解説している。金融システムの開発を目指すシステムエンジニアにとって、データの正確な処理や異なるシステム間でのデータ交換の重要性を理解し、そのための技術を学ぶ良い出発点となるだろう。