Commit fe9e8bd0 authored by Sherry Mathews's avatar Sherry Mathews

V1

V1
parent 660cd076
#### The project contains all the components required to create an integration to an Enterprise System Of Records (AWS Oracle RDS)
### Use-Case / Requirement
Build a process to create an integration to MSSQL Database serving as [Enterprise System Of Records](https://en.wikipedia.org/wiki/System_of_record).
### Prerequisites to run this demo end-2-end
* Alfresco Process Services (powered by Activiti) (Version 1.9 and above) - If you don't have it already, you can download a 30 day trial from [Alfresco Process Services (APS)](https://www.alfresco.com/products/business-process-management/alfresco-activiti).Instructions & help available at [Activiti Docs](http://docs.alfresco.com/activiti/docs/), [Alfresco BPM Community](https://community.alfresco.com/community/bpm)
* The Oracle Database is created as AWS RDS.
## Configuration Steps
### Create the AWS RDS MSSQL DB
Follow the steps per [AWS Documentation](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_GettingStarted.CreatingConnecting.SQLServer.html) to create an [AWS MSSQL RDS](https://aws.amazon.com/rds/sqlserver/)
![rds](images/rds.png)
### Connect to the AWS RDS Oracle DB using SQL Developer
![sqldeveloper](images/sqldeveloper.png)
### Create datasource for AWS RDS Oracle DB in APS
1. Download the sqljdbc.jar file from [here](http://www.java2s.com/Code/Jar/s/Downloadsqljdbc420jar.htm)
2. Copy the sqljdbc.jar to tomcat/lib location of APS server. eg: /usr/share/tomcat/lib/sqljdbc.jar
3. Restart APS
4. Create data source using the values mentioned in [APS article](https://github.com/sherrymax/aps-examples/tree/master/aps-custom-database-integration#mssql-db)
5. ![MSSQL](images/mssql.png)
```
Name : aps-custom-mssql-db
JDBC URL : jdbc:sqlserver://<aws-db-end-point>:<aws-port>;database=<aws-db-name>
Driver Class : com.microsoft.sqlserver.jdbc.SQLServerDriver
User Name : db-username
Password : db-password
```
### Activiti Setup and Process Deployment
1. Import the [MSSQL-Database-Operations.zip](MSSQL-Database-Operations.zip) app available in this project into Activiti.
2. Process Flow. ![Process-Flow](images/Process-Flow.png)
3. Data Model Configuration in Process. ![Data-Model-App-Configuration](images/Data-Model-App-Configuration.png)
4. Data Model Configuration in Application. ![Data-Model-DB-Configuration](images/Data-Model-DB-Configuration.png)
5. Publish/Deploy the APS App.
### Run the DEMO
1. Verify the data entered through the APS form: ![Runtime-APS-Form](images/Runtime-APS-Form.png)
1. Verify the data in AWS RDS MSSQL Database using SQL Developer: ![Runtime-DB](images/Runtime-DB.png)
### References
1. http://docs.alfresco.com/activiti/docs/user-guide/1.5.0/
2. http://docs.alfresco.com/activiti/docs/user-guide/1.5.0/#_connecting_your_data_model_to_a_relational_database
3. https://oskar.idashboards.com/hc/en-us/articles/227563548-Amazon-RDS-MS-SQL-Data-Source
4. https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_GettingStarted.CreatingConnecting.SQLServer.html
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment