Merge pull request #5 from Ajai-Suvendran/data-mapper-0.9.1

Resolve Build Issue
ballerina-platform · Jan 6, 2025 · 39f55e1 · 39f55e1
2 parents 26fc817 + e1225e5
commit 39f55e1
Show file tree

Hide file tree

Showing 25 changed files with 551 additions and 423 deletions.
diff --git a/README.md b/README.md
@@ -1,4 +1,4 @@
-# Ballerina SWIFT MT to ISO 20022 Data Mapper Library
+# Ballerina ISO 20022 to SWIFT MT Data Mapper Library
 
 ## Overview
 
@@ -29,35 +29,75 @@ The DataMapper Library is a comprehensive toolkit designed to convert ISO 20022
 
 ## Usage
 
-### Conversion of ISO 20022 to SWIFT MT
+### Conversion of ISO 20022 xml to SWIFT MT message
 
 ```ballerina
 import ballerina/io;
 import ballerinax/financial.iso20022ToSwiftMT as mxToMt;
 
 public function main() returns error? {
-    string isoMessage = string `<Document xmlns="urn:iso:std:iso:20022:tech:xsd:camt.054.001.04">
-    <BkToCstmrDbtCdtNtfctn>
-        <GrpHdr>
-            <MsgId>C11126A1378</MsgId>
-            <CreDtTm>2024-12-16T12:00:00Z</CreDtTm>
-        </GrpHdr>
-        <Ntfctn>
-            <Id>5482ABC</Id>
-            <Acct>
-                <Id>
-                    <IBAN>CH9380000000009876543</IBAN>
-                </Id>
-            </Acct>
-            <TxsSummry>
-                <TtlAmt>
-                    <Amt Ccy="USD">233530.00</Amt>
-                </TtlAmt>
-            </TxsSummry>
-        </Ntfctn>
-    </BkToCstmrDbtCdtNtfctn>
+    xml isoMessage = xml `<Document xmlns="urn:iso:std:iso:20022:tech:xsd:camt.057.001.08">
+  <NtfctnToRcv>
+    <GrpHdr>
+      <MsgId>318393</MsgId>
+      <CreDtTm>2025-01-01T10:12:11.802172400Z</CreDtTm>
+    </GrpHdr>
+    <Ntfctn>
+      <Id>318393</Id>
+      <Itm>
+        <Id>BEBEBB0023CRESZZ</Id>
+        <EndToEndId>BEBEBB0023CRESZZ</EndToEndId>
+        <Acct>
+          <Id>
+            <Othr>
+              <SchmeNm/>
+            </Othr>
+          </Id>
+        </Acct>
+        <Amt>
+          <ActiveOrHistoricCurrencyAndAmount_SimpleType Ccy="USD">
+            <ActiveOrHistoricCurrencyAndAmount_SimpleType>230000.00</ActiveOrHistoricCurrencyAndAmount_SimpleType>
+          </ActiveOrHistoricCurrencyAndAmount_SimpleType>
+        </Amt>
+        <XpctdValDt>2010-02-22</XpctdValDt>
+        <Dbtr>
+          <Pty>
+            <PstlAdr/>
+            <Id>
+              <OrgId/>
+              <PrvtId>
+                <Othr>
+                  <SchmeNm/>
+                </Othr>
+              </PrvtId>
+            </Id>
+          </Pty>
+        </Dbtr>
+        <DbtrAgt>
+          <FinInstnId>
+            <BICFI>CRESCHZZ</BICFI>
+            <ClrSysMmbId>
+              <ClrSysId/>
+              <MmbId/>
+            </ClrSysMmbId>
+            <PstlAdr/>
+          </FinInstnId>
+        </DbtrAgt>
+        <IntrmyAgt>
+          <FinInstnId>
+            <BICFI>CITIUS33</BICFI>
+            <ClrSysMmbId>
+              <ClrSysId/>
+              <MmbId/>
+            </ClrSysMmbId>
+            <PstlAdr/>
+          </FinInstnId>
+        </IntrmyAgt>
+      </Itm>
+    </Ntfctn>
+  </NtfctnToRcv>
 </Document>`;
