...

Each country must build their own jar file containing their own implementations, dependencies and supporting files.This National jar file

can be bundled into the There are a number of strategies for building the OpenNCP Server and bundling in the National jar, for example:

1. Build epsos-ws-server.war

...

...

1. in a local build environment using maven profile "national-connector-impl" to include the local classes as a dependency.  The disadvantage with this approach is that the local build server must download all the source files from Google Code repository plus all dependencies from Joinup.
2. Download a released epsos-ws-server.war from Joinup.  Use a local build script to unpack the archive, bundle in the local classes and then repackage.  This is the preferred approach in Sweden.
3. Download epsos-ws-server.war from Joinup.  Add local classes to tomcat/lib.  This has been briefly tested and did not work due to class loader errors.  Furthermore it is never a good idea to deploy application-specific classes into tomcat/lib.

Local build using profile

Here are the profiles that are declared in the Protocol Terminator pom file.

	<profiles>
		<profile>
			<!-- This profile bundles a mock National Connector implementation -->
			<id>national-connector-mock-impl</id>
			<dependencies>
				<dependency>
               <version>0.1-SNAPSHOT</version>      <groupId>eu.europa.ec.joinup.ecc.epsos-protocol-terminators.epsos-ncp-server</groupId>
              <scope>runtime</scope>      <artifactId>epsos-nc-mock-it</artifactId>
          </dependency> 			</dependencies> 		</profile> 		<profile> 			<!-- This profile bundles the real National Connector implementation -->
			<id>national-connector-impl</id>
			<dependencies>
				<dependency>
					<groupId>${national-connector-impl.groupId}</groupId>
					<artifactId>${national-connector-impl.artifactId}</artifactId>
					<version>${national-connector-impl.version}</version>
					<scope>runtime</scope>
				</dependency>
			</dependencies>
		</profile>
	</profiles>

...

 <version>0.1-SNAPSHOT</version>
                    <scope>runtime</scope>
                </dependency>
			</dependencies>
		</profile>
		<profile>
			<!-- This profile bundles the real National Connector implementation -->
			<id>national-connector-impl</id>
			<dependencies>
				<dependency>
					<groupId>${national-connector-impl.groupId}</groupId>
					<artifactId>${national-connector-impl.artifactId}</artifactId>
					<version>${national-connector-impl.version}</version>
					<scope>runtime</scope>
				</dependency>
			</dependencies>
		</profile>
	</profiles>

The first profile bundles a mock implementation into the war file.  The second profile bundles a National implementation.  If no profile is specified then no implementation will be bundled at all.  In this case, the jar must be deployed to the tomcat/lib directory.The National profile needs some properties.  These properties are defined

To use the National profile some properties must be set in the local build environment.  There are a few options for doing this:

Per User

- Defined in the Maven-settings (%USER_HOME%/.m2/settings.xml).

...

<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
          xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 http://maven.apache.org/xsd/settings-1.0.0.xsd">
  <profiles>
    <profile>
      <id>national-connector-impl</id>
      <properties>
        <national-connector-impl.groupId>se.apotekensservice</national-connector-impl.groupId>
        <national-connector-impl.artifactId>epsos-shelob</national-connector-impl.artifactId>
        <national-connector-impl.version>0.0.1-SNAPSHOT</national-connector-impl.version>
      </properties>
    </profile>
  </profiles>
</settings>

Here are the Maven commands:

# build epsos-ws-serverwith no implementation
mvn clean install
 
# build epsos-ws-server with mock implementations
mvn clean install -P national-connector-mock-impl
 
# build epsos-ws-server with real implementations
mvn clean install -P national-connector-impl

Example National build script

Here is the Maven pom that Sweden uses to download OpenNCP from Joinup Nexus repository and then bundle in the jar containing the National implementations.

