May 2009 - jbosstools-commits - Jboss List Archives

JBoss Tools SVN: r15163 - tags/jbpm-jpdl-4.0.0.beta2.

by jbosstools-commits＠lists.jboss.org

Author: koen.aers(a)jboss.com Date: 2009-05-11 11:48:20 -0400 (Mon, 11 May 2009) New Revision: 15163 Added: tags/jbpm-jpdl-4.0.0.beta2/org.jboss.tools.flow.jpdl4/ Log: 4.0.0.beta2 release Copied: tags/jbpm-jpdl-4.0.0.beta2/org.jboss.tools.flow.jpdl4 (from rev 15162, trunk/jbpm/plugins/org.jboss.tools.flow.jpdl4)

15 years, 1 month

1
0
0 / 0

JBoss Tools SVN: r15162 - tags/jbpm-jpdl-4.0.0.beta2.

by jbosstools-commits＠lists.jboss.org

Author: koen.aers(a)jboss.com Date: 2009-05-11 11:48:00 -0400 (Mon, 11 May 2009) New Revision: 15162 Added: tags/jbpm-jpdl-4.0.0.beta2/org.jboss.tools.flow.jpdl4.feature/ Log: 4.0.0.beta2 release Copied: tags/jbpm-jpdl-4.0.0.beta2/org.jboss.tools.flow.jpdl4.feature (from rev 15161, trunk/jbpm/features/org.jboss.tools.flow.jpdl4.feature)

15 years, 1 month

1
0
0 / 0

JBoss Tools SVN: r15161 - tags/jbpm-jpdl-4.0.0.beta2.

by jbosstools-commits＠lists.jboss.org

Author: koen.aers(a)jboss.com Date: 2009-05-11 11:47:09 -0400 (Mon, 11 May 2009) New Revision: 15161 Added: tags/jbpm-jpdl-4.0.0.beta2/org.jboss.tools.flow.common/ Log: 4.0.0.beta2 release Copied: tags/jbpm-jpdl-4.0.0.beta2/org.jboss.tools.flow.common (from rev 15160, trunk/flow/plugins/org.jboss.tools.flow.common)

15 years, 1 month

1
0
0 / 0

JBoss Tools SVN: r15160 - branches/jbosstools-3.0.x/documentation/jbds-docs.

by jbosstools-commits＠lists.jboss.org

Author: smukhina Date: 2009-05-11 11:46:42 -0400 (Mon, 11 May 2009) New Revision: 15160 Added: branches/jbosstools-3.0.x/documentation/jbds-docs/all-guides.xml branches/jbosstools-3.0.x/documentation/jbds-docs/clean.sh branches/jbosstools-3.0.x/documentation/jbds-docs/pom.xml branches/jbosstools-3.0.x/documentation/jbds-docs/settings.xml Removed: branches/jbosstools-3.0.x/documentation/jbds-docs/all-guides.xml branches/jbosstools-3.0.x/documentation/jbds-docs/clean.sh branches/jbosstools-3.0.x/documentation/jbds-docs/pom.xml branches/jbosstools-3.0.x/documentation/jbds-docs/settings.xml Log: https://jira.jboss.org/jira/browse/JBDS-717 merged changes from trunk are added to the corresponding branch Deleted: branches/jbosstools-3.0.x/documentation/jbds-docs/all-guides.xml =================================================================== --- branches/jbosstools-3.0.x/documentation/jbds-docs/all-guides.xml 2009-05-11 15:46:31 UTC (rev 15159) +++ branches/jbosstools-3.0.x/documentation/jbds-docs/all-guides.xml 2009-05-11 15:46:42 UTC (rev 15160) @@ -1,272 +0,0 @@ -<?xml version="1.0" encoding="UTF-8"?> -<assembly> - <id>all-guides</id> - - <formats> - <format>dir</format> - </formats> - <includeBaseDirectory>false</includeBaseDirectory> - <fileSets> - <fileSet> - <directory>index/target/docbook/publish/en-US/html_single/</directory> - <outputDirectory>../</outputDirectory> - <filtered>false</filtered> - <lineEnding>keep</lineEnding> - <includes> - <include>index.html</include> - </includes> - <useStrictFiltering>false</useStrictFiltering> - <useDefaultExcludes>true</useDefaultExcludes> - <fileMode>0644</fileMode> - <directoryMode>0755</directoryMode> - </fileSet> - - - <fileSet> - <directory>../guides/Exadel-migration/target/docbook/publish/en-US</directory> - <outputDirectory>/Exadel-migration</outputDirectory> - <filtered>false</filtered> - <lineEnding>keep</lineEnding> - <includes> - <include>**/*.*</include> - </includes> - <useStrictFiltering>false</useStrictFiltering> - <useDefaultExcludes>true</useDefaultExcludes> - <fileMode>0644</fileMode> - <directoryMode>0755</directoryMode> - </fileSet> - <fileSet> - <directory>../guides/GettingStartedGuide/target/docbook/publish/en-US</directory> - <outputDirectory>/GettingStartedGuide</outputDirectory> - <filtered>false</filtered> - <lineEnding>keep</lineEnding> - <includes> - <include>**/*.*</include> - </includes> - <useStrictFiltering>false</useStrictFiltering> - <useDefaultExcludes>true</useDefaultExcludes> - <fileMode>0644</fileMode> - <directoryMode>0755</directoryMode> - </fileSet> -  - - <fileSet> - <directory>../../as/docs/reference/target/docbook/publish/en-US</directory> - <outputDirectory>/as</outputDirectory> - <filtered>false</filtered> - <lineEnding>keep</lineEnding> - <includes> - <include>**/*.*</include> - </includes> - <useStrictFiltering>false</useStrictFiltering> - <useDefaultExcludes>true</useDefaultExcludes> - <fileMode>0644</fileMode> - <directoryMode>0755</directoryMode> - </fileSet> - <fileSet> - <directory>../../hibernatetools/docs/reference/target/docbook/publish/en-US</directory> - <outputDirectory>/hibernatetools</outputDirectory> - <filtered>false</filtered> - <lineEnding>keep</lineEnding> - <includes> - <include>**/*.*</include> - </includes> - <useStrictFiltering>false</useStrictFiltering> - <useDefaultExcludes>true</useDefaultExcludes> - <fileMode>0644</fileMode> - <directoryMode>0755</directoryMode> - </fileSet> - <fileSet> - <directory>../../jbpm/docs/reference/target/docbook/publish/en-US</directory> - <outputDirectory>/jboss_jbpm_ref_guide</outputDirectory> - <filtered>false</filtered> - <lineEnding>keep</lineEnding> - <includes> - <include>**/*.*</include> - </includes> - <useStrictFiltering>false</useStrictFiltering> - <useDefaultExcludes>true</useDefaultExcludes> - <fileMode>0644</fileMode> - <directoryMode>0755</directoryMode> - </fileSet> - <fileSet> - <directory>../../jbpm/docs/converter_ref/target/docbook/publish/en-US</directory> - <outputDirectory>/jboss_bpmn_convert_ref_guide</outputDirectory> - <filtered>false</filtered> - <lineEnding>keep</lineEnding> - <includes> - <include>**/*.*</include> - </includes> - <useStrictFiltering>false</useStrictFiltering> - <useDefaultExcludes>true</useDefaultExcludes> - <fileMode>0644</fileMode> - <directoryMode>0755</directoryMode> - </fileSet> - <fileSet> - <directory>../../jsf/docs/userguide/target/docbook/publish/en-US</directory> - <outputDirectory>/jsf</outputDirectory> - <filtered>false</filtered> - <lineEnding>keep</lineEnding> - <includes> - <include>**/*.*</include> - </includes> - <useStrictFiltering>false</useStrictFiltering> - <useDefaultExcludes>true</useDefaultExcludes> - <fileMode>0644</fileMode> - <directoryMode>0755</directoryMode> - </fileSet> - <fileSet> - <directory>../../seam/docs/reference/target/docbook/publish/en-US</directory> - <outputDirectory>/seam</outputDirectory> - <filtered>false</filtered> - <lineEnding>keep</lineEnding> - <includes> - <include>**/*.*</include> - </includes> - <useStrictFiltering>false</useStrictFiltering> - <useDefaultExcludes>true</useDefaultExcludes> - <fileMode>0644</fileMode> - <directoryMode>0755</directoryMode> - </fileSet> - <fileSet> - <directory>../../jsf/docs/jsf_tools_ref_guide/target/docbook/publish/en-US</directory> - <outputDirectory>/jsf_tools_ref_guide</outputDirectory> - <filtered>false</filtered> - <lineEnding>keep</lineEnding> - <includes> - <include>**/*.*</include> - </includes> - <useStrictFiltering>false</useStrictFiltering> - <useDefaultExcludes>true</useDefaultExcludes> - <fileMode>0644</fileMode> - <directoryMode>0755</directoryMode> - </fileSet> - - <fileSet> - <directory>../../jsf/docs/jsf_tools_tutorial/target/docbook/publish/en-US</directory> - <outputDirectory>/jsf_tools_tutorial</outputDirectory> - <filtered>false</filtered> - <lineEnding>keep</lineEnding> - <includes> - <include>**/*.*</include> - </includes> - <useStrictFiltering>false</useStrictFiltering> - <useDefaultExcludes>true</useDefaultExcludes> - <fileMode>0644</fileMode> - <directoryMode>0755</directoryMode> - </fileSet> - - <fileSet> - <directory>../../struts/docs/struts_tools_tutorial/target/docbook/publish/en-US</directory> - <outputDirectory>/struts_tools_tutorial</outputDirectory> - <filtered>false</filtered> - <lineEnding>keep</lineEnding> - <includes> - <include>**/*.*</include> - </includes> - <useStrictFiltering>false</useStrictFiltering> - <useDefaultExcludes>true</useDefaultExcludes> - <fileMode>0644</fileMode> - <directoryMode>0755</directoryMode> - </fileSet> - - <fileSet> - <directory>../../struts/docs/struts_tools_ref_guide/target/docbook/publish/en-US</directory> - <outputDirectory>/struts_tools_ref_guide</outputDirectory> - <filtered>false</filtered> - <lineEnding>keep</lineEnding> - <includes> - <include>**/*.*</include> - </includes> - <useStrictFiltering>false</useStrictFiltering> - <useDefaultExcludes>true</useDefaultExcludes> - <fileMode>0644</fileMode> - <directoryMode>0755</directoryMode> - </fileSet> - <fileSet> - <directory>../../esb/docs/esb_ref_guide/target/docbook/publish/en-US</directory> - <outputDirectory>/esb_ref_guide</outputDirectory> - <filtered>false</filtered> - <lineEnding>keep</lineEnding> - <includes> - <include>**/*.*</include> - </includes> - <useStrictFiltering>false</useStrictFiltering> - <useDefaultExcludes>true</useDefaultExcludes> - <fileMode>0644</fileMode> - <directoryMode>0755</directoryMode> - </fileSet> - - <fileSet> - <directory>../../ws/docs/reference/target/docbook/publish/en-US</directory> - <outputDirectory>/ws_ref_guide</outputDirectory> - <filtered>false</filtered> - <lineEnding>keep</lineEnding> - <includes> - <include>**/*.*</include> - </includes> - <useStrictFiltering>false</useStrictFiltering> - <useDefaultExcludes>true</useDefaultExcludes> - <fileMode>0644</fileMode> - <directoryMode>0755</directoryMode> - </fileSet> - - <fileSet> - <directory>../../portlet/docs/reference/target/docbook/publish/en-US</directory> - <outputDirectory>/jboss_portal_tools_ref_guide</outputDirectory> - <filtered>false</filtered> - <lineEnding>keep</lineEnding> - <includes> - <include>**/*.*</include> - </includes> - <useStrictFiltering>false</useStrictFiltering> - <useDefaultExcludes>true</useDefaultExcludes> - <fileMode>0644</fileMode> - <directoryMode>0755</directoryMode> - </fileSet> - - - <fileSet> - <directory>../../drools/docs/reference/target/docbook/publish/en-US</directory> - <outputDirectory>/drools_tools_ref_guide</outputDirectory> - <filtered>false</filtered> - <lineEnding>keep</lineEnding> - <includes> - <include>**/*.*</include> - </includes> - <useStrictFiltering>false</useStrictFiltering> - <useDefaultExcludes>true</useDefaultExcludes> - <fileMode>0644</fileMode> - <directoryMode>0755</directoryMode> - </fileSet> - - - - <fileSet> - <directory>../../jmx/docs/reference/target/docbook/publish/en-US</directory> - <outputDirectory>/jmx_ref_guide</outputDirectory> - <filtered>false</filtered> - <lineEnding>keep</lineEnding> - <includes> - <include>**/*.*</include> - </includes> - <useStrictFiltering>false</useStrictFiltering> - <useDefaultExcludes>true</useDefaultExcludes> - <fileMode>0644</fileMode> - <directoryMode>0755</directoryMode> - </fileSet> - - </fileSets> - -</assembly> \ No newline at end of file Copied: branches/jbosstools-3.0.x/documentation/jbds-docs/all-guides.xml (from rev 15128, trunk/documentation/jbds-docs/all-guides.xml) =================================================================== --- branches/jbosstools-3.0.x/documentation/jbds-docs/all-guides.xml (rev 0) +++ branches/jbosstools-3.0.x/documentation/jbds-docs/all-guides.xml 2009-05-11 15:46:42 UTC (rev 15160) @@ -0,0 +1,272 @@ +<?xml version="1.0" encoding="UTF-8"?> +<assembly> + <id>all-guides</id> + + <formats> + <format>dir</format> + </formats> + <includeBaseDirectory>false</includeBaseDirectory> + <fileSets> + <fileSet> + <directory>index/target/docbook/publish/en-US/html_single/</directory> + <outputDirectory>../</outputDirectory> + <filtered>false</filtered> + <lineEnding>keep</lineEnding> + <includes> + <include>index.html</include> + </includes> + <useStrictFiltering>false</useStrictFiltering> + <useDefaultExcludes>true</useDefaultExcludes> + <fileMode>0644</fileMode> + <directoryMode>0755</directoryMode> + </fileSet> + + + <fileSet> + <directory>../guides/Exadel-migration/target/docbook/publish/en-US</directory> + <outputDirectory>/Exadel-migration</outputDirectory> + <filtered>false</filtered> + <lineEnding>keep</lineEnding> + <includes> + <include>**/*.*</include> + </includes> + <useStrictFiltering>false</useStrictFiltering> + <useDefaultExcludes>true</useDefaultExcludes> + <fileMode>0644</fileMode> + <directoryMode>0755</directoryMode> + </fileSet> + <fileSet> + <directory>../guides/GettingStartedGuide/target/docbook/publish/en-US</directory> + <outputDirectory>/GettingStartedGuide</outputDirectory> + <filtered>false</filtered> + <lineEnding>keep</lineEnding> + <includes> + <include>**/*.*</include> + </includes> + <useStrictFiltering>false</useStrictFiltering> + <useDefaultExcludes>true</useDefaultExcludes> + <fileMode>0644</fileMode> + <directoryMode>0755</directoryMode> + </fileSet> +  + + <fileSet> + <directory>../../as/docs/reference/target/docbook/publish/en-US</directory> + <outputDirectory>/as</outputDirectory> + <filtered>false</filtered> + <lineEnding>keep</lineEnding> + <includes> + <include>**/*.*</include> + </includes> + <useStrictFiltering>false</useStrictFiltering> + <useDefaultExcludes>true</useDefaultExcludes> + <fileMode>0644</fileMode> + <directoryMode>0755</directoryMode> + </fileSet> + <fileSet> + <directory>../../hibernatetools/docs/reference/target/docbook/publish/en-US</directory> + <outputDirectory>/hibernatetools</outputDirectory> + <filtered>false</filtered> + <lineEnding>keep</lineEnding> + <includes> + <include>**/*.*</include> + </includes> + <useStrictFiltering>false</useStrictFiltering> + <useDefaultExcludes>true</useDefaultExcludes> + <fileMode>0644</fileMode> + <directoryMode>0755</directoryMode> + </fileSet> + <fileSet> + <directory>../../jbpm/docs/reference/target/docbook/publish/en-US</directory> + <outputDirectory>/jboss_jbpm_ref_guide</outputDirectory> + <filtered>false</filtered> + <lineEnding>keep</lineEnding> + <includes> + <include>**/*.*</include> + </includes> + <useStrictFiltering>false</useStrictFiltering> + <useDefaultExcludes>true</useDefaultExcludes> + <fileMode>0644</fileMode> + <directoryMode>0755</directoryMode> + </fileSet> + <fileSet> + <directory>../../jbpm/docs/converter_ref/target/docbook/publish/en-US</directory> + <outputDirectory>/jboss_bpmn_convert_ref_guide</outputDirectory> + <filtered>false</filtered> + <lineEnding>keep</lineEnding> + <includes> + <include>**/*.*</include> + </includes> + <useStrictFiltering>false</useStrictFiltering> + <useDefaultExcludes>true</useDefaultExcludes> + <fileMode>0644</fileMode> + <directoryMode>0755</directoryMode> + </fileSet> + <fileSet> + <directory>../../jsf/docs/userguide/target/docbook/publish/en-US</directory> + <outputDirectory>/jsf</outputDirectory> + <filtered>false</filtered> + <lineEnding>keep</lineEnding> + <includes> + <include>**/*.*</include> + </includes> + <useStrictFiltering>false</useStrictFiltering> + <useDefaultExcludes>true</useDefaultExcludes> + <fileMode>0644</fileMode> + <directoryMode>0755</directoryMode> + </fileSet> + <fileSet> + <directory>../../seam/docs/reference/target/docbook/publish/en-US</directory> + <outputDirectory>/seam</outputDirectory> + <filtered>false</filtered> + <lineEnding>keep</lineEnding> + <includes> + <include>**/*.*</include> + </includes> + <useStrictFiltering>false</useStrictFiltering> + <useDefaultExcludes>true</useDefaultExcludes> + <fileMode>0644</fileMode> + <directoryMode>0755</directoryMode> + </fileSet> + <fileSet> + <directory>../../jsf/docs/jsf_tools_ref_guide/target/docbook/publish/en-US</directory> + <outputDirectory>/jsf_tools_ref_guide</outputDirectory> + <filtered>false</filtered> + <lineEnding>keep</lineEnding> + <includes> + <include>**/*.*</include> + </includes> + <useStrictFiltering>false</useStrictFiltering> + <useDefaultExcludes>true</useDefaultExcludes> + <fileMode>0644</fileMode> + <directoryMode>0755</directoryMode> + </fileSet> + + <fileSet> + <directory>../../jsf/docs/jsf_tools_tutorial/target/docbook/publish/en-US</directory> + <outputDirectory>/jsf_tools_tutorial</outputDirectory> + <filtered>false</filtered> + <lineEnding>keep</lineEnding> + <includes> + <include>**/*.*</include> + </includes> + <useStrictFiltering>false</useStrictFiltering> + <useDefaultExcludes>true</useDefaultExcludes> + <fileMode>0644</fileMode> + <directoryMode>0755</directoryMode> + </fileSet> + + <fileSet> + <directory>../../struts/docs/struts_tools_tutorial/target/docbook/publish/en-US</directory> + <outputDirectory>/struts_tools_tutorial</outputDirectory> + <filtered>false</filtered> + <lineEnding>keep</lineEnding> + <includes> + <include>**/*.*</include> + </includes> + <useStrictFiltering>false</useStrictFiltering> + <useDefaultExcludes>true</useDefaultExcludes> + <fileMode>0644</fileMode> + <directoryMode>0755</directoryMode> + </fileSet> + + <fileSet> + <directory>../../struts/docs/struts_tools_ref_guide/target/docbook/publish/en-US</directory> + <outputDirectory>/struts_tools_ref_guide</outputDirectory> + <filtered>false</filtered> + <lineEnding>keep</lineEnding> + <includes> + <include>**/*.*</include> + </includes> + <useStrictFiltering>false</useStrictFiltering> + <useDefaultExcludes>true</useDefaultExcludes> + <fileMode>0644</fileMode> + <directoryMode>0755</directoryMode> + </fileSet> + <fileSet> + <directory>../../esb/docs/esb_ref_guide/target/docbook/publish/en-US</directory> + <outputDirectory>/esb_ref_guide</outputDirectory> + <filtered>false</filtered> + <lineEnding>keep</lineEnding> + <includes> + <include>**/*.*</include> + </includes> + <useStrictFiltering>false</useStrictFiltering> + <useDefaultExcludes>true</useDefaultExcludes> + <fileMode>0644</fileMode> + <directoryMode>0755</directoryMode> + </fileSet> + + <fileSet> + <directory>../../ws/docs/reference/target/docbook/publish/en-US</directory> + <outputDirectory>/ws_ref_guide</outputDirectory> + <filtered>false</filtered> + <lineEnding>keep</lineEnding> + <includes> + <include>**/*.*</include> + </includes> + <useStrictFiltering>false</useStrictFiltering> + <useDefaultExcludes>true</useDefaultExcludes> + <fileMode>0644</fileMode> + <directoryMode>0755</directoryMode> + </fileSet> + + <fileSet> + <directory>../../portlet/docs/reference/target/docbook/publish/en-US</directory> + <outputDirectory>/jboss_portal_tools_ref_guide</outputDirectory> + <filtered>false</filtered> + <lineEnding>keep</lineEnding> + <includes> + <include>**/*.*</include> + </includes> + <useStrictFiltering>false</useStrictFiltering> + <useDefaultExcludes>true</useDefaultExcludes> + <fileMode>0644</fileMode> + <directoryMode>0755</directoryMode> + </fileSet> + + + <fileSet> + <directory>../../drools/docs/reference/target/docbook/publish/en-US</directory> + <outputDirectory>/drools_tools_ref_guide</outputDirectory> + <filtered>false</filtered> + <lineEnding>keep</lineEnding> + <includes> + <include>**/*.*</include> + </includes> + <useStrictFiltering>false</useStrictFiltering> + <useDefaultExcludes>true</useDefaultExcludes> + <fileMode>0644</fileMode> + <directoryMode>0755</directoryMode> + </fileSet> + + + + <fileSet> + <directory>../../jmx/docs/reference/target/docbook/publish/en-US</directory> + <outputDirectory>/jmx_ref_guide</outputDirectory> + <filtered>false</filtered> + <lineEnding>keep</lineEnding> + <includes> + <include>**/*.*</include> + </includes> + <useStrictFiltering>false</useStrictFiltering> + <useDefaultExcludes>true</useDefaultExcludes> + <fileMode>0644</fileMode> + <directoryMode>0755</directoryMode> + </fileSet> + + </fileSets> + +</assembly> \ No newline at end of file Deleted: branches/jbosstools-3.0.x/documentation/jbds-docs/clean.sh =================================================================== --- branches/jbosstools-3.0.x/documentation/jbds-docs/clean.sh 2009-05-11 15:46:31 UTC (rev 15159) +++ branches/jbosstools-3.0.x/documentation/jbds-docs/clean.sh 2009-05-11 15:46:42 UTC (rev 15160) @@ -1,9 +0,0 @@ --rm './Exadel-migration/html/images/jboss-logo copy.png' --rm './Exadel-migration/html_single/images/jboss-logo copy.png' --rm './Exadel-migration/eclipse/images/jboss-logo copy.png' --rm './GettingStartedGuide/html/images/jboss-logo copy.png' --rm './GettingStartedGuide/html_single/images/jboss-logo copy.png' --rm './GettingStartedGuide/eclipse/images/jboss-logo copy.png' --rm './jsf/html/images/jboss-logo copy.png' --rm './jsf/html_single/images/jboss-logo copy.png' --rm './jsf/eclipse/images/jboss-logo copy.png' Copied: branches/jbosstools-3.0.x/documentation/jbds-docs/clean.sh (from rev 15128, trunk/documentation/jbds-docs/clean.sh) =================================================================== --- branches/jbosstools-3.0.x/documentation/jbds-docs/clean.sh (rev 0) +++ branches/jbosstools-3.0.x/documentation/jbds-docs/clean.sh 2009-05-11 15:46:42 UTC (rev 15160) @@ -0,0 +1,9 @@ +-rm './Exadel-migration/html/images/jboss-logo copy.png' +-rm './Exadel-migration/html_single/images/jboss-logo copy.png' +-rm './Exadel-migration/eclipse/images/jboss-logo copy.png' +-rm './GettingStartedGuide/html/images/jboss-logo copy.png' +-rm './GettingStartedGuide/html_single/images/jboss-logo copy.png' +-rm './GettingStartedGuide/eclipse/images/jboss-logo copy.png' +-rm './jsf/html/images/jboss-logo copy.png' +-rm './jsf/html_single/images/jboss-logo copy.png' +-rm './jsf/eclipse/images/jboss-logo copy.png' Deleted: branches/jbosstools-3.0.x/documentation/jbds-docs/pom.xml =================================================================== --- branches/jbosstools-3.0.x/documentation/jbds-docs/pom.xml 2009-05-11 15:46:31 UTC (rev 15159) +++ branches/jbosstools-3.0.x/documentation/jbds-docs/pom.xml 2009-05-11 15:46:42 UTC (rev 15160) @@ -1,60 +0,0 @@ -<project xmlns="http://maven.apache.org/POM/4.0.0" - xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" - xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"> - - <modelVersion>4.0.0</modelVersion> - - <groupId>org.jboss.tools</groupId> - <artifactId>all-guides</artifactId> - <version>1.0-SNAPSHOT</version> - <packaging>pom</packaging> - <name>All_Userguides</name> - - <modules> - <module>../jbosstools-docbook-xslt</module> - <module>../guides/Exadel-migration</module> - <module>../guides/GettingStartedGuide</module> - <module>../../as/docs/reference</module> - <module>../../hibernatetools/docs/reference</module> - <module>../../jbpm/docs/reference</module> - <module>../../jsf/docs/userguide</module> - <module>../../jsf/docs/jsf_tools_ref_guide</module> - <module>../../jsf/docs/jsf_tools_tutorial</module> - <module>../../seam/docs/reference</module> - <module>../../struts/docs/struts_tools_ref_guide</module> - <module>../../struts/docs/struts_tools_tutorial</module> - <module>../../esb/docs/esb_ref_guide</module> - <module>../../ws/docs/reference</module> - <module>../../portlet/docs/reference</module> - <module>../../drools/docs/reference</module> - <module>../../jbpm/docs/converter_ref</module> - <module>../../jmx/docs/reference</module> - - <module>index</module> - </modules> - - <build> - <plugins> - - <plugin> - <artifactId>maven-assembly-plugin</artifactId> - <version>2.2-beta-2</version> - <configuration> - <descriptors> - <descriptor>all-guides.xml</descriptor> - </descriptors> - <finalName>en</finalName> - <outputDirectory>jbds-docs</outputDirectory> - <appendAssemblyId>false</appendAssemblyId> - <ignoreDirFormatExtensions>true</ignoreDirFormatExtensions> - </configuration> - </plugin> - - </plugins> - </build> - - <properties> - <translation>en-US</translation> - </properties> - -</project> Copied: branches/jbosstools-3.0.x/documentation/jbds-docs/pom.xml (from rev 15128, trunk/documentation/jbds-docs/pom.xml) =================================================================== --- branches/jbosstools-3.0.x/documentation/jbds-docs/pom.xml (rev 0) +++ branches/jbosstools-3.0.x/documentation/jbds-docs/pom.xml 2009-05-11 15:46:42 UTC (rev 15160) @@ -0,0 +1,60 @@ +<project xmlns="http://maven.apache.org/POM/4.0.0" + xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" + xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"> + + <modelVersion>4.0.0</modelVersion> + + <groupId>org.jboss.tools</groupId> + <artifactId>all-guides</artifactId> + <version>1.0-SNAPSHOT</version> + <packaging>pom</packaging> + <name>All_Userguides</name> + + <modules> + <module>../jbosstools-docbook-xslt</module> + <module>../guides/Exadel-migration</module> + <module>../guides/GettingStartedGuide</module> + <module>../../as/docs/reference</module> + <module>../../hibernatetools/docs/reference</module> + <module>../../jbpm/docs/reference</module> + <module>../../jsf/docs/userguide</module> + <module>../../jsf/docs/jsf_tools_ref_guide</module> + <module>../../jsf/docs/jsf_tools_tutorial</module> + <module>../../seam/docs/reference</module> + <module>../../struts/docs/struts_tools_ref_guide</module> + <module>../../struts/docs/struts_tools_tutorial</module> + <module>../../esb/docs/esb_ref_guide</module> + <module>../../ws/docs/reference</module> + <module>../../portlet/docs/reference</module> + <module>../../drools/docs/reference</module> + <module>../../jbpm/docs/converter_ref</module> + <module>../../jmx/docs/reference</module> + + <module>index</module> + </modules> + + <build> + <plugins> + + <plugin> + <artifactId>maven-assembly-plugin</artifactId> + <version>2.2-beta-2</version> + <configuration> + <descriptors> + <descriptor>all-guides.xml</descriptor> + </descriptors> + <finalName>en</finalName> + <outputDirectory>jbds-docs</outputDirectory> + <appendAssemblyId>false</appendAssemblyId> + <ignoreDirFormatExtensions>true</ignoreDirFormatExtensions> + </configuration> + </plugin> + + </plugins> + </build> + + <properties> + <translation>en-US</translation> + </properties> + +</project> Deleted: branches/jbosstools-3.0.x/documentation/jbds-docs/settings.xml =================================================================== --- branches/jbosstools-3.0.x/documentation/jbds-docs/settings.xml 2009-05-11 15:46:31 UTC (rev 15159) +++ branches/jbosstools-3.0.x/documentation/jbds-docs/settings.xml 2009-05-11 15:46:42 UTC (rev 15160) @@ -1,95 +0,0 @@ - - -<settings> - <proxies> - </proxies> - <servers> - </servers> - <mirrors> - </mirrors> - <profiles> - <profile> - <id>jboss</id> - <repositories> - <repository> - <releases> - <enabled>true</enabled> - </releases> - <snapshots> - <enabled>false</enabled> - <updatePolicy>never</updatePolicy> - </snapshots> - <id>repository.jboss.com</id> - <name>Jboss Repository for Maven</name> - <url> - http://repository.jboss.com/maven2/ - </url> - <layout>default</layout> - </repository> - <repository> - <releases> - <enabled>true</enabled> - </releases> - <snapshots> - <enabled>true</enabled> - <updatePolicy>never</updatePolicy> - </snapshots> - <id>snapshots.jboss.org</id> - <name>Jboss Repository for Maven</name> - <url> - http://snapshots.jboss.org/maven2/ - </url> - <layout>default</layout> - </repository> - <repository> - <id>java.net</id> - <url>https://maven-repository.dev.java.net/nonav/repository</url> - <layout>legacy</layout> - </repository> - </repositories> - <pluginRepositories> - <pluginRepository> - <releases> - <enabled>true</enabled> - </releases> - <snapshots> - <enabled>false</enabled> - <updatePolicy>never</updatePolicy> - </snapshots> - <id>repository.jboss.com</id> - <name>Jboss Repository for Maven</name> - <url> - http://repository.jboss.com/maven2/ - </url> - <layout>default</layout> - </pluginRepository> - <pluginRepository> - <releases> - <enabled>false</enabled> - </releases> - <snapshots> - <enabled>true</enabled> - <updatePolicy>never</updatePolicy> - </snapshots> - <id>snapshots.jboss.org</id> - <name>Jboss Repository for Maven</name> - <url> - http://snapshots.jboss.org/maven2/ - </url> - <layout>default</layout> - </pluginRepository> - </pluginRepositories> - </profile> - </profiles> - - <activeProfiles> - <activeProfile>jboss</activeProfile> - </activeProfiles> - -</settings> Copied: branches/jbosstools-3.0.x/documentation/jbds-docs/settings.xml (from rev 15128, trunk/documentation/jbds-docs/settings.xml) =================================================================== --- branches/jbosstools-3.0.x/documentation/jbds-docs/settings.xml (rev 0) +++ branches/jbosstools-3.0.x/documentation/jbds-docs/settings.xml 2009-05-11 15:46:42 UTC (rev 15160) @@ -0,0 +1,95 @@ + + +<settings> + <proxies> + </proxies> + <servers> + </servers> + <mirrors> + </mirrors> + <profiles> + <profile> + <id>jboss</id> + <repositories> + <repository> + <releases> + <enabled>true</enabled> + </releases> + <snapshots> + <enabled>false</enabled> + <updatePolicy>never</updatePolicy> + </snapshots> + <id>repository.jboss.com</id> + <name>Jboss Repository for Maven</name> + <url> + http://repository.jboss.com/maven2/ + </url> + <layout>default</layout> + </repository> + <repository> + <releases> + <enabled>true</enabled> + </releases> + <snapshots> + <enabled>true</enabled> + <updatePolicy>never</updatePolicy> + </snapshots> + <id>snapshots.jboss.org</id> + <name>Jboss Repository for Maven</name> + <url> + http://snapshots.jboss.org/maven2/ + </url> + <layout>default</layout> + </repository> + <repository> + <id>java.net</id> + <url>https://maven-repository.dev.java.net/nonav/repository</url> + <layout>legacy</layout> + </repository> + </repositories> + <pluginRepositories> + <pluginRepository> + <releases> + <enabled>true</enabled> + </releases> + <snapshots> + <enabled>false</enabled> + <updatePolicy>never</updatePolicy> + </snapshots> + <id>repository.jboss.com</id> + <name>Jboss Repository for Maven</name> + <url> + http://repository.jboss.com/maven2/ + </url> + <layout>default</layout> + </pluginRepository> + <pluginRepository> + <releases> + <enabled>false</enabled> + </releases> + <snapshots> + <enabled>true</enabled> + <updatePolicy>never</updatePolicy> + </snapshots> + <id>snapshots.jboss.org</id> + <name>Jboss Repository for Maven</name> + <url> + http://snapshots.jboss.org/maven2/ + </url> + <layout>default</layout> + </pluginRepository> + </pluginRepositories> + </profile> + </profiles> + + <activeProfiles> + <activeProfile>jboss</activeProfile> + </activeProfiles> + +</settings>

15 years, 1 month

1
0
0 / 0

JBoss Tools SVN: r15159 - in tags: jbpm-jpdl-4.0.0.beta2 and 1 other directory.

by jbosstools-commits＠lists.jboss.org

Author: koen.aers(a)jboss.com Date: 2009-05-11 11:46:31 -0400 (Mon, 11 May 2009) New Revision: 15159 Added: tags/jbpm-jpdl-4.0.0.beta2/ tags/jbpm-jpdl-4.0.0.beta2/org.jboss.tools.flow.common.feature/ Log: 4.0.0.beta2 release Copied: tags/jbpm-jpdl-4.0.0.beta2/org.jboss.tools.flow.common.feature (from rev 15158, trunk/flow/features/org.jboss.tools.flow.common.feature)

15 years, 1 month

1
0
0 / 0

JBoss Tools SVN: r15158 - in branches/jbosstools-3.0.x/documentation/guides: Exadel-migration/en and 7 other directories.

by jbosstools-commits＠lists.jboss.org

Author: smukhina Date: 2009-05-11 11:38:03 -0400 (Mon, 11 May 2009) New Revision: 15158 Modified: branches/jbosstools-3.0.x/documentation/guides/Exadel-migration/en/master.xml branches/jbosstools-3.0.x/documentation/guides/Exadel-migration/en/modules/introduction.xml branches/jbosstools-3.0.x/documentation/guides/Exadel-migration/en/modules/jsf_struts_war.xml branches/jbosstools-3.0.x/documentation/guides/Exadel-migration/pom.xml branches/jbosstools-3.0.x/documentation/guides/GettingStartedGuide/en/images/first_seam/first_seam10.png branches/jbosstools-3.0.x/documentation/guides/GettingStartedGuide/en/images/manage/manage_1.png branches/jbosstools-3.0.x/documentation/guides/GettingStartedGuide/en/images/manage/manage_17.png branches/jbosstools-3.0.x/documentation/guides/GettingStartedGuide/en/images/manage/manage_4.png branches/jbosstools-3.0.x/documentation/guides/GettingStartedGuide/en/images/manage/manage_6.png branches/jbosstools-3.0.x/documentation/guides/GettingStartedGuide/en/images/project_examples/pr_example_1.png branches/jbosstools-3.0.x/documentation/guides/GettingStartedGuide/en/images/project_examples/pr_example_2.png branches/jbosstools-3.0.x/documentation/guides/GettingStartedGuide/en/images/project_examples/pr_example_5.png branches/jbosstools-3.0.x/documentation/guides/GettingStartedGuide/en/master.xml branches/jbosstools-3.0.x/documentation/guides/GettingStartedGuide/en/modules/first_seam.xml branches/jbosstools-3.0.x/documentation/guides/GettingStartedGuide/en/modules/further_reading.xml branches/jbosstools-3.0.x/documentation/guides/GettingStartedGuide/en/modules/getting_started.xml branches/jbosstools-3.0.x/documentation/guides/GettingStartedGuide/en/modules/jsp_application.xml branches/jbosstools-3.0.x/documentation/guides/GettingStartedGuide/en/modules/manage.xml branches/jbosstools-3.0.x/documentation/guides/GettingStartedGuide/en/modules/project_examples.xml branches/jbosstools-3.0.x/documentation/guides/GettingStartedGuide/en/modules/rad_jsf_application.xml branches/jbosstools-3.0.x/documentation/guides/GettingStartedGuide/pom.xml Log: https://jira.jboss.org/jira/browse/JBDS-717 merged changes from trunk are added to the corresponding branch Modified: branches/jbosstools-3.0.x/documentation/guides/Exadel-migration/en/master.xml =================================================================== --- branches/jbosstools-3.0.x/documentation/guides/Exadel-migration/en/master.xml 2009-05-11 15:33:05 UTC (rev 15157) +++ branches/jbosstools-3.0.x/documentation/guides/Exadel-migration/en/master.xml 2009-05-11 15:38:03 UTC (rev 15158) @@ -33,7 +33,7 @@ <holder>JBoss, a division of Red Hat</holder> </copyright> <releaseinfo> -Version: 2.0.0.GA +Version: 2.0.1.GA </releaseinfo> <abstract> Modified: branches/jbosstools-3.0.x/documentation/guides/Exadel-migration/en/modules/introduction.xml =================================================================== --- branches/jbosstools-3.0.x/documentation/guides/Exadel-migration/en/modules/introduction.xml 2009-05-11 15:33:05 UTC (rev 15157) +++ branches/jbosstools-3.0.x/documentation/guides/Exadel-migration/en/modules/introduction.xml 2009-05-11 15:38:03 UTC (rev 15158) @@ -1,23 +1,23 @@ <?xml version="1.0" encoding="UTF-8"?> <chapter id="introduction" xreflabel="introduction"> <?dbhtml filename="introduction.html"?> - <chapterinfo> - <keywordset> - <keyword>JBoss Developer Studio</keyword> - <keyword>JBDS</keyword> - <keyword>Exadel Studio Pro</keyword> - </keywordset> - </chapterinfo> - + <chapterinfo> + <keywordset> + <keyword>JBoss Developer Studio</keyword> + <keyword>JBDS</keyword> + <keyword>Exadel Studio Pro</keyword> + </keywordset> + </chapterinfo> + <title>Introduction </title> - <para>This document is intended to help you to migrate an existing Exadel JSF or Struts projects - into <property>JBoss Developer Studio</property>. Preferences can be exported from Eclipse 3.2.0 (3.2.1 or 3.2.2) and imported in Eclipse 3.3 by the standard Eclipse means. - </para> -<section> - <title>Other relevant resources on the topic</title> - <para>All JBoss Developer Studio/JBoss Tools documentation you can find <ulink url="http://docs.jboss.org/tools">here</ulink>.</para> - <para>The latest documentation builds are available <ulink url="http://download.jboss.org/jbosstools/nightly-docs/">here</ulink>.</para> - -</section> + <para>This document is intended to help you to migrate an existing Exadel JSF or Struts projects + into <property>JBoss Developer Studio</property>. Preferences can be exported from Eclipse 3.2.0 + (3.2.1 or 3.2.2) and imported in Eclipse 3.4.x by the standard Eclipse means.</para> + <section> + <title>Other relevant resources on the topic</title> + <para>All JBoss Developer Studio/JBoss Tools release documentation you can find at<ulink url="http://docs.jboss.org/tools/">http://docs.jboss.org/tools</ulink> in the corresponding release directory.</para> + <para>The latest documentation builds are available at <ulink url="http://download.jboss.org/jbosstools/nightly-docs/">http://download.jboss.org/jbosstools/nightly-docs</ulink>.</para> - </chapter> + </section> + +</chapter> Modified: branches/jbosstools-3.0.x/documentation/guides/Exadel-migration/en/modules/jsf_struts_war.xml =================================================================== --- branches/jbosstools-3.0.x/documentation/guides/Exadel-migration/en/modules/jsf_struts_war.xml 2009-05-11 15:33:05 UTC (rev 15157) +++ branches/jbosstools-3.0.x/documentation/guides/Exadel-migration/en/modules/jsf_struts_war.xml 2009-05-11 15:38:03 UTC (rev 15158) @@ -144,5 +144,14 @@ </listitem> </itemizedlist> <para>The migration process is completed</para> + + <para>If there's anything we didn't cover or you can't figure + out, please feel free to visit our <ulink + url="http://www.jboss.com/index.html?module=bb&op=viewforum&f=258" + >JBoss Developer Studio Users Forum</ulink> or <ulink + url="http://www.jboss.com/index.html?module=bb&op=viewforum&f=201" + >JBoss Tools Users Forum</ulink> to ask questions. There we are also looking for + your suggestions and comments.</para> </section> + </chapter> \ No newline at end of file Modified: branches/jbosstools-3.0.x/documentation/guides/Exadel-migration/pom.xml =================================================================== --- branches/jbosstools-3.0.x/documentation/guides/Exadel-migration/pom.xml 2009-05-11 15:33:05 UTC (rev 15157) +++ branches/jbosstools-3.0.x/documentation/guides/Exadel-migration/pom.xml 2009-05-11 15:38:03 UTC (rev 15158) @@ -81,6 +81,11 @@ <artifactId>jbosstools-docbook-xslt</artifactId> <version>1.0.0-SNAPSHOT</version> </dependency> + <dependency> + <groupId>org.apache.xmlgraphics</groupId> + <artifactId>fop</artifactId> + <version>0.95</version> + </dependency> </dependencies> <configuration> <sourceDocumentName>${master}</sourceDocumentName> Modified: branches/jbosstools-3.0.x/documentation/guides/GettingStartedGuide/en/images/first_seam/first_seam10.png =================================================================== (Binary files differ) Modified: branches/jbosstools-3.0.x/documentation/guides/GettingStartedGuide/en/images/manage/manage_1.png =================================================================== (Binary files differ) Modified: branches/jbosstools-3.0.x/documentation/guides/GettingStartedGuide/en/images/manage/manage_17.png =================================================================== (Binary files differ) Modified: branches/jbosstools-3.0.x/documentation/guides/GettingStartedGuide/en/images/manage/manage_4.png =================================================================== (Binary files differ) Modified: branches/jbosstools-3.0.x/documentation/guides/GettingStartedGuide/en/images/manage/manage_6.png =================================================================== (Binary files differ) Modified: branches/jbosstools-3.0.x/documentation/guides/GettingStartedGuide/en/images/project_examples/pr_example_1.png =================================================================== (Binary files differ) Modified: branches/jbosstools-3.0.x/documentation/guides/GettingStartedGuide/en/images/project_examples/pr_example_2.png =================================================================== (Binary files differ) Modified: branches/jbosstools-3.0.x/documentation/guides/GettingStartedGuide/en/images/project_examples/pr_example_5.png =================================================================== (Binary files differ) Modified: branches/jbosstools-3.0.x/documentation/guides/GettingStartedGuide/en/master.xml =================================================================== --- branches/jbosstools-3.0.x/documentation/guides/GettingStartedGuide/en/master.xml 2009-05-11 15:33:05 UTC (rev 15157) +++ branches/jbosstools-3.0.x/documentation/guides/GettingStartedGuide/en/master.xml 2009-05-11 15:38:03 UTC (rev 15158) @@ -26,6 +26,11 @@ <!ENTITY jbossportallink "../../jboss_portal_tools_ref_guide/html_single/index.html"> <!ENTITY migrationlink "../../Exadel-migration/html_single/index.html"> <!ENTITY wslink "../../ws_ref_guide/html_single/index.html"> +<!ENTITY smookslink "../../jboss_smooks_plugin_ref_guide/html_single/index.html"> +<!ENTITY droolslink "../../drools_tools_ref_guide/html_single/index.html"> +<!ENTITY jmxlink "../../jmx_ref_guide/html_single/index.html"> + + ]> <book> @@ -37,7 +42,7 @@ <year>2009</year> <holder>JBoss, a division of Red Hat</holder> </copyright> - <releaseinfo>Version: 2.0.0.GA</releaseinfo> + <releaseinfo>Version: 2.0.1.GA</releaseinfo> <abstract> <title/> <para> Modified: branches/jbosstools-3.0.x/documentation/guides/GettingStartedGuide/en/modules/first_seam.xml =================================================================== --- branches/jbosstools-3.0.x/documentation/guides/GettingStartedGuide/en/modules/first_seam.xml 2009-05-11 15:33:05 UTC (rev 15157) +++ branches/jbosstools-3.0.x/documentation/guides/GettingStartedGuide/en/modules/first_seam.xml 2009-05-11 15:38:03 UTC (rev 15158) @@ -273,17 +273,13 @@ <para>The complete information on how to manage JBoss AS from JBoss Developer Studio you can read in a <link linkend="manage">corresponding chapter</link>.</para> - <para>Now you just need to start the server by clicking on green circle/triangle icon in the - JBoss Server View.</para> - - <figure> - <title>Starting the Server</title> - <mediaobject> + <para>Now you just need to start the server by clicking on the Start the server icon ( + <inlinemediaobject> <imageobject> - <imagedata fileref="images/first_seam/first_seam15.png"/> + <imagedata fileref="images/first_seam/first_seam50.png"/> </imageobject> - </mediaobject> - </figure> + </inlinemediaobject> ) in the + JBoss Server View.</para> <para>Then run the project by selecting the project and use <emphasis><property>Run As... > Run on Server</property>.</emphasis></para> Modified: branches/jbosstools-3.0.x/documentation/guides/GettingStartedGuide/en/modules/further_reading.xml =================================================================== --- branches/jbosstools-3.0.x/documentation/guides/GettingStartedGuide/en/modules/further_reading.xml 2009-05-11 15:33:05 UTC (rev 15157) +++ branches/jbosstools-3.0.x/documentation/guides/GettingStartedGuide/en/modules/further_reading.xml 2009-05-11 15:38:03 UTC (rev 15158) @@ -12,20 +12,111 @@ </chapterinfo> <title>Further Reading</title> - - <para> - <emphasis role="bold">JSF Tools Reference Guide</emphasis> - <ulink url="&jsfreflink;">(html)</ulink> - - </para> - <para> From this guide you'll discover all peculiarities of work at a JSF project. You'll - learn all shades that cover the process of project creation and take a closer look at the JSF - configuration file. Also you'll get to know managed beans and how to work with them and - find out, how to create and register a custom converter, custom validator and referenced beans - in a JSF project. </para> - <itemizedlist> + <listitem> + <para> + <emphasis role="bold">Seam Dev Tools Reference Guide</emphasis> + <ulink url="&seamlink;">(html)</ulink> + </para> + <para> This guide helps you to understand what Seam is and how to install Seam plug-in into + Eclipse. It tells you the necessary steps to start working with Seam Framework and assists in a + simple Seam Project creation. Also you will learn how to create and run the CRUD Database + Application with Seam as well as find out what Seam Editors Features and Seam Components are. </para> + </listitem> + + <listitem> + <para> + <emphasis role="bold">Visual Web Tools Reference Guide</emphasis> + <ulink url="&jsflink;">(html)</ulink> provides general orientation and an overview of JBDS visual web tools functionality. This guide discusses the following topics: editors, palette, web properties view, openOn, content assist, RichFaces support. + </para> + </listitem> + + <listitem> + <para> + <emphasis role="bold">JBoss Server Manager Reference Guide</emphasis> + <ulink url="&aslink;">(html)</ulink> + </para> + <para> This guide covers the basics of working with the JBoss server manager. You will read how to + install runtimes and servers and quickly learn how to configure, start, stop the server and know + how deployment and archiving process. You will find out how to manage installed JBoss Servers + via JBoss AS Perspective. You will also read how to deploy modules onto the server. </para> + </listitem> + + <listitem> + <para> + <emphasis role="bold">jBPM Tools Reference Guide</emphasis> + <ulink url="&jbpmlink;">(html)</ulink> + </para> + <para>With jBPM Tools Reference Guide we'll help you to facilitate a cross-product + learning and know how you can speed your development using special editors and visual designers. + We'll also guide you through the steps on how to create a simple process and test it + within jBPM jPDL perspective.</para> + </listitem> + + <listitem> + <para> + <emphasis role="bold">Hibernate Tools Reference Guide</emphasis> + <ulink url="&hibernatelink;">(html)</ulink> + </para> + <para>Throughout this guide you will learn how to install and use Hibernate Tools bath via Ant and + through Eclipse. We'll supply you with the information on how to create mapping files, + configuration file as well as a file for controlling reverse engineering by using specific + wizards that Hibernate tooling provides. Also you will know about Code Generation and + peculiarities of work within Hibernate Console Perspective.</para> + </listitem> + + <listitem> + <para> + <emphasis role="bold">ESB Editor Reference Guide</emphasis> + <ulink url="&esblink;">(html)</ulink> + </para> + <para>This guide provides you with the information on ESB Editor and all necessary wizards for ESB + files development.</para> + </listitem> + + <listitem> + <para> + <emphasis role="bold">JBoss Portal Tools Reference Guide</emphasis> + <ulink url="&jbossportallink;">(html)</ulink> + </para> + <para>The guide gives a detail look at how you can easily build a Portlet Web Application with + JBoss Tools and deploy it onto JBoss Portal.</para> + </listitem> + + <listitem> + <para> + <emphasis role="bold">JBoss WS User Guide</emphasis> + <ulink url="&wslink;">(html)</ulink> + </para> + <para>This guide gives you practical help on JBossWS usage. You will learn how to create a web service using JBossWS runtime, find out how to create a web service client from a WSDL document using JBoss WS and also see how to set your development environment.</para> + </listitem> + + <listitem> + <para> + <emphasis role="bold">Smooks Tools Reference Guide</emphasis> + <ulink url="&smookslink;">(html)</ulink> + </para> + <para>This guide is packed with useful and easy-to-understand information about graphical, configuration and source editor pages.</para> + </listitem> + + <listitem> + <para> + <emphasis role="bold">Drools Tools Reference Guide</emphasis> + <ulink url="&droolslink;">(html)</ulink> + </para> + <para>The guide help you to discover how to create a new Drools project, use debugging rules and work with different editors.</para> + </listitem> + + <listitem> + <para> + <emphasis role="bold">JMX Tools Reference Guide</emphasis> + <ulink url="&jmxlink;">(html)</ulink> + </para> + <para>With the help of this guide you'll explore the best practices to follow when working with MBean Explorer, MBean Editor, Connections and etc.</para> + </listitem> + + <listitem> <para> <emphasis role="bold">JSF Tools Tutorial</emphasis> <ulink url="&jsftutoriallink;">(html)</ulink> @@ -35,6 +126,18 @@ </listitem> <listitem> <para> + <emphasis role="bold">JSF Tools Reference Guide</emphasis> + <ulink url="&jsfreflink;">(html)</ulink> + + </para> + <para> From this guide you'll discover all peculiarities of work at a JSF project. You'll + learn all shades that cover the process of project creation and take a closer look at the JSF + configuration file. Also you'll get to know managed beans and how to work with them and + find out, how to create and register a custom converter, custom validator and referenced beans + in a JSF project. </para> + </listitem> + + <listitem> <para> <emphasis role="bold">Struts Tools Reference Guide</emphasis> <ulink url="&strutsreflink;">(html)</ulink> </para> @@ -52,92 +155,22 @@ step-by-step show you how to create a simple Struts application in JBoss Developer Studio.</para> </listitem> -<listitem> - <para> - <emphasis role="bold">Seam Dev Tools Reference Guide</emphasis> - <ulink url="&seamlink;">(html)</ulink> - </para> - <para> This guide helps you to understand what Seam is and how to install Seam plug-in into - Eclipse. It tells you the necessary steps to start working with Seam Framework and assists in a - simple Seam Project creation. Also you will learn how to create and run the CRUD Database - Application with Seam as well as find out what Seam Editors Features and Seam Components are. </para> - </listitem> - - <listitem> - <para> - <emphasis role="bold">Visual Web Tools Reference Guide</emphasis> - <ulink url="&jsflink;">(html)</ulink> - </para> - </listitem> - - <listitem> - <para> - <emphasis role="bold">JBoss Server Manager Reference Guide</emphasis> - <ulink url="&aslink;">(html)</ulink> - </para> - <para> This guide covers the basics of working with the JBoss server manager. You will read how to - install runtimes and servers and quickly learn how to configure, start, stop the server and know - how deployment and archiving process. You will find out how to manage installed JBoss Servers - via JBoss AS Perspective. You will also read how to deploy modules onto the server. </para> - </listitem> - - <listitem> - <para> - <emphasis role="bold">jBPM Tools Reference Guide</emphasis> - <ulink url="&jbpmlink;">(html)</ulink> - </para> - <para>With jBPM Tools Reference Guide we'll help you to facilitate a cross-product - learning and know how you can speed your development using special editors and visual designers. - We'll also guide you through the steps on how to create a simple process and test it - within jBPM jPDL perspective.</para> - </listitem> - - <listitem> - <para> - <emphasis role="bold">Hibernate Tools Reference Guide</emphasis> - <ulink url="&hibernatelink;">(html)</ulink> - </para> - <para>Throughout this guide you will learn how to install and use Hibernate Tools bath via Ant and - through Eclipse. We'll supply you with the information on how to create mapping files, - configuration file as well as a file for controlling reverse engineering by using specific - wizards that Hibernate tooling provides. Also you will know about Code Generation and - peculiarities of work within Hibernate Console Perspective.</para> - </listitem> - <listitem> - <para> - <emphasis role="bold">ESB Editor Reference Guide</emphasis> - <ulink url="&esblink;">(html)</ulink> - </para> - <para>This guide provides you with the information on ESB Editor which allows you to develop ESB - file.</para> - </listitem> - - <listitem> - <para> - <emphasis role="bold">JBoss Portal Tools Reference Guide</emphasis> - <ulink url="&jbossportallink;">(html)</ulink> - </para> - <para>The guide gives a detail look at how you can easily build a Portlet Web Application with - JBoss Tools and deploy it onto JBoss Portal.</para> - </listitem> - - <listitem> - <para> - <emphasis role="bold">JBoss WS User Guide</emphasis> - <ulink url="&wslink;">(html)</ulink> - </para> - <para>This guide gives you practical help on JBossWS usage.</para> - </listitem> - <listitem> <para> <emphasis role="bold">Exadel Studio Migration Guide</emphasis> <ulink url="&migrationlink;">(html)</ulink> </para> <para>This document is intended to help you to migrate an existing Exadel JSF or Struts projects - from Exadel Studio into JBoss Developer Studio. </para> + from Exadel Studio into JBoss Developer Studio. </para> </listitem> - + + <para>If there's anything we didn't cover in this guide, please feel free to visit our <ulink + url="http://www.jboss.com/index.html?module=bb&op=viewforum&f=258" + >JBoss Developer Studio Users Forum</ulink> or <ulink + url="http://www.jboss.com/index.html?module=bb&op=viewforum&f=201" + >JBoss Tools Users Forum</ulink> to ask questions. There we are also looking for + your suggestions and comments.</para> </itemizedlist> + </chapter> Modified: branches/jbosstools-3.0.x/documentation/guides/GettingStartedGuide/en/modules/getting_started.xml =================================================================== --- branches/jbosstools-3.0.x/documentation/guides/GettingStartedGuide/en/modules/getting_started.xml 2009-05-11 15:33:05 UTC (rev 15157) +++ branches/jbosstools-3.0.x/documentation/guides/GettingStartedGuide/en/modules/getting_started.xml 2009-05-11 15:38:03 UTC (rev 15158) @@ -458,8 +458,8 @@ <para>Get Eclipse and Web Tools</para> </listitem> </itemizedlist> - <para>The current version of JBoss Tools (3.0.0.GA) targets at Eclipse 3.4.2/Ganymede SR2 and WTP - 3.0.3+</para> + <para>The current version of JBoss Tools (3.0.1.GA) targets at Eclipse 3.4.2 and WTP + 3.0.4</para> <tip> <title>Tip:</title> Modified: branches/jbosstools-3.0.x/documentation/guides/GettingStartedGuide/en/modules/jsp_application.xml =================================================================== --- branches/jbosstools-3.0.x/documentation/guides/GettingStartedGuide/en/modules/jsp_application.xml 2009-05-11 15:33:05 UTC (rev 15157) +++ branches/jbosstools-3.0.x/documentation/guides/GettingStartedGuide/en/modules/jsp_application.xml 2009-05-11 15:38:03 UTC (rev 15158) @@ -9,16 +9,16 @@ </keywordset> </chapterinfo> <title>Developing a simple JSP web application</title> - + <note> <title>Note:</title> <para>We highly recommend developing in <property>Seam</property>. This chapter is for users who for some reason cannot use Seam.</para> </note> - + <para>In this chapter you'll find out how to create a simple <ulink - url="http://java.sun.com/products/jsp/">JSP</ulink> application using the - <property>JBoss Developer Studio</property>. The application will show a classic + url="http://java.sun.com/products/jsp/">JSP</ulink> application using the + <property>JBoss Developer Studio</property>. The application will show a classic "Hello World!" on the page.</para> <para>We'll assume that you have already launched <property>JBoss Developer Studio</property> and also that the <property>Web Development</property> perspective is the @@ -28,7 +28,7 @@ <property>Window > Open Perspective > Other...</property> </emphasis> from the menu bar and then selecting Web Development from the Select Perspective dialog box.</para> - + <section id="SettingUpTheProject"> <?dbhtml filename="SettingUpTheProject.html"?> <title>Setting Up the Project</title> @@ -38,18 +38,18 @@ <itemizedlist> <listitem> <para>Go to the menu bar and select <emphasis> - <property>File > New > Other...</property> - </emphasis></para> + <property>File > New > Other...</property> + </emphasis></para> </listitem> <listitem> <para>Select <emphasis> - <property>Web > Dynamic Web Project</property> - </emphasis> in the New Project dialog box</para> + <property>Web > Dynamic Web Project</property> + </emphasis> in the New Project dialog box</para> </listitem> <listitem> <para>Click <emphasis> - <property>Next</property> - </emphasis> + <property>Next</property> + </emphasis> </para> </listitem> <listitem> @@ -57,10 +57,10 @@ </listitem> <listitem> <para>Then select <emphasis> - <property>Minimal Configuration</property> - </emphasis> from the list of possible configurations and click <emphasis> - <property>Finish</property> - </emphasis></para> + <property>Minimal Configuration</property> + </emphasis> from the list of possible configurations and click <emphasis> + <property>Finish</property> + </emphasis></para> </listitem> </itemizedlist> <figure> @@ -71,10 +71,10 @@ </imageobject> </mediaobject> </figure> - + <para>The <emphasis> - <property>jspHello</property> - </emphasis> node should appear in the upper-left <property>Package Explorer</property> + <property>jspHello</property> + </emphasis> node should appear in the upper-left <property>Package Explorer</property> view.</para> <figure> <title>New Web Project</title> @@ -85,32 +85,32 @@ </mediaobject> </figure> </section> - + <section id="CreatingJSPPage"> <?dbhtml filename="CreatingJSPPage.html"?> <title>Creating JSP Page</title> <para>This section covers all the points how to create, edit and then preview JSP page.</para> <para>In our simple application we need to create only one JSP page which displays a - <emphasis>"Hello World!"</emphasis> message.</para> + <emphasis>"Hello World!"</emphasis> message.</para> <itemizedlist> <listitem> <para>Right click <emphasis><property>WebContent > New > - JSP</property>. </emphasis></para> + JSP</property>. </emphasis></para> </listitem> <listitem> <para>Type "hello.jsp" for a file name and click the <emphasis> - <property>Next</property> - </emphasis> button.</para> + <property>Next</property> + </emphasis> button.</para> </listitem> </itemizedlist> <para>In the next window you can choose a template for your jsp page and see its preview.</para> <itemizedlist> <listitem> <para>Select <emphasis> - <property>New JSP File (xhtml)</property> - </emphasis> template and click <emphasis> - <property>Finish</property> - </emphasis> button.</para> + <property>New JSP File (xhtml)</property> + </emphasis> template and click <emphasis> + <property>Finish</property> + </emphasis> button.</para> </listitem> </itemizedlist> <figure> @@ -121,26 +121,33 @@ </imageobject> </mediaobject> </figure> - <para>Our <emphasis><property>hello.jsp</property></emphasis> page will now appear in - <property>Project Explorer</property>. + <para>Our <emphasis><property>hello.jsp</property></emphasis> page will now appear in + <property>Project Explorer</property>. </para> <section id="EditingJSPPage"> <?dbhtml filename="EditingJSPPage.html"?> <title>Editing a JSP Page</title> <para>Let's now make a little change so that a jsp page displays - <emphasis>"Hello World!"</emphasis> message.</para> + <emphasis>"Hello World!"</emphasis> message.</para> <itemizedlist> <listitem> - <para>Insert this line inside the <emphasis role="bold"> - <property><body></property> +  + <para> + + Insert this line inside the + <code><body> </body> + </code> + tag: + </para> </listitem> </itemizedlist> <programlisting role="XML"><![CDATA[<% System.out.println("Hello World!"); %>]]> -</programlisting> - + </programlisting> + <para>Notice that content assist functionality is always available when you are typing:</para> <figure> <title>Content Assist in JSP Page</title> @@ -151,8 +158,8 @@ </mediaobject> </figure> <para>After changes made your <emphasis> - <property>hello.jsp</property> - </emphasis> page should look like this:</para> + <property>hello.jsp</property> + </emphasis> page should look like this:</para> <figure> <title>Hello.jsp Page</title> <mediaobject> @@ -161,21 +168,21 @@ </imageobject> </mediaobject> </figure> - + <para>This line will actually output <emphasis>"Hello World!"</emphasis> message in the <property>Console</property>. To make the message displayed in the Browser, just replace this line with the simple - <emphasis>Hello World!</emphasis>.</para> + <emphasis>Hello World!</emphasis>.</para> </section> - + <section id="WebXML"> <?dbhtml filename="WebXML.html"?> <title>web.xml file</title> <para>When you are creating web project the wizard creates the <emphasis> - <property>web.xml</property> - </emphasis> for you automatically. The <property>web.xml file editor</property> + <property>web.xml</property> + </emphasis> for you automatically. The <property>web.xml file editor</property> provided by <property>JBoss Developer Studio</property> is available in two modes: - <property>Tree</property> and <property>Source</property>.</para> + <property>Tree</property> and <property>Source</property>.</para> <figure> <title>Web.xml in Design and Source Mode</title> <mediaobject> @@ -186,18 +193,18 @@ </mediaobject> </figure> <para>Both modes are fully synchronized. Let's add mapping to our <emphasis> - <property>hello.jsp</property> - </emphasis> page in <emphasis> - <property>web.xml</property> - </emphasis> file.</para> + <property>hello.jsp</property> + </emphasis> page in <emphasis> + <property>web.xml</property> + </emphasis> file.</para> <itemizedlist> <listitem> <para>Switch to <property>Source</property> tab.</para> </listitem> <listitem> - <para>Add the next code into <emphasis role="bold"> - <property><welcome-file-list></property> - </emphasis>:</para> + <para>Add the next code into + <code><welcome-file-list></code> + :</para> </listitem> </itemizedlist> <programlisting role="XML"><![CDATA[<welcome-file>hello.jsp</welcome-file> @@ -206,29 +213,29 @@ made are automatically reflected in that mode.</para> <para>Actually you don't really need to do any configurations right now.</para> </section> - + <section id="DeployTheProject"> <?dbhtml filename="DeployTheProject.html"?> <title>Deploying the project</title> <para>While creating any web project you could experience a pain writing ant scripts and managing the packaging even when writing the most trivial web applications. With - <property>JBoss Developer Studio</property> you are saved from such a pain. All + <property>JBoss Developer Studio</property> you are saved from such a pain. All you need is to start <property>JBoss Server</property> and launch your application in your favorite browser.</para> <para>You can also create a war archive with <ulink - url="&aslink;#Project_archivesView">JBDS's Archive Tools</ulink> + url="&aslink;#Project_archivesView">JBDS's Archive Tools</ulink> and export it to any web server.</para> <section id="WarConfig"> <?dbhtml filename="WarConfig.html"?> <title>WAR Config</title> <para>Project archives managing is available through <ulink - url="&aslink;#Project_archivesView">Project Archives view</ulink>.</para> + url="&aslink;#Project_archivesView">Project Archives view</ulink>.</para> <itemizedlist> <listitem> <para>Select <emphasis> - <property>Window > Show view > Other > JBoss - Tools > Project archives</property> - </emphasis> from menu bar</para> + <property>Window > Show view > Other > JBoss + Tools > Project archives</property> + </emphasis> from menu bar</para> </listitem> <listitem> <para>Select a project in Package Explorer you want to be archived</para> @@ -247,8 +254,8 @@ <itemizedlist> <listitem> <para>Click, for example, <emphasis> - <property>WAR</property> - </emphasis> option to create war archive</para> + <property>WAR</property> + </emphasis> option to create war archive</para> </listitem> </itemizedlist> <para>In the <property>New WAR</property> dialog you can see automatically selected @@ -264,24 +271,24 @@ <itemizedlist> <listitem> <para>Click <emphasis> - <property>Next</property> - </emphasis> to see a stub archive configuration for your project: <figure> - <title>Stub Archive Configuration</title> - <mediaobject> - <imageobject> - <imagedata - fileref="images/jsp_application/jsp_application_10.png" - /> - </imageobject> - </mediaobject> - </figure> + <property>Next</property> + </emphasis> to see a stub archive configuration for your project: <figure> + <title>Stub Archive Configuration</title> + <mediaobject> + <imageobject> + <imagedata + fileref="images/jsp_application/jsp_application_10.png" + /> + </imageobject> + </mediaobject> + </figure> </para> </listitem> <listitem> <para>Click <emphasis> - <property>Finish</property>. </emphasis> The + <property>Finish</property>. </emphasis> The <emphasis>.war</emphasis> file will appear in <property>Package - Explorer</property> and also in <property>Project Archives</property> + Explorer</property> and also in <property>Project Archives</property> view as structure tree: <figure> <title>Archive is Created</title> <mediaobject> @@ -316,19 +323,19 @@ </mediaobject> </figure> </section> - + <section id="AutoRedeploy"> <?dbhtml filename="AutoRedeploy.html"?> <title>Auto redeploy</title> <para>When you are creating a web application and register it on <property>JBoss - Server</property> it is automatically deployed into + Server</property> it is automatically deployed into <emphasis>/deploy</emphasis> directory of the server. JBDS comes with the feature of auto-redeploy. It means that you don't need to restart - <property>JBoss Server</property>. Any changes made in the application in + <property>JBoss Server</property>. Any changes made in the application in exploded format will trigger a redeployment on the server.</para> </section> </section> - + <section id="Previewtab"> <?dbhtml filename="Previewtab.html"?> <title>JSP Page Preview</title> @@ -339,8 +346,8 @@ <itemizedlist> <listitem> <para>Make a little change to <emphasis> - <property>hello.jsp</property> - </emphasis> page, e.g. put this code snippet:</para> + <property>hello.jsp</property> + </emphasis> page, e.g. put this code snippet:</para> </listitem> </itemizedlist> <programlisting role="XML"><![CDATA[<%= new java.util.Date() %> @@ -348,8 +355,8 @@ <itemizedlist> <listitem> <para>Click <emphasis> - <property>Save</property> - </emphasis> button.</para> + <property>Save</property> + </emphasis> button.</para> </listitem> <listitem> <para>Switch to Preview page by clicking <property>Preview</property> tab at the @@ -357,56 +364,52 @@ </listitem> </itemizedlist>  + </mediaobject> + </figure> + --> </section> <section id="LaunchingTheProject"> <?dbhtml filename="LaunchingTheProject.html"?> <title>Launch JSP Project</title> <para>Let's now launch our project on server. We'll use - <property>JBoss Server</property> that is shipped with <property>JBoss Developer + <property>JBoss Server</property> that is shipped with <property>JBoss Developer Studio</property>. You can do it by performing one of the following actions:</para> <itemizedlist> <listitem> <para>Start JBoss Server from <ulink url="&aslink;#JBossServerView">JBoss - Server view</ulink> by clicking the Start icon.</para> + Server view</ulink> by clicking the Start the server icon ( + <inlinemediaobject> + <imageobject> + <imagedata fileref="images/jsp_application/jsp_application_18.png"/> + </imageobject> + </inlinemediaobject> ) .</para> </listitem> </itemizedlist> - <figure> - <title>Starting Server</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/jsp_application/jsp_application_15.png"/> - </imageobject> - </mediaobject> - </figure> + <itemizedlist> <listitem> <para>Click the Run icon or right click your project folder and select <emphasis> - <property>Run As > Run on Server</property>. </emphasis> If you + <property>Run As > Run on Server</property>. </emphasis> If you haven't made any changes in <emphasis> <property>web.xml</property> </emphasis> file or cleared it out you can launch the application by right clicking the <emphasis> <property>hello.jsp</property> </emphasis> page and selecting <emphasis> - <property>Run on the Server</property>. </emphasis></para> + <property>Run on the Server</property> </emphasis>( + <inlinemediaobject> + <imageobject> + <imagedata fileref="images/jsp_application/jsp_application_16.png"/> + </imageobject> + </inlinemediaobject> ).</para> </listitem> </itemizedlist> - <figure> - <title>Run Project</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/jsp_application/jsp_application_16.png"/> - </imageobject> - </mediaobject> - </figure> + <para>You should see the next page in a Browser :</para> <figure> <title>Running Project</title> @@ -415,13 +418,13 @@ <imagedata fileref="images/jsp_application/jsp_application_17.png"/> </imageobject> </mediaobject> - </figure> + </figure> <para>Thus with the help of this chapter you've learnt how to organize a Dynamic Web Project with a minimal configuration, add any staff to it (in our case it's just one jsp page) and deploy and run it on the <property>JBoss Server</property> shipped with <property>JBDS</property>. </para> </section> - - </section> + + </section> </chapter> Modified: branches/jbosstools-3.0.x/documentation/guides/GettingStartedGuide/en/modules/manage.xml =================================================================== --- branches/jbosstools-3.0.x/documentation/guides/GettingStartedGuide/en/modules/manage.xml 2009-05-11 15:33:05 UTC (rev 15157) +++ branches/jbosstools-3.0.x/documentation/guides/GettingStartedGuide/en/modules/manage.xml 2009-05-11 15:38:03 UTC (rev 15158) @@ -15,8 +15,8 @@ <para>In this chapter we'll focus more on how to operate the <property>JBoss AS</property> from <property>JBoss Developer Studio</property>.</para> - <para><property>JBoss Developer Studio</property> ships with <property>JBoss EAP - v.4.2</property> bundled. When you followed the default installation of <property>JBoss + <para><property>JBoss Developer Studio</property> is shipped with <property>JBoss EAP + </property>. When you followed the default installation of <property>JBoss Developer Studio</property>, you should already have a JBoss EAP 4.3 Server installed and defined. To run JBoss AS you need JDK 1.5, JDK 6 is not formally supported yet, although you may be able to start the server with it.</para> @@ -141,7 +141,7 @@ <?dbhtml filename="JBossInstances.html"?> <title>How to Use Your Own JBoss AS Instance with JBDS</title> <para>Although <property>JBoss Developer Studio</property> works closely with - <property>JBoss EAP 4.2</property> we do not ultimately tie you to any particular + <property>JBoss EAP 4.3</property> we do not ultimately tie you to any particular server for deployment. There are some servers that Studio supports directly (via the bundled Eclipse WTP plug-ins). In this section we discuss how to manage self-installed JBoss AS. Suppose you want to deploy the application to <property>JBoss 4.2.3 @@ -151,7 +151,7 @@ <title>JBoss AS Installation</title> <itemizedlist> <listitem> - <para>Download the binary package of <property>JBoss 4.2.3</property> and save + <para>Download the binary package of JBoss AS, e.g. <property>JBoss 4.2.3</property> and save it on your computer: <ulink url="http://labs.jboss.com/jbossas/downloads" >http://labs.jboss.com/jbossas/downloads</ulink></para> </listitem> Modified: branches/jbosstools-3.0.x/documentation/guides/GettingStartedGuide/en/modules/project_examples.xml =================================================================== --- branches/jbosstools-3.0.x/documentation/guides/GettingStartedGuide/en/modules/project_examples.xml 2009-05-11 15:33:05 UTC (rev 15157) +++ branches/jbosstools-3.0.x/documentation/guides/GettingStartedGuide/en/modules/project_examples.xml 2009-05-11 15:38:03 UTC (rev 15158) @@ -40,7 +40,7 @@ </figure> <itemizedlist> - <listitem><para>Now in the New Project Example dialog you can select a project you would like to explore</para> + <listitem><para>Now in the New Project Example dialog you can select a project you would like to explore and a site to download it from</para> <para>Project Examples Wizard provides a filter field to more easily locate the project examples you want, so you can type in the project you would like to explore in the field.</para></listitem> </itemizedlist> Modified: branches/jbosstools-3.0.x/documentation/guides/GettingStartedGuide/en/modules/rad_jsf_application.xml =================================================================== --- branches/jbosstools-3.0.x/documentation/guides/GettingStartedGuide/en/modules/rad_jsf_application.xml 2009-05-11 15:33:05 UTC (rev 15157) +++ branches/jbosstools-3.0.x/documentation/guides/GettingStartedGuide/en/modules/rad_jsf_application.xml 2009-05-11 15:38:03 UTC (rev 15158) @@ -571,25 +571,24 @@ <para>The Visual Page Editor will open in a screen split between source code along the top and a WYSIWIG view along the bottom. You can see that some JSF code will be already generated as we choose a template when creating the page.</para> - <para>At the beginning it's necessary to create a <emphasis role="bold"> - <property><h:form></property> - </emphasis> component where all others components are put.</para> + <para>At the beginning it's necessary to create a + <code><h:form></code> + component where all others components are put.</para> <itemizedlist> <listitem> - <para>Place the mouse cursor inside <emphasis role="bold"> - <property><f:view></property> - </emphasis><emphasis role="bold"> - <property></f:view></property> - </emphasis></para> + <para>Place the mouse cursor inside + <code><f:view> + </f:view></code> + </para> </listitem> <listitem> <para>Go to JBoss Tools Palette and expand JSF HTML folder by selecting it</para> </listitem> <listitem> - <para>Click on <emphasis role="bold"> - <property><h:form></property> - </emphasis> tag <figure> + <para>Click on + <code><h:form></code> + tag <figure> <title>Insert h:form</title> <mediaobject> <imageobject> @@ -720,11 +719,11 @@ </figure> <itemizedlist> <listitem> - <para>Switch to Source mode and insert <emphasis role="bold"> - <property><br/></property> - </emphasis> tag after <emphasis role="bold"> - <property><h:outputText></property> - </emphasis> component to make a new line.</para> + <para>Switch to Source mode and insert + <code><br/></code> + tag after + <code><h:outputText></code> + component to make a new line.</para> </listitem> <listitem> <para>Click <emphasis> @@ -737,11 +736,11 @@ editor, and drop it inside the editor after the text.</para> </listitem> <listitem> - <para>Switch to a Source mode and insert <emphasis role="bold"> - <property><br/></property> - </emphasis> tag after <emphasis role="bold"> - <property><h:outputText></property> - </emphasis> component to make a new line</para> + <para>Switch to a Source mode and insert + <code><br/></code> + tag after + <code><h:outputText></code> + component to make a new line</para> </listitem> <listitem> <para>Click <emphasis> @@ -826,9 +825,9 @@ <para>Go to Source mode</para> </listitem> <listitem> - <para>Add the validation attribute to <emphasis role="bold"> - <property><f:validateLongRange></property> - </emphasis> for user input validation</para> + <para>Add the validation attribute to + <code><f:validateLongRange></code> + for user input validation</para> </listitem> </itemizedlist> <programlisting role="XML"><![CDATA[<h:inputText id="userNumber" value="#{NumberBean.userNumber}" required="true"> @@ -890,37 +889,41 @@ </emphasis></para> </listitem> <listitem> - <para>In Source mode add <emphasis role="bold"> - <property><br/></property> - </emphasis> tags between <emphasis role="bold"> - <property><outputText></property> - </emphasis>, <emphasis role="bold"> - <property><inputText></property> - </emphasis> and <emphasis role="bold"> - <property><commandButton></property> - </emphasis> components to place them on different lines</para> + <para>In Source mode add + <code><br/></code> + tags between + <code><outputText></code> + , <code><inputText></code> + and <code><commandButton></code> + components to place them on different lines</para> </listitem> </itemizedlist> <para>inputnumber.jsp page should look like this:</para> <programlisting role="XML"><![CDATA[<%@ taglib uri="http://java.sun.com/jsf/html" prefix="h" %> <%@ taglib uri="http://java.sun.com/jsf/core" prefix="f" %> -<f:loadBundle basename="game.messages" var="msg"/> - +<f:loadBundle basename="game.messages" var="msg" /> <html> - <f:view> - <h:form id="inputNumbers"> - <h:outputText value="#{msg.how_to_play}"/> - <br/> - <h:messages style="color: blue"/> - <br/> - <h:inputText id="userNumber" value="#{NumberBean.userNumber}" required="true"> - <f:validateLongRange minimum="0" maximum="100"/> - </h:inputText> - <br/><br/> - <h:commandButton value= - "#{msg.makeguess_button}" action="#{NumberBean.checkGuess}"/> - </h:form> - </f:view> +<head> +<title></title> +</head> + <body> + <f:view> + <h:form id="inputNumbers"> + <h:outputText value="#{msg.how_to_play}" /> + <br /> + <h:messages style="color: blue" /> + <br /> + <h:inputText value="#{NumberBean.userNumber}" id="userNumber" + required="true"> + <f:validateLongRange minimum="0" maximum="100" /> + </h:inputText> + <br /> + <br /> + <h:commandButton value="#{msg.makeguess_button}" + action="#{NumberBean.checkGuess}" /> + </h:form> + </f:view> + </body> </html> ]]></programlisting> </section> @@ -934,17 +937,24 @@ <f:loadBundle basename="game.messages" var="msg"/> <html> - <f:view> - <h:form id="result"> - <h:outputFormat value="#{msg.success_text}"> - <f:param value="#{NumberBean.userNumber}"/> - </h:outputFormat> - <br/><br/> - <h:commandButton value= - "#{msg.trayagain_button}" action="#{NumberBean.playagain}"/> - </h:form> - </f:view> + <head> + <title></title> + </head> + <body> + <f:view> + <h:form id="result"> + <h:outputFormat value="#{msg.success_text}"> + <f:param value="#{NumberBean.userNumber}" /> + </h:outputFormat> + <br /> + <br /> + <h:commandButton value="#{msg.trayagain_button}" + action="#{NumberBean.playagain}" /> + </h:form> + </f:view> + </body> </html> + ]]></programlisting> <para>Again you can use code assist provided by JBDS when editing jsp page:</para> <figure> @@ -957,13 +967,11 @@ </mediaobject> </figure> <para>This page, success.jsp, is shown if you correctly guessed the number. The - <emphasis role="bold"> - <property><h:outputFormat></property> - </emphasis> tag will get the value of success_text from the properties file. The {0} + <code><h:outputFormat></code> + tag will get the value of success_text from the properties file. The {0} in success_text will be substituted for by the value of the value attribute within - the <emphasis role="bold"> - <property><f:param></property> - </emphasis> tag during runtime.</para> + the <code><f:param></code> + tag during runtime.</para> <para>At the end, you have a button which allows you to replay the game. The action value references a backing bean method. In this case, the method only terminates the current session so that when you are shown the first page, the input text box is Modified: branches/jbosstools-3.0.x/documentation/guides/GettingStartedGuide/pom.xml =================================================================== --- branches/jbosstools-3.0.x/documentation/guides/GettingStartedGuide/pom.xml 2009-05-11 15:33:05 UTC (rev 15157) +++ branches/jbosstools-3.0.x/documentation/guides/GettingStartedGuide/pom.xml 2009-05-11 15:38:03 UTC (rev 15158) @@ -72,10 +72,14 @@ <groupId>org.jboss.tools</groupId> <artifactId>jbosstools-docbook-xslt</artifactId> <version>1.0.0-SNAPSHOT</version> - </dependency> + </dependency> + <dependency> + <groupId>org.apache.xmlgraphics</groupId> + <artifactId>fop</artifactId> + <version>0.95</version> + </dependency> </dependencies> - - <configuration> + <configuration> <sourceDocumentName>${master}</sourceDocumentName> <sourceDirectory>${pom.basedir}/en</sourceDirectory> <imageResource> @@ -90,11 +94,11 @@ </cssResource> <formats> - <format> +  <format> <formatName>html</formatName> <stylesheetResource>${xsl-chunked}</stylesheetResource>

15 years, 1 month

1
0
0 / 0

JBoss Tools SVN: r15157 - in trunk/jbpm/plugins/org.jboss.tools.flow.jpdl4: src/org/jboss/tools/flow/jpdl4/editor and 1 other directories.

by jbosstools-commits＠lists.jboss.org

Author: koen.aers(a)jboss.com Date: 2009-05-11 11:33:05 -0400 (Mon, 11 May 2009) New Revision: 15157 Added: trunk/jbpm/plugins/org.jboss.tools.flow.jpdl4/src/org/jboss/tools/flow/jpdl4/model/MailTask.java Modified: trunk/jbpm/plugins/org.jboss.tools.flow.jpdl4/plugin.xml trunk/jbpm/plugins/org.jboss.tools.flow.jpdl4/src/org/jboss/tools/flow/jpdl4/editor/JpdlDeserializer.java trunk/jbpm/plugins/org.jboss.tools.flow.jpdl4/src/org/jboss/tools/flow/jpdl4/editor/JpdlPaletteFactory.java trunk/jbpm/plugins/org.jboss.tools.flow.jpdl4/src/org/jboss/tools/flow/jpdl4/editor/JpdlSerializer.java Log: enable mail, remove subprocess from palette Modified: trunk/jbpm/plugins/org.jboss.tools.flow.jpdl4/plugin.xml =================================================================== --- trunk/jbpm/plugins/org.jboss.tools.flow.jpdl4/plugin.xml 2009-05-11 15:22:07 UTC (rev 15156) +++ trunk/jbpm/plugins/org.jboss.tools.flow.jpdl4/plugin.xml 2009-05-11 15:33:05 UTC (rev 15157) @@ -133,6 +133,16 @@ </node> </element> <element + class="org.jboss.tools.flow.jpdl4.model.MailTask" + figure="icons/16/task_empty.png" + id="org.jboss.tools.flow.jpdl4.mailTask" + label="mail" + language="org.jboss.tools.flow.jpdl4"> + <node> + <figure class="org.jboss.tools.flow.jpdl4.figure.TaskFigure"></figure> + </node> + </element> + <element class="org.jboss.tools.flow.jpdl4.model.JavaTask" figure="icons/16/task_java.png" id="org.jboss.tools.flow.jpdl4.javaTask" Modified: trunk/jbpm/plugins/org.jboss.tools.flow.jpdl4/src/org/jboss/tools/flow/jpdl4/editor/JpdlDeserializer.java =================================================================== --- trunk/jbpm/plugins/org.jboss.tools.flow.jpdl4/src/org/jboss/tools/flow/jpdl4/editor/JpdlDeserializer.java 2009-05-11 15:22:07 UTC (rev 15156) +++ trunk/jbpm/plugins/org.jboss.tools.flow.jpdl4/src/org/jboss/tools/flow/jpdl4/editor/JpdlDeserializer.java 2009-05-11 15:33:05 UTC (rev 15157) @@ -419,6 +419,7 @@ else if ("java".equals(nodeName)) return "org.jboss.tools.flow.jpdl4.javaTask"; else if ("script".equals(nodeName)) return "org.jboss.tools.flow.jpdl4.scriptTask"; else if ("esb".equals(nodeName)) return "org.jboss.tools.flow.jpdl4.serviceTask"; + else if ("mail".equals(nodeName)) return "org.jboss.tools.flow.jpdl4.mailTask"; else if ("task".equals(nodeName)) return "org.jboss.tools.flow.jpdl4.humanTask"; else if ("sub-process".equals(nodeName)) return "org.jboss.tools.flow.jpdl4.subprocessTask"; else if ("decision".equals(nodeName)) return "org.jboss.tools.flow.jpdl4.exclusiveGateway"; Modified: trunk/jbpm/plugins/org.jboss.tools.flow.jpdl4/src/org/jboss/tools/flow/jpdl4/editor/JpdlPaletteFactory.java =================================================================== --- trunk/jbpm/plugins/org.jboss.tools.flow.jpdl4/src/org/jboss/tools/flow/jpdl4/editor/JpdlPaletteFactory.java 2009-05-11 15:22:07 UTC (rev 15156) +++ trunk/jbpm/plugins/org.jboss.tools.flow.jpdl4/src/org/jboss/tools/flow/jpdl4/editor/JpdlPaletteFactory.java 2009-05-11 15:33:05 UTC (rev 15157) @@ -169,15 +169,15 @@ ImageDescriptor.createFromURL(Activator.getDefault().getBundle().getEntry("icons/32/task_empty.png")) ); entries.add(combined); - combined = new CombinedTemplateCreationEntry( - "sub-process", - "Create a new Subprocess", - "org.jboss.tools.flow.jpdl4.subprocess", - ElementRegistry.getCreationFactory("org.jboss.tools.flow.jpdl4.subprocessTask"), - ImageDescriptor.createFromURL(Activator.getDefault().getBundle().getEntry("icons/16/task_empty.png")), - ImageDescriptor.createFromURL(Activator.getDefault().getBundle().getEntry("icons/32/task_empty.png")) - ); - entries.add(combined); +// combined = new CombinedTemplateCreationEntry( +// "sub-process", +// "Create a new Subprocess", +// "org.jboss.tools.flow.jpdl4.subprocess", +// ElementRegistry.getCreationFactory("org.jboss.tools.flow.jpdl4.subprocessTask"), +// ImageDescriptor.createFromURL(Activator.getDefault().getBundle().getEntry("icons/16/task_empty.png")), +// ImageDescriptor.createFromURL(Activator.getDefault().getBundle().getEntry("icons/32/task_empty.png")) +// ); +// entries.add(combined); return entries; } Modified: trunk/jbpm/plugins/org.jboss.tools.flow.jpdl4/src/org/jboss/tools/flow/jpdl4/editor/JpdlSerializer.java =================================================================== --- trunk/jbpm/plugins/org.jboss.tools.flow.jpdl4/src/org/jboss/tools/flow/jpdl4/editor/JpdlSerializer.java 2009-05-11 15:22:07 UTC (rev 15156) +++ trunk/jbpm/plugins/org.jboss.tools.flow.jpdl4/src/org/jboss/tools/flow/jpdl4/editor/JpdlSerializer.java 2009-05-11 15:33:05 UTC (rev 15157) @@ -40,6 +40,7 @@ import org.jboss.tools.flow.jpdl4.model.HumanTask; import org.jboss.tools.flow.jpdl4.model.JavaTask; import org.jboss.tools.flow.jpdl4.model.JoinParallelGateway; +import org.jboss.tools.flow.jpdl4.model.MailTask; import org.jboss.tools.flow.jpdl4.model.Process; import org.jboss.tools.flow.jpdl4.model.ProcessNode; import org.jboss.tools.flow.jpdl4.model.ScriptTask; @@ -187,6 +188,7 @@ else if ("org.jboss.tools.flow.jpdl4.sqlTask".equals(elementId)) return "sql"; else if ("org.jboss.tools.flow.jpdl4.javaTask".equals(elementId)) return "java"; else if ("org.jboss.tools.flow.jpdl4.scriptTask".equals(elementId)) return "script"; + else if ("org.jboss.tools.flow.jpdl4.mailTask".equals(elementId)) return "mail"; else if ("org.jboss.tools.flow.jpdl4.serviceTask".equals(elementId)) return "esb"; else if ("org.jboss.tools.flow.jpdl4.humanTask".equals(elementId)) return "task"; else if ("org.jboss.tools.flow.jpdl4.subprocessTask".equals(elementId)) return "sub-process"; @@ -503,8 +505,10 @@ new ProcessNodeWrapperSerializer().appendOpening(buffer, wrapper, level); } else if (element instanceof JavaTask) { new ProcessNodeWrapperSerializer().appendOpening(buffer, wrapper, level); - } else if (element instanceof ScriptTask) { + } else if (element instanceof ScriptTask) { new ProcessNodeWrapperSerializer().appendOpening(buffer, wrapper, level); + } else if (element instanceof MailTask) { + new ProcessNodeWrapperSerializer().appendOpening(buffer, wrapper, level); } else if (element instanceof ServiceTask) { new ProcessNodeWrapperSerializer().appendOpening(buffer, wrapper, level); } else if (element instanceof HumanTask) { @@ -621,6 +625,8 @@ buffer.append("</java>"); } else if (element instanceof ScriptTask) { buffer.append("</script>"); + } else if (element instanceof MailTask) { + buffer.append("</mail>"); } else if (element instanceof ServiceTask) { buffer.append("</esb>"); } else if (element instanceof HumanTask) { Added: trunk/jbpm/plugins/org.jboss.tools.flow.jpdl4/src/org/jboss/tools/flow/jpdl4/model/MailTask.java =================================================================== --- trunk/jbpm/plugins/org.jboss.tools.flow.jpdl4/src/org/jboss/tools/flow/jpdl4/model/MailTask.java (rev 0) +++ trunk/jbpm/plugins/org.jboss.tools.flow.jpdl4/src/org/jboss/tools/flow/jpdl4/model/MailTask.java 2009-05-11 15:33:05 UTC (rev 15157) @@ -0,0 +1,10 @@ +package org.jboss.tools.flow.jpdl4.model; + + +public class MailTask extends Task { + + protected boolean isPropagationExclusive() { + return true; + } + +} Property changes on: trunk/jbpm/plugins/org.jboss.tools.flow.jpdl4/src/org/jboss/tools/flow/jpdl4/model/MailTask.java ___________________________________________________________________ Name: svn:mime-type + text/plain

15 years, 1 month

1
0
0 / 0

JBoss Tools SVN: r15156 - branches/jbosstools-3.0.x/birt/docs/en.

by jbosstools-commits＠lists.jboss.org

Author: smukhina Date: 2009-05-11 11:22:07 -0400 (Mon, 11 May 2009) New Revision: 15156 Added: branches/jbosstools-3.0.x/birt/docs/en/master_output.xml Removed: branches/jbosstools-3.0.x/birt/docs/en/master_output.xml Log: https://jira.jboss.org/jira/browse/JBDS-717 merged changes from trunk are added to the corresponding branch Deleted: branches/jbosstools-3.0.x/birt/docs/en/master_output.xml =================================================================== --- branches/jbosstools-3.0.x/birt/docs/en/master_output.xml 2009-05-11 15:18:11 UTC (rev 15155) +++ branches/jbosstools-3.0.x/birt/docs/en/master_output.xml 2009-05-11 15:22:07 UTC (rev 15156) @@ -1,1103 +0,0 @@ -<?xml version="1.0" encoding="UTF-8"?> -<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" -"http://www.docbook.org/xml/4.3/docbookx.dtd" - -[ -<!ENTITY introduction SYSTEM "modules/introduction.xml"> -<!ENTITY birt_support SYSTEM "modules/birt_support.xml"> -<!ENTITY birt_designer SYSTEM "modules/birt_designer.xml"> -<!ENTITY birt_integration SYSTEM "modules/birt_integration.xml"> - - - -]><book xmlns:diffmk="http://diffmk.sf.net/ns/diff"> - <bookinfo> - <title>Birt Plugin Reference Guide</title> - - <author><firstname>Anastasiya</firstname><surname>Bogachuk</surname><email>abogachuk(a)exadel.com</email></author> - - - <pubdate>August 2008</pubdate> - <copyright> - <year>2008</year> - <year diffmk:change="added"><diffmk:wrapper diffmk:change="added">2009</diffmk:wrapper></year> - <holder><diffmk:wrapper diffmk:change="changed">JBoss, a division of Red Hat</diffmk:wrapper></holder> - </copyright> - <releaseinfo><diffmk:wrapper diffmk:change="changed"> - Version: 1.0.0.GA - </diffmk:wrapper></releaseinfo> - - -<abstract> - <title></title> - <para> - <ulink url="http://download.jboss.org/jbosstools/nightly-docs/en/jboss_birt_plugin_re...">PDF version</ulink> - </para> -</abstract> - - - </bookinfo> - <toc></toc> - - - -<chapter id="introduction" xml:base="file:///home/ochikvina/WORK/for_compare/trunk/birt/docs/en/modules/introduction.xml"> - <?dbhtml filename="introduction.html"?> - - <chapterinfo> - <keywordset> - <keyword>JBoss Developer Studio</keyword> - <keyword>Eclipse</keyword> - <keyword>Java</keyword> - <keyword>JBoss</keyword> - <keyword>JBoss Tools</keyword> - <keyword>JBDS</keyword> - <keyword>BIRT</keyword> - <keyword>BIRT Plugin</keyword> - </keywordset> - </chapterinfo> - - <title>Introduction</title> - - <section> - - <title>What is BIRT?</title> - <para>BIRT plugin for JBoss Developer Studio is an Eclipse-based open source reporting - system for web applications based on Java and J2EE. BIRT consists of two main - components: a report designer based on Eclipse, and a runtime component that can be - added to your app server. BIRT also offers a charting engine that lets you add charts to - your own Web application.</para> - <para>With the help of BIRT you can generate a great number of reports to be used in your - application:</para> - - <itemizedlist> - <listitem> - <para>Lists</para> - </listitem> - <listitem> - <para>Charts</para> - </listitem> - <listitem> - <para>Crosstabs, or cross-tabulation, or matrix</para> - </listitem> - <listitem> - <para>Letters and Documents</para> - </listitem> - <listitem> - <para>Compound Reports</para> - </listitem> - </itemizedlist> - - <para><diffmk:wrapper diffmk:change="changed">In this guide we provide you with the information on BIRT Designer which allows to - create a report much faster and with far fewer errors to spare your time.</diffmk:wrapper></para> - - <literallayout class="normal" format="linespecific"> </literallayout> - <para>You can find detailed information on the BIRT report types and anatomy here: <ulink url="http://www.eclipse.org/birt/phoenix/intro/">JBoss BIRT</ulink></para> - - - <para><diffmk:wrapper diffmk:change="changed">All JBoss Developer Studio/JBoss Tools documentation you can find on</diffmk:wrapper><ulink url="http://docs.jboss.org/tools/"><diffmk:wrapper diffmk:change="changed">documentation release page</diffmk:wrapper></ulink>.</para> - <para><diffmk:wrapper diffmk:change="changed">The latest documentation builds are available on </diffmk:wrapper><ulink url="http://download.jboss.org/jbosstools/nightly-docs/"><diffmk:wrapper diffmk:change="changed">documentation nightly builds page</diffmk:wrapper></ulink>.</para> - - </section> - -</chapter> - - -<chapter id="esb_support" xml:base="file:///home/ochikvina/WORK/for_compare/trunk/birt/docs/en/modules/birt_support.xml"> - <?dbhtml filename="esb_support.html"?> - <chapterinfo> - <keywordset> - <keyword>JBoss Developer Studio</keyword> - <keyword>Eclipse</keyword> - <keyword>BIRT</keyword> - <keyword>Java</keyword> - <keyword>JBoss</keyword> - </keywordset> - </chapterinfo> - - <title>BIRT Support</title> - - <para>In this section we will focus more on all concepts that JBoss Tools integrates for - working with BIRT.</para> - - <section> - <title>BIRT Plugin Installation</title> - - <para>This chapter will provide you with detailed information on how to install BIRT plugin into JBoss Developer Studio.</para> - - <para>Since BIRT plugin is one of the modules of JBoss Tools project it has a dependence on other modules and will require their pre-installation. </para> - - <para>These are the prerequisites to create a web project including Seam and BIRT capabilities:</para> - <itemizedlist> - <listitem><para>Eclipse Version 3.4 SDK</para></listitem> - <listitem><para>DTP Version 1.6 Release</para></listitem> - <listitem><para>EMF Version 2.4 Release EMF+XSD</para></listitem> - <listitem><para>GEF Version 3.4 Release runtime</para></listitem> - <listitem><para>WTP Version 3.0 Release</para></listitem> - <listitem><para><ulink url="http://repository.jboss.org/eclipse/birt/2.3.0/birt-report-framework-2_3_...">BIRT Report Designer SDK 2.3.0 Release</ulink> or BIRT Report Designer 2.3.0 Release</para></listitem> - <listitem><para>JBoss Application Server 4.2.2 GA</para></listitem> - <listitem><para>JBoss Seam 2.0.1 GA</para></listitem> - <listitem><para><ulink url="http://repository.jboss.org/eclipse/birt/2.3.0/birt-wtp-integration-sdk-2...">BIRT Web Tools Integration</ulink></para></listitem> - <listitem><para>JBoss Tools nightly build</para></listitem> - - </itemizedlist> - - - - </section> - -<section> - - <title>JBoss BIRT Integration</title> - <para>To understand Hibernate configuration, integration with Seam, and deployment see <ulink url="http://docs.jboss.org/tools/whatsnew/birt/birt-news-1.0.0.Alpha1.html">JBoss BIRT Integration 1.0.0.alpha1 - New and Noteworthy</ulink>.</para> - -</section> - - <section> - <title>Creating a BIRT Report</title> - <para>In this chapter we suggest a step-by-step walk-through of creating your own BIRT report.</para> - - <section><title>Create a Report Project</title> - - <para>First create a Report project. Select <emphasis><property moreinfo="none">File > New > Project...</property> - </emphasis> in the main menu bar or context menu. The new project dialog appears. Choose <emphasis><property moreinfo="none">Business Intelligence and Reporting Tools > Report Project</property></emphasis>: - - <figure float="0"> - <title>New Report Project Creation</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/BirtSupport/01ReportProjectWizard.png"></imagedata> - </imageobject> - </mediaobject> - </figure> - - Click on the <emphasis><property moreinfo="none">Next</property></emphasis> button. Specify a name for the project and change location if necessary:</para> - - <figure float="0"> - <title>Specify a Name for the Report Project</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/BirtSupport/02ProjectName.png"></imagedata> - </imageobject> - </mediaobject> - </figure> - - <para>Click on the <emphasis><property moreinfo="none">Finish</property></emphasis> button. Click <emphasis><property moreinfo="none">Ok</property></emphasis> to switch to the Report Design perspective. Your Report Project is now created:</para> - - - <figure float="0"> - <title>New Report Project Created</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/BirtSupport/03NewProjectCreated.png"></imagedata> - </imageobject> - </mediaobject> - </figure> - </section> - - <section> <title>Create a Report</title> - <para>Now you can create a Report. Go to <emphasis><property moreinfo="none">File > New > Report...</property></emphasis>:</para> - - <figure float="0"> - <title>Create a New Report</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/BirtSupport/04NewReport.png"></imagedata> - </imageobject> - </mediaobject> - </figure> - - <para>The new report dialog appears. Select the created project as a parent folder in the tree view:</para> - - <figure float="0"> - <title>Select a Parent Folder</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/BirtSupport/05SelectingParentFolder.png"></imagedata> - </imageobject> - </mediaobject> - </figure> - - <para>Click on the <emphasis><property moreinfo="none">Next</property></emphasis> button. Then select the type of the template to use for your report. Each template is shown in the Preview window and is described below. Tick off the "Show Report Creation Cheat Sheet" checkbox if you don't need the Cheat Sheets view to be displayed. The Cheat Sheets view can walk you though the process of creating a report based on the template you selected. - - <figure float="0"> - <title>Choose a Report Template</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/BirtSupport/06ReportTemplate.png"></imagedata> - </imageobject> - </mediaobject> - </figure> - - - Click on the <emphasis><property moreinfo="none">Finish</property></emphasis> button to open the newly created report in the workspace:</para> - - <figure float="0"> - <title>Report Opened in the Workspace</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/BirtSupport/07SimpleListingReport.png"></imagedata> - </imageobject> - </mediaobject> - </figure> - - </section> - - <section> - <title>Build a Data Source</title> - - <para>Data source is used to connect to the database. In order to create a data source for your report follow these steps:</para> - <para>Open the Data Explorer View. Select Data Sources, right-click on it and choose New Data Source:</para> - - - <figure float="0"> - <title>Create a Data Source</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/BirtSupport/08DataSource.png"></imagedata> - </imageobject> - </mediaobject> - </figure> - - <para><diffmk:wrapper diffmk:change="changed">The New Data Source dialog appears. Choose the "Create from a data source type in the following list" radio button and then "Classic Models Inc. Sample Database". Click on the </diffmk:wrapper><emphasis><property moreinfo="none">Next</property></emphasis> button:</para> - - - <figure float="0"> - <title>New Data Source</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/BirtSupport/09NewDataSource.png"></imagedata> - </imageobject> - </mediaobject> - </figure> - - <para>The newly created data source details wll be displayed: Driver Class, Database URL and Database User:</para> - - <figure float="0"> - <title>New Data Source Details</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/BirtSupport/10NewSampleDateSource.png"></imagedata> - </imageobject> - </mediaobject> - </figure> - <para>Click on the <emphasis><property moreinfo="none">Finish</property></emphasis> button to add the data source to the data source for your report.</para> - - <para><diffmk:wrapper diffmk:change="changed">If you need to edit the data source, right-click on it and select the corresponding option.</diffmk:wrapper></para> - </section> - - - <section><title>Build a Data Set</title> - - <para>Data Set is a query to get and represent necessary column data from the data source specified. Select Data Sets in the tree view, right-click on it and select New Data Set:</para> - - <figure float="0"> - <title>Create a Data Set</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/BirtSupport/11DataSet.png"></imagedata> - </imageobject> - </mediaobject> - </figure> - - - <para>The New Data Set dialog will appear. Enter a name for the Data Set Name field and ensure that the Data Source field shows the data source already created and that the Data Set Type field is set to "SQL Select Query". - Then click on the <emphasis><property moreinfo="none">Next</property></emphasis> button:</para> - - - <figure float="0"> - <title>New Data Set Details</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/BirtSupport/12NewDataSet.png"></imagedata> - </imageobject> - </mediaobject> - </figure> - - <para>Enter the following details into the query:</para> - <programlisting format="linespecific"><![CDATA[ -SELECT * -FROM CUSTOMERS -WHERE COUNTRY = 'USA']]></programlisting> - - - <figure float="0"> - <title>Query Details</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/BirtSupport/13SQLQuery.png"></imagedata> - </imageobject> - </mediaobject> - </figure> - - - <para>Click on the <emphasis><property moreinfo="none">Finish</property></emphasis> button. The Edit Data Set window opens where you can change Data Source, Settings, Parameters and other details for the Data Set created. If switched to the Query page you can check the schemas within this database, you can expand them to see the list of tables with their columns:</para> - - - <figure float="0"> - <title>Edit the Data Set</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/BirtSupport/14EditDataSet.png"></imagedata> - </imageobject> - </mediaobject> - </figure> - - <para>Switch to the Preview page to test your query and verify whether the list of customers appears:</para> - - <figure float="0"> - <title>Test the Query</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/BirtSupport/15TestQuery.png"></imagedata> - </imageobject> - </mediaobject> - </figure> - - <para>Click on the <emphasis><property moreinfo="none">Ok</property></emphasis> button.</para> - </section> - - <section><title>Create Report Layout</title> - - <para>After the Data source and Data set are specified you can continue with the report layout. Please see the <xref linkend="Birt_Designer"></xref> chapter to learn more about BIRT Report Designer.</para> - - </section> - - - </section> - -</chapter> - - -<chapter id="Birt_Designer" xml:base="file:///home/ochikvina/WORK/for_compare/trunk/birt/docs/en/modules/birt_designer.xml" xreflabel="Birt_Designer"> - <?dbhtml filename="birtDesigner.html"?> - <chapterinfo> - <keywordset> - <keyword>JBoss</keyword> - <keyword>BIRT</keyword> - <keyword>BIRT Designer</keyword> - <keyword>BIRT Report Designer</keyword> - </keywordset> - </chapterinfo> - - <title>BIRT Report Designer</title> - - <para>BIRT Designer is an intuitive and quite easy Eclipse-based set of plugins to make reports. - In this chapter we will describe its interface and its features to you.</para> - - <section id="birt_designer_UI" xreflabel="birt_designer_UI"> - <title>BIRT User Interface</title> - - <para>The central part of the user interface is the <property moreinfo="none">Layout Editor</property>. It - displays the whole process of building a report and contains the following tabs:</para> - - <itemizedlist> - <listitem> - <para><emphasis role="bold">Layout</emphasis> - this is an area where you can edit - your report design;</para> - </listitem> - <listitem> - <para><emphasis role="bold">Preview</emphasis> - runs your report created and shows - the output;</para> - </listitem> - <listitem> - <para><emphasis role="bold">Script</emphasis> - on this page you can add JavaScript - to your report to customize its behavior;</para> - </listitem> - <listitem> - <para><emphasis role="bold">XML Source</emphasis> - this is an area where you can - view and modify the XML source of your report;</para> - </listitem> - <listitem> - <para><emphasis role="bold">Master Page</emphasis> - use it to format page - data.</para> - </listitem> - </itemizedlist> - - <para>The next part of user interface is different <property moreinfo="none">Views</property> that can be - arranged around the Layout Editor area the way you like:</para> - - <itemizedlist> - <listitem> - <para><emphasis role="bold">Palette</emphasis> - shows the standard report items you - can add to your report using drag and drop.</para> - </listitem> - <listitem> - <para><emphasis role="bold">Outline</emphasis> - shows the structure of your report - as a tree view.</para> - </listitem> - <listitem> - <para><emphasis role="bold">Navigator</emphasis> - shows your projects and reports - within the projects.</para> - </listitem> - <listitem> - <para><emphasis role="bold">Data Explorer</emphasis> - shows your data sources, data - sets and report parameters. You also can use this view to add data set columns - to your report layout.</para> - </listitem> - <listitem> - <para><emphasis role="bold">Property Editor</emphasis> - displays properties for - many report items.</para> - </listitem> - <listitem> - <para><emphasis role="bold">Properties View</emphasis> - shows all properties for a - report item as a simple list.</para> - </listitem> - <listitem> - <para><emphasis role="bold">Library Explorer View</emphasis> - allows the reuse of - report objects, such as tables, data sources and styles. Objects created for - reuse are stored in a library file. The Library Explorer will display Libraries - that exist in the Resource folder. Developed libraries can be added to the - resource folder by selecting <emphasis>File→Publish Library in Resource - Folder</emphasis>. The resource folder location can be configured. </para> - </listitem> - - </itemizedlist> - - </section> - - <section id="birt_designer_features"> - - <title>BIRT Report Designer Features</title> - <para>Here are the main BIRT Report Designer features:</para> - <itemizedlist> - <listitem> - <para><emphasis role="bold">Palette</emphasis> - contains tables, labels, and - charts. It is used in conjunction with the Layout View to design reports.</para> - </listitem> - <listitem> - <para><emphasis role="bold">Data Explorer</emphasis> - organizes your data sources - and data sets. The Data Sets editor enables testing your data set to check - whether the report receives the correct data. You can also create cubes using - your data sets (when building any dynamic cross tables) and design necessary - report parameters.</para> - </listitem> - <listitem> - <para><emphasis role="bold">Resource Explorer</emphasis> - BIRT allows the reuse of - report objects, such as tables, data sources and styles. Objects created for - reuse are stored in a library file. To browse the contents of report libraries - BIRT supplies the Resource Explorer view. This view lists all libraries within - the resource folder, in addition to other shared content such as images and - JavaScript files.</para> - </listitem> - <listitem> - <para><emphasis role="bold">Property Editor</emphasis> - shows the most commonly - used properties. BIRT also integrates with the standard Eclipse property view to - display a detailed listing of all properties for an item.</para> - </listitem> - <listitem> - <para><emphasis role="bold">Layout View</emphasis> - WYSIWYG editor. You can select - any element from the Palette, drag and drop it to the report and then edit the - way you like.</para> - </listitem> - <listitem> - <para><emphasis role="bold">Script Editor</emphasis> - scripting adds business logic - to reports during data access, report generation, or viewing. The code editor - provides standard features for editing scripts: syntax coloring, auto-complete - etc. You also can debug scripts when the report is running.</para> - </listitem> - <listitem> - <para><emphasis role="bold">Report Preview</emphasis> - Report Preview is used to - test your newly created report with some real data.</para> - </listitem> - <listitem> - <para><emphasis role="bold">Chart Builder</emphasis> - using the Chart Builder you - can add any charts to the design of your report. Just select a chart type, then - data and, finally, format the chart.</para> - </listitem> - <listitem> - <para><emphasis role="bold">Expression Builder </emphasis> - expressions are simple - scripts that return a value. They are used to assign data values to report - elements, build image locations, hyperlinks, parameter default values - etc.</para> - </listitem> - <listitem> - <para><emphasis role="bold">Cheat Sheets</emphasis> - Cheat sheets are small pices - of useful documentation that lead you through a report creation process. Just - select what you need and then follow the instructions.</para> - </listitem> - <listitem> - <para><emphasis role="bold">Outline</emphasis> - this view provides a compact - overview of the entire report structure.</para> - </listitem> - </itemizedlist> - - <para><diffmk:wrapper diffmk:change="changed">In this guide we made a short overview of the BIRT plugin: its installation, support, - features etc. that will help you to make your first steps with it.</diffmk:wrapper></para> - - </section> - -</chapter> - - -<chapter diffmk:change="added" id="Birt_Integration" xml:base="file:///home/ochikvina/WORK/for_compare/trunk/birt/docs/en/modules/birt_integration.xml" xreflabel="Birt_Integration"> - - <?dbhtml filename="birtSeamWebProject.html"?> - <chapterinfo diffmk:change="added"> - <keywordset diffmk:change="added"> - <keyword diffmk:change="added"><diffmk:wrapper diffmk:change="added">JBoss</diffmk:wrapper></keyword> - <keyword diffmk:change="added"><diffmk:wrapper diffmk:change="added">BIRT</diffmk:wrapper></keyword> - <keyword diffmk:change="added"><diffmk:wrapper diffmk:change="added">Seam</diffmk:wrapper></keyword> - </keywordset> - </chapterinfo> - <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">Birt Integration</diffmk:wrapper></title> - - <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">This chapter covers the steps required for BIRT Integration</diffmk:wrapper></para> - - <section diffmk:change="added" id="Birt_Seam_Web_Project" xreflabel="Birt_Seam_Web_Project"> - <title diffmk:change="added"><diffmk:wrapper diffmk:change="added"> Adding JBoss BIRT functionality to the standard Seam web project</diffmk:wrapper></title> - - <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">In this section you'll find out how to create a web project including Seam and BIRT capabilities </diffmk:wrapper></para> - - <section diffmk:change="added" id="prerequisites" xreflabel="prerequisites"> - <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">Prerequisites</diffmk:wrapper></title> - - <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">These are the prerequisites required to create a Seam web project including with BIRT functionality:</diffmk:wrapper></para> - - <itemizedlist diffmk:change="added"> - <listitem diffmk:change="added"> - <para diffmk:change="added"> - <ulink diffmk:change="added" url="http://download.eclipse.org/eclipse/downloads/drops/R-3.4-200806172000/in..."><diffmk:wrapper diffmk:change="added">Eclipse Version 3.4 SDK</diffmk:wrapper></ulink> - </para> - </listitem> - <listitem diffmk:change="added"> - <para diffmk:change="added"> - <ulink diffmk:change="added" url="http://www.eclipse.org/downloads/download.php?file=/datatools/downloads/1..."><diffmk:wrapper diffmk:change="added">DTP Version 1.6 Release</diffmk:wrapper></ulink> - </para> - </listitem> - <listitem diffmk:change="added"> - <para diffmk:change="added"> - <ulink diffmk:change="added" url="http://www.eclipse.org/modeling/emf/downloads/?project=emf"><diffmk:wrapper diffmk:change="added">EMF Version 2.4 Release EMF+XSD</diffmk:wrapper></ulink> - </para> - </listitem> - <listitem diffmk:change="added"> - <para diffmk:change="added"> - <ulink diffmk:change="added" url="http://www.eclipse.org/gef/downloads/"><diffmk:wrapper diffmk:change="added">GEF Version 3.4 Release runtime</diffmk:wrapper></ulink> - </para> - </listitem> - <listitem diffmk:change="added"> - <para diffmk:change="added"> - <ulink diffmk:change="added" url="http://download.eclipse.org/webtools/downloads/drops/R3.0/R-3.0-200806161..."><diffmk:wrapper diffmk:change="added">WTP Version 3.0 Release</diffmk:wrapper></ulink> - </para> - </listitem> - <listitem diffmk:change="added"> - <para diffmk:change="added"> - <ulink diffmk:change="added" url="http://www.eclipse.org/downloads/download.php?file=/birt/downloads/drops/..."><diffmk:wrapper diffmk:change="added">BIRT Report Designer SDK 2.3.0 Release</diffmk:wrapper></ulink><diffmk:wrapper diffmk:change="added"> or </diffmk:wrapper><ulink diffmk:change="added" url="http://www.eclipse.org/downloads/download.php?file=/birt/downloads/drops/..."><diffmk:wrapper diffmk:change="added">BIRT Report Designer 2.3.0 Release</diffmk:wrapper></ulink> - </para> - </listitem> - <listitem diffmk:change="added"> - <para diffmk:change="added"> - <ulink diffmk:change="added" url="http://sourceforge.net/project/showfiles.php?group_id=22866&package_i..."><diffmk:wrapper diffmk:change="added">JBoss Application Server 4.2.2 GA</diffmk:wrapper></ulink> - </para> - </listitem> - <listitem diffmk:change="added"> - <para diffmk:change="added"> - <ulink diffmk:change="added" url="http://sourceforge.net/project/showfiles.php?group_id=22866&package_i..."><diffmk:wrapper diffmk:change="added">JBoss Seam 2.0.1 GA</diffmk:wrapper></ulink> - </para> - </listitem> - <listitem diffmk:change="added"> - <para diffmk:change="added"> - <ulink diffmk:change="added" url="http://www.eclipse.org/downloads/download.php?file=/birt/downloads/drops/..."><diffmk:wrapper diffmk:change="added">BIRT Web Tools Integration</diffmk:wrapper></ulink> - </para> - </listitem> - <listitem diffmk:change="added"> - <para diffmk:change="added"> - <ulink diffmk:change="added" url="http://download.jboss.org/jbosstools/builds/nightly/latestBuild.html"><diffmk:wrapper diffmk:change="added">JBoss Tools nightly build</diffmk:wrapper></ulink> - </para> - </listitem> - <listitem diffmk:change="added"> - <para diffmk:change="added"> - <ulink diffmk:change="added" url="http://jira.jboss.com/jira/secure/attachment/12320944/org.jboss.tools.bir..."><diffmk:wrapper diffmk:change="added">JBoss BIRT integration feature</diffmk:wrapper></ulink> - </para> - </listitem> - </itemizedlist> - - </section> - - <section diffmk:change="added" id="creating_web_project" xreflabel="creating_web_project"> - <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">Creating a web project</diffmk:wrapper></title> - - <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">Follow the next steps to create a web project</diffmk:wrapper></para> - <itemizedlist diffmk:change="added"> - <listitem diffmk:change="added"> - <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">Create a new Seam Web Project</diffmk:wrapper></para> - </listitem> - <listitem diffmk:change="added"> - <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">Choose the 2.0 version of the Seam facet</diffmk:wrapper></para> - </listitem> - <listitem diffmk:change="added"> - <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">Add the "Birt Reporting Runtime Component" facet </diffmk:wrapper></para> - </listitem> - </itemizedlist> - - <figure diffmk:change="added" float="0"> - <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">Adding "Birt Reporting Runtime Component" Facet </diffmk:wrapper></title> - <mediaobject diffmk:change="added"> - <imageobject diffmk:change="added"> - <imagedata diffmk:change="added" fileref="images/BirtIntegration/AddingBirtFacet.png"></imagedata> - </imageobject> - </mediaobject> - </figure> - - <itemizedlist diffmk:change="added"> - <listitem diffmk:change="added"> - <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">Or choose the "JBoss BIRT Integration Web Project" - configuration</diffmk:wrapper></para> - </listitem> - </itemizedlist> - - <figure diffmk:change="added" float="0"> - <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">Choosing "JBoss BIRT Integration Web Project " - Configuration</diffmk:wrapper></title> - <mediaobject diffmk:change="added"> - <imageobject diffmk:change="added"> - <imagedata diffmk:change="added" fileref="images/BirtIntegration/SeamProjectConfiguration.png"></imagedata> - </imageobject> - </mediaobject> - </figure> - - <itemizedlist diffmk:change="added"> - <listitem diffmk:change="added"> - <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">Create the birttests.xhtml, testbirt.xhtml and testbirt1.xhtml pages as - follows:</diffmk:wrapper></para> - </listitem> - </itemizedlist> - <para diffmk:change="added"> - <emphasis diffmk:change="added" role="bold"><diffmk:wrapper diffmk:change="added">birttests.xhtml:</diffmk:wrapper></emphasis> - </para> - - <programlisting diffmk:change="added" format="linespecific" role="XHTML"><diffmk:wrapper diffmk:change="added"><![CDATA[ - - <!DOCTYPE composition PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" - "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> - <ui:composition xmlns="http://www.w3.org/1999/xhtml" - xmlns:s="http://jboss.com/products/seam/taglib" - xmlns:ui="http://java.sun.com/jsf/facelets" xmlns:f="http://java.sun.com/jsf/core" - xmlns:h="http://java.sun.com/jsf/html" - xmlns:rich="http://richfaces.org/rich" - template="layout/template.xhtml"> - - <ui:define name="body"> - <h:messages globalOnly="true" styleClass="message"/> <rich:panel> - <f:facet name="header">Welcome to JBoss BIRT!</f:facet> - <ul> - <li><s:link view="/testbirt.xhtml" value="Test Birt" /></li> - <li><s:link view="/testbirt1.xhtml" value="Test Birt 1" /></li> - </ul> - </rich:panel> - </ui:define> - </ui:composition> - ]]></diffmk:wrapper></programlisting> - - - <para diffmk:change="added"> - <emphasis diffmk:change="added" role="bold"><diffmk:wrapper diffmk:change="added">testbirt.xhtml:</diffmk:wrapper></emphasis> - </para> - - <programlisting diffmk:change="added" format="linespecific" role="XHTML"><diffmk:wrapper diffmk:change="added"><![CDATA[ - <p:birt xmlns:ui="http://java.sun.com/jsf/facelets" - xmlns:s="http://jboss.com/products/seam/taglib" - xmlns:p="http://jboss.com/products/seam/birt" - designType="run" - format="pdf" - designName="test.rptdesign" - title="JBoss Birt Test"> - - <p:param name="sample" value="sample param"/> - </p:birt> - ]]></diffmk:wrapper></programlisting> - - <para diffmk:change="added"> - <emphasis diffmk:change="added" role="bold"><diffmk:wrapper diffmk:change="added">testbirt1.xhtml:</diffmk:wrapper></emphasis> - </para> - - <programlisting diffmk:change="added" format="linespecific" role="XHTML"><diffmk:wrapper diffmk:change="added"><![CDATA[ -<p:birt xmlns:ui="http://java.sun.com/jsf/facelets" - xmlns:s="http://jboss.com/products/seam/taglib" - xmlns:p="http://jboss.com/products/seam/birt" - designType="frameset" - designName="test1.rptdesign" - title="JBoss Birt Test"> - </p:birt> - ]]></diffmk:wrapper></programlisting> - - - <itemizedlist diffmk:change="added"> - <listitem diffmk:change="added"> - <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">Try the tests out by accessing http://localhost:8080//birttests.seam with your web browser.</diffmk:wrapper></para> - </listitem> - </itemizedlist> - - <figure diffmk:change="added" float="0"> - <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">Trying the Tests out. First Page</diffmk:wrapper></title> - <mediaobject diffmk:change="added"> - <imageobject diffmk:change="added"> - <imagedata diffmk:change="added" fileref="images/BirtIntegration/Tests1.png"></imagedata> - </imageobject> - </mediaobject> - </figure> - - <figure diffmk:change="added" float="0"> - <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">Trying the Tests out. Second Page</diffmk:wrapper></title> - <mediaobject diffmk:change="added"> - <imageobject diffmk:change="added"> - <imagedata diffmk:change="added" fileref="images/BirtIntegration/Tests2.png"></imagedata> - </imageobject> - </mediaobject> - </figure> - - <figure diffmk:change="added" float="0"> - <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">Trying the Tests out. Third Page</diffmk:wrapper></title> - <mediaobject diffmk:change="added"> - <imageobject diffmk:change="added"> - <imagedata diffmk:change="added" fileref="images/BirtIntegration/Tests3.png"></imagedata> - </imageobject> - </mediaobject> - </figure> - - <figure diffmk:change="added" float="0"> - <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">Trying the Tests out. Forth Page</diffmk:wrapper></title> - <mediaobject diffmk:change="added"> - <imageobject diffmk:change="added"> - <imagedata diffmk:change="added" fileref="images/BirtIntegration/Tests4.png"></imagedata> - </imageobject> - </mediaobject> - </figure> - - <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">The birt tag recognizes most of the parameters described on </diffmk:wrapper><ulink diffmk:change="added" url="http://www.eclipse.org/birt/phoenix/deploy/viewerUsage2.2.php#parameters"><diffmk:wrapper diffmk:change="added">the BIRT Report Viewer Parameters page</diffmk:wrapper></ulink><diffmk:wrapper diffmk:change="added">. The attributes of the birt tag don't contain the "__" prefix. The param tag describes report parameters. It supports the following attributes: </diffmk:wrapper></para> - <itemizedlist diffmk:change="added"> - <listitem diffmk:change="added"> - <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">name - the parameter name (required)</diffmk:wrapper></para> - </listitem> - <listitem diffmk:change="added"> - <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">value - the parameter value (required)</diffmk:wrapper></para> - </listitem> - <listitem diffmk:change="added"> - <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">isnull - specifies that a report parameter has a null value (optional)</diffmk:wrapper></para> - </listitem> - <listitem diffmk:change="added"> - <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">islocale - specifies whether the parameter is localized (optional)</diffmk:wrapper></para> - </listitem> - </itemizedlist> - <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">These tags are defined in the org.jboss.birt.core/resources/jboss-seam-birt.jar library that contains source. </diffmk:wrapper></para> - <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">It is possible to embed a BIRT report in some Seam xhtml page. For instance: </diffmk:wrapper></para> - <para diffmk:change="added"></para> - - <para diffmk:change="added"> - <emphasis diffmk:change="added" role="bold"><diffmk:wrapper diffmk:change="added">Example:</diffmk:wrapper></emphasis> - </para> - <programlisting diffmk:change="added" format="linespecific" role="XHTML"><diffmk:wrapper diffmk:change="added"><![CDATA[ - - -<!DOCTYPE composition PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> -<ui:composition xmlns="http://www.w3.org/1999/xhtml" - xmlns:s="http://jboss.com/products/seam/taglib" - xmlns:ui="http://java.sun.com/jsf/facelets" - xmlns:f="http://java.sun.com/jsf/core" - xmlns:h="http://java.sun.com/jsf/html" - xmlns:rich="http://richfaces.org/rich" - xmlns:b="http://jboss.com/products/seam/birt" - template="layout/template.xhtml"> - <ui:define name="body"> - <h:messages globalOnly="true" styleClass="message" id="globalMessages"/> - <rich:panel> - <f:facet name="header">Products</f:facet> - <b:birt designType="embed" designName="ProductCatalog.rptdesign" embeddable="true" masterpage="false"/> - <div style="clear:both"/> - </rich:panel> - <div class="actionButtons"> - <s:button view="/ProductsEdit.xhtml" id="edit" value="Edit"/> - <s:button view="/BirtProductsPdf.xhtml" id="BirtProductPdf" value="Product Catalog - PDF"/> - <s:button view="/BirtProductsFrameset.xhtml" id="BirtProductFrameset" value="Product Catalog - Frameset"/> - <s:button view="/BirtProductsEmbedded.xhtml" id="BirtProductEmbedded" value="Product Catalog - Embedded"/> - <s:button view="/TopSellingProducts.xhtml" id="TopSellingProducts" value="Top Selling Products"/> - <s:button view="/#{empty productsFrom ? 'ProductsList' : productsFrom}.xhtml" id="done" value="Done"/> - </div> - </ui:define> -</ui:composition> - - ]]></diffmk:wrapper></programlisting> - - <figure diffmk:change="added" float="0"> - <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">Embeding BIRT Report in Seam xhtml Page. First Page</diffmk:wrapper></title> - <mediaobject diffmk:change="added"> - <imageobject diffmk:change="added"> - <imagedata diffmk:change="added" fileref="images/BirtIntegration/BirtReportInSeamPage1.png"></imagedata> - </imageobject> - </mediaobject> - </figure> - - <figure diffmk:change="added" float="0"> - <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">Embeding BIRT Report in Seam xhtml Page. Second Page</diffmk:wrapper></title> - <mediaobject diffmk:change="added"> - <imageobject diffmk:change="added"> - <imagedata diffmk:change="added" fileref="images/BirtIntegration/BirtReportInSeamPage2.png"></imagedata> - </imageobject> - </mediaobject> - </figure> - - <figure diffmk:change="added" float="0"> - <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">Embeding BIRT Report in Seam xhtml Page. Third Page</diffmk:wrapper></title> - <mediaobject diffmk:change="added"> - <imageobject diffmk:change="added"> - <imagedata diffmk:change="added" fileref="images/BirtIntegration/BirtReportInSeamPage3.png"></imagedata> - </imageobject> - </mediaobject> - </figure> - - </section> - </section> - - - <section diffmk:change="added"> - <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">Hibernate ODA Data Source</diffmk:wrapper></title> - - <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">The JBoss BIRT Integration feature includes the Hibernate ODA Data Source completely integrated with Hibernate Tools. You can use it in the way you use any of BIRT ODA drivers. For instance, </diffmk:wrapper></para> - <itemizedlist diffmk:change="added"> - <listitem diffmk:change="added"> - <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">run the Seam Generate Entities action</diffmk:wrapper></para> - </listitem> - </itemizedlist> - <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">This action will create a Hibernate Console configuration. </diffmk:wrapper></para> - <itemizedlist diffmk:change="added"> - <listitem diffmk:change="added"> - <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">create a new BIRT report</diffmk:wrapper></para> - </listitem> - </itemizedlist> - - <figure diffmk:change="added" float="0"> - <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">Creating New Birt Report </diffmk:wrapper></title> - <mediaobject diffmk:change="added"> - <imageobject diffmk:change="added"> - <imagedata diffmk:change="added" fileref="images/BirtIntegration/CreatingNewBirtReport.png"></imagedata> - </imageobject> - </mediaobject> - </figure> - - <itemizedlist diffmk:change="added"> - <listitem diffmk:change="added"> - <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">add the Hibernate ODA datasource</diffmk:wrapper></para> - </listitem> - </itemizedlist> - - <figure diffmk:change="added" float="0"> - <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">Adding Hibernate ODA Datasource </diffmk:wrapper></title> - <mediaobject diffmk:change="added"> - <imageobject diffmk:change="added"> - <imagedata diffmk:change="added" fileref="images/BirtIntegration/AddingHibernateODADatasource.png"></imagedata> - </imageobject> - </mediaobject> - </figure> - - <figure diffmk:change="added" float="0"> - <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">Testing Connection</diffmk:wrapper></title> - <mediaobject diffmk:change="added"> - <imageobject diffmk:change="added"> - <imagedata diffmk:change="added" fileref="images/BirtIntegration/TestingConnection.png"></imagedata> - </imageobject> - </mediaobject> - </figure> - - - <itemizedlist diffmk:change="added"> - <listitem diffmk:change="added"> - <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">add the Hibernate ODA dataset</diffmk:wrapper></para> - </listitem> - </itemizedlist> - - <figure diffmk:change="added" float="0"> - <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">Adding Hibernate ODA Dataset </diffmk:wrapper></title> - <mediaobject diffmk:change="added"> - <imageobject diffmk:change="added"> - <imagedata diffmk:change="added" fileref="images/BirtIntegration/AddingHibernateODADataset.png"></imagedata> - </imageobject> - </mediaobject> - </figure> - - <figure diffmk:change="added" float="0"> - <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">Testing Query </diffmk:wrapper></title> - <mediaobject diffmk:change="added"> - <imageobject diffmk:change="added"> - <imagedata diffmk:change="added" fileref="images/BirtIntegration/TestingQuery.png"></imagedata> - </imageobject> - </mediaobject> - </figure> - - <itemizedlist diffmk:change="added"> - <listitem diffmk:change="added"> - <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">All the HQL features like syntax highlighting, content assist, formatting, Drag and Drop, etc., are available to you here </diffmk:wrapper><inlinegraphic depth="5.2083inch" diffmk:change="added" fileref="embedded:graphics15" width="8.3335inch"></inlinegraphic> - </para> - </listitem> - </itemizedlist> - - <figure diffmk:change="added" float="0"> - <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">HQL Features - Output Columns Section</diffmk:wrapper></title> - <mediaobject diffmk:change="added"> - <imageobject diffmk:change="added"> - <imagedata diffmk:change="added" fileref="images/BirtIntegration/HQLFeaturesOutputColumns.png"></imagedata> - </imageobject> - </mediaobject> - </figure> - <figure diffmk:change="added" float="0"> - <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">HQL Features - Preview Results Section</diffmk:wrapper></title> - <mediaobject diffmk:change="added"> - <imageobject diffmk:change="added"> - <imagedata diffmk:change="added" fileref="images/BirtIntegration/HQLFeaturesPreviewResults.png"></imagedata> - </imageobject> - </mediaobject> - </figure> - - - <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">You can create a BIRT report using this data source and data set.</diffmk:wrapper></para> - - <figure diffmk:change="added" float="0"> - <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">Creating a BIRT report using this data source and data set</diffmk:wrapper></title> - <mediaobject diffmk:change="added"> - <imageobject diffmk:change="added"> - <imagedata diffmk:change="added" fileref="BIRTReportUsingDataSourceAndSet.png "></imagedata> - </imageobject> - </mediaobject> - </figure> - - <figure diffmk:change="added" float="0"> - <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">BIRT Report -Preview Tab</diffmk:wrapper></title> - <mediaobject diffmk:change="added"> - <imageobject diffmk:change="added"> - <imagedata diffmk:change="added" fileref="images/BirtIntegration/BIRTReportPreviewTab.png"></imagedata> - </imageobject> - </mediaobject> - </figure> - - <figure diffmk:change="added" float="0"> - <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">Adding "Birt Reporting Runtime Component" Facet </diffmk:wrapper></title> - <mediaobject diffmk:change="added"> - <imageobject diffmk:change="added"> - <imagedata diffmk:change="added" fileref="images/BirtIntegration/AddingBirtFacet.png"></imagedata> - </imageobject> - </mediaobject> - </figure> - - <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">You can also use parameters within the Hibernate ODA driver. </diffmk:wrapper></para> - - <figure diffmk:change="added" float="0"> - <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">Using parameters within the Hibernate ODA driver.</diffmk:wrapper></title> - <mediaobject diffmk:change="added"> - <imageobject diffmk:change="added"> - <imagedata diffmk:change="added" fileref="images/BirtIntegration/ParametersWithinHibernateODADriver.png"></imagedata> - </imageobject> - </mediaobject> - </figure> - - - <figure diffmk:change="added" float="0"> - <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">Adding New Parameter</diffmk:wrapper></title> - <mediaobject diffmk:change="added"> - <imageobject diffmk:change="added"> - <imagedata diffmk:change="added" fileref="images/BirtIntegration/AddingNewParameter.png"></imagedata> - </imageobject> - </mediaobject> - </figure> - - - <figure diffmk:change="added" float="0"> - <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">Previewing Results</diffmk:wrapper></title> - <mediaobject diffmk:change="added"> - <imageobject diffmk:change="added"> - <imagedata diffmk:change="added" fileref="images/BirtIntegration/PreviewingResults.png"></imagedata> - </imageobject> - </mediaobject> - </figure> - - - </section> - - <section diffmk:change="added"> - <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">Deploying a BIRT report</diffmk:wrapper></title> - <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">You can deploy this report by adding an action button to the Seam's CRUD xhtml file.</diffmk:wrapper></para> - - <figure diffmk:change="added" float="0"> - <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">Adding Action Button</diffmk:wrapper></title> - <mediaobject diffmk:change="added"> - <imageobject diffmk:change="added"> - <imagedata diffmk:change="added" fileref="images/BirtIntegration/AddingActionButton.png"></imagedata> - </imageobject> - </mediaobject> - </figure> - <itemizedlist diffmk:change="added"> - <listitem diffmk:change="added"> - <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">create the testHibernateOda.xhtml file </diffmk:wrapper></para> - </listitem> - </itemizedlist> - - <para diffmk:change="added"> - <emphasis diffmk:change="added" role="bold"><diffmk:wrapper diffmk:change="added">birttests.xhtml:</diffmk:wrapper></emphasis> - </para> - - <programlisting diffmk:change="added" format="linespecific" role="XHTML"><diffmk:wrapper diffmk:change="added"><![CDATA[ - -<p:birt xmlns:ui="http://java.sun.com/jsf/facelets" - xmlns:s="http://jboss.com/products/seam/taglib" - xmlns:p="http://jboss.com/products/seam/birt" - designType="run" - format="pdf" - designName="testHibernateOda.rptdesign" - title="JBoss Birt Test"> - -</p:birt> -]]></diffmk:wrapper></programlisting> - - <itemizedlist diffmk:change="added"> - <listitem diffmk:change="added"> - <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">open the Articles.xhtml page</diffmk:wrapper></para> - </listitem> - </itemizedlist> - - <figure diffmk:change="added" float="0"> - <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">Opening Articles.xhtml Page</diffmk:wrapper></title> - <mediaobject diffmk:change="added"> - <imageobject diffmk:change="added"> - <imagedata diffmk:change="added" fileref="images/BirtIntegration/OpeningArticlesPage.png"></imagedata> - </imageobject> - </mediaobject> - </figure> - - <itemizedlist diffmk:change="added"> - <listitem diffmk:change="added"> - <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">click the Birt PDF Report button </diffmk:wrapper></para> - </listitem> - </itemizedlist> - - <figure diffmk:change="added" float="0"> - <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">Birt PDF Report</diffmk:wrapper></title> - <mediaobject diffmk:change="added"> - <imageobject diffmk:change="added"> - <imagedata diffmk:change="added" fileref="images/BirtIntegration/BirtPDFReport.png"></imagedata> - </imageobject> - </mediaobject> - </figure> - - <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">The JNDI URL property can be either Hibernate Session Factory or Hibernate Entity Manager Factory. If a user doesn't specify this property, our engine will try the following JNDI URLs : </diffmk:wrapper></para> - <itemizedlist diffmk:change="added"> - <listitem diffmk:change="added"> - <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">java:/<project_name></diffmk:wrapper></para> - </listitem> - <listitem diffmk:change="added"> - <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">java:/<project_name>EntityManagerFactory</diffmk:wrapper></para> - </listitem> - </itemizedlist> - <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">If you want to test this feature using PDE Runtime, you need to add osgi.dev=bin to the WebContent/WEB-INF/platform/configuration/config.ini file </diffmk:wrapper></para> - </note> -<para diffmk:change="added"><diffmk:wrapper diffmk:change="added">In conclusion, the main goal of this document is to get you know with a full featureset that JBoss BIRT Tools provides. Thus if you have some questions, comments or suggestions on the topic, please fell free to ask in the JBoss Tools Forum. You can also influence on how you want to see JBoss Tools docs in future leaving your vote on our page here.</diffmk:wrapper></para> - - </section> - - - - - -</chapter> - - - -</book> Copied: branches/jbosstools-3.0.x/birt/docs/en/master_output.xml (from rev 15151, branches/jbosstools-3.0.x/birt/docs/en/master_output.xml) =================================================================== --- branches/jbosstools-3.0.x/birt/docs/en/master_output.xml (rev 0) +++ branches/jbosstools-3.0.x/birt/docs/en/master_output.xml 2009-05-11 15:22:07 UTC (rev 15156) @@ -0,0 +1,843 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" +"http://www.docbook.org/xml/4.3/docbookx.dtd" + +[ +<!ENTITY introduction SYSTEM "modules/introduction.xml"> +<!ENTITY birt_integration_with_seam SYSTEM "modules/birt_integration_with_seam.xml"> +<!ENTITY hibernate_datasource SYSTEM "modules/hibernate_datasource.xml"> +<!ENTITY birt_reports_deployment SYSTEM "modules/birt_reports_deployment.xml"> + +<!ENTITY gsglink "../../GettingStartedGuide/html_single/index.html"> +]><book xmlns:diffmk="http://diffmk.sf.net/ns/diff"> + <bookinfo> + <title><diffmk:wrapper diffmk:change="changed">Birt Plugin Integration Reference Guide</diffmk:wrapper></title> + + <author><firstname>Anastasiya</firstname><surname>Bogachuk</surname><email>abogachuk(a)exadel.com</email></author> + <author diffmk:change="added"><firstname diffmk:change="added"><diffmk:wrapper diffmk:change="added">Olga</diffmk:wrapper></firstname><surname diffmk:change="added"><diffmk:wrapper diffmk:change="added">Chikvina</diffmk:wrapper></surname></author> + + <pubdate>August 2008</pubdate> + <copyright> + <year>2008</year> + <year>2009</year> + <holder>JBoss, a division of Red Hat</holder> + </copyright> + <releaseinfo> + Version: 1.0.0.GA + </releaseinfo> + + +<abstract> + <title></title> + <para> + <ulink url="http://download.jboss.org/jbosstools/nightly-docs/en/jboss_birt_plugin_re...">PDF version</ulink> + </para> +</abstract> + + + </bookinfo> + <toc></toc> + + +<chapter id="introduction" xml:base="file:///home/ochikvina/WORK/for_compare/trunk/birt/docs/en/modules/introduction.xml"> + <?dbhtml filename="introduction.html"?> + + <chapterinfo> + <keywordset> + <keyword>JBoss Developer Studio</keyword> + <keyword>Eclipse</keyword> + <keyword>JBoss</keyword> + <keyword>JBoss Tools</keyword> + <keyword>JBDS</keyword> + <keyword>BIRT Plugin</keyword> + </keywordset> + </chapterinfo> + + <title>Introduction</title> + + <section> + + <title>What is BIRT?</title> + <para><diffmk:wrapper diffmk:change="changed">BIRT plugin is an Eclipse-based open source reporting system for web applications + based on Java and J2EE. BIRT consists of two main components: a report designer based on + Eclipse, and a runtime component that can be added to your app server. BIRT also offers + a charting engine that lets you add charts to your own Web application.</diffmk:wrapper></para> + <para>With the help of BIRT you can generate a great number of reports to be used in your + application:</para> + + <itemizedlist> + <listitem> + <para>Lists</para> + </listitem> + <listitem> + <para>Charts</para> + </listitem> + <listitem> + <para>Crosstabs, or cross-tabulation, or matrix</para> + </listitem> + <listitem> + <para>Letters and Documents</para> + </listitem> + <listitem> + <para>Compound Reports</para> + </listitem> + </itemizedlist> + + <para><diffmk:wrapper diffmk:change="added">You can find more detailed information on the BIRT plugin, its report types and + anatomy on the </diffmk:wrapper><ulink url="http://www.eclipse.org/birt/phoenix/intro/"><diffmk:wrapper diffmk:change="changed">BIRT Homepage</diffmk:wrapper></ulink>.</para> + + <para><diffmk:wrapper diffmk:change="added">To understand the basic BIRT concepts and to know how to create a basic BIRT report, + refer to the </diffmk:wrapper><ulink diffmk:change="added" url="http://www.eclipse.org/birt/phoenix/tutorial/"><diffmk:wrapper diffmk:change="added">Eclipse BIRT + Tutorials</diffmk:wrapper></ulink><diffmk:wrapper diffmk:change="added">. What extensions </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">JBoss Tools</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added"> provides for + Eclipse BIRT you'll find out in the next sections.</diffmk:wrapper></para> + </section> + + <section diffmk:change="added"> + <title><diffmk:wrapper diffmk:change="changed">JBoss BIRT Integration Functionality Overview</diffmk:wrapper></title> + + <para><diffmk:wrapper diffmk:change="added">This reference guide describes the one module of the </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">JBoss Tools</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added"> project which + performs the integration with BIRT. The integration includes the following functionalities:</diffmk:wrapper></para> + <itemizedlist> + <listitem> + <para><diffmk:wrapper diffmk:change="changed">Hibernate ODA driver that includes a dialog to create HQL queries with + syntax-highlighting, content-assist, formatting as well as other functionalities + available in the HQL editor. There is also a possibility to add + parameters.</diffmk:wrapper></para> + </listitem> + <listitem> + <para><diffmk:wrapper diffmk:change="changed">possibility to add JBoss BIRT functionality to the standard Seam web + project</diffmk:wrapper></para> + </listitem> + <listitem> + <para><diffmk:wrapper diffmk:change="changed">BIRT JSF/Seam control</diffmk:wrapper></para> + </listitem> + <listitem> + <para><diffmk:wrapper diffmk:change="changed">deployment of BIRT reports within web projects (Seam, JSF, etc.)</diffmk:wrapper></para> + </listitem> + </itemizedlist> + + <para><diffmk:wrapper diffmk:change="added">To enable </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">JBoss Tools</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added"> integration with BIRT you are intended to + have the next:</diffmk:wrapper></para> + <itemizedlist diffmk:change="added"> + <listitem> + <para><diffmk:wrapper diffmk:change="added">Eclipse with </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">JBoss Tools</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added"> + installed (how to install </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">JBoss Tools</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added"> on Eclipse, what + dependences and versions requirements are needed reed in the </diffmk:wrapper><ulink diffmk:change="added" url="../../GettingStartedGuide/html_single/index.html#JBossToolsInstall"><diffmk:wrapper diffmk:change="added">JBoss Tools Installation</diffmk:wrapper></ulink><diffmk:wrapper diffmk:change="added"> section)</diffmk:wrapper></para> + </listitem> + <listitem> + <para><diffmk:wrapper diffmk:change="added">BIRT Report Designer (BIRT Report Designer 2.3.2 + you can download from </diffmk:wrapper><ulink diffmk:change="added" url="http://www.eclipse.org/downloads/download.php?file=/birt/downloads/drops/..."><diffmk:wrapper diffmk:change="added">Eclipse downloads site</diffmk:wrapper></ulink><diffmk:wrapper diffmk:change="added">)</diffmk:wrapper></para> + </listitem> + <listitem> + <para><diffmk:wrapper diffmk:change="added">BIRT Web Tools Integration ( BIRT WTP Integration 2.3.2 you can download from + </diffmk:wrapper><ulink diffmk:change="added" url="http://www.eclipse.org/downloads/download.php?file=/birt/downloads/drops/..."><diffmk:wrapper diffmk:change="added">Eclipse downloads site</diffmk:wrapper></ulink><diffmk:wrapper diffmk:change="added">)</diffmk:wrapper></para> + </listitem> + </itemizedlist> + + <note diffmk:change="added"> + <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">Note:</diffmk:wrapper></title> + <para><diffmk:wrapper diffmk:change="added">Versions of BIRT framework and BIRT WTP integration should be no less than RC4 in + order to the BIRT facet works correctly.</diffmk:wrapper></para> + </note> + </section> + + <section diffmk:change="added" id="birt_plugin_rel_resources"> + <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">Other Relevant Resources on the Topic</diffmk:wrapper></title> + + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">All 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:wrapper></ulink><diffmk:wrapper diffmk:change="added"> in the corresponding release directory.</diffmk:wrapper></para> + <para><diffmk:wrapper diffmk:change="added">The latest documentation builds are available at </diffmk:wrapper><ulink diffmk:change="added" url="http://download.jboss.org/jbosstools/nightly-docs/"><diffmk:wrapper diffmk:change="added">http://download.jboss.org/jbosstools/nightly-docs</diffmk:wrapper></ulink><diffmk:wrapper diffmk:change="added">.</diffmk:wrapper></para> + </section> + +</chapter> + + +<chapter diffmk:change="added" id="birt_integration_with_seam" xml:base="file:///home/ochikvina/WORK/for_compare/trunk/birt/docs/en/modules/birt_integration_with_seam.xml" xreflabel="birt_integration_with_seam"> + + <?dbhtml filename="birt_integration_with_seam.html"?> + <chapterinfo diffmk:change="added"> + <keywordset diffmk:change="added"> + <keyword diffmk:change="added"><diffmk:wrapper diffmk:change="added">JBoss</diffmk:wrapper></keyword> + <keyword diffmk:change="added"><diffmk:wrapper diffmk:change="added">BIRT</diffmk:wrapper></keyword> + <keyword diffmk:change="added"><diffmk:wrapper diffmk:change="added">Seam</diffmk:wrapper></keyword> + </keywordset> + </chapterinfo> + <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">Adding BIRT Functionality to Standard Seam Web Project</diffmk:wrapper></title> + + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">In this chapter you'll know how to create a Seam web project with BIRT + capabilities included.</diffmk:wrapper></para> + + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">You are supposed to have Seam runtime and JBoss Application Server downloaded and + extracted somewhere on you hard drive.</diffmk:wrapper></para> + + <tip diffmk:change="added"> + <title><diffmk:wrapper diffmk:change="changed">Tip:</diffmk:wrapper></title> + <para><diffmk:wrapper diffmk:change="added">We used</diffmk:wrapper><ulink diffmk:change="added" url="http://sourceforge.net/project/showfiles.php?group_id=22866&package_i..."><diffmk:wrapper diffmk:change="added">JBoss Seam 2.0.1 GA</diffmk:wrapper></ulink><diffmk:wrapper diffmk:change="added"> and </diffmk:wrapper><ulink diffmk:change="added" url="http://sourceforge.net/project/showfiles.php?group_id=22866&package_i..."><diffmk:wrapper diffmk:change="added">JBoss Application Server 4.2.2 GA</diffmk:wrapper></ulink><diffmk:wrapper diffmk:change="added"> in examples of this guide.</diffmk:wrapper></para> + </tip> + + <section diffmk:change="added" id="creatin_project_with_birt"> + <title><diffmk:wrapper diffmk:change="changed">Creating Seam Web Project with Birt Facet</diffmk:wrapper></title> + + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">First, open </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Seam perspective</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added"> by going to </diffmk:wrapper><emphasis diffmk:change="added"> + <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Window > Open Perspective > Other > Seam</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added">. + </diffmk:wrapper></emphasis><diffmk:wrapper diffmk:change="added"> To create a new Seam Web project follow to </diffmk:wrapper><emphasis diffmk:change="added"> + <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">File > New > Seam Web Project</diffmk:wrapper></property> + </emphasis><diffmk:wrapper diffmk:change="added"> (or </diffmk:wrapper><emphasis diffmk:change="added"> + <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">File > New > Other > Seam > Seam Web + Project</diffmk:wrapper></property> + </emphasis><diffmk:wrapper diffmk:change="added"> if you are not in the </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Seam perspective</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added">).</diffmk:wrapper></para> + + <para><diffmk:wrapper diffmk:change="added">On the first wizard page enter the project name, then specify the target runtime and + target server. In the </diffmk:wrapper><emphasis diffmk:change="added"> + <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Configuration</diffmk:wrapper></property> + </emphasis><diffmk:wrapper diffmk:change="added"> section 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"> to configure the project facets.</diffmk:wrapper></para> + + <figure diffmk:change="added" float="0"> + <title><diffmk:wrapper diffmk:change="changed">Creating Seam Web Project</diffmk:wrapper></title> + <mediaobject diffmk:change="added"> + <imageobject diffmk:change="added"> + <imagedata diffmk:change="added" fileref="images/birt_integration_with_seam/testBirtProject.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para><diffmk:wrapper diffmk:change="changed">Choose the 2.0 version of the </diffmk:wrapper><emphasis> + <property moreinfo="none"><diffmk:wrapper diffmk:change="changed">Seam</diffmk:wrapper></property> + </emphasis><diffmk:wrapper diffmk:change="changed"> facet and enable the </diffmk:wrapper><emphasis> + <property moreinfo="none"><diffmk:wrapper diffmk:change="changed">Birt Reporting Runtime Component</diffmk:wrapper></property> + </emphasis><diffmk:wrapper diffmk:change="added"> facet.</diffmk:wrapper></para> + + <figure float="0"> + <title><diffmk:wrapper diffmk:change="changed">Adding the Birt Reporting Runtime Component Facet </diffmk:wrapper></title> + <mediaobject> + <imageobject> + <imagedata fileref="images/birt_integration_with_seam/addingBirtFacet.png"/> + </imageobject> + </mediaobject> + </figure> + + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">Or you can just choose the </diffmk:wrapper><emphasis> + <property moreinfo="none"><diffmk:wrapper diffmk:change="changed">JBoss BIRT Integration Web Project</diffmk:wrapper></property> + </emphasis><diffmk:wrapper diffmk:change="changed"> configuration.</diffmk:wrapper></para> + + <figure float="0"> + <title><diffmk:wrapper diffmk:change="changed">Choosing the JBoss BIRT Integration Web Project Configuration</diffmk:wrapper></title> + <mediaobject> + <imageobject> + <imagedata + fileref="images/birt_integration_with_seam/projectBirtConfiguration.png"/> + </imageobject> + </mediaobject> + </figure> + + <para><diffmk:wrapper diffmk:change="changed">Next three pages are filled out with defaults, just leave them through by pressing </diffmk:wrapper><emphasis> + <property moreinfo="none"><diffmk:wrapper diffmk:change="changed">Next</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added">.</diffmk:wrapper></emphasis><diffmk:wrapper diffmk:change="changed"> On the </diffmk:wrapper><emphasis> + <property moreinfo="none"><diffmk:wrapper diffmk:change="changed">Seam Facet</diffmk:wrapper></property> + </emphasis><diffmk:wrapper diffmk:change="changed"> page you should specify the Seam runtime and Connection profile.</diffmk:wrapper></para> + + <figure float="0"> + <title><diffmk:wrapper diffmk:change="changed">Configuring the Seam Facet settings</diffmk:wrapper></title> + <mediaobject> + <imageobject> + <imagedata fileref="images/birt_integration_with_seam/seamFacet.png"/> + </imageobject> + </mediaobject> + </figure> + + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">Hit </diffmk:wrapper><emphasis diffmk:change="added"> + <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Finish</diffmk:wrapper></property> + </emphasis><diffmk:wrapper diffmk:change="added"> to create the project with Birt functionality enabled.</diffmk:wrapper></para> + </section> + + <section diffmk:change="added" id="integration"> + <title><diffmk:wrapper diffmk:change="changed">Integration with Seam</diffmk:wrapper></title> + + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">The JBoss BIRT Integration feature contains the BIRT tag that allows the user to add a + BIRT report to an </diffmk:wrapper><emphasis diffmk:change="added"> + <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">.xhtml</diffmk:wrapper></property> + </emphasis><diffmk:wrapper diffmk:change="added"> file:</diffmk:wrapper></para> + + <programlisting diffmk:change="added" format="linespecific" role="XHTML"><diffmk:wrapper diffmk:change="added"><![CDATA[<p:birt xmlns:ui="http://java.sun.com/jsf/facelets" + xmlns:s="http://jboss.com/products/seam/taglib" + xmlns:p="http://jboss.com/products/seam/birt" + designType="run" + format="pdf" + designName="test.rptdesign" + title="JBoss Birt Test"> + +</p:birt>]]></diffmk:wrapper></programlisting> + + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">Let's look how it works.</diffmk:wrapper></para> + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">Create in the </diffmk:wrapper><emphasis diffmk:change="added"> + <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Web Content</diffmk:wrapper></property> + </emphasis><diffmk:wrapper diffmk:change="added"> folder three </diffmk:wrapper><emphasis diffmk:change="added"> + <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">.xhtml</diffmk:wrapper></property> + </emphasis><diffmk:wrapper diffmk:change="added"> pages with the following content:</diffmk:wrapper></para> + + <itemizedlist diffmk:change="added"> + <listitem diffmk:change="added"> + <para diffmk:change="added"> + <emphasis diffmk:change="added"> + <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">birttests.xhtml</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added">:</diffmk:wrapper></emphasis> + </para> + <programlisting diffmk:change="added" format="linespecific" role="XHTML"><diffmk:wrapper diffmk:change="added"><![CDATA[<!DOCTYPE composition PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" + "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> + <ui:composition xmlns="http://www.w3.org/1999/xhtml" + xmlns:s="http://jboss.com/products/seam/taglib" + xmlns:ui="http://java.sun.com/jsf/facelets" xmlns:f="http://java.sun.com/jsf/core" + xmlns:h="http://java.sun.com/jsf/html" + xmlns:rich="http://richfaces.org/rich" + template="layout/template.xhtml"> + + <ui:define name="body"> + <h:messages globalOnly="true" styleClass="message"/> + <rich:panel> + <f:facet name="header">Welcome to JBoss BIRT!</f:facet> + <ul> + <li><s:link view="/testbirt.xhtml" value="Test Birt" /></li> + <li><s:link view="/testbirt1.xhtml" value="Test Birt 1" /></li> + </ul> + </rich:panel> + </ui:define> + </ui:composition>]]></diffmk:wrapper></programlisting> + </listitem> + <listitem diffmk:change="added"> + <para> + <emphasis> + <property moreinfo="none"><diffmk:wrapper diffmk:change="changed">testbirt.xhtml</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added">:</diffmk:wrapper></emphasis> + </para> + <programlisting diffmk:change="added" format="linespecific" role="XHTML"><diffmk:wrapper diffmk:change="added"><![CDATA[<p:birt xmlns:ui="http://java.sun.com/jsf/facelets" + xmlns:s="http://jboss.com/products/seam/taglib" + xmlns:p="http://jboss.com/products/seam/birt" + designType="run" + format="pdf" + designName="test.rptdesign" + title="JBoss Birt Test"> + + <p:param name="sample" value="sample param"/> +</p:birt>]]></diffmk:wrapper></programlisting> + </listitem> + <listitem diffmk:change="added"> + <para diffmk:change="added"> + <emphasis diffmk:change="added"> + <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">testbirt1.xhtml</diffmk:wrapper></property>:</emphasis> + </para> + <programlisting diffmk:change="added" format="linespecific" role="XHTML"><diffmk:wrapper diffmk:change="added"><![CDATA[<p:birt xmlns:ui="http://java.sun.com/jsf/facelets" + xmlns:s="http://jboss.com/products/seam/taglib" + xmlns:p="http://jboss.com/products/seam/birt" + designType="frameset" + designName="test1.rptdesign" + title="JBoss Birt Test"> +</p:birt>]]></diffmk:wrapper></programlisting> + </listitem> + </itemizedlist> + + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">Now start the application server by clicking the </diffmk:wrapper><emphasis diffmk:change="added"> + <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Start</diffmk:wrapper></property> + </emphasis><diffmk:wrapper diffmk:change="added"> option in the context menu of the server in the </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">JBoss Server + View</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added"> (if the view isn't open go to </diffmk:wrapper><emphasis diffmk:change="added"> + <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Window > Show View > Other > JBoss Server + View</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added">)</diffmk:wrapper></emphasis><diffmk:wrapper diffmk:change="added">. Try the tests out by accessing </diffmk:wrapper><emphasis diffmk:change="added"> + <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">http://localhost:8080/hellobirt/birttests.seam</diffmk:wrapper></property> + </emphasis><diffmk:wrapper diffmk:change="added"> in your web browser.</diffmk:wrapper></para> + + <figure float="0"> + <title><diffmk:wrapper diffmk:change="changed">Welcome Page in the Browser</diffmk:wrapper></title> + <mediaobject> + <imageobject> + <imagedata fileref="images/birt_integration_with_seam/birttestsPage.png"/> + </imageobject> + </mediaobject> + </figure> + + <para><diffmk:wrapper diffmk:change="added">Now if you click </diffmk:wrapper><emphasis diffmk:change="added"> + <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Test Birt</diffmk:wrapper></property> + </emphasis><diffmk:wrapper diffmk:change="added"> you should see the following </diffmk:wrapper><emphasis diffmk:change="added"> + <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">.pdf</diffmk:wrapper></property> + </emphasis><diffmk:wrapper diffmk:change="added"> file:</diffmk:wrapper></para> + + <figure float="0"> + <title><diffmk:wrapper diffmk:change="changed">After Clicking Test Birt</diffmk:wrapper></title> + <mediaobject> + <imageobject> + <imagedata fileref="images/birt_integration_with_seam/testbirtPage.png"/> + </imageobject> + </mediaobject> + </figure> + + <para><diffmk:wrapper diffmk:change="changed">After clicking </diffmk:wrapper><emphasis> + <property moreinfo="none"><diffmk:wrapper diffmk:change="changed">Test Birt 1</diffmk:wrapper></property> + </emphasis><diffmk:wrapper diffmk:change="added"> the next page is displayed:</diffmk:wrapper></para> + + <figure float="0"> + <title><diffmk:wrapper diffmk:change="changed">After Clicking Test Birt 1</diffmk:wrapper></title> + <mediaobject> + <imageobject> + <imagedata fileref="images/birt_integration_with_seam/testbirt1Page1.png"/> + </imageobject> + </mediaobject> + </figure> + + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">Put the </diffmk:wrapper><emphasis diffmk:change="added"> + <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">test param</diffmk:wrapper></property> + </emphasis><diffmk:wrapper diffmk:change="added"> as Sample Parameter value, specify the maximum possible Customer Number as + </diffmk:wrapper><emphasis> + <property moreinfo="none"><diffmk:wrapper diffmk:change="added">1001</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added">,</diffmk:wrapper></emphasis><diffmk:wrapper diffmk:change="added"> for instance, and then press </diffmk:wrapper><emphasis diffmk:change="added"> + <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Ok</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added">.</diffmk:wrapper></emphasis><diffmk:wrapper diffmk:change="changed"> You'll see the following BIRT + report:</diffmk:wrapper></para> + + <figure float="0"> + <title><diffmk:wrapper diffmk:change="changed">BIRT Report in the Browser Window</diffmk:wrapper></title> + <mediaobject> + <imageobject> + <imagedata fileref="images/birt_integration_with_seam/testbirt1Page2.png"/> + </imageobject> + </mediaobject> + </figure> + + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">The BIRT tag recognizes most of the parameters described on </diffmk:wrapper><ulink diffmk:change="added" url="http://www.eclipse.org/birt/phoenix/deploy/viewerUsage2.2.php#parameters"><diffmk:wrapper diffmk:change="added">the + BIRT Report Viewer Parameters page</diffmk:wrapper></ulink><diffmk:wrapper diffmk:change="added">. The attributes of the BIRT tag + don't contain the </diffmk:wrapper><emphasis diffmk:change="added"> + <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">"__"</diffmk:wrapper></property> + </emphasis><diffmk:wrapper diffmk:change="added"> prefix.</diffmk:wrapper></para> + + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">The </diffmk:wrapper><emphasis diffmk:change="added"> + <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">param</diffmk:wrapper></property> + </emphasis><diffmk:wrapper diffmk:change="added"> tag describes report parameters (see the listing for the </diffmk:wrapper><emphasis diffmk:change="added"> + <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">testbirt.xhtml</diffmk:wrapper></property> + </emphasis><diffmk:wrapper diffmk:change="added"> above). It supports the following attributes: </diffmk:wrapper></para> + <itemizedlist diffmk:change="added"> + <listitem diffmk:change="added"> + <para diffmk:change="added"><emphasis diffmk:change="added"> + <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">name</diffmk:wrapper></property> + </emphasis><diffmk:wrapper diffmk:change="added"> - the parameter name (required)</diffmk:wrapper></para> + </listitem> + <listitem diffmk:change="added"> + <para diffmk:change="added"><emphasis diffmk:change="added"> + <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">value</diffmk:wrapper></property> + </emphasis><diffmk:wrapper diffmk:change="added"> - the parameter value (required)</diffmk:wrapper></para> + </listitem> + <listitem diffmk:change="added"> + <para diffmk:change="added"><emphasis diffmk:change="added"> + <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">isnull</diffmk:wrapper></property> + </emphasis><diffmk:wrapper diffmk:change="added"> - specifies that a report parameter has a null value + (optional)</diffmk:wrapper></para> + </listitem> + <listitem diffmk:change="added"> + <para diffmk:change="added"><emphasis diffmk:change="added"> + <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">islocale</diffmk:wrapper></property> + </emphasis><diffmk:wrapper diffmk:change="added"> - specifies whether the parameter is localized (optional)</diffmk:wrapper></para> + </listitem> + </itemizedlist> + + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">These tags are defined in the </diffmk:wrapper><emphasis diffmk:change="added"> + <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">org.jboss.birt.core/resources/jboss-seam-birt.jar</diffmk:wrapper></property> + </emphasis><diffmk:wrapper diffmk:change="added"> library that contains source. </diffmk:wrapper></para> + + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">It is also possible to embed a BIRT report in some Seam </diffmk:wrapper><emphasis diffmk:change="added"> + <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">.xhtml</diffmk:wrapper></property> + </emphasis><diffmk:wrapper diffmk:change="added"> page. See how it may be done:</diffmk:wrapper></para> + <para diffmk:change="added"></para> + + <para diffmk:change="added"> + <emphasis diffmk:change="added" role="bold"><diffmk:wrapper diffmk:change="added">Example:</diffmk:wrapper></emphasis> + </para> + <programlisting diffmk:change="added" format="linespecific" role="XHTML"><diffmk:wrapper diffmk:change="added"><![CDATA[<!DOCTYPE composition PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" + "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> +<ui:composition xmlns="http://www.w3.org/1999/xhtml" + xmlns:s="http://jboss.com/products/seam/taglib" + xmlns:ui="http://java.sun.com/jsf/facelets" + xmlns:f="http://java.sun.com/jsf/core" + xmlns:h="http://java.sun.com/jsf/html" + xmlns:rich="http://richfaces.org/rich" + xmlns:b="http://jboss.com/products/seam/birt" + template="layout/template.xhtml"> + <ui:define name="body"> + <h:messages globalOnly="true" styleClass="message" id="globalMessages"/> + <rich:panel> + <f:facet name="header">Products</f:facet> + <b:birt designType="embed" designName="ProductCatalog.rptdesign" + embeddable="true" masterpage="false"/> + <div style="clear:both"/> + </rich:panel> + <div class="actionButtons"> + <s:button view="/ProductsEdit.xhtml" id="edit" value="Edit"/> + + <s:button view="/#{empty productsFrom ? 'ProductsList' : productsFrom}.xhtml" + id="done" value="Done"/> + </div> + </ui:define> +</ui:composition>]]></diffmk:wrapper></programlisting> + + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">See the result in a Browser:</diffmk:wrapper></para> + + <figure diffmk:change="added" float="0"> + <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">Embedding BIRT Report in Seam xhtml Page</diffmk:wrapper></title> + <mediaobject diffmk:change="added"> + <imageobject diffmk:change="added"> + <imagedata diffmk:change="added" fileref="images/birt_integration_with_seam/embeddedReportInSeamPage.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + </section> +</chapter> + + +<chapter diffmk:change="added" id="hibernate_datasource" xml:base="file:///home/ochikvina/WORK/for_compare/trunk/birt/docs/en/modules/hibernate_datasource.xml" xreflabel="hibernate_datasource"> + + <?dbhtml filename="hibernate_datasource.html"?> + <chapterinfo diffmk:change="added"> + <keywordset diffmk:change="added"> + <keyword diffmk:change="added"><diffmk:wrapper diffmk:change="added">JBoss</diffmk:wrapper></keyword> + <keyword diffmk:change="added"><diffmk:wrapper diffmk:change="added">BIRT</diffmk:wrapper></keyword> + <keyword diffmk:change="added"><diffmk:wrapper diffmk:change="added">Seam</diffmk:wrapper></keyword> + </keywordset> + </chapterinfo> + + <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">Hibernate ODA Data Source</diffmk:wrapper></title> + + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">The JBoss BIRT Integration feature includes the Hibernate ODA Data Source completely + integrated with Hibernate Tools. You can use it in the way you use any of BIRT ODA drivers. + Let's perform simple actions that demonstrate it.</diffmk:wrapper></para> + + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">First, run the </diffmk:wrapper><emphasis diffmk:change="added"> + <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Seam Generate Entities</diffmk:wrapper></property> + </emphasis><diffmk:wrapper diffmk:change="added"> action (You can access it from </diffmk:wrapper><emphasis diffmk:change="added"> + <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">File > New > Seam Generate Entities</diffmk:wrapper></property> + </emphasis><diffmk:wrapper diffmk:change="added"> in the </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Seam perspective</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added">. More details on the Seam Generate + Entities read in our </diffmk:wrapper><ulink diffmk:change="added" url="http://download.jboss.org/jbosstools/nightly-docs/en/seam/html_single/ind..."><diffmk:wrapper diffmk:change="added">Seam Dev Tools Reference guide</diffmk:wrapper></ulink><diffmk:wrapper diffmk:change="added">). This action will create a Hibernate Console + configuration.</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">Before performing Seam Generate Entities, you should have a connection profile + adjusted and connected to a database. How to do this see in the </diffmk:wrapper><ulink diffmk:change="added" url="http://download.jboss.org/jbosstools/nightly-docs/en/seam/html_single/ind..."><diffmk:wrapper diffmk:change="added">CRUD Database Application</diffmk:wrapper></ulink><diffmk:wrapper diffmk:change="added"> chapter of the Seam Dev Tools Reference + guide.</diffmk:wrapper></para> + </tip> + + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">Next add a new BIRT report. To do that navigate to </diffmk:wrapper><emphasis diffmk:change="added"> + <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">File > New > Other > Business Intelligence and Reporting + Tools > Report</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added">.</diffmk:wrapper></emphasis><diffmk:wrapper diffmk:change="added"> In the </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">New Report + wizard</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added"> enter the report name, for instance </diffmk:wrapper><emphasis diffmk:change="added"> + <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">testHibernateOda.rptdesign</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added">,</diffmk:wrapper></emphasis><diffmk:wrapper diffmk:change="added"> then click </diffmk:wrapper><emphasis diffmk:change="added"> + <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Finish</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added">.</diffmk:wrapper></emphasis></para> + + <figure diffmk:change="added" float="0"> + <title><diffmk:wrapper diffmk:change="changed">Creating a New BIRT Report </diffmk:wrapper></title> + <mediaobject diffmk:change="added"> + <imageobject diffmk:change="added"> + <imagedata diffmk:change="added" fileref="images/hibernate_datasource/creatingNewBirtReport.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para><diffmk:wrapper diffmk:change="added">Now switch to the </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Report Design perspective</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added">.</diffmk:wrapper></para> + + <para><diffmk:wrapper diffmk:change="added">In the </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Data Explorer View</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added"> right-click the </diffmk:wrapper><emphasis diffmk:change="added"> + <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Data Source</diffmk:wrapper></property> + </emphasis><diffmk:wrapper diffmk:change="added"> node and choose </diffmk:wrapper><emphasis diffmk:change="added"> + <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">New Data Source</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added">.</diffmk:wrapper></emphasis></para> + + <figure float="0"> + <title><diffmk:wrapper diffmk:change="changed">Creating a New Data Source</diffmk:wrapper></title> + <mediaobject> + <imageobject> + <imagedata fileref="images/hibernate_datasource/creatingDataSource.png"/> + </imageobject> + </mediaobject> + </figure> + + <para><diffmk:wrapper diffmk:change="added">In the wizard select </diffmk:wrapper><emphasis diffmk:change="added"> + <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Hibernate Data Source</diffmk:wrapper></property> + </emphasis><diffmk:wrapper diffmk:change="added"> and give it a proper name, </diffmk:wrapper><emphasis diffmk:change="added"> + <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">HbDataSource</diffmk:wrapper></property> + </emphasis><diffmk:wrapper diffmk:change="added"> for instance. Hit </diffmk:wrapper><emphasis> + <property moreinfo="none">Next</property><diffmk:wrapper diffmk:change="added">.</diffmk:wrapper></emphasis></para> + + <figure float="0"> + <title><diffmk:wrapper diffmk:change="changed">Creating Hibernate Data Source</diffmk:wrapper></title> + <mediaobject> + <imageobject> + <imagedata fileref="images/hibernate_datasource/hibernateDataSource.png"/> + </imageobject> + </mediaobject> + </figure> + + <para><diffmk:wrapper diffmk:change="added">On the next wizard page leave everything as it is, just press the </diffmk:wrapper><emphasis diffmk:change="added"> + <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Test Connection</diffmk:wrapper></property> + </emphasis><diffmk:wrapper diffmk:change="added"> button to verify the connection is successful.</diffmk:wrapper></para> + + <figure float="0"> + <title><diffmk:wrapper diffmk:change="changed">Hibernate Data Source Profile</diffmk:wrapper></title> + <mediaobject> + <imageobject> + <imagedata fileref="images/hibernate_datasource/connectionSuccessful.png"/> + </imageobject> + </mediaobject> + </figure> + + <para><diffmk:wrapper diffmk:change="added">Click </diffmk:wrapper><emphasis diffmk:change="added"> + <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Ok</diffmk:wrapper></property> + </emphasis><diffmk:wrapper diffmk:change="added"> and then </diffmk:wrapper><emphasis> + <property moreinfo="none">Finish</property> + </emphasis><diffmk:wrapper diffmk:change="changed"> to complete.</diffmk:wrapper></para> + + <para><diffmk:wrapper diffmk:change="added">Now let's add a Hibernate ODA dataset. To do that you should bring up the + </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">New Data Set wizard</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added">. In the </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Data Explorer View</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added"> + right-click the </diffmk:wrapper><emphasis diffmk:change="added"> + <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Data Set</diffmk:wrapper></property> + </emphasis><diffmk:wrapper diffmk:change="added"> node and select </diffmk:wrapper><emphasis diffmk:change="added"> + <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">New Data Set</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added">.</diffmk:wrapper></emphasis></para> + + <figure diffmk:change="added" float="0"> + <title><diffmk:wrapper diffmk:change="changed">Creating a New Data Set</diffmk:wrapper></title> + <mediaobject diffmk:change="added"> + <imageobject diffmk:change="added"> + <imagedata diffmk:change="added" fileref="images/hibernate_datasource/creatingDataSet.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para><diffmk:wrapper diffmk:change="added">In the </diffmk:wrapper><emphasis diffmk:change="added"> + <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Data Set Name</diffmk:wrapper></property> + </emphasis><diffmk:wrapper diffmk:change="added"> section specify the name. Let's it be </diffmk:wrapper><emphasis diffmk:change="added"> + <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">HbDataSet</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added">.</diffmk:wrapper></emphasis></para> + + <figure float="0"> + <title><diffmk:wrapper diffmk:change="changed">Creating a Hibernate ODA Data Set</diffmk:wrapper></title> + <mediaobject> + <imageobject> + <imagedata fileref="images/hibernate_datasource/addingHibernateODADataset.png"/> + </imageobject> + </mediaobject> + </figure> + + <para><diffmk:wrapper diffmk:change="changed">Next you'll be prompted to define the query for this data set. To validate the + entered query you can press the </diffmk:wrapper><emphasis> + <property moreinfo="none"><diffmk:wrapper diffmk:change="changed">Test query</diffmk:wrapper></property> + </emphasis><diffmk:wrapper diffmk:change="changed"> button. All the HQL features like syntax highlighting, content assist, + formatting, Drag and Drop, etc., are available to you here.</diffmk:wrapper></para> + + <figure float="0"> + <title><diffmk:wrapper diffmk:change="changed">Testing Query </diffmk:wrapper></title> + <mediaobject> + <imageobject> + <imagedata fileref="images/hibernate_datasource/testingQuery.png"/> + </imageobject> + </mediaobject> + </figure> + + <para><diffmk:wrapper diffmk:change="changed">Next the output columns will be displayed. It's possible to edit them + here.</diffmk:wrapper></para> + + <figure float="0"> + <title><diffmk:wrapper diffmk:change="changed">HQL Features - Output Columns Section</diffmk:wrapper></title> + <mediaobject> + <imageobject> + <imagedata fileref="images/hibernate_datasource/hqlFeaturesOutputColumns.png"/> + </imageobject> + </mediaobject> + </figure> + + <para><diffmk:wrapper diffmk:change="changed">To preview the results of the defined query click the </diffmk:wrapper><emphasis> + <property moreinfo="none"><diffmk:wrapper diffmk:change="changed">Preview Results</diffmk:wrapper></property> + </emphasis><diffmk:wrapper diffmk:change="changed"> item.</diffmk:wrapper></para> + <figure float="0"> + <title><diffmk:wrapper diffmk:change="changed">HQL Features - Preview Results Section</diffmk:wrapper></title> + <mediaobject> + <imageobject> + <imagedata fileref="images/hibernate_datasource/hqlFeaturesPreviewResults.png"/> + </imageobject> + </mediaobject> + </figure> + + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">So far you have the Hibernate data source and data set defined. Now you can create a BIRT + report using this data source and data set.</diffmk:wrapper></para> + + <tip diffmk:change="added"> + <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">Tip:</diffmk:wrapper></title> + <para><diffmk:wrapper diffmk:change="added">If you don't know how to do this we suggest that you refer to the </diffmk:wrapper><ulink diffmk:change="added" url="http://www.eclipse.org/birt/phoenix/tutorial/"><diffmk:wrapper diffmk:change="added">Eclipse BIRT Tutorial</diffmk:wrapper></ulink><diffmk:wrapper diffmk:change="added">.</diffmk:wrapper></para> + </tip> + + <figure float="0"> + <title><diffmk:wrapper diffmk:change="changed">Creating a BIRT Report using Created Data Source and Data Set</diffmk:wrapper></title> + <mediaobject> + <imageobject> + <imagedata + fileref="images/hibernate_datasource/BIRTReportUsingDataSourceAndSet.png "/> + </imageobject> + </mediaobject> + </figure> + + <para><diffmk:wrapper diffmk:change="changed">If you switch to the </diffmk:wrapper><emphasis> + <property moreinfo="none"><diffmk:wrapper diffmk:change="changed">Preview</diffmk:wrapper></property></emphasis><diffmk:wrapper diffmk:change="changed"> tab, it will run your report and show the output.</diffmk:wrapper></para> + + <figure diffmk:change="added" float="0"> + <title><diffmk:wrapper diffmk:change="changed">BIRT Report -Preview Tab</diffmk:wrapper></title> + <mediaobject diffmk:change="added"> + <imageobject diffmk:change="added"> + <imagedata diffmk:change="added" fileref="images/hibernate_datasource/BIRTReportPreviewTab.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para><diffmk:wrapper diffmk:change="added">You can also use parameters within the Hibernate ODA driver.</diffmk:wrapper></para> + + <figure diffmk:change="added" float="0"> + <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">Using Parameters within the Hibernate ODA Driver</diffmk:wrapper></title> + <mediaobject diffmk:change="added"> + <imageobject diffmk:change="added"> + <imagedata diffmk:change="added" fileref="images/hibernate_datasource/parametersWithinHibernateODADriver.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + + <figure diffmk:change="added" float="0"> + <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">Adding New Parameter</diffmk:wrapper></title> + <mediaobject diffmk:change="added"> + <imageobject diffmk:change="added"> + <imagedata diffmk:change="added" fileref="images/hibernate_datasource/addingNewParameter.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">Again, to preview the results switch to the </diffmk:wrapper><emphasis diffmk:change="added"> + <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Preview Results</diffmk:wrapper></property> + </emphasis><diffmk:wrapper diffmk:change="added"> item.</diffmk:wrapper></para> + <figure diffmk:change="added" float="0"> + <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">Previewing the Results</diffmk:wrapper></title> + <mediaobject diffmk:change="added"> + <imageobject diffmk:change="added"> + <imagedata diffmk:change="added" fileref="images/hibernate_datasource/previewingResults.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + +</chapter> + + +<chapter diffmk:change="added" id="birt_reports_deployment" xml:base="file:///home/ochikvina/WORK/for_compare/trunk/birt/docs/en/modules/birt_reports_deployment.xml" xreflabel="birt_reports_deployment"> + + <?dbhtml filename="birt_reports_deployment"?> + <chapterinfo> + <keywordset> + <keyword>JBoss</keyword> + <keyword>BIRT</keyword> + <keyword><diffmk:wrapper diffmk:change="changed">Seam</diffmk:wrapper></keyword> + </keywordset> + </chapterinfo> + + <title><diffmk:wrapper diffmk:change="changed">BIRT Reports Deployment</diffmk:wrapper></title> + + <para><diffmk:wrapper diffmk:change="changed">When everything is configured correctly you will be able to view/render the designed + reports in your Seam (or any other) Web application.</diffmk:wrapper></para> + + <para><diffmk:wrapper diffmk:change="added">You can deploy a report by adding an action button to the Seam's CRUD </diffmk:wrapper><emphasis diffmk:change="added"> + <property moreinfo="none"><diffmk:wrapper diffmk:change="changed">.xhtml</diffmk:wrapper></property> + </emphasis><diffmk:wrapper diffmk:change="added"> file.</diffmk:wrapper></para> + + <figure diffmk:change="added" float="0"> + <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">Adding Action Button to the Seam file</diffmk:wrapper></title> + <mediaobject diffmk:change="added"> + <imageobject diffmk:change="added"> + <imagedata diffmk:change="added" fileref="images/birt_reports_deployment/addingActionButton.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para><diffmk:wrapper diffmk:change="added">As you can see on the figure you should have the </diffmk:wrapper><emphasis diffmk:change="added"> + <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">testHibernateOda.xhtml</diffmk:wrapper></property> + </emphasis><diffmk:wrapper diffmk:change="added"> file. It's content should be the following:</diffmk:wrapper></para> + + <programlisting diffmk:change="added" format="linespecific" role="XHTML"><diffmk:wrapper diffmk:change="added"><![CDATA[<p:birt xmlns:ui="http://java.sun.com/jsf/facelets" + xmlns:s="http://jboss.com/products/seam/taglib" + xmlns:p="http://jboss.com/products/seam/birt" + designType="run" + format="pdf" + designName="testHibernateOda.rptdesign" + title="JBoss Birt Test"> + +</p:birt> +]]></diffmk:wrapper></programlisting> + + <para><diffmk:wrapper diffmk:change="added">Next run the Seam page with embedded report on the server by right-clicking the file and + going to </diffmk:wrapper><emphasis diffmk:change="added"> + <property moreinfo="none"><diffmk:wrapper diffmk:change="changed">Run > Run on Server</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added">.</diffmk:wrapper></emphasis></para> + + <figure diffmk:change="added" float="0"> + <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">Opening Employees.xhtml Page</diffmk:wrapper></title> + <mediaobject diffmk:change="added"> + <imageobject diffmk:change="added"> + <imagedata diffmk:change="added" fileref="images/birt_reports_deployment/openingArticlesPage.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para><diffmk:wrapper diffmk:change="added">After clicking the </diffmk:wrapper><emphasis diffmk:change="added"> + <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">BIRT PDF Report</diffmk:wrapper></property> + </emphasis><diffmk:wrapper diffmk:change="added"> button, you should see the following report:</diffmk:wrapper></para> + + <figure diffmk:change="added" float="0"> + <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">Birt PDF Report</diffmk:wrapper></title> + <mediaobject diffmk:change="added"> + <imageobject diffmk:change="added"> + <imagedata diffmk:change="added" fileref="images/birt_reports_deployment/BirtPDFReport.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para><diffmk:wrapper diffmk:change="added">Thus, a Seam project that includes the BIRT facet can be deployed as any project. If you + define the Hibernate ODA driver, the JBoss BIRT engine will use JNDI URL that has to be bind + to either Hibernate Session Factory or Hibernate Entity Manager Factory. If you + don't specify the JNDI URL property, our engine will try the following JNDI + URLs:</diffmk:wrapper></para> + <itemizedlist diffmk:change="added"> + <listitem> + <para> + <emphasis><diffmk:wrapper diffmk:change="changed">java:/<project_name></diffmk:wrapper></emphasis> + </para> + </listitem> + <listitem> + <para> + <emphasis diffmk:change="added"><diffmk:wrapper diffmk:change="added">java:/<project_name>EntityManagerFactory</diffmk:wrapper></emphasis> + </para> + </listitem> + </itemizedlist> + + <para><diffmk:wrapper diffmk:change="added">When creating a Seam EAR project, Hibernate Entity Manager Factory is bound to + </diffmk:wrapper><emphasis diffmk:change="added"><diffmk:wrapper diffmk:change="added">java:/{projectName}EntityManagerFactory</diffmk:wrapper></emphasis><diffmk:wrapper diffmk:change="added">. All you need to do is + using the Hibernate Configuration created automatically. You can use default values for the + Hibernate Configuration and JNDI URL within the BIRT Hibernate Data Source.</diffmk:wrapper></para> + + <para><diffmk:wrapper diffmk:change="added">When using a Seam WAR project, neither HSF nor HEMF aren't binded to JNDI by + default. You has to do this manually. For instance, HSF can be bound to JNDI by adding the + following property to the </diffmk:wrapper><emphasis diffmk:change="added"> + <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">persistence.xml</diffmk:wrapper></property></emphasis><diffmk:wrapper diffmk:change="added"> file:</diffmk:wrapper></para> + + <programlisting diffmk:change="added" format="linespecific" role="XHTML"><diffmk:wrapper diffmk:change="added"><![CDATA[<property name="hibernate.session_factory_name" value="java:/projectname"/> + ]]></diffmk:wrapper></programlisting> + + <para><diffmk:wrapper diffmk:change="added">And you can use </diffmk:wrapper><emphasis diffmk:change="added"><diffmk:wrapper diffmk:change="added">java:/projectname</diffmk:wrapper></emphasis><diffmk:wrapper diffmk:change="added"> as the JNDI URL property when creating a BIRT + Hibernate Data Source.</diffmk:wrapper></para> + + <note diffmk:change="added"> + <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">Note:</diffmk:wrapper></title> + <para><diffmk:wrapper diffmk:change="added">If you want to test this feature using PDE Runtime, you need to add </diffmk:wrapper><emphasis diffmk:change="added"> + <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">osgi.dev=bin</diffmk:wrapper></property> + </emphasis><diffmk:wrapper diffmk:change="added"> to the </diffmk:wrapper><emphasis diffmk:change="added"> + <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">WebContent/WEB-INF/platform/configuration/config.ini</diffmk:wrapper></property> + </emphasis><diffmk:wrapper diffmk:change="added"> file.</diffmk:wrapper></para> + </note> + <para><diffmk:wrapper diffmk:change="added">In conclusion, the main goal of this document is to get you know with a full featureset + that </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">JBoss BIRT Tools</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added"> provide. Thus if you have some questions, + comments or suggestions on the topic, please feel free to ask in the </diffmk:wrapper><ulink diffmk:change="added" url="http://www.jboss.org/index.html?module=bb&op=viewforum&f=201"><diffmk:wrapper diffmk:change="added">JBoss + Tools Forum</diffmk:wrapper></ulink><diffmk:wrapper diffmk:change="added">. You can also influence on how you want to see JBoss Tools docs in + future leaving your vote on our page </diffmk:wrapper><ulink diffmk:change="added" url="http://www.jboss.org/community/docs/DOC-10795"><diffmk:wrapper diffmk:change="added">here</diffmk:wrapper></ulink><diffmk:wrapper diffmk:change="added">.</diffmk:wrapper></para> + + + + +</chapter></book>

15 years, 1 month

1
0
0 / 0

JBoss Tools SVN: r15155 - in branches/jbosstools-3.0.x/birt/docs: en and 2 other directories.

by jbosstools-commits＠lists.jboss.org

Author: smukhina Date: 2009-05-11 11:18:11 -0400 (Mon, 11 May 2009) New Revision: 15155 Removed: branches/jbosstools-3.0.x/birt/docs/en/images/BirtIntegration/ branches/jbosstools-3.0.x/birt/docs/en/images/BirtSupport/ branches/jbosstools-3.0.x/birt/docs/en/modules/birt_designer.xml branches/jbosstools-3.0.x/birt/docs/en/modules/birt_integration.xml branches/jbosstools-3.0.x/birt/docs/en/modules/birt_support.xml Modified: branches/jbosstools-3.0.x/birt/docs/en/master.xml branches/jbosstools-3.0.x/birt/docs/en/modules/introduction.xml branches/jbosstools-3.0.x/birt/docs/pom.xml Log: https://jira.jboss.org/jira/browse/JBDS-717 merged changes from trunk are added to the corresponding branch Modified: branches/jbosstools-3.0.x/birt/docs/en/master.xml =================================================================== --- branches/jbosstools-3.0.x/birt/docs/en/master.xml 2009-05-11 14:40:45 UTC (rev 15154) +++ branches/jbosstools-3.0.x/birt/docs/en/master.xml 2009-05-11 15:18:11 UTC (rev 15155) @@ -4,18 +4,17 @@ [ <!ENTITY introduction SYSTEM "modules/introduction.xml"> -<!ENTITY birt_support SYSTEM "modules/birt_support.xml"> -<!ENTITY birt_designer SYSTEM "modules/birt_designer.xml"> - - - +<!ENTITY birt_integration_with_seam SYSTEM "modules/birt_integration_with_seam.xml"> +<!ENTITY hibernate_datasource SYSTEM "modules/hibernate_datasource.xml"> +<!ENTITY birt_reports_deployment SYSTEM "modules/birt_reports_deployment.xml"> ]> + <book> <bookinfo> - <title>Birt Plugin Reference Guide</title> + <title>Birt Plugin Integration Reference Guide</title> <author><firstname>Anastasiya</firstname><surname>Bogachuk</surname><email>abogachuk(a)exadel.com</email></author> - + <author><firstname>Olga</firstname><surname>Chikvina</surname></author> <pubdate>August 2008</pubdate> <copyright> @@ -38,11 +37,10 @@ </bookinfo> <toc/> - - - &introduction; - &birt_support; - &birt_designer; + &introduction; + &birt_integration_with_seam; + &hibernate_datasource; + &birt_reports_deployment; </book> \ No newline at end of file Deleted: branches/jbosstools-3.0.x/birt/docs/en/modules/birt_designer.xml =================================================================== --- branches/jbosstools-3.0.x/birt/docs/en/modules/birt_designer.xml 2009-05-11 14:40:45 UTC (rev 15154) +++ branches/jbosstools-3.0.x/birt/docs/en/modules/birt_designer.xml 2009-05-11 15:18:11 UTC (rev 15155) @@ -1,160 +0,0 @@ -<?xml version='1.0' encoding='UTF-8'?> -<chapter id="Birt_Designer" xreflabel="Birt_Designer"> - <?dbhtml filename="birtDesigner.html"?> - <chapterinfo> - <keywordset> - <keyword>JBoss</keyword> - <keyword>BIRT</keyword> - <keyword>BIRT Designer</keyword> - <keyword>BIRT Report Designer</keyword> - </keywordset> - </chapterinfo> - - <title>BIRT Report Designer</title> - - <para>BIRT Designer is an intuitive and quite easy Eclipse-based set of plugins to make reports. - In this chapter we will describe its interface and its features to you.</para> - - <section id="birt_designer_UI" xreflabel="birt_designer_UI"> - <title>BIRT User Interface</title> - - <para>The central part of the user interface is the <property>Layout Editor</property>. It - displays the whole process of building a report and contains the following tabs:</para> - - <itemizedlist> - <listitem> - <para><emphasis role="bold">Layout</emphasis> - this is an area where you can edit - your report design;</para> - </listitem> - <listitem> - <para><emphasis role="bold">Preview</emphasis> - runs your report created and shows - the output;</para> - </listitem> - <listitem> - <para><emphasis role="bold">Script</emphasis> - on this page you can add JavaScript - to your report to customize its behavior;</para> - </listitem> - <listitem> - <para><emphasis role="bold">XML Source</emphasis> - this is an area where you can - view and modify the XML source of your report;</para> - </listitem> - <listitem> - <para><emphasis role="bold">Master Page</emphasis> - use it to format page - data.</para> - </listitem> - </itemizedlist> - - <para>The next part of user interface is different <property>Views</property> that can be - arranged around the Layout Editor area the way you like:</para> - - <itemizedlist> - <listitem> - <para><emphasis role="bold">Palette</emphasis> - shows the standard report items you - can add to your report using drag and drop.</para> - </listitem> - <listitem> - <para><emphasis role="bold">Outline</emphasis> - shows the structure of your report - as a tree view.</para> - </listitem> - <listitem> - <para><emphasis role="bold">Navigator</emphasis> - shows your projects and reports - within the projects.</para> - </listitem> - <listitem> - <para><emphasis role="bold">Data Explorer</emphasis> - shows your data sources, data - sets and report parameters. You also can use this view to add data set columns - to your report layout.</para> - </listitem> - <listitem> - <para><emphasis role="bold">Property Editor</emphasis> - displays properties for - many report items.</para> - </listitem> - <listitem> - <para><emphasis role="bold">Properties View</emphasis> - shows all properties for a - report item as a simple list.</para> - </listitem> - <listitem> - <para><emphasis role="bold">Library Explorer View</emphasis> - allows the reuse of - report objects, such as tables, data sources and styles. Objects created for - reuse are stored in a library file. The Library Explorer will display Libraries - that exist in the Resource folder. Developed libraries can be added to the - resource folder by selecting <emphasis>File→Publish Library in Resource - Folder</emphasis>. The resource folder location can be configured. </para> - </listitem> - - </itemizedlist> - - </section> - - <section id="birt_designer_features"> - - <title>BIRT Report Designer Features</title> - <para>Here are the main BIRT Report Designer features:</para> - <itemizedlist> - <listitem> - <para><emphasis role="bold">Palette</emphasis> - contains tables, labels, and - charts. It is used in conjunction with the Layout View to design reports.</para> - </listitem> - <listitem> - <para><emphasis role="bold">Data Explorer</emphasis> - organizes your data sources - and data sets. The Data Sets editor enables testing your data set to check - whether the report receives the correct data. You can also create cubes using - your data sets (when building any dynamic cross tables) and design necessary - report parameters.</para> - </listitem> - <listitem> - <para><emphasis role="bold">Resource Explorer</emphasis> - BIRT allows the reuse of - report objects, such as tables, data sources and styles. Objects created for - reuse are stored in a library file. To browse the contents of report libraries - BIRT supplies the Resource Explorer view. This view lists all libraries within - the resource folder, in addition to other shared content such as images and - JavaScript files.</para> - </listitem> - <listitem> - <para><emphasis role="bold">Property Editor</emphasis> - shows the most commonly - used properties. BIRT also integrates with the standard Eclipse property view to - display a detailed listing of all properties for an item.</para> - </listitem> - <listitem> - <para><emphasis role="bold">Layout View</emphasis> - WYSIWYG editor. You can select - any element from the Palette, drag and drop it to the report and then edit the - way you like.</para> - </listitem> - <listitem> - <para><emphasis role="bold">Script Editor</emphasis> - scripting adds business logic - to reports during data access, report generation, or viewing. The code editor - provides standard features for editing scripts: syntax coloring, auto-complete - etc. You also can debug scripts when the report is running.</para> - </listitem> - <listitem> - <para><emphasis role="bold">Report Preview</emphasis> - Report Preview is used to - test your newly created report with some real data.</para> - </listitem> - <listitem> - <para><emphasis role="bold">Chart Builder</emphasis> - using the Chart Builder you - can add any charts to the design of your report. Just select a chart type, then - data and, finally, format the chart.</para> - </listitem> - <listitem> - <para><emphasis role="bold">Expression Builder </emphasis> - expressions are simple - scripts that return a value. They are used to assign data values to report - elements, build image locations, hyperlinks, parameter default values - etc.</para> - </listitem> - <listitem> - <para><emphasis role="bold">Cheat Sheets</emphasis> - Cheat sheets are small pices - of useful documentation that lead you through a report creation process. Just - select what you need and then follow the instructions.</para> - </listitem> - <listitem> - <para><emphasis role="bold">Outline</emphasis> - this view provides a compact - overview of the entire report structure.</para> - </listitem> - </itemizedlist> - - <para>In this guide we made a short overview of the BIRT plugin: its installation, support, - features etc. that will help you to make your first steps with it.</para> - - </section> - -</chapter> Deleted: branches/jbosstools-3.0.x/birt/docs/en/modules/birt_integration.xml =================================================================== --- branches/jbosstools-3.0.x/birt/docs/en/modules/birt_integration.xml 2009-05-11 14:40:45 UTC (rev 15154) +++ branches/jbosstools-3.0.x/birt/docs/en/modules/birt_integration.xml 2009-05-11 15:18:11 UTC (rev 15155) @@ -1,548 +0,0 @@ -<?xml version='1.0' encoding='UTF-8'?> -<chapter id="Birt_Seam_Web_Project" xreflabel="Birt_Seam_Web_Project"> - - <?dbhtml filename="birtSeamWebProject.html"?> - <chapterinfo> - <keywordset> - <keyword>JBoss</keyword> - <keyword>BIRT</keyword> - <keyword>Seam</keyword> - </keywordset> - </chapterinfo> - - <title> Adding JBoss BIRT functionality to the standard Seam web project</title> - - <para>In this chapter you'll find out how to create a web project including Seam and BIRT capabilities </para> - - <section id="prerequisites" xreflabel="prerequisites"> - <title>Prerequisites</title> - - <para>These are the prerequisites required to create a Seam web project including with BIRT functionality:</para> - - <orderedlist> - <listitem> - <para> - <ulink url="http://download.eclipse.org/eclipse/downloads/drops/R-3.4-200806172000/in...">Eclipse Version 3.4 SDK</ulink> - </para> - </listitem> - <listitem> - <para> - <ulink url="http://www.eclipse.org/downloads/download.php?file=/datatools/downloads/1...">DTP Version 1.6 Release</ulink> - </para> - </listitem> - <listitem> - <para> - <ulink url="http://www.eclipse.org/modeling/emf/downloads/?project=emf">EMF Version 2.4 Release EMF+XSD</ulink> - </para> - </listitem> - <listitem> - <para> - <ulink url="http://www.eclipse.org/gef/downloads/">GEF Version 3.4 Release runtime</ulink> - </para> - </listitem> - <listitem> - <para> - <ulink url="http://download.eclipse.org/webtools/downloads/drops/R3.0/R-3.0-200806161...">WTP Version 3.0 Release</ulink> - </para> - </listitem> - <listitem> - <para> - <ulink url="http://www.eclipse.org/downloads/download.php?file=/birt/downloads/drops/...">BIRT Report Designer SDK 2.3.0 Release</ulink> or <ulink url="http://www.eclipse.org/downloads/download.php?file=/birt/downloads/drops/...">BIRT Report Designer 2.3.0 Release</ulink> - </para> - </listitem> - <listitem> - <para> - <ulink url="http://sourceforge.net/project/showfiles.php?group_id=22866&package_i...">JBoss Application Server 4.2.2 GA</ulink> - </para> - </listitem> - <listitem> - <para> - <ulink url="http://sourceforge.net/project/showfiles.php?group_id=22866&package_i...">JBoss Seam 2.0.1 GA</ulink> - </para> - </listitem> - <listitem> - <para> - <ulink url="http://www.eclipse.org/downloads/download.php?file=/birt/downloads/drops/...">BIRT Web Tools Integration</ulink> - </para> - </listitem> - <listitem> - <para> - <ulink url="http://download.jboss.org/jbosstools/builds/nightly/latestBuild.html">JBoss Tools nightly build</ulink> - </para> - </listitem> - <listitem> - <para> - <ulink url="http://jira.jboss.com/jira/secure/attachment/12320944/org.jboss.tools.bir...">JBoss BIRT integration feature</ulink> - </para> - </listitem> - </orderedlist> - - </section> - - <section id="creating_web_project" xreflabel="creating_web_project"> - <title>Creating a web project</title> - - <para>Follow the next steps to create a web project</para> - <orderedlist> - <listitem> - <para>Create a new Seam Web Project</para> - </listitem> - <listitem> - <para>Choose the 2.0 version of the Seam facet</para> - </listitem> - <listitem> - <para>Add the "Birt Reporting Runtime Component" facet </para> - </listitem> - </orderedlist> - - <figure> - <title>Adding "Birt Reporting Runtime Component" Facet </title> - <mediaobject> - <imageobject> - <imagedata fileref="images/BirtSeamProject/AddingBirtFacet.png"/> - </imageobject> - </mediaobject> - </figure> - - <orderedlist> - <listitem> - <para>Or choose the "JBoss BIRT Integration Web Project" - configuration</para> - </listitem> - </orderedlist> - - <figure> - <title>Choosing "JBoss BIRT Integration Web Project " - Configuration</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/BirtSeamProject/SeamProjectConfiguration.png"/> - </imageobject> - </mediaobject> - </figure> - - <orderedlist> - <listitem> - <para>Create the birttests.xhtml, testbirt.xhtml and testbirt1.xhtml pages as - follows:</para> - </listitem> - </orderedlist> - <para> - <emphasis role="bold">birttests.xhtml:</emphasis> - </para> - - <programlisting role="XHTML"><![CDATA[ - <!DOCTYPE composition PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" - "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> - <ui:composition xmlns="http://www.w3.org/1999/xhtml" - xmlns:s="http://jboss.com/products/seam/taglib" - xmlns:ui="http://java.sun.com/jsf/facelets" xmlns:f="http://java.sun.com/jsf/core" - xmlns:h="http://java.sun.com/jsf/html" - xmlns:rich="http://richfaces.org/rich" - template="layout/template.xhtml"> - - <ui:define name="body"> - <h:messages globalOnly="true" styleClass="message"/> <rich:panel> - <f:facet name="header">Welcome to JBoss BIRT!</f:facet> - <ul> - <li><s:link view="/testbirt.xhtml" value="Test Birt" /></li> - <li><s:link view="/testbirt1.xhtml" value="Test Birt 1" /></li> - </ul> - </rich:panel> - </ui:define> - </ui:composition> - ]]></programlisting> - - - <para> - <emphasis role="bold">testbirt.xhtml:</emphasis> - </para> - - <programlisting role="XHTML"><![CDATA[ - <p:birt xmlns:ui="http://java.sun.com/jsf/facelets" - xmlns:s="http://jboss.com/products/seam/taglib" - xmlns:p="http://jboss.com/products/seam/birt" - designType="run" - format="pdf" - designName="test.rptdesign" - title="JBoss Birt Test"> - - <p:param name="sample" value="sample param"/> - </p:birt> - ]]></programlisting> - - <para> - <emphasis role="bold">testbirt1.xhtml:</emphasis> - </para> - - <programlisting role="XHTML"><![CDATA[ -<p:birt xmlns:ui="http://java.sun.com/jsf/facelets" - xmlns:s="http://jboss.com/products/seam/taglib" - xmlns:p="http://jboss.com/products/seam/birt" - designType="frameset" - designName="test1.rptdesign" - title="JBoss Birt Test"> - </p:birt> - ]]></programlisting> - - - <orderedlist> - <listitem> - <para>Try the tests out by accessing http://localhost:8080//birttests.seam with your web browser.</para> - </listitem> - </orderedlist> - - <figure> - <title>Trying the tests out. First Page</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/BirtSeamProject/Tests1.png"/> - </imageobject> - </mediaobject> - </figure> - - <figure> - <title>Trying the tests out. Second Page</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/BirtSeamProject/Tests2.png"/> - </imageobject> - </mediaobject> - </figure> - - <figure> - <title>Trying the tests out. Third Page</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/BirtSeamProject/Tests3.png"/> - </imageobject> - </mediaobject> - </figure> - - <figure> - <title>Trying the tests out. Forth Page</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/BirtSeamProject/Tests4.png"/> - </imageobject> - </mediaobject> - </figure> - - <para>The birt tag recognizes most of the parameters described on <ulink url="http://www.eclipse.org/birt/phoenix/deploy/viewerUsage2.2.php#parameters">the BIRT Report Viewer Parameters page</ulink>. The attributes of the birt tag don't contain the "__" prefix. The param tag describes report parameters. It supports the following attributes: </para> - <orderedlist> - <listitem> - <para>name - the parameter name (required)</para> - </listitem> - <listitem> - <para>value - the parameter value (required)</para> - </listitem> - <listitem> - <para>isnull - specifies that a report parameter has a null value (optional)</para> - </listitem> - <listitem> - <para>islocale - specifies whether the parameter is localized (optional)</para> - </listitem> - </orderedlist> - <para>These tags are defined in the org.jboss.birt.core/resources/jboss-seam-birt.jar library that contains source. </para> - <para>It is possible to embed a BIRT report in some Seam xhtml page. For instance: </para> - <para/> - - <para> - <emphasis role="bold">Example:</emphasis> - </para> - <!DOCTYPE composition PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" - "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> - -<ui:composition xmlns="http://www.w3.org/1999/xhtml" - xmlns:s="http://jboss.com/products/seam/taglib" - xmlns:ui="http://java.sun.com/jsf/facelets" - xmlns:f="http://java.sun.com/jsf/core" - xmlns:h="http://java.sun.com/jsf/html" - xmlns:rich="http://richfaces.org/rich" - xmlns:b="http://jboss.com/products/seam/birt" - template="layout/template.xhtml"> - -<ui:define name="body"> - - <h:messages globalOnly="true" styleClass="message" id="globalMessages"/> - - <rich:panel> - <f:facet name="header">Products</f:facet> - - <b:birt designType="embed" - designName="ProductCatalog.rptdesign" - embeddable="true" - masterpage="false"> - </b:birt> - - - <div style="clear:both"/> - - </rich:panel> - - <div class="actionButtons"> - - <s:button view="/ProductsEdit.xhtml" - id="edit" - value="Edit"/> - - <s:button view="/BirtProductsPdf.xhtml" - id="BirtProductPdf" - value="Product Catalog - PDF"/> - - <s:button view="/BirtProductsFrameset.xhtml" - id="BirtProductFrameset" - value="Product Catalog - Frameset"/> - - <s:button view="/BirtProductsEmbedded.xhtml" - id="BirtProductEmbedded" - value="Product Catalog - Embedded"/> - - <s:button view="/TopSellingProducts.xhtml" - id="TopSellingProducts" - value="Top Selling Products"/> - - <s:button view="/#{empty productsFrom ? 'ProductsList' : productsFrom}.xhtml" - id="done" - value="Done"/> - - </div> - -</ui:define> - -</ui:composition> - - <programlisting role="XHTML"><![CDATA[ - ]]></programlisting> - -<figure> - <title>Embeding BIRT Report in Seam xhtml Page. First Page</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/BirtSeamProject/BirtReportInSeamPage1.png"/> - </imageobject> - </mediaobject> - </figure> - - <figure> - <title>Embeding BIRT Report in Seam xhtml Page. Second Page</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/BirtSeamProject/BirtReportInSeamPage2.png"/> - </imageobject> - </mediaobject> - </figure> - - -</section> - -<section> -<title>Hibernate ODA Data Source</title> - -<para>The JBoss BIRT Integration feature includes the Hibernate ODA Data Source completely integrated with Hibernate Tools. You can use it in the way you use any of BIRT ODA drivers. For instance, </para> - <orderedlist> - <listitem> - <para>run the Seam Generate Entities action</para> - </listitem> - </orderedlist> - <para>This action will create a Hibernate Console configuration. </para> - <orderedlist> - <listitem> - <para>create a new BIRT report</para> - </listitem> - </orderedlist> - - <figure> - <title>Adding "Birt Reporting Runtime Component" Facet </title> - <mediaobject> - <imageobject> - <imagedata fileref="images/BirtSeamProject/AddingBirtFacet.png"/> - </imageobject> - </mediaobject> - </figure> - - <orderedlist> - <listitem> - <para>add the Hibernate ODA datasource</para> - </listitem> - </orderedlist> - - <figure> - <title>Adding "Birt Reporting Runtime Component" Facet </title> - <mediaobject> - <imageobject> - <imagedata fileref="images/BirtSeamProject/AddingBirtFacet.png"/> - </imageobject> - </mediaobject> - </figure> - - <figure> - <title>Adding "Birt Reporting Runtime Component" Facet </title> - <mediaobject> - <imageobject> - <imagedata fileref="images/BirtSeamProject/AddingBirtFacet.png"/> - </imageobject> - </mediaobject> - </figure> - - - -<orderedlist> - <listitem> - <para>add the Hibernate ODA dataset</para> - </listitem> - </orderedlist> - - <figure> - <title>Adding "Birt Reporting Runtime Component" Facet </title> - <mediaobject> - <imageobject> - <imagedata fileref="images/BirtSeamProject/AddingBirtFacet.png"/> - </imageobject> - </mediaobject> - </figure> - - <figure> - <title>Adding "Birt Reporting Runtime Component" Facet </title> - <mediaobject> - <imageobject> - <imagedata fileref="images/BirtSeamProject/AddingBirtFacet.png"/> - </imageobject> - </mediaobject> - </figure> - -<orderedlist> - <listitem> - <para>All the HQL features like syntax highlighting, content assist, formatting, Drag and Drop, etc., are available to you here <inlinegraphic fileref="embedded:graphics15" width="8.3335inch" depth="5.2083inch"/> - </para> - </listitem> - </orderedlist> - - <figure> - <title>Adding "Birt Reporting Runtime Component" Facet </title> - <mediaobject> - <imageobject> - <imagedata fileref="images/BirtSeamProject/AddingBirtFacet.png"/> - </imageobject> - </mediaobject> - </figure> - <figure> - <title>Adding "Birt Reporting Runtime Component" Facet </title> - <mediaobject> - <imageobject> - <imagedata fileref="images/BirtSeamProject/AddingBirtFacet.png"/> - </imageobject> - </mediaobject> - </figure> - -<para>You can also use parameters within the Hibernate ODA driver. </para> - - -<figure> - <title>Adding "Birt Reporting Runtime Component" Facet </title> - <mediaobject> - <imageobject> - <imagedata fileref="images/BirtSeamProject/AddingBirtFacet.png"/> - </imageobject> - </mediaobject> - </figure> - -<figure> - <title>Adding "Birt Reporting Runtime Component" Facet </title> - <mediaobject> - <imageobject> - <imagedata fileref="images/BirtSeamProject/AddingBirtFacet.png"/> - </imageobject> - </mediaobject> - </figure> - -<figure> - <title>Adding "Birt Reporting Runtime Component" Facet </title> - <mediaobject> - <imageobject> - <imagedata fileref="images/BirtSeamProject/AddingBirtFacet.png"/> - </imageobject> - </mediaobject> - </figure> - - -</section> - -<section> -<title>Deploying a BIRT report</title> -<para>You can deploy this report by adding an action button to the Seam's CRUD xhtml file.</para> - -<figure> - <title>Adding "Birt Reporting Runtime Component" Facet </title> - <mediaobject> - <imageobject> - <imagedata fileref="images/BirtSeamProject/AddingBirtFacet.png"/> - </imageobject> - </mediaobject> - </figure> -<orderedlist> - <listitem> - <para>create the testHibernateOda.xhtml file </para> - </listitem> - </orderedlist> - - <para> - <emphasis role="bold">birttests.xhtml:</emphasis> - </para> - - <programlisting role="XHTML"><![CDATA[ - -<p:birt xmlns:ui="http://java.sun.com/jsf/facelets" - xmlns:s="http://jboss.com/products/seam/taglib" - xmlns:p="http://jboss.com/products/seam/birt" - designType="run" - format="pdf" - designName="testHibernateOda.rptdesign" - title="JBoss Birt Test"> - -</p:birt> -]]></programlisting> - -<orderedlist> - <listitem> - <para>open the Articles.xhtml page</para> - </listitem> - </orderedlist> - -<figure> - <title>Adding "Birt Reporting Runtime Component" Facet </title> - <mediaobject> - <imageobject> - <imagedata fileref="images/BirtSeamProject/AddingBirtFacet.png"/> - </imageobject> - </mediaobject> - </figure> - -<orderedlist> - <listitem> - <para>click the Birt PDF Report button </para> - </listitem> - </orderedlist> - - <figure> - <title>Adding "Birt Reporting Runtime Component" Facet </title> - <mediaobject> - <imageobject> - <imagedata fileref="images/BirtSeamProject/AddingBirtFacet.png"/> - </imageobject> - </mediaobject> - </figure> - - <para>The JNDI URL property can be either Hibernate Session Factory or Hibernate Entity Manager Factory. If a user doesn't specify this property, our engine will try the following JNDI URLs : </para> - <orderedlist> - <listitem> - <para>java:/<project_name></para> - </listitem> - <listitem> - <para>java:/<project_name>EntityManagerFactory</para> - </listitem> - </orderedlist></sect2><sect2><title>NOTE:</title> - <para>If you want to test this feature using PDE Runtime, you need to add osgi.dev=bin to the WebContent/WEB-INF/platform/configuration/config.ini file </para> -</section> - -</chapter> Deleted: branches/jbosstools-3.0.x/birt/docs/en/modules/birt_support.xml =================================================================== --- branches/jbosstools-3.0.x/birt/docs/en/modules/birt_support.xml 2009-05-11 14:40:45 UTC (rev 15154) +++ branches/jbosstools-3.0.x/birt/docs/en/modules/birt_support.xml 2009-05-11 15:18:11 UTC (rev 15155) @@ -1,265 +0,0 @@ -<?xml version="1.0" encoding="UTF-8"?> -<chapter id="esb_support"> - <?dbhtml filename="esb_support.html"?> - <chapterinfo> - <keywordset> - <keyword>JBoss Developer Studio</keyword> - <keyword>Eclipse</keyword> - <keyword>BIRT</keyword> - <keyword>Java</keyword> - <keyword>JBoss</keyword> - </keywordset> - </chapterinfo> - - <title>BIRT Support</title> - - <para>In this section we will focus more on all concepts that JBoss Tools integrates for - working with BIRT.</para> - - <section> - <title>BIRT Plugin Installation</title> - - <para>This chapter will provide you with detailed information on how to install BIRT plugin into JBoss Developer Studio.</para> - - <para>Since BIRT plugin is one of the modules of JBoss Tools project it has a dependence on other modules and will require their pre-installation. </para> - - <para>These are the prerequisites to create a web project including Seam and BIRT capabilities:</para> - <itemizedlist> - <listitem><para>Eclipse Version 3.4 SDK</para></listitem> - <listitem><para>DTP Version 1.6 Release</para></listitem> - <listitem><para>EMF Version 2.4 Release EMF+XSD</para></listitem> - <listitem><para>GEF Version 3.4 Release runtime</para></listitem> - <listitem><para>WTP Version 3.0 Release</para></listitem> - <listitem><para><ulink url="http://repository.jboss.org/eclipse/birt/2.3.0/birt-report-framework-2_3_...">BIRT Report Designer SDK 2.3.0 Release</ulink> or BIRT Report Designer 2.3.0 Release</para></listitem> - <listitem><para>JBoss Application Server 4.2.2 GA</para></listitem> - <listitem><para>JBoss Seam 2.0.1 GA</para></listitem> - <listitem><para><ulink url="http://repository.jboss.org/eclipse/birt/2.3.0/birt-wtp-integration-sdk-2...">BIRT Web Tools Integration</ulink></para></listitem> - <listitem><para>JBoss Tools nightly build</para></listitem> - - </itemizedlist> - - - - </section> - -<section> - - <title>JBoss BIRT Integration</title> - <para>To understand Hibernate configuration, integration with Seam, and deployment see <ulink url="http://docs.jboss.org/tools/whatsnew/birt/birt-news-1.0.0.Alpha1.html">JBoss BIRT Integration 1.0.0.alpha1 - New and Noteworthy</ulink>.</para> - -</section> - - <section> - <title>Creating a BIRT Report</title> - <para>In this chapter we suggest a step-by-step walk-through of creating your own BIRT report.</para> - - <section><title>Create a Report Project</title> - - <para>First create a Report project. Select <emphasis><property>File > New > Project...</property> - </emphasis> in the main menu bar or context menu. The new project dialog appears. Choose <emphasis><property>Business Intelligence and Reporting Tools > Report Project</property></emphasis>: - - <figure> - <title>New Report Project Creation</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/BirtSupport/01ReportProjectWizard.png"/> - </imageobject> - </mediaobject> - </figure> - - Click on the <emphasis><property>Next</property></emphasis> button. Specify a name for the project and change location if necessary:</para> - - <figure> - <title>Specify a Name for the Report Project</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/BirtSupport/02ProjectName.png"/> - </imageobject> - </mediaobject> - </figure> - - <para>Click on the <emphasis><property>Finish</property></emphasis> button. Click <emphasis><property>Ok</property></emphasis> to switch to the Report Design perspective. Your Report Project is now created:</para> - - - <figure> - <title>New Report Project Created</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/BirtSupport/03NewProjectCreated.png"/> - </imageobject> - </mediaobject> - </figure> - </section> - - <section> <title>Create a Report</title> - <para>Now you can create a Report. Go to <emphasis><property>File > New > Report...</property></emphasis>:</para> - - <figure> - <title>Create a New Report</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/BirtSupport/04NewReport.png"/> - </imageobject> - </mediaobject> - </figure> - - <para>The new report dialog appears. Select the created project as a parent folder in the tree view:</para> - - <figure> - <title>Select a Parent Folder</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/BirtSupport/05SelectingParentFolder.png"/> - </imageobject> - </mediaobject> - </figure> - - <para>Click on the <emphasis><property>Next</property></emphasis> button. Then select the type of the template to use for your report. Each template is shown in the Preview window and is described below. Tick off the "Show Report Creation Cheat Sheet" checkbox if you don't need the Cheat Sheets view to be displayed. The Cheat Sheets view can walk you though the process of creating a report based on the template you selected. - - <figure> - <title>Choose a Report Template</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/BirtSupport/06ReportTemplate.png"/> - </imageobject> - </mediaobject> - </figure> - - - Click on the <emphasis><property>Finish</property></emphasis> button to open the newly created report in the workspace:</para> - - <figure> - <title>Report Opened in the Workspace</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/BirtSupport/07SimpleListingReport.png"/> - </imageobject> - </mediaobject> - </figure> - - </section> - - <section> - <title>Build a Data Source</title> - - <para>Data source is used to connect to the database. In order to create a data source for your report follow these steps:</para> - <para>Open the Data Explorer View. Select Data Sources, right-click on it and choose New Data Source:</para> - - - <figure> - <title>Create a Data Source</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/BirtSupport/08DataSource.png"/> - </imageobject> - </mediaobject> - </figure> - - <para>The New Data Source dialog appears. Choose the "Create from a data source type in the following list" radio button and then "Classic Models Inc. Sample Database". Click on the <emphasis><property>Next</property></emphasis> button:</para> - - - <figure> - <title>New Data Source</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/BirtSupport/09NewDataSource.png"/> - </imageobject> - </mediaobject> - </figure> - - <para>The newly created data source details wll be displayed: Driver Class, Database URL and Database User:</para> - - <figure> - <title>New Data Source Details</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/BirtSupport/10NewSampleDateSource.png"/> - </imageobject> - </mediaobject> - </figure> - <para>Click on the <emphasis><property>Finish</property></emphasis> button to add the data source to the data source for your report.</para> - - <para>If you need to edit the data source, right-click on it and select the corresponding option.</para> - </section> - - - <section><title>Build a Data Set</title> - - <para>Data Set is a query to get and represent necessary column data from the data source specified. Select Data Sets in the tree view, right-click on it and select New Data Set:</para> - - <figure> - <title>Create a Data Set</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/BirtSupport/11DataSet.png"/> - </imageobject> - </mediaobject> - </figure> - - - <para>The New Data Set dialog will appear. Enter a name for the Data Set Name field and ensure that the Data Source field shows the data source already created and that the Data Set Type field is set to "SQL Select Query". - Then click on the <emphasis><property>Next</property></emphasis> button:</para> - - - <figure> - <title>New Data Set Details</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/BirtSupport/12NewDataSet.png"/> - </imageobject> - </mediaobject> - </figure> - - <para>Enter the following details into the query:</para> - <programlisting><![CDATA[ -SELECT * -FROM CUSTOMERS -WHERE COUNTRY = 'USA']]></programlisting> - - - <figure> - <title>Query Details</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/BirtSupport/13SQLQuery.png"/> - </imageobject> - </mediaobject> - </figure> - - - <para>Click on the <emphasis><property>Finish</property></emphasis> button. The Edit Data Set window opens where you can change Data Source, Settings, Parameters and other details for the Data Set created. If switched to the Query page you can check the schemas within this database, you can expand them to see the list of tables with their columns:</para> - - - <figure> - <title>Edit the Data Set</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/BirtSupport/14EditDataSet.png"/> - </imageobject> - </mediaobject> - </figure> - - <para>Switch to the Preview page to test your query and verify whether the list of customers appears:</para> - - <figure> - <title>Test the Query</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/BirtSupport/15TestQuery.png"/> - </imageobject> - </mediaobject> - </figure> - - <para>Click on the <emphasis><property>Ok</property></emphasis> button.</para> - </section> - - <section><title>Create Report Layout</title> - - <para>After the Data source and Data set are specified you can continue with the report layout. Please see the <xref linkend="Birt_Designer"/> chapter to learn more about BIRT Report Designer.</para> - - </section> - - - </section> - -</chapter> Modified: branches/jbosstools-3.0.x/birt/docs/en/modules/introduction.xml =================================================================== --- branches/jbosstools-3.0.x/birt/docs/en/modules/introduction.xml 2009-05-11 14:40:45 UTC (rev 15154) +++ branches/jbosstools-3.0.x/birt/docs/en/modules/introduction.xml 2009-05-11 15:18:11 UTC (rev 15155) @@ -6,11 +6,9 @@ <keywordset> <keyword>JBoss Developer Studio</keyword> <keyword>Eclipse</keyword> - <keyword>Java</keyword> <keyword>JBoss</keyword> <keyword>JBoss Tools</keyword> <keyword>JBDS</keyword> - <keyword>BIRT</keyword> <keyword>BIRT Plugin</keyword> </keywordset> </chapterinfo> @@ -20,11 +18,10 @@ <section> <title>What is BIRT?</title> - <para>BIRT plugin for JBoss Developer Studio is an Eclipse-based open source reporting - system for web applications based on Java and J2EE. BIRT consists of two main - components: a report designer based on Eclipse, and a runtime component that can be - added to your app server. BIRT also offers a charting engine that lets you add charts to - your own Web application.</para> + <para>BIRT plugin is an Eclipse-based open source reporting system for web applications + based on Java and J2EE. BIRT consists of two main components: a report designer based on + Eclipse, and a runtime component that can be added to your app server. BIRT also offers + a charting engine that lets you add charts to your own Web application.</para> <para>With the help of BIRT you can generate a great number of reports to be used in your application:</para> @@ -46,19 +43,75 @@ </listitem> </itemizedlist> - <para>In this guide we provide you with the information on BIRT Designer which allows to - create a report much faster and with far fewer errors to spare your time.</para> + <para>You can find more detailed information on the BIRT plugin, its report types and + anatomy on the <ulink url="http://www.eclipse.org/birt/phoenix/intro/">BIRT Homepage</ulink>.</para> - <literallayout> </literallayout> - <para>You can find detailed information on the BIRT report types and anatomy here: <ulink - url="http://www.eclipse.org/birt/phoenix/intro/">JBoss BIRT</ulink></para> + <para>To understand the basic BIRT concepts and to know how to create a basic BIRT report, + refer to the <ulink url="http://www.eclipse.org/birt/phoenix/tutorial/">Eclipse BIRT + Tutorials</ulink>. What extensions <property>JBoss Tools</property> provides for + Eclipse BIRT you'll find out in the next sections.</para> + </section> + <section> + <title>JBoss BIRT Integration Functionality Overview</title> - <para>All JBoss Developer Studio/JBoss Tools documentation you can find on<ulink - url="http://docs.jboss.org/tools/">documentation release page</ulink>.</para> - <para>The latest documentation builds are available on <ulink - url="http://download.jboss.org/jbosstools/nightly-docs/">documentation nightly builds page</ulink>.</para> + <para>This reference guide describes the one module of the <property>JBoss Tools</property> project which + performs the integration with BIRT. The integration includes the following functionalities:</para> + <itemizedlist> + <listitem> + <para>Hibernate ODA driver that includes a dialog to create HQL queries with + syntax-highlighting, content-assist, formatting as well as other functionalities + available in the HQL editor. There is also a possibility to add + parameters.</para> + </listitem> + <listitem> + <para>possibility to add JBoss BIRT functionality to the standard Seam web + project</para> + </listitem> + <listitem> + <para>BIRT JSF/Seam control</para> + </listitem> + <listitem> + <para>deployment of BIRT reports within web projects (Seam, JSF, etc.)</para> + </listitem> + </itemizedlist> + <para>To enable <property>JBoss Tools</property> integration with BIRT you are intended to + have the next:</para> + <itemizedlist> + <listitem> + <para>Eclipse with <property>JBoss Tools</property> + installed (how to install <property>JBoss Tools</property> on Eclipse, what + dependences and versions requirements are needed reed in the <link + linkend="http://download.jboss.org/jbosstools/nightly-docs/en/GettingStartedGuide/..." + >JBoss Tools Installation</link> section)</para> + </listitem> + <listitem> + <para>BIRT Report Designer (BIRT Report Designer 2.3.2 + you can download from <ulink + url="http://www.eclipse.org/downloads/download.php?file=/birt/downloads/drops/..." + >Eclipse downloads site</ulink>)</para> + </listitem> + <listitem> + <para>BIRT Web Tools Integration ( BIRT WTP Integration 2.3.2 you can download from + <ulink + url="http://www.eclipse.org/downloads/download.php?file=/birt/downloads/drops/..." + >Eclipse downloads site</ulink>)</para> + </listitem> + </itemizedlist> + + <note> + <title>Note:</title> + <para>Versions of BIRT framework and BIRT WTP integration should be no less than RC4 in + order to the BIRT facet works correctly.</para> + </note> </section> + <section id="birt_plugin_rel_resources"> + <title>Other Relevant Resources on the Topic</title> + + <para>All JBoss Developer Studio/JBoss Tools release documentation you can find at<ulink url="http://docs.jboss.org/tools/">http://docs.jboss.org/tools</ulink> in the corresponding release directory.</para> + <para>The latest documentation builds are available at <ulink url="http://download.jboss.org/jbosstools/nightly-docs/">http://download.jboss.org/jbosstools/nightly-docs</ulink>.</para> + </section> + </chapter> Modified: branches/jbosstools-3.0.x/birt/docs/pom.xml =================================================================== --- branches/jbosstools-3.0.x/birt/docs/pom.xml 2009-05-11 14:40:45 UTC (rev 15154) +++ branches/jbosstools-3.0.x/birt/docs/pom.xml 2009-05-11 15:18:11 UTC (rev 15155) @@ -86,6 +86,11 @@ <version>1.1.0</version> <type>jdocbook-style</type> </dependency> + <dependency> + <groupId>org.apache.xmlgraphics</groupId> + <artifactId>fop</artifactId> + <version>0.95</version> + </dependency> </dependencies> <configuration>

15 years, 1 month

1
0
0 / 0

JBoss Tools SVN: r15154 - branches/jbosstools-3.0.x/as/docs/reference/en.

by jbosstools-commits＠lists.jboss.org

Author: smukhina Date: 2009-05-11 10:40:45 -0400 (Mon, 11 May 2009) New Revision: 15154 Modified: branches/jbosstools-3.0.x/as/docs/reference/en/master_output.xml Log: https://jira.jboss.org/jira/browse/JBDS-717 merged changes from trunk are added to the corresponding branch Modified: branches/jbosstools-3.0.x/as/docs/reference/en/master_output.xml =================================================================== --- branches/jbosstools-3.0.x/as/docs/reference/en/master_output.xml 2009-05-11 13:28:49 UTC (rev 15153) +++ branches/jbosstools-3.0.x/as/docs/reference/en/master_output.xml 2009-05-11 14:40:45 UTC (rev 15154) @@ -22,2035 +22,2069 @@ <!ENTITY strutstutoriallink "../../struts_tools_tutorial/html_single/index.html"> -]><book xmlns:diffmk="http://diffmk.sf.net/ns/diff"> - - <bookinfo> - <title>JBoss Server Manager Reference Guide</title> - - <author><firstname>Anatoly</firstname><surname>Fedosik</surname></author> - <author><firstname>Olga</firstname><surname>Chikvina</surname></author> - <author><firstname>Rob</firstname><surname>Stryker</surname><email>rob.stryker(a)jboss.com</email></author> - <author><firstname>Svetlana</firstname><surname>Mukhina</surname><email>smukhina(a)exadel.com</email></author> - - <pubdate>April 2008</pubdate> - <copyright> - <year>2007</year> - <year><diffmk:wrapper diffmk:change="changed">2009</diffmk:wrapper></year> - <holder><diffmk:wrapper diffmk:change="changed">JBoss, a division of Red Hat</diffmk:wrapper></holder> - </copyright> - <releaseinfo><diffmk:wrapper diffmk:change="changed"> - Version: 2.0.0.GA - </diffmk:wrapper></releaseinfo> -<abstract> - <title></title> - <para> - <ulink url="http://download.jboss.org/jbosstools/nightly-docs/en/as/pdf/AS_Reference_...">PDF version</ulink> - </para> -</abstract> - - </bookinfo> - - - <toc></toc> - -<chapter id="quick_start" role="updated" xml:base="file:///home/ochikvina/WORK/for_compare/trunk/as/docs/reference/en/modules/quick_start.xml"> - <title>Quick Start with JBoss Server</title> - - <para>This chapter covers the basics of working with the <property moreinfo="none">JBoss Server</property>. If you - already have installed JBoss server and runtime you can quickly learn how to configure, start, - stop the server, to know deployment and archiving processes. How to install runtimes and servers - read in the <link linkend="runtimes_servers">Runtimes and Servers in the JBoss AS plugin</link> - chapter.</para> - - <para>To start working with JBoss AS, select a <property moreinfo="none">JBoss AS Perspective</property> via - <emphasis><property moreinfo="none">Window > Open Perspective > Other > JBoss - AS</property>.</emphasis></para> - - <section id="starting"> - <title>Starting JBoss Server</title> - - <para>Starting <property moreinfo="none">JBoss Server</property> is quite simple. You can control the server - behaviour with the help of a special toolbar in the <property moreinfo="none">JBoss Server View</property> - where you could <emphasis> - <property moreinfo="none">start</property> - </emphasis> it in a regular or debug mode, <emphasis> - <property moreinfo="none">stop</property> - </emphasis> it or <emphasis> - <property moreinfo="none">restart</property> - </emphasis> it, <emphasis> - <property moreinfo="none">publish</property> - </emphasis> to the server, <emphasis> - <property moreinfo="none">clean</property> - </emphasis> the server.</para> - - <figure float="0"> - <title>JBoss Server Toolbar</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/quick_start/quick_start_1.png"></imagedata> - </imageobject> - </mediaobject> - </figure> - - <para>To launch the server click the green-with-white-arrow icon on the <property moreinfo="none">JBoss Server - View </property>or right click server name in this view and select <emphasis> - <property moreinfo="none">Start</property>. </emphasis> If this view is not open, select - <emphasis><property moreinfo="none">Window > Show View > Other > Server > - JBoss Server View</property>.</emphasis></para> - - <figure float="0"> - <title>Start JBoss Server</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/quick_start/quick_start_2.png"></imagedata> - </imageobject> - </mediaobject> - </figure> - - </section> - - <section id="stopping"> - <title>Stopping JBoss Server</title> - - <para>To stop the server, click the <emphasis> - <property moreinfo="none">Stop</property> - </emphasis> icon in the <property moreinfo="none">JBoss Server View</property> or right click the server name - and press <emphasis><property moreinfo="none">Stop</property>.</emphasis></para> - - <figure float="0"> - <title>Stop JBoss Server</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/quick_start/quick_start_3.png"></imagedata> - </imageobject> - </mediaobject> - </figure> - - <para>When the server is stopped you will see <emphasis> - <property moreinfo="none">Stopped</property> - </emphasis> state next to its name in the square brackets.</para> - <para>Learn more about the <property moreinfo="none">JBoss Server View</property> - <link linkend="JBossServerView">here</link>.</para> - </section> - - <section id="archiving"> - - <title>Project Archiving</title> - - <para><property moreinfo="none">JBoss Tools</property> comes with our own archives tool. The Project Archives - plugin consists primarily of a view to set up each packaging configuration <emphasis>( - <property moreinfo="none">Window > Show View > Other > JBoss Tools > Project archives</property>). - </emphasis></para> - <para>Right clicking in the <property moreinfo="none">Project archives view</property> you can create War, - EJB War, EAR or JAR archive.</para> - - <figure float="0"> - <title>Archive Creating</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/quick_start/quick_start_7.png"></imagedata> - </imageobject> - </mediaobject> - </figure> - - <para>Using the context menu on the item you can initiate a <emphasis><property moreinfo="none">full build</property></emphasis> on - archive, <emphasis><property moreinfo="none">edit</property>,</emphasis> <emphasis><property moreinfo="none">delete</property></emphasis> or - <emphasis><property moreinfo="none">publish</property></emphasis> it.</para> - - <figure float="0"> - <title>Context Menu on the Item</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/quick_start/quick_start_8.png"></imagedata> - </imageobject> - </mediaobject> - </figure> - - <para>Learn more about the <property moreinfo="none">Project Archives View</property> - <link linkend="Project_archivesView">here</link>.</para> - - </section> - <section id="deployment"> - <title>Deploying an Application to a Server</title> - - <para>There are two times to deploy your application:</para> - <itemizedlist> - <listitem> - <para>While creating it</para> - </listitem> - <listitem> - <para>After it already exists</para> - </listitem> - </itemizedlist> - - <para>When you create a new project (Seam, JSF or Struts) with the New Project or Import Project - wizards, the one of wizards steps has a <emphasis> - <property moreinfo="none">Target Runtime</property> - </emphasis> and <emphasis> - <property moreinfo="none">Target Server</property> - </emphasis> sections. You can deploy the application through the appropriate selection in - these sections.</para> - - <figure float="0"> - <title>Runtime and Server Sections in the New Project Wizard</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/quick_start/quick_start_4a.png"></imagedata> - </imageobject> - </mediaobject> - </figure> - - <figure float="0"> - <title>Runtime and Server Sections in the Import Project Wizard</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/quick_start/quick_start_4b.png"></imagedata> - </imageobject> - </mediaobject> - </figure> - - <para>You can deploy an existing application to a server by right-clicking the target defined - server in the <property moreinfo="none">JBoss Servers View</property> and then selecting <emphasis><property moreinfo="none">Add and - Remove Projects</property></emphasis> from the context menu.</para> - - <figure float="0"> - <title>Add and Remove Projects From the Context Menu.</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/quick_start/quick_start_5.png"></imagedata> - </imageobject> - </mediaobject> - </figure> - - <para>If this application is not assigned to a server, it will be in the left-hand available - projects list. Clicking on the <property moreinfo="none">Add ></property> button will add it to the right-hand - configured projects list and deploy the application to this server.</para> - - <figure float="0"> - <title>Modifying The Projects that are Configured on the Server</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/quick_start/quick_start_6.png"></imagedata> - </imageobject> - </mediaobject> - </figure> - - <para>Here, we have just performed the basic steps you should know to quick start with JBoss - server. In fact, there are more functionalities which you can make use of. Further we will - talk about them in detail.</para> - </section> - - - <section> - <title>Other relevant resources on the topic</title> - - <para>All JBoss Developer Studio/JBoss Tools documentation you can find <ulink url="http://docs.jboss.org/tools/2.1.0.GA">here</ulink>.</para> - <para>The latest documentation builds are available <ulink url="http://download.jboss.org/jbosstools/nightly-docs/">here</ulink>.</para> - - </section> - -</chapter> - - -<chapter id="runtimes_servers" xml:base="file:///home/ochikvina/WORK/for_compare/trunk/as/docs/reference/en/modules/runtimes_servers.xml" xreflabel="runtimes_servers"> - <?dbhtml filename="runtimes_servers.html"?> - <chapterinfo> - <keywordset> - <keyword>JBoss Developer Studio</keyword> - <keyword>Eclipse</keyword> - <keyword>Deploy</keyword> - <keyword>Deployment</keyword> - <keyword>JBoss</keyword> - </keywordset> - </chapterinfo> - <title>Runtimes and Servers in the JBoss AS plugin</title> - - <para>In this chapter we will discuss how to install runtimes and servers.</para> - - <para><diffmk:wrapper diffmk:change="changed">First of all it's necessary to mention that the JBoss AS plugin makes use of WTP. - This includes starting and stopping servers in run or debug mode. It also includes targeting WTP - projects, such as Dynamic Web Projects, to certain server runtimes in order to ensure that the - proper jars from a specific server are added to the project's classpath - properly.</diffmk:wrapper></para> - <para>In order to get started creating, running, and debugging J2EE applications, we should create - our <property moreinfo="none">runtime</property> and <property moreinfo="none">server</property> instances.</para> - - <section> - <title>Runtimes</title> - <para><diffmk:wrapper diffmk:change="added">In </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">JBoss Tools</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added">, the main purpose of Server Runtimes is to point to a - server installation somewhere on disk. In our case, this will be a JBoss installation, and it - can then be used for two primary purposes:</diffmk:wrapper></para> - <itemizedlist> - <listitem> - <para>it provides classpath additions to WTP projects that require them.</para> - </listitem> - <listitem> - <para>for <property moreinfo="none">JBoss server</property> at least, it provides information necessary for - the starting and stopping of the server, it tells which jars to run and which - configuration to use.</para> - </listitem> - </itemizedlist> - - <section id="InstNewRuntime"> - <title><diffmk:wrapper diffmk:change="changed">Installing a New Runtime</diffmk:wrapper></title> - <para>You can install runtimes into eclipse from the <emphasis> - <property moreinfo="none"><diffmk:wrapper diffmk:change="changed">Window > Preferences </diffmk:wrapper></property> - </emphasis> menu, and then select <emphasis> - <property moreinfo="none"><diffmk:wrapper diffmk:change="changed">Server > Runtime Environments</diffmk:wrapper></property> - </emphasis><diffmk:wrapper diffmk:change="changed"> from the categories available on the left.</diffmk:wrapper></para> - <figure float="0"> - <title>Installed Runtimes</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/runtimes_servers/runtimes_servers_1.png"></imagedata> - </imageobject> - </mediaobject> - </figure> - <para><diffmk:wrapper diffmk:change="changed">From this preference page you can see all declared runtimes and their types as well. - Here, it's possible to edit or remove existing runtimes as well as add a new - one.</diffmk:wrapper></para> - - <para>To create a JBoss runtime click <emphasis> - <property moreinfo="none">Add</property> - </emphasis><diffmk:wrapper diffmk:change="added"> button and choose a necessary type of runtime from the </diffmk:wrapper><emphasis diffmk:change="added"> - <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">JBoss Community</diffmk:wrapper></property> - </emphasis><diffmk:wrapper diffmk:change="added"> category.</diffmk:wrapper></para> - - <figure float="0"> - <title>Adding a Runtime</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/runtimes_servers/runtimes_servers_2.png"></imagedata> - </imageobject> - </mediaobject> - </figure> - - <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">Now there is a separation between .org servers (the </diffmk:wrapper><emphasis diffmk:change="added"> - <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">JBoss Community</diffmk:wrapper></property> - </emphasis><diffmk:wrapper diffmk:change="added"> category) and product server that comes with JBoss EAP in JBDS ( the </diffmk:wrapper><emphasis diffmk:change="added"> - <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">JBoss Enterprise Middleware</diffmk:wrapper></property> - </emphasis><diffmk:wrapper diffmk:change="added"> category).</diffmk:wrapper></para> - </note> - - <para>As you can see, <property moreinfo="none">JBoss Tools</property> provide its own adapters such as JBoss - 3.2, 4.0, 4.2 and 5.0 as well. The last one comes with its own new feature, that is a safer - incremental deployment, which prevents partial deployments to be picked up by the server. It - means that scanning for auto-deployment is suspended while files are being copied to the - deployment location and resumed when the copy is completed.</para> - - <note> - <title>Note:</title> - <para>Currently we recommend you to use a fully supported JBoss 4.2 server adapter.</para> - </note> - - <para>You'll also note a Deploy-Only Runtime type. This type provides no classpath - for WTP projects. It is used solely by its server type for the purpose of setting up a - deploy directory for users who don't wish to make use of starting, stopping, or - debugging their projects inside eclipse.</para> - - <figure float="0" id="add_runtime_figure"> - <title>Adding a JBoss 4.2 Runtime</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/runtimes_servers/runtimes_servers_3.png"></imagedata> - </imageobject> - </mediaobject> - </figure> - - <para><diffmk:wrapper diffmk:change="changed">The following table describes all the available options of the currant wizard - page.</diffmk:wrapper></para> - <table> - <title>Server Runtime Wizard Parameters</title> - <tgroup cols="2"> - <colspec align="left" colnum="1" colwidth="1*"></colspec> - <colspec colnum="2" colwidth="3*"></colspec> - - <thead> - <row> - <entry align="center"> - <para>Name</para> - </entry> - - <entry align="center"> - <para>Description</para> - </entry> - </row> - </thead> - - <tbody> - <row> - <entry> - <para>Name</para> - </entry> - <entry> - <para>The name of a new Runtime for a chosen server. We suggest that you - don't leave a default value. It's better to give descriptive - names that will help to distinguish one runtime from another.</para> - </entry> - </row> - - <row> - <entry> - <para>Home directory</para> - </entry> - <entry> - <para>The path to a directory where the runtime is installed.</para> - </entry> - </row> - - <row> - <entry> - <para>jRE</para> - </entry> - <entry> - <para>The proper Java Runtime Environment. Because of the open-source nature of - JBoss, a user is likely to want to modify and repackage some of the - configuration-specific jboss jars and create their own configuration. Thus, rather - than forcing you to copy his entire JBoss installation, the structure of the - wizard allows to create only a new configuration instead.</para> - </entry> - </row> - - <row> - <entry> - <para>Configuration</para> - </entry> - <entry> - <para>The list of configurations (all, default, minimal) that is updated as soon as - you browse to a valid runtime installation folder. After the runtime is created - the configuration becomes an unchanging property of that runtime. To compile - against a different configuration's jars, you will need to create a new runtime - from that configuration.</para> - </entry> - </row> - - </tbody> - </tgroup> - </table> - - <para><diffmk:wrapper diffmk:change="changed">As a result of having each runtime represent a specific configuration rather than the - server installation as a whole, it is very likely you'll create several different - runtimes to test each of your configurations. It becomes important to ensure your runtimes, - and later your servers, are given descriptive names that help you remember which is - which.</diffmk:wrapper></para> - - <para>Press <emphasis> - <property moreinfo="none">Finish</property> - </emphasis> to see your new runtime in the list.</para> - </section> - - </section> - - <section> - <title>Servers</title> - <para>WTP servers are eclipse-representations of a backing server installation. They are used to - start or stop servers, deploy to servers, or debug code that will run on the server. They keep - track of the modules (jars, wars, etc) you deploy to the server and also allow you to undeploy - those modules (see <link linkend="run_on_server_wizard"><diffmk:wrapper diffmk:change="changed">Deploying with Run On Server - Wizard</diffmk:wrapper></link> section). </para> - <para>Servers can be started or stopped with different <link linkend="com_line_arg">command-line - arguments</link><diffmk:wrapper diffmk:change="changed">. They are often backed by a runtime object representing that server's - location.</diffmk:wrapper></para> - - <section> - <title>Creating a New Server</title> - - <para>There are many ways to get to the new server wizard. One way is to use the old standard <emphasis> - <property moreinfo="none">File > New > Other... </property> - </emphasis> and then <emphasis> - <property moreinfo="none">Server</property> - </emphasis>. This should show the wizard like below.</para> - <figure float="0"> - <title>Adding a JBoss Server</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/runtimes_servers/runtimes_servers_4.png"></imagedata> - </imageobject> - </mediaobject> - </figure> - <para>A server object is that keeps track of things like command line arguments when starting - or stopping, and runtimes keep track of the location of the installation. Thus, each server - instance must be backed by an appropriate runtime. </para> - - <para><diffmk:wrapper diffmk:change="changed">From the list of already declared runtimes in the combo box below the view it's - possible to select which runtime you want your server to be backed by. If there is no - runtime that matches your needs just press the </diffmk:wrapper><emphasis> - <property moreinfo="none"><diffmk:wrapper diffmk:change="changed">Add...</diffmk:wrapper></property> - </emphasis><diffmk:wrapper diffmk:change="added"> link nearby to bring up the wizard for creating a new runtime (see the </diffmk:wrapper><link diffmk:change="added" linkend="add_runtime_figure"><diffmk:wrapper diffmk:change="added">previous section</diffmk:wrapper></link><diffmk:wrapper diffmk:change="added">). To configure the already installed - runtimes you should go to server preferences that you can easily do by pressing the </diffmk:wrapper><emphasis diffmk:change="added"> - <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Configure runtime environments...</diffmk:wrapper></property></emphasis><diffmk:wrapper diffmk:change="added"> link.</diffmk:wrapper></para> - - <para><diffmk:wrapper diffmk:change="changed">If the server you want to create doesn't have any installed runtime yet, the combo box - and the links are absent.</diffmk:wrapper></para> - - <figure float="0"> - <title>Installed Server Runtime Environments</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/runtimes_servers/runtimes_servers_6.png"></imagedata> - </imageobject> - </mediaobject> - </figure> - - <para>In this case the next page in the wizard which has the same form as in <link linkend="add_runtime_figure">the previous section</link> will ask you to create the - associated runtime.</para> - <para>Either way, after targeting your server to a runtime, the final screen in this wizard is - largely confirmational, giving you a chance to verify that you've selected the - appropriate runtime. It also allows to name the server appropriately. </para> - - <figure float="0"> - <title>Installed Server Runtime Environments</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/runtimes_servers/runtimes_servers_7.png"></imagedata> - </imageobject> - </mediaobject> - </figure> - - <para>Press <emphasis> - <property moreinfo="none">Finish</property> - </emphasis> to complete the process of the server creation.</para> - <para>Now that we've created our runtimes and servers, we can dwell on all services - and tools that JBoss Server Manager provides.</para> - </section> - - </section> - -</chapter> - - -<chapter id="perspective" role="updated" xml:base="file:///home/ochikvina/WORK/for_compare/trunk/as/docs/reference/en/modules/perspective.xml" xreflabel="perspective"> - <?dbhtml filename="perspective.html"?> - <chapterinfo> - <keywordset> - <keyword>JBoss Developer Studio</keyword> - <keyword>Eclipse</keyword> - <keyword>Deploy</keyword> - <keyword>Deployment</keyword> - <keyword>JBoss</keyword> - </keywordset> - </chapterinfo> - - <title>JBoss AS Perspective</title> - - <para>This chapter tells how to manage installed <property moreinfo="none">JBoss Server</property> via - <property moreinfo="none">JBoss AS perspective</property>.</para> - - <para>The <property moreinfo="none">JBoss AS perspective</property> is similar to the <property moreinfo="none">Java - perspective</property>, but it contains a few additional views. Two of the additional - views are standard views, specifically the <property moreinfo="none">Console view</property> and the - <property moreinfo="none">Properties view</property>. The other two views that are added are the - <property moreinfo="none">Project archives view</property> and the <property moreinfo="none">JBoss Server - View</property>.</para> - - <section id="JBossServerView" role="updated"> - <?dbhtml filename="JBossServerView.html"?> - <title>The JBoss Server View</title> - - <para>The <property moreinfo="none">JBoss Server View</property> is built on Common Navigator Framework - allowing extensions and is using label decorators what makes the UI enough compact - without loosing the vital information.</para> - - <para>Let's have a look at the <property moreinfo="none">JBoss Server View</property> and inspect - in detail all parts it consists of. </para> - <figure float="0"> - <title>The JBoss Server View</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/perspective/perspective_1.png"></imagedata> - </imageobject> - </mediaobject> - </figure> - - <section id="jbossserver_view_toolbar"> - <title>JBoss Server View Toolbar</title> - <para>In the right top corner of the <property moreinfo="none">JBoss Server View</property> there is a - special toolbar which provides a quick access to starting a server (in debug mode, - run mode, or profile mode), restarting a server, stopping a server, publishing to a - server and a possibility to clean a server.</para> - - <figure float="0"> - <title>The JBoss Server View Toolbar</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/perspective/perspective_2.png"></imagedata> - </imageobject> - </mediaobject> - </figure> - - <para>In order to debug your applications or EJB's that are deployed to the server, you - must start the server in debug mode. By starting the server in debug mode, eclipse - will allow you to set breakpoints on code in your workspace and step through the - code.</para> - - <para><emphasis> - <property moreinfo="none">Start the server in profiling mode</property> - </emphasis> button allows to enable profiling actions for your application. For more - details on how to start using TPTP profiling with <property moreinfo="none">JBoss Tools</property> - refer to <link linkend="tptp_support">TPTP Support</link> chapter.</para> - - <para><emphasis> - <property moreinfo="none">Publish to the server</property> - </emphasis> button will republish any modules where it has determined the workspace - is out of sync with the server. It will attempt to do an incremental publish if it - turns out that the module in question is capable of doing one.</para> - - - <para>Press <emphasis> - <property moreinfo="none">Clean</property> - </emphasis> if you need to clean projects published on the server, i.e. remove - invalid resources from the server.</para> - </section> - - <section id="jbossserver_view_structure"> - <title>JBoss Server View Structure</title> - <para>The <property moreinfo="none">JBoss Server View</property> displays all declared servers as well - as their current states (that is whether they are started or stopped) and statuses - in the square brackets next to a server name.</para> - - <figure float="0"> - <title>The JBoss Server View</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/perspective/perspective_1.png"></imagedata> - </imageobject> - </mediaobject> - </figure> - - <para>The following table lists possible server statuses.</para> - - <table> - <title>Server Publish Status</title> - <tgroup cols="2"> - <colspec align="left" colnum="1" colwidth="1*"></colspec> - <colspec colnum="2" colwidth="3*"></colspec> - - - <thead> - <row> - <entry align="center">Status</entry> - - <entry align="center">Description</entry> - </row> - </thead> - - <tbody> - <row> - <entry align="center"> - <para>Republish</para> - </entry> - - <entry align="center"> - <para>The status which allows you to see if changes are - awaiting</para> - </entry> - </row> - <row> - <entry align="center"> - <para>Publishing...</para> - </entry> - - <entry align="center"> - <para>The status which shows if changes are being updated</para> - </entry> - </row> - <row> - <entry align="center"> - <para>Synchronized</para> - </entry> - - <entry align="center"> - <para>The status which allows you to see if changes are - in-sync</para> - </entry> - </row> - </tbody> - </tgroup> - </table> - - <para>You can control a server behavior as well as adjust some server preferences with - the help of the context menu commands.</para> - - <figure float="0"> - <title><diffmk:wrapper diffmk:change="changed">Context Menu Commands</diffmk:wrapper></title> - <mediaobject> - <imageobject> - <imagedata fileref="images/perspective/perspective_8.png"></imagedata> - </imageobject> - </mediaobject> - </figure> - - <para>All available context menu commands are described in the following table.</para> - <table> - <title>Server Properties through the Context Menu</title> - <tgroup cols="2"> - <colspec align="left" colnum="1" colwidth="1*"></colspec> - <colspec colnum="2" colwidth="3*"></colspec> - - <thead> - <row> - <entry align="center"> - <para>Name</para> - </entry> - - <entry align="center"> - <para>Description</para> - </entry> - </row> - </thead> - - <tbody> - <row> - <entry> - <para>New Server</para> - </entry> - <entry> - <para>The option allows to define a new server</para> - </entry> - </row> - - <row> - <entry> - <para>Open</para> - </entry> - <entry> - <para>The option opens the Server editor</para> - </entry> - </row> - - <row> - <entry> - <para>Show in</para> - </entry> - <entry> - <para><diffmk:wrapper diffmk:change="changed">This option gives an easy access to the next views: Console, - Debug view, Server Log or MBean Explorer</diffmk:wrapper></para> - </entry> - </row> - - <row> - <entry> - <para>Delete</para> - </entry> - <entry> - <para>Standard option that allows to delete the chosen server</para> - </entry> - </row> - - <row> - <entry> - <para>Start</para> - </entry> - <entry> - <para>The action for stating a server in a run mode</para> - </entry> - </row> - - <row> - <entry> - <para>Debug</para> - </entry> - <entry> - <para>The action for stating a server in a debug mode</para> - </entry> - </row> - - <row> - <entry> - <para>Stop</para> - </entry> - <entry> - <para>The action for stopping a declared server</para> - </entry> - </row> - - <row> - <entry> - <para>Publish</para> - </entry> - <entry> - <para>The action for synching the publish information between the - server and workspace</para> - </entry> - </row> - - <row> - <entry> - <para>Clean</para> - </entry> - <entry> - <para>The option for complete redeploying the resources</para> - </entry> - </row> - - <row> - <entry> - <para><diffmk:wrapper diffmk:change="added">Explore</diffmk:wrapper></para> - </entry> - <entry diffmk:change="added"> - <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">This action uses the native OS file explorer to browse the - deploy destination. Note: The option is also available for - deployed resources/projects (see the figure below).</diffmk:wrapper></para> - </entry> - </row> - - <row diffmk:change="added"> - <entry diffmk:change="added"> - <para diffmk:change="added">Add and Remove Projects</para> - </entry> - <entry> - <para>The option allows to publish a new project to the server (if - its type is supported)</para> - </entry> - </row> - - <row> - <entry> - <para>Monitoring</para> - </entry> - <entry> - <para><diffmk:wrapper diffmk:change="changed">Possibility to add ports to be monitored on the current - server</diffmk:wrapper></para> - </entry> - </row> - - <row> - <entry> - <para>Properties</para> - </entry> - <entry> - <para><diffmk:wrapper diffmk:change="changed">Opens the window to adjust the current server - preferences</diffmk:wrapper></para> - </entry> - </row> - - </tbody> - </tgroup> - </table> - - <para>Under the server element in the <property moreinfo="none">JBoss Server View</property>, you can - see currently deployed to the server modules and some server extensions which - provide the additional information on the server.</para> - - <para>The context menu for any module allows you to remove it from the server, force a - full or incremental republish upon it.</para> - - <figure float="0"> - <title>Modules Action</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/perspective/perspective_11.png"></imagedata> - </imageobject> - </mediaobject> - </figure> - - <section diffmk:change="added" id="filesets"> - <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">Filesets</diffmk:wrapper></title> - - <para>The <emphasis> - <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Filesets</diffmk:wrapper></property> - </emphasis><diffmk:wrapper diffmk:change="added"> category in the </diffmk:wrapper><property moreinfo="none"><diffmk:wrapper diffmk:change="added">JBoss Server View</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added"> is intended - for files filtering.</diffmk:wrapper></para> - - <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">To add a new file filter, right-click the </diffmk:wrapper><emphasis diffmk:change="added"> - <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Filesets</diffmk:wrapper></property> - </emphasis><diffmk:wrapper diffmk:change="added"> category and select </diffmk:wrapper><emphasis diffmk:change="added"> - <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Create File Filter</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added">.</diffmk:wrapper></emphasis><diffmk:wrapper diffmk:change="added">The </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">New File - Filter wizard</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added"> should appear.</diffmk:wrapper></para> - - <figure diffmk:change="added" float="0"> - <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">Creating a New File Filter</diffmk:wrapper></title> - <mediaobject diffmk:change="added"> - <imageobject diffmk:change="added"> - <imagedata diffmk:change="added" fileref="images/perspective/filesets1.png"></imagedata> - </imageobject> - </mediaobject> - </figure> - - <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">The wizard asks you to enter the filter name and add includes and excludes - patterns. The preview box underneath gives a list of files matched to the - defined patterns.</diffmk:wrapper></para> - - <figure diffmk:change="added" float="0"> - <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">New File Filter Wizard</diffmk:wrapper></title> - <mediaobject diffmk:change="added"> - <imageobject diffmk:change="added"> - <imagedata diffmk:change="added" fileref="images/perspective/filesets2.png"></imagedata> - </imageobject> - </mediaobject> - </figure> - - <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">After the filter is created, you can observe it by expanding the </diffmk:wrapper><emphasis diffmk:change="added"> - <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Filesets</diffmk:wrapper></property> - </emphasis><diffmk:wrapper diffmk:change="added"> category in the </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">JBoss Server View</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added">.</diffmk:wrapper></para> - - <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">It's possible now to edit files directly from the </diffmk:wrapper><emphasis diffmk:change="added"> - <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Filesets</diffmk:wrapper></property> - </emphasis><diffmk:wrapper diffmk:change="changed"> category. Double clicking on a file from </diffmk:wrapper><emphasis> - <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Filesets</diffmk:wrapper></property> - </emphasis><diffmk:wrapper diffmk:change="added"> opens up the editor automatically or you can use the </diffmk:wrapper><emphasis diffmk:change="added"> - <property moreinfo="none"><diffmk:wrapper diffmk:change="changed">Edit File</diffmk:wrapper></property> - </emphasis><diffmk:wrapper diffmk:change="changed"> context menu command.</diffmk:wrapper></para> - - <figure diffmk:change="added" float="0"> - <title><diffmk:wrapper diffmk:change="changed">Direct Editing from the Filesets</diffmk:wrapper></title> - <mediaobject diffmk:change="added"> - <imageobject diffmk:change="added"> - <imagedata diffmk:change="added" fileref="images/perspective/filesets3.png"></imagedata> - </imageobject> - </mediaobject> - </figure> - - <para><diffmk:wrapper diffmk:change="added">To delete a file filter (or just a file) from the </diffmk:wrapper><emphasis diffmk:change="added"> - <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Filesets</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added">,</diffmk:wrapper></emphasis><diffmk:wrapper diffmk:change="added"> right-click a file filter (or the - unnecessary file) and select the </diffmk:wrapper><emphasis diffmk:change="added"> - <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Delete File Filter</diffmk:wrapper></property> - </emphasis> - <emphasis diffmk:change="added"><diffmk:wrapper diffmk:change="added">(</diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Delete File</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added">)</diffmk:wrapper></emphasis><diffmk:wrapper diffmk:change="added"> command.</diffmk:wrapper></para> - - <figure diffmk:change="added" float="0"> - <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">Deleting the File from the Filesets</diffmk:wrapper></title> - <mediaobject diffmk:change="added"> - <imageobject diffmk:change="added"> - <imagedata diffmk:change="added" fileref="images/perspective/filesets4.png"></imagedata> - </imageobject> - </mediaobject> - </figure> - </section> - - <section diffmk:change="added" id="xml_configuration"> - <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">XML Configuration</diffmk:wrapper></title> - <para>The <emphasis> - <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">XML Configuration</diffmk:wrapper></property> - </emphasis><diffmk:wrapper diffmk:change="added"> category allows you to quickly browse to descriptor files in your - server's deploy directory and check or change the values. Basically, </diffmk:wrapper><emphasis diffmk:change="added"> - <property moreinfo="none">XML Configuration</property> - </emphasis><diffmk:wrapper diffmk:change="added"> includes XML XPaths where a xpath is a path used to access some - specific part of an xml document. </diffmk:wrapper></para> - - <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 are assumed to be familiar with XPath. If not, we highly suggested - that you look through an appropriate manual or tutorial on the topic.</diffmk:wrapper></para> - </note> - - <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">The </diffmk:wrapper><emphasis diffmk:change="added"> - <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">XML Configuration</diffmk:wrapper></property> - </emphasis> category itself contains only a list of categories. <emphasis> - <property moreinfo="none">Ports</property> - </emphasis><diffmk:wrapper diffmk:change="changed"> are provided by default and is filled with many of the most commonly - used ports in the </diffmk:wrapper><property moreinfo="none">JBoss Server</property>.</para> - - <figure float="0"> - <title>XML Configuration</title> - <mediaobject diffmk:change="added"> - <imageobject diffmk:change="added"> - <imagedata fileref="images/perspective/perspective_14.png"></imagedata> - </imageobject> - </mediaobject> - </figure> - - - - - <para>By right-clicking on <emphasis> - <property moreinfo="none">XML Configuration</property>, </emphasis><diffmk:wrapper diffmk:change="changed"> you can create a new - category. Besides, context menu for </diffmk:wrapper><emphasis> - <property moreinfo="none">XML Configuration</property> - </emphasis><diffmk:wrapper diffmk:change="changed"> category makes possible to disable it. You can disable any category - in the bottom part of the </diffmk:wrapper><emphasis> - <property moreinfo="none">JBoss Server View</property>.</emphasis> Look for them in the <emphasis> - <property moreinfo="none">Inactive Categories</property> - </emphasis> afterwards to re-enable.</para> - - <figure float="0"> - <title>Adding New Category</title> - <mediaobject diffmk:change="added"> - <imageobject diffmk:change="added"> - <imagedata fileref="images/perspective/perspective_15.png"></imagedata> - </imageobject> - </mediaobject> - </figure> - - <para>By right-clicking on <emphasis> - <property moreinfo="none">Ports</property> - </emphasis> or any other category in <emphasis> - <property moreinfo="none">XML Configuration</property> - </emphasis>, you can create a new xpath.</para> - - <figure float="0"> - <title>Adding New XPath</title> - <mediaobject diffmk:change="added"> - <imageobject diffmk:change="added"> - <imagedata fileref="images/perspective/perspective_16.png"></imagedata> - </imageobject> - </mediaobject> - </figure> - - <para>After that, the dialog shown below will appear.</para> - - <figure float="0"> - <title>Adding New XPath</title> - <mediaobject diffmk:change="added"> - <imageobject diffmk:change="added"> - <imagedata fileref="images/perspective/perspective_17.png"></imagedata> - </imageobject> - </mediaobject> - </figure> - - <para><diffmk:wrapper diffmk:change="changed">The goal here is to get an end result where the XPath matches up with a - necessary property. With that in mind, let's look how it works. If the - property you want to reach is the value of the </diffmk:wrapper><emphasis>name</emphasis><diffmk:wrapper diffmk:change="changed"> - attribute in the element </diffmk:wrapper><emphasis><mbean></emphasis>, then your <emphasis> - <property moreinfo="none">XPath Patten</property> - </emphasis>should end with <emphasis>mbean</emphasis> and your <emphasis> - <property moreinfo="none">Attribute Name</property> - </emphasis> should be <emphasis>name</emphasis> like on the next figure.</para> - - <programlisting format="linespecific" role="XML"><![CDATA[... -<server> -... - <mbean code="org.jboss.ejb.EJBDeployer" - name="jboss.ejb:service=EJBDeployer" xmbean-dd=""> - -  - <xmbean> - <description> - The EJBDeployer responsible for ejb jar deployment</description> - ... - </xmbean> - </mbean> -</server> -]]></programlisting> - - <figure float="0"> - <title>XPath Preview</title> - <mediaobject diffmk:change="added"> - <imageobject diffmk:change="added"> - <imagedata fileref="images/perspective/perspective_18.png"></imagedata> - </imageobject> - </mediaobject> - </figure> - - <tip> - <title>Tip:</title> - <para><diffmk:wrapper diffmk:change="changed">Notice, when you type the fields autocomplete to help you locate exactly - what xpath you're looking for.</diffmk:wrapper></para> - </tip> - - <para><diffmk:wrapper diffmk:change="changed">Then, on the other hand, if your desired field is the text of an element - </diffmk:wrapper><emphasis><description></emphasis>, your <emphasis> - <property moreinfo="none">XPath Patten</property> - </emphasis> should end with <emphasis>description</emphasis> and <emphasis> - <property moreinfo="none">Attribute Name</property> - </emphasis> field should be left blank. When finished, click <emphasis> - <property moreinfo="none">Preview</property> - </emphasis> to see how many matches you have for that particular XPath.</para> - - <figure diffmk:change="added" float="0"> - <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">XPath Preview</diffmk:wrapper></title> - <mediaobject diffmk:change="added"> - <imageobject diffmk:change="added"> - <imagedata diffmk:change="added" fileref="images/perspective/perspective_19.png"></imagedata> - </imageobject> - </mediaobject> - </figure> - - </section> - </section> - - <section diffmk:change="added" id="dragndrop_to_jboss_server_view"> - <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">Drag-n-Drop to JBoss Server View</diffmk:wrapper></title> - - <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">Starting from 2.0.0.CR2 version of </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">JBoss AS Tools</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added"> the - </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">JBoss Server View</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added"> supports drag-n-drop of deployable and - runnable projects/resources.</diffmk:wrapper></para> - - <figure float="0"> - <title><diffmk:wrapper diffmk:change="changed">Dragging to the JBoss Server View</diffmk:wrapper></title> - <mediaobject> - <imageobject> - <imagedata fileref="images/perspective/dnd_toJBossServerView.png"></imagedata> - </imageobject> - </mediaobject> - </figure> - - <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">With drag-n-drop the following actions can be performed:</diffmk:wrapper></para> - - <itemizedlist diffmk:change="added"> - <listitem diffmk:change="added"> - <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">dragging a project to a server will deploy it to the server and run it by - showing the main page in a browser</diffmk:wrapper></para> - </listitem> - - <listitem diffmk:change="added"> - <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">dragging an </diffmk:wrapper><emphasis diffmk:change="added"> - <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">.xhtml</diffmk:wrapper></property> - </emphasis><diffmk:wrapper diffmk:change="added"> file from </diffmk:wrapper><emphasis diffmk:change="added"> - <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">WebContent</diffmk:wrapper></property> - </emphasis><diffmk:wrapper diffmk:change="added"> will do the same and show the corresponding page in a - browser</diffmk:wrapper></para> - </listitem> - - <listitem diffmk:change="added"> - <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">dragging a deployable resource (i.e. a datasource (</diffmk:wrapper><emphasis diffmk:change="added"> - <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">-ds.xml</diffmk:wrapper></property></emphasis><diffmk:wrapper diffmk:change="added">) file that has - been made deployable) will simply deploy that resource directly to the - server</diffmk:wrapper></para> - </listitem> - </itemizedlist> - - <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">In short, the feature does the same thing as if you used the </diffmk:wrapper><emphasis diffmk:change="added"> - <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Run On Server</diffmk:wrapper></property> - </emphasis><diffmk:wrapper diffmk:change="added"> option or </diffmk:wrapper><emphasis diffmk:change="added"> - <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Add and Remove Projects</diffmk:wrapper></property> - </emphasis><diffmk:wrapper diffmk:change="added"> option in the context menu of the server.</diffmk:wrapper></para> - </section> - - <section id="server_log"> - <title>Server Log View</title> - - <para><diffmk:wrapper diffmk:change="changed">You can monitor the current server behavior with the help of the </diffmk:wrapper><property moreinfo="none">Server - Log</property>. To open a server in the <property moreinfo="none"><diffmk:wrapper diffmk:change="changed">Server Log view</diffmk:wrapper></property><diffmk:wrapper diffmk:change="changed"> you - should right-click on the server and follow to </diffmk:wrapper><emphasis> - <property moreinfo="none">Open in > Server Log</property>.</emphasis></para> - - <para>The <emphasis> - <property moreinfo="none">Server Log</property> - </emphasis><diffmk:wrapper diffmk:change="changed"> shows relevant information to your server's startup, shutdown, - and publish processes. This allows you to keep an eye on what's going on - (such as automatic incremental deployment if you have it enabled).</diffmk:wrapper></para> - - <figure float="0"> - <title>Event Log Actions</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/perspective/perspective_12.png"></imagedata> - </imageobject> - </mediaobject> - </figure> - - <para>The <property moreinfo="none">Server Log</property><diffmk:wrapper diffmk:change="changed"> toolbar contains several icons that perform - the following actions:</diffmk:wrapper></para> - - <table> - <title>Server Log Toolbar Icons</title> - <tgroup cols="2"> - <colspec align="left" colnum="1" colwidth="1*"></colspec> - <colspec colnum="2" colwidth="3*"></colspec> - - <thead> - <row> - <entry align="center"> - <para>Name</para> - </entry> - - <entry align="center"> - <para>Description</para> - </entry> - </row> - </thead> - - <tbody> - <row> - <entry> - <para>Export Log</para> - </entry> - <entry> - <para>Possibility to export the log into a text file</para> - </entry> - </row> - - <row> - <entry> - <para>Clear Log Viewer</para> - </entry> - <entry> - <para><diffmk:wrapper diffmk:change="changed">The option clears the current server log</diffmk:wrapper></para> - </entry> - </row> - - <row> - <entry> - <para>Delete Log</para> - </entry> - <entry> - <para>Click to delete the server log</para> - </entry> - </row> - - <row> - <entry> - <para>Open Log</para> - </entry> - <entry> - <para>Click to open the server log text file</para> - </entry> - </row> - - <row> - <entry> - <para>Restore Log</para> - </entry> - <entry> - <para>Click to restore the server log</para> - </entry> - </row> - - </tbody> - </tgroup> - </table> - - </section> - - <section id="server_editor"> - <title>Server Editor</title> - <para>By double-clicking on any server, an editor window will appear allowing you to - edit parts of that server.</para> - - <figure float="0"> - <title>Preferences Page for the Chosen Server</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/perspective/perspective_4.png"></imagedata> - </imageobject> - </mediaobject> - </figure> - - <tip> - <title>Tip:</title> - <para>On the figure you can see that a username/password is available in the UI when - configuring the server. If you get an SecurityException when trying to launch - the server, it is most likely because your server is protected and hence you - need to fill the username/password fields with appropriate values.</para> - </tip> - - <para>It should be pointed out that our server adapter by default tries to automatically - detect the ports it needs for integrating with a <property moreinfo="none">JBoss Server</property>. - Sometimes it can though be relevant to override this automatic detection if you are - using some custom configuration. For this purposes the <emphasis> - <property moreinfo="none">Server Ports</property> - </emphasis> section in the <property moreinfo="none">Server editor</property> is provided where the - port settings are configurable. Click the <emphasis> - <property moreinfo="none">Configure...</property> - </emphasis> link to bring up the wizard for adjusting the settings for the - ports.</para> - - <figure float="0"> - <title>Server Ports Preferences</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/perspective/perspective_5.png"></imagedata> - </imageobject> - </mediaobject> - </figure> - - <para>Press <emphasis> - <property moreinfo="none">Edit XPath</property> - </emphasis> button for the chosen port to configure its XPath's values.</para> - - <figure float="0"> - <title>XPath Pattern for a Server Port</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/perspective/perspective_6.png"></imagedata> - </imageobject> - </mediaobject> - </figure> - - <para>The settings related to <emphasis> - <property moreinfo="none">Publishing</property> - </emphasis>, <emphasis> - <property moreinfo="none">Timeouts</property> - </emphasis> or <emphasis> - <property moreinfo="none">Server Polling</property> - </emphasis> can be also adjusted in the <property moreinfo="none">Server editor</property>.</para> - - <para id="com_line_arg"><property moreinfo="none">Server editor</property> makes it also possible to - modify the server's launch configuration. It's just after clicking <emphasis> - <property moreinfo="none">Open launch configuration</property> - </emphasis> link. In the open window there are the tabs for setting command line - arguments and other things that are relevant to launching the server.</para> - - <figure float="0"> - <title>Launch Configuration Properties</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/perspective/perspective_7.png"></imagedata> - </imageobject> - </mediaobject> - </figure> - - <para>Look up <ulink url="http://docs.jboss.org/jbossas/guides/installguide/r1/en/html/start-stop.html">here</ulink> to find parameters which can be specified for <property moreinfo="none">JBoss - Server</property>.</para> - </section> - - <section> - <title>Relevant Resources Links</title> - <para>Find more about XPath in the <ulink url="http://www.w3.org/TR/xpath20/">XPath - Documentation</ulink>.</para> - </section> - </section> - - <section id="Project_archivesView" role="updated"> - <title>Project Archives View</title> - <para>Every application, whether Plain Old Java, J2EE, or some other language altogether, - needs to be packaged in some way. In Java-related projects, many people use ANT. </para> - <note> - <title>Note:</title> - <para>Those who use ANT will appreciate how the Project Archives Ant task is now - improved: it supports variables and gives more informative error/logging messages - when something goes wrong.</para> - </note> - - <para>But <property moreinfo="none">JBoss Tools</property> come with our own Archives tool with a bit easier - and less-verbose XML and a handy user interface. The Project Archives plugin consists - primarily of a view, that is <property moreinfo="none">Project Archives view</property>, to set up each - packaging configuration.</para> - <para>So far, let's look through all functionality that the <property moreinfo="none">Project - Archives view</property> provides.</para> - - <section id="archives_overview"> - <title>Overview</title> - - <para>The packaging configuration for each project is stored in the project's root - folder, and is in a file named <emphasis> - <property moreinfo="none">.packages</property> - </emphasis>, which has a fairly simple XML structure. Modifying the file by hand is - neither required nor recommended, and using the UI is the official way of modifying - your packaging structure.</para> - - <figure float="0"> - <title>Archives View</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/perspective/perspective_21.png"></imagedata> - </imageobject> - </mediaobject> - </figure> - - <para>A project's configuration contains archives. As you can see on the image - above a project can contain more than one archive. Internal archives and filesets - can be directly inside of an archive, or in some sub-folder of that archive.</para> - - <para>In the upper right corner of the view you can see an icon which, when clicked, - will build the selected top-level archive. Additionally, you can select <emphasis> - <property moreinfo="none">Project > Build Packages</property> - </emphasis> when a project is selected in the <property moreinfo="none">Packages View</property> to - build all declared packages in that project's <emphasis> - <property moreinfo="none">.packages</property> - </emphasis> file. This will execute a full build on all declared archives.</para> - </section> - - <section id="Creating_Archive"> - <title>Creating an Archive</title> - - <para>When you open the <property moreinfo="none">Project archives view</property> for the first time, - it asks you to select the project for what you want to create an archive.</para> - - <figure float="0"> - <title>Archives View</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/perspective/perspective_21a.png"></imagedata> - </imageobject> - </mediaobject> - </figure> - - <para>When creating a new archive for selected project, you have some different options - at your disposal. You need right-click inside the view and select <emphasis> - <property moreinfo="none">New Archive</property> - </emphasis> to see your archive type options.</para> - - <figure float="0"> - <title>Create an Archive</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/perspective/perspective_22.png"></imagedata> - </imageobject> - </mediaobject> - </figure> - - <note> - <title>Note:</title> - <para>If you see only JAR from the list of available archive types, you should - verify whether AS Tools plugins/features are in place. EAR, EJB JAR and WAR - options are contributed by the AS Tools independently from webtools and the - virtual project model. Thus, without them only JAR will show up.</para> - </note> - - <para><property moreinfo="none">JAR</property> is the standard archive type, and does very little - configuration, leaving most of the work up to you. You can customize the name, add - folders, filesets, and inner jars to it.</para> - - <para>The other types, for the most part, simply start off with a default setting, - usually the jar with some specific children based on an expected structure of the - project. For example, if the project is a Dynamic Web Project, and you create a - <property moreinfo="none">WAR</property> archive, the archive will be created with a few - filesets relevant to the known structure of the project.</para> - - <para>Here is the first page of all New archive wizards. It is the same for any archive - type and the only page in the <property moreinfo="none">New Jar wizard</property>.</para> - <figure float="0"> - <title>New WAR Wizard</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/perspective/perspective_23.png"></imagedata> - </imageobject> - </mediaobject> - </figure> - - <para>The page is pretty simple. First it asks to set the name of your new archive and a - destination.</para> - - <para>The destination of an archive can be anywhere on the file system, anywhere in the - workspace, inside some other archive, or inside a folder declared inside an archive. - Select the necessary checkbox (either <emphasis> - <property moreinfo="none">workspace</property> - </emphasis> or <emphasis> - <property moreinfo="none"> file system</property> - </emphasis>) for marking the destination as related to either workspace or file - system. You can browse to workspace or filesystem destinations by clicking on their - respective buttons. To select a destination inside some other archive, you'll need - to press the <emphasis> - <property moreinfo="none">Workspace</property> - </emphasis> button. At the bottom of the list, you'll see archives that - have been declared in the workspace.</para> - - <figure float="0"> - <title>Selecting the destination in the workspace</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/perspective/perspective_23a.png"></imagedata> - </imageobject> - </mediaobject> - </figure> - - <para>Also in the wizard for creating a new archive you can choose whether an archive to - be compressed or exploded into a folder (without compression). You need just select - proper chechbox in the <emphasis> - <property moreinfo="none">Archive type</property> - </emphasis> section.</para> - <para>If a build or incremental update fails Project Archives will show an error - dialog:</para> - <figure float="0"> - <title>Selecting the destination in the workspace</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/perspective/projectarchives_error.png"></imagedata> - </imageobject> - </mediaobject> - </figure> - <para>Click in <emphasis> - <property moreinfo="none">Details</property> - </emphasis> to see detailed information about what caused the error.</para> - - <para>In the <property moreinfo="none">Package Explorer</property> you can observe the created - archive.</para> - <figure float="0"> - <title>The Archive in the Package Explorer</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/perspective/perspective_23b.png"></imagedata> - </imageobject> - </mediaobject> - </figure> - - <para>If you use the exploded type of archiving, instead of a single file archive the - result put into a folder is displayed in the <property moreinfo="none">Package - Explorer</property>.</para> - <figure float="0"> - <title>The Exploded Archive in the Package Explorer</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/perspective/perspective_23c.png"></imagedata> - </imageobject> - </mediaobject> - </figure> - - <section id="CreatingaFolder"> - <title>Creating a Folder</title> - <para>Creating a folder is much easier. You simply right-click on an archive or - folder you want your new folder to be a child under. The only piece of required - information is naming the file.</para> - </section> - <section id="CreatingaFileSet"> - <title>Creating a FileSet</title> - <para>To create a new fileset, you click on an available target location such as an - archive, a nested archive, or a folder within an archive, and select <emphasis> - <property moreinfo="none">New Fileset</property>. </emphasis></para> - <para>The <property moreinfo="none">New Fileset wizard</property> requires a destination (where the - files will go), and a root directory (or where the files are coming from). The - source can be anywhere in the workspace or from the filesystem at large.</para> - - <figure float="0"> - <title>Adding a New FileSet</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/perspective/perspective_24.png"></imagedata> - </imageobject> - </mediaobject> - </figure> - - <para>Below that, the fileset requires only an includes pattern and an excludes - pattern. As you type in either of these fields, the preview viewer should update - itself with which files are matched.</para> - - <para>You can create a Fileset with flattenning or without it. Look at the - difference on the figure below.</para> - - <figure float="0"> - <title>The FileSet with flattenning and without it</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/perspective/perspective_24a.png"></imagedata> - </imageobject> - </mediaobject> - </figure> - - </section> - </section> - - <section id="View_Actions"> - <title>Archive Actions</title> - <figure float="0"> - <title>Context Menu on the Item</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/perspective/perspective_25.png"></imagedata> - </imageobject> - </mediaobject> - </figure> - <para>The context menu on the items in the view is extendable, but there are several - that come standard.</para> - - <table> - <title>Context Menu on the Item</title> - <tgroup cols="2"> - <colspec align="left" colnum="1" colwidth="1*"></colspec> - <colspec colnum="2" colwidth="3*"></colspec> - - - <thead> - <row> - <entry align="center"> - <para>Name</para> - </entry> - - <entry align="center"> - <para>Description</para> - </entry> - </row> - </thead> - - <tbody> - - <row> - <entry> - <para>Build Archive (Full)</para> - </entry> - - <entry> - <para>The action enabled only on top-level archives, which initiates - a full build on that archive</para> - </entry> - </row> - - <row> - <entry> - <para>Edit Archive</para> - </entry> - - <entry> - <para>Standard action that brings up the wizard associated with that - particular node type and allows the details to be changed</para> - </entry> - </row> - - <row> - <entry> - <para>Delete Archive</para> - </entry> - - <entry> - <para>Deleting node is standard action with deletion not needing an - explanation</para> - </entry> - </row> - - <row> - <entry> - <para>Publish To Server</para> - </entry> - - <entry> - <para>The action means the ability to publish to a declared - server</para> - </entry> - </row> - - <row> - <entry> - <para>Edit publish settings</para> - </entry> - - <entry> - <para>Gives possibility to edit an archive publish settings</para> - </entry> - </row> - - </tbody> - </tgroup> - </table> - </section> - - <section id="PublishToServer"> - <title>Publishing to Server</title> - <para>Finally, you'll need to publish your application to a server. Here, we - show you how to do it with the help of <emphasis> - <property moreinfo="none">Archives View</property>. </emphasis></para> - - <figure float="0"> - <title>Context Menu on the Item</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/perspective/perspective_26.png"></imagedata> - </imageobject> - </mediaobject> - </figure> - <para>The dialog above appears after selecting <emphasis> - <property moreinfo="none">Publish To Server</property>. </emphasis> To simply publish once, you - just select the server(s) that you want, and finish. If you want the <emphasis> - <property moreinfo="none">Publish to Server</property> - </emphasis> action on that particular Archive to publish always to that set of - servers, then check the appropriate checkbox. And finally, to enable automatic - publishing upon build events, check the last checkbox.</para> - <para>The automatic publishing feature is nice if, for example, your package's - destination (where it is built) is a temporary folder and you want the archive - published to several servers. If you only really want your archive published to one - server, it might be easier to have the archive's destination folder be the deploy - folder of the server.</para> - </section> - <section id="rel_res_links_archiving"> - <title>Relevant Resources Links</title> - <para>Refer to <ulink url="http://ant.apache.org/manual/index.html">Ant manual</ulink> - to find more on how to build your applications with help of Ant.</para> - - <para>We also recommend you to watch the <ulink url="http://docs.jboss.org/tools/movies/demos/archiving/archiving.htm">movie</ulink> which demonstrates a powerful archiving functionality in - <property moreinfo="none">JBoss Tools</property>.</para> - - <para>At this point, you are guessed to be familiar with <property moreinfo="none">JBoss AS - perspective</property> and your next step now is to explore how to work with - different kinds of projects.</para> - </section> - - </section> - - -</chapter> - - -<chapter id="webtools" xml:base="file:///home/ochikvina/WORK/for_compare/trunk/as/docs/reference/en/modules/webtools.xml"> - <title>Projects</title> - <para>The most popular of the projects we deal with are the J2EE ones, such as Dynamic Web - Project, EJB Project, or EAR project. Web projects of <property moreinfo="none">JBoss Tools</property> are - Struts, JSF and Seam projects. All of them are called faceted projects. Thus, in this - chapter we are going to tell you about facets the main benefit of which to provide proper - structuring and packaging for any type of project.</para> - - <section> - <title>Faceted Projects Overview</title> - <para>The idea behind faceted projects is that each project can accept units of - functionality, or facets, which can be added or removed by the user. Most often, these - facets either add to the project's classpath, enable a builder, or watch the project in - some other fashion. Generally, every project concerned has at least one facet when - it's created. As an example, a Web project has a WebDoclet facet, or an EJB - Project has an EJB Module facet as prerequisites.</para> - - <para> WTP projects have undergone some criticism as being - <emphasis>over-engineered</emphasis> or too restrictive in their design. WTP projects - are set up in a tree-relationship to each other, where one project can be a child of - another. For example, an EAR project may have a Web Project child, an EJB project child, - or other types.</para> - - <para> However, the benefit of this is that the structure of your projects is then known, - and packaging it up *should* be trivial. Apparently, if your project is non-standard, or - you feel too confined by such rigid structural requirements, you can still choose to - package your project using the <link linkend="Project_archivesView">Archives - plugin</link>.</para> - </section> - - - <section> - <title>Adding Facets to a Project</title> - - <para>In this section we're going to consider the facets added by <property moreinfo="none">JBoss - Tools</property> and show how you can configure them in a project: add new ones or - modify already existing configuration of the facets.</para> - - <para>One way to configure the facets is doing it while organizing a new project. To - demonstrate this let's create a new <property moreinfo="none">Dynamic Web Project</property> by - selecting <emphasis> - <property moreinfo="none">File > New > Other...</property> - </emphasis> and then <emphasis> - <property moreinfo="none">Web > Dynamic Web Project</property>. </emphasis></para> - <figure float="0"> - <title>New Dynamic Web Project</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/webtools/webtools_1.png"></imagedata> - </imageobject> - </mediaobject> - </figure> - <para>Click <emphasis> - <property moreinfo="none">Next</property> - </emphasis> and you will see Dynamic Web Project page like on the figure below.</para> - - <para> The first page of most WTP projects allows you to target a specific runtime, - representing a server's library location. It will also provide you the ability to add - this project to an EAR project, and select a pre-selected default set of facets, called - a configuration, rather than manually select each facet you might want.</para> - <para> Selecting the runtime, again, allows the project to install the proper classpaths to - the project so it knows what code to compile against.</para> - - <figure float="0" id="dyn_web_project"> - <title>New Dynamic Web Project</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/webtools/webtools_2.png"></imagedata> - </imageobject> - </mediaobject> - </figure> - <para>Click on the <emphasis> - <property moreinfo="none">Modify</property> - </emphasis> button next to <property moreinfo="none">Configuration</property> section in order to open - the wizard which allows you to modify a chosen configuration. The wizard looks as - follows.</para> - - <figure float="0" id="project_facets"> - <title>Project Facets Wizard</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/webtools/webtools_3.png"></imagedata> - </imageobject> - </mediaobject> - </figure> - - <para>Here part of the listed facets are those which are provided by WTP. Some of them are - added by <property moreinfo="none">JBoss Tools</property>. They are:</para> - <itemizedlist> - <listitem> - <para>BIRT Charting Runtime Component</para> - </listitem> - <listitem> - <para>BIRT Reporting Runtime Component</para> - </listitem> - <listitem> - <para>JBoss ESB</para> - </listitem> - <listitem> - <para>JBoss Portlets</para> - </listitem> - <listitem> - <para>JBoss Web Services</para> - </listitem> - <listitem> - <para>Seam</para> - </listitem> - </itemizedlist> - - <para>On this wizard page you can enable or disable any facet as well as change it version. - What you should note here is that some facets or facets versions may conflict with each - other. In case of incompatibility you'll be prompted about this in the combo - box underneath.</para> - <figure float="0"> - <title>Facet Constraints</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/webtools/webtools_4.png"></imagedata> - </imageobject> - </mediaobject> - </figure> - <para>When switching on the <emphasis> - <property moreinfo="none">Runtimes</property> - </emphasis><diffmk:wrapper diffmk:change="changed"> tab on the right you'll see the current server Runtime.</diffmk:wrapper></para> - <figure float="0"> - <title>Runtimes on the Project Facets Wizard</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/webtools/webtools_5.png"></imagedata> - </imageobject> - </mediaobject> - </figure> - <para>On this tab you can also create a new Server Runtime and make it primary by pressing <emphasis> - <property moreinfo="none">Make Primary</property> - </emphasis> button after enabling it.</para> - - <para>Clicking on <emphasis> - <property moreinfo="none">OK</property> - </emphasis> will save the chosen configuration of the facets and return you to the <link linkend="dyn_web_project">Dynamic Web Project wizard</link>. Further pages in the - wizard are specific to either the project type or the facets selected.</para> - - - <para>If you need to configure the facets for the existing project, you should bring up the - context menu for selected project and click <emphasis> - <property moreinfo="none">Properties</property> - </emphasis> and then <emphasis> - <property moreinfo="none">Project Facets</property>. </emphasis> This will bring up the familiar - <link linkend="project_facets">Project Facets wizard</link>, where you can create - your own custom facets configuration.</para> - - <para></para> - - </section> - <section id="rel_resources_links"> - <title>Relevant Resources Links</title> - - <para>More on the WTP facets you can read in the <ulink url="http://help.eclipse.org/ganymede/index.jsp?topic=/org.eclipse.jst.j2ee.do...">eclipse help</ulink>.</para> - </section> -</chapter> - - -<chapter id="modules" xml:base="file:///home/ochikvina/WORK/for_compare/trunk/as/docs/reference/en/modules/modules.xml"> - <title>Deploying Modules</title> - - <para>In this chapter it will be described how to deploy modules onto the server.</para> - <para> First of all it is necessary to say that deploying to a server is mostly painless. There - are several ways to do it provided by WTP, and some additional methods provided by JBoss - Tools. These methods are described further in this chapter.</para> - - <section> - <title>Deploying on the Package Explorer</title> - - <para>On the package explorer it is possible to publish either a project to a server or just - a signal file. Let's look at how to do this.</para> - <section id="run_on_server_wizard"> - <title>Deploying with Run On Server Wizard</title> - <para> The first WTP method is to right-click on a project, such as a Dynamic Web - project, EJB project, or EAR project and then select <emphasis> - <property moreinfo="none">Run As > Run on Server</property> - </emphasis>. The resulting dialog allows you to select which supporting server the - project can be published to.</para> - <figure float="0"> - <title>Define a New Server</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/modules/modules_1.png"></imagedata> - </imageobject> - </mediaobject> - </figure> - <para>Click <emphasis> - <property moreinfo="none">Next</property> - </emphasis> button to see add or remove projects page where you can choose projects - to configure them on server.</para> - <figure float="0" id="add_rem_proj"> - <title>Add or Remove Projects</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/modules/modules_2.png"></imagedata> - </imageobject> - </mediaobject> - </figure> - <para>This page of the wizard also allows to undeploy modules from the server. For that - choose proper module(s) from the right and click <emphasis> - <property moreinfo="none"> < Remove</property> - </emphasis>. The modules will be completely undeployed after restarting your server - or republishing.</para> - <para>Generally, for the JBoss AS Server Adapters, publishing using this method will - force a default, best-guess, packaging configuration for your project. This - best-guess does not publish incrementally, but instead repackages your entire - project into a <emphasis> - <property moreinfo="none">.war</property> - </emphasis>, <emphasis> - <property moreinfo="none">.jar</property> - </emphasis>, or <emphasis> - <property moreinfo="none">.ear</property> - </emphasis> as appropriate, and then copies that file into the proper deploy - directory. For quicker smarter deployment, you will need to create archives using - the <link linkend="Project_archivesView">Project Archives view</link> and customize - packaging yourself.</para> - </section> - - <section id="single_file_deployment"> - <?dbhtml filename="DeployToServer.html"?> - <title>Deploying single files</title> - - <para>Sometimes it becomes necessary to deploy one or more files to a server. For - that in order not to do a full republish in the context menu of files a <emphasis><property moreinfo="none">Deploy To Server</property></emphasis> - option is provided that allows a single file deployment. To deploy these non-WTP files/projects - right click on the file (<emphasis> - <property moreinfo="none">-ds.xml</property></emphasis>, <emphasis> - <property moreinfo="none">.ear</property></emphasis>, <emphasis> - <property moreinfo="none">.jar</property></emphasis> etc.) and select <emphasis> - <property moreinfo="none">Deploy To Server</property> - </emphasis> and it will be automatically deployed.</para> - <figure float="0"> - <title>Deploy to Sever</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/modules/modules_6.png"></imagedata> - </imageobject> - </mediaobject> - </figure> - <para>The deployed files are listed side-by-side with other modules that are deployed to - the server.</para> - - <figure float="0"> - <title>Deployed files on the Server</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/modules/modules_7.png"></imagedata> - </imageobject> - </mediaobject> - </figure> - - </section> - - </section> - <section> - <title>Deploying with JBoss Server View</title> - <para>As it has been already mentioned <property moreinfo="none">JBoss Server View</property> contains two - parts: the top part that displays all defined servers and the bottom part which provides - categories with additional information. Thus, in this section we suggest two more ways - to deploy resources onto the server.</para> - <section> - <title>Top part of JBoss Server View</title> - <para>In the top part of the <property moreinfo="none">JBoss Servers View</property> like in the Servers - View you should right click on a server and select the <emphasis> - <property moreinfo="none">Add and Remove Projects</property> - </emphasis> menu item.</para> - <figure float="0"> - <title>Add and Remove Projects</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/modules/modules_3.png"></imagedata> - </imageobject> - </mediaobject> - </figure> - - <para>This will bring up a <link linkend="add_rem_proj">familiar dialog</link> allowing - you to either publish projects or modules to a server, or remove them from the - server. If the selected module is a project like a Dynamic Web project, EJB project, - or EAR project, it will be published as through <emphasis> - <property moreinfo="none">Run on Server</property> - </emphasis> wizard, with a best-guess full package. If, however, the selected - element is an archive from the <link linkend="Project_archivesView">Project Archives - view</link>, it will be published according to the rules of that module - type.</para> - </section> - - <section> - <title>Bottom part of JBoss Server View</title> - <para>In the bottom part of <emphasis> - <property moreinfo="none">JBoss Server View</property> - </emphasis> there is a category called <emphasis> - <property moreinfo="none">Modules</property> - </emphasis> which should display all currently-published modules on the server. - Right-clicking on the desired module and selecting <emphasis> - <property moreinfo="none">Full Publish</property> - </emphasis> will force a full rebuild of the entire module.</para> - <figure float="0"> - <title>Full Publish</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/modules/modules_4.png"></imagedata> - </imageobject> - </mediaobject> - </figure> - - <para>Here, <emphasis> - <property moreinfo="none">Incremental Publish</property> - </emphasis> is meant to enable publishing of only those parts where changes have - been made.</para> - </section> - </section> - <section> - <title>Deploying with Project Archives View</title> - <para>In the <property moreinfo="none">Project Archives View</property> you can right-click on any declared - archive and select the <emphasis> - <property moreinfo="none">Publish To Server</property> - </emphasis> element. For more on this subject, see <link linkend="PublishToServer">Publishing to Server</link> in the Project Archives View section.</para> - <figure float="0"> - <title>Publish to Server</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/modules/modules_5.png"></imagedata> - </imageobject> - </mediaobject> - </figure> - <para> The only way to ensure an <emphasis> - <property moreinfo="none">Incremental Build</property> - </emphasis>, such as changes to one <emphasis> - <property moreinfo="none">.jsp</property>, </emphasis> - <emphasis> - <property moreinfo="none">.html</property>, </emphasis> or <emphasis> - <property moreinfo="none">.class</property> - </emphasis> file, is to enable the builder for that project. This is done by either - changing the global preferences for the <property moreinfo="none">Archives View</property>, or by - enabling project-specific preferences and ensuring the builder is on.</para> - <para>The last chapter covers a variety of methods on how you can deploy needed modules onto a - server.</para> - </section> -</chapter> - - -<chapter id="tptp_support" xml:base="file:///home/ochikvina/WORK/for_compare/trunk/as/docs/reference/en/modules/tptp_support.xml"> - <title>TPTP Support</title> - <para>This chapter provides an overview on how to enable TPTP Profiling for <property moreinfo="none">JBoss - AS</property> adapters in <property moreinfo="none">JBoss Tools</property>.</para> - - <section> - <title>TPTP Profiling</title> - - <para>To get TPTP profiling work on <property moreinfo="none">JBoss Application Server</property> you should - first download <ulink url="http://www.eclipse.org/downloads/download.php?file=/tptp/4.5.0/TPTP-4.5.0...">TPTP 4.5.0 Runtime</ulink> and install it, i. e. just add the content of <emphasis> - <property moreinfo="none">plugins/features</property> - </emphasis> folders from downloaded directory to the same folders in your eclipse - installation directory.</para> - - <para>And now all profile actions should work for you. To start <property moreinfo="none">JBoss - AS</property> in profiling mode use <emphasis> - <property moreinfo="none">Start the server in profiling mode</property> - </emphasis> button or <emphasis> - <property moreinfo="none">Profile As > Profile on Server</property> - </emphasis> option in the context menu of the project.</para> - - <figure float="0"> - <title>Start the Server in Profiling mode</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/tptp_support/tptp_support_1.png"></imagedata> - </imageobject> - </mediaobject> - </figure> - - <para>To enable TPTP features in your workbench use <property moreinfo="none">Profiling and Logging - Perspective</property> that you can find in the list of proposed perspectives: <emphasis> - <property moreinfo="none">Window > Open Perspective > Other…</property> - </emphasis> - </para> - - <figure float="0"> - <title>Profiling and Logging Perspective</title> - <mediaobject> - <imageobject> - <imagedata fileref="images/tptp_support/tptp_support_2.png"></imagedata> - </imageobject> - </mediaobject> - </figure> - </section> - - <section> - <title>Relevant Resources Links</title> - <para>All additional information on TPTP(Test and Performance Tools Platform) you can find - in <ulink url="http://www.eclipse.org/tptp/home/downloads/4.5.0/documents/quicktour/quic...">eclipse documentation</ulink>.</para> - <para>In summary, this reference should help you to start with <ulink url="http://www.jboss.org/jbossas">JBoss AS</ulink> and get to know with functionality - for work with it.</para> - </section> -</chapter> - - -</book> +]><book xmlns:diffmk="http://diffmk.sf.net/ns/diff"> + + <bookinfo> + <title>JBoss Server Manager Reference Guide</title> + + <author><firstname>Anatoly</firstname><surname>Fedosik</surname></author> + <author><firstname>Olga</firstname><surname>Chikvina</surname></author> + <author><firstname>Rob</firstname><surname>Stryker</surname><email>rob.stryker(a)jboss.com</email></author> + <author><firstname>Svetlana</firstname><surname>Mukhina</surname><email>smukhina(a)exadel.com</email></author> + + <pubdate>April 2008</pubdate> + <copyright> + <year>2007</year> + <year>2009</year> + <holder>JBoss, a division of Red Hat</holder> + </copyright> + <releaseinfo> + Version: 2.0.0.GA + </releaseinfo> +<abstract> + <title></title> + <para> + <ulink url="http://download.jboss.org/jbosstools/nightly-docs/en/as/pdf/AS_Reference_...">PDF version</ulink> + </para> +</abstract> + + </bookinfo> + + + <toc></toc> + +<chapter id="quick_start" role="updated" xml:base="file:///home/ochikvina/WORK/for_compare/trunk/as/docs/reference/en/modules/quick_start.xml"> + <title>Quick Start with JBoss Server</title> + + <para>This chapter covers the basics of working with the <property moreinfo="none">JBoss Server</property>. If you + already have installed JBoss server and runtime you can quickly learn how to configure, start, + stop the server, to know deployment and archiving processes. How to install runtimes and servers + read in the <link linkend="runtimes_servers">Runtimes and Servers in the JBoss AS plugin</link> + chapter.</para> + + <para>To start working with JBoss AS, select a <property moreinfo="none">JBoss AS Perspective</property> via + <emphasis><property moreinfo="none">Window > Open Perspective > Other > JBoss + AS</property>.</emphasis></para> + + <section id="starting"> + <title>Starting JBoss Server</title> + + <para>Starting <property moreinfo="none">JBoss Server</property> is quite simple. You can control the server + behaviour with the help of a special toolbar in the <property moreinfo="none">JBoss Server View</property> + where you could <emphasis> + <property moreinfo="none">start</property> + </emphasis> it in a regular or debug mode, <emphasis> + <property moreinfo="none">stop</property> + </emphasis> it or <emphasis> + <property moreinfo="none">restart</property> + </emphasis><diffmk:wrapper diffmk:change="changed"> it and </diffmk:wrapper><emphasis> + <property moreinfo="none">publish</property> + </emphasis><diffmk:wrapper diffmk:change="added"> to the server.</diffmk:wrapper></para> + + <figure float="0"> + <title>JBoss Server Toolbar</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/quick_start/quick_start_1.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para>To launch the server click the green-with-white-arrow icon on the <property moreinfo="none">JBoss Server + View </property>or right click server name in this view and select <emphasis> + <property moreinfo="none">Start</property>. </emphasis> If this view is not open, select + <emphasis><property moreinfo="none">Window > Show View > Other > Server > + JBoss Server View</property>.</emphasis></para> + + <figure float="0"> + <title>Start JBoss Server</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/quick_start/quick_start_2.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + </section> + + <section id="stopping"> + <title>Stopping JBoss Server</title> + + <para>To stop the server, click the <emphasis> + <property moreinfo="none">Stop</property> + </emphasis> icon in the <property moreinfo="none">JBoss Server View</property> or right click the server name + and press <emphasis><property moreinfo="none">Stop</property>.</emphasis></para> + + <figure float="0"> + <title>Stop JBoss Server</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/quick_start/quick_start_3.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para>When the server is stopped you will see <emphasis> + <property moreinfo="none">Stopped</property> + </emphasis> state next to its name in the square brackets.</para> + <para>Learn more about the <property moreinfo="none">JBoss Server View</property> + <link linkend="JBossServerView">here</link>.</para> + </section> + + <section id="archiving"> + + <title>Project Archiving</title> + + <para><property moreinfo="none">JBoss Tools</property> comes with our own archives tool. The Project Archives + plugin consists primarily of a view to set up each packaging configuration <emphasis>( + <property moreinfo="none">Window > Show View > Other > JBoss Tools > Project archives</property>). + </emphasis></para> + <para>Right clicking in the <property moreinfo="none">Project archives view</property> you can create War, + EJB War, EAR or JAR archive.</para> + + <figure float="0"> + <title>Archive Creating</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/quick_start/quick_start_7.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para>Using the context menu on the item you can initiate a <emphasis><property moreinfo="none">full build</property></emphasis> on + archive, <emphasis><property moreinfo="none">edit</property>,</emphasis> <emphasis><property moreinfo="none">delete</property></emphasis> or + <emphasis><property moreinfo="none">publish</property></emphasis> it.</para> + + <figure float="0"> + <title>Context Menu on the Item</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/quick_start/quick_start_8.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para>Learn more about the <property moreinfo="none">Project Archives View</property> + <link linkend="Project_archivesView">here</link>.</para> + + </section> + <section id="deployment"> + <title>Deploying an Application to a Server</title> + + <para>There are two times to deploy your application:</para> + <itemizedlist> + <listitem> + <para>While creating it</para> + </listitem> + <listitem> + <para>After it already exists</para> + </listitem> + </itemizedlist> + + <para>When you create a new project (Seam, JSF or Struts) with the New Project or Import Project + wizards, the one of wizards steps has a <emphasis> + <property moreinfo="none">Target Runtime</property> + </emphasis> and <emphasis> + <property moreinfo="none">Target Server</property> + </emphasis> sections. You can deploy the application through the appropriate selection in + these sections.</para> + + <figure float="0"> + <title>Runtime and Server Sections in the New Project Wizard</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/quick_start/quick_start_4a.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <figure float="0"> + <title>Runtime and Server Sections in the Import Project Wizard</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/quick_start/quick_start_4b.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para>You can deploy an existing application to a server by right-clicking the target defined + server in the <property moreinfo="none">JBoss Servers View</property> and then selecting <emphasis><property moreinfo="none">Add and + Remove Projects</property></emphasis> from the context menu.</para> + + <figure float="0"> + <title>Add and Remove Projects From the Context Menu.</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/quick_start/quick_start_5.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para>If this application is not assigned to a server, it will be in the left-hand available + projects list. Clicking on the <property moreinfo="none">Add ></property> button will add it to the right-hand + configured projects list and deploy the application to this server.</para> + + <figure float="0"> + <title>Modifying The Projects that are Configured on the Server</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/quick_start/quick_start_6.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para>Here, we have just performed the basic steps you should know to quick start with JBoss + server. In fact, there are more functionalities which you can make use of. Further we will + talk about them in detail.</para> + </section> + + + <section> + <title>Other relevant resources on the topic</title> + + <para>All JBoss Developer Studio/JBoss Tools documentation you can find <ulink url="http://docs.jboss.org/tools/2.1.0.GA">here</ulink>.</para> + <para>The latest documentation builds are available <ulink url="http://download.jboss.org/jbosstools/nightly-docs/">here</ulink>.</para> + + </section> + +</chapter> + + +<chapter id="runtimes_servers" xml:base="file:///home/ochikvina/WORK/for_compare/trunk/as/docs/reference/en/modules/runtimes_servers.xml" xreflabel="runtimes_servers"> + <?dbhtml filename="runtimes_servers.html"?> + <chapterinfo> + <keywordset> + <keyword>JBoss Developer Studio</keyword> + <keyword>Eclipse</keyword> + <keyword>Deploy</keyword> + <keyword>Deployment</keyword> + <keyword>JBoss</keyword> + </keywordset> + </chapterinfo> + <title>Runtimes and Servers in the JBoss AS plugin</title> + + <para>In this chapter we will discuss how to install runtimes and servers.</para> + + <para>First of all it's necessary to mention that the JBoss AS plugin makes use of WTP. + This includes starting and stopping servers in run or debug mode. It also includes targeting WTP + projects, such as Dynamic Web Projects, to certain server runtimes in order to ensure that the + proper jars from a specific server are added to the project's classpath + properly.</para> + <para>In order to get started creating, running, and debugging J2EE applications, we should create + our <property moreinfo="none">runtime</property> and <property moreinfo="none">server</property> instances.</para> + + <section> + <title>Runtimes</title> + <para>In <property moreinfo="none">JBoss Tools</property>, the main purpose of Server Runtimes is to point to a + server installation somewhere on disk. In our case, this will be a JBoss installation, and it + can then be used for two primary purposes:</para> + <itemizedlist> + <listitem> + <para>it provides classpath additions to WTP projects that require them.</para> + </listitem> + <listitem> + <para>for <property moreinfo="none">JBoss server</property> at least, it provides information necessary for + the starting and stopping of the server, it tells which jars to run and which + configuration to use.</para> + </listitem> + </itemizedlist> + + <section id="InstNewRuntime"> + <title>Installing a New Runtime</title> + <para>You can install runtimes into eclipse from the <emphasis> + <property moreinfo="none">Window > Preferences </property> + </emphasis> menu, and then select <emphasis> + <property moreinfo="none">Server > Runtime Environments</property> + </emphasis> from the categories available on the left.</para> + <figure float="0"> + <title>Installed Runtimes</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/runtimes_servers/runtimes_servers_1.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + <para>From this preference page you can see all declared runtimes and their types as well. + Here, it's possible to edit or remove existing runtimes as well as add a new + one.</para> + + <para>To create a JBoss runtime click <emphasis> + <property moreinfo="none">Add</property> + </emphasis> button and choose a necessary type of runtime from the <emphasis> + <property moreinfo="none">JBoss Community</property> + </emphasis> category.</para> + + <figure float="0"> + <title>Adding a Runtime</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/runtimes_servers/runtimes_servers_2.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <note> + <title>Note:</title> + + <para>Now there is a separation between .org servers (the <emphasis> + <property moreinfo="none">JBoss Community</property> + </emphasis> category) and product server that comes with JBoss EAP in JBDS ( the <emphasis> + <property moreinfo="none">JBoss Enterprise Middleware</property> + </emphasis> category).</para> + </note> + + <para>As you can see, <property moreinfo="none">JBoss Tools</property> provide its own adapters such as JBoss + 3.2, 4.0, 4.2 and 5.0 as well. The last one comes with its own new feature, that is a safer + incremental deployment, which prevents partial deployments to be picked up by the server. It + means that scanning for auto-deployment is suspended while files are being copied to the + deployment location and resumed when the copy is completed.</para> + + <note> + <title>Note:</title> + <para>Currently we recommend you to use a fully supported JBoss 4.2 server adapter.</para> + </note> + + <para>You'll also note a Deploy-Only Runtime type. This type provides no classpath + for WTP projects. It is used solely by its server type for the purpose of setting up a + deploy directory for users who don't wish to make use of starting, stopping, or + debugging their projects inside eclipse.</para> + + <figure float="0" id="add_runtime_figure"> + <title>Adding a JBoss 4.2 Runtime</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/runtimes_servers/runtimes_servers_3.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para>The following table describes all the available options of the currant wizard + page.</para> + <table> + <title>Server Runtime Wizard Parameters</title> + <tgroup cols="2"> + <colspec align="left" colnum="1" colwidth="1*"></colspec> + <colspec colnum="2" colwidth="3*"></colspec> + + <thead> + <row> + <entry align="center"> + <para>Name</para> + </entry> + + <entry align="center"> + <para>Description</para> + </entry> + </row> + </thead> + + <tbody> + <row> + <entry> + <para>Name</para> + </entry> + <entry> + <para>The name of a new Runtime for a chosen server. We suggest that you + don't leave a default value. It's better to give descriptive + names that will help to distinguish one runtime from another.</para> + </entry> + </row> + + <row> + <entry> + <para>Home directory</para> + </entry> + <entry> + <para>The path to a directory where the runtime is installed.</para> + </entry> + </row> + + <row> + <entry> + <para><diffmk:wrapper diffmk:change="changed">JRE</diffmk:wrapper></para> + </entry> + <entry> + <para>The proper Java Runtime Environment. Because of the open-source nature of + JBoss, a user is likely to want to modify and repackage some of the + configuration-specific jboss jars and create their own configuration. Thus, rather + than forcing you to copy his entire JBoss installation, the structure of the + wizard allows to create only a new configuration instead.</para> + </entry> + </row> + + <row> + <entry> + <para>Configuration</para> + </entry> + <entry> + <para>The list of configurations (all, default, minimal) that is updated as soon as + you browse to a valid runtime installation folder. After the runtime is created + the configuration becomes an unchanging property of that runtime. To compile + against a different configuration's jars, you will need to create a new runtime + from that configuration.</para> + </entry> + </row> + + </tbody> + </tgroup> + </table> + + <para>As a result of having each runtime represent a specific configuration rather than the + server installation as a whole, it is very likely you'll create several different + runtimes to test each of your configurations. It becomes important to ensure your runtimes, + and later your servers, are given descriptive names that help you remember which is + which.</para> + + <para>Press <emphasis> + <property moreinfo="none">Finish</property> + </emphasis> to see your new runtime in the list.</para> + </section> + + </section> + + <section> + <title>Servers</title> + <para>WTP servers are eclipse-representations of a backing server installation. They are used to + start or stop servers, deploy to servers, or debug code that will run on the server. They keep + track of the modules (jars, wars, etc) you deploy to the server and also allow you to undeploy + those modules (see <link linkend="run_on_server_wizard">Deploying with Run On Server + Wizard</link> section). </para> + <para>Servers can be started or stopped with different <link linkend="com_line_arg">command-line + arguments</link>. They are often backed by a runtime object representing that server's + location.</para> + + <section> + <title>Creating a New Server</title> + + <para>There are many ways to get to the new server wizard. One way is to use the old standard <emphasis> + <property moreinfo="none">File > New > Other... </property> + </emphasis> and then <emphasis> + <property moreinfo="none">Server</property> + </emphasis>. This should show the wizard like below.</para> + <figure float="0"> + <title>Adding a JBoss Server</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/runtimes_servers/runtimes_servers_4.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + <para>A server object is that keeps track of things like command line arguments when starting + or stopping, and runtimes keep track of the location of the installation. Thus, each server + instance must be backed by an appropriate runtime. </para> + + <para>From the list of already declared runtimes in the combo box below the view it's + possible to select which runtime you want your server to be backed by. If there is no + runtime that matches your needs just press the <emphasis> + <property moreinfo="none">Add...</property> + </emphasis> link nearby to bring up the wizard for creating a new runtime (see the <link linkend="add_runtime_figure">previous section</link>). To configure the already installed + runtimes you should go to server preferences that you can easily do by pressing the <emphasis> + <property moreinfo="none">Configure runtime environments...</property></emphasis> link.</para> + + <para>If the server you want to create doesn't have any installed runtime yet, the combo box + and the links are absent.</para> + + <figure float="0"> + <title>Installed Server Runtime Environments</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/runtimes_servers/runtimes_servers_6.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para>In this case the next page in the wizard which has the same form as in <link linkend="add_runtime_figure">the previous section</link> will ask you to create the + associated runtime.</para> + <para>Either way, after targeting your server to a runtime, the final screen in this wizard is + largely confirmational, giving you a chance to verify that you've selected the + appropriate runtime. It also allows to name the server appropriately. </para> + + <figure float="0"> + <title>Installed Server Runtime Environments</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/runtimes_servers/runtimes_servers_7.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para>Press <emphasis> + <property moreinfo="none">Finish</property> + </emphasis> to complete the process of the server creation.</para> + <para><diffmk:wrapper diffmk:change="added">Now that we've created our runtimes and servers, we can dwell on all services + and tools that JBoss Server Manager provides.</diffmk:wrapper></para> + + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">We hope, this guide helped you to get started with the JBoss Tools server manager. Besides, for additional information you are welcome on </diffmk:wrapper><ulink diffmk:change="added" url="http://www.jboss.com/index.html?module=bb&op=viewforum&f=201"><diffmk:wrapper diffmk:change="added">JBoss forum</diffmk:wrapper></ulink><diffmk:wrapper diffmk:change="added">.</diffmk:wrapper></para> + </section> + + </section> + +</chapter> + + +<chapter id="perspective" role="updated" xml:base="file:///home/ochikvina/WORK/for_compare/trunk/as/docs/reference/en/modules/perspective.xml" xreflabel="perspective"> + <?dbhtml filename="perspective.html"?> + <chapterinfo> + <keywordset> + <keyword>JBoss Developer Studio</keyword> + <keyword>Eclipse</keyword> + <keyword>Deploy</keyword> + <keyword>Deployment</keyword> + <keyword>JBoss</keyword> + </keywordset> + </chapterinfo> + + <title>JBoss AS Perspective</title> + + <para>This chapter tells how to manage installed <property moreinfo="none">JBoss Server</property> via + <property moreinfo="none">JBoss AS perspective</property>.</para> + + <para>The <property moreinfo="none">JBoss AS perspective</property> is similar to the <property moreinfo="none">Java + perspective</property>, but it contains a few additional views. Two of the additional + views are standard views, specifically the <property moreinfo="none">Console view</property> and the + <property moreinfo="none">Properties view</property>. The other two views that are added are the + <property moreinfo="none">Project archives view</property> and the <property moreinfo="none">JBoss Server + View</property>.</para> + + <section id="JBossServerView" role="updated"> + <?dbhtml filename="JBossServerView.html"?> + <title>The JBoss Server View</title> + + <para>The <property moreinfo="none">JBoss Server View</property> is built on Common Navigator Framework + allowing extensions and is using label decorators what makes the UI enough compact + without loosing the vital information.</para> + + <para>Let's have a look at the <property moreinfo="none">JBoss Server View</property> and inspect + in detail all parts it consists of. </para> + <figure float="0"> + <title>The JBoss Server View</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/perspective/perspective_1.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <section id="jbossserver_view_toolbar"> + <title>JBoss Server View Toolbar</title> + <para>In the right top corner of the <property moreinfo="none">JBoss Server View</property><diffmk:wrapper diffmk:change="changed"> there is a + special toolbar which provides a quick access to starting a server (in the debug mode, + run mode, or profile mode), restarting a server, stopping a server and a possibility to publish to a + server.</diffmk:wrapper></para> + + <figure float="0"> + <title>The JBoss Server View Toolbar</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/perspective/perspective_2.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para>In order to debug your applications or EJB's that are deployed to the server, you + must start the server in debug mode. By starting the server in debug mode, eclipse + will allow you to set breakpoints on code in your workspace and step through the + code.</para> + + <para><emphasis> + <property moreinfo="none">Start the server in profiling mode</property> + </emphasis> button allows to enable profiling actions for your application. For more + details on how to start using TPTP profiling with <property moreinfo="none">JBoss Tools</property> + refer to <link linkend="tptp_support">TPTP Support</link> chapter.</para> + + <para><emphasis> + <property moreinfo="none">Publish to the server</property> + </emphasis> button will republish any modules where it has determined the workspace + is out of sync with the server. It will attempt to do an incremental publish if it + turns out that the module in question is capable of doing one.</para> + + </section> + + <section id="jbossserver_view_structure"> + <title>JBoss Server View Structure</title> + <para>The <property moreinfo="none">JBoss Server View</property> displays all declared servers as well + as their current states (that is whether they are started or stopped) and statuses + in the square brackets next to a server name.</para> + + <figure float="0"> + <title>The JBoss Server View</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/perspective/perspective_1.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para>The following table lists possible server statuses.</para> + + <table> + <title>Server Publish Status</title> + <tgroup cols="2"> + <colspec align="left" colnum="1" colwidth="1*"></colspec> + <colspec colnum="2" colwidth="3*"></colspec> + + + <thead> + <row> + <entry align="center">Status</entry> + + <entry align="center">Description</entry> + </row> + </thead> + + <tbody> + <row> + <entry align="center"> + <para>Republish</para> + </entry> + + <entry align="center"> + <para>The status which allows you to see if changes are + awaiting</para> + </entry> + </row> + <row> + <entry align="center"> + <para>Publishing...</para> + </entry> + + <entry align="center"> + <para>The status which shows if changes are being updated</para> + </entry> + </row> + <row> + <entry align="center"> + <para>Synchronized</para> + </entry> + + <entry align="center"> + <para>The status which allows you to see if changes are + in-sync</para> + </entry> + </row> + </tbody> + </tgroup> + </table> + + <para>You can control a server behavior as well as adjust some server preferences with + the help of the context menu commands.</para> + + <figure float="0"> + <title>Context Menu Commands</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/perspective/perspective_8.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para>All available context menu commands are described in the following table.</para> + <table> + <title>Server Properties through the Context Menu</title> + <tgroup cols="2"> + <colspec align="left" colnum="1" colwidth="1*"></colspec> + <colspec colnum="2" colwidth="3*"></colspec> + + <thead> + <row> + <entry align="center"> + <para>Name</para> + </entry> + + <entry align="center"> + <para>Description</para> + </entry> + </row> + </thead> + + <tbody> + <row> + <entry> + <para>New Server</para> + </entry> + <entry> + <para>The option allows to define a new server</para> + </entry> + </row> + + <row> + <entry> + <para>Open</para> + </entry> + <entry> + <para>The option opens the Server editor</para> + </entry> + </row> + + <row> + <entry> + <para>Show in</para> + </entry> + <entry> + <para>This option gives an easy access to the next views: Console, + Debug view, Server Log or MBean Explorer</para> + </entry> + </row> + + <row> + <entry> + <para>Delete</para> + </entry> + <entry> + <para>Standard option that allows to delete the chosen server</para> + </entry> + </row> + + <row> + <entry> + <para>Start</para> + </entry> + <entry> + <para>The action for stating a server in a run mode</para> + </entry> + </row> + + <row> + <entry> + <para>Debug</para> + </entry> + <entry> + <para>The action for stating a server in a debug mode</para> + </entry> + </row> + + <row> + <entry> + <para>Stop</para> + </entry> + <entry> + <para>The action for stopping a declared server</para> + </entry> + </row> + + <row> + <entry> + <para>Publish</para> + </entry> + <entry> + <para><diffmk:wrapper diffmk:change="added">The action for synchronizing the publish information between + the server and workspace</diffmk:wrapper></para> + </entry> + </row> + + <row> + <entry> + <para>Explore</para> + </entry> + <entry> + <para>This action uses the native OS file explorer to browse the + deploy destination. Note: The option is also available for + deployed resources/projects (see the figure below).</para> + </entry> + </row> + + <row> + <entry> + <para>Add and Remove Projects</para> + </entry> + <entry> + <para>The option allows to publish a new project to the server (if + its type is supported)</para> + </entry> + </row> + + <row> + <entry> + <para>Monitoring</para> + </entry> + <entry> + <para>Possibility to add ports to be monitored on the current + server</para> + </entry> + </row> + + <row> + <entry> + <para>Properties</para> + </entry> + <entry> + <para>Opens the window to adjust the current server + preferences</para> + </entry> + </row> + + </tbody> + </tgroup> + </table> + + <para>Under the server element in the <property moreinfo="none">JBoss Server View</property>, you can + see currently deployed to the server modules and some server extensions which + provide the additional information on the server.</para> + + <para>The context menu for any module allows you to remove it from the server, force a + full or incremental republish upon it.</para> + + <figure float="0"> + <title>Modules Action</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/perspective/perspective_11.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <section id="filesets"> + <title>Filesets</title> + + <para>The <emphasis> + <property moreinfo="none">Filesets</property> + </emphasis> category in the <property moreinfo="none">JBoss Server View</property> is intended + for files filtering.</para> + + <para>To add a new file filter, right-click the <emphasis> + <property moreinfo="none">Filesets</property> + </emphasis> category and select <emphasis> + <property moreinfo="none">Create File Filter</property>.</emphasis>The <property moreinfo="none">New File + Filter wizard</property> should appear.</para> + + <figure float="0"> + <title>Creating a New File Filter</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/perspective/filesets1.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para>The wizard asks you to enter the filter name and add includes and excludes + patterns. The preview box underneath gives a list of files matched to the + defined patterns.</para> + + <figure float="0"> + <title>New File Filter Wizard</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/perspective/filesets2.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para>After the filter is created, you can observe it by expanding the <emphasis> + <property moreinfo="none">Filesets</property> + </emphasis> category in the <property moreinfo="none">JBoss Server View</property>.</para> + + <para>It's possible now to edit files directly from the <emphasis> + <property moreinfo="none">Filesets</property> + </emphasis> category. Double clicking on a file from <emphasis> + <property moreinfo="none">Filesets</property> + </emphasis> opens up the editor automatically or you can use the <emphasis> + <property moreinfo="none">Edit File</property> + </emphasis> context menu command.</para> + + <figure float="0"> + <title>Direct Editing from the Filesets</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/perspective/filesets3.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para>To delete a file filter (or just a file) from the <emphasis> + <property moreinfo="none">Filesets</property>,</emphasis> right-click a file filter (or the + unnecessary file) and select the <emphasis> + <property moreinfo="none">Delete File Filter</property> + </emphasis> + <emphasis>(<property moreinfo="none">Delete File</property>)</emphasis> command.</para> + + <figure float="0"> + <title>Deleting the File from the Filesets</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/perspective/filesets4.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + </section> + + <section id="xml_configuration"> + <title>XML Configuration</title> + <para>The <emphasis> + <property moreinfo="none">XML Configuration</property> + </emphasis> category allows you to quickly browse to descriptor files in your + server's deploy directory and check or change the values. Basically, <emphasis> + <property moreinfo="none">XML Configuration</property> + </emphasis><diffmk:wrapper diffmk:change="changed"> includes XML XPaths where an xpath is a path used to access some + specific part of an xml document. </diffmk:wrapper></para> + + <note> + <title>Note:</title> + <para>You are assumed to be familiar with XPath. If not, we highly suggested + that you look through an appropriate manual or tutorial on the topic.</para> + </note> + + <para>The <emphasis> + <property moreinfo="none">XML Configuration</property> + </emphasis> category itself contains only a list of categories. <emphasis> + <property moreinfo="none">Ports</property> + </emphasis> are provided by default and is filled with many of the most commonly + used ports in the <property moreinfo="none">JBoss Server</property>.</para> + + <figure float="0"> + <title>XML Configuration</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/perspective/perspective_14.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + +  + + <para>By right-clicking on <emphasis> + <property moreinfo="none">XML Configuration</property>, </emphasis> you can create a new + category. Besides, context menu for <emphasis> + <property moreinfo="none">XML Configuration</property> + </emphasis> category makes possible to disable it. You can disable any category + in the bottom part of the <emphasis> + <property moreinfo="none">JBoss Server View</property>.</emphasis> Look for them in the <emphasis> + <property moreinfo="none">Inactive Categories</property> + </emphasis> afterwards to re-enable.</para> + + <figure float="0"> + <title>Adding New Category</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/perspective/perspective_15.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para>By right-clicking on <emphasis> + <property moreinfo="none">Ports</property> + </emphasis> or any other category in <emphasis> + <property moreinfo="none">XML Configuration</property> + </emphasis>, you can create a new xpath.</para> + + <figure float="0"> + <title>Adding New XPath</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/perspective/perspective_16.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para>After that, the dialog shown below will appear.</para> + + <figure float="0"> + <title>Adding New XPath</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/perspective/perspective_17.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para>The goal here is to get an end result where the XPath matches up with a + necessary property. With that in mind, let's look how it works. If the + property you want to reach is the value of the <emphasis>name</emphasis> + attribute in the element <code diffmk:change="added"><mbean></code>, then your <emphasis> + <property moreinfo="none">XPath Patten</property> + </emphasis>should end with <emphasis>mbean</emphasis> and your <emphasis> + <property moreinfo="none">Attribute Name</property> + </emphasis> should be <emphasis>name</emphasis> like on the next figure.</para> + + <programlisting format="linespecific" role="XML"><![CDATA[... +<server> +... + <mbean code="org.jboss.ejb.EJBDeployer" + name="jboss.ejb:service=EJBDeployer" xmbean-dd=""> + +  + <xmbean> + <description> + The EJBDeployer responsible for ejb jar deployment</description> + ... + </xmbean> + </mbean> +</server> +]]></programlisting> + + <figure float="0"> + <title>XPath Preview</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/perspective/perspective_18.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <tip> + <title>Tip:</title> + <para>Notice, when you type the fields autocomplete to help you locate exactly + what xpath you're looking for.</para> + </tip> + + <para>Then, on the other hand, if your desired field is the text of an element + <code diffmk:change="added"><description></code>, your <emphasis> + <property moreinfo="none">XPath Patten</property> + </emphasis> should end with <emphasis>description</emphasis> and <emphasis> + <property moreinfo="none">Attribute Name</property> + </emphasis> field should be left blank. When finished, click <emphasis> + <property moreinfo="none">Preview</property> + </emphasis> to see how many matches you have for that particular XPath.</para> + + <figure float="0"> + <title>XPath Preview</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/perspective/perspective_19.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + </section> + </section> + + <section id="dragndrop_to_jboss_server_view"> + <title>Drag-n-Drop to JBoss Server View</title> + + <para>Starting from 2.0.0.CR2 version of <property moreinfo="none">JBoss AS Tools</property> the + <property moreinfo="none">JBoss Server View</property><diffmk:wrapper diffmk:change="changed"> supports drag-n-drop of deployable and + runnable projects/resources.</diffmk:wrapper></para> + + <figure float="0"> + <title>Dragging to the JBoss Server View</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/perspective/dnd_toJBossServerView.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para>With drag-n-drop the following actions can be performed:</para> + + <itemizedlist> + <listitem> + <para>dragging a project to a server will deploy it to the server and run it by + showing the main page in a browser</para> + </listitem> + + <listitem> + <para>dragging an <emphasis> + <property moreinfo="none">.xhtml</property> + </emphasis> file from <emphasis> + <property moreinfo="none">WebContent</property> + </emphasis> will do the same and show the corresponding page in a + browser</para> + </listitem> + + <listitem> + <para>dragging a deployable resource (i.e. a datasource (<emphasis> + <property moreinfo="none">-ds.xml</property> + </emphasis><diffmk:wrapper diffmk:change="changed">) file that has been made deployable) will simply deploy that + resource directly to the server</diffmk:wrapper></para> + </listitem> + </itemizedlist> + + <para>In short, the feature does the same thing as if you used the <emphasis> + <property moreinfo="none">Run On Server</property> + </emphasis> option or <emphasis> + <property moreinfo="none">Add and Remove Projects</property> + </emphasis> option in the context menu of the server.</para> + </section> + + <section id="server_log"> + <title>Server Log View</title> + + <para>You can monitor the current server behavior with the help of the <property moreinfo="none">Server + Log</property>. To open a server in the <property moreinfo="none">Server Log view</property> you + should right-click on the server and follow to <emphasis> + <property moreinfo="none">Open in > Server Log</property>.</emphasis></para> + + <para>The <emphasis> + <property moreinfo="none">Server Log</property> + </emphasis> shows relevant information to your server's startup, shutdown, + and publish processes. This allows you to keep an eye on what's going on + (such as automatic incremental deployment if you have it enabled).</para> + + <figure float="0"> + <title>Event Log Actions</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/perspective/perspective_12.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para>The <property moreinfo="none">Server Log</property> toolbar contains several icons that perform + the following actions:</para> + + <table> + <title>Server Log Toolbar Icons</title> + <tgroup cols="2"> + <colspec align="left" colnum="1" colwidth="1*"></colspec> + <colspec colnum="2" colwidth="3*"></colspec> + + <thead> + <row> + <entry align="center"> + <para>Name</para> + </entry> + + <entry align="center"> + <para>Description</para> + </entry> + </row> + </thead> + + <tbody> + <row> + <entry> + <para>Export Log</para> + </entry> + <entry> + <para>Possibility to export the log into a text file</para> + </entry> + </row> + + <row> + <entry> + <para>Clear Log Viewer</para> + </entry> + <entry> + <para>The option clears the current server log</para> + </entry> + </row> + + <row> + <entry> + <para>Delete Log</para> + </entry> + <entry> + <para>Click to delete the server log</para> + </entry> + </row> + + <row> + <entry> + <para>Open Log</para> + </entry> + <entry> + <para>Click to open the server log text file</para> + </entry> + </row> + + <row> + <entry> + <para>Restore Log</para> + </entry> + <entry> + <para>Click to restore the server log</para> + </entry> + </row> + + </tbody> + </tgroup> + </table> + + </section> + + <section id="server_editor"> + <title>Server Editor</title> + <para>By double-clicking on any server, an editor window will appear allowing you to + edit parts of that server.</para> + + <figure float="0"> + <title>Preferences Page for the Chosen Server</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/perspective/perspective_4.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <tip> + <title>Tip:</title> + <para><diffmk:wrapper diffmk:change="changed">On the figure you can see that a username/password is available in the UI when + configuring the server. If you get a SecurityException when trying to launch the + server, it is most likely because your server is protected and hence you need to + fill the username/password fields with appropriate values.</diffmk:wrapper></para> + </tip> + + <para>It should be pointed out that our server adapter by default tries to automatically + detect the ports it needs for integrating with a <property moreinfo="none">JBoss Server</property>. + Sometimes it can though be relevant to override this automatic detection if you are + using some custom configuration. For this purposes the <emphasis> + <property moreinfo="none">Server Ports</property> + </emphasis> section in the <property moreinfo="none">Server editor</property> is provided where the + port settings are configurable. Click the <emphasis> + <property moreinfo="none">Configure...</property> + </emphasis> link to bring up the wizard for adjusting the settings for the + ports.</para> + + <figure float="0"> + <title>Server Ports Preferences</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/perspective/perspective_5.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para>Press <emphasis> + <property moreinfo="none">Edit XPath</property> + </emphasis> button for the chosen port to configure its XPath's values.</para> + + <figure float="0"> + <title>XPath Pattern for a Server Port</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/perspective/perspective_6.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para>The settings related to <emphasis> + <property moreinfo="none">Publishing</property> + </emphasis>, <emphasis> + <property moreinfo="none">Timeouts</property> + </emphasis> or <emphasis> + <property moreinfo="none">Server Polling</property> + </emphasis> can be also adjusted in the <property moreinfo="none">Server editor</property>.</para> + + <para id="com_line_arg"><property moreinfo="none">Server editor</property> makes it also possible to + modify the server's launch configuration. It's just after clicking <emphasis> + <property moreinfo="none">Open launch configuration</property> + </emphasis><diffmk:wrapper diffmk:change="changed"> link. In the open window there are the tabs for setting command line + arguments, classpaths and other things that are relevant to launching the + server.</diffmk:wrapper></para> + + <figure float="0"> + <title>Launch Configuration Properties</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/perspective/perspective_7.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para>Look up <ulink url="http://docs.jboss.org/jbossas/guides/installguide/r1/en/html/start-stop.html">here</ulink> to find parameters which can be specified for <property moreinfo="none">JBoss + Server</property>.</para> + + <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">Please note, that the Launch Configurations for JBoss Servers are enough + strict in enforcing the configured values in the server in order to avoid + inconsistencies between server's and their configured runtime.</diffmk:wrapper></para> + + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">For example, if you change the launch configuration program arguments to + </diffmk:wrapper><emphasis diffmk:change="added"><diffmk:wrapper diffmk:change="added">"-c myConfig"</diffmk:wrapper></emphasis><diffmk:wrapper diffmk:change="added"> but do not change the + targeted runtime configuration, then your program arguments will be ignored. The + server runtime "wins" so to speak. This ensures consistency + and if you change the location of the runtime, your launch configurations will + automatically pick that up.</diffmk:wrapper></para> + + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">Values are not controlled by the server and its runtime setup will be passed + on unaltered.</diffmk:wrapper></para> + </note> + + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">Until 3.0.0.GA release of </diffmk:wrapper><property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">JBoss Tools</diffmk:wrapper></property><diffmk:wrapper diffmk:change="added">, the servers classpath was readonly, but that caused + problems for users wanting to add their own jars in the startup classpath. That is + relevant if you need to patch the server, add a custom charset or other tweaks that + require early access to the classpath.</diffmk:wrapper></para> + + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">Now all servers have a custom 'server runtime classpath + container', which is there by default and point to the default jars in + JBoss. You can now adjust the classpath. Then just make sure this container is there + if you want the classpath to be picked up.</diffmk:wrapper></para> + + <figure diffmk:change="added" float="0"> + <title diffmk:change="added"><diffmk:wrapper diffmk:change="added">Server Classpaths</diffmk:wrapper></title> + <mediaobject diffmk:change="added"> + <imageobject diffmk:change="added"> + <imagedata diffmk:change="added" fileref="images/perspective/server_classpaths.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para diffmk:change="added"><diffmk:wrapper diffmk:change="added">If for some reason you have a launch configuration without this container, </diffmk:wrapper><emphasis diffmk:change="added"> + <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Restore + Default Entries</diffmk:wrapper></property></emphasis><diffmk:wrapper diffmk:change="added"> should add it properly. Also, </diffmk:wrapper><emphasis diffmk:change="added"> + <property diffmk:change="added" moreinfo="none"><diffmk:wrapper diffmk:change="added">Restore + Default Entries</diffmk:wrapper></property></emphasis><diffmk:wrapper diffmk:change="added"> will also remove any + extra entries you added yourself.</diffmk:wrapper></para> + </section> + + <section> + <title>Relevant Resources Links</title> + <para>Find more about XPath in the <ulink url="http://www.w3.org/TR/xpath20/">XPath + Documentation</ulink>.</para> + </section> + </section> + + <section id="Project_archivesView" role="updated"> + <title>Project Archives View</title> + <para>Every application, whether Plain Old Java, J2EE, or some other language altogether, + needs to be packaged in some way. In Java-related projects, many people use ANT. </para> + <note> + <title>Note:</title> + <para>Those who use ANT will appreciate how the Project Archives Ant task is now + improved: it supports variables and gives more informative error/logging messages + when something goes wrong.</para> + </note> + + <para>But <property moreinfo="none">JBoss Tools</property> come with our own Archives tool with a bit easier + and less-verbose XML and a handy user interface. The Project Archives plugin consists + primarily of a view, that is <property moreinfo="none">Project Archives view</property>, to set up each + packaging configuration.</para> + <para>So far, let's look through all functionality that the <property moreinfo="none">Project + Archives view</property> provides.</para> + + <section id="archives_overview"> + <title>Overview</title> + + <para>The packaging configuration for each project is stored in the project's root + folder, and is in a file named <emphasis> + <property moreinfo="none">.packages</property> + </emphasis>, which has a fairly simple XML structure. Modifying the file by hand is + neither required nor recommended, and using the UI is the official way of modifying + your packaging structure.</para> + + <figure float="0"> + <title>Archives View</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/perspective/perspective_21.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para>A project's configuration contains archives. As you can see on the image + above a project can contain more than one archive. Internal archives and filesets + can be directly inside of an archive, or in some sub-folder of that archive.</para> + + <para>In the upper right corner of the view you can see an icon which, when clicked, + will build the selected top-level archive. Additionally, you can select <emphasis> + <property moreinfo="none">Project > Build Packages</property> + </emphasis> when a project is selected in the <property moreinfo="none">Packages View</property> to + build all declared packages in that project's <emphasis> + <property moreinfo="none">.packages</property> + </emphasis> file. This will execute a full build on all declared archives.</para> + </section> + + <section id="Creating_Archive"> + <title>Creating an Archive</title> + + <para>When you open the <property moreinfo="none">Project archives view</property> for the first time, + it asks you to select the project for what you want to create an archive.</para> + + <figure float="0"> + <title>Archives View</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/perspective/perspective_21a.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para>When creating a new archive for selected project, you have some different options + at your disposal. You need right-click inside the view and select <emphasis> + <property moreinfo="none">New Archive</property> + </emphasis> to see your archive type options.</para> + + <figure float="0"> + <title>Create an Archive</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/perspective/perspective_22.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <note> + <title>Note:</title> + <para>If you see only JAR from the list of available archive types, you should + verify whether AS Tools plugins/features are in place. EAR, EJB JAR and WAR + options are contributed by the AS Tools independently from webtools and the + virtual project model. Thus, without them only JAR will show up.</para> + </note> + + <para><property moreinfo="none">JAR</property> is the standard archive type, and does very little + configuration, leaving most of the work up to you. You can customize the name, add + folders, filesets, and inner jars to it.</para> + + <para>The other types, for the most part, simply start off with a default setting, + usually the jar with some specific children based on an expected structure of the + project. For example, if the project is a Dynamic Web Project, and you create a + <property moreinfo="none">WAR</property> archive, the archive will be created with a few + filesets relevant to the known structure of the project.</para> + + <para>Here is the first page of all New archive wizards. It is the same for any archive + type and the only page in the <property moreinfo="none">New Jar wizard</property>.</para> + <figure float="0"> + <title>New WAR Wizard</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/perspective/perspective_23.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para>The page is pretty simple. First it asks to set the name of your new archive and a + destination.</para> + + <para>The destination of an archive can be anywhere on the file system, anywhere in the + workspace, inside some other archive, or inside a folder declared inside an archive. + Select the necessary checkbox (either <emphasis> + <property moreinfo="none">workspace</property> + </emphasis> or <emphasis> + <property moreinfo="none"> file system</property> + </emphasis>) for marking the destination as related to either workspace or file + system. You can browse to workspace or filesystem destinations by clicking on their + respective buttons. To select a destination inside some other archive, you'll need + to press the <emphasis> + <property moreinfo="none">Workspace</property> + </emphasis> button. At the bottom of the list, you'll see archives that + have been declared in the workspace.</para> + + <figure float="0"> + <title>Selecting the destination in the workspace</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/perspective/perspective_23a.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para>Also in the wizard for creating a new archive you can choose whether an archive to + be compressed or exploded into a folder (without compression). You need just select + proper chechbox in the <emphasis> + <property moreinfo="none">Archive type</property> + </emphasis> section.</para> + <para>If a build or incremental update fails Project Archives will show an error + dialog:</para> + <figure float="0"> + <title>Selecting the destination in the workspace</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/perspective/projectarchives_error.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + <para>Click in <emphasis> + <property moreinfo="none">Details</property> + </emphasis> to see detailed information about what caused the error.</para> + + <para>In the <property moreinfo="none">Package Explorer</property> you can observe the created + archive.</para> + <figure float="0"> + <title>The Archive in the Package Explorer</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/perspective/perspective_23b.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para>If you use the exploded type of archiving, instead of a single file archive the + result put into a folder is displayed in the <property moreinfo="none">Package + Explorer</property>.</para> + <figure float="0"> + <title>The Exploded Archive in the Package Explorer</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/perspective/perspective_23c.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <section id="CreatingaFolder"> + <title>Creating a Folder</title> + <para>Creating a folder is much easier. You simply right-click on an archive or + folder you want your new folder to be a child under. The only piece of required + information is naming the file.</para> + </section> + <section id="CreatingaFileSet"> + <title>Creating a FileSet</title> + <para>To create a new fileset, you click on an available target location such as an + archive, a nested archive, or a folder within an archive, and select <emphasis> + <property moreinfo="none">New Fileset</property>. </emphasis></para> + <para>The <property moreinfo="none">New Fileset wizard</property> requires a destination (where the + files will go), and a root directory (or where the files are coming from). The + source can be anywhere in the workspace or from the filesystem at large.</para> + + <figure float="0"> + <title>Adding a New FileSet</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/perspective/perspective_24.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para>Below that, the fileset requires only an includes pattern and an excludes + pattern. As you type in either of these fields, the preview viewer should update + itself with which files are matched.</para> + + <para><diffmk:wrapper diffmk:change="changed">You can create a Fileset with flattening or without it. Look at the difference + on the figure below.</diffmk:wrapper></para> + + <figure float="0"> + <title><diffmk:wrapper diffmk:change="changed">The FileSet with flattening and without it</diffmk:wrapper></title> + <mediaobject> + <imageobject> + <imagedata fileref="images/perspective/perspective_24a.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + </section> + </section> + + <section id="View_Actions"> + <title>Archive Actions</title> + <figure float="0"> + <title>Context Menu on the Item</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/perspective/perspective_25.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + <para>The context menu on the items in the view is extendable, but there are several + that come standard.</para> + + <table> + <title>Context Menu on the Item</title> + <tgroup cols="2"> + <colspec align="left" colnum="1" colwidth="1*"></colspec> + <colspec colnum="2" colwidth="3*"></colspec> + + + <thead> + <row> + <entry align="center"> + <para>Name</para> + </entry> + + <entry align="center"> + <para>Description</para> + </entry> + </row> + </thead> + + <tbody> + + <row> + <entry> + <para>Build Archive (Full)</para> + </entry> + + <entry> + <para>The action enabled only on top-level archives, which initiates + a full build on that archive</para> + </entry> + </row> + + <row> + <entry> + <para>Edit Archive</para> + </entry> + + <entry> + <para>Standard action that brings up the wizard associated with that + particular node type and allows the details to be changed</para> + </entry> + </row> + + <row> + <entry> + <para>Delete Archive</para> + </entry> + + <entry> + <para>Deleting node is standard action with deletion not needing an + explanation</para> + </entry> + </row> + + <row> + <entry> + <para>Publish To Server</para> + </entry> + + <entry> + <para>The action means the ability to publish to a declared + server</para> + </entry> + </row> + + <row> + <entry> + <para>Edit publish settings</para> + </entry> + + <entry> + <para>Gives possibility to edit an archive publish settings</para> + </entry> + </row> + + </tbody> + </tgroup> + </table> + </section> + + <section id="PublishToServer"> + <title>Publishing to Server</title> + <para>Finally, you'll need to publish your application to a server. Here, we + show you how to do it with the help of <emphasis> + <property moreinfo="none">Archives View</property>. </emphasis></para> + + <figure float="0"> + <title>Context Menu on the Item</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/perspective/perspective_26.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + <para>The dialog above appears after selecting <emphasis> + <property moreinfo="none">Publish To Server</property>. </emphasis> To simply publish once, you + just select the server(s) that you want, and finish. If you want the <emphasis> + <property moreinfo="none">Publish to Server</property> + </emphasis> action on that particular Archive to publish always to that set of + servers, then check the appropriate checkbox. And finally, to enable automatic + publishing upon build events, check the last checkbox.</para> + <para>The automatic publishing feature is nice if, for example, your package's + destination (where it is built) is a temporary folder and you want the archive + published to several servers. If you only really want your archive published to one + server, it might be easier to have the archive's destination folder be the deploy + folder of the server.</para> + </section> + <section id="rel_res_links_archiving"> + <title>Relevant Resources Links</title> + <para>Refer to <ulink url="http://ant.apache.org/manual/index.html">Ant manual</ulink> + to find more on how to build your applications with help of Ant.</para> + + <para>We also recommend you to watch the <ulink url="http://docs.jboss.org/tools/movies/demos/archiving/archiving.htm">movie</ulink> which demonstrates a powerful archiving functionality in + <property moreinfo="none">JBoss Tools</property>.</para> + + <para>At this point, you are guessed to be familiar with <property moreinfo="none">JBoss AS + perspective</property> and your next step now is to explore how to work with + different kinds of projects.</para> + </section> + + </section> + + +</chapter> + + +<chapter id="webtools" xml:base="file:///home/ochikvina/WORK/for_compare/trunk/as/docs/reference/en/modules/webtools.xml"> + <title>Projects</title> + <para>The most popular of the projects we deal with are the J2EE ones, such as Dynamic Web + Project, EJB Project, or EAR project. Web projects of <property moreinfo="none">JBoss Tools</property> are + Struts, JSF and Seam projects. All of them are called faceted projects. Thus, in this + chapter we are going to tell you about facets the main benefit of which to provide proper + structuring and packaging for any type of project.</para> + + <section> + <title>Faceted Projects Overview</title> + <para>The idea behind faceted projects is that each project can accept units of + functionality, or facets, which can be added or removed by the user. Most often, these + facets either add to the project's classpath, enable a builder, or watch the project in + some other fashion. Generally, every project concerned has at least one facet when + it's created. As an example, a Web project has a WebDoclet facet, or an EJB + Project has an EJB Module facet as prerequisites.</para> + + <para> WTP projects have undergone some criticism as being + <emphasis>over-engineered</emphasis> or too restrictive in their design. WTP projects + are set up in a tree-relationship to each other, where one project can be a child of + another. For example, an EAR project may have a Web Project child, an EJB project child, + or other types.</para> + + <para> However, the benefit of this is that the structure of your projects is then known, + and packaging it up *should* be trivial. Apparently, if your project is non-standard, or + you feel too confined by such rigid structural requirements, you can still choose to + package your project using the <link linkend="Project_archivesView">Archives + plugin</link>.</para> + </section> + + + <section> + <title>Adding Facets to a Project</title> + + <para>In this section we're going to consider the facets added by <property moreinfo="none">JBoss + Tools</property> and show how you can configure them in a project: add new ones or + modify already existing configuration of the facets.</para> + + <para>One way to configure the facets is doing it while organizing a new project. To + demonstrate this let's create a new <property moreinfo="none">Dynamic Web Project</property> by + selecting <emphasis> + <property moreinfo="none">File > New > Other...</property> + </emphasis> and then <emphasis> + <property moreinfo="none">Web > Dynamic Web Project</property>. </emphasis></para> + <figure float="0"> + <title>New Dynamic Web Project</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/webtools/webtools_1.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + <para>Click <emphasis> + <property moreinfo="none">Next</property> + </emphasis> and you will see Dynamic Web Project page like on the figure below.</para> + + <para><diffmk:wrapper diffmk:change="changed"> The first page of most WTP projects allows you to target a specific runtime, + representing a server's library location. It will also provide you the ability to add + this project to an EAR project, and select a preselected default set of facets, called + a configuration, rather than manually select each facet you might want.</diffmk:wrapper></para> + <para> Selecting the runtime, again, allows the project to install the proper classpaths to + the project so it knows what code to compile against.</para> + + <figure float="0" id="dyn_web_project"> + <title>New Dynamic Web Project</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/webtools/webtools_2.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + <para>Click on the <emphasis> + <property moreinfo="none">Modify</property> + </emphasis> button next to <property moreinfo="none">Configuration</property> section in order to open + the wizard which allows you to modify a chosen configuration. The wizard looks as + follows.</para> + + <figure float="0" id="project_facets"> + <title>Project Facets Wizard</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/webtools/webtools_3.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para>Here part of the listed facets are those which are provided by WTP. Some of them are + added by <property moreinfo="none">JBoss Tools</property>. They are:</para> + <itemizedlist> + <listitem> + <para>BIRT Charting Runtime Component</para> + </listitem> + <listitem> + <para>BIRT Reporting Runtime Component</para> + </listitem> + <listitem> + <para>JBoss ESB</para> + </listitem> + <listitem> + <para>JBoss Portlets</para> + </listitem> + <listitem> + <para>JBoss Web Services</para> + </listitem> + <listitem> + <para>Seam</para> + </listitem> + </itemizedlist> + + <para>On this wizard page you can enable or disable any facet as well as change it version. + What you should note here is that some facets or facets versions may conflict with each + other. In case of incompatibility you'll be prompted about this in the combo + box underneath.</para> + <figure float="0"> + <title>Facet Constraints</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/webtools/webtools_4.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + <para>When switching on the <emphasis> + <property moreinfo="none">Runtimes</property> + </emphasis> tab on the right you'll see the current server Runtime.</para> + <figure float="0"> + <title>Runtimes on the Project Facets Wizard</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/webtools/webtools_5.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + <para>On this tab you can also create a new Server Runtime and make it primary by pressing <emphasis> + <property moreinfo="none">Make Primary</property> + </emphasis> button after enabling it.</para> + + <para>Clicking on <emphasis> + <property moreinfo="none">OK</property> + </emphasis> will save the chosen configuration of the facets and return you to the <link linkend="dyn_web_project">Dynamic Web Project wizard</link>. Further pages in the + wizard are specific to either the project type or the facets selected.</para> + + + <para>If you need to configure the facets for the existing project, you should bring up the + context menu for selected project and click <emphasis> + <property moreinfo="none">Properties</property> + </emphasis> and then <emphasis> + <property moreinfo="none">Project Facets</property>. </emphasis> This will bring up the familiar + <link linkend="project_facets">Project Facets wizard</link>, where you can create + your own custom facets configuration.</para> + + <para></para> + + </section> + <section id="rel_resources_links"> + <title>Relevant Resources Links</title> + + <para>More on the WTP facets you can read in the <ulink url="http://help.eclipse.org/ganymede/index.jsp?topic=/org.eclipse.jst.j2ee.do...">eclipse help</ulink>.</para> + </section> +</chapter> + + +<chapter id="modules" xml:base="file:///home/ochikvina/WORK/for_compare/trunk/as/docs/reference/en/modules/modules.xml"> + <title>Deploying Modules</title> + + <para>In this chapter it will be described how to deploy modules onto the server.</para> + <para> First of all it is necessary to say that deploying to a server is mostly painless. There + are several ways to do it provided by WTP, and some additional methods provided by JBoss + Tools. These methods are described further in this chapter.</para> + + <section> + <title>Deploying on the Package Explorer</title> + + <para><diffmk:wrapper diffmk:change="changed">On the package explorer it is possible to publish either a project to a server or just + a single file. Let's look at how to do this.</diffmk:wrapper></para> + <section id="run_on_server_wizard"> + <title>Deploying with Run On Server Wizard</title> + <para> The first WTP method is to right-click on a project, such as a Dynamic Web + project, EJB project, or EAR project and then select <emphasis> + <property moreinfo="none">Run As > Run on Server</property> + </emphasis>. The resulting dialog allows you to select which supporting server the + project can be published to.</para> + <figure float="0"> + <title>Define a New Server</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/modules/modules_1.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + <para>Click <emphasis> + <property moreinfo="none">Next</property> + </emphasis> button to see add or remove projects page where you can choose projects + to configure them on server.</para> + <figure float="0" id="add_rem_proj"> + <title>Add or Remove Projects</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/modules/modules_2.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + <para>This page of the wizard also allows to undeploy modules from the server. For that + choose proper module(s) from the right and click <emphasis> + <property moreinfo="none"> < Remove</property> + </emphasis>. The modules will be completely undeployed after restarting your server + or republishing.</para> + <para>Generally, for the JBoss AS Server Adapters, publishing using this method will + force a default, best-guess, packaging configuration for your project. This + best-guess does not publish incrementally, but instead repackages your entire + project into a <emphasis> + <property moreinfo="none">.war</property> + </emphasis>, <emphasis> + <property moreinfo="none">.jar</property> + </emphasis>, or <emphasis> + <property moreinfo="none">.ear</property> + </emphasis> as appropriate, and then copies that file into the proper deploy + directory. For quicker smarter deployment, you will need to create archives using + the <link linkend="Project_archivesView">Project Archives view</link> and customize + packaging yourself.</para> + </section> + + <section id="single_file_deployment"> + <?dbhtml filename="DeployToServer.html"?> + <title>Deploying single files</title> + + <para>Sometimes it becomes necessary to deploy one or more files to a server. For + that in order not to do a full republish in the context menu of files a <emphasis><property moreinfo="none">Deploy To Server</property></emphasis> + option is provided that allows a single file deployment. To deploy these non-WTP files/projects + right click on the file (<emphasis> + <property moreinfo="none">-ds.xml</property></emphasis>, <emphasis> + <property moreinfo="none">.ear</property></emphasis>, <emphasis> + <property moreinfo="none">.jar</property></emphasis> etc.) and select <emphasis> + <property moreinfo="none">Deploy To Server</property> + </emphasis> and it will be automatically deployed.</para> + <figure float="0"> + <title>Deploy to Sever</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/modules/modules_6.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + <para>The deployed files are listed side-by-side with other modules that are deployed to + the server.</para> + + <figure float="0"> + <title>Deployed files on the Server</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/modules/modules_7.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + </section> + + </section> + <section> + <title>Deploying with JBoss Server View</title> + <para>As it has been already mentioned <property moreinfo="none">JBoss Server View</property> contains two + parts: the top part that displays all defined servers and the bottom part which provides + categories with additional information. Thus, in this section we suggest two more ways + to deploy resources onto the server.</para> + <section> + <title>Top part of JBoss Server View</title> + <para>In the top part of the <property moreinfo="none">JBoss Servers View</property> like in the Servers + View you should right click on a server and select the <emphasis> + <property moreinfo="none">Add and Remove Projects</property> + </emphasis> menu item.</para> + <figure float="0"> + <title>Add and Remove Projects</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/modules/modules_3.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para>This will bring up a <link linkend="add_rem_proj">familiar dialog</link> allowing + you to either publish projects or modules to a server, or remove them from the + server. If the selected module is a project like a Dynamic Web project, EJB project, + or EAR project, it will be published as through <emphasis> + <property moreinfo="none">Run on Server</property> + </emphasis> wizard, with a best-guess full package. If, however, the selected + element is an archive from the <link linkend="Project_archivesView">Project Archives + view</link>, it will be published according to the rules of that module + type.</para> + </section> + + <section> + <title>Bottom part of JBoss Server View</title> + <para>In the bottom part of <emphasis> + <property moreinfo="none">JBoss Server View</property> + </emphasis> there is a category called <emphasis> + <property moreinfo="none">Modules</property> + </emphasis> which should display all currently-published modules on the server. + Right-clicking on the desired module and selecting <emphasis> + <property moreinfo="none">Full Publish</property> + </emphasis> will force a full rebuild of the entire module.</para> + <figure float="0"> + <title>Full Publish</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/modules/modules_4.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para>Here, <emphasis> + <property moreinfo="none">Incremental Publish</property> + </emphasis> is meant to enable publishing of only those parts where changes have + been made.</para> + </section> + </section> + <section> + <title>Deploying with Project Archives View</title> + <para>In the <property moreinfo="none">Project Archives View</property> you can right-click on any declared + archive and select the <emphasis> + <property moreinfo="none">Publish To Server</property> + </emphasis> element. For more on this subject, see <link linkend="PublishToServer">Publishing to Server</link> in the Project Archives View section.</para> + <figure float="0"> + <title>Publish to Server</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/modules/modules_5.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + <para> The only way to ensure an <emphasis> + <property moreinfo="none">Incremental Build</property> + </emphasis>, such as changes to one <emphasis> + <property moreinfo="none">.jsp</property>, </emphasis> + <emphasis> + <property moreinfo="none">.html</property>, </emphasis> or <emphasis> + <property moreinfo="none">.class</property> + </emphasis> file, is to enable the builder for that project. This is done by either + changing the global preferences for the <property moreinfo="none">Archives View</property>, or by + enabling project-specific preferences and ensuring the builder is on.</para> + <para>The last chapter covers a variety of methods on how you can deploy needed modules onto a + server.</para> + </section> +</chapter> + + +<chapter id="tptp_support" xml:base="file:///home/ochikvina/WORK/for_compare/trunk/as/docs/reference/en/modules/tptp_support.xml"> + <title>TPTP Support</title> + <para>This chapter provides an overview on how to enable TPTP Profiling for <property moreinfo="none">JBoss + AS</property> adapters in <property moreinfo="none">JBoss Tools</property>.</para> + + <section> + <title>TPTP Profiling</title> + + <para>To get TPTP profiling work on <property moreinfo="none">JBoss Application Server</property> you should + first download <ulink url="http://www.eclipse.org/downloads/download.php?file=/tptp/4.5.0/TPTP-4.5.0...">TPTP 4.5.0 Runtime</ulink> and install it, i. e. just add the content of <emphasis> + <property moreinfo="none">plugins/features</property> + </emphasis> folders from downloaded directory to the same folders in your eclipse + installation directory.</para> + + <para>And now all profile actions should work for you. To start <property moreinfo="none">JBoss + AS</property> in profiling mode use <emphasis> + <property moreinfo="none">Start the server in profiling mode</property> + </emphasis> button or <emphasis> + <property moreinfo="none">Profile As > Profile on Server</property> + </emphasis> option in the context menu of the project.</para> + + <figure float="0"> + <title>Start the Server in Profiling mode</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/tptp_support/tptp_support_1.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + + <para>To enable TPTP features in your workbench use <property moreinfo="none">Profiling and Logging + Perspective</property> that you can find in the list of proposed perspectives: <emphasis> + <property moreinfo="none">Window > Open Perspective > Other…</property> + </emphasis> + </para> + + <figure float="0"> + <title>Profiling and Logging Perspective</title> + <mediaobject> + <imageobject> + <imagedata fileref="images/tptp_support/tptp_support_2.png"></imagedata> + </imageobject> + </mediaobject> + </figure> + </section> + + <section> + <title>Relevant Resources Links</title> + <para>All additional information on TPTP(Test and Performance Tools Platform) you can find + in <ulink url="http://www.eclipse.org/tptp/home/downloads/4.5.0/documents/quicktour/quic...">eclipse documentation</ulink>.</para> + <para>In summary, this reference should help you to start with <ulink url="http://www.jboss.org/jbossas">JBoss AS</ulink> and get to know with functionality + for work with it.</para> + </section> +</chapter> + + +</book>

15 years, 1 month

1
0
0 / 0

2024

2023

2022

2021

2020

2019

2018

2017

2016

2015

2014

2013

2012

2011

2010

2009

2008

2007

jbosstools-commits May 2009