-    io:println(mxToMt:toSwiftMtMessage(finMessage));
+    io:println(mxToMt:toSwiftMtMessage(isoMessage, "210"));
 }
 ```
 

diff --git a/iso20022_to_switmt/.gitignore → iso20022_to_swiftmt/.gitignore b/iso20022_to_switmt/.gitignore → iso20022_to_swiftmt/.gitignore
diff --git a/iso20022_to_switmt/Ballerina.toml → iso20022_to_swiftmt/Ballerina.toml b/iso20022_to_switmt/Ballerina.toml → iso20022_to_swiftmt/Ballerina.toml
diff --git a/iso20022_to_switmt/Dependencies.toml → iso20022_to_swiftmt/Dependencies.toml b/iso20022_to_switmt/Dependencies.toml → iso20022_to_swiftmt/Dependencies.toml
@@ -10,7 +10,7 @@ distribution-version = "2201.10.1"
 [[package]]
 org = "ballerina"
 name = "data.xmldata"
-version = "1.0.0"
+version = "1.1.0"
 dependencies = [
 	{org = "ballerina", name = "jballerina.java"}
 ]

diff --git a/iso20022_to_swiftmt/Module.md b/iso20022_to_swiftmt/Module.md
@@ -0,0 +1,102 @@
+# Ballerina ISO 20022 to SWIFT MT Data Mapper Library
+
+## Overview
+
+The DataMapper Library is a comprehensive toolkit designed to convert ISO 20022 XML messages into SWIFT MT format within Ballerina applications. It simplifies the process of mapping ISO 20022 elements to their corresponding SWIFT MT fields, leveraging predefined records and parsers from the ISO 20022 and SWIFT MT libraries. This enables developers to seamlessly convert financial messages from the structured ISO 20022 XML standard into SWIFT MT record value format, ensuring accurate and efficient data conversion.
+
+## Supported Conversions
+
+- pain.001.001.12 to SWIFT MT101
+- pacs.008.001.12 to SWIFT MT102
+- pacs.008.001.12 to SWIFT MT102STP
+- pacs.008.001.12 to SWIFT MT103
+- pacs.008.001.12 to SWIFT MT103STP
+- pacs.008.001.12 to SWIFT MT103REMIT
+- pacs.003.001.11 to SWIFT MT104
+- pacs.003.001.11 to SWIFT MT107
+- pacs.009.001.11 to SWIFT MT200
+- pacs.009.001.11 to SWIFT MT201
+- pacs.009.001.11 to SWIFT MT202
+- pacs.009.001.11 to SWIFT MT202COV
+- pacs.009.001.11 to SWIFT MT203
+- pacs.010.001.06 to SWIFT MT204
+- pacs.009.001.11 to SWIFT MT205
+- pacs.009.001.11 to SWIFT MT205COV
+- camt.057.001.08 to SWIFT MT210
+- camt.056.001.11 to SWIFT MTn92
+- camt.026.001.10 to SWIFT MTn95
+- camt.029.001.13 to SWIFT MTn96
+
+## Usage
+
+### Conversion of ISO 20022 xml to SWIFT MT message
+
+```ballerina
+import ballerina/io;
+import ballerinax/financial.iso20022ToSwiftMT as mxToMt;
+
+public function main() returns error? {
+    xml isoMessage = xml `<Document xmlns="urn:iso:std:iso:20022:tech:xsd:camt.057.001.08">
+  <NtfctnToRcv>
+    <GrpHdr>
+      <MsgId>318393</MsgId>
+      <CreDtTm>2025-01-01T10:12:11.802172400Z</CreDtTm>
+    </GrpHdr>
+    <Ntfctn>
+      <Id>318393</Id>
+      <Itm>
+        <Id>BEBEBB0023CRESZZ</Id>
+        <EndToEndId>BEBEBB0023CRESZZ</EndToEndId>
+        <Acct>
+          <Id>
+            <Othr>
+              <SchmeNm/>
+            </Othr>
+          </Id>
+        </Acct>
+        <Amt>
+          <ActiveOrHistoricCurrencyAndAmount_SimpleType Ccy="USD">
+            <ActiveOrHistoricCurrencyAndAmount_SimpleType>230000.00</ActiveOrHistoricCurrencyAndAmount_SimpleType>
+          </ActiveOrHistoricCurrencyAndAmount_SimpleType>
+        </Amt>
+        <XpctdValDt>2010-02-22</XpctdValDt>
+        <Dbtr>
+          <Pty>
+            <PstlAdr/>
+            <Id>
+              <OrgId/>
+              <PrvtId>
+                <Othr>
+                  <SchmeNm/>
+                </Othr>
+              </PrvtId>
+            </Id>
+          </Pty>
+        </Dbtr>
+        <DbtrAgt>
+          <FinInstnId>
+            <BICFI>CRESCHZZ</BICFI>
+            <ClrSysMmbId>
+              <ClrSysId/>
+              <MmbId/>
+            </ClrSysMmbId>
+            <PstlAdr/>
+          </FinInstnId>
+        </DbtrAgt>
+        <IntrmyAgt>
+          <FinInstnId>
+            <BICFI>CITIUS33</BICFI>
+            <ClrSysMmbId>
+              <ClrSysId/>
+              <MmbId/>
+            </ClrSysMmbId>
+            <PstlAdr/>
+          </FinInstnId>
+        </IntrmyAgt>
+      </Itm>
+    </Ntfctn>
+  </NtfctnToRcv>
+</Document>`;
+    io:println(mxToMt:toSwiftMtMessage(isoMessage, "210"));
+}
+```
diff --git a/iso20022_to_swiftmt/Package.md b/iso20022_to_swiftmt/Package.md
@@ -0,0 +1,102 @@
+# Ballerina ISO 20022 to SWIFT MT Data Mapper Library
+
+## Overview
+
+The DataMapper Library is a comprehensive toolkit designed to convert ISO 20022 XML messages into SWIFT MT format within Ballerina applications. It simplifies the process of mapping ISO 20022 elements to their corresponding SWIFT MT fields, leveraging predefined records and parsers from the ISO 20022 and SWIFT MT libraries. This enables developers to seamlessly convert financial messages from the structured ISO 20022 XML standard into SWIFT MT record value format, ensuring accurate and efficient data conversion.
+
+## Supported Conversions
+
+- pain.001.001.12 to SWIFT MT101
+- pacs.008.001.12 to SWIFT MT102
+- pacs.008.001.12 to SWIFT MT102STP
+- pacs.008.001.12 to SWIFT MT103
+- pacs.008.001.12 to SWIFT MT103STP
+- pacs.008.001.12 to SWIFT MT103REMIT
+- pacs.003.001.11 to SWIFT MT104
+- pacs.003.001.11 to SWIFT MT107
+- pacs.009.001.11 to SWIFT MT200
+- pacs.009.001.11 to SWIFT MT201
+- pacs.009.001.11 to SWIFT MT202
+- pacs.009.001.11 to SWIFT MT202COV
+- pacs.009.001.11 to SWIFT MT203
+- pacs.010.001.06 to SWIFT MT204
+- pacs.009.001.11 to SWIFT MT205
+- pacs.009.001.11 to SWIFT MT205COV
+- camt.057.001.08 to SWIFT MT210
+- camt.056.001.11 to SWIFT MTn92
+- camt.026.001.10 to SWIFT MTn95
+- camt.029.001.13 to SWIFT MTn96
+
+## Usage
+
+### Conversion of ISO 20022 xml to SWIFT MT message
+
+```ballerina
+import ballerina/io;
+import ballerinax/financial.iso20022ToSwiftMT as mxToMt;
+
+public function main() returns error? {
+    xml isoMessage = xml `<Document xmlns="urn:iso:std:iso:20022:tech:xsd:camt.057.001.08">
+  <NtfctnToRcv>
+    <GrpHdr>
+      <MsgId>318393</MsgId>
+      <CreDtTm>2025-01-01T10:12:11.802172400Z</CreDtTm>
+    </GrpHdr>
+    <Ntfctn>
+      <Id>318393</Id>
+      <Itm>
+        <Id>BEBEBB0023CRESZZ</Id>
+        <EndToEndId>BEBEBB0023CRESZZ</EndToEndId>
+        <Acct>
+          <Id>
+            <Othr>
+              <SchmeNm/>
+            </Othr>
+          </Id>
+        </Acct>
+        <Amt>
+          <ActiveOrHistoricCurrencyAndAmount_SimpleType Ccy="USD">
+            <ActiveOrHistoricCurrencyAndAmount_SimpleType>230000.00</ActiveOrHistoricCurrencyAndAmount_SimpleType>
+          </ActiveOrHistoricCurrencyAndAmount_SimpleType>
+        </Amt>
+        <XpctdValDt>2010-02-22</XpctdValDt>
+        <Dbtr>
+          <Pty>
+            <PstlAdr/>
+            <Id>
+              <OrgId/>
+              <PrvtId>
+                <Othr>
+                  <SchmeNm/>
+                </Othr>
+              </PrvtId>
+            </Id>
+          </Pty>
+        </Dbtr>
+        <DbtrAgt>
+          <FinInstnId>
+            <BICFI>CRESCHZZ</BICFI>
+            <ClrSysMmbId>
+              <ClrSysId/>
+              <MmbId/>
+            </ClrSysMmbId>
+            <PstlAdr/>
+          </FinInstnId>
+        </DbtrAgt>
+        <IntrmyAgt>
+          <FinInstnId>
+            <BICFI>CITIUS33</BICFI>
+            <ClrSysMmbId>
+              <ClrSysId/>
+              <MmbId/>
+            </ClrSysMmbId>
+            <PstlAdr/>
+          </FinInstnId>
+        </IntrmyAgt>
+      </Itm>
+    </Ntfctn>
+  </NtfctnToRcv>
+</Document>`;
+    io:println(mxToMt:toSwiftMtMessage(isoMessage, "210"));
+}
+```
diff --git a/iso20022_to_switmt/camt_026_transform.bal → iso20022_to_swiftmt/camt_026_transform.bal b/iso20022_to_switmt/camt_026_transform.bal → iso20022_to_swiftmt/camt_026_transform.bal
diff --git a/iso20022_to_switmt/camt_028_transform.bal → iso20022_to_swiftmt/camt_028_transform.bal b/iso20022_to_switmt/camt_028_transform.bal → iso20022_to_swiftmt/camt_028_transform.bal
diff --git a/iso20022_to_switmt/camt_029_transform.bal → iso20022_to_swiftmt/camt_029_transform.bal b/iso20022_to_switmt/camt_029_transform.bal → iso20022_to_swiftmt/camt_029_transform.bal
diff --git a/iso20022_to_switmt/camt_031_transform.bal → iso20022_to_swiftmt/camt_031_transform.bal b/iso20022_to_switmt/camt_031_transform.bal → iso20022_to_swiftmt/camt_031_transform.bal
diff --git a/iso20022_to_switmt/camt_055_transform.bal → iso20022_to_swiftmt/camt_055_transform.bal b/iso20022_to_switmt/camt_055_transform.bal → iso20022_to_swiftmt/camt_055_transform.bal
diff --git a/iso20022_to_switmt/camt_056_transform.bal → iso20022_to_swiftmt/camt_056_transform.bal b/iso20022_to_switmt/camt_056_transform.bal → iso20022_to_swiftmt/camt_056_transform.bal
diff --git a/iso20022_to_switmt/camt_057_transform.bal → iso20022_to_swiftmt/camt_057_transform.bal b/iso20022_to_switmt/camt_057_transform.bal → iso20022_to_swiftmt/camt_057_transform.bal
diff --git a/iso20022_to_switmt/defines.bal → iso20022_to_swiftmt/defines.bal b/iso20022_to_switmt/defines.bal → iso20022_to_swiftmt/defines.bal
diff --git a/iso20022_to_switmt/main.bal → iso20022_to_swiftmt/main.bal b/iso20022_to_switmt/main.bal → iso20022_to_swiftmt/main.bal
@@ -16,6 +16,14 @@
 
 import ballerina/data.xmldata;
 
+# Converts an ISO 20022 XML message to its corresponding SWIFT MT message format.
+#
+# The function uses a map of transformation functions for different ISO 20022 message types
+# and applies the appropriate transformation based on the provided XML content and target SWIFT MT message type.
+#
+# + xmlContent - The ISO 20022 XML content that needs to be converted.
+# + messageType - The target SWIFT MT message type (e.g., "103", "102STP","202", "202COV").
+# + return - Returns the transformed SWIFT MT message as a record value or an error if the conversion fails.
 public isolated function toSwiftMtMessage(xml xmlContent, string messageType) returns record {}|error {
     xml:Element document = check xmlContent.get(0).ensureType();
     string? isoMessageType = (document).getAttributes()["{" + xml:XMLNS_NAMESPACE_URI + "}xmlns"];

diff --git a/iso20022_to_switmt/pacs_003_transform.bal → iso20022_to_swiftmt/pacs_003_transform.bal b/iso20022_to_switmt/pacs_003_transform.bal → iso20022_to_swiftmt/pacs_003_transform.bal
diff --git a/iso20022_to_switmt/pacs_008_transform.bal → iso20022_to_swiftmt/pacs_008_transform.bal b/iso20022_to_switmt/pacs_008_transform.bal → iso20022_to_swiftmt/pacs_008_transform.bal
diff --git a/iso20022_to_switmt/pacs_009_transform.bal → iso20022_to_swiftmt/pacs_009_transform.bal b/iso20022_to_switmt/pacs_009_transform.bal → iso20022_to_swiftmt/pacs_009_transform.bal
diff --git a/iso20022_to_switmt/pacs_010_transform.bal → iso20022_to_swiftmt/pacs_010_transform.bal b/iso20022_to_switmt/pacs_010_transform.bal → iso20022_to_swiftmt/pacs_010_transform.bal
diff --git a/iso20022_to_switmt/pain_001_transform.bal → iso20022_to_swiftmt/pain_001_transform.bal b/iso20022_to_switmt/pain_001_transform.bal → iso20022_to_swiftmt/pain_001_transform.bal
diff --git a/iso20022_to_switmt/pain_008_transform.bal → iso20022_to_swiftmt/pain_008_transform.bal b/iso20022_to_switmt/pain_008_transform.bal → iso20022_to_swiftmt/pain_008_transform.bal