V21 20120131

From DOC

Jump to: navigation, search


This page provides information about the V21_20120131 repository snapshot of the Tolven plug-in catalog.

Contents

Upgrade Instructions

If you are upgrading from the V21_20120118 snapshot to this V21_20120131 snapshot, this is a Level 2 upgrade because the authorization table has changed. Actually, it's not the appserver which changed in this case, so those who use the authorization command should be able to repopulate their table if they just delete the rows, as opposed to dropping the table.

See Tolven V2.1 Upgrade Guide for general instructions and see other snapshot-specific installation and upgrade notes below.

Installation/Release Notes

  • Note that the installer and OpenDS config plug-ins were updated with this publication. Be sure to download the new versions as reflected below and in the installation guides.
  • Some customers who use the manifest <filter> extension must remove the web-resource-name and transaction parameter, which is DEPRECATED.
  • Etension-points related to the web.xml tags below, can now be added via web-fragment.xmls instead of manifest extension-points. See "Supplying Extension Points via a web-fragment" below for details on adding the extension points.
    • <listener>
    • <env-entry>
    • <ejb-local-ref>
    • <session-config>
    • <welcome-file-list>
    • <login-config>
  • The url permissions found in org.tolven.gatekeeper.authorization must be reloaded.
  • The tolvenSSO role in OpenDS is now deprecated and can be removed. For previous installations, tolvenUser should be added instead, while new installation will get it automatically. Adding tolvenUser can be done at any time, because currently the role is yet active in the application.

Supplying Extension Points via a web-fragment

The following <extension-point> tags have been removed:

  • servlet
  • servlet-mapping-contribution
  • servlet-adaptor
  • servlet-mapping-contribution-adaptor

An example of contributing a servlet to, for example, tolvenweb, is shown below:

1. Create a file called web-fragment.xml.

2. Add the normal JEE web.xml entries to that file. Here is an example from analysis: 

