Finding and replacing applications

As applications change, you may need to replace existing applications with newer versions or different application implementations. Use the Find/Replace Application window to perform this update.

This functionality is particularly useful to replace broken applications in your production environment.

Using Find/Replace for any application with CGI parameters is limited to finding the same application with a different version. For example, if application A has CGI parameters, you can find or replace another application with the same name, application A, but the application must have a different version to find it using Find/Replace.

Enabling find and replace application functionality

Unwired Accelerator lets you enable the find and replace applications functionality for Mobile Web Studio users with the PortalAdmin role, as described in the global.properties.xml portal configuration file:

<Property name="PortalAdministrationRole"
value="PortalAdmin" description="The J2EE role 
required to administer the Portal performing export/import and update operations." menugroup="-1" />

To grant a Mobile Web Studio user the PortalAdmin role, you must have the StudioAdmin role.

Select the organization in which the user resides to whom you want to give find and replace access.

Select Users in the Organization Manager menu.

Right-click the user in the detail view and select Edit Roles.

When the Edit User Roles window displays, grant the user the PortalAdmin role, then click OK.

Finding and replacing applications

To find and replace applications should follow this procedure.

When the Mobile Web Studio main window displays, select Build | Applications from the left pane, then click Replace from the toolbar above the detail pane.

In the Find/Replace Application window, click Select to the right of “Find.”

In the Find Application window, click Search. A list of applications displays in the Search Results window.

Select the application you want to replace, and click Add.

You return to the Find / Replace Application window with the Name, Version, and ID fields filled in.

Click Select to the right of “Replace.”

In the Find Application window, click Search. A list of applications displays in the Search Results window.

Select the application you want to replace the previously selected application, and click Add.

You return to the Find / Replace Application window with the Name, Version, and ID fields filled in.

Before executing the find and replace operation, UA checks whether the applications you specified are using CGI parameters. If the applications use CGI parameters, both the find and replace application must have the same name.

(From) Active Catalogs – select this option to find and replace the specified applications in all active catalogs. Active catalogs in Portal Interface display applications that users can select and add to their own personal pages. If any active catalogs are modified with a new application, Portal Interface users catalogs are immediately updated.
(From) Non-Active Catalogs – select this option to find and replace the specified applications in all non-active catalogs.
(From) Portal Pages – select this option to find and replace an application for all page types—guest, default, and catalog.
- Update Portal User Pages – when you select the previous option (Portal Pages), select this option to have Portal Interface user page groups automatically updated for all changed portal pages.
Agent’s Rule – agent rules evaluate an application’s content and determine if the agent should continue. Select this option to find and replace the application specified in the agent’s rule. Agents can use one application in the processing rule. If a criteria is selected for the rule, no application is included in the agent and no update is needed. See Chapter 7, “Using Unwired Accelerator Alerts,” for more information.
Agent’s Action – select this option to find and replace the specified application in the agent’s delivery action. Agents can deliver or write applications to a location. These applications are listed in the agent’s actions.

To view a log of the changes that would occur as a result of your selections, click Preview.

Click OK.

Once you click OK, the Details button is enabled. Click Details to see a detailed log of the changes that would occur:

Once you preview the changes, click Replace to permanently implement the changes.

You see an alert message similar to the one that displays when you click Preview.