From a9100aefc2a236d73a6bc07ac8fde37049500215 Mon Sep 17 00:00:00 2001 From: kesavan Date: Thu, 11 Apr 2019 11:35:24 +0530 Subject: [PATCH 1/2] Fix to support EI-6.5.0. --- README.md | 38 +++++++++++++++---- docs/README.md | 14 ------- pom.xml | 10 ++--- ...TEGRATION-TEST.txt => INTEGRATION-TEST.md} | 20 +++++----- 4 files changed, 45 insertions(+), 37 deletions(-) delete mode 100644 docs/README.md rename src/test/{INTEGRATION-TEST.txt => INTEGRATION-TEST.md} (77%) diff --git a/README.md b/README.md index 8df2505..5d02200 100644 --- a/README.md +++ b/README.md @@ -1,15 +1,37 @@ -# ISO8583 EI Connector +# ISO8583 WSO2 EI Connector -ISO8583 connector allows you to send the ISO8583 standard messages through WSO2 EI. ISO8583 is a message standard which is using in financial transactions. +The ISO8583 [Connector](https://docs.wso2.com/display/EI640/Working+with+Connectors) allows you to send ISO8583 standard messages through the ESB Profile of WSO2 Enterprise Integrator (WSO2 EI). ISO8583 is an international messaging standard for financial transaction card originated messages, and is commonly used in transactions between devices such as point-of-sale(POS) terminals and automated teller machines(ATMs). +Although there are various versions of the ISO8583 standard, this connector is developed based on the 1987 version. For more information on the ISO8583 standard, see [ISO8583 Documentation](https://en.wikipedia.org/wiki/ISO_8583). -**[ISO8583 EI Connector documentation v1.0.2](docs/README.md)** +## Compatibility -# Build +| Connector version | Supported jpos library version | Supported WSO2 ESB/EI version | +| ------------- | ---------------|------------- | +| [1.0.2](https://github.com/wso2-extensions/esb-connector-iso8583/tree/org.wso2.carbon.connector.iso8583-1.0.2) | 1.9.4 | EI 6.1.1, EI 6.3.0, EI 6.4.0 | -mvn clean install -# How You Can Contribute +## Getting started -You can create a third party connector and publish in WSO2 Connector Store. +#### Download and install the connector -https://docs.wso2.com/display/ESBCONNECTORS/Creating+and+Publishing+a+Third+Party+Connector \ No newline at end of file +1. Download the connector from the [WSO2 Store](https://store.wso2.com/store/assets/esbconnector/details/e4cf3fd5-445f-4317-beb6-09998906fb0d) by clicking the **Download Connector** button. +2. You can then follow this [documentation](https://docs.wso2.com/display/EI640/Working+with+Connectors+via+the+Management+Console) to add the connector to your WSO2 EI instance and to enable it (via the management console). +3. For more information on using connectors and their operations in your WSO2 EI configurations, see [Using a Connector](https://docs.wso2.com/display/EI640/Using+a+Connector). +4. If you want to work with connectors via WSO2 EI Tooling, see [Working with Connectors via Tooling](https://docs.wso2.com/display/EI640/Working+with+Connectors+via+Tooling). + +#### Configuring the connector operations + +To get started with the **ISO8583** connector and their operations, see [Configuring ISO8583 Operations](docs/config.md). + +## Building from the source + +Follow the steps given below to build the ISO8583 connector from the source code. + +1. Get a clone or download the source from [Github](https://github.com/wso2-extensions/esb-connector-iso8583). +2. Run the following Maven command from the `esb-connector-iso8583` directory: `mvn clean install`. +3. The ZIP file with the ISO8583 connector is created in the `esb-connector-iso8583/target` directory. + +## How you can contribute + +As an open source project, WSO2 extensions welcome contributions from the community. +Check the [issue tracker](https://github.com/wso2-extensions/esb-connector-iso8583/issues) for open issues that interest you. We look forward to receiving your contributions. diff --git a/docs/README.md b/docs/README.md deleted file mode 100644 index f4efd9d..0000000 --- a/docs/README.md +++ /dev/null @@ -1,14 +0,0 @@ -# ISO8583 Connector - -The ISO8583 [Connector](https://docs.wso2.com/display/EI611/Working+with+Connectors) allows you to send ISO8583 standard messages through the ESB Profile of WSO2 Enterprise Integrator (WSO2 EI). ISO8583 is an international messaging standard for financial transaction card originated messages, and is commonly used in transactions between devices such as point-of-sale(POS) terminals and automated teller machines(ATMs). -Although there are various versions of the ISO8583 standard, this connector is developed based on the 1987 version. For more information on the ISO8583 standard, see [ISO8583 Documentation](https://en.wikipedia.org/wiki/ISO_8583). - -## Getting started -To get started, go to [Configuring the ISO8583 Connector](config.md). Once you have completed your configurations, you can work with ISO8583 standard messages through the ESB Profile of WSO2 EI. - -## Additional information -For general information on using connectors and their operations in your configurations, see [working with Connectors](https://docs.wso2.com/display/EI611/Working+with+Connectors). To download the connector, go to [https://store.wso2.com/store/assets/esbconnector/details/iso8583](https://store.wso2.com/store/assets/esbconnector/details/e4cf3fd5-445f-4317-beb6-09998906fb0d), click ISO8583, and then click **Download Connector**. Next, you can [add and enable the connector](https://docs.wso2.com/display/EI611/Working+with+Connectors+via+the+Management+Console) in the ESB Profile of WSO2 EI. - -| | Version | -| ------------- |-------------| -| Connector | 1.0.2 | diff --git a/pom.xml b/pom.xml index 0482e7e..4ed7bc8 100644 --- a/pom.xml +++ b/pom.xml @@ -31,14 +31,14 @@ 1.9.6 1.3.1 1.1.3 - 4.6.19 + 4.6.123 6.1.1 4.4.3 2.1.5320 4.4.17 4.4.2 - 6.4.0 - 2.1.7-wso2v19 + 6.5.0-m4 + 2.1.7-wso2v95 true @@ -162,9 +162,9 @@ ${product.ei.version} - org.wso2.ei + org.wso2.carbon.mediation org.wso2.carbon.integrator.core - ${product.ei.version} + ${carbon.mediation.version} org.wso2.ei diff --git a/src/test/INTEGRATION-TEST.txt b/src/test/INTEGRATION-TEST.md similarity index 77% rename from src/test/INTEGRATION-TEST.txt rename to src/test/INTEGRATION-TEST.md index 3b9dd89..f7f4d8b 100644 --- a/src/test/INTEGRATION-TEST.txt +++ b/src/test/INTEGRATION-TEST.md @@ -15,9 +15,9 @@ Steps to follow in setting integration test. 1. Download EI 6.4.0 from the official website - 2. Download the jpos-1.9.4.jar from the http://mvnrepository.com/artifact/org.jpos/jpos/1.9.4 , - download jdom-1.1.3.jar from http://mvnrepository.com/artifact/org.jdom/jdom/1.1.3 and - download commons-cli-1.3.1.jar from http://mvnrepository.com/artifact/commons-cli/commons-cli/1.3 and then copy the + 2. Download the jpos-1.9.4.jar from the http://mvnrepository.com/artifact/org.jpos/jpos/1.9.4 ,
+ download jdom-1.1.3.jar from http://mvnrepository.com/artifact/org.jdom/jdom/1.1.3 and
+ download commons-cli-1.3.1.jar from http://mvnrepository.com/artifact/commons-cli/commons-cli/1.3 and
then copy the jars to the /repository/components/lib or /lib directory. 3. Compress modified EI as wso2ei-6.4.0.zip and copy that zip file in to location "{ISO8583_CONNECTOR_HOME}/repository/". @@ -27,11 +27,11 @@ Steps to follow in setting integration test. Clone the JavaTestServer from above link and to run the test server follow the below instructions: 1. Add following jars as an external jars in java build path. - jpos-1.9.0.jar - log4j-1.2.17.jar - commons-cli-1.3.1.jar - jdom-1.1.3.jar - org.osgi.core-4.3.0.jar + - jpos-1.9.0.jar + - log4j-1.2.17.jar + - commons-cli-1.3.1.jar + - jdom-1.1.3.jar + - org.osgi.core-4.3.0.jar 2. Update the relative path in log4j.properties for the property "log4j.appender.R.File". @@ -39,8 +39,8 @@ Steps to follow in setting integration test. 5. Update the iso8583 (esb-connector-iso8583.properties) properties file at location "{ISO8583_HOME}/repository/" as below. - i) serverHost - Here the host is localhost - ii) serverPort - Here the port is 5010 , The above JavaTestserver will start to listen on that port. + i) serverHost - Here the host is localhost + ii) serverPort - Here the port is 5010 , The above JavaTestserver will start to listen on that port. Note : If you wanted to change the above host and port , then you should change the relevant properties in JavaTestServer as well. From 8839e2ab75ca6ab99ea0b9ad983a2f38b1378406 Mon Sep 17 00:00:00 2001 From: kesavan Date: Fri, 12 Apr 2019 11:38:19 +0530 Subject: [PATCH 2/2] Fixed https://github.com/wso2-extensions/esb-connector-iso8583/issues/16. --- README.md | 9 +++++---- docs/config.md | 1 + pom.xml | 6 +++--- src/test/INTEGRATION-TEST.md | 6 +++--- 4 files changed, 12 insertions(+), 10 deletions(-) diff --git a/README.md b/README.md index 5d02200..162d252 100644 --- a/README.md +++ b/README.md @@ -1,12 +1,13 @@ # ISO8583 WSO2 EI Connector -The ISO8583 [Connector](https://docs.wso2.com/display/EI640/Working+with+Connectors) allows you to send ISO8583 standard messages through the ESB Profile of WSO2 Enterprise Integrator (WSO2 EI). ISO8583 is an international messaging standard for financial transaction card originated messages, and is commonly used in transactions between devices such as point-of-sale(POS) terminals and automated teller machines(ATMs). +The ISO8583 [Connector](https://docs.wso2.com/display/EI650/Working+with+Connectors) allows you to send ISO8583 standard messages through the ESB Profile of WSO2 Enterprise Integrator (WSO2 EI). ISO8583 is an international messaging standard for financial transaction card originated messages, and is commonly used in transactions between devices such as point-of-sale(POS) terminals and automated teller machines(ATMs). Although there are various versions of the ISO8583 standard, this connector is developed based on the 1987 version. For more information on the ISO8583 standard, see [ISO8583 Documentation](https://en.wikipedia.org/wiki/ISO_8583). ## Compatibility | Connector version | Supported jpos library version | Supported WSO2 ESB/EI version | | ------------- | ---------------|------------- | +| [1.0.3](https://github.com/wso2-extensions/esb-connector-iso8583/tree/org.wso2.carbon.connector.iso8583-1.0.3) | 1.9.4 | EI 6.5.0 | | [1.0.2](https://github.com/wso2-extensions/esb-connector-iso8583/tree/org.wso2.carbon.connector.iso8583-1.0.2) | 1.9.4 | EI 6.1.1, EI 6.3.0, EI 6.4.0 | @@ -15,9 +16,9 @@ Although there are various versions of the ISO8583 standard, this connector is d #### Download and install the connector 1. Download the connector from the [WSO2 Store](https://store.wso2.com/store/assets/esbconnector/details/e4cf3fd5-445f-4317-beb6-09998906fb0d) by clicking the **Download Connector** button. -2. You can then follow this [documentation](https://docs.wso2.com/display/EI640/Working+with+Connectors+via+the+Management+Console) to add the connector to your WSO2 EI instance and to enable it (via the management console). -3. For more information on using connectors and their operations in your WSO2 EI configurations, see [Using a Connector](https://docs.wso2.com/display/EI640/Using+a+Connector). -4. If you want to work with connectors via WSO2 EI Tooling, see [Working with Connectors via Tooling](https://docs.wso2.com/display/EI640/Working+with+Connectors+via+Tooling). +2. You can then follow this [documentation](https://docs.wso2.com/display/EI650/Working+with+Connectors+via+the+Management+Console) to add the connector to your WSO2 EI instance and to enable it (via the management console). +3. For more information on using connectors and their operations in your WSO2 EI configurations, see [Using a Connector](https://docs.wso2.com/display/EI650/Using+a+Connector). +4. If you want to work with connectors via WSO2 EI Tooling, see [Working with Connectors via Tooling](https://docs.wso2.com/display/EI650/Working+with+Connectors+via+Tooling). #### Configuring the connector operations diff --git a/docs/config.md b/docs/config.md index 3745f13..54e0e4b 100644 --- a/docs/config.md +++ b/docs/config.md @@ -83,3 +83,4 @@ Following is a sample proxy service that illustrates how to connect to a test se ``` >> NOTE : The ISO8583 connector uses the jpos library, which is a third party library that provides a high-performance bridge between card messages generated at point of sale terminals, ATMs, and internal systems across the entire financial messaging network. The jposdef.xml file has the field definitions of standard ISO8583 messages. According to the field definitions, each ISO8583 message in XML format coming from the REST client is packed and sent to the test server. +Therefore, you need to create a file called jposdef.xml (with the contents given [here](https://github.com/wso2-extensions/esb-connector-iso8583/blob/master/src/main/resources/jposdef.xml)) in the directory. \ No newline at end of file diff --git a/pom.xml b/pom.xml index 4ed7bc8..a3e040e 100644 --- a/pom.xml +++ b/pom.xml @@ -23,7 +23,7 @@ org.wso2.carbon.connector org.wso2.carbon.connector.iso8583 jar - 1.0.3-SNAPSHOT + 1.0.3 WSO2 Carbon - Mediation Library Connector For ISO8583 http://wso2.org @@ -37,7 +37,7 @@ 2.1.5320 4.4.17 4.4.2 - 6.5.0-m4 + 6.5.0 2.1.7-wso2v95 true @@ -342,4 +342,4 @@ scp://dist.wso2.org/home/httpd/dist.wso2.org/maven2/ - \ No newline at end of file + diff --git a/src/test/INTEGRATION-TEST.md b/src/test/INTEGRATION-TEST.md index f7f4d8b..92455b2 100644 --- a/src/test/INTEGRATION-TEST.md +++ b/src/test/INTEGRATION-TEST.md @@ -8,19 +8,19 @@ Pre-requisites: Tested Platform: - Ubuntu 14.04 - - WSO2 EI 6.4.0 + - WSO2 EI 6.5.0 - Java 1.8 Steps to follow in setting integration test. - 1. Download EI 6.4.0 from the official website + 1. Download EI 6.5.0 from the official website 2. Download the jpos-1.9.4.jar from the http://mvnrepository.com/artifact/org.jpos/jpos/1.9.4 ,
download jdom-1.1.3.jar from http://mvnrepository.com/artifact/org.jdom/jdom/1.1.3 and
download commons-cli-1.3.1.jar from http://mvnrepository.com/artifact/commons-cli/commons-cli/1.3 and
then copy the jars to the /repository/components/lib or /lib directory. - 3. Compress modified EI as wso2ei-6.4.0.zip and copy that zip file in to location "{ISO8583_CONNECTOR_HOME}/repository/". + 3. Compress modified EI as wso2ei-6.5.0.zip and copy that zip file in to location "{ISO8583_CONNECTOR_HOME}/repository/". 4. Obtain the Sample test server from https://github.com/wso2-docs/CONNECTORS/tree/master/ISO8583/ISO8583TestServer.