URI Examples

Several URI examples with ways to help you launch applications.

In this page examples are grouped under the headings: connections, launching applications, launching applications with arguments, and launching Web services.

Web application URI syntax

A Web application URI entered in your browser's address bar takes the form of the following syntax:
http[s]://host:port/scope/action/app-name
Where:
  1. host is the name or IP address of the Application Server.
  2. port is the port number on which the Application Server listens.
  3. scope is the client protocol, for example, ua (uaproxy) for applications.
  4. action is the action requested of the Application Server. For example, r is used for a start-up request. This changes depending on the action requested of the server as the application runs.
  5. app-name is the name of the application.

Web application URI syntax with query string

If the AllowUrlParameters attribute in the EXECUTION (for an application) is set to TRUE, parameters can be passed as arguments in the application URL. A Web application URI with arguments takes the form of the following syntax:
http[s]://host:port/scope/action/app-name?arg-name=arg-value[&...]
Where:
  1. host is the name or IP address of the Application Server.
  2. port is the port number on which the Application Server listens.
  3. scope is the client protocol, for example, ua (uaproxy) for applications.
  4. action is the action requested of the Application Server. For example, r is used for a start-up request. This changes depending on the action requested of the server as the application runs.
  5. app-name is the name of the application.
  6. arg-name=arg-value is a query string in the key/value pair format. There can be one or more query strings in the URL. A question mark (?) follows the application name before the first query string. Each key/value pair thereafter is separated by an ampersand (&).

For an example using arguments in the app URL, see Running applications with GBC customization set in URL query string.

Connections

Running applications with direct connection to standalone GAS

  • This example launches the "myApp" Web application on the "localhost" Application Server, listening to port 6394:
    http://localhost:6394/ua/r/myApp
  • If the startup URL lists additional path members, they are allowed but ignored:
    http://localhost:6394/ua/r/myApp/foo/bar
    In this example, the "myApp" Web application is launched, and /foo/bar is ignored.

    When the proxy is started, the FGL_VMPROXY_START_URL environment variable is set to the URL used to start the application. In our example, this includes the additional path members /foo/bar, making the full path available for use by the application.

  • If the application is in the default group (_default), you can use the same URL or you can include the group name:
    http://localhost:6394/ua/r/_default/myApp

    The use of the _default group name is optional.

Running applications through Web server

This example launches the "myApp" application through the "webserver" Web Server.
http://webserver/gas/ua/r/myApp

The gas is a directory or virtual directory on the Web Server defined by the $(connector.uri) resource in the GAS configuration file (as.xcf). Typically this directory is called "gas".

Launching applications

Running Web applications

This URL example launches the "myApp" application:
http://appserver:6394/ua/r/myApp

Running desktop applications from URL with da protocol

Using a URL with da protocol launches an application via the Genero Desktop Client (GDC) monitor:
http://appserver:6394/da/r/appid
A .gdc shortcut is downloaded to your downloads directory. Doubleclick on the gdc shortcut to run the application. Alternatively, if your browser supports it, you can configure file association in the browser to open the .gdc shortcut with the GDC monitor and run the application directly. For more information on setting file association, see the browser's documentation.
Note: Prerequisites:
  1. Genero Desktop Client is installed.
  2. Application extension associations for gdc are set for your machine.

Running applications with arguments set in URL

The "myApp" application is launched with two arguments by the "webserver" Web server:
http://webserver/gas/ua/r/myApp?Arg=Val1&Arg=Val2

If the DVM already has parameters set by the command line, the parameters in the URL are added to the end of the command line.

For examples using arguments in the app URL, see Running applications with GBC customization set in URL query string .

Running applications with GBC customization set in URL query string

To specify the customization to use for the GBC user interface, add the gbc query string parameter to the application URL.
http://appserver:6394/ua/r/gwc-demo?gbc=my-custom-gbc
You can see:
  • A question mark (?) follows the application name.
  • gbc is the required query string parameter.
    Note: In the Genero web client prior to version 3.00, the parameter gwc-js was used. From version 3.10, it is renamed gbc. Use of gwc-js is deprecated but remains for compatibility.
  • The my-custom-gbc value is either the name of a text file referencing the customization directory name, or the actual name of the customization directory in paths defined by the GBC_LOOKUP_PATH element.
Important: The gbc value provided in the query string takes precedence over the configuration for the GBC element in the application configuration file (xcf).

Running Web applications in debug mode using the URL query string

To enable debug mode for a Web application running in the GBC, add the debugMode=1 query string parameter to the application URL. For example: http://localhost:6394/ua/r/HelloWorld?debugMode=1
Tip:

Add the query string parameter debugMode=0 to the URL to execute the application without debug mode. This can be useful when the GAS runs in development mode (with the --development flag), but you do not want the app running in debug mode.

Web services

SOAP Web services URI Syntax

A SOAP Web services URI entered in your browser's address bar takes the form of the following syntax:
http[s]://host:port/scope/action/[/group-name]/app-id/service-name
Where:
  1. host is the name or IP address of the Application Server.
  2. port is the port number on which the Application Server listens.
  3. scope is the client protocol ws (gwsproxy) for Web services
  4. action is the action requested of the Application Server. For example, r is used for a start-up request. This changes depending on the action requested of the server as the application runs.
  5. group-name is the name of the group. If the Web service belongs to the default group on the GAS, this is optional. If the Web service is part of a group that is not the default, you must provide the group name.
  6. app-id is the name that identifies the application. The configuration file .xcf identifies the name of the application. For example, if the configuration file is named app1.xcf, the name of your application (as it appears in the URL) is app1.
  7. service-name is the name of the Web service.

Running SOAP Web service applications

  • To get the WSDL for a specified service:
    http://appserver:6394/ws/r/appid/service?WSDL
  • To access the Web service: 
    http://appserver:6394/ws/r/appid/service
  • If the Web service uses a group: 
    http://appserver:6394/ws/r/mygroup/appid/service
  • Access through a Web server:
    http://appserver/gas/ws/r/appid/service

REST Web services URI Syntax

A REST Web services URI entered in your browser's address bar takes the form of the following syntax:
http[s]://host:port/scope/action/service-name/endpoint-path
Where:
  1. host is the name or IP address of the Application Server.
  2. port is the port number on which the Application Server listens.
  3. scope is the client protocol ws (gwsproxy) for Web services
  4. action is the action requested of the Application Server. For example, r is used for a start-up request. This changes depending on the action requested of the server as the application runs.
  5. service-name is the name of the Web service.
  6. endpoint-path contains path segments pointing to a resource.

Running REST Web service applications

  • To get the OpenAPI specification file for a specified service:
    http://appserver:6394/ws/r/myservice?openapi.json
  • To access a Web service resource: 
    http://appserver:6394/ws/r/myservice/myresource
  • Access through a Web server:
    http://appserver/gas/ws/r/myservice/myresource