Merging ATG Self Service with an Existing J2EE Application

You must combine the ATG Self Service application module and your application module into a single J2EE application with a single context-root. These instructions assume that you are using your own module named DSSJ2EEDemoSS with a J2EE application called QuincyFunds.

  1. Make a copy of your application module and rename it. For example, DSSJ2EEDemoSS.

    Copy the <ATG2007.3dir>/Service2007.3/Service/SelfService/config directory into <ATG2007.3dir>/DSSJ2EEDemoSS/config/. Don’t overwrite any files. If there are files that overlap, copy the contents of the .properties file from ATG Service into your application.

  2. Follow the same procedure for the liveconfig directory.

  3. Copy over the <ATG2007.3dir>/Service2007.3/Service/SelfService/
    lib/classes.jar     file into your <ATG2007.3dir>/DSSJ2EEDemoSS/lib directory. If you already have a lib/classes.jar, rename the classes.jar from SelfService to ssClasses.jar.

  4. In the <ATG2007.3dir>/DSSJ2EEDemo/META-INF/MANIFEST.MF file add

    ATG-Class-Path: lib/classes.jar (or lib/ssClasses.jar)

    If you already have an ATG-Class-Path declaration, simply add a space after the last entry in that line, and add lib/classes.jar or lib/ssClasses.jar to it.

    Make sure there is an ATG-Config-Path: config/ line and an ATG-LiveConfig-Path: liveconfig line in the file as well.

    Add PublishingAgent Service.common-ui to the ATG-Required: line.

  5. Make an ss directory in your root web-app folder. For example:

    <ATG2007.3dir>/DSSJ2EEDemo/j2ee-apps/QuincyFunds/web-app/en/ss

    and copy into it everything from

    <ATG2007.3dir>/Service2007.3/Service/SelfService/j2ee-apps
    /selfservice-ear/_SelfService/

    (This is assuming that you have already followed the directions on how to expand the SS ear file into folders from Getting Set Up.)

  6. Except for web.xml, move all the files from

    <ATG2007.3dir>/DSSJ2EEDemo/j2ee-apps/QuincyFunds/web-app/en/ss/WEB-INF/*

    into

    <ATG2007.3dir>/DSSJ2EEDemo/j2ee-apps/QuincyFunds/web-app/WEB-INF/

    Important: Do not overwrite files if they have the same name.

  7. Delete the META-INF directory:

    <ATG2007.3dir>/DSSJ2EEDemo/j2ee-apps/QuincyFunds/web-app/en/ss/META-INF

  8. Change the web.xml file at

    <ATG2007.3dir>/DSSJ2EEDemo/j2ee-apps/QuincyFunds/web-app/WEB-INF/web.xml

    Add the filter mappings:

    <filter-mapping>
        <filter-name>RequireLoginFilter</filter-name>
        <url-pattern>*.jsp</url-pattern>
    </filter-mapping>

You can now include ss into your application using the following:

<dsp:include src="ss/main.jsp"></dsp:include>
 
loading table of contents...