Merge pull request #17 from kesavany/master

Fix to support EI-6.5.0.

README.md

@@ -1,15 +1,38 @@
-# 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/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).
 
-**[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.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    |
 
-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
+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/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
+
+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.

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 <EI_HOME> directory.

pom.xml

@@ -23,22 +23,22 @@
     <groupId>org.wso2.carbon.connector</groupId>
     <artifactId>org.wso2.carbon.connector.iso8583</artifactId>
     <packaging>jar</packaging>
-    <version>1.0.3-SNAPSHOT</version>
+    <version>1.0.3</version>
     <name>WSO2 Carbon - Mediation Library Connector For ISO8583</name>
     <url>http://wso2.org</url>
     <properties>
         <connector.name>iso8583</connector.name>
         <org.jpos.version>1.9.6</org.jpos.version>
         <commons-cli.version>1.3.1</commons-cli.version>
         <org.jdom.version>1.1.3</org.jdom.version>
-        <carbon.mediation.version>4.6.19</carbon.mediation.version>
+        <carbon.mediation.version>4.6.123</carbon.mediation.version>
         <org.testng.version>6.1.1</org.testng.version>
         <automation.framework.version>4.4.3</automation.framework.version>
         <emma.version>2.1.5320</emma.version>
         <carbon.kernel.version>4.4.17</carbon.kernel.version>
         <automation.framework.utils.version>4.4.2</automation.framework.utils.version>
-        <product.ei.version>6.4.0</product.ei.version>
-        <synapse.version>2.1.7-wso2v19</synapse.version>
+        <product.ei.version>6.5.0</product.ei.version>
+        <synapse.version>2.1.7-wso2v95</synapse.version>
         <skip-tests>true</skip-tests>
     </properties>
     <dependencies>
@@ -162,9 +162,9 @@
             <version>${product.ei.version}</version>
         </dependency>
         <dependency>
-            <groupId>org.wso2.ei</groupId>
+            <groupId>org.wso2.carbon.mediation</groupId>
             <artifactId>org.wso2.carbon.integrator.core</artifactId>
-            <version>${product.ei.version}</version>
+            <version>${carbon.mediation.version}</version>
         </dependency>
         <dependency>
             <groupId>org.wso2.ei</groupId>
@@ -342,4 +342,4 @@
             <url>scp://dist.wso2.org/home/httpd/dist.wso2.org/maven2/</url>
         </repository>
     </distributionManagement>
-</project>
+</project>

src/test/INTEGRATION-TEST.txt → src/test/INTEGRATION-TEST.md

@@ -8,39 +8,39 @@ 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
+ 2. Download the jpos-1.9.4.jar from the http://mvnrepository.com/artifact/org.jpos/jpos/1.9.4 ,<br/>
+    download jdom-1.1.3.jar from http://mvnrepository.com/artifact/org.jdom/jdom/1.1.3 and <br/>
+    download commons-cli-1.3.1.jar from http://mvnrepository.com/artifact/commons-cli/commons-cli/1.3 and <br/> then copy the
     jars to the <ESB_HOME>/repository/components/lib or <EI_HOME>/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.
 
     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".
 
     3.  Run the main class (mockServer.java)
 
  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.