Skip to content

Camel component for czech system ISDS (Informační Systém Datových Schránek).

License

Notifications You must be signed in to change notification settings

czgov/camel-isds

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

67 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Camel ISDS Component

Build Status Maven Central Javadocs

Project is no longer being actively maintained.

ISDS is shortcut for system run by Czech government called Informační systém datových schránek.

This camel components allows easy sending and receiving of messages to ISDS.
Underneath this component leverages library Java ISDS.

Component is currently under development and any contribution is welcome and appreciated.

Examples

Camel route in Java DSL for downloading of *.zfo messages to directory dir-with-zfo-files:

from("isds:messages?environment=test&username=YOUR_LOGIN&password=YOUR_PASSWORD?zfo=true")
	.log("New message ${body}")
	.to("file:dir-with-zfo-files");

See component documentation here.

OSGi ready

Component is ready for OSGi deployment.
Example of deployment into JBoss Fuse 6.3:

# download features.xml from maven central
JBossFuse:karaf@root> features:addurl mvn:com.github.czgov/camel-isds/0.1.0/xml/features

# download jars and install into Fuse
JBossFuse:karaf@root> features:install camel-isds

# verify features are installed
JBossFuse:karaf@root> features:list | grep isds
[installed  ] [1.1.0                ] isds                                          javaisds-1.1.0                         
[installed  ] [0.1.0-SNAPSHOT       ] camel-isds                                    camel-isds-0.1.0   

How to contribute

Pull requests are welcome and appreciated as well as github issue reports.

Building

Use maven to build project from sources:

# skip tests if you don't have login credentials for test accounts in ISDS system
mvn install -DskipTests

# optionally run tests during the build
mvn install

To run tests it's required to have 3 test (staging) accounts.
Login credentials should be defined in file isds-config.properties in project root (next to pom.xml).

Example content of isds-config.properties:

# type of account - FO (fyzicka osoba)
isds.fo.id=ID_OF_DATABOX
isds.fo.login=USERNAME_OF_DATABOX
isds.fo.password=PASSWORD_OF_DATABOX

# type of account - FO (fyzicka osoba)
isds.fo2.id=ID_OF_DATABOX
isds.fo2.login=USERNAME_OF_DATABOX
isds.fo2.password=PASSWORD_OF_DATABOX

# type of account - OVM (organ verejne moci)
isds.ovm.id=ID_OF_DATABOX
isds.ovm.login=USERNAME_OF_DATABOX
isds.ovm.password=PASSWORD_OF_DATABOX

Getting access to ISDS

There is production and "staging" environment. Staging environment is commonly used for integration tests with ISDS.

To get access to production system one needs to personally file a request. More information on page https://www.datoveschranky.info/zakladni-informace/zrizeni-datove-schranky-na-zadost.

To get access to test (staging) system one needs to download *.zfo form from page https://www.datoveschranky.info/o-datovych-schrankach/vyzkousejte-si-datovou-schranku and send it either directly from Form Filler (if one already has his ISDS account) or send via e-mail to "Ministerstvo vnitra" (posta@mvcr.cz).