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. |