GENF4720 - System Web Control

Purpose

To define System Web Control Items and assign control values to them.

Subsystem

General

Normally Run By System Specialist
Anticipated Frequency As required
Structure  Block System Web Control

  

Callista system configuration items for ADF and web services are stored in the S_WEB_CONTROL table and can be viewed or maintained in this form (GENF4720).

The system configuration items ('System Web Control items') configurable in this form are described below.

More information can be found in the following Callista Technical information in the Callista Product Centre - wiki.callista.com.au/display/CPC.

  • Callista ADF Security
  • Callista ADF
  • Callista Web Services

 

ADF System Web Control Items:

  • The ADF_POLICY_URL_0 property is an important component of the security infrastructure.
    (See the ADF Security technical information for complete instructions on setting up the security infrastructure.)

  • To allow ADF pages to be called from the Forms menu, the WEB_RESOURCE_URL value must be set to the URL of the target application. For example, http://crux.callista.com.au:8180/CallistaSMS/faces/smsHome

  • MENU STYLE determines the style of menu displayed in ADF. See the 'To Change the ADF Menu Style' section, below.

  • The TAB_ONLY_MODE value should be set to Y to allow multiple tabs to be available in user sessions.

  • The following values can be updated in GENW0050.

    • SYSTEM_WIDE_LOGGING_LEVEL
    • ORACLE_BUSINESS_COMPONENTS_LOGGING_LEVEL
    • CALLISTA_SOFTWARE_LOGGING_LEVEL
    • SEND_APP_LOG_TO_WEBLOGIC_SERVER_LOG_FILE
    • SEND_APP_LOG_TO_EXTERNAL_LOG_FILE
    • EXTERNAL_LOG_FILE_LOCATION

Note: If these items are modified directly in GENF4720, then the Callista SMS application will require a re-start for any changes to be applied. If the changes are applied in the ADF page GENW0050 then no re-starts are necessary.

  • DISPLAY_MSG_DIALOGUES_INLINE should be set to Y. This allows any error messages to be displayed within the page in which they are generated, rather than as a pop-up.

  • GOTO_SEARCH_HINT is the text that is displayed in the Search field in the ADF page header.

  • DATABASE_DISPLAY_NAME is the database name that displays with the greeting in the ADF page header.

  • For USE_CUSTOM_HOME_PAGE: Control Value = Y to use a customised Home Page and N otherwise.

  • For USE_CUSTOM_LOGIN_PAGE: Control Value = Y to use a customised Login Page and N otherwise.

  • HELP_BASE_URL is the base URL to access ADF Help pages.

  • If DASHBOARD_MODE= Y (default value), widgets can be displayed in the ADF home page. (See the Callista ADF Screen Online Help page for more information.)

 

Web Services (WS) System Web Control Items:

  • WS_ACCEPT_END_USERNAME - Enter Y or N to indicate whether or not to accept a user-defined web service end-user username in the HTTP header of the web service. This will be the person (i.e. end user) who accesses the web service or the application owner (e.g. institution). The Callista SMS Person ID of the end username recorded in the HTTP header (or the application user's Person ID) is recorded in the update_who audit field of the database table.

    Allowable values are: ‘Y’ and ‘N’. The default value is 'N'.
    (Note: This value can be overridden by an 'Accept WS End User' value specified at the Person (SECF0097) or Role (SECF0099) security level.)

    If 'WS ACCEPT_END_USER' is set to Y, then the web service end-user username must be mapped to a Callista SMS Person ID in order to run a web service. This is configured in the LDAP Configuration (SECF0100) form, in the SMS Identifier and WS End User Identifier fields.

  • WS_ACCESS_LOGGING_LEVEL – Specifies whether activity logging will occur for web services, and the logging level that is to be captured from web service Requests and Responses. Data is written to the S_WS_ACCESS_LOG table in the database.
    Allowable values are:
    • REQ (Request) - captures web service Request information (i.e. Insert, update, or get).
    • RESP (Response) - captures web service Response information.
    • ALL - captures both REQ and RESP information.
    • NONE (the default value) - no logging will occur.

A value in the 'Override System WS Access Logging Level' field in the 'Person Web Service Method Grant' (SECF0097) or 'Security Role Web Service Method Grant' (SECF0099) forms overrides the WS_ACCESS_LOGGING_LEVEL value specified in this form (GENF4720).
Note: An 'Override System WS Access Logging Level' value specified at the Person level in SECF0097 overrides a value specified at the Role level in SECF0099.

If an end user has access to web services via multiple Roles (SECF0099), the highest logging setting is used. Ranking hierarchy is ALL, REQ, RESP, or NONE. For example, if the settings are NONE and RESP, then RESP applies. If there are settings for both REQ and RESP, assume ALL.

  • WS_END_USERNAME_HTTP_HEADER - Allows a user-defined (institution-defined) end user attribute name to be passed in as an HTTP header of the web service. The default value is: 'ws_end_username'.

    Note: In addition, the WS_ACCEPT_END_USERNAME control item must be set to Y.

For more information, see Web Services, and the Web Services Security technical documentation in the Callista Product Centre - wiki.callista.com.au/display/CPC.

Notes:

 

 

To Change the ADF Menu Style:

  • Go to the GENF4720 SMS form.
  • Update the MENU_STYLE value to any of the five styles listed, then save the changes.
  • Log into ADF and open the GENW0070 – 'Web Resource Customisation' page.
  • Click the 'Clear Cache' button.
  • Log out of ADF.
  • Log back into ADF and you will see the updated menu style.
    Note: The menu style is environment-wide, i.e. all users will have the same menu style.

Rules/Notes:

Callista currently supports five menu styles:

  • HORIZONTAL_FULL_GRADIENT_BAR
  • HORIZONTAL_ROUNDED_CORNERS
  • VERTICAL_FULL_GRADIENT_BAR
  • VERTICAL_GRADIENT_TREE (Default style delivered by Callista)
  • VERTICAL_TEXT_TREE

 

 


Last Modified on 04-Jun-2009 3:16 PM

History Information

Release Version Project Change to Document
17.1 2010 - API Improvement (Security) Added new Web Service System Items & updated Tech. documentation.
17.0 2013 - User Interface Consolidation Added information for Dashboard
15.0 1747- 11g Product Structure New page