<project xmlns="0 http://maven.apache.org/POMxsd/4settings-1.0.0.xsd" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
	xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
	<modelVersion>4.0.0</modelVersion>
	<parent>
		<artifactId>epsos</artifactId>
		<groupId>se.apotekensservice</groupId>
		<version>1.0-SNAPSHOT</version>
	</parent>
	<groupId>se.apotekensservice</groupId>
	<artifactId>epsos-ncp</artifactId>
	<version>0.0.1-SNAPSHOT</version>
	<packaging>war</packaging>
	<name>Package OpenNCP</name>
	<description>This project fetches the OpenNCP epsos-ws-server.war.  It then unpacks it, adds the shelob.jar dependency and creates a new web archive</description>
	<build>
		<plugins>
			<plugin>
				<groupId>org.apache.maven.plugins</groupId>
				<artifactId>maven-dependency-plugin</artifactId>
				<version>2.5.1</version>
				<executions>
					<execution>
						<id>unpack</id>
						<phase>package</phase>
						<goals>
							<goal>unpack</goal>
						</goals>
						<configuration>
							<artifactItems>
								<artifactItem>
									<groupId>${project.openNcpGroupId}</groupId>
									<artifactId>${project.openNcpArtifactId}</artifactId>
									<version>${project.openNcpVersion}</version>
									<type>war</type>
									<overWrite>true</overWrite>
									<outputDirectory>${project.build.directory}/epsos-ws-server</outputDirectory>
									<includes></includes>
									<excludes>epsos-ws-server-mock*.jar</excludes>
								</artifactItem>
							</artifactItems>
						</configuration>
					</execution>
				</executions>
			</plugin>
		</plugins>
	</build>
	<dependencies>
		<dependency>
			<groupId>${project.shelobGroupId}</groupId>
			<artifactId>${project.shelobArtifactId}</artifactId>
			<version>${project.shelobVersion}</version>
		</dependency>
		<dependency>
			<groupId>${project.openNcpGroupId}</groupId>
			<artifactId>${project.openNcpArtifactId}</artifactId>
			<version>${project.openNcpVersion}</version>
			<type>war</type>
		</dependency>
	</dependencies>
	<properties>
		<!-- OpenNCP war -->
		<project.openNcpGroupId>eu.>
  <profiles>
    <profile>
      <id>national-connector-impl</id>
      <properties>
        <national-connector-impl.groupId>se.apotekensservice</national-connector-impl.groupId>
        <national-connector-impl.artifactId>epsos-shelob</national-connector-impl.artifactId>
        <national-connector-impl.version>1.1</national-connector-impl.version>
      </properties>
    </profile>
  </profiles>
</settings>

Here are the Maven commands for activating the various profiles:

# build epsos-ws-serverwith no implementation
mvn clean install
 
# build epsos-ws-server with mock implementations
mvn clean install -P national-connector-mock-impl
 
# build epsos-ws-server with real implementations
mvn clean install -P national-connector-impl

Manipulation of epsos-ws-server.war

Here is the Maven pom that Sweden uses to download OpenNCP from Joinup Nexus repository and then bundle in the jar containing the National implementations.

<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
	xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
	<modelVersion>4.0.0</modelVersion>
	<parent>
		<artifactId>epsos</artifactId>
		<groupId>se.apotekensservice</groupId>
		<version>1.1</version>
	</parent>
	<artifactId>epsos-ws-server</artifactId>
	<packaging>war</packaging>
	<name>OpenNCP Server (Country A)</name>
	<description>This project downloads the OpenNCP epsos-ws-server.war and bundles in the National implementations</description>
	<build>
		<plugins>
			<plugin>
				<groupId>org.apache.maven.plugins</groupId>
				<artifactId>maven-war-plugin</artifactId>
				<version>2.3</version>
				<configuration>
					<packagingExcludes>**/epsos*-mock-*.jar</packagingExcludes>
				</configuration>
			</plugin>
		</plugins>
	</build>
	<dependencies>
		<dependency>
			<groupId>se.apotekensservice</groupId>
			<artifactId>epsos-shelob</artifactId>
			<version>1.1</version>
		</dependency>
		<dependency>
			<groupId>eu.europa.ec.joinup.ecc.epsos-protocol-terminators.epsos-ncp-server</project.openNcpGroupId>
		<project.openNcpArtifactId>epsos-ws-server</project.openNcpArtifactId>
		<project.openNcpVersion>0.2.1-SNAPSHOT</project.openNcpVersion>
		<!-- Shelob jar -->
		<project.shelobGroupId>se.apotekensservice</project.shelobGroupId>
		<project.shelobArtifactId>epsos-shelob</project.shelobArtifactId>
		<project.shelobVersion>0.0.1-SNAPSHOT</project.shelobVersion>
	</properties>
</project>-server</groupId>
			<artifactId>epsos-ws-server</artifactId>
			<version>2.0.0-SNAPSHOT</version>
			<type>war</type>
		</dependency>
	</dependencies>
</project>

XCPD PatientSearchInterface usage

TODO

XCA DocumentSearchInterface usage

...

The current implementation of the interface is as follows:

public interface DocumentSearchInterface extends NationalConnectorInterface {

...

...

