Configuring the Same Project with Different Names in the Broker (Magic xpa 2.x)

Objective

This Technical Note explains how to configure the same project with different names in the broker.

General

Sometimes you need to configure a different Web URL (application name) for a different set of users while pointing to the same application.

In eDeveloper V9.4 there is an option to have the application list point to the same MCF or MFF in the Magic.ini file.

Since eDeveloper V10 and Magic xpa do not keep a list of all the projects in the ini, a solution is required to enable you to specify a different name to the application.

Solution

The ApplicationPublicName environment setting provides a way to set a different name for the project. The broker will recognize the application by this name.

Example Description

If you want to refer to the application in the URL by APPNAME=IncomeT while the project name is Accounts you need to add the following flag in the Magic.ini file:

ApplicationPublicName = IncomeT

This setting is available only by manually setting it in the .ini file under the MAGIC_ENV section.

Opening the project using the modified Magic.ini file will indicate to the broker to recognize the application by the name IncomeT instead of Accounts.

The same can be done in the Mgrb.ini file.

Using the command line parameters in the Mgrb.ini [APPLICATIONS_LIST], the same setting can be applied:

[APPLICATIONS_LIST]

Salary = MgxpaRuntime.exe /ApplicationPublicName=Salary /DeploymentMode=B /StartApplication=C:\ Magicxpa\Projects\Accounts\Accounts.ecf, C:Magicxpa\,,,1,0

IncomeT = MgxpaRuntime.exe /ApplicationPublicName=IncomeT /DeploymentMode=B /StartApplication=C:\ Magicxpa\Projects\Accounts\Accounts.ecf, C:\Magicxpa\,,,1,0

Important Notes

1. The new application values will not be retrieved in your application logic if you are using the AppName() function. This function is meant only to return the project name and not the application names registered in the broker via /ApplicationPublicName.

2. If you need to retrieve the name set by /ApplicationPublicName for the project, you need to do one of the following:

• INIGet(‘[MAGIC_ENV] ApplicationPublicName’)

• Retrieve the QUERY_STRING keyword using the HttpVars parameter of the Mgreq.ini file.