1. The Administration Console

All aspects of Report Launch application and its settings are created, updated, and edited through the Administration Console. The administration console can be accessed through the following URL: 

http://\{localhost}:{port}/launch/administration/ 

The above link will bring up the following login page:


  • User Name: See Operations Team
  • Password: See Operations Team



2. Adding a new Application

Each installation of Report Launch can support one or more Applications, or AppNames. To create a new Application, follow the link for Add Application. Once selected, you will be presented with the following screen. 




 Application configuration settings that appear on the application configuration page can be broken down in three categories: 

1) BOE Connectivity, 

2) Database Connectivity, 

3) General Preferences. 


Descriptions for the above settings are defined below: 


Application Setting
 
Description
Application Name

The name of the application (i.e. profile) for this implementation. This can be given any name in a multiple implementation environment. Appending this name to the url calling the dashboard login (e.g.
http://\{servername}/launch/dashboard?AppName={application}) will cause the dashboard to use the preferences defined below.
Web Server Name
BOE Connectivity
Fully qualified BOE server location (e.g.
http://100-abcde-001:8080.company.net
CMS Name
BOE Connectivity
The name of the BOE server Report Launch connects to
CMS Web Server Port
BOE Connectivity
Not used for Report Launch
CMS Admin ID
BOE Connectivity
The BOE Administrator ID.
CMS Admin Password
BOE Connectivity
The BOE Administrator password.
CMS Application ID
BOE Connectivity
The default BOE user ID.
CMS Application Password
BOE Connectivity
The default BOE user's password.
Database Type
DB Connectivity
The DBMS, database server, database port, name, and credentials used to connect to the Report Launch database
Database Server
DB Connectivity
 
Database Port
DB Connectivity
 
Database Name
DB Connectivity
 
Database User ID
DB Connectivity
 
Database User Password
DB Connectivity
 
Application Logo File
General Preference
The logo file (jpg, png, or gif) to be displayed on the Report Launch login screen and dashboard pages.
Application Logo Height
General Preference
(Optional) the dimension setting used to resize the logo file. (common settings: Height 70/Width 210)
Application Logo Width
General Preference
 
Default Report Viewer
HTML , Word, Excel, Pdf, Csv, DHTML, Scheduler, Active X Viewer

General Preference
Default report viewer types
Add CSS File
General Preference
The cascading style sheet to be used for the appearance of the report list on the Reports tab. (See notes under CSS Files section below)
Images Directory URL
General Preference
The location of images (primarily the logo file) used by Report Launch.
Parameter Start Index
General Preference
Start index of Crystal Report parameter. By default the index starts at 0. E.g. If this value is set to 2, first 2 parameters will be skipped in parameter screen
Enable/Disable Save Parameter Set
General Preference
Allow the Save/Retrieve Parameters set feature to be turned on/off.
Enable/Disable Popup Viewer
General Preference
Allow the report prompt/execution screen to be either show up in a separate popup page or the same page. This should be set as unchecked for Ion
Enable/Disable Custom Flag(Stored Procedure String)
General Preference
Used to store procedure string key value pair string. This option is not applicable for Ion
Enable/Disable Instance Deletion
General Preference
Ability delete items from history screen; options to turn on/off. This should be set as unchecked for Ion
History Refresh (in milliseconds)
General Preference
History screen refresh rate
Submit Report Shortkey Key (Ctrl + key)
General Preference
Shortcut for submitting the report - Ctrl + <configurable key>
Enable/Disable Legend
General Preference
Allows the Legend on the Reports tab to be hidden.
Show/Hide Report Icons
General Preference
This section allows shortcut icons on the Reports tab to be hidden.


3. Application Attributes


Once the Application is created and the required settings for the Business Objects environment, Database information, and general setting have been entered, additional Application Attributes can be entered. 



Application attributes are additional settings of an application attribute that control the behaviour of various aspects of the Launch application. Application attributes consist of name-value pairs and can be accessed via the More Attributes link of the Application Configuration page.


3.1 Global Settings Attributes



Attribute Name
Value(s)
Description
allow_app_change
Y/N
Determines whether the application can change to another once it has been set. Setting this to Y is useful in environments where users may switch between applications (i.e implementations of Launch) during the same browser session.
License_date
(Encrypted)
(Encrypted) Defines the expiration date of the launch application based on licensing.
boe_license_mode
non-optimized/optimized
Enabling BOLO (Business Objects License Optimization) will minimize concurrent user sessions by managing sessions only when serve resources are needed
Mobile_app
Y/N
defines whether Launch should modify its interface for mobile devices
Mobile_Tabs
(Tab Names from Dashboard Admin)
A list of the available tabs for mobile access
Mobile_webroot
URL
Root URL for mobile applications
time_out_page
URL
The web page to use when a user logs off or the application times out.
User_error_page
URL
The web page to use when a user error occurs
Timeout_period
numeric value
Defines the number of minutes before the application times out.
Dashboard_launch_ajax
Y/N
Option for cached Ajax tabs. Setting this option to Y will cache each tab per session keeping the tabs from having to reload as users navigate to and from tabs.
Dl_supress_singletablabel
Y/N
Suppresses a single minor tab when > 2 minor tabs exist for a given major Tab. This is a cosmetic display option.
Video_folder
Folder Name (e.g. media)
The defined folder for hosting videos
Domain_fodler
Folder name
Main folder of Scorecard Uploading in Business Objects.
Domain_Value
User Defined
This value is used to retrieve client specific domain value; Since all query values passed to reports.jsp are stored in session, this is a flexible way to retrieve domain value without using the keyword "domain"
Forgotten_password_link
Url
Defined link for a forgotten password
History_archive
Date
Metric for Archiving (Scorecards) This option allows the newest Scorecard to display on the main scorecard screen, and any older versions to populate
History_filter
none/user
Used to determine whether the history is restricted to the user that created the instance or all users. None = all users, user = only user access
Webroot
/launch
Root folder for all dashboard/template page calls. Most often, this will be the install folder under webapps/.
error_page_back_button
Y/N
Determines whether or not the application shows an back button on an error page.
App_logo_location
URL
For dynamic logo type, this location is used as a base URL
App_logo_type
Static/Dynamic
Flag that specified whether Dashboard logo is static or dynamic
approot
Launch (unless installed under another name i.e. reportlaunch)
Application root folder
Back_page
URL
External or relative URL of when custom back button is pressed
Dashboard_header_height_direct
Numeric (best practices is 105)
Dashboard Header Height in Pixels
dl_default_group
"group name"
Utilizes a default group for dashboard display. Logic determines which dashboard/tabs are used for the user if no valid groups are found.
url_domain
xxxxxxx.com
Defined URL name for embedded content pages (LaunchPages setting)
Parent_group
"group name"
Parent BO group that will determine where the domain groups will be found.
auth_mode
roleid,
default,
sfdc,
oauth,
ping,
saml
session

Sets the application's user authentication mode. If left blank, default mode is enforced.

roleid - userID is passed as a 64-bit encoded url parameter.
default - user enters BOE userID and password on application logon page.
sfdc - authenticates with SalesForce.com application using url parameters "SfdcSessionId" and "SfdcUrl". User's SFDC FederationID must match their BOE userID.
oauth - authenticate with SFDC via OAuth protocol. See "LaunchWorks SalesForce Configuration Guide" for additional configuration.
ping - authenticate with Ping Identity server
saml - allows userID to be passed via SAML protocol
session - database level coordination, roleid is passed at database level via a just-in-time key to a database record containing any variables needed for authentication, hidden prompts, domain based security, etc.

schedule_to_disk_server
Name of Server to Export Crystal Reports
Used only in ScheduleReportExternalCrystal.jsp. The name of the Windows server written to when Destination parameter = Disk. Should be used in conjunction with "Filepath" parameter to build the UNC file path.



3.2 Report List Attributes

Attribute Name
Value(s)
Description
burst_folder
Folder Name
Identifies the folder in a report list that contains burst instances. A folder identified as the burst folder will display burst instances found in that folder instead of standard report objects. This can be used in parallel with standard reporting.
Burst_type
Launch
Uses domain awareness to link "burst" instances that contain the domain name to a logged in users (domain).
Schedule_from_address
Email address
From address for email delivery for scheduled reports
custom_folder_sort
e.g. ")" (if folders are named "1), 2), 3)" etc.
Used by some Report List templates to define the prefix delimiter used to prefix folder names for the purpose of custom sorting the folders in the Report List page. Launch removes the prefix including the delimiter when the folder is displayed.
Refresh_personal_reports
Y/N
Controls whether reports in a user's Personal (favorites) folder are automatically refreshed or not. Refreshed by Default
report_list_cache
Y/N
Defines whether the Report List page is cached to improve performance. Setting to Y will prevent the Reports List page from reflecting real-time changes to BOE folder content during a browser session. Default is N
reports_page
the name of the .jsp file in the Launch templates sub-folder
Defines the report template to be used for the report list page.
Root_category
BO Category
Determines under what Parent Category group, user defined categories will reside. Used as part of LW Report category security.
Root_folder
BOE Folder Name
Defines the BOE folder whose contents (including subfolders) are displayed in the Launch report list
show_root_folder
Y/N
Defines whether the root folder should appear or not in the Report List page/Parameter Administration page. If the root folder is hidden, any report objects in that folder are also hidden.