Publishing an application

Progress Developer Studio for OpenEdge provides a Publish wizard to facilitate application publishing. The Publish wizard allows you to complete the following tasks:

Retrieve the project file as input and pack all the referred files into an archive file.

Connect to the web service on the specified server and upload the package (that is, send the user name and password, verify if the application is already installed; and if yes, prompts you to replace the existing application).

Send the archive to the Web server and instructs the server to unpack and install the application.

Display the result of publishing (success/failure).

Note: Alternatively, you can use the Servers view to publish processes as modules on the connected Business Process Server. For more information, see Using the Servers view.

Note: To successfully publish an application, you must ensure that JDK/ JRE 1.7 build path is installed with Eclipse.

All existing applications are archived in JAR file. Progress of publishing and error messages are shown in a dialog box.

Note: Make sure that all active instances for an application (and its subprocesses) are completed before publishing (or republishing) the application.

To publish an application:

1. From the Project Explorer view, select the project to be published.

2. From the Project menu, click Publish to open the Publish Wizard.

Note: All project components must be valid in order to publish it. To determine the validity of the application, click

or right-click in a blank area of the main frame and select Check Diagram option. If you have correctly defined the application, “The diagram is complete” message appears. Click OK.

3. From the options displayed in the Server drop-down list, select the server to which you want to connect the project, or modify the default server path. The URL you enter here for example, http://localhost:port/sbm/deployment— is where SOAP can be found as part of the Web application.

4. Enter your User name and Password and then click Next to go to the next page.

Note: You can configure target server options from the Publish page in Preferences dialog box. For details, see Using the Publish page.

The Publish wizard now attempts to connect to the server you selected.

a. If you are publishing the process template for the first time, the second page of the Publish Wizard displays the Web services section. Select the Publish as web service checkbox to publish the process as a Web service.

b. If you are publishing a process template that has been published previously, the second page of the Publish Wizard now displays the options described in Table 18.

Table 18. Publish options for a previously published application
Select	To
Reinstall	Reinstall the process template
Refresh process template	Apply simple changes in process flow to running processes and associated instances. You don't have to create a new version or, migrate instances. For example, select this option (as is shown in the figure above) if you only want to change the format of a few HTML/JSP forms in the application. If the application cannot be refreshed, the Refresh Process Template option is not enabled, and a message appears with a link that will open a window listing the issues preventing a refresh.
Copy files to server only	Copy any updated files to the connected server.

You can select the Publish as web service checkbox to publish the process as a Web service. This checkbox is enabled even if the application was previously installed. If the application had previously been published, reinstalling or refreshing the template automatically republishes the application and this checkbox is not displayed.

c. If you are publishing a process template, which is a version of a previously published application, the second page of the Publish Wizard displays the following options.

Select the Inherit ACL checkbox to retain any user permissions in the version of the application you are creating that are associated with the parent application. By selecting this option, you ensure that when you publish this version on Business Process Portal, it will have the same user permissions that the original application had.

Select the Publish as web service checkbox to publish the process as a Web service.

For Business Process Server installed with https enabled, ensure that a valid certificate is added to your JDK. Otherwise, this publish operation using Web services will fail. For information on how to add a certificate, refer JDK documentation.

d. Click Next to continue.

5. The last page of the Publish Wizard displays the “Application published successfully” message if the application has been successfully published. You can select the Go to Business Process Portal checkbox to automatically open Business Process Portal login page (with address as specified in the adjoining box) in your Web browser when you click Finish.

If the Publish Wizard encounters problems in publishing the application, an Error window appears. Click Details to obtain information about any publishing problems.