You must enable javascript in order to view this page or you can go
here
to view the webhelp.
Genero Application Server User Guide 2.50
Content
Search
Index
Keywords:
Loading, please wait ...
What's new in Genero Application Server, v 2.50
Product Overview
What is the Genero Application Server?
Standalone Genero Application Server
Dispatchers
Front Ends and Extensions
Architecture of the Genero Application Server
Architecture overview
Reliability inherent in the architecture
Development architecture (standalone GAS)
Deployment (production) architecture
Services Pool (GWS Only)
Quick Start Guide for the GAS
Fundamentals
The Application Web Address
URIs acknowledged by the GAS
Application URIs
File serving URIs
URI Examples
Automatic Discovery of User Agent (adua.xrd)
What is an Output Map?
How an Output Map is chosen
Modify the adua.xrd file to specify custom Output Maps
Specify the Output Map in the application URI
ADUA Syntax Diagrams
RULE_LIST
RULE
TABLE
ROW
auda.xrd Usage Example
Internationalization
Encoding Architecture
Charsets Configuration
DVM Locale
HTML charset
XML Encoding
GAS System Encoding
Default Encoding
Supported Charsets
Translations in the snippets
Predefined Resources
GAS predefined resources
Common GAS predefined resources
GDCAX-specific GAS predefined resources
GWC-specific GAS predefined resources
Application Environment
Delegate the start of an application or service
What is delegation?
How delegation works
Configure delegation for an application or service
From the user agent to the REST service
From the REST service to the proxy
REST service example
Delegation use cases
GAS Directories
Genero demo applications
Find the demo applications
Display demo applications with the Genero Web Client
Configuring the Genero Application Server
System Requirements
Operating Systems
Genero BDL
Web Servers
User Agents
Databases
GAS Configuration Check
Managing Access Rights
Validating the Installation with the Genero Web Client
Validate the installation without a Web server
Validate the integration with the Web Server
Validating the Installation with the GDC
Validate the installation without a Web server
Validating the Installation with the GDCAX
Validate the installation without a Web server
Validate the integration with the Web Server
Troubleshooting Configuration Issues
Proxy Errors
Browser cannot open 127.0.0.1 or localhost
Application does not start
Licensing
Licensing - Base Example
Licensing - Using the RUN command
Licensing - Multiple User Agents
Licensing - Summary Case
Genero Front Ends and License Counting
Licensing Tips and Tricks / Troubleshooting
The ADDRESS element
The USER_AGENT timeout element
The MAX_AVAILABLE element for a Web Service
Evaluate licensing when migrating from GDC
ISAPI Extension Installation and Web Server Configuration
The Genero Application Server and IIS
Install the ISAPI dispatcher
Installing with the Microsoft Installer
Manual configuration for IIS 6.0
Manual configuration for IIS 7.x
Manual configuration for IIS 8.x and IIS 10.x
Finishing the installation
GAS ISAPI Extension configuration file
Troubleshooting installation
Restarting the ISAPI dispatcher
FastCGI Installation and Web Server Configuration
Using the FastCGI connector
FastCGI GAS configuration on various Web Server
Apache: mod_fastcgi
Apache 2.4: mod_proxy_fcgi
Fastcgi for nginx
Lighttpd
Sun Java System Web Server 7.0
Troubleshooting
Why does my application not work with fastcgi?
Invalid installation directory
Applications all down at the same time
Restarting the FastCgi dispatcher
Java Servlet Installation and Web Server Configuration
Using the GAS Java dispatcher
Configuration of the Java dispatcher
Building the Java Web Archive (WAR)
Deploying on a Java Web Server
Restarting the J2EE dispatcher
Validating configuration files
What is an XML Schema Definition file?
Why specify the XML Schema Definition file?
Validating with the gasadmin tool
Selecting an XML editor
Quick Start: Have the GAS deliver your application
Create an application configuration file
Configure the database environment
Use a script to set the environment
Deploying application images
Next steps
Single sign-on (SSO)
Kerberos authentication
Using Kerberos
System Requirements
Configuring Authentication
Authentication Process for Applications delivered by the GWC
Enabling Kerberos authentication for a GWC application
Implement Kerberos Authentication
Kerberos Deployment Goals
Why deploy Kerberos?
Kerberos Main Concept
Kerberos Service Name
Configuring Kerberos Environment
Required Information
Examples used in this documentation
Kerberos Requirements
Domain Name System (DNS)
Configure Time and Verify Time Synchronization
TCP/IP Network Connectivity
Operating System
Configure Kerberos Authentication between the Web Browser and the Web Server
Windows Service Principal Name (SPN)
Configure Kerberos Authentication between the Web Browser and the GAS server
Complete Configuration
Kerberos Configuration Reference
Used Kerberos Service Name
Web Server Configuration
IIS 6.0 Configuration
IIS 7.0 Configuration
HTTP Clients Configuration
Internet Explorer Configuration
Step 1: Configure Local Intranet Domains
Step 2: Configure Intranet Authentication
Step 3: Verify the Proxy Settings
Step 4: Set Integrated Authentication for Internet Explorer 8.0
Firefox Configuration
Genero Desktop Client Configuration
Genero Configuration
GAS Configuration
GAS Account Configuration
Service Principal Name (SPN) Configuration
Unconstrained Delegation Configuration
Kerberos Constraints
Useful Tools
OpenID SSO and the Genero Application Server
Quickstart: Set up OpenID in the Genero Application Server
Configure GAS to support OpenID SSO
Add OpenID SSO to a Genero Web application
Retrieve identity attributes with OpenID SSO
Authorization and OpenID SSO
Execute a Genero Web Client application with OpenID SSO
Realm Usage
Genero OpenID configuration
Specify a database for Genero OpenID implementation
FGLPROFILE
The Genero OpenID implementation log file
SAML SSO and the Genero Application Server
Quickstart: Set up SAML in the Genero Application Server
Configure GAS to support SAML SSO
The ImportIdP program
Add SAML SSO to a Genero Web application
Select the SAML server (Identity Provider)
Define the ID format
Retrieve the SAML ID
Set the authentication context
Retrieve identity attributes with SAML
Authorization and SAML SSO
Execute a Genero Web Client application with SAML SSO
Genero SAML configuration
Specify a database for Genero SAML implementation
SAML FGLPROFILE
The Genero SAML implementation log file
Single sign-on tutorial
Force user to enter login and password
Add a cookie mechanism
Disconnect (log off)
Production recommendations
Compression and the Genero Application Server
Configuring Multiple Dispatchers
Administering the Genero Application Server
Tools and Commands
Dispatcher: httpdispatch
Dispatcher: fastcgidispatch
Dispatcher: java-j2eedispatch
Proxy: html5proxy
Proxy: gwcproxy
Proxy: gdcproxy
Proxy: gwsproxy
The fglxslp command
The fglgar command
The gasadmin command
Monitoring
Usage
Statistics
Logging
Using the debugger
Using the Debugger for the GAS on the Windows platform
Using the Debugger for the GAS on UNIX
Performance tuning
Web server configuration: Keep Alive
SPDY
Load balancing
GAS requests
Sessionless request processing
Session-bound request processing
Load Balancing Configuration Examples
Internet Information Services 5.x and 6.0
Internet Information Services 7.x
Apache 1.3.x and 2.0.x
Apache 2.2.x
Developing Web applications
Genero Desktop Client ActiveX
Adding a GDCAX Application
Application Configuration Overview
Creating Abstract Applications
Configuring applications for Genero Desktop Client ActiveX
Using External Application Configuration Files
Creating a Group
Configuring an External Application
How Templates Work for the GDCAX
GAS tags and predefined resources
GDCAX Template
Genero Web Client
Genero Web Client Basics
What is the GWC?
Key Players
Browser-based themes
Features and limitations
Non-supported hot keys
Migrating from GDC to GWC
Evaluate your GWC application needs
Migration tips
Adding a Web Client Application
Application Configuration Overview
Creating Abstract Applications
Configuring applications for Genero Web Client (GWC)
Using External Application Configuration Files
Creating a Group
Configuring an External Application
What if the application doesn't start?
How the GAS / GWC uses Web Technologies to deliver an application
How an Application is Rendered by the GWC
Template
Cascading Style Sheet
JavaScript
Template Language
Session Variables and Cookies
Why Session Variables? Use Cases
Working with Session Variables and Cookies
Build HTTP Cookies in the Configuration File
Setting session variables with front-end functions
Setting session variables with a snippet-based rendering engine function
Setting session variables with Client Side Framework API
Access session variables using template paths
Example
File Transfer within the GWC
File Transfer: Uploading a File
Deploying an application that includes a file upload field
File Transfer: Downloading a File
GAS configuration for Web application file transfer
File Transfer Timeout
File Upload Temporary Directory
Troubleshooting FAQ
EDIT field rendering
Forms statement error -8067
Forms statement error -8066
Type Ahead
What is the Type Ahead mechanism?
Type Ahead mechanism details
Type Ahead Best Practices
Type Ahead workflows
Customize the UI for the GWC
Understanding SBRE (the Snippet-Based Rendering Engine)
What is the SBRE (Snippet-Based Rendering Engine)?
Understanding Snippet-Based Rendering
Rendering Configuration
Output Driver
Themes and Snippet Sets
Output Maps
Why are some widgets partially rendered?
Html5 Theme
HTML5 theme overview
Features / browsers supported
Genero features not supported or partially supported
Widget support by browser
Understanding layouting with the HTML5 theme
Layout defaults
Layout markup and data structures
Layout container elements
Layout item elements
Layout policy elements
Example of layout markup
Layout algorithm
Client-Side Framework and Components
Parts of the Client-Side Framework
Snippets-components relationship
Attributes used in snippets
Snippet data
Snippet data event
Snippet event
Client-Side Framework lifecycle
Client-Side Framework events
Component
Component API
Component lifecycle
component.dialog API
Client-Side Framework internals
gwc.api
gwc.cfg
gwc.dialog
gwc.frontCallModuleList
gwc.componentSet.main (the main component)
gwc.componentSet.extend (Extending the component)
Localization
Component customization
Limitations
System Features Limitations
Miscellaneous missing features
Customize your Genero Web Client application
Customize with Genero Presentation Styles
Limitations when generating CSS from a 4st style file
Customize with Cascading Style Sheets (CSS)
Cascading Style Sheets and the HTML5 theme
What takes priority: Presentation Styles or existing CSS files
Customize the User Interface with Templates and Snippets
Writing a Custom Snippet
Using your Custom Snippet
Customize templates and snippets for HTML5
Customize the application header and footer
Customize the bootstrap template to initialize information for the application
Customize the User Interface with JavaScript
Customization tutorial
Step 0: Run the Card application
Step 1: Customize with Cascading Style Sheets
Step 2: Customize the layout
Step 3: Customize the snippets
Front End Protocol
Exclusive/Inclusive forms
Usage
Front End Call Framework
Front End Calls
GWC How To's
Browser Back and Forward Buttons
Change the Widget Display based on a Field Attribute
Control the folder size
Copy the content of disabled fields
Create a Breadcrumb Trail
Display a widget as a hyperlink
Display the error message at the bottom of the screen (GWC for HTML5)
Enable the StartMenu and applications in folder tabs
Handling POST Method Submit Parameters
Relating Styles, Classes, and Selectors
Rich text editing
Run batch programs
Start an application without stored settings (GWC for HTML5)
Transmit spaces with an HTML submit
Genero Web Client hybrid mode
What is the GWC hybrid mode?
Create a native application from your Genero application
The GWC hybrid mode for iOS
Requirements
Source files and components
Open the project
Deploy your GWC hybrid mode application for iOS
Customizations and Extensions
Set the application splash screen
Set the application icon
Set the application URL
Set the default application details for the Settings pane
Hard-code the application URL
Use front calls
Execute Javascript from the native application
Call Objective-C methods from the Genero application
Add localization
Limitations
The GWC hybrid mode for Android
Requirements
Install Eclipse and the Android Development Tools (ADT) plug-in
Source files and components
Open the project
Deploy your GWC hybrid mode for Android
Customizations and Extensions
Set the application splash screen
Set the application icon
Enable or disable the display of the Preferences Screen
Set the application URL
Use front calls
Bridge to JavaScript methods
Call Native Methods
Add localization
Limitations
Genero Web Services
Application Configuration Overview
Creating Abstract Applications
Configuring applications for Genero Web Services
Accessing the Web Service (Web Services URI information)
Using External Application Configuration Files
Creating a Group
Configuring an External Application
Service invalidation
Sticky Web services
Deploying with Genero Archive
What is a Genero Archive?
Quick start: Genero Archive
Genero Archive lifecycle
The MANIFEST file
File system layout of a deployed archive
Genero Archive procedures
Create a Genero Archive
Deploy an archive
List all deployed archives
Activate (enable) a deployed archive
Deactivate (disable) a deployed archive
Undeploy a deployed archive
Clean up undeployed archives
Upgrade an archive
Genero Archive deployment service
Upgrading
New Features
Version 2.50
Version 2.41
Version 2.40
Version 2.32
Version 2.30
Version 2.22
Version 2.21
Version 2.20
Upgrade Guides
2.50 upgrade guide
2.41 upgrade guide
2.40 upgrade guide
Template and snippets
Template paths
2.30 upgrade guide
Starting the GAS
Configuration
Support
Template functions
XPathConfig migration
Legacy connectors
Mod_fcgid
2.22 upgrade guide
2.21 upgrade guide
2.20 upgrade guide
Configuration
Snippets sets
Legacy connectors installation
Templates and snippets
Migrating from GAS 2.10.x or GWC 2.10.x
Application configuration
Template and snippets
Deprecated functions and paths
2.10 upgrade guide
Migrating to the snippet-based rendering engine
2.00 upgrade guide
fglxslp
fglxmlp
Migrating Templates and Snippets Customizations
Template and Snippets Customization Migration Steps
Step 1: Retrieve customization changes
Step 2: Study validity of changes against the new GAS version
Step 3: Merge the changes in new version
Step 4: Test the results of the migration
Template and Snippets Customization Guidelines
Other Merging Tools
Reference
GAS Configuration Reference
Genero Application Server configuration
GAS configuration element listing
Application configuration
Web client application configuration element listing
Web service configuration element listing
The CONFIGURATION element
The APPLICATION_SERVER element
The RESOURCE_LIST element
PLATFORM_INDEPENDENT
RESOURCE
WNT
RESOURCE
UNX
RESOURCE
The COMPONENT_LIST element
xxx_APPLICATION_EXECUTION_COMPONENT
WEB APPLICATION EXECUTION COMPONENT
ENVIRONMENT_VARIABLE
PATH
DVM
WEB_COMPONENT
MODULE
AUTHENTICATION
LIMIT_REQUEST_SIZE
PARAMETERS
ACCESS_CONTROL
ALLOW_FROM
DELEGATE
SERVICE APPLICATION EXECUTION COMPONENT
ENVIRONMENT_VARIABLE
PATH
DVM
MODULE
LIMIT_REQUEST_SIZE
PARAMETERS
ACCESS_CONTROL
DELEGATE
POOL
START
MIN_AVAILABLE
MAX_AVAILABLE
MAX_REQUESTS_PER_DVM
xxx_APPLICATION_TIMEOUT_COMPONENT
WEB APPLICATION TIMEOUT COMPONENT
USER_AGENT
REQUEST_RESULT
DVM_AVAILABLE
DVM_PINGTIMEOUT
SERVICE APPLICATION TIMEOUT COMPONENT
DVM_AVAILABLE
KEEP_ALIVE
WEB_APPLICATION_PICTURE_COMPONENT
PATH
PATH with Type WEBSERVER
PATH with Type APPSERVER
WEB_APPLICATION_RENDERING_COMPONENT
OUTPUT_DRIVER
XML_DECLARATION
HTTP_RESPONSE_ENCODING
HTTP_REQUEST_ENCODING
MIME_TYPE
DOC_TYPE
NAME
EXTERNAL_ID
SYSTEM_ID
WEB_APPLICATION_HTTP_COOKIES_COMPONENT
HTTP_COOKIE
CONSTANT
VARIABLE
WEB_APPLICATION_THEME_COMPONENT
BOOTSTRAP
TEMPLATE
SHORTCUT
SNIPPET
The INTERFACE_TO_CONNECTOR element
TCP_BASE_PORT
TCP_PORT_OFFSET
LIMIT_REQUEST_SIZE
DOCUMENT_ROOT
TEMPORARY_DIRECTORY
SESSION_DIRECTORY
SOCKET_FAMILY
SOCKET_PATH
ERROR_DOCUMENT
The INTERFACE_TO_DVM element
ADDRESS
The LOG element
OUTPUT
FORMAT
CATEGORIES_FILTER
RAW_DATA
The MONITOR element
ALLOW_FROM
The FILE_TRANSFER element
TIMEOUT
The AUTHENTICATION element
REALM
SERVICE_NAME
KEYTAB
The APPLICATION_LIST element
GROUP
APPLICATION
DESCRIPTION
SHORT
LONG
RESOURCE
EXECUTION
OUTPUT
HTTP_HEADER
HTTP_COOKIES / HTTP_COOKIE / VARIABLE / CONSTANT
MAP
PROXY
TIMEOUT
USER_AGENT
REQUEST_RESULT
DVM_AVAILABLE
DVM_PINGTIMEOUT
PICTURE
PATH
PATH with Type WEBSERVER
PATH with Type APPSERVER
RENDERING
OUTPUT_DRIVER
XML_DECLARATION
HTTP_RESPONSE_ENCODING
HTTP_REQUEST_ENCODING
MIME_TYPE
DOC_TYPE
NAME
EXTERNAL_ID
SYSTEM_ID
THEME
BOOTSTRAP
TEMPLATE
SHORTCUT
SNIPPET
The SERVICE_LIST element
The SERVICE_LIST element
GROUP
APPLICATION
DESCRIPTION
SHORT
LONG
RESOURCE
PROXY
EXECUTION
ENVIRONMENT_VARIABLE
PATH
DVM
MODULE
AUTHENTICATION
PARAMETERS
ACCESS_CONTROL
POOL
START
MIN_AVAILABLE
MAX_AVAILABLE
MAX_REQUESTS_PER_DVM
TIMEOUT
DVM_AVAILABLE
KEEP_ALIVE
GWC Template Language Reference
Template Language Reference Overview (for the Snippet-Based Rendering Engine)
Template Instructions
Genero Web Client Namespace
Template Instructions
snippet-root instruction
define instruction
condition instruction
repeat instruction
replace instruction
attributes instruction
content instruction
omit-tag instruction
marks instruction
Template Element Identifiers
Feature description
How to configure it?
Template Expressions
Expressions syntax
Embedded expressions
Template Functions
Conversion Functions
bool()
number()
string()
object()
Logical Functions
for()
switch()
Number Functions
min()
max()
round()
fill()
precision()
abs()
sin()
cos()
tan()
String Functions
escapeJS()
translate()
split()
length()
substring()
contains()
indexOf()
replace()
filterAmpersand()
isnumber()
trim()
prefix()
Front End Protocol Functions
makeScrollOffsetIDID()
makeScrollOffsetXDID()
makePageSizeIDID()
makeRowSelectionIDID()
makeRowSelectionXDID()
makeTableNoSortValue()
makeColumnSortIDID()
makeValueIDID()
makeFocusXDID()
makeFocusIDID()
makeKeyXDID()
makeKeyIDID()
makeProcessingXDID()
combEvents()
makeSessionVarIDID()
Other Functions
XPath()
XPathConfig()
resourceURI()
imageURI()
includeSnippet()
check()
noOp()
colorToRGB()
Template Paths Overview
What is a Template Path?
Template Paths Details
Template Paths - Server hierarchy
The Server object
Template Paths - Document hierarchy
The Document object
The Request object
The Header object
Template Paths - Application hierarchy
The Application object
The ApplicationState object
The Processing object
The Ended object
The EndedError object
The ApplicationMetaInformation object
The ApplicationLaunch object
The FileTransfer object
The File object
The Variable object
The UserInterface object
The StyleList object
The Interrupt object
The DragDropInfo object
The Error object
The FrontCall object
Template Paths - StartMenu hierarchy
The StartMenu object
The StartMenuItem objects
The StartMenuCommand object
The StartMenuGroup object
The StartMenuSeparator object
Template Paths - TopMenu hierarchy
The TopMenu object
The TopMenuItem objects
The TopMenuCommand object
The TopMenuGroup object
The TopMenuSeparator object
Template Paths - Toolbar hierarchy
The Toolbar object
The ToolBarItem objects
The ToolbarCommand object
The ToolBarSeparator object
Template Paths - Window hierarchy
The Window object
The Menu object
The Dialog object
The Form object
The Action object
The LocalAction object
The Idle object
Template Paths - Layout hierarchies
The LayoutContainer objects
The Grid object
The ScrollGrid object
The GridLayout object
The GridLayoutLine object
The GridLayoutTableLine object
The GridLayoutCell object
The Group object
The Folder object
The FolderPage object
The Box object
The Table object
The Table Column object
The Table Row object
The Table Cell object
The TableAction object
Template Paths - Widgets hierarchies
The Grid Elements objects
The Widgets objects
The StaticLabel object
The StaticImage object
The FormField object
The HLine object
The Button object
The HBoxTag object
The HBoxTagCell object
The Common fields
The Label object
The Image object
The Edit object
The ButtonEdit object
The TextEdit object
The DateEdit object
The Slider object
The ComboBox object
The RadioGroup object
The ChoiceItem object
The CheckBox object
The TimeEdit object
The SpinEdit object
The ProgressBar object
The Canvas object
The CanvasItem object
The WebComponent object
The Screen object
The DecorationStyleItem object
The DecorationStylesItem object
The Rectangle object
The Ripbmp object
The Ripbutton object
The Ripcheck object
The Ripcombo object
The Ripfield_bmp object
The Ripgraphic object
The Riplabel object
The Ripradio object
Glossary and Acronyms
Legal Notices
access rights
[1]
ActiveX
[1]
administration
gasadmin
[1]
application
adding a GDCAX application
[1]
application configuration file
creating
[1]
archiver
[1]
back button
[1]
batch programs
[1]
browser
back button
[1]
forward button
[1]
commands
[1]
configuration check
[1]
configuration file
validating
[1]
connector
[1]
database
[1]
configure environment
[1]
debugger
[1]
dispatcher
[1]
configuring multiple
[1]
Environment variable
Set using a script
[1]
FastCGI
[1]
[2]
fastcgidispatch
[1]
fglgar
[1]
fglxslp
[1]
footer
customization and the HTML5 theme
[1]
forward button
[1]
gasadmin
[1]
GDCAX
[1]
gdcproxy
[1]
Genero Desktop Client ActiveX
[1]
Genero Web Client
[1]
GWC
[1]
gwcproxy
[1]
gwsproxy
[1]
header
customization and the HTML5 theme
[1]
HTML5
customizing the footer
[1]
customizing the header
[1]
HTML5 theme
[1]
html5proxy
[1]
httpdispatch
[1]
IIS 6.x
installing the ISAPI dispatcher
[1]
IIS 7.x
installing the ISAPI dispatcher
[1]
images
make available to a web application
[1]
install
FastCGI
[1]
validating with GDC
[1]
validating with GDCAX
[1]
validating with GWC
[1]
ISAPI dispatcher
activate IIS on Windows Server 2012
[1]
configuring IIS 10.x
[1]
configuring IIS 8.x
[1]
finishing the installation
[1]
installing
[1]
installing on IIS 6.x
[1]
installing on IIS 7.x
[1]
Installing with Microsoft Installer
[1]
java-j2eedispatch
[1]
Kerberos
[1]
license
[1]
load balancing
[1]
logging
[1]
monitoring
[1]
OpenID
[1]
operating system
[1]
SAML
[1]
SBRE
[1]
Security Assertion Markup Language
[1]
single sign-on
[1]
tutorial
[1]
snippet-based rendering engine
[1]
SPDY
[1]
SSO
[1]
tutorial
[1]
standalone dispatcher
[1]
style
allowWebSelection
[1]
system requirements
[1]
Business Development Language
[1]
database
[1]
operating system
[1]
user agent
[1]
virtual machine
[1]
Web server
[1]
tools
[1]
troubleshooting
[1]
application does not start
[1]
browser cannot open 127.0.0.1 or localhost
[1]
proxy errors
[1]
tuning
[1]
user agent
[1]
virtual machine
[1]
Web server
[1]
xsltproc
[1]
Your browser does not support iframes.