<web-fragment xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
xmlns="http://java.sun.com/xml/ns/javaee" 
xsi:schemaLocation="http://java.sun.com/xml/ns/javaee 
http://java.sun.com/xml/ns/javaee/web-fragment_3_0.xsd" version="3.0">
<name>org_tolven_analysis</name>
<servlet>
<servlet-name>PortletChartServlet</servlet-name>
<servlet-class>org.tolven.web.servlet.PortletChartServlet</servlet-class>
<load-on-startup>5</load-on-startup>
</servlet>
<servlet-mapping>
<servlet-name>PortletChartServlet</servlet-name>
<url-pattern>/five/analysis/portletchart/*</url-pattern>
</servlet-mapping>
</web-fragment>

3. Place the web-fragment.xml file in the META-INF of a jar file e.g: org.tolven.analysis.web.jar.

4. Next, contribute that the jar file to the target war using the following manifest entries:

5. An extension-point which indicates to the TPF that the jar is available, without directly referring to its name: 

<extension-point id="analysis-web" extension-multiplicity="none">
<parameter-def id="jar" default-value="org.tolven.analysis.web.jar" multiplicity="none-or-one" />
</extension-point>

6. An extension which then allows the TPF to find the jar (here targeted for org.tolven.component.tolvenweb): 

<extension id="analysis-web-WEB-INF-LIB-adaptor" plugin-id="org.tolven.component.tolvenweb" point-id="WEB-INF-LIB-adaptor">
<parameter id="source-plugin-id" value="org.tolven.analysis" />
<parameter id="extension-point" value="analysis-web" />
</extension>

7. In the near future, all web.xml contributions should be made via the web-fragment.xml, except filters at this time, because filter ordering can be important. However, if a filter just needs to turn up last, it may be possible to use this mechanism as well. So, the other extension-points for a web.xml file (<context-param>, <listener> etc) will eventually be removed also.

Tolven V21_20120131 Plug-in Changes

Changed Plug-ins

The following plug-ins changed:

  • org.tolven.source.ant.plugin 2.1.7
    • Added the section name prefix to the zipfileset, which ensures that the section directory appears in the plug-in zip file.
    • Removed org.tolven.assembler.facesconfig and org.tolven.assembler.webxml from pluginsToBuild, because they have been deprecated.
  • org.tolven.ccd 2.1.11
    • CCD from another account is no longer listed twice in the patient's documents list. The For column on the Activity tab for 'CCD from another account' now displays the patient's name. This was happening because the path echr:patient:patDoc had two references in ccd-summary.trim.xml which was causing the rule 'Add document to patient document list also' to be fired twice when the document was shared. This caused the document to be listed twice under the patient's documents. Removal of the relationship reference solved the problem while not affected the share or creation of a CCD Summary document.
    • The response containing the CCD document was modified to include the content-type and character set. This was done to avoid backend trouble when proxying through the Apache server.
  • org.tolven.assembler.war 2.1.4
    • Removed the check for whether a class provided for inclusion in WEB-INF/classes exists or not, because although a class (for example, a Servlet) may be referred to in a manifest, it might be contributed in a jar in the WEB-INF/lib, and this would lead to an exception.
    • Moved functionality from org.tolven.assembler.facesconfig and org.tolven.assembler.webxml to org.tolven.assembler.war.
    • Removed web-resource-name parameter-def from webDirectory, filter and filter-adaptor extension-points
    • Extension-points transaction-filter, security-filter, security-role and security-constraint are deprecated, and no longer required.
    • The following extension-points can now be supplied via a web-fragment:
      • listener-adaptor
      • env-entry-adaptor
      • ejb-local-ref
      • session-config
      • welcome-file-list
      • login-config
      • env-entry
    • Added a web.xml directly to war module plug-ins, which then forms the basis for default entries to which web-fragments contribute.
  • org.tolven.performance 2.1.3
    • All classes in web are now descendants of the package org.tolven.performance.web.
    • Web classes are now provided not as loose classes in tolvenWEB's WEB-INF/classes directory, but instead as org.tolven.performance.web.jar in the WEB-INF/lib directory.
    • Removed transaction parameter from filter extension.
  • org.tolven.gatekeeper 2.1.3
    • Moved the "Manage Security Questions" and "Reset Login Password" to the home page, and along with "Create User", they are only visible to the admin user.
    • Logout link now appears toward the top of the page, and has also been added the the Manage Login Password page.
    • The LOGGED_IN log entry has now been moved to org.tolven.shiro code.
    • Changed the directory resetLoginPassword to lowercase.
    • Added a web.xml directly to war module plug-ins, which then forms the basis for default entries to which web-fragments contribute.
    • Removed web-resource-name parameter from filter-adaptor extension.
    • Added a web.xml directly to war module plug-ins, which then forms the basis for default entries to which web-fragments contribute.
  • org.tolven.ws 2.1.6
    • Added a web.xml directly to war module plug-ins, which then forms the basis for default entries to which web-fragments contribute.
  • org.tolven.gatekeeper.authorization 2.1.8
    • All /api (primarily used by admin) and admin specific gatekeeper functionality now requires the role tolvenAdmin.
    • Corrected case-sensitivity for resetloginpassword url to have all lowercase.
  • org.tolven.library.tolvencommon 2.1.8
    • Added the following role methods to TolvenSubject:
      • hasAllRoles(Collection<String> roleIdentifiers);
      • hasRole(String roleIdentifier);
      • hasRoles(List<String> roleIdentifiers);
  • org.tolven.shiro 2.1.2
    • Added the following role methods to ShiroSessionWrapper:
      • hasAllRoles(Collection<String> roleIdentifiers);
      • hasRole(String roleIdentifier);
      • hasRoles(List<String> roleIdentifiers);
    • Also fixed a role handling bug in TolvenJndiLdapRealm.
    • SUCCESSFUL_LOGIN, FAILED_LOGIN, and LOGGED_OUT are now audited indicating user, realm, and host.
    • Removed GatekeeperServletContextListener from org.tolven.shiro, in favor of each plug-in's using its own ServletContextListener to more clearly indicate in their logs more detailed information about when those plug-ins come online, and what services they offer.
  • org.tolven.onc.applications 2.1.25
    • The "For" column is now populated on the Activity list for a received CCD document in the eCHR.
    • For ONC ยง170.302 (i) Generate Patient Lists functionality, fixed the rule associated with Influenza to point to the appropriate list.
    • When receiving a share, the Create New Patient link now properly links to the Create New Patient wizard.
    • Removed the New Study Patient wizard from the application because it is no longer applicable.
  • org.tolven.installer 2.1.8
    • Changed the connection string:
      • FROM: db.url=jdbc:postgresql://${db.host}:${db.port}?ssl=true/${db.name}
      • TO: db.url=jdbc:postgresql://${db.host}:${db.port}/${db.name}?ssl=true
    • Changed the default tolven.domain to dev.able.com.
    • Adjusted the order of targets to allow the include.* properties to work correctly. That is, include.appserver=false will no longer result in a failure just because the user did not set include.appserver.upload=false at the same time.
  • org.tolven.wsclient.example 2.1.4
    • Added class NullHostnameVerifier to assist with development environments where self-signed certificates are used. When executing a client, the following option can be added: 
Dorg.tolven.defaultHostnameVerifierClass=org.tolven.client.examples.ws.common.NullHostnameVerifier
  • org.tolven.analysis 2.1.4
    • Removed the <servlet> and <servlet-mapping-contribution> extensions from the manifests, and instead we now supply the servlet information via a web-fragment.xml file.
    • Added a ServletContextListener which logs when the module is successfully deployed with the war file.
  • org.tolven.api 2.1.6
    • Removed the <servlet> and <servlet-mapping-contribution> extensions from the manifests, and instead we now supply the servlet information via a web-fragment.xml file.
    • Added a ServletContextListener which logs when the module is successfully deployed with the war file.
  • org.tolven.component.tolvenear.config 2.1.5
    • Removed GatekeeperServletContextListener from org.tolven.shiro, in favor of each plug-in's using its own ServletContextListener to more clearly indicate in their logs more detailed information about when those plug-ins come online, and what services they offer.
  • org.tolven.component.tolvenweb 2.1.26
    • First and Last name as well as *'d required fields of the Address are now required when creating a new patient.
    • Removed web-resource-name parameter-def from webDirectory and filter extension-points
    • Moved welcome-file-list and session-config from the manifest to the web/WEB-INF/web.xml file
    • Removed security-constraint and security-role which are not required for Shiro security
    • DocServlet now contains a minor modification to add content type and character set to responses for XML documents. This was done to avoid backend trouble when proxying through the Apache server.
    • A fix was made to Cause of Death, which was throwing an error on the drill-down page. This was due to the reference of a wrong attribute in the XHTML page.
    • Removed GatekeeperServletContextListener from org.tolven.shiro, in favor of each plug-in's using its own ServletContextListener to more clearly indicate in their logs more detailed information about when those plug-ins come online, and what services they offer.
  • org.tolven.component.war 2.1.4
    • Provided support to add a web.xml directly to war module plugins, which then forms the basis for web-fragments to contribute to.
    • Removed web-resource-name parameter-def from webDirectory, filter and filter-adaptor extension-points.
    • Extension-points transaction-filter, security-filter, security-role and security-constraint are deprecated, and no longer required.
    • The following extension-points can now be supplied via a web-fragment:
      • listener-adaptor
      • env-entry-adaptor
      • ejb-local-ref
      • session-config
      • welcome-file-list
      • login-config
      • env-entry
  • org.tolven.config.eprescription 2.1.12
    • Removed the <servlet> and <servlet-mapping-contribution> extensions from the manifests, and instead we now supply the servlet information via a web-fragment.xml file.
    • Added a ServletContextListener which logs when the module is successfully deployed with the war file.
  • org.tolven.dischargeInstructions 2.1.2
    • Removed the <servlet> and <servlet-mapping-contribution> extensions from the manifests, and instead we now supply the servlet information via a web-fragment.xml file.
    • Added a ServletContextListener which logs when the module is successfully deployed with the war file.
  • org.tolven.fdb 2.1.9
    • Removed the <servlet> and <servlet-mapping-contribution> extensions from the manifests, and instead we now supply the servlet information via a web-fragment.xml file.
    • Added a ServletContextListener which logs when the module is successfully deployed with the war file.
  • org.tolven.hl7 2.1.7
    • Removed the <servlet> and <servlet-mapping-contribution> extensions from the manifests, and instead we now supply the servlet information via a web-fragment.xml file.
    • Added a ServletContextListener which logs when the module is successfully deployed with the war file.
  • org.tolven.jaxrs 2.1.6
    • Removed JAXRSServlet contribution tolvenAPI.war's web.xml, which was already being made by org.tolven.api itself.
  • org.tolven.onc.component.mirth 2.1.4
    • Removed the <servlet> and <servlet-mapping-contribution> extensions from the manifests, and instead we now supply the servlet information via a web-fragment.xml file.
    • Added a ServletContextListener which logs when the module is successfully deployed with the war file.
  • org.tolven.onc.component.web 2.1.12
    • Removed the <servlet> and <servlet-mapping-contribution> extensions from the manifests, and instead we now supply the servlet information via a web-fragment.xml file.
    • Added a ServletContextListener which logs when the module is successfully deployed with the war file.
    • Removed transaction parameter from filter extension.
  • org.tolven.surescripts 2.1.6
    • Removed the <servlet> and <servlet-mapping-contribution> extensions from the manifests, and instead we now supply the servlet information via a web-fragment.xml file.
    • Added a ServletContextListener which logs when the module is successfully deployed with the war file.
  • org.tolven.deploy.allergies 2.1.1
    • Changed all projects to java projects, and removed any unused directories and sections. These changes had no effect on the final plug-in zip files.
  • org.tolven.deploy.diagnoses 2.1.1
    • Changed all projects to java projects, and removed any unused directories and sections. These changes had no effect on the final plug-in zip files.
  • org.tolven.deploy.immunization 2.1.1
    • Changed all projects to java projects, and removed any unused directories and sections. These changes had no effect on the final plug-in zip files.
  • org.tolven.deploy.plugincopy 2.1.1
    • Changed all projects to java projects, and removed any unused directories and sections. These changes had no effect on the final plug-in zip files.
  • org.tolven.deploy.problems 2.1.1
    • Changed all projects to java projects, and removed any unused directories and sections. These changes had no effect on the final plug-in zip files.
  • org.tolven.deploy.procedures 2.1.1
    • Changed all projects to java projects, and removed any unused directories and sections. These changes had no effect on the final plug-in zip files.
  • org.tolven.deploy.rxnorm 2.1.1
    • Changed all projects to java projects, and removed any unused directories and sections. These changes had no effect on the final plug-in zip files.


Deprecated Plug-ins

The following plug-ins were deprecated:


Tolven V21_20120131 Documentation


Retrieved from "http://wiki.tolven.org/doc/index.php/V21_20120131"
Personal tools