4:35 a.m.
Author: ochikvina
Date: 2010-02-18 05:35:18 -0500 (Thu, 18 Feb 2010)
New Revision: 20354
Modified:
trunk/portlet/docs/reference/en/master.xml
trunk/portlet/docs/reference/en/master_output.xml
Log:
<html><head><meta name="qrichtext" content="1"
/></head><body style="font-size:9pt;font-family:Sans Serif">
<p>https://jira.jboss.org/jira/browse/JBDS-1104 - Updated versions,corrected
master_output file</p>
</body></html>
Modified: trunk/portlet/docs/reference/en/master.xml
===================================================================
--- trunk/portlet/docs/reference/en/master.xml 2010-02-18 09:49:18 UTC (rev 20353)
+++ trunk/portlet/docs/reference/en/master.xml 2010-02-18 10:35:18 UTC (rev 20354)
@@ -45,12 +45,12 @@
<copyright>
<year>2008</year>
- <year>2009</year>
+ <year>2009</year>
<year>2010</year>
<holder>JBoss by Red Hat</holder>
</copyright>
<releaseinfo>
- Version: 1.1.0.CR1
+ Version: 1.1.0.CR2
</releaseinfo>
<abstract>
Modified: trunk/portlet/docs/reference/en/master_output.xml
===================================================================
--- trunk/portlet/docs/reference/en/master_output.xml 2010-02-18 09:49:18 UTC (rev 20353)
+++ trunk/portlet/docs/reference/en/master_output.xml 2010-02-18 10:35:18 UTC (rev 20354)
@@ -4,10 +4,12 @@
[<!ENTITY intro SYSTEM "modules/intro.xml">
<!ENTITY installation SYSTEM "modules/installation.xml">
+<!ENTITY portlet_tools_tasks SYSTEM "modules/portlet_tools_tasks.xml">
<!ENTITY starting_project SYSTEM "modules/starting_project.xml">
<!ENTITY jsf_portlet SYSTEM "modules/jsf_portlet.xml">
<!ENTITY seam_portlet SYSTEM "modules/seam_portlet.xml">
-<!ENTITY portlets_to_nonWTP_projects SYSTEM
"modules/portlets_to_nonWTP_projects.xml">
+<!ENTITY reference SYSTEM "modules/reference.xml">
+<!ENTITY summary SYSTEM "modules/summary.xml">
<!ENTITY seamlink "../../seam/html_single/index.html">
<!ENTITY aslink "../../as/html_single/index.html">
@@ -20,982 +22,1666 @@
<!ENTITY jsftutoriallink
"../../jsf_tools_tutorial/html_single/index.html">
<!ENTITY strutsreflink
"../../struts_tools_ref_guide/html_single/index.html">
<!ENTITY strutstutoriallink
"../../struts_tools_tutorial/html_single/index.html">
-]><book xmlns:diffmk="http://diffmk.sf.net/ns/diff">
-
- <bookinfo>
- <title>JBoss Portal Tools Reference Guide</title>
- <corpauthor>
- <inlinemediaobject>
- <imageobject role="fo">
- <imagedata fileref="images/jbosstools_logo.png"
format="PNG"></imagedata>
- </imageobject>
- <imageobject role="html">
- <imagedata></imagedata>
- </imageobject>
- </inlinemediaobject>
- </corpauthor>
-
<author><firstname>Olga</firstname><surname>Chikvina</surname></author>
-
<author><firstname>Snjezana</firstname><surname>Peco</surname><email>snjezana.peco(a)redhat.com</email></author>
-
<author><firstname>Svetlana</firstname><surname>Mukhina</surname><email>smukhina(a)exadel.com</email></author>
-
<author><firstname>Thomas</firstname><surname>Heute</surname><email>theute(a)jboss.org</email></author>
-
- <pubdate>September 2008</pubdate>
- <copyright>
- <year>2008</year>
- <year>2009</year>
- <holder>JBoss by Red Hat</holder>
- </copyright>
- <releaseinfo><diffmk:wrapper diffmk:change="changed">
- Version: 1.1.0.CR1
- </diffmk:wrapper></releaseinfo>
-
-<abstract>
- <title></title>
- <para>
- <ulink
url="http://download.jboss.org/jbosstools/nightly-docs/en/jboss_port...
version</ulink>
- </para>
-</abstract>
-
-
- </bookinfo>
- <toc></toc>
-
-
-
-<chapter id="intro"
xml:base="file:///home/ochikvina/WORK/for_compare/jbosstools-3.1.0.CR1/portlet/docs/reference/en/modules/intro.xml"
xreflabel="intro">
- <?dbhtml filename="intro.html"?>
- <title>Introduction</title>
-
- <para>Starting from 3.0.0.Alpha1 version, JBoss set of plugins extends
<property moreinfo="none">JBoss Portal</property>
- features. Thus, this guide is intended to explain you how to manage the
functionality
- <property moreinfo="none">JBoss Tools</property>
provide to ease the development with <property moreinfo="none">JBoss
- Portal</property>.</para>
-
- <section id="preface">
- <title>Preface</title>
- <para><property moreinfo="none">JBoss
Portal</property> provides an open source platform for hosting and
- serving a portal's Web interface, publishing and managing its content,
and customizing
- its experience. It supports a wide range of features, including standard
portlets,
- single sign-on, clustering, and internationalization.</para>
- </section>
-
- <section id="key_features">
- <title>Key Features</title>
- <para>The next table lists key features supplied by <property
moreinfo="none">JBoss Portal Tools</property>.</para>
-
- <table>
- <title>Key Functionality of JBoss Portal Tools</title>
- <tgroup cols="3">
-
- <colspec align="left" colnum="1"
colwidth="1*"></colspec>
- <colspec colnum="2"
colwidth="5*"></colspec>
- <colspec align="left" colnum="3"
colwidth="1*"></colspec>
-
- <thead>
- <row>
- <entry>Feature</entry>
- <entry>Benefit</entry>
- <entry>Chapter</entry>
- </row>
- </thead>
-
- <tbody>
-
- <row>
- <entry>
- <para>Wizards for creating Projects with Portlet
Facets</para>
- </entry>
- <entry>
- <para>New Dynamic Web Project wizard allows you to
select a proper
- Configuration to enable Portlet Facet in
it.</para>
- </entry>
- <entry>
- <link
linkend="creating_project_with_jbossportal">Creating a Dynamic
- Web Project</link>
- </entry>
- </row>
-
-
- <row>
- <entry>
- <para>Create Java Portlet wizard</para>
- </entry>
-
- <entry>
- <para>The wizard enables creating a JSR-186/JSR-286
compliant
- portlet.</para>
- </entry>
- <entry>
- <link linkend="adding_java_portlet">Adding
Java Portlet to a
- project</link>
- </entry>
- </row>
-
- <row>
- <entry>
- <para>Create JSF/Seam Portlet wizard</para>
- </entry>
- <entry>
- <para>This wizard allows to create JSF/Seam
portlets</para>
- </entry>
- <entry>
- <link linkend="jsf_portlet">Creating JSF
Portlet</link>
- <link linkend="seam_portlet">Creating Seam
Portlet</link>
- </entry>
- </row>
-
- </tbody>
- </tgroup>
- </table>
- </section>
-
- <section id="rel_resources">
- <title>Other relevant resources on the topic</title>
-
- <itemizedlist>
- <listitem>
- <para>
- <ulink url="http://www.jboss.org/jbossportal/">JBoss
Portal Home Page</ulink>
- </para>
- </listitem>
-
- <listitem>
- <para>
- <ulink
url="http://wiki.jboss.org/wiki/JBossPortal">JBoss Portal Wiki</ulink>
- </para>
- </listitem>
-
- <listitem>
- <para>
- <ulink url="http://www.jboss.org/tools/">JBoss Tools
Home Page</ulink>
- </para>
- </listitem>
-
- <listitem>
- <para>
- <ulink
url="http://www.jboss.com/index.html?module=bb&op=viewforum&...
Tools Forum</ulink>
- </para>
- </listitem>
-
- <listitem>
- <para>
- <ulink
url="http://download.jboss.org/jbosstools/nightly-docs/">The latest
- JBossTools/JBDS documentation builds</ulink>
- </para>
- </listitem>
-
- <listitem>
- <para>JBoss Developer Studio/JBoss Tools release documentation you
can find at<ulink
url="http://docs.jboss.org/tools/">http://docs.jboss.org/too...
in the corresponding release directory.</para>
- </listitem>
- </itemizedlist>
-
- </section>
-</chapter>
-
-
-<chapter id="installation"
xml:base="file:///home/ochikvina/WORK/for_compare/jbosstools-3.1.0.CR1/portlet/docs/reference/en/modules/installation.xml"
xreflabel="installation">
- <?dbhtml filename="installation.html"?>
- <title>Installation issues</title>
-
- <para>This section provides you with the steps on how to start with
<property moreinfo="none">JBoss
- Portal</property> and integrated features using <property
moreinfo="none">JBoss Tools</property>.</para>
-
- <itemizedlist>
- <listitem>
- <para>First, you need to have Eclipse Ganymede with JBoss Tools
3.0.0.Alpha1 and higher installed.</para>
-
- <tip>
- <title>Tip:</title>
- <para>Read <ulink
url="../../GettingStartedGuide/html_single/index.html#JBossToolsInstall">JBoss
Tools
- Installation</ulink> section in our Getting Started
documentation to find out
- how to install <property moreinfo="none">JBoss
Tools</property> onto Eclipse.</para>
- </tip>
- </listitem>
-
- <listitem>
- <para>Next, download the JBoss Portal + JBoss AS bundle from <ulink
url="http://www.jboss.org/jbossportal/download/index.html">J... Portal
Download
- page</ulink></para>
-
- <note>
- <title>Note:</title>
- <para>You need JBoss Portal 2.7 if you want to work with a Portlet
2.0</para>
- </note>
-
- </listitem>
-
- <listitem>
- <para>Extract the bundle wherever you want on your hard
drive</para>
- </listitem>
- </itemizedlist>
-
- <para>Now, when you have it installed, we are going to demonstrate some
powerful features of
- <property moreinfo="none">JBoss Portal</property> tooling
for Eclipse.</para>
-</chapter>
-
-
-<chapter id="starting_project"
xml:base="file:///home/ochikvina/WORK/for_compare/jbosstools-3.1.0.CR1/portlet/docs/reference/en/modules/starting_project.xml"
xreflabel="starting_project">
- <?dbhtml filename="starting_project.html"?>
- <title>Starting the Project with JBoss Portal</title>
-
- <para>To get started with <property moreinfo="none">JBoss
Portal</property> and <property moreinfo="none">JBoss
- Tools</property>, you should first have a Web Project pointed to the JBoss
Portal Runtime.
- Thus, in this chapter we are going to show you how to create a Dynamic Web
Project, add Java
- Portlet to it and deploy it to the <property
moreinfo="none">JBoss Portal</property>.</para>
-
- <section id="creating_project_with_jbossportal">
- <title>Creating a Dynamic Web Project</title>
-
- <para>To create a Dynamic Web Project, go to <emphasis>
- <property moreinfo="none">File > New >
Dynamic Web Project</property>
- </emphasis> if you are in the <property
moreinfo="none">Web Perspective</property> or <property
moreinfo="none">File >
- New > Other > Web > Dynamic Web
Project</property> in any other Perspective. The
- first page of the New Dynamic Web Project wizard looks as
follows.</para>
-
- <figure float="0">
- <title>New Dynamic Web Project</title>
- <mediaobject>
- <imageobject>
- <imagedata
fileref="images/starting_project/starting_project_1.png"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
-
- <para>Fill out the name of your project. Next, click the <emphasis>
- <property moreinfo="none">New</property>
- </emphasis> button in the <emphasis>
- <property moreinfo="none">Target
Runtime</property>
- </emphasis> section to specify a new Target Runtime. Choose
<emphasis>
- <property moreinfo="none"> JBoss Community > JBoss
4.2 Runtime</property>
- </emphasis> and select the <emphasis>
- <property moreinfo="none">Create a new local
server</property>
- </emphasis> checkbox. Click <emphasis>
- <property
moreinfo="none">Next</property>.</emphasis></para>
-
- <figure float="0">
- <title>New Server Runtime</title>
- <mediaobject>
- <imageobject>
- <imagedata
fileref="images/starting_project/starting_project_2.png"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
-
- <para>On the next page you should give a name to the runtime. Let's
call it <emphasis>
- <property moreinfo="none">JBoss Portal 2.7
Runtime</property>
- </emphasis>, and then point it to the location of your JBoss AS +
Portal
- installation.</para>
-
- <figure float="0">
- <title>New Server Runtime Environment</title>
- <mediaobject>
- <imageobject>
- <imagedata
fileref="images/starting_project/server_runtime_environment.png"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
-
- <note>
- <title>Note:</title>
-
- <para>The JBoss Tools Portlet feature has been tested using 2.6.5 and
2.7.0.ALPHA
- versions of <property moreinfo="none">JBoss
Portal</property>. Remember, if you want to use Portlet
- version 2.0 (JSR-268), you have to choose JBoss Portal 2.7.</para>
- </note>
-
- <para>At this point a new JBoss Server instance will be created. Here you
can verify the
- defined runtime information. If something is incorrect, press
<emphasis>
- <property moreinfo="none">Back</property>
- </emphasis> to return on the previous wizard page.</para>
-
- <figure float="0">
- <title>Target Server</title>
- <mediaobject>
- <imageobject>
- <imagedata
fileref="images/starting_project/starting_project_3.png"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
-
- <para>Click <emphasis>
- <property
moreinfo="none">Finish</property>.</emphasis></para>
-
- <para>On the next step you should click the <emphasis>
- <property moreinfo="none">Modify</property>
- </emphasis> button next to the <property
moreinfo="none">Configuration</property> section to enable
- Portlet Facets for the project.</para>
-
- <figure float="0">
- <title>Setting the Project Configuration</title>
- <mediaobject>
- <imageobject>
- <imagedata
fileref="images/starting_project/starting_project_4.png"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
-
- <para>On this page you should check the <emphasis>
- <property moreinfo="none">JBoss Core
Portlet</property>
- </emphasis> and press <emphasis>
- <property moreinfo="none">OK</property>
- </emphasis>.</para>
-
- <figure float="0">
- <title>Enabling the Portlet Facet</title>
- <mediaobject>
- <imageobject>
- <imagedata
fileref="images/starting_project/starting_project_4_a.png"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
-
- <note>
- <title>Note:</title>
- <para>If the portlet libraries aren't available in the runtime you
targeted,
- JBoss Portlet facets will be hidden on this page.</para>
- <para>To made portal functionality always visible no matter what the
runtime support,
- you should go to <emphasis>
- <property moreinfo="none">Window >
Preferences</property>
- </emphasis> and then <emphasis>
- <property moreinfo="none">JBoss Tools > JBoss
Portlet</property>
- </emphasis> and deselect <emphasis>
- <property moreinfo="none">Check runtimes for Portlet
Components</property>
- </emphasis> checkbox (see figure below).</para>
- </note>
-
- <figure float="0">
- <title>JBoss Runtime Preferences</title>
- <mediaobject>
- <imageobject>
- <imagedata
fileref="images/starting_project/portlet_preferences.png"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
-
- <para>The next page is for configuring web modules. Here all values are
set, so you can
- leave everything as it is.</para>
-
- <figure float="0">
- <title>The Project Web Modules</title>
- <mediaobject>
- <imageobject>
- <imagedata
fileref="images/starting_project/starting_project_5.png"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
-
- <para>Finally, the last wizard page will ask you to add JBoss Portlet
capabilities to your
- project. Here you can choose whether to set up user libraries, libraries
provided by
- server runtime or not include libraries at all.</para>
-
- <itemizedlist>
- <listitem><para>To set up server runtime libraries, you need to
select <emphasis>
- <property moreinfo="none">Libraries provided by server
runtime</property></emphasis> in the list box.</para>
- </listitem>
- </itemizedlist>
-
- <figure float="0">
- <title>Including Server Runtime Libraries</title>
- <mediaobject>
- <imageobject>
- <imagedata
fileref="images/starting_project/portlet_capabilities6.png"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
-
- <itemizedlist>
- <listitem>
- <para>For setting up user libraries, select <emphasis>
- <property moreinfo="none">User
library</property></emphasis> in the list box and then press <emphasis>
- <property
moreinfo="none">Add</property></emphasis> in the
<emphasis>
- <property moreinfo="none">User
Library</property></emphasis> section.</para>
- </listitem>
- </itemizedlist>
-
- <figure float="0">
- <title>Adding User Library</title>
- <mediaobject>
- <imageobject>
- <imagedata
fileref="images/starting_project/portlet_capabilities1.png"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
-
- <para>Then press <emphasis>
- <property
moreinfo="none">New</property></emphasis> and type the user
library name in the appeared dialog.</para>
-
- <figure float="0">
- <title>Adding User Library</title>
- <mediaobject>
- <imageobject>
- <imagedata
fileref="images/starting_project/portlet_capabilities2.png"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
-
- <para>Next add necessary jar's.</para>
-
- <figure float="0">
- <title>Adding the Portlet API Jar</title>
- <mediaobject>
- <imageobject>
- <imagedata
fileref="images/starting_project/portlet_capabilities3.png"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
-
- <para>Hit <emphasis>
- <property
moreinfo="none">OK</property>.</emphasis> The user library will
be added.
- </para>
-
- <figure float="0">
- <title>User Library Added</title>
- <mediaobject>
- <imageobject>
- <imagedata
fileref="images/starting_project/portlet_capabilities4.png"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
-
- <itemizedlist>
- <listitem><para>If you don't need to include libraries at
all, just deselect the <emphasis>
- <property moreinfo="none">Enable implementation
library</property></emphasis> checkbox.</para>
- </listitem>
- </itemizedlist>
-
- <figure float="0">
- <title>Disabling Implementation Libraries</title>
- <mediaobject>
- <imageobject>
- <imagedata
fileref="images/starting_project/portlet_capabilities5.png"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
-
- <para>After setting JBoss Portlet capabilities press <emphasis>
- <property
moreinfo="none">Finish</property>.</emphasis></para>
-
- <para>That's it! Our base project is done.</para>
-
- </section>
-
- <section id="structure_overview">
- <title>The Project Structure Overview</title>
-
- <para>Now, let's look at the structure of the just created
project.</para>
-
- <figure float="0">
- <title>The Project Structure Overview</title>
- <mediaobject>
- <imageobject>
- <imagedata
fileref="images/starting_project/starting_project_6.png"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
-
- <para>Here <property moreinfo="none">JBoos
Tools</property> added JBoss Portlet facet to the project,
- created an empty <emphasis>
- <property moreinfo="none">portlet.xml</property>
- </emphasis> file and added the Portlet library to the project
classpath.</para>
- </section>
-
- <section id="adding_java_portlet">
- <title>Adding a Java Portlet to the Project</title>
-
- <para>At this point we'll show what the steps you need to proceed to
add a new Java
- Portlet to the project.</para>
-
- <para>Call the <property moreinfo="none">Create Portlet
wizard</property> by selecting <emphasis>
- <property moreinfo="none">New > Other >
JBoss Tools Web > Portlet > Java
- Portlet</property>.</emphasis></para>
-
- <figure float="0">
- <title>New Java Portlet</title>
- <mediaobject>
- <imageobject>
- <imagedata
fileref="images/starting_project/starting_project_7.png"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
-
- <para>The wizard fills in the Web Project and Source Folder fields for you.
Then you need to
- specify the Java package and the Class name and click <emphasis>
- <property moreinfo="none">Next</property>
- </emphasis>.</para>
-
- <figure float="0">
- <title>Specifying Class File Destination</title>
- <mediaobject>
- <imageobject>
- <imagedata
fileref="images/starting_project/starting_project_8.png"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
-
- <para>On the other page you will be able to set the display name of the
Portlet, a title, a
- description, the supported modes and init parameters.</para>
-
- <figure float="0">
- <title>Specifying Class File Destination</title>
- <mediaobject>
- <imageobject>
- <imagedata
fileref="images/starting_project/starting_project_9.png"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
-
- <para>On the next screen you can define which methods from
- <emphasis>GenericPortlet</emphasis> you want to
override.</para>
-
- <figure float="0">
- <title>Specifying Class File Destination</title>
- <mediaobject>
- <imageobject>
- <imagedata
fileref="images/starting_project/starting_project_10.png"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
-
- <para>The last screen lets you build <property
moreinfo="none">JBoss Portal</property> specific descriptors
- to create an instance during the deployment and place it directly on the
Portal.</para>
-
- <figure float="0">
- <title>Specifying Class File Destination</title>
- <mediaobject>
- <imageobject>
- <imagedata
fileref="images/starting_project/starting_project_11.png"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
-
- <tip>
- <title>Tip:</title>
-
- <para>If you uncheck the <emphasis> Create Portlet
Instance</emphasis> checkbox,
- <property moreinfo="none">JBoss
Tools</property> won't create the deployment elements
- in the <emphasis> default-object.xml</emphasis> and
<emphasis>
- portlet-instances.xml</emphasis> files.</para>
- </tip>
-
- <para>Once Java Portlet is created, new resources have been added to the
project structure.
- As you can see on the figure below, it adds a Java Portlet class
(<emphasis>
- <property
moreinfo="none">TestPortlet.java</property>
- </emphasis> in our case), <emphasis>
- <property
moreinfo="none">default-object.xml</property>
- </emphasis> and <emphasis>
- <property
moreinfo="none">portlet-instances.xml</property>
- </emphasis> files and updates <emphasis>
- <property moreinfo="none">portlet.xml</property>
- </emphasis> as well.</para>
-
- <figure float="0">
- <title>The structure of Web Project with Java Portlet
created</title>
- <mediaobject>
- <imageobject>
- <imagedata
fileref="images/starting_project/starting_project_12.png"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
-
- <para>Thus, now the Project is ready to be built and
deployed.</para>
- </section>
-
- <section id="deploying_to_portal">
- <title>Deploying a Portlet to JBoss Portal</title>
-
- <para>You can deploy the created project in the way you deploy any other
Web Application.
- Right click on the project and do <emphasis>
- <property moreinfo="none">Run As > Run On
Server</property>
- </emphasis> and accept the defaults. On the <emphasis>
- <property moreinfo="none">Add and Remove
Projects</property>
- </emphasis> page move the created Project to the right and click
<emphasis>
- <property
moreinfo="none">Finish</property>.</emphasis></para>
-
- <figure float="0">
- <title>Deploying the Portlet Application</title>
- <mediaobject>
- <imageobject>
- <imagedata
fileref="images/starting_project/starting_project_13.png"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
-
- <para>It will deploy the Portlet Web Application and start <property
moreinfo="none">JBoss
- AS</property>.</para>
-
- <tip>
- <title>Tip:</title>
-
- <para>You should use
<emphasis>http://localhost:8080/portal</emphasis> URL to see your
- Portlet in the Browser.</para>
- </tip>
-
- <para>In the Browser the Portlet looks as follows:</para>
-
- <figure float="0">
- <title>Java Portlet in the Browser Window</title>
- <mediaobject>
- <imageobject>
- <imagedata
fileref="images/starting_project/starting_project_14.png"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
-
- <para>Consequently, here you learnt how to create a Dynamic Web Project,
add Java Portlet to
- it and deploy the project to <property moreinfo="none">JBoss
Portal</property>.</para>
- </section>
-
-</chapter>
-
-
-<chapter id="jsf_portlet"
xml:base="file:///home/ochikvina/WORK/for_compare/jbosstools-3.1.0.CR1/portlet/docs/reference/en/modules/jsf_portlet.xml"
xreflabel="jsf_portlet">
- <?dbhtml filename="jsf_portlet.html"?>
- <title>Creating JSF Portlet</title>
-
- <para>This chapter will explain how you can configure JSF Portlet within
Dynamic Web
- Project and JSF Project by using the wizards <property
moreinfo="none">JBoss Tools</property> provides.</para>
-
- <section id="jsf_portlet1">
- <title>Adding JSF Portlet to Dynamic Web Project</title>
-
- <para>To add JSF Portlet to a Dynamic Web Project, you should set the
Configuration to <emphasis>
- <property moreinfo="none">JavaServer Faces v1.1
Project</property>
- </emphasis> or <emphasis>
- <property moreinfo="none">JavaServer Faces v1.2
Project</property>
- </emphasis> and configure the JSF Portlet Facets in the <property
moreinfo="none">New Dynamic Web
- Project wizard</property> by clicking the <emphasis>
- <property moreinfo="none">Modify</property>
- </emphasis> button.</para>
-
- <figure float="0">
- <title>Setting the JSF Configuration</title>
- <mediaobject>
- <imageobject>
- <imagedata
fileref="images/jsf_portlet/jsf_portlet1.png"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
-
- <para>On the Project Facets dialog you should select <property
moreinfo="none">JBoss Core Portlet</property>
- and <property moreinfo="none">JBoss JSF
Portlet</property> check boxes.</para>
-
- <figure float="0">
- <title>Enabling the Portlet Facets</title>
- <mediaobject>
- <imageobject>
- <imagedata
fileref="images/jsf_portlet/jsf_portlet2.png"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
-
- <para>Next wizard page is for configuring JSF Capabilities. You can leave
everything as it
- is here.</para>
-
- <figure float="0">
- <title>JSF Capabilities</title>
- <mediaobject>
- <imageobject>
- <imagedata
fileref="images/jsf_portlet/jsf_portlet3.png"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
-
- <para>To support Portlets in JSF/Seam applications <property
moreinfo="none">JBoss Tools</property> works
- with <property moreinfo="none">JBoss Portlet
Bridge</property>. Thus on the next page you should add JSF Portlet
- capabilities by pointing to the Portletbridge Runtime location.</para>
-
- <figure float="0">
- <title>JSF Capabilities</title>
- <mediaobject>
- <imageobject>
- <imagedata
fileref="images/jsf_portlet/jsf_portlet4.png"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
-
- <tip>
- <title>Tip:</title>
-
- <para>You can download JBoss Portlet Bridge 1.0.0.B4 from <ulink
url="http://www.jboss.org/portletbridge/download/">Portletbr... Download
page</ulink>.</para>
- </tip>
-
- <para>Next click <emphasis>
- <property moreinfo="none">Finish</property>
- </emphasis> to organize the Project.</para>
- <para id="add_jsf_portlet">To add JSF Portlet to generated
project you should call the
- <property moreinfo="none">Create Portlet
wizard</property> by navigating to <emphasis>
- <property moreinfo="none">New > Other >
JBoss Tools Web > Portlet > JSF/Seam
- Portlet</property>.</emphasis></para>
-
- <figure float="0">
- <title>Calling New Portlet Wizard</title>
- <mediaobject>
- <imageobject>
- <imagedata
fileref="images/jsf_portlet/jsf_portlet5.png"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
-
- <para>As you see, the Seam and JSF Portlet wizards are merged into one. We
set JSF
- Configuration for the project, so default values in this wizard will be set
as for a JSF
- portlet.</para>
-
- <figure float="0">
- <title>Creating JSF Portlet</title>
- <mediaobject>
- <imageobject>
- <imagedata
fileref="images/jsf_portlet/jsf_portlet6.png"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
-
- <para>Click <emphasis>
- <property moreinfo="none">Finish</property>
- </emphasis> to complete JSF Portlet creation. Now you can deploy the
project the same
- way as it was <link linkend="deploying_to_portal">described
above</link>.</para>
-
- <para>In the Browser JSF Portlet looks as follows.</para>
-
- <figure float="0">
- <title>JSF Portlet in the Browser</title>
- <mediaobject>
- <imageobject>
- <imagedata
fileref="images/jsf_portlet/jsf_portlet7.png"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
- </section>
-
- <section id="jsf_portlet_to_JSF_project">
- <title>Adding JSF Portlet to JSF Project</title>
-
- <para>How to organize a JSF Project you can find out in our <ulink
url="../../jsf_tools_ref_guide/html_single/index.html#new_jsf_project">JSF
Tools Reference Guide</ulink>. Just
- remember to point Target Runtime to JBoss Portal directory
location.</para>
-
- <figure float="0">
- <title>Creating New JSF Project</title>
- <mediaobject>
- <imageobject>
- <imagedata
fileref="images/jsf_portlet/jsf_portlet8.png"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
-
- <para>Before adding a Portlet to the project you should enable necessary
facets for it.
- Right-click the created project and click <emphasis>
- <property moreinfo="none">Preferences</property>
- </emphasis> to open the <property
moreinfo="none">Project Preferences</property> screen.</para>
- <para>On the <property moreinfo="none">Project
Facets</property> page select the <emphasis>
- <property moreinfo="none">JBoss Core
Portlet</property>
- </emphasis> and <emphasis>
- <property moreinfo="none">JBoss JSF Portlet</property>
- </emphasis> checkboxes. And then the screen will ask you to enable
<emphasis>
- <property moreinfo="none">JavaServer Faces</property>
- </emphasis> facet as well.</para>
-
- <figure float="0">
- <title>Project Facets</title>
- <mediaobject>
- <imageobject>
- <imagedata
fileref="images/jsf_portlet/jsf_portlet9.png"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
-
- <para>Notice, <emphasis>
- <property moreinfo="none">"Further configuration
required..."</property>
- </emphasis> warning appears at the bottom of the screen. It means that you
should click
- it to configure JSF and JSF Portlet Capabilities in the
project.</para>
-
- <figure float="0">
- <title>JSF Capabilities</title>
- <mediaobject>
- <imageobject>
- <imagedata
fileref="images/jsf_portlet/jsf_portlet10.png"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
-
- <figure float="0">
- <title>Project Facets</title>
- <mediaobject>
- <imageobject>
- <imagedata
fileref="images/jsf_portlet/jsf_portlet11.png"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
-
- <para>After setting the path to Portletbridge Runtime location, click
<emphasis>
- <property moreinfo="none">OK</property>
- </emphasis> and then <emphasis>
- <property moreinfo="none">OK</property>
- </emphasis> again.</para>
-
- <para>Now you can add JSF Portlet to the generated JSF Project. How to do
it we showed in
- <link linkend="add_jsf_portlet">the previous
section</link>.</para>
- </section>
-</chapter>
-
-
-<chapter id="seam_portlet"
xml:base="file:///home/ochikvina/WORK/for_compare/jbosstools-3.1.0.CR1/portlet/docs/reference/en/modules/seam_portlet.xml"
xreflabel="seam_portlet">
- <?dbhtml filename="seam_portlet.html"?>
- <title>Creating Seam Portlet</title>
-
- <para>This chapter covers the steps on how to configure Seam Portlet within
Dynamic Web
- Project and Seam Project by using the wizards <property
moreinfo="none">JBoss Tools</property> provides.</para>
-
- <section id="seam_portlet1">
- <title>Adding Seam Portlet to Dynamic Web Project</title>
-
- <para>To add Seam Portlet to a Dynamic Web Project first you should
organize New Dynamic Web
- Project with the Configuration setting to <emphasis>
- <property moreinfo="none">JBoss Seam Portlet Project
v2.0</property>.</emphasis></para>
-
- <figure float="0">
- <title>Calling New Portlet Wizard</title>
- <mediaobject>
- <imageobject>
- <imagedata
fileref="images/seam_portlet/seam_portlet1.png"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
-
- <para>It will add all needed facets to your project. By clicking the
<emphasis>
- <property moreinfo="none">Modify</property>
- </emphasis> button you can observe the chosen configuration of facets
as well as modify
- it. As you can see, all JBoss Portlets are checked.</para>
-
- <figure float="0">
- <title>Project Facets</title>
- <mediaobject>
- <imageobject>
- <imagedata
fileref="images/seam_portlet/seam_portlet2.png"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
-
- <para>Next wizard pages are for adjusting the Project Web Modules and JSF
Configuration.
- They include default values, so you can skip them by pressing
<emphasis>
- <property
moreinfo="none">Next</property>.</emphasis></para>
-
- <para>On the <property moreinfo="none">Seam
Facet</property> page <ulink
url="../../seam/html_single/index.html#seamFacet">set
- Connection Profile</ulink> and hit <emphasis>
- <property
moreinfo="none">Next</property>.</emphasis></para>
-
- <figure float="0">
- <title>Seam Facet Settings</title>
- <mediaobject>
- <imageobject>
- <imagedata
fileref="images/seam_portlet/seam_portlet3.png"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
-
- <para>Last wizard page will prompt you to set the path to Portletbridge
Runtime
- location.</para>
-
- <figure float="0">
- <title>Setting the Portletbridge Runtime</title>
- <mediaobject>
- <imageobject>
- <imagedata
fileref="images/seam_portlet/seam_portlet4.png"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
-
- <tip>
- <title>Tip:</title>
-
- <para>Thus you should have JBoss Portlet Bridge downloaded and
extracted somewhere on
- your hard drive. You can download JBoss Portlet Bridge 1.0.0.B4 from
<ulink
url="http://www.jboss.org/portletbridge/download/">www.jboss...
- </tip>
-
- <para>Now, to add Seam Portlet to the project you should follow to
<emphasis>
- <property moreinfo="none">New > Other >
JBoss Tools Web > Portlet > JSF/Seam
- Portlet</property>.</emphasis> This will call the wizard for
creating JSF/Seam
- Portlets.</para>
-
- <figure float="0">
- <title>Calling the Create Portlet Wizard</title>
- <mediaobject>
- <imageobject>
- <imagedata
fileref="images/seam_portlet/seam_portlet5.png"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
-
- <para>As we set Seam Configuration for the Dynamic Web Project, the wizard
puts the values
- as for Seam Portlet.</para>
-
- <figure float="0">
- <title>Creating Seam Portlet</title>
- <mediaobject>
- <imageobject>
- <imagedata
fileref="images/seam_portlet/seam_portlet6.png"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
-
- <para>After creating the Seam Portlet, you should <link
linkend="deploying_to_portal">deploy
- the project to JBoss Portal</link> and start the Server. In a
Browser
- you'll see the following:</para>
-
- <figure float="0">
- <title>Seam Portlet in the Browser</title>
- <mediaobject>
- <imageobject>
- <imagedata
fileref="images/seam_portlet/seam_portlet7.png"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
- </section>
-
- <section id="seam_portlet_to_seam_project">
- <title>Adding Seam Portlet to Seam Project</title>
-
- <para>First start a Seam Project by following to <emphasis>
- <property moreinfo="none">New > Other > Seam
> Seam Web Project</property>. </emphasis> On the first
- wizard page specify JBoss Portal directory location as <property
moreinfo="none">Target
- Runtime</property> and <emphasis>
- <property moreinfo="none">JBoss Seam Portlet Project
v2.0</property>
- </emphasis> as <property
moreinfo="none">Configuration</property>.</para>
-
- <figure float="0">
- <title>Project Facets</title>
- <mediaobject>
- <imageobject>
- <imagedata
fileref="images/seam_portlet/seam_portlet8.png"></imagedata>
- </imageobject>
- </mediaobject>
- </figure>
-
- <para>Next steps will be the same as we did for the Dynamic Web Project in
the <link linkend="seam_portlet1">Adding Seam Portlet to Dynamic Web
Project</link>
- section.</para>
- </section>
-</chapter>
-
-
-<chapter id="portlets_to_nonWTP_projects"
xml:base="file:///home/ochikvina/WORK/for_compare/jbosstools-3.1.0.CR1/portlet/docs/reference/en/modules/portlets_to_nonWTP_projects.xml"
xreflabel="portlets_to_nonWTP_projects">
- <?dbhtml filename="portlets_to_nonWTP_projects.html"?>
- <title>Adding Portlets to non-WTP Projects</title>
-
- <para>Starting from <property moreinfo="none">JBoss Tools
3.0.0.Beta1</property> version the JBoss Portlet
- wizards no longer require a WTP project to be able to create
Portlets.</para>
-
- <note>
- <title>Note:</title>
- <para>Please note, if the project does not have the proper portlet API
jar's, the generated
- classes will have compile errors.</para>
- </note>
-
- <para>In conclusion, with this document you've learnt how to get started
with <property moreinfo="none">JBoss
- Portal</property> using <property moreinfo="none">JBoss
Tools</property> suite of Eclipse plugins.
- The above chapters walked you through the steps on how to organize a web project
with
- portlets which includes a sample staff and deploy it onto the <property
moreinfo="none">JBoss
- Portal</property>.</para>
-
- <para>If you still have questions or suggestions you are always welcome on our
<ulink
url="http://www.jboss.com/index.html?module=bb&op=viewforum&...;.
Your feedback will be very much appreciated.</para>
-
-</chapter>
-
-
-</book>
+]><book xmlns:diffmk="http://diffmk.sf.net/ns/diff">
+
+ <bookinfo>
+ <title><diffmk:wrapper diffmk:change="changed">JBoss
Portlet Tools User Guide</diffmk:wrapper></title>
+ <corpauthor>
+ <inlinemediaobject>
+ <imageobject role="fo">
+ <imagedata fileref="images/jbosstools_logo.png"
format="PNG"></imagedata>
+ </imageobject>
+ <imageobject role="html">
+ <imagedata></imagedata>
+ </imageobject>
+ </inlinemediaobject>
+ </corpauthor>
+
<author><firstname>Olga</firstname><surname>Chikvina</surname></author>
+
<author><firstname>Snjezana</firstname><surname>Peco</surname><email>snjezana.peco(a)redhat.com</email></author>
+
<author><firstname>Svetlana</firstname><surname>Mukhina</surname><email>smukhina(a)exadel.com</email></author>
+
<author><firstname>Thomas</firstname><surname>Heute</surname><email>theute(a)jboss.org</email></author>
+
+ <copyright>
+ <year>2008</year>
+ <year>2009</year>
+ <year
diffmk:change="added"><diffmk:wrapper
diffmk:change="added">2010</diffmk:wrapper></year>
+ <holder>JBoss by Red Hat</holder>
+ </copyright>
+ <releaseinfo><diffmk:wrapper diffmk:change="changed">
+ Version: 1.1.0.CR2
+ </diffmk:wrapper></releaseinfo>
+
+<abstract>
+ <title></title>
+ <para>
+ <ulink
url="http://download.jboss.org/jbosstools/nightly-docs/en/jboss_port...
version</ulink>
+ </para>
+</abstract>
+
+
+ </bookinfo>
+ <toc></toc>
+
+
+
+<chapter id="intro"
xml:base="file:///home/vchukhutsina/repos/ochik_jboss/portlet/docs/reference/en/modules/intro.xml"
xreflabel="intro">
+ <?dbhtml filename="intro.html"?>
+ <title>Introduction</title>
+
+ <para><diffmk:wrapper diffmk:change="changed">Starting from
3.0.0.Alpha1 version, JBoss set of plugins includes tools for supporting
</diffmk:wrapper><property moreinfo="none">JBoss
Portal</property><diffmk:wrapper diffmk:change="changed"> and
JSR-186/JSR-286 portlets.
+ Thus, this guide is intended to explain you how to get started and manage
</diffmk:wrapper><property moreinfo="none"><diffmk:wrapper
diffmk:change="added">JBoss Portlet
Tools</diffmk:wrapper></property>.</para>
+
+ <section id="preface">
+ <title><diffmk:wrapper diffmk:change="changed">What is
JBoss Portal and Portlet Tools?</diffmk:wrapper></title>
+ <para><property moreinfo="none">JBoss
Portal</property><diffmk:wrapper diffmk:change="added"> provides an
open source platform for hosting and
+ serving a portal's Web interface, publishing and managing its content,
and customizing
+ its experience. It supports a wide range of features, including standard
portlets,
+ single sign-on, clustering, and internationalization. More about
</diffmk:wrapper><property diffmk:change="added"
moreinfo="none"><diffmk:wrapper diffmk:change="added">JBoss
Portal</diffmk:wrapper></property><diffmk:wrapper
diffmk:change="added"> you can find visiting
+ its home page at: </diffmk:wrapper><ulink
diffmk:change="added"
url="http://www.jboss.org/jbossportal/"><diffmk:wrapper
diffmk:change="added">http://www.jboss.org/jbossportal/</...
diffmk:change="added">.</diffmk:wrapper></para>
+
+ <para diffmk:change="added"><diffmk:wrapper
diffmk:change="added">With </diffmk:wrapper><property
diffmk:change="added" moreinfo="none"><diffmk:wrapper
diffmk:change="added">JBoss Portlet
Tools</diffmk:wrapper></property><diffmk:wrapper
diffmk:change="added"> you can easily create a Java, JSF and Seam portlet and
deploy it to </diffmk:wrapper><property diffmk:change="added"
moreinfo="none"><diffmk:wrapper diffmk:change="added">JBoss
Portal</diffmk:wrapper></property><diffmk:wrapper
diffmk:change="added">.</diffmk:wrapper></para>
+ </section>
+
+ <section id="key_features">
+ <title><diffmk:wrapper diffmk:change="changed">Key Features of
JBoss Portlet Tools</diffmk:wrapper></title>
+ <para diffmk:change="added"><property
diffmk:change="added" moreinfo="none"><diffmk:wrapper
diffmk:change="added">JBoss Portlet
Tools</diffmk:wrapper></property><diffmk:wrapper
diffmk:change="added"> supports the </diffmk:wrapper><ulink
diffmk:change="added"
url="http://www.jcp.org/en/jsr/detail?id=168"><diffmk:wra...
diffmk:change="added">JSR-168 Portlet Specification (Portlet
1.0)</diffmk:wrapper></ulink><diffmk:wrapper
diffmk:change="added"> and
+ </diffmk:wrapper><ulink diffmk:change="added"
url="http://www.jcp.org/en/jsr/detail?id=286"><diffmk:wra...
diffmk:change="added">JSR-286 Portlet Specification (Portlet
2.0)</diffmk:wrapper></ulink><diffmk:wrapper
diffmk:change="added"> and works with
+ </diffmk:wrapper><ulink diffmk:change="added"
url="http://www.jboss.org/portletbridge/"><diffmk:wrapper
diffmk:change="added">JBoss Portlet
Bridge</diffmk:wrapper></ulink><diffmk:wrapper
diffmk:change="added"> for supporting Portlets
+ in JSF/Seam applications. To enable these features, you need to add the JBoss
Portlet facet to a new or an existing web project
+ (see </diffmk:wrapper><link diffmk:change="added"
linkend="portlet_tools_tasks"><diffmk:wrapper
diffmk:change="added">JBoss Portlet Tools
Tasks</diffmk:wrapper></link><diffmk:wrapper
diffmk:change="added">). The project could be a non-WTP project, but you
should know that
+ if it does not have the proper portlet API jar's the generated classes will
have compile errors.</diffmk:wrapper></para>
+
+ <para>The next table lists key features supplied by <property
moreinfo="none"><diffmk:wrapper diffmk:change="changed">JBoss
Portlet Tools</diffmk:wrapper></property>.</para>
+
+ <table>
+ <title><diffmk:wrapper diffmk:change="changed">Key
Features of JBoss Portlet Tools</diffmk:wrapper></title>
+ <tgroup cols="3">
+
+ <colspec align="left" colnum="1"
colwidth="1*"></colspec>
+ <colspec colnum="2"
colwidth="5*"></colspec>
+ <colspec align="left" colnum="3"
colwidth="1*"></colspec>
+
+ <thead>
+ <row>
+ <entry>Feature</entry>
+ <entry>Benefit</entry>
+ <entry>Chapter</entry>
+ </row>
+ </thead>
+
+ <tbody>
+
+ <row>
+ <entry>
+ <para><diffmk:wrapper
diffmk:change="changed">JBoss Portlet
facets</diffmk:wrapper></para>
+ </entry>
+ <entry>
+ <para><property diffmk:change="added"
moreinfo="none"><diffmk:wrapper diffmk:change="added">JBoss
Portlet Tools</diffmk:wrapper></property><diffmk:wrapper
diffmk:change="added"> provides the Java, JSF and Seam Portlet facets that
could be enabled for a Web project.</diffmk:wrapper></para>
+ </entry>
+ <entry>
+ <diffmk:wrapper diffmk:change="changed">JBoss
Portlet Tools Tasks</diffmk:wrapper></entry>
+ </row>
+ </tbody>
+
+ <row>
+ <entry>
+ <para><diffmk:wrapper
diffmk:change="changed">Java Portlet
wizard</diffmk:wrapper></para>
+ </entry>
+
+ <entry>
+ <para><diffmk:wrapper
diffmk:change="changed">The wizard helps create a JSR-186/JSR-286 compliant
+ portlets</diffmk:wrapper></para>
+ </entry>
+ <entry>
+ <diffmk:wrapper diffmk:change="changed">Java
Portlet Wizard</diffmk:wrapper></entry>
+ </row>
+ </tgroup>
+
+ <row>
+ <entry>
+ <para><diffmk:wrapper
diffmk:change="changed">JSF/Seam Portlet
wizard</diffmk:wrapper></para>
+ </entry>
+ <entry>
+ <para><diffmk:wrapper
diffmk:change="changed">This wizard helps create JSF/Seam
portlets</diffmk:wrapper></para>
+ </entry>
+ <entry>
+ <link diffmk:change="added"
linkend="jsf_seam_portlet_wizard"><diffmk:wrapper
diffmk:change="added">JSF/Seam Portlet
Wizard</diffmk:wrapper></link>
+ </entry>
+ </row>
+ </table>
+ </section>
+ <section id="requirements_installation">
+ <title>Requirements and Installation</title>
+
+ <para><property diffmk:change="added"
moreinfo="none"><diffmk:wrapper diffmk:change="added">JBoss
+ Portlet Tools</diffmk:wrapper></property><diffmk:wrapper
diffmk:change="added"> needs the following minimal
requirements:</diffmk:wrapper></para>
+
+ <itemizedlist diffmk:change="added">
+ <listitem>
+ <para><diffmk:wrapper diffmk:change="added">Eclipse
3.4.2/Ganymede</diffmk:wrapper></para>
+ </listitem>
+ <listitem>
+ <para><diffmk:wrapper diffmk:change="changed">JBoss Tools
3.0.0.Alpha1 (for higher versions of JBoss Tools make sure you use the
+ </diffmk:wrapper><diffmk:wrapper
diffmk:change="changed">compatible version of
Eclipse</diffmk:wrapper><diffmk:wrapper
diffmk:change="changed">)</diffmk:wrapper></para>
+ </listitem>
+ <listitem><para><diffmk:wrapper diffmk:change="added">JDK
5 or higher</diffmk:wrapper></para></listitem>
+ <listitem>
+ <para><diffmk:wrapper diffmk:change="changed">JBoss Portal +
JBoss AS bundle from: </diffmk:wrapper><ulink
url="http://www.jboss.org/jbossportal/download/index.html">&...
diffmk:change="changed">http://www.jboss.org/jbossportal/dow...
+ <note>
+ <title>Note:</title>
+ <para><diffmk:wrapper diffmk:change="added">JBoss Portlet
Tools has been tested using 2.6.5 and 2.7.0.ALPHA
+ versions of </diffmk:wrapper><property diffmk:change="added"
moreinfo="none"><diffmk:wrapper diffmk:change="added">JBoss
Portal</diffmk:wrapper></property><diffmk:wrapper
diffmk:change="added">. Remember, if you want to use Portlet
+ version 2.0 (JSR-268), you have to choose JBoss Portal
2.7.</diffmk:wrapper></para>
+ </note>
+ </listitem>
+ <listitem>
+ <para><diffmk:wrapper diffmk:change="added">JBoss Portlet
Bridge (optionally) from: </diffmk:wrapper><ulink diffmk:change="added"
url="http://www.jboss.org/portletbridge/downloads.html"><...
diffmk:change="added">http://www.jboss.org/portletbridge/dow...
+ </listitem>
+ </itemizedlist>
+
+ <para><property moreinfo="none"><diffmk:wrapper
diffmk:change="added">JBoss Portlet
Tools</diffmk:wrapper></property><diffmk:wrapper
diffmk:change="added"> is included as part of
</diffmk:wrapper><property diffmk:change="added"
moreinfo="none"><diffmk:wrapper diffmk:change="added">JBoss
Tools</diffmk:wrapper></property><diffmk:wrapper
diffmk:change="added"> project.
+ Refer to </diffmk:wrapper><ulink diffmk:change="added"
url="http://www.jboss.org/tools/download/installation.html">...
diffmk:change="added">http://www.jboss.org/tools/download/in...
diffmk:change="added">
+ for installation methods of </diffmk:wrapper><property
diffmk:change="added" moreinfo="none"><diffmk:wrapper
diffmk:change="added">JBoss
Tools</diffmk:wrapper></property><diffmk:wrapper
diffmk:change="changed">.</diffmk:wrapper></para>
+</section>
+</chapter>
+<chapter id="portlet_tools_tasks"
xreflabel="portlet_tools_tasks">
+ <?dbhtml filename="portlet_tools_tasks.html"?>
+ <title>JBoss Portlet Tools Tasks</title>
+ <section id="starting_project">
+ <title>Creating and Deploying a Java Portlet</title>
+
+ <para>This chapter shows how to create a Dynamic Web Project, add a Java
+ Portlet to it and deploy it to the <property>JBoss
Portal</property>.</para>
+
+ <section id="jboss_core_portlet">
+ <title>Creating a Web Project with JBoss Portlet Capabilities</title>
+ <para>Fallow the next procedure to create a Web project with JBoss Portlet
capabilities pointed to the JBoss Portal runtime.</para>
+
+ <orderedlist>
+ <listitem>
+ <para>Go to <emphasis>
+ <property>File > New > Dynamic Web Project</property>
+ </emphasis> if you are in the <property>Web</property> perspective
or <emphasis><property>File >
+ New > Other > Web > Dynamic Web Project</property></emphasis>
in any other perspective.
+ The <property>New Dynamic Web Project</property> wizard
appears.</para>
+
+ <figure>
+ <title>New Dynamic Web Project</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/starting_project/starting_project_1.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ </listitem>
+
+ <listitem><para>Specify the name of the
project.</para></listitem>
+
+ <listitem>
+ <para>Click <emphasis>
+ <property>New</property>
+ </emphasis> in the <emphasis>
+ <property>Target Runtime</property>
+ </emphasis> area to create a JBoss Portal runtime. Choose <emphasis>
+ <property>JBoss Community > JBoss 4.2 Runtime</property>
+ </emphasis> and select the <emphasis>
+ <property>Create a new local server</property>
+ </emphasis> check box below. Click <emphasis>
+ <property>Next</property>.</emphasis></para>
+
+ <figure>
+ <title>New Server Runtime</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/starting_project/starting_project_2.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ </listitem>
+
+ <listitem>
+ <para>The <property>New Server Runtime Environment</property>
wizard appears. In the <emphasis>
+ <property>Name</property></emphasis> field, type
<emphasis>
+ <property>JBoss Portal 2.7 Runtime</property>,
+ </emphasis> and then use the <emphasis>
+ <property>Browse</property></emphasis> button to point to the
location of JBoss Portal + JBoss AS extracted. Click <emphasis>
+ <property>Next</property></emphasis> to proceed.</para>
+
+ <figure>
+ <title>New Server Runtime Environment</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/starting_project/server_runtime_environment.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ </listitem>
+
+ <listitem>
+ <para>At this point a new JBoss Server instance will be created. On the next
page you can verify the
+ runtime information defined. If something is incorrect, press <emphasis>
+ <property>Back</property>
+ </emphasis> to return to the previous wizard page. Click <emphasis>
+ <property>Finish</property>.</emphasis></para>
+
+ <figure>
+ <title>Target Server</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/starting_project/starting_project_3.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ </listitem>
+
+ <listitem>
+ <para>Click <emphasis>
+ <property>Modify</property>
+ </emphasis> in the
<emphasis><property>Configuration</property></emphasis> area to
enable
+ a portlet facet for the project.</para>
+
+ <figure>
+ <title>Setting the Project Configuration</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/starting_project/starting_project_4.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ </listitem>
+
+ <listitem>
+ <para>In the <property>Project Facets</property> dialog, check
<emphasis>
+ <property>JBoss Core Portlet</property>
+ </emphasis> and press <emphasis>
+ <property>OK</property>
+ </emphasis>.</para>
+
+ <figure>
+ <title>Enabling the JBoss Core Portlet Facet</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/starting_project/starting_project_4_a.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <note>
+ <title>Note:</title>
+ <para>If the portlet libraries aren't available in the runtime you
targeted,
+ <emphasis>
+ <property>JBoss Portlets</property></emphasis> facets will be
hidden on this page.</para>
+ <para>To make them always visible no matter what the runtime is set, you
should enable the appropriate option in
+ <link linkend="preferences">JBoss Portlet
Preferences</link>.</para>
+ </note>
+ </listitem>
+
+ <listitem>
+ <para>The <property>Java</property> and <property>Web
Module</property> pages are for configuring Java and Web modules in the project.
+ Here all values are set, so leave everything as it is.</para>
+ </listitem>
+
+ <listitem>
+ <para>The last wizard page will ask you to add JBoss Portlet capabilities to
the
+ project. Select <emphasis>
+ <property>Portlet Target Runtime Provider</property></emphasis>
and click <emphasis>
+ <property>Finish</property></emphasis> to complete the project
creation.</para>
+
+ <figure>
+ <title>Including the Portlet Libraries Provided by Target
Runtime</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/starting_project/portlet_capabilities6.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <note>
+ <title>Note:</title>
+ <para>All types available under <emphasis>
+ <property>Portlet Implementation Library</property></emphasis>
are fully described in the Wiki article at:
+ <ulink
url="http://www.jboss.org/community/wiki/PortletFacetLibraries"...
+ </note>
+ </listitem>
+ </orderedlist>
+
+ <para>As the result, <property>JBoss Portlet Tools</property> adds
<emphasis>
+ <property>JBoss Core Portlet</property></emphasis> facet to the
project,
+ creates an empty <literal>portlet.xml</literal> file and adds the JBoss
Portlet library to the project classpath.</para>
+
+ <figure>
+ <title>Portlet Project Structure Overview</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/starting_project/starting_project_6.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ </section>
+
+ <section id="adding_java_portlet">
+ <title>Adding a Java Portlet to a Web Project</title>
+
+ <para>At the previous section you have created a web project with JBoss Portlet
capabilities.
+ The next steps will show you how to add a new Java portlet to the
project.</para>
+
+ <orderedlist>
+ <listitem>
+ <para>Right-click the project and follow to <emphasis>
+ <property>New > Other > JBoss Tools Web > Portlet
> Java
+ Portlet</property>.</emphasis></para>
+
+ <figure>
+ <title>New Java Portlet</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/starting_project/starting_project_7.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ </listitem>
+
+ <listitem>
+ <para>The <property>Create Portlet</property> wizard starts (for
information about the wizard options, see
+ <link linkend="java_portlet_wizard">"Java Portlet
Wizard"</link> in the guide reference).
+ The wizard fills in the
<emphasis><property>Project</property></emphasis> and
<emphasis>
+ <property>Source Folder</property></emphasis> fields for you.
You should specify a Java package and a class name
+ (for instance, <emphasis>
+ <property>org.example</property></emphasis> and
<emphasis>
+ <property>TestPortlet</property></emphasis>). Then click
<emphasis>
+ <property>Next</property>
+ </emphasis>.</para>
+
+ <figure>
+ <title>Specifying Class File Destination</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/starting_project/starting_project_8.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ </listitem>
+
+ <listitem><para>You may leave the next three pages with default values,
on the last one hit <emphasis>
+ <property>Finish</property>.</emphasis></para>
+ </listitem>
+ </orderedlist>
+
+ <para>Once a Java portlet is created, new resources are added to the project
structure: a Java portlet class (<literal>TestPortlet.java</literal>),
+ <literal>default-object.xml</literal> and
<literal>portlet-instances.xml</literal> files and the
<literal>portlet.xml</literal> descriptor is updated as well.</para>
+
+ <figure>
+ <title>Structure of the Project with a Java Portlet</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/starting_project/starting_project_12.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para>Thus, now the project is ready to be built and deployed.</para>
+ </section>
+
+ <section id="deploying_to_portal">
+ <title>Deploying a Portlet to JBoss Portal</title>
+
+ <para>You can deploy a portlet project in the way you deploy any other web
application.</para>
+
+ <orderedlist>
+ <listitem>
+ <para>Right-click the project and do <emphasis>
+ <property>Run As > Run On Server</property>.
+ </emphasis> The <property>Run On Server</property> wizard
starts.</para>
+
+ <figure>
+ <title>Running the Java Portlet on Server</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/starting_project/runOnServer.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ </listitem>
+
+ <listitem>
+ <para>Select <emphasis><property>JBoss Portal 2.7
Server</property></emphasis> created before and click
<emphasis><property>Next</property>.</emphasis></para>
+ </listitem>
+
+ <listitem>
+ <para>On the <emphasis>
+ <property>Add and Remove</property>
+ </emphasis> page move the created project to the right and click
<emphasis>
+ <property>Finish</property>.</emphasis></para>
+
+ <figure>
+ <title>Deploying the Portlet Application</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/starting_project/starting_project_13.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para>It will deploy the portlet application and start <property>JBoss
+ AS</property>.</para>
+ </listitem>
+
+ <listitem>
+ <para>Use the
<emphasis>http://localhost:8080/portal/portal/default/default</emphasis> URL
to see your
+ portlet in the browser.</para>
+
+ <figure>
+ <title>Java Portlet in the Browser Window</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/starting_project/starting_project_14.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ </listitem>
+ </orderedlist>
+ </section>
+
+ </section>
+
+ <section diffmk:change="added" id="jsf_portlet"
xml:base="file:///home/vchukhutsina/repos/ochik_jboss/portlet/docs/reference/en/modules/jsf_portlet.xml">
+ <title diffmk:change="added"><diffmk:wrapper
diffmk:change="added">Creating and Deploying a JSF
Portlet</diffmk:wrapper></title>
+
+ <para diffmk:change="added"><diffmk:wrapper
diffmk:change="added">This chapter will explain how you can configure a JSF
portlet within a JSF project with JBoss Portlet capabilities
+ and then deploy it to </diffmk:wrapper><property
diffmk:change="added" moreinfo="none"><diffmk:wrapper
diffmk:change="added">JBoss
Portal</diffmk:wrapper></property><diffmk:wrapper
diffmk:change="added">.</diffmk:wrapper></para>
+
+ <section diffmk:change="added" id="jsf_portlet1">
+ <title diffmk:change="added"><diffmk:wrapper
diffmk:change="added">Creating a JSF Project with JBoss Portlet
Capabilities</diffmk:wrapper></title>
+
+ <para diffmk:change="added"><diffmk:wrapper
diffmk:change="added">You can create a JSF project with JBoss Portlet
capabilities in two ways:</diffmk:wrapper></para>
+
+ <orderedlist continuation="restarts" diffmk:change="added"
inheritnum="ignore">
+ <listitem diffmk:change="added">
+ <para><diffmk:wrapper diffmk:change="added">Create a dynamic
Web project with the </diffmk:wrapper><emphasis
diffmk:change="added"><property
moreinfo="none"><diffmk:wrapper
diffmk:change="changed">JavaServer
Faces</diffmk:wrapper></property></emphasis><diffmk:wrapper
diffmk:change="added">
+ and </diffmk:wrapper><emphasis><property
moreinfo="none"><diffmk:wrapper diffmk:change="changed">JBoss
JSF Portlet</diffmk:wrapper></property></emphasis><diffmk:wrapper
diffmk:change="added"> facets enabled (
+ </diffmk:wrapper><link diffmk:change="added"
linkend="create_dyn_web_proj_jsf"><diffmk:wrapper
diffmk:change="added">the steps to
proceed</diffmk:wrapper></link><diffmk:wrapper
diffmk:change="added">)</diffmk:wrapper></para>
+ </listitem>
+ <listitem diffmk:change="added"><para
diffmk:change="added"><diffmk:wrapper
diffmk:change="added">Or create a JSF project using the wizard JBoss JSF
Tools provides, then enable
+ JSF and JBoss Portlet facets and add JBoss Portlet capabilities (
+ </diffmk:wrapper><link diffmk:change="added"
linkend="create_jsf_proj"><diffmk:wrapper
diffmk:change="added">the steps to
proceed</diffmk:wrapper></link><diffmk:wrapper
diffmk:change="added">)</diffmk:wrapper></para></listitem>
+ </orderedlist>
+
+ <para diffmk:change="added"><diffmk:wrapper
diffmk:change="added">Refer to the further sections for the procedures on how
to do this.</diffmk:wrapper></para>
+
+ <section diffmk:change="added"
id="create_dyn_web_proj_jsf">
+ <title><diffmk:wrapper diffmk:change="changed">Creating a
Dynamic Web Project with the JBoss Portlet
Capabilities</diffmk:wrapper></title>
+
+ <para><diffmk:wrapper diffmk:change="changed">The basic steps
to create a dynamic Web project with the JBoss Portlet capabilities are as
follows:</diffmk:wrapper></para>
+
+ <orderedlist continuation="restarts" diffmk:change="added"
inheritnum="ignore">
+ <listitem diffmk:change="added">
+ <para><diffmk:wrapper diffmk:change="added">Start the
</diffmk:wrapper><emphasis diffmk:change="added"><property
moreinfo="none"><diffmk:wrapper
diffmk:change="changed">Dynamic Web
Project</diffmk:wrapper></property></emphasis><diffmk:wrapper
diffmk:change="added"> wizard navigating to
+ </diffmk:wrapper><emphasis><property
moreinfo="none"><diffmk:wrapper diffmk:change="changed">File
> New > Other > Web > Dynamic Web
Project</diffmk:wrapper></property>.</emphasis></para>
+
+ <tip diffmk:change="added">
+ <title diffmk:change="added"><diffmk:wrapper
diffmk:change="added">Tip:</diffmk:wrapper></title>
+ <para diffmk:change="added"><diffmk:wrapper
diffmk:change="added">You can also select the
</diffmk:wrapper><property diffmk:change="added"
moreinfo="none"><diffmk:wrapper diffmk:change="added">Java
EE</diffmk:wrapper></property><diffmk:wrapper
diffmk:change="added"> perspective and then go to
+ </diffmk:wrapper><emphasis
diffmk:change="added"><property diffmk:change="added"
moreinfo="none"><diffmk:wrapper diffmk:change="added">File
> New > Dynamic Web
Project</diffmk:wrapper></property><diffmk:wrapper
diffmk:change="added">.</diffmk:wrapper></emphasis></para>
+ </tip>
+
+ <figure float="0">
+ <title><diffmk:wrapper diffmk:change="changed">Setting the
JSF Configuration</diffmk:wrapper></title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/jsf_portlet/jsf_portlet1.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ </listitem>
+
+ <listitem diffmk:change="added">
+ <para diffmk:change="added"><diffmk:wrapper
diffmk:change="added">Specify the project name and set the target runtime to
</diffmk:wrapper><property diffmk:change="added"
moreinfo="none"><diffmk:wrapper diffmk:change="added">JBoss
Portal</diffmk:wrapper></property><diffmk:wrapper
diffmk:change="added"> by following the points 3, 4 and 5 in the
+ </diffmk:wrapper><link diffmk:change="added"
linkend="jboss_core_portlet"><diffmk:wrapper
diffmk:change="added">"Creating a Web Project with JBoss Portlet
Capabilities"</diffmk:wrapper></link><diffmk:wrapper
diffmk:change="added"> procedure.</diffmk:wrapper></para>
+ </listitem>
+
+ <listitem diffmk:change="added">
+ <para><diffmk:wrapper diffmk:change="changed">In the
</diffmk:wrapper><emphasis><property
moreinfo="none"><diffmk:wrapper
diffmk:change="changed">Configuration</diffmk:wrapper></property></emphasis><diffmk:wrapper
diffmk:change="added">
+ area, click </diffmk:wrapper><emphasis
diffmk:change="added"><property diffmk:change="added"
moreinfo="none"><diffmk:wrapper
diffmk:change="added">Modify</diffmk:wrapper></property></emphasis><diffmk:wrapper
diffmk:change="added"> and enable </diffmk:wrapper><emphasis
diffmk:change="added"><property diffmk:change="added"
moreinfo="none"><diffmk:wrapper
diffmk:change="added">JavaServer
Faces</diffmk:wrapper></property><diffmk:wrapper
diffmk:change="added">,</diffmk:wrapper></emphasis>
+ <emphasis diffmk:change="added"><property
diffmk:change="added" moreinfo="none"><diffmk:wrapper
diffmk:change="added">JBoss Core
Portlet</diffmk:wrapper></property></emphasis><diffmk:wrapper
diffmk:change="added"> and </diffmk:wrapper><emphasis
diffmk:change="added"><property diffmk:change="added"
moreinfo="none"><diffmk:wrapper diffmk:change="added">JBoss
JSF Portlet</diffmk:wrapper></property></emphasis><diffmk:wrapper
diffmk:change="added"> facets.
+ Hit </diffmk:wrapper><emphasis
diffmk:change="added"><property diffmk:change="added"
moreinfo="none"><diffmk:wrapper
diffmk:change="added">OK</diffmk:wrapper></property>.</emphasis></para>
+
+ <figure float="0">
+ <title><diffmk:wrapper diffmk:change="changed">Enabling
the Portlet Facets</diffmk:wrapper></title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/jsf_portlet/jsf_portlet2.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ </listitem>
+
+ <listitem diffmk:change="added">
+ <para diffmk:change="added"><diffmk:wrapper
diffmk:change="added">You may leave the next two wizard pages with defaults,
just press </diffmk:wrapper><emphasis
diffmk:change="added"><property diffmk:change="added"
moreinfo="none"><diffmk:wrapper
diffmk:change="added">Next</diffmk:wrapper></property></emphasis><diffmk:wrapper
diffmk:change="added"> to proceed.</diffmk:wrapper></para>
+ </listitem>
+
+ <listitem diffmk:change="added">
+ <para><diffmk:wrapper diffmk:change="added">On the
</diffmk:wrapper><property diffmk:change="added"
moreinfo="none"><diffmk:wrapper diffmk:change="added">JBoss
Portlet Capabilities</diffmk:wrapper></property><diffmk:wrapper
diffmk:change="added"> page, select </diffmk:wrapper><emphasis
diffmk:change="added">
+ <property diffmk:change="added"
moreinfo="none"><diffmk:wrapper diffmk:change="added">Portlet
Target Runtime
Provider</diffmk:wrapper></property></emphasis><diffmk:wrapper
diffmk:change="added"> and click </diffmk:wrapper><emphasis
diffmk:change="added"><property diffmk:change="added"
moreinfo="none"><diffmk:wrapper
diffmk:change="added">Next</diffmk:wrapper></property><diffmk:wrapper
diffmk:change="added">.</diffmk:wrapper></emphasis></para>
+
+ <figure float="0">
+ <title><diffmk:wrapper diffmk:change="changed">JBoss
Portlet Capabilities</diffmk:wrapper></title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/jsf_portlet/jsf_portlet2a.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <tip diffmk:change="added">
+ <title diffmk:change="added"><diffmk:wrapper
diffmk:change="added">Tip:</diffmk:wrapper></title>
+ <para><diffmk:wrapper diffmk:change="added">All types of
the portlet implementation library are described more closely in the wiki article at:
+ </diffmk:wrapper><ulink diffmk:change="added"
url="http://www.jboss.org/community/wiki/PortletFacetLibraries"...
diffmk:change="added">http://www.jboss.org/community/wiki/Po...
diffmk:change="added">.</diffmk:wrapper></para>
+ </tip>
+ </listitem>
+
+ <listitem diffmk:change="added">
+ <para diffmk:change="added"><diffmk:wrapper
diffmk:change="added">Next wizard page is for configuring JSF capabilities.
You can leave everything as it
+ is here.</diffmk:wrapper></para>
+
+ <figure float="0">
+ <title><diffmk:wrapper diffmk:change="changed">JSF
Capabilities</diffmk:wrapper></title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/jsf_portlet/jsf_portlet3.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ </listitem>
+
+ <listitem diffmk:change="added">
+ <para><diffmk:wrapper diffmk:change="changed">On the
</diffmk:wrapper><property moreinfo="none"><diffmk:wrapper
diffmk:change="added">JBoss JSF Portlet
Capabilities</diffmk:wrapper></property><diffmk:wrapper
diffmk:change="added"> page, select
+ </diffmk:wrapper><emphasis
diffmk:change="added"><property diffmk:change="added"
moreinfo="none"><diffmk:wrapper diffmk:change="added">JSF
Portlet Target Runtime
Provider</diffmk:wrapper></property></emphasis><diffmk:wrapper
diffmk:change="added"> as the JSF portlet implementation library. It will
+ copy Portlet Bridge libraries from the server runtime to the project
classpath.</diffmk:wrapper></para>
+
+ <figure float="0">
+ <title><diffmk:wrapper diffmk:change="changed">JBoss JSF
PortletCapabilities</diffmk:wrapper></title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/jsf_portlet/jsf_portlet4.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <tip>
+ <title>Tip:</title>
+ <para><diffmk:wrapper diffmk:change="changed">On this
page, it is also possible to add the RichFaces libraries from the RichFaces distribution
by checking
+ </diffmk:wrapper><emphasis><property
moreinfo="none"><diffmk:wrapper
diffmk:change="changed">Add/Change Richfaces
Libraries</diffmk:wrapper></property><diffmk:wrapper
diffmk:change="added">.</diffmk:wrapper></emphasis></para>
+ </tip>
+
+ <note diffmk:change="added">
+ <title diffmk:change="added"><diffmk:wrapper
diffmk:change="added">Note:</diffmk:wrapper></title>
+ <para diffmk:change="added"><diffmk:wrapper
diffmk:change="added">You can select the
</diffmk:wrapper><emphasis><property diffmk:change="added"
moreinfo="none"><diffmk:wrapper diffmk:change="added">JSF
Portletbridge Runtime
Provider</diffmk:wrapper></property></emphasis><diffmk:wrapper
diffmk:change="added"> type. Then it
+ is necessary to set the home of the Portlet Bridge
distribution.</diffmk:wrapper></para>
+ <para diffmk:change="added"><diffmk:wrapper
diffmk:change="added">For information about all the JSF Portlet facet library
providers, refer to the wiki article at:
+ </diffmk:wrapper><ulink diffmk:change="added"
url="http://community.jboss.org/wiki/PortletFacetLibraries">...
diffmk:change="added">http://community.jboss.org/wiki/Portle...
diffmk:change="added">.</diffmk:wrapper></para>
+ </note>
+ </listitem>
+
+ <listitem diffmk:change="added">
+ <para diffmk:change="added"><diffmk:wrapper
diffmk:change="added">Click
</diffmk:wrapper><emphasis><property diffmk:change="added"
moreinfo="none"><diffmk:wrapper
diffmk:change="added">Finish</diffmk:wrapper></property><diffmk:wrapper
diffmk:change="added">.</diffmk:wrapper></emphasis><diffmk:wrapper
diffmk:change="changed"> The project will be created in the
workbench.</diffmk:wrapper></para>
+ </listitem>
+ </orderedlist>
+ </section>
+
+ <section diffmk:change="added" id="create_jsf_proj">
+ <title diffmk:change="added"><diffmk:wrapper
diffmk:change="added">Creating a JSF Project and adding the JBoss Portlet
Capabilities</diffmk:wrapper></title>
+
+ <para diffmk:change="added"><diffmk:wrapper
diffmk:change="added">How to organize a JSF project you can find out in the
</diffmk:wrapper><ulink diffmk:change="added"
url="../../jsf_tools_ref_guide/html_single/index.html#new_jsf_project"><diffmk:wrapper
diffmk:change="added">JSF Tools User
Guide</diffmk:wrapper></ulink><diffmk:wrapper
diffmk:change="added">. Just
+ remember to point the target runtime to </diffmk:wrapper><property
diffmk:change="added" moreinfo="none"><diffmk:wrapper
diffmk:change="added">JBoss
Portal</diffmk:wrapper></property><diffmk:wrapper
diffmk:change="added"> directory location (see
+ how it is done for a dynamic Web project: steps 3, 4 and 5 in the
+ </diffmk:wrapper><link diffmk:change="added"
linkend="jboss_core_portlet"><diffmk:wrapper
diffmk:change="added">"Creating a Web Project with JBoss Portlet
Capabilities"</diffmk:wrapper></link><diffmk:wrapper
diffmk:change="added"> procedure).</diffmk:wrapper></para>
+
+ <figure diffmk:change="added" float="0">
+ <title diffmk:change="added"><diffmk:wrapper
diffmk:change="added">Creating New JSF
Project</diffmk:wrapper></title>
+ <mediaobject diffmk:change="added">
+ <imageobject diffmk:change="added">
+ <imagedata diffmk:change="added"
fileref="images/jsf_portlet/jsf_portlet8.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para diffmk:change="added"><diffmk:wrapper
diffmk:change="added">To add the JBoss Portlet capabilities to the created
JSF project you should complete the next steps:</diffmk:wrapper></para>
+
+ <orderedlist continuation="restarts" diffmk:change="added"
inheritnum="ignore">
+ <listitem diffmk:change="added">
+ <para><diffmk:wrapper diffmk:change="changed">Right-click
the project and click </diffmk:wrapper><emphasis>
+ <property moreinfo="none"><diffmk:wrapper
diffmk:change="changed">Properties</diffmk:wrapper></property>
+ </emphasis><diffmk:wrapper diffmk:change="added"> to open
the project </diffmk:wrapper><property diffmk:change="added"
moreinfo="none"><diffmk:wrapper
diffmk:change="added">Properties</diffmk:wrapper></property><diffmk:wrapper
diffmk:change="added"> sheet. Select </diffmk:wrapper><property
diffmk:change="added" moreinfo="none"><diffmk:wrapper
diffmk:change="added">Project
Facets</diffmk:wrapper></property><diffmk:wrapper
diffmk:change="added">
+ on the left and enable the </diffmk:wrapper><emphasis><property
moreinfo="none"><diffmk:wrapper
diffmk:change="changed">JavaServer
Faces</diffmk:wrapper></property><diffmk:wrapper
diffmk:change="changed">,</diffmk:wrapper></emphasis>
+ <emphasis><property moreinfo="none"><diffmk:wrapper
diffmk:change="changed">JBoss Core
Portlet</diffmk:wrapper></property></emphasis><diffmk:wrapper
diffmk:change="changed"> and
</diffmk:wrapper><emphasis><property
moreinfo="none"><diffmk:wrapper diffmk:change="changed">JBoss
JSF Portlet</diffmk:wrapper></property></emphasis><diffmk:wrapper
diffmk:change="changed"> facets.</diffmk:wrapper></para>
+
+ <figure float="0">
+ <title><diffmk:wrapper diffmk:change="changed">Project
Facets</diffmk:wrapper></title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/jsf_portlet/jsf_portlet9.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ </listitem>
+
+ <listitem diffmk:change="added">
+ <para><diffmk:wrapper diffmk:change="added">Notice,
</diffmk:wrapper><emphasis diffmk:change="added">
+ <property diffmk:change="added"
moreinfo="none"><diffmk:wrapper
diffmk:change="added">"Further configuration
available..."</diffmk:wrapper></property>
+ </emphasis><diffmk:wrapper diffmk:change="added"> warning
appears at the bottom of the screen. It means that next you should configure the JSF
Portlet capabilities in the project.
+ Click the link. The </diffmk:wrapper><property
diffmk:change="added" moreinfo="none"><diffmk:wrapper
diffmk:change="added">Modify Faceted
Project</diffmk:wrapper></property><diffmk:wrapper
diffmk:change="added"> wizard appears.</diffmk:wrapper></para>
+ </listitem>
+
+ <listitem diffmk:change="added">
+ <para><diffmk:wrapper diffmk:change="added">Complete all
wizard pages the same way as described in the steps 5, 6, 7 of the
+ </diffmk:wrapper><link diffmk:change="added"
linkend="jboss_core_portlet"><diffmk:wrapper
diffmk:change="added">"Creating a Dynamic Web Project with the JBoss
Portlet Capabilities"</diffmk:wrapper></link><diffmk:wrapper
diffmk:change="added"> procedure.
+ Hit </diffmk:wrapper><emphasis><property
moreinfo="none"><diffmk:wrapper
diffmk:change="changed">OK</diffmk:wrapper></property><diffmk:wrapper
diffmk:change="changed">.</diffmk:wrapper></emphasis></para>
+ </listitem>
+
+ <listitem diffmk:change="added">
+ <para diffmk:change="added"><diffmk:wrapper
diffmk:change="added">To apply the changes click
</diffmk:wrapper><emphasis><property
moreinfo="none"><diffmk:wrapper
diffmk:change="changed">Apply</diffmk:wrapper></property></emphasis><diffmk:wrapper
diffmk:change="changed"> and then
+ </diffmk:wrapper><emphasis><property
moreinfo="none"><diffmk:wrapper
diffmk:change="added">OK</diffmk:wrapper></property></emphasis><diffmk:wrapper
diffmk:change="added"> to close the project
</diffmk:wrapper><property diffmk:change="added"
moreinfo="none"><diffmk:wrapper
diffmk:change="added">Properties</diffmk:wrapper></property><diffmk:wrapper
diffmk:change="added"> sheet.</diffmk:wrapper></para>
+ </listitem>
+ </orderedlist>
+ </section>
+ </section>
+
+ <section diffmk:change="added"
id="jsf_portlet_to_JSF_project">
+ <title diffmk:change="added"><diffmk:wrapper
diffmk:change="added">Adding a JSF Portlet to the Project and Deploying It to
JBoss Portal</diffmk:wrapper></title>
+
+ <para diffmk:change="added"><diffmk:wrapper
diffmk:change="added">The previous section has shown how to create a JSF
project with JBoss Portlet and JSF Portlet capabilities enabled. Use
+ the following procedure to add a JSF portlet to the created project and deploy it
to </diffmk:wrapper><property diffmk:change="added"
moreinfo="none"><diffmk:wrapper diffmk:change="added">JBoss
Portal</diffmk:wrapper></property>.</para>
+
+ <orderedlist continuation="restarts" diffmk:change="added"
inheritnum="ignore">
+ <listitem diffmk:change="added">
+ <para diffmk:change="added"><diffmk:wrapper
diffmk:change="added">Call the
+ </diffmk:wrapper><property diffmk:change="added"
moreinfo="none"><diffmk:wrapper diffmk:change="added">Create
Portlet</diffmk:wrapper></property><diffmk:wrapper
diffmk:change="added"> wizard by navigating to
</diffmk:wrapper><emphasis diffmk:change="added">
+ <property diffmk:change="added"
moreinfo="none"><diffmk:wrapper diffmk:change="added">New
> Other > JBoss Tools Web > Portlet > JSF/Seam
+
Portlet</diffmk:wrapper></property></emphasis><diffmk:wrapper
diffmk:change="added"> on the context menu of the project (for information
about the wizard options, see
+ </diffmk:wrapper><link diffmk:change="added"
linkend="jsf_seam_portlet_wizard"><diffmk:wrapper
diffmk:change="added">"JSF/Seam Portlet
Wizard"</diffmk:wrapper></link><diffmk:wrapper
diffmk:change="added"> in the guide
reference).</diffmk:wrapper></para>
+
+ <figure float="0">
+ <title><diffmk:wrapper diffmk:change="changed">Calling New
Portlet Wizard</diffmk:wrapper></title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/jsf_portlet/jsf_portlet5.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <tip>
+ <title>Tip:</title>
+ <para diffmk:change="added"><diffmk:wrapper
diffmk:change="added">As you see, the JSF and Seam Portlet wizards are merged
into one. We have set the JSF
+ configuration for the project, so the default values in this wizard will be set
as for a JSF
+ portlet.</diffmk:wrapper></para>
+ </tip>
+ </listitem>
+
+ <listitem diffmk:change="added">
+ <para><diffmk:wrapper diffmk:change="added">Leave all the
wizard pages with default values by clicking the </diffmk:wrapper><emphasis
diffmk:change="added"><property diffmk:change="added"
moreinfo="none"><diffmk:wrapper
diffmk:change="added">Next</diffmk:wrapper></property></emphasis><diffmk:wrapper
diffmk:change="added"> button,
+ on the last one click </diffmk:wrapper><emphasis><property
diffmk:change="added" moreinfo="none"><diffmk:wrapper
diffmk:change="added">Finish</diffmk:wrapper></property></emphasis><diffmk:wrapper
diffmk:change="changed"> to complete the JSF portlet
creation.</diffmk:wrapper></para>
+ </listitem>
+
+ <listitem diffmk:change="added">
+ <para><diffmk:wrapper diffmk:change="added">Complete the
steps described in the </diffmk:wrapper><link diffmk:change="added"
linkend="deploying_to_portal"><diffmk:wrapper
diffmk:change="added">"Deploying a Portlet to JBoss
Portal"</diffmk:wrapper></link><diffmk:wrapper
diffmk:change="added"> procedure to
+ deploy a JSF portlet to </diffmk:wrapper><property
diffmk:change="added" moreinfo="none"><diffmk:wrapper
diffmk:change="added">JBoss
Portal</diffmk:wrapper></property><diffmk:wrapper
diffmk:change="added">. Just use the other URL to see it in the browser:
+ </diffmk:wrapper><emphasis
diffmk:change="added"><diffmk:wrapper
diffmk:change="added">http://localhost:8080/portal/portal/default/JSFPortlet</diffmk:wrapper></emphasis><diffmk:wrapper
diffmk:change="added">.</diffmk:wrapper></para>
+
+ <figure float="0">
+ <title><diffmk:wrapper diffmk:change="changed">JSF Portlet
in the Browser</diffmk:wrapper></title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/jsf_portlet/jsf_portlet7.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ </listitem>
+ </orderedlist>
+
+ </section>
+</section>
+
+
+ <section diffmk:change="added" id="seam_portlet"
xml:base="file:///home/vchukhutsina/repos/ochik_jboss/portlet/docs/reference/en/modules/seam_portlet.xml">
+ <title><diffmk:wrapper diffmk:change="changed">Creating and
Deploying a Seam Portlet</diffmk:wrapper></title>
+
+ <para><diffmk:wrapper diffmk:change="changed">This chapter
covers the steps on how to configure a Seam portlet within a Seam
+ project with the help of the </diffmk:wrapper><property
moreinfo="none"><diffmk:wrapper diffmk:change="changed">JBoss
Portlet Tools</diffmk:wrapper></property><diffmk:wrapper
diffmk:change="changed"> features.</diffmk:wrapper></para>
+
+ <section id="seam_portlet1">
+ <title><diffmk:wrapper diffmk:change="changed">Creating a Seam
Project with JBoss Portlet Capabilities</diffmk:wrapper></title>
+
+ <para><diffmk:wrapper diffmk:change="added">Follow one of two
ways of creating a Seam project with JBoss Portlet capabilities
enabled:</diffmk:wrapper></para>
+ <orderedlist continuation="restarts" diffmk:change="added"
inheritnum="ignore">
+ <listitem diffmk:change="added">
+ <para diffmk:change="added"><diffmk:wrapper
diffmk:change="added">Create a dynamic Web project with the
</diffmk:wrapper><emphasis><property
moreinfo="none"><diffmk:wrapper
diffmk:change="changed">Seam</diffmk:wrapper></property></emphasis><diffmk:wrapper
diffmk:change="changed">
+ and </diffmk:wrapper><emphasis><property
moreinfo="none"><diffmk:wrapper diffmk:change="changed">JBoss
Portlets</diffmk:wrapper></property></emphasis><diffmk:wrapper
diffmk:change="added"> facets enabled (</diffmk:wrapper><link
diffmk:change="added"
linkend="create_dyn_web_proj_seam"><diffmk:wrapper
diffmk:change="added">the steps to
proceed</diffmk:wrapper></link><diffmk:wrapper
diffmk:change="added">)</diffmk:wrapper></para>
+ </listitem>
+ <listitem diffmk:change="added"><para
diffmk:change="added"><diffmk:wrapper
diffmk:change="added">Or create a Seam project with the JBoss Seam portlet
configuration using the wizard JBoss Seam Tools provides
+ and follow all the wizard steps to enable JBoss Portlet capabilities
(</diffmk:wrapper><link diffmk:change="added"
linkend="create_seam_proj"><diffmk:wrapper
diffmk:change="added">the steps to
proceed</diffmk:wrapper></link><diffmk:wrapper
diffmk:change="added">)</diffmk:wrapper></para></listitem>
+ </orderedlist>
+
+ <section diffmk:change="added"
id="create_dyn_web_proj_seam">
+ <title diffmk:change="added"><diffmk:wrapper
diffmk:change="added">Creating a Dynamic Web Project with Seam and JBoss
Portlet Capabilities</diffmk:wrapper></title>
+
+ <para diffmk:change="added"><diffmk:wrapper
diffmk:change="added">To create a dynamic Web project with Seam and JBoss
Portlet capabilities you should take the following
steps:</diffmk:wrapper></para>
+
+ <orderedlist continuation="restarts" diffmk:change="added"
inheritnum="ignore">
+ <listitem diffmk:change="added">
+ <para diffmk:change="added"><diffmk:wrapper
diffmk:change="added">In the </diffmk:wrapper><emphasis
diffmk:change="added"><property
moreinfo="none"><diffmk:wrapper
diffmk:change="changed">File</diffmk:wrapper></property></emphasis><diffmk:wrapper
diffmk:change="added"> menu, go to
+ </diffmk:wrapper><emphasis><property
moreinfo="none"><diffmk:wrapper diffmk:change="changed">New
> Other > Web > Dynamic Web
Project</diffmk:wrapper></property><diffmk:wrapper
diffmk:change="changed">.</diffmk:wrapper></emphasis><diffmk:wrapper
diffmk:change="added"> The </diffmk:wrapper><property
diffmk:change="added" moreinfo="none"><diffmk:wrapper
diffmk:change="added">New Dynamic Web
Project</diffmk:wrapper></property><diffmk:wrapper
diffmk:change="added">
+ wizard starts.</diffmk:wrapper></para>
+
+ <figure float="0">
+ <title><diffmk:wrapper diffmk:change="changed">Creating a
New Dynamic Web Project</diffmk:wrapper></title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/seam_portlet/seam_portlet1.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ </listitem>
+
+ <listitem diffmk:change="added">
+ <para diffmk:change="added"><diffmk:wrapper
diffmk:change="added">Give the project a name and follow the steps 3, 4, 5 of
the
+ </diffmk:wrapper><link diffmk:change="added"
linkend="jboss_core_portlet"><diffmk:wrapper
diffmk:change="added">"Creating a Web Project with JBoss Portlet
Capabilities"</diffmk:wrapper></link><diffmk:wrapper
diffmk:change="added"> procedure to set the target
runtime.</diffmk:wrapper></para>
+ </listitem>
+
+ <listitem diffmk:change="added">
+ <para><diffmk:wrapper diffmk:change="added">In the
</diffmk:wrapper><emphasis diffmk:change="added"><property
moreinfo="none"><diffmk:wrapper
diffmk:change="changed">Configuration</diffmk:wrapper></property></emphasis><diffmk:wrapper
diffmk:change="added"> area of the first wizard page,
+ select </diffmk:wrapper><emphasis diffmk:change="added">
+ <property moreinfo="none"><diffmk:wrapper
diffmk:change="changed">JBoss Seam Portlet Project
v2.0</diffmk:wrapper></property><diffmk:wrapper
diffmk:change="added">.</diffmk:wrapper></emphasis><diffmk:wrapper
diffmk:change="added"> It will add needed facets to the
project.</diffmk:wrapper></para>
+
+ <tip diffmk:change="added">
+ <title diffmk:change="added"><diffmk:wrapper
diffmk:change="added">Tip:</diffmk:wrapper></title>
+ <para diffmk:change="added"><diffmk:wrapper
diffmk:change="added">If you now click the
</diffmk:wrapper><emphasis diffmk:change="added"><property
diffmk:change="added" moreinfo="none"><diffmk:wrapper
diffmk:change="added">Modify</diffmk:wrapper></property></emphasis><diffmk:wrapper
diffmk:change="added"> button, you should see the
+ </diffmk:wrapper><emphasis
diffmk:change="added"><property diffmk:change="added"
moreinfo="none"><diffmk:wrapper
diffmk:change="added">JavaServer
Faces</diffmk:wrapper></property><diffmk:wrapper
diffmk:change="added">,</diffmk:wrapper></emphasis> <emphasis
diffmk:change="added"><property diffmk:change="added"
moreinfo="none"><diffmk:wrapper diffmk:change="added">Jboss
Portlets</diffmk:wrapper></property></emphasis><diffmk:wrapper
diffmk:change="added">
+ and </diffmk:wrapper><emphasis
diffmk:change="added"><property diffmk:change="added"
moreinfo="none"><diffmk:wrapper
diffmk:change="added">Seam</diffmk:wrapper></property></emphasis><diffmk:wrapper
diffmk:change="added"> facets enabled.</diffmk:wrapper></para>
+ </tip>
+
+ <figure float="0">
+ <title><diffmk:wrapper diffmk:change="changed">Project
Facets</diffmk:wrapper></title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/seam_portlet/seam_portlet2.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ </listitem>
+
+ <listitem diffmk:change="added">
+ <para><diffmk:wrapper diffmk:change="added">The next two
pages are for adjusting the project Java and Web modules.
+ They include the default values, so you can skip them by pressing
</diffmk:wrapper><emphasis diffmk:change="added">
+ <property diffmk:change="added"
moreinfo="none"><diffmk:wrapper
diffmk:change="added">Next</diffmk:wrapper></property><diffmk:wrapper
diffmk:change="added">.</diffmk:wrapper></emphasis></para>
+ </listitem>
+
+ <listitem diffmk:change="added">
+ <para diffmk:change="added"><diffmk:wrapper
diffmk:change="added">On the </diffmk:wrapper><property
diffmk:change="added" moreinfo="none"><diffmk:wrapper
diffmk:change="added">Jboss Portlet
Capabilities</diffmk:wrapper></property><diffmk:wrapper
diffmk:change="added"> page, select
+ </diffmk:wrapper><emphasis
diffmk:change="added"><property diffmk:change="added"
moreinfo="none"><diffmk:wrapper diffmk:change="added">Portlet
Target Runtime
Provider</diffmk:wrapper></property></emphasis><diffmk:wrapper
diffmk:change="added"> as the portlet implementation
library.</diffmk:wrapper></para>
+
+ <tip diffmk:change="added">
+ <title diffmk:change="added"><diffmk:wrapper
diffmk:change="added">Tip:</diffmk:wrapper></title>
+ <para diffmk:change="added"><diffmk:wrapper
diffmk:change="added">All types of the portlet implementation library are
described more closely in the wiki article at:
+ </diffmk:wrapper><ulink diffmk:change="added"
url="http://www.jboss.org/community/wiki/PortletFacetLibraries"...
diffmk:change="added">http://www.jboss.org/community/wiki/Po...
diffmk:change="added">.</diffmk:wrapper></para>
+ </tip>
+ </listitem>
+
+ <listitem diffmk:change="added">
+ <para diffmk:change="added"><diffmk:wrapper
diffmk:change="added">The next page is for configuring JSF capabilities. As
it contains the default values, just click
+ </diffmk:wrapper><emphasis
diffmk:change="added"><property diffmk:change="added"
moreinfo="none"><diffmk:wrapper
diffmk:change="added">Next</diffmk:wrapper></property></emphasis><diffmk:wrapper
diffmk:change="added"> to proceed.</diffmk:wrapper></para>
+ </listitem>
+
+ <listitem diffmk:change="added">
+ <para diffmk:change="added"><diffmk:wrapper
diffmk:change="added">On the </diffmk:wrapper><property
diffmk:change="added" moreinfo="none"><diffmk:wrapper
diffmk:change="added">Seam
Facet</diffmk:wrapper></property><diffmk:wrapper
diffmk:change="added"> page, set a Seam runtime and
+ a connection profile.</diffmk:wrapper></para>
+
+ <tip diffmk:change="added">
+ <title diffmk:change="added"><diffmk:wrapper
diffmk:change="added">Tip:</diffmk:wrapper></title>
+ <para diffmk:change="added"><diffmk:wrapper
diffmk:change="added">For details about how to set a Seam runtime and a
connection profile, see
+ </diffmk:wrapper><ulink diffmk:change="added"
url="../../seam/html_single/index.html#seamFacet"><diffmk:wrapper
diffmk:change="added">"Configure Seam Facet
Settings"</diffmk:wrapper></ulink><diffmk:wrapper
diffmk:change="added"> in the Chapter 2,
+ </diffmk:wrapper><ulink diffmk:change="added"
url="../../seam/html_single/index.html"><diffmk:wrapper
diffmk:change="added">"Seam Dev Tools Reference
Guide"</diffmk:wrapper></ulink><diffmk:wrapper
diffmk:change="added">.</diffmk:wrapper></para>
+ </tip>
+
+ <figure float="0">
+ <title><diffmk:wrapper diffmk:change="changed">Seam Facet
Settings</diffmk:wrapper></title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/seam_portlet/seam_portlet3.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ </listitem>
+
+ <listitem diffmk:change="added">
+ <para><diffmk:wrapper diffmk:change="changed">On the
</diffmk:wrapper><property moreinfo="none"><diffmk:wrapper
diffmk:change="changed">JBoss JSF Portlet
Capabilities</diffmk:wrapper></property><diffmk:wrapper
diffmk:change="added"> page, select the
+ </diffmk:wrapper><emphasis
diffmk:change="added"><property diffmk:change="added"
moreinfo="none"><diffmk:wrapper diffmk:change="added">JSF
Portlet Target Runtime
Provider</diffmk:wrapper></property></emphasis><diffmk:wrapper
diffmk:change="added"> type of the implementation
library.</diffmk:wrapper></para>
+
+ <tip diffmk:change="added">
+ <title diffmk:change="added"><diffmk:wrapper
diffmk:change="added">Tip:</diffmk:wrapper></title>
+ <para diffmk:change="added"><diffmk:wrapper
diffmk:change="added">If you have </diffmk:wrapper><property
moreinfo="none">JBoss Portlet Bridge</property><diffmk:wrapper
diffmk:change="added"> downloaded,
+ alternatively you can select </diffmk:wrapper><emphasis
diffmk:change="added"><property diffmk:change="added"
moreinfo="none"><diffmk:wrapper diffmk:change="added">JSF
Portletbridge Runtime
Provider</diffmk:wrapper></property></emphasis><diffmk:wrapper
diffmk:change="added"> and then provide a path to
+ the </diffmk:wrapper><property diffmk:change="added"
moreinfo="none"><diffmk:wrapper diffmk:change="added">JBoss
Portlet Bridge</diffmk:wrapper></property><diffmk:wrapper
diffmk:change="added"> distribution.</diffmk:wrapper></para>
+ </tip>
+
+ <figure float="0">
+ <title><diffmk:wrapper diffmk:change="changed">Setting
Portlet Bridge Provider</diffmk:wrapper></title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/jsf_portlet/jsf_portlet4.png"></imagedata>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para><diffmk:wrapper diffmk:change="added">It will add
</diffmk:wrapper><property diffmk:change="added"
moreinfo="none"><diffmk:wrapper diffmk:change="added">JBoss
Portlet Bridge</diffmk:wrapper></property><diffmk:wrapper
diffmk:change="added"> libraries to the project
classpath.</diffmk:wrapper></para>
+ </listitem>
+
+ <listitem diffmk:change="added">
+ <para><diffmk:wrapper diffmk:change="changed">Hit
</diffmk:wrapper><emphasis><property
moreinfo="none">Finish</property></emphasis><diffmk:wrapper
diffmk:change="changed"> to complete the project
creation.</diffmk:wrapper></para>
+ </listitem>
+ </orderedlist>
+ </section>
+
+ <section diffmk:change="added" id="create_seam_proj">
+ <title diffmk:change="added"><diffmk:wrapper
diffmk:change="added">Creating a Seam Project with JBoss Portlet
Capabilities</diffmk:wrapper></title>
+
+ <para diffmk:change="added"><diffmk:wrapper
diffmk:change="added">The steps to create a Seam project with JBoss Portlet
capabilities are as follows:</diffmk:wrapper></para>
+
+ <orderedlist continuation="restarts" diffmk:change="added"
inheritnum="ignore">
+ <listitem diffmk:change="added">
+ <para diffmk:change="added"><diffmk:wrapper
diffmk:change="added">In the </diffmk:wrapper><emphasis
diffmk:change="added"><property
moreinfo="none"><diffmk:wrapper
diffmk:change="changed">File</diffmk:wrapper></property></emphasis><diffmk:wrapper
diffmk:change="added"> menu, go to </diffmk:wrapper><emphasis>
+ <property moreinfo="none"><diffmk:wrapper
diffmk:change="changed">New > Other > Seam > Seam Web
Project</diffmk:wrapper></property>.</emphasis><diffmk:wrapper
diffmk:change="added"> The </diffmk:wrapper><property
diffmk:change="added" moreinfo="none"><diffmk:wrapper
diffmk:change="added">New Seam
Project</diffmk:wrapper></property><diffmk:wrapper
diffmk:change="added">
+ wizard appears.</diffmk:wrapper></para>
+ </listitem>
+
+ <listitem diffmk:change="added">
+ <para diffmk:change="added"><diffmk:wrapper
diffmk:change="added">Next steps are the same as in the
</diffmk:wrapper><link diffmk:change="added"
linkend="create_dyn_web_proj_seam"><diffmk:wrapper
diffmk:change="added">"Creating a Dynamic Web Project with Seam and
JBoss Portlet Capabilities"</diffmk:wrapper></link><diffmk:wrapper
diffmk:change="added">
+ procedure starting from the step 2.</diffmk:wrapper></para>
+ </listitem>
+ </orderedlist>
+ </section>
+ </section>
+
+ <section diffmk:change="added"
id="seam_portlet_to_seam_project">
+ <title diffmk:change="added"><diffmk:wrapper
diffmk:change="added">Adding a Seam Portlet to the Project and Deploying It
to JBoss Portal</diffmk:wrapper></title>
+
+ <para diffmk:change="added"><diffmk:wrapper
diffmk:change="added">The previous section has shown you how to create a Web
project with Seam and JBoss Portlet capabilities. Now you can create a Seam portlet
+ and deploy it to </diffmk:wrapper><property
diffmk:change="added" moreinfo="none"><diffmk:wrapper
diffmk:change="added">JBoss
Portal</diffmk:wrapper></property><diffmk:wrapper
diffmk:change="added"> by following the next
procedure:</diffmk:wrapper></para>
+
+ <orderedlist continuation="restarts" diffmk:change="added"
inheritnum="ignore">
+ <listitem diffmk:change="added">
+ <para diffmk:change="added"><diffmk:wrapper
diffmk:change="added">In the </diffmk:wrapper><emphasis
diffmk:change="added"><property diffmk:change="added"
moreinfo="none"><diffmk:wrapper
diffmk:change="added">File</diffmk:wrapper></property></emphasis><diffmk:wrapper
diffmk:change="added"> or context menu of the project go to
+ </diffmk:wrapper><emphasis
diffmk:change="added"><property diffmk:change="added"
moreinfo="none"><diffmk:wrapper diffmk:change="added">New
> Other > JBoss Tools Web > Portlet > JSF/Seam
+ Portlet</diffmk:wrapper></property><diffmk:wrapper
diffmk:change="added">.</diffmk:wrapper></emphasis></para>
+
+ <figure float="0">
+ <title><diffmk:wrapper diffmk:change="changed">Calling
the Create Portlet Wizard</diffmk:wrapper></title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/seam_portlet/seam_portlet5.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ </listitem>
+
+ <listitem diffmk:change="added">
+ <para><diffmk:wrapper diffmk:change="added">The
</diffmk:wrapper><property diffmk:change="added"
moreinfo="none"><diffmk:wrapper diffmk:change="added">Create
Portlet</diffmk:wrapper></property><diffmk:wrapper
diffmk:change="added"> wizard starts (for more information about wizard
options, see
+ </diffmk:wrapper><link diffmk:change="added"
linkend="jsf_seam_portlet_wizard"><diffmk:wrapper
diffmk:change="added">"JSF/Seam Portlet
Wizard"</diffmk:wrapper></link><diffmk:wrapper
diffmk:change="added"> in the guide reference).
+ As the Seam configuration is set for the project, the wizard puts the values
as for Seam portlet.</diffmk:wrapper></para>
+
+ <figure float="0">
+ <title><diffmk:wrapper diffmk:change="changed">Creating
Seam Portlet</diffmk:wrapper></title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/seam_portlet/seam_portlet6.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ </listitem>
+
+ <listitem diffmk:change="added">
+ <para><diffmk:wrapper diffmk:change="changed">Next two
pages are filled out with default values, just press
</diffmk:wrapper><emphasis><property diffmk:change="added"
moreinfo="none"><diffmk:wrapper
diffmk:change="added">Next</diffmk:wrapper></property></emphasis><diffmk:wrapper
diffmk:change="added"> to
+ proceed. On the last one click </diffmk:wrapper><emphasis
diffmk:change="added"><property
moreinfo="none">Finish</property></emphasis><diffmk:wrapper
diffmk:change="added"> to complete.</diffmk:wrapper></para>
+ </listitem>
+
+ <listitem diffmk:change="added">
+ <para diffmk:change="added"><diffmk:wrapper
diffmk:change="added">To deploy and run the portlet on
</diffmk:wrapper><property diffmk:change="added"
moreinfo="none"><diffmk:wrapper diffmk:change="added">JBoss
Portal</diffmk:wrapper></property><diffmk:wrapper
diffmk:change="added"> complete the steps described in the
+ </diffmk:wrapper><link
linkend="deploying_to_portal"><diffmk:wrapper
diffmk:change="changed">"Deploying a Portlet to JBoss
Portal"</diffmk:wrapper></link><diffmk:wrapper
diffmk:change="added"> procedure. Just use the following URL to see it in the
browser:
+ </diffmk:wrapper><emphasis
diffmk:change="added"><diffmk:wrapper
diffmk:change="added">http://localhost:8080/portal/portal/default/SeamPortlet</diffmk:wrapper></emphasis>.</para>
+
+ <figure float="0">
+ <title><diffmk:wrapper diffmk:change="changed">Seam
Portlet in the Browser Window</diffmk:wrapper></title>
+ <mediaobject>
+ <imageobject>
+ <imagedata
fileref="images/seam_portlet/seam_portlet7.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+ </listitem>
+ </orderedlist>
+ </section>
+ </section>
+</chapter>
+ <chapter id="reference" xreflabel="reference">
+ <?dbhtml filename="reference.html"?>
+ <title>Reference</title>
+
+ <para>This chapter includes detailed reference information about
<property>JBoss Portlet Tools</property>.</para>
+ <section id="project_overview">
+ <title>JBoss Portlet Descriptors</title>
+
+ <para>In order to a web project with portlets could be deployed to
<property>JBoss Portal</property>, it should include certain descriptors.
+ The next table lists and describes these configuration files.</para>
+
+ <table>
+ <title>JBoss Portlet Descriptors</title>
+ <tgroup cols="2">
+ <thead>
+ <row>
+ <entry>Name</entry>
+
+ <entry>Description</entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry>portlet.xml</entry>
+ <entry>The mandatory portlet descriptor defined by the <ulink
url="http://www.jcp.org/en/jsr/detail?id=168">JSR-168 Portlet
Specification</ulink>.
+ It is used during deployment.</entry>
+ </row>
+
+ <row>
+ <entry>portlet-instances.xml</entry>
+ <entry>The optional <property>JBoss Portal</property> specific
descriptor. It allows to create a portlet instance from a portlet class
definition.</entry>
+ </row>
+
+ <row>
+ <entry>*-object.xml</entry>
+ <entry>The optional <property>JBoss Portal</property> specific
descriptor. It helps define the layout of the portal.</entry>
+ </row>
+
+ <row>
+ <entry>jboss-portlet.xml</entry>
+ <entry>The optional <property>JBoss Portal</property> specific
descriptor. It allows to use JBoss
+ specific functionality within a portlet application.</entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </table>
+
+ <para>For more detail information about each descriptor, see
+ <ulink
url="http://docs.jboss.org/jbportal/v2.7.1/referenceGuide/html_singl...
Descriptors"</ulink> in Chapter 6,
+ <ulink
url="http://docs.jboss.org/jbportal/v2.7.1/referenceGuide/html_singl...
Portal Reference Guide"</ulink>.</para>
+ </section>
+
+ <section id="wizards">
+ <title>Wizards</title>
+ <para>This section describes the <property>JBoss Portlet
Tools</property> wizards:</para>
+ <itemizedlist>
+ <listitem><para><link linkend="java_portlet_wizard">Java
Portlet wizard</link></para></listitem>
+ <listitem><para><link
linkend="jsf_seam_portlet_wizard">JSF/Seam Portlet
wizard</link></para></listitem>
+ </itemizedlist>
+
+ <section id="java_portlet_wizard">
+ <title>Java Portlet Wizard</title>
+
+ <para>The <property>Java Portlet</property> wizard helps you create
a new Java portlet (1.0 or 2.0). It is based on the WTP's Create Servlet wizard,
+ but adapted to JBoss Portlet. You can call it from the
<emphasis><property>File</property></emphasis> or context menu of
your project by following to
+ <emphasis><property>New > Other > JBoss Tools Web >
Portlet > Java Portlet</property>.</emphasis></para>
+
+ <para>The wizard consists of the four pages:</para>
+
+ <orderedlist>
+ <listitem>
+ <para>The first one includes the next options to adjust:</para>
+
+ <table>
+ <title>Java Portlet Wizard. First Page Options.</title>
+ <tgroup cols="3">
+ <colspec colnum="1" align="left"
colwidth="1*"/>
+ <colspec colnum="2" colwidth="3*"/>
+ <colspec colnum="3" align="left"
colwidth="1*"/>
+
+ <thead>
+ <row>
+ <entry>Option</entry>
+ <entry>Description</entry>
+ <entry>Default</entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry>Project</entry>
+ <entry>Select the project to add a new Java portlet</entry>
+ <entry>The project selected when the wizard has been
started</entry>
+ </row>
+
+ <row>
+ <entry>Source folder</entry>
+ <entry>The path to the source folder relative to the selected
project</entry>
+ <entry>The source folder of the project selected in the
<emphasis><property>Project</property></emphasis>
field</entry>
+ </row>
+
+ <row>
+ <entry>Java package</entry>
+ <entry>Enter a package to contain a new portlet. Either type a valid
package name or click
+ <emphasis><property>Browse</property></emphasis> to
select a package via the dialog box.</entry>
+ <entry><blank></entry>
+ </row>
+
+ <row>
+ <entry>Class name</entry>
+ <entry>Type a name for a new Java portlet class</entry>
+ <entry><blank></entry>
+ </row>
+
+ <row>
+ <entry>Superclass</entry>
+ <entry>Type or click
<emphasis><property>Browse</property></emphasis> to select a
superclass for a Java portlet class</entry>
+ <entry>javax.portlet.GenericPortlet</entry>
+ </row>
+
+ <row>
+ <entry>Use an existing Portlet class</entry>
+ <entry>Select this check box if you want to use an existing Java portlet
class. In the appeared
+ <emphasis><property>Class name</property></emphasis>
field type or
+ click <emphasis><property>Browse</property></emphasis>
to select an existing portlet class.</entry>
+ <entry>Cleared</entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </table>
+ </listitem>
+
+ <listitem>
+ <para>The second wizard page is for specifying modifiers, interfaces to
implement and method stubs to generate.</para>
+
+ <figure>
+ <title>Second Page of the Java Portlet Wizard</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/reference/javaPortlet2.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para>The descriptions of the options listed on this page are in the following
table.</para>
+
+ <table>
+ <title>Java Portlet Wizard. Second Page Options.</title>
+ <tgroup cols="3">
+ <colspec colnum="1" align="left"
colwidth="1*"/>
+ <colspec colnum="2" align="left"
colwidth="3*"/>
+ <colspec colnum="3" align="left"
colwidth="1*"/>
+
+ <thead>
+ <row>
+ <entry>Option</entry>
+ <entry>Description</entry>
+ <entry>Default</entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry>Modifiers</entry>
+ <entry>Select one or more access modifiers for a new Java portlet class:
+ <itemizedlist>
+ <listitem><para>Public</para></listitem>
+ <listitem><para>Abstract</para></listitem>
+ <listitem><para>Final</para></listitem>
+ </itemizedlist>
+ </entry>
+ <entry>Public</entry>
+ </row>
+
+ <row>
+ <entry>Interfaces</entry>
+ <entry>Click
<emphasis><property>Add</property></emphasis> to choose interfaces
that a new class implements</entry>
+ <entry><blank></entry>
+ </row>
+
+ <row>
+ <entry>Which method stubs would you like to create?</entry>
+ <entry>Choose which methods from superclass to override in the Java
portlet class:
+ <itemizedlist>
+ <listitem><para>Constructors from
superclass</para></listitem>
+ <listitem><para>Inherited abstract
methods</para></listitem>
+ <listitem><para>init</para></listitem>
+ <listitem><para>doView</para></listitem>
+ <listitem><para>doDispatch</para></listitem>
+ <listitem><para>destroy</para></listitem>
+ <listitem><para>doEdit</para></listitem>
+ <listitem><para>processAction</para></listitem>
+ <listitem><para>getPortletConfig</para></listitem>
+ <listitem><para>doHelp</para></listitem>
+ <listitem><para>render</para></listitem>
+ </itemizedlist>
+ </entry>
+ <entry>Inherited abstract methods, doView</entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </table>
+ </listitem>
+
+ <listitem>
+ <para>The third page is for adjusting the portlet deployment descriptor
settings.</para>
+
+ <figure>
+ <title>Third Page of the Java Portlet Wizard</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/reference/javaPortlet3.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <table>
+ <title>Java Portlet Wizard. Third Page Options.</title>
+ <tgroup cols="3">
+ <colspec colnum="1" align="left"
colwidth="1*"/>
+ <colspec colnum="2" align="left"
colwidth="3*"/>
+ <colspec colnum="3" align="left"
colwidth="1*"/>
+
+ <thead>
+ <row>
+ <entry>Option</entry>
+ <entry>Description</entry>
+ <entry>Default</entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry>Name</entry>
+ <entry>Enter the portlet name. It does not have to be the portlet class
name.</entry>
+ <entry>The name of the portlet class</entry>
+ </row>
+
+ <row>
+ <entry>Display name</entry>
+ <entry>Enter the display name of the Java portlet</entry>
+ <entry>The name of the portlet class</entry>
+ </row>
+
+ <row>
+ <entry>Title</entry>
+ <entry>Enter the title of the portlet</entry>
+ <entry>The name of the portlet class</entry>
+ </row>
+
+ <row>
+ <entry>Description</entry>
+ <entry>Enter the description of the portlet's
function</entry>
+ <entry><blank></entry>
+ </row>
+
+ <row>
+ <entry>Portlet Modes</entry>
+ <entry>Select one or more of three modes defined by the JSR-286
specification:
+ <itemizedlist>
+ <listitem><para><emphasis>View</emphasis> - generates
markup reflecting the current state of the portlet;</para></listitem>
+ <listitem><para><emphasis>Edit</emphasis> - allows
customizing the behavior of the portlet;</para></listitem>
+ <listitem><para><emphasis>Help</emphasis> - provides
an information on how to use the portlet.</para></listitem>
+ </itemizedlist>
+ </entry>
+ <entry>View</entry>
+ </row>
+
+ <row>
+ <entry>Initialization Parameters</entry>
+ <entry>Specify initialization parameters to create an initial state inside
your portlet class. Click
+ <emphasis><property>Add</property></emphasis> and fill
in the
+ <emphasis><property>Name</property>,</emphasis>
<emphasis><property>Value</property></emphasis> and
+ <emphasis><property>Description</property></emphasis>
(optional) fields to set a parameter.</entry>
+ <entry><blank></entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </table>
+
+ </listitem>
+
+ <listitem>
+ <para>The last wizard page helps configure the JBoss Portlet specific
descriptors.</para>
+
+ <figure>
+ <title>Last Page of the Java Portlet Wizard</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/reference/javaPortlet4.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <table>
+ <title>Java Portlet Wizard. Last Page Options.</title>
+ <tgroup cols="3">
+ <colspec colnum="1" align="left"
colwidth="1*"/>
+ <colspec colnum="2" align="left"
colwidth="3*"/>
+ <colspec colnum="3" align="left"
colwidth="1*"/>
+
+ <thead>
+ <row>
+ <entry>Option</entry>
+ <entry>Description</entry>
+ <entry>Default</entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry>Create Portlet Instance</entry>
+ <entry>Clear the <emphasis><property>Create Portlet
Instance</property></emphasis> check box,
+ if you don't wont the wizard to create the deployment elements
+ in the <literal>default-object.xml</literal> and <literal>
+ portlet-instances.xml</literal> files</entry>
+ <entry>Selected</entry>
+ </row>
+
+ <row>
+ <entry>If Exists</entry>
+ <entry>Select one of two options:
+ <itemizedlist>
+ <listitem><para><emphasis>overwrite</emphasis> -
destroys the existing object and creates a new one based on the content of the
deployment</para></listitem>
+ <listitem><para><emphasis>keep</emphasis> - maintains
the existing object deployment or creates a new one if it does not
exist</para></listitem>
+ </itemizedlist>
+ </entry>
+ <entry>overwrite</entry>
+ </row>
+
+ <row>
+ <entry>Instance Name</entry>
+ <entry>Enter a name of the portlet instance that the portlet window
represents</entry>
+ <entry>[Portlet class name]Instance</entry>
+ </row>
+
+ <row>
+ <entry>Page Name</entry>
+ <entry>If set, the portlet page is created with the name
defined</entry>
+ <entry><blank></entry>
+ </row>
+
+ <row>
+ <entry>Window Name</entry>
+ <entry>Enter a name of the portlet window</entry>
+ <entry>[Portlet class name]Window</entry>
+ </row>
+
+ <row>
+ <entry>Parent Reference</entry>
+ <entry>
+ <para>Define a reference to the parent object. The syntax for this
element is <literal>[portal-instance].[portal-page]</literal>.</para>
+ <para>For example, <literal>default.default</literal> means
that the window appears on the default page, in the default portal.</para>
+ </entry>
+ <entry>default.default</entry>
+ </row>
+
+ <row>
+ <entry>Region</entry>
+ <entry>Specify the region where the window should appear on the
page</entry>
+ <entry>center</entry>
+ </row>
+
+ <row>
+ <entry>Height</entry>
+ <entry>Define the height of the window</entry>
+ <entry>1</entry>
+ </row>
+
+ <row>
+ <entry>Initial Window State</entry>
+ <entry>Set the window state indicator by selecting one of three states
defined by the JSR-168 specification:
+ <itemizedlist>
+ <listitem><para><emphasis>normal</emphasis> - a
portlet shares this page with other portlets</para></listitem>
+ <listitem><para><emphasis>minimized</emphasis> - a
portlet may show very little information or none at all</para></listitem>
+ <listitem><para><emphasis>maximized</emphasis> - a
portlet may be the only portlet displayed on this page</para></listitem>
+ </itemizedlist>
+ </entry>
+ <entry>maximized</entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </table>
+ </listitem>
+ </orderedlist>
+ </section>
+
+ <section id="jsf_seam_portlet_wizard">
+ <title>JSF/Seam Portlet Wizard</title>
+
+ <para>The <property>JSF/Seam Portlet</property> wizard, that is
merged into one JSF and Seam Portlet wizards, helps you create a
+ JSF/Seam portlet that uses the <property>JBoss Portlet Bridge</property>
libraries. The default values in this wizard
+ depend on the configuration set for the project. For instance, if you set the JSF
configuration, the default values in this wizard will be
+ as for a JSF portlet.</para>
+
+ <para>The <property>JSF/Seam Portlet</property> wizard could be
started from the <emphasis><property>File</property></emphasis> or
+ context menu of your project by following to
+ <emphasis><property>New > Other > JBoss Tools Web >
Portlet > JSF/Seam Portlet</property>.</emphasis></para>
+
+ <para>The wizard includes three pages to adjust JSF/Seam portlet
setting:</para>
+
+ <orderedlist>
+ <listitem>
+ <para>The first wizard page asks to select a project to add JSF/Seam portlet
and set a class file destination.</para>
+
+ <figure>
+ <title>First Page of the JSF Portlet Wizard</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/reference/jsf_seam_portlet1.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <table>
+ <title>JSF/Seam Portlet Wizard. First Page Options.</title>
+ <tgroup cols="3">
+ <colspec colnum="1" align="left"
colwidth="1*"/>
+ <colspec colnum="2" align="left"
colwidth="3*"/>
+ <colspec colnum="3" align="left"
colwidth="1*"/>
+
+ <thead>
+ <row>
+ <entry>Option</entry>
+ <entry>Description</entry>
+ <entry>Default</entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry>Project</entry>
+ <entry>Select the project to add a new JSF/Seam portlet</entry>
+ <entry>The project selected when the wizard has been
started</entry>
+ </row>
+
+ <row>
+ <entry>Class name</entry>
+ <entry>Type or click
<emphasis><property>Browse</property></emphasis> to select a class
for a JSF/Seam portlet</entry>
+ <entry>javax.portlet.faces.GenericFacesPortlet</entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </table>
+ </listitem>
+
+ <listitem>
+ <para>The second page allows to configure a portlet deployment
descriptors.</para>
+
+ <figure>
+ <title>Second Page of the JSF Portlet Wizard</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/reference/jsf_seam_portlet2.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <table>
+ <title>JSF/Seam Portlet Wizard. Second Page Options.</title>
+ <tgroup cols="3">
+ <colspec colnum="1" align="left"
colwidth="1*"/>
+ <colspec colnum="2" align="left"
colwidth="3*"/>
+ <colspec colnum="3" align="left"
colwidth="1*"/>
+
+ <thead>
+ <row>
+ <entry>Option</entry>
+ <entry>Description</entry>
+ <entry>Default (JSF / Seam)</entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry>Name</entry>
+ <entry>Enter the portlet name. It does not have to be the portlet class
name.</entry>
+ <entry>riPortlet / seamPortlet</entry>
+ </row>
+
+ <row>
+ <entry>Display name</entry>
+ <entry>Enter the display name of the Java portlet</entry>
+ <entry>JBoss JSF Portlet / JBoss Seam Portlet</entry>
+ </row>
+
+ <row>
+ <entry>Title</entry>
+ <entry>Enter the title of the portlet</entry>
+ <entry>JBoss JSF Portlet / JBoss Seam Portlet</entry>
+ </row>
+
+ <row>
+ <entry>Description</entry>
+ <entry>Enter the description of the portlet's
function</entry>
+ <entry><blank></entry>
+ </row>
+
+ <row>
+ <entry>Portlet Modes</entry>
+ <entry>Select one or more of three modes defined by the JSR-286
specification:
+ <itemizedlist>
+ <listitem><para><emphasis>View</emphasis> - generates
markup reflecting the current state of the portlet</para></listitem>
+ <listitem><para><emphasis>Edit</emphasis> - allows
customizing the behavior of the portlet</para></listitem>
+ <listitem><para><emphasis>Help</emphasis> - provides
an information on how to use the portlet</para></listitem>
+ </itemizedlist>
+ </entry>
+ <entry>View, Edit, Help / View</entry>
+ </row>
+
+ <row>
+ <entry>Initialization Parameters</entry>
+ <entry>Specify initialization parameters to create an initial state inside
your portlet class. Click
+ <emphasis><property>Add</property></emphasis> and fill
in the
+ <emphasis><property>Name</property>,</emphasis>
<emphasis><property>Value</property></emphasis> and
+ <emphasis><property>Description</property></emphasis>
(optional) fields to set a parameter.</entry>
+ <entry>javax.portlet.faces.defaultViewId.view,
javax.portlet.faces.defaultViewId.edit,
+ javax.portlet.faces.defaultViewId.help /
javax.portlet.faces.defaultViewId.view</entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </table>
+ </listitem>
+
+ <listitem>
+ <para>The last wizard page helps you configure the JBoss Portlet specific
information.</para>
+
+ <figure>
+ <title>Third Page of the JSF Portlet Wizard</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/reference/jsf_seam_portlet3.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <table>
+ <title>JSF/Seam Portlet Wizard. Third Page Options.</title>
+ <tgroup cols="3">
+ <colspec colnum="1" align="left"
colwidth="1*"/>
+ <colspec colnum="2" align="left"
colwidth="3*"/>
+ <colspec colnum="3" align="left"
colwidth="1*"/>
+
+ <thead>
+ <row>
+ <entry>Option</entry>
+ <entry>Description</entry>
+ <entry>Default (JSF / Seam)</entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry>Create Portlet Instance</entry>
+ <entry>Clear the <emphasis><property>Create Portlet
Instance</property></emphasis> check box,
+ if you don't wont the wizard to create the deployment elements
+ in the <literal>default-object.xml</literal> and <literal>
+ portlet-instances.xml</literal> files</entry>
+ <entry>Selected</entry>
+ </row>
+
+ <row>
+ <entry>If Exists</entry>
+ <entry>Select one of two options:
+ <itemizedlist>
+ <listitem><para><emphasis>overwrite</emphasis> -
destroys the existing object and creates a new one based on the content of the
deployment</para></listitem>
+ <listitem><para><emphasis>keep</emphasis> - maintains
the existing object deployment or creates a new one if it does not
exist</para></listitem>
+ </itemizedlist>
+ </entry>
+ <entry>overwrite</entry>
+ </row>
+
+ <row>
+ <entry>Instance Name</entry>
+ <entry>Enter a name of the portlet instance that the portlet window
represents</entry>
+ <entry>JSFPortletInstance / SeamPortletInstance</entry>
+ </row>
+
+ <row>
+ <entry>Page Name</entry>
+ <entry>If set, the portlet page is created with the name
defined</entry>
+ <entry>JSFPortlet / SeamPortlet</entry>
+ </row>
+
+ <row>
+ <entry>Window Name</entry>
+ <entry>Enter a name of the portlet window</entry>
+ <entry>JSFPortletWindow / SeamPortletWindow</entry>
+ </row>
+
+ <row>
+ <entry>Parent Reference</entry>
+ <entry>
+ <para>Define a reference to the parent object.</para>
+ <para>For example, <literal>default</literal> means that the
page appears in the default portal.</para>
+ </entry>
+ <entry>default</entry>
+ </row>
+
+ <row>
+ <entry>Region</entry>
+ <entry>Specify the region where the window should appear on the
page</entry>
+ <entry>center</entry>
+ </row>
+
+ <row>
+ <entry>Height</entry>
+ <entry>Define the height of the window</entry>
+ <entry>1</entry>
+ </row>
+
+ <row>
+ <entry>Initial Window State</entry>
+ <entry>Set the window state indicator by selecting one of three states
defined by the JSR-168 specification:
+ <itemizedlist>
+ <listitem><para><emphasis>normal</emphasis> - a
portlet shares this page with other portlets</para></listitem>
+ <listitem><para><emphasis>minimized</emphasis> - a
portlet may show very little information or none at all</para></listitem>
+ <listitem><para><emphasis>maximized</emphasis> - a
portlet may be the only portlet displayed on this page</para></listitem>
+ </itemizedlist>
+ </entry>
+ <entry>maximized</entry>
+ </row>
+
+ <row>
+ <entry>Create JBoss Application</entry>
+ <entry>
+ <para>Select to add the <literal>jboss-app.xml</literal>
descriptor.</para>
+ <para><emphasis>riPortletApp / seamPortletApp</emphasis> -
the default name of the JBoss application. You can change it by
+ typing a new one in the <emphasis><property>JBoss Application
Name</property></emphasis> field.</para>
+ </entry>
+ <entry>Selected</entry>
+ </row>
+
+ <row>
+ <entry>Add the jboss-portlet.xml file</entry>
+ <entry>Select to create the
<literal>jboss-portlet.xml</literal> file</entry>
+ <entry>Selected</entry>
+ </row>
+
+ <row>
+ <entry>Copy JSF Templates</entry>
+ <entry>Select to add the folder with JSF templates
(<literal>edit.jsp</literal>, <literal>help.jsp</literal>,
+ <literal>view.jsp</literal>) to the project</entry>
+ <entry>Cleared</entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </table>
+ </listitem>
+ </orderedlist>
+ </section>
+ </section>
+
+ <section id="preferences">
+ <title>JBoss Portlet Preferences</title>
+
+ <para>To open <property>JBoss Portlet Preferences</property> property
sheet, go to <emphasis>
+ <property>Window > Preferences</property>
+ </emphasis> and then <emphasis>
+ <property>JBoss Tools > JBoss Portlet</property>.
+ </emphasis></para>
+
+ <figure>
+ <title>JBoss Runtime Preferences</title>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="images/reference/portlet_preferences.png"/>
+ </imageobject>
+ </mediaobject>
+ </figure>
+
+ <para>The <emphasis>
+ <property>Check runtimes for Portlet Components</property>
+ </emphasis> option makes the JBoss Portlet functionality always visible no matter
what the runtime is set. By default the option is checked.</para>
+ </section>
+</chapter>
+<chapter diffmk:change="added" id="summary"
xml:base="file:///home/vchukhutsina/repos/ochik_jboss/portlet/docs/reference/en/modules/summary.xml"
xreflabel="summary">
+ <?dbhtml filename="summary.html"?>
+ <title><diffmk:wrapper
diffmk:change="changed">Summary</diffmk:wrapper></title>
+
+ <para><diffmk:wrapper diffmk:change="changed">In conclusion, with
this document you could easily get started with </diffmk:wrapper><property
moreinfo="none"><diffmk:wrapper
diffmk:change="changed">JBoss
+ Portlet Tools</diffmk:wrapper></property><diffmk:wrapper
diffmk:change="changed">.
+ The above chapters walked you through the steps on how to organize a web project with
+ JBoss Portlet capabilities enabled, create a Java portlet, JSF or Seam portlet and
deploy them to </diffmk:wrapper><property
moreinfo="none"><diffmk:wrapper
diffmk:change="changed">JBoss
+ Portal</diffmk:wrapper></property><diffmk:wrapper
diffmk:change="changed">. The document also includes the reference of
</diffmk:wrapper><property moreinfo="none"><diffmk:wrapper
diffmk:change="changed">JBoss Portlet
Tools</diffmk:wrapper></property><diffmk:wrapper
diffmk:change="changed"> features.</diffmk:wrapper></para>
+
+ <para>If you have questions or suggestions concerned both the documentation and
tools behavior, you are welcome
+ to <ulink
url="http://www.jboss.com/index.html?module=bb&op=viewforum&...
Tools Users forum</ulink>.</para>
+ <para diffmk:change="added"><diffmk:wrapper
diffmk:change="added">Please, use </diffmk:wrapper><ulink
diffmk:change="added"
url="https://jira.jboss.org/jira/browse/JBDS"><diffmk:wra...
diffmk:change="added">Jira</diffmk:wrapper></ulink><diffmk:wrapper
diffmk:change="added"> to report bugs and requests on
documentation.</diffmk:wrapper></para>
+
+ <section diffmk:change="added" id="rel_resources">
+ <title diffmk:change="added"><diffmk:wrapper
diffmk:change="added">Other Relevant Resources on the
Topic</diffmk:wrapper></title>
+
+ <itemizedlist diffmk:change="added">
+ <listitem diffmk:change="added">
+ <para diffmk:change="added"><diffmk:wrapper
diffmk:change="added">
+ JBoss Portal home page: </diffmk:wrapper><ulink
diffmk:change="added"
url="http://www.jboss.org/jbossportal/"><diffmk:wrapper
diffmk:change="added">http://www.jboss.org/jbossportal/</...
+ </para>
+ </listitem>
+
+ <listitem diffmk:change="added">
+ <para diffmk:change="added"><diffmk:wrapper
diffmk:change="added">
+ JBoss Portal Wiki at: </diffmk:wrapper><ulink
diffmk:change="added"
url="http://wiki.jboss.org/wiki/JBossPortal"><diffmk:wrapper
diffmk:change="added">http://wiki.jboss.org/wiki/JBossPortal...
+ </para>
+ </listitem>
+
+ <listitem diffmk:change="added">
+ <para diffmk:change="added"><diffmk:wrapper
diffmk:change="added">JBoss Portal documentation set at:
</diffmk:wrapper><ulink diffmk:change="added"
url="http://docs.jboss.org/jbportal/"><diffmk:wrapper
diffmk:change="added">http://docs.jboss.org/jbportal/</di...
+ </listitem>
+
+ <listitem diffmk:change="added">
+ <para diffmk:change="added"><diffmk:wrapper
diffmk:change="added">
+ JBoss Tools home page at: </diffmk:wrapper><ulink
diffmk:change="added"
url="http://www.jboss.org/tools/"><diffmk:wrapper
diffmk:change="added">http://www.jboss.org/tools/</diffmk...
+ </para>
+ </listitem>
+
+ <listitem diffmk:change="added">
+ <para diffmk:change="added"><diffmk:wrapper
diffmk:change="added">
+ The latest JBossTools/JBDS documentation builds at: </diffmk:wrapper><ulink
diffmk:change="added"
url="http://download.jboss.org/jbosstools/nightly-docs/"><...
diffmk:change="added">http://download.jboss.org/jbosstools/n...
+ </para>
+ </listitem>
+
+ <listitem diffmk:change="added">
+ <para diffmk:change="added"><diffmk:wrapper
diffmk:change="added">JBoss Developer Studio/JBoss Tools release
documentation you can
+ find at </diffmk:wrapper><ulink diffmk:change="added"
url="http://docs.jboss.org/tools/"><diffmk:wrapper
diffmk:change="added">http://docs.jboss.org/tools</diffmk...
diffmk:change="added"> in the corresponding release
directory.</diffmk:wrapper></para>
+ </listitem>
+ </itemizedlist>
+
+ </section>
+</chapter>
+</book>