Creating an ApplinX for JSP Web Application using the Software AG Designer (recommended)
Creating an ApplinX for JSP Web Application using JDK and Tomcat (no IDE)
Creating an ApplinX .NET Web Application using Visual Studio 2008
Creating an ApplinX .NET Web Application using Visual Studio 2010
Creating an ApplinX .NET Web Application using .NET (no IDE)
Upgrading an ApplinX .NET Web Application from Visual Studio 2003 to 2005
Upgrading an ApplinX .NET Web Application from Visual Studio 2003 to 2008
Upgrading an ApplinX .NET Web Application to Visual Studio 2010
The following is based on the released Eclipse version. Additional information can be found on Eclipse website and WTP (web tool platform) site.
To create a new Dynamic Web project
In the Eclipse workspace, select to create a new project.
Select .
Click to create a new web project. The New Dynamic Web Project dialog box is displayed.
Enter a name for the project.
In the Target Runtime field, select the Tomcat installation: click and select the server to be used: Either J2EE Preview (recommended) or Tomcat v5.5.
Important:
The Restart function in the J2EE Preview server does not work
properly. Instead of using the Restart function, stop and the start the server.
In addition, editing files only works after stopping and starting the
server.
Click .
Browse and select the Tomcat installation.
Note:
Currently the ApplinX internal Tomcat cannot be used to create a
web application and when selecting to use Tomcat, you are required to install
an additional Tomcat 5.5 version.
Select a JRE or click to add a new JRE. The Preferences dialog box is displayed.
Define the Runtime Environment (JRE) for the server: JSP server requires a full JDK and not only the JRE bundle. If you need to add a new JRE, click the button.
Assign a name to the new JRE.
Enter the JRE home directory (when necessary, click to locate the file).
Add VM arguments when required.
Click to return to the New Server Runtime dialog box. Select the newly created JRE. Click .
Click . The New Dynamic Web Project dialog box is displayed.
You have completed the configuration of the flexible project, the server (Tomcat) and the JDK.
Change the configuration to Custom and click .
Select ApplinX Framework. Ensure that the Dynamic Web Module and Java check boxes are selected. Click .
Click .
Click .
Select ApplinX installation from which to create the web project and select the application type.
Click .
Select the template to use in your application.
Click .
You have completed the creation of a standard WAR file (Java Web Archive).
Ensure that in the menu, is selected.
To run the project, right-click on the project's folder in the Project Explorer view and select .
The first time you run a project you are required to select a default server:
Select the server you configured.
Select the Always use this server when running this project check box. The next time you run the application, this dialog box will not be displayed. The server you selected will automatically be used.
Click to continue. A browser window will be opened.
Note:
The browser type can be configured under . It is recommended to configure it to Default system web browser.
When using the Javadoc you will have:
Online usage of the Eclipse Javadoc for ApplinX API.
Suggested argument names for the ApplinX API, instead of arg0, arg1, etc.
To use Javadoc capabilities when developing your project
Right-click on the project node and select . The Properties dialog box is displayed.
In the Libraries tab, expand the gxframework.jar node, click on Javadoc location and then click on the Edit... button to determine the location of the Javadoc.
You can either enter the URL http://localhost:2380/applinx-help or browse and select the Javadoc location path <Software AG installation> > ApplinX > Help > API. Then click .
Click to close the Properties dialog box.
Note:
This is not available when working with a SOA license.
To create a new JSP application without any IDE and with JDK
Refer to ApplinX for JSP Web Application in Software Requirements.
During the installation process, choose the option .
In the ApplinX Explorer, right-click on the relevant application and select . The Web Application Manager wizard is displayed.
Ensure that Create a new Web application (for IIS or Tomcat) is selected. Click . The Create a New Web Application screen is displayed.
Ensure that JSP is selected. Select the application type: New application to create a basic ApplinX web application with a web look and feel or Emulation template to create an ApplinX web application with a host look and feel.
Click . The Select Template screen is displayed.
Select a template from the list on the left.
Click . The Create a New JSP Web Application screen is displayed.
Enter a name for the web application. By default this is the name of the ApplinX application that you selected. Browse and select the folder where Tomcat is installed. Select the location of the JDK installation.
When you wish to use the ApplinX internal Tomcat, select the corresponding check box.
Click . The Wizard Summary screen is displayed.
Select whether to launch the browser when the process is completed.
Select whether to restart Tomcat. This is only relevant when Tomcat is activated from a batch file. The Framework Manager does not support restarting Tomcat when Tomcat runs as a Windows Service (in this case, you need to manually restart Tomcat).
Click . A message will be displayed indicating whether the process succeeded or failed.
Note:
Any change in the Java file requires recompilation of your new
application. Changes in JSP files do not require recompilation. Furthermore,
Tomcat requires reloading:
http://localhost:8080/manager/reload?path=/<YOUR_APP_NAME>.
To create a new ApplinX web application using Visual Studio 2008
Install J# 2.0 redistributable package Second edition.
Install Microsoft Visual Studio 2008 on your computer (install Visual Studio before installing ApplinX so that when installing ApplinX, the ApplinX web application templates will be added to the available Visual Studio New Web Sites).
Open Visual Studio 2008.
In the menu, select and then to create a new web site. The New Web Site dialog box is displayed.
Select the relevant ApplinX web application type (Visual C# or Visual Basic).
Determine whether you would like to upgrade to .NET framework 3.5 or continue working with .NET framework 2.0 (both options are acceptable).
Define that index.aspx will be the start page (right-click on index.aspx and select ).
Run the web site.
In the Framework Configuration Editor, define the connection parameters as follows:
Click on the Framework Configuration link. The Configuration Editor will be displayed.
In the Session node, enter the application name. By default, the application name is "InstantDemo". In the Session node, it is possible to edit and configure additional connection and project properties.
Click to save your changes.
Click to return to the web application.
To create a new ApplinX web application using Visual Studio 2010
Install J# 2.0 redistributable package.
Install .NET Framework 3.5 SP1.
Install Microsoft Visual Studio 2010 on your computer (install Visual Studio before installing ApplinX so that when installing ApplinX, the ApplinX web application templates will be added to the available Visual Studio New Web Sites).
Open Visual Studio 2010.
In the menu, select and then to create a new web site. The New Web Site dialog box is displayed.
Select to work either with .NET Framework 2.0 or 4.0.
Select the relevant ApplinX web application type (Visual C# or Visual Basic).
Define that index.aspx will be the start page (right-click on index.aspx and select ).
Run the web site
In the Framework Configuration Editor, define the connection parameters as follows:
Click on the Framework Configuration link. The Configuration Editor will be displayed.
In the Session node, enter the application name. By default, the application name is "InstantDemo". In the Session node, it is possible to edit and configure additional connection and project properties.
Click to save your changes.
Click to return to the web application.
Note:
This is not available when working with a SOA license.
To create a new ASP.NET application without Visual Studio .NET with
.NET SDK
During ApplinX installation, select the ApplinX ASP.NET Web Framework C#/VB .NET option.
In the ApplinX Explorer, right-click on the relevant application and select . The Web Application Manager wizard is displayed.
Ensure that Create a new Web application (for IIS or Tomcat) is selected. Click . The Create a New Web Application screen is displayed.
Ensure that C# 2.0 or VB 2.0 is selected. Select the application type: New application to create a basic ApplinX web application with a web look and feel or Emulation template to create an ApplinX web application with a host look and feel.
Note:
If you wish to create a new web application based on .NET 4.0, you
need to use Visual Studio 2010 (refer to Creating an ApplinX .NET Web Application using
Visual Studio 2010).
Click . The Select Template screen is displayed.
Select a template from the list on the left. Click .
The Create a New .NET Web Application screen is displayed.
Enter a name for the web application. By default, this is the name of the ApplinX application that you selected. Browse and select the destination folder.
Click . The Wizard Summary screen is displayed.
Select whether to launch the browser when the process is completed.
Click . A message will be displayed indicating whether the process succeeded or failed.
Note:
When using the Application Manager on IIS 7.5 or 8.0, you need to convert
your application from a virtual directory to a web application (in the IIS
manager, right-click on your application and select Convert to
Application).
To upgrade a project from Visual Studio 2003 to Visual Studio
2005
In Visual Studio 2005, open the web application by clicking and selecting the web application.
The Visual Studio Conversion Wizard is displayed. Click .
Determine whether you would like to create a backup before converting.
Click
The conversion process is run. Once completed, errors are displayed in the conversion log. When necessary, make the required changes to correct these errors (error lines relating to the project file do not need to be dealt with, as from this point, you are working with a web site and not a web project). For example, an error "Unable to move file" should be corrected by manually moving the file.
Build the web site. If errors are displayed, check what these errors are and make the necessary changes.
Close the web site ().
In ApplinX Designer, upgrade your web application using the ApplinX Web Application Manager (refer to Upgrading a .NET Web Application in Web Application Development.
Reopen the web application in Visual Studio 2005 ( and select the web application).
Build the web site. Correct errors.
Define that index.aspx will be the start page (right-click on index.aspx and select ).
You can run the web site to ensure that it performs as expected.
To upgrade a project from Visual Studio 2003 to Visual Studio
2008
Ensure that you have J# 2.0 redistributable package installed.
In Visual Studio 2008, open the web application by clicking and selecting the web application.
The Visual Studio Conversion Wizard is displayed. Click .
Determine whether you would like to create a backup before converting. Click .
Determine whether you would like to work with .NET 2.0 or .NET 3.5.
Click .
The conversion process is run. Once completed, errors are displayed in the conversion log. When necessary, make the required changes to correct these errors (error lines relating to the project file do not need to be dealt with, as from this point, you are working with a web site and not a web project). For example, an error "Unable to move file" should be corrected by manually moving the file.
Build the web site. If errors are displayed, check what these errors are and make the necessary changes.
Close the web site ().
In ApplinX Designer, upgrade your web application using the ApplinX Web Application Manager (refer to Upgrading a .NET Web Application in Web Application Development.
Reopen the web application in Visual Studio 2008 ( and select the web application).
Build the web site. Correct errors.
Define that index.aspx will be the start page (right-click on index.aspx and select ).
You can run the web site to ensure that it performs as expected.
To upgrade a project to Visual Studio 2010
Ensure that you have J# 2.0 redistributable package Second edition installed.
When upgrading to Visual Studio 2010 from Visual Studio 2003, you need to first perform the upgrade task above: either Upgrading an ApplinX Web Application from Visual Studio 2003 to 2005 or Upgrading an ApplinX Web Application from Visual Studio 2003 to 2008.
In Visual Studio 2010, open the web application by clicking and selecting the web application.
Determine whether you would like to work with .NET 2.0 or .NET 4.0.
In ApplinX Designer, upgrade your web application using the ApplinX Web Application Manager (refer to Upgrading a .NET Web Application in Web Application Development.
Define that index.aspx will be the start page (right-click on index.aspx and select ).
You can run the web site to ensure that it performs as expected.
