Sie sind auf Seite 1von 11

ATG Developer Tools Plug-in for Eclipse 3.1.

Quick Start Guide

Copyright (c) 2006 Art Technology Group, Inc. Page 1


Table of Contents

Installing ATG Developer Tools Plug-In ...............................................................3


Introduction to ATG Developer Tools...................................................................3
ATG Project Wizards......................................................................................3
Example: Creating a Project and New ATG Module.........................................4
ATG Component Browser ...............................................................................7
ATG Application Assembler Wizard ..................................................................8
ATG Repository Definition Editor .....................................................................9
Help ............................................................................................................. 11

Copyright (c) 2006 Art Technology Group, Inc. Page 2


Installing ATG Developer Tools Plug-In
1. Download Eclipse 3.1.1 or 3.1.2 from www.eclipse.org. The ATG Plug-in does not work
with Eclipse 3.2, 3.1.0 or prior
2. After Eclipse is installed, start up Eclipse, go to Help -> Software Updates -> Find
and Install
3. Select Search for new features to install
4. Select New Remote Site…, enter ATG in the name field and
http://www.atg.com/eclipse in the URL field.
5. Follow the steps to finish the installation.
6. Restart Eclipse. Enter the location of your ATG Root when prompted (e.g.
C:\ATG\ATG7.2)

Introduction to ATG Developer Tools


ATG Project Wizards
The ATG Project wizards enable you to quickly create ATG modules and skeleton J2EE
applications.

• The New ATG Module wizard extends the standard Eclipse Java Project wizard. It
creates a new Java project and sets up the required directory structure and
configuration files for an ATG application module, J2EE application and web
application.
• The Existing ATG Module wizard creates a new Java project for a module that
already exists in your ATG installation.
• The ATG J2EE Application wizard creates a basic J2EE application and web
application within an existing ATG module project.
• The ATG Web Application wizard creates a basic web application within an existing
J2EE application.
• The ATG Standalone Web Application wizard creates a basic web application that is
not part of a J2EE application.

Please visit Help -> Help Content -> ATG Development Tools 3.1.1 -> Using the ATG
Project Wizards for more details.

Copyright (c) 2006 Art Technology Group, Inc. Page 3


Example: Creating a Project and New ATG Module

Follow these steps to create a new Java project and ATG module simultaneously:

1. From the File menu, select New >


Project. When the New Project
dialog box opens, select Java >
ATG Wizards > New ATG
Module.

2. Enter a name for the project. Note


that the wizard adds a new project
directory under the ATG root
directory.

Copyright (c) 2006 Art Technology Group, Inc. Page 4


3. Specify the ATG applications on
which the new module depends.
(ATG Adaptive Scenario Engine is
included by default). Click Add to
select additional applications from
a separate pop-up list. Your
selections here determine the
modules that are included in the
new module's CLASSPATH,
CONFIGPATH, and manifest file.

4. The next screen lists the individual


modules included in the ATG
application(s) you selected in the
previous step. If the new module is
dependent on any other modules,
click Add to select them from a
separate pop-up list. (Note: This
pop-up list includes all ATG
directories that include a
MANIFEST.MF file; some items may
not be actual application modules.)

If necessary, you can edit the


Configuration Directory field to
change the ATG-Config-Path entry
in the module's MANIFEST.MF file.
This field is set to config by default.

Copyright (c) 2006 Art Technology Group, Inc. Page 5


5. Define the build settings for the
new module. Note: You can click
Finish here, or you can continue to
the next screen to define a J2EE
application for your module.

6. Fill in a name and context-root for


the J2EE application and web
application, click Add to select the
target application server(s), and
then click Finish.

Copyright (c) 2006 Art Technology Group, Inc. Page 6


ATG Component Browser
The ATG Component Browser view should appear automatically in the Workbench's Java and
Resource perspectives.

The ATG Component Browser shows you the hierarchy of components within a selected ATG
module project. When you right-click inside the browser, a pop-up menu gives you the option
of creating a new component, opening the component editor, or refreshing the component
tree.

Note: Due to a known Eclipse limitation, the component browser may not open automatically
if you've customized the layout of your Workbench perspectives. If you don't see the
component browser view in the Java or Resource perspective, you can open it manually by
selecting Window > Show View > Other > ATG > ATG Component Browser.

Please visit Help -> Help Content -> ATG Development Tools 3.1.1 -> Working with ATG
Nucleus Components for more details.

Copyright (c) 2006 Art Technology Group, Inc. Page 7


ATG Application Assembler Wizard
The ATG Application Assembler wizard takes the application modules in a specified ATG project
and assembles them into an EAR file, which you can then deploy to BEA WebLogic or IBM
WebSphere.

To assemble an application:

1. Select File > Export > ATG J2EE Application to open the ATG Application
Assembler wizard.

2. Select an ATG project and enter the output path and display name of the new EAR file.
(The display name appears in the application.xml file for the assembled EAR file.)

3. Select the assembly options you want to use, and click Finish. (Please see Help ->
Help Content -> ATG Development Tools 3.1.1 -> Assembling an ATG Application ->
Application Assembly Options for a glossary of the options.)

Copyright (c) 2006 Art Technology Group, Inc. Page 8


ATG Repository Definition Editor
• ATG Repository Definition Editor provides a graphical interface for easily building and
modifying ATG repositories.

Copyright (c) 2006 Art Technology Group, Inc. Page 9


• To use the editor, open the Repository Editor Perspective, which includes the
following:
o Editor Window - manage your repository definition diagrams in this
area

o Outline View - provides a map of objects and their relationships.

o Package Explorer – standard Eclipse view for managing Java packages.


o ATG Component Browser – see Component Browser above
o Attribute Editor - allows you to add, edit, and remove attributes and values
for the object selected

Please see Help -> Help Content -> ATG Development Tools 3.1.1 -> Using the
Repository Definition Editor for more details.

Copyright (c) 2006 Art Technology Group, Inc. Page 10


Help
• Documentation shipped as integrated Eclipse help located under Help -> Help
Contents.
• If you are an ATG customer with a current support contract, you can visit
http://esupport.atg.com or contact ATG Support for help.

See also:

“Creating a Many to Many Relationship using the Repository Editor Eclipse Plugin” by
Patrick Beagan, ATG
http://www.atg.com/portal/myatg/developer?paf_dm=full&paf_gear_id=1100008&showD
etail=true&id=600008

Copyright (c) 2006 Art Technology Group, Inc. Page 11