Create an application configuration file

An application or Web service configuration file provides details required by the Genero Application Server to launch an application or Web service.

About this task

When using Genero Studio, if you specify a Genero Browser Client front-end, Genero Studio generates a default application configuration file. You may need to change the default configuration. For example, you may need to pass parameters to the application or change the customization project used by the Genero Browser Client.

To specify a different configuration, create a custom application configuration file. Your custom file will eventually be merged with the default configuration file.
Note: If you created your project using the Desktop Project (.4pw) or BAM Desktop Project options, you already have this file. However, if this is not the case, you can create this file in Genero Studio.

If you want to package multiple applications in your project, create configuration files for each one. The simplest method is to copy the existing configuration file, rename it, and update the MODULE element in the file. If you do not have an existing configuration file, see the Genero Application Server User Guide for information.

  1. Select File > >> New > >> Web / AS.
  2. Under the section Configuration, select either Application Configuration (.xcf) or Web Service Configuration (.xcf) and click OK.
    An untitled .xcf file displays in Code Editor, providing the basic shell needed for an application or Web service configuration file.
  3. Modify the file as needed. Add those elements that you need to modify.
    See the Genero Application Server User Guide for specifics on updating application or Web service configuration files. You only need to include those elements you need to modify.
    This example specifies the customization directory to use when displaying an application using the Genero Browser Client (GBC). The GBC element specifies the symbolic link to the customization project directory. For more information on GBC customization projects and configuration files, refer to the Genero Browser Client User Guide.
    <?xml version="1.0" encoding="UTF-8" ?>
    <APPLICATION Parent="defaultgwc"
     xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
     xsi:noNamespaceSchemaLocation="http://www.4js.com/ns/gas/3.00/cfextwa.xsd">
      <UA_OUTPUT>
        <PUBLIC_IMAGEPATH>$(res.public.resources)</PUBLIC_IMAGEPATH>
        <GBC>mycust</GBC>
      </UA_OUTPUT>
    </APPLICATION>

    This example passes parameters at the application start.

    <?xml version="1.0" encoding="UTF-8" ?>
    <APPLICATION Parent="defaultgwc"
     xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
     xsi:noNamespaceSchemaLocation="http://www.4js.com/ns/gas/2.10/cfextwa.xsd">
       <EXECUTION>
        <PARAMETERS>
            <PARAMETER>--test</PARAMETER>
            <PARAMETER>-o</PARAMETER>
            <PARAMETER>outputFile.txt</PARAMETER>
        </PARAMETERS>
      </EXECUTION>
    </APPLICATION>