   public DocumentAssociation<PSDocumentMetaData> getPSDocumentList(SearchCriteria searchCriteria);

...

   public List<DocumentAssociation<EPDocumentMetaData>> getEPDocumentList(SearchCriteria searchCriteria);

...

   public EPSOSDocument getDocument(SearchCriteria searchCriteria);

...

}

The DocumentAssociation interface

public interface DocumentAssociation<T extends EPSOSDocumentMetaData> {

...

   public T getXMLDocumentMetaData();

...

   public T getPDFDocumentMetaData();

...

   public String getDocumentClassCode(String documentId);

...

   public String getPatientId(String documentId);

...

}

The DocumentAssociation will store XML and PDF document metadata and has two helper methods for searching document's classCode and patientId.

The EPSOSDocumentMetaData

public interface EPSOSDocumentMetaData {

...

...

   public String getId();

...

...

   public String getPatientId();

...

...

   public int getFormat();

...

...

   public Date getEffectiveTime();

...

...

   public String getClassCode();

...

...

   public String getRepositoryId();

...

   public String getTitle();

...

   public String getAuthor();

...

}

This interface is a parent for EPDocumentMetaData and PSDocumentMetaData that reprecent the EPrescription and PatientSummary metaDatas.

The EPSOSDocument

public interface EPSOSDocument

...

 {

...

...

	public String getPatientId();
	public 

...

String 

...

getClassCode();

...

...

	public org.w3c.dom.Document getDocument();

...

...

	public boolean matchesCriteria(SearchCriteria sc);

...

}

The EPSOSDocument has one document metaData and the actual DOM documentthe actual DOM document plus a subset of the metadata. The interface also has a helper method for checking that if the SearchCriteria matches the DocumentMetaDatametadata.

The SearchCriteria

public interface SearchCriteria {

...

...

 public enum Criteria {

...

    PatientId,

...

    RepositoryId,

...

    DocumentId

...

 }

...

...

   public SearchCriteria add(Criteria c, String value);

...

   public String getCriteriaValue(Criteria c);

...

...

   public Iterator<Criteria> getSearchCriteriaKeys();

...

}

The SearchCriteria interface reprecents the criteria what will be used for searching the metaData and DOM documents from the national side. Currently the possible criteria values are in the Criteria enum.

Implementation

From the national component side

From the national component the usage of this interface, when returning DocumentAssociations should be something like:

EPDocumentMetaData epdXml = DocumentFactory.createEPDocumentXML(documentId, patientId, effectiveDate, repositoryId, title, author);

...

EPDocumentMetaData epdPdf = DocumentFactory.createEPDocumentPDF(documentId, patientId, effectiveDate, repositoryId, title, author);

...

DocumentFactory.createDocumentAssociation(epdXml, epdPdf);

...

PSDocumentMetaData psdPdf = DocumentFactory.createPSDocumentPDF(documentId, patientId, effectiveDate, repositoryId, title, author);

...

PSDocumentMetaData psdXml = DocumentFactory.createPSDocumentXML(documentId, patientId, effectiveDate, repositoryId, title, author);

...

DocumentFactory.createDocumentAssociation(psdPdf, psdXml);

And when returning the (DOM) document itself, should be implemented for example like:

EPSOSDocument epsosDocument = DocumentFactory.createEPSOSDocument(

...

		patientId,
		Constants.EP_CLASSCODE,
		xmlDocument);

From the XCAService component side

From the XCAService component side the usage of this interface is as following, when fetching PatientSummary document metadatas:

//when fetching PatientSummary document metadatas:
DocumentAssociation<PSDocumentMetaData> daPs = documentSearchService.getPSDocumentList(DocumentFactory.createSearchCriteria().add(Criteria.PatientId, "patientId"));

...

And when fetching EPrescriptions metadatas:

//when fetching EPrescriptions metadatas:
List<DocumentAssociation<EPDocumentMetaData>> prescriptions = documentSearchService.getEPDocumentList(DocumentFactory.createSearchCriteria().add(Criteria.PatientId, "patientId"));

...

And when fetching the actual DOM document with metada:

//when fetching the actual DOM document with metada:
EPSOSDocument epsosDoc = documentSearchService.getDocument(DocumentFactory.createSearchCriteria().add(Criteria.DocumentId, "documentId").add(Criteria.PatientId, "patientId").add(Criteria.RepositoryId,  

...

"repositoryId"));

XDR DocumentSubmitInterface usage

TODO

References

Java SE6 ServiceLoader

...