CorporateTime for the Web 3.0 Administrator's Guide

Default settings

• [extiteminfo]
• [limits]
• [admin]
• [ACE]
• [href]
• [pref_attr]
• [taskview]
• [calendar_view]
• [cookies]
• [Sync]
• [system]

[extiteminfo]

Setting the location of character set conversion maps

Parameter

charmappath

Description

Sets the location of the character set conversion maps.

Accepted values

Any valid directory path.

Default values

./etc/charset

[limits]

Setting the maximum number of favourite Agendas

Parameter

maxfavourite

Description

Sets the maximum number of favourite Agendas a user is able to maintain. This section and its accompanying parameter are commented out by default in webcal.ini.

Accepted values

Any number from 0 to 15.

Default values

15

Limiting the maximum number of Groups owned by a user

Parameter

max_group_per_user

Description

Limits the number of Groups a user may own. The maximum number is 20.

Accepted values

Any value between 0 and 20.

Default values

10

Limiting the maximum number of Tasks a user can print

Parameter

tv_max_num_tasks

Description

Limits the number of Tasks a user can print.

Accepted values

Any value between 1 and 1000.

Default values

100

---

[admin]

Setting a time length before session timeout

Parameter

ssn_timeout

Description

Sets the number of minutes of inactivity CorporateTime for the Web permits before a user session times out.

Accepted values

Any positive integer.

Default values

15

Setting a default directory path for images

Parameter

img_path

Description

Sets the directory path to your images.

Accepted values

Any directory path.

Default values

<htdocs>/swc/images/<language-dir>

Setting secure error messages for authentication

Parameter

secure_login

Description

Controls the security level of the error message generated on the sign-in page. Choose from either a secure mode or a user-friendly mode that provides specific information about the authentication failure. This parameter overrides the server-side parameter [LIMITS] secure-login in unison.ini.

Action	Secure error-message mode	User-friendly error-message mode
Invalid user ID	Authentication failed.	The system found no matches for the given search string.
Invalid password	Authentication failed.	The password you entered is incorrect.

If the secure error-message mode is enabled, the administrator is advised to set [sched] userlist_login to FALSE (Providing a list of possible sign-in matches) to provide a truly secure sign-in for users.

Accepted values

TRUE (secure mode)

FALSE (user-friendly mode)

Default values

TRUE

Choosing a timeout value after failed sign-ins

Parameter

login_fail_timeout

Description

Allows you to specify the amount of time a user is denied access to CorporateTime for the Web if she or he has reached the maximum number of sign-in attempts. This parameter is commented out by default.

Accepted values

Any number.

Default values

0

---

[ACE]

Choosing ACE mechanisms for CorporateTime for the Web

Parameters

authentication, compression, encryption

Description

Set a default authentication, compression or encryption method. If you do not specify a value, CorporateTime for the Web will use the server-defined default.

---

Configuring your calendar system to use Web-based certificate authentication

CorporateTime for the Web 3.0 provides the ability to authenticate users with the calendar server using Web-based mechanisms, allowing users to access their calendar data without formally signing in to the Web Calendar. Instead, the system employs a plug-in (aut_web) to identify calendar users by reading the appropriate environment variables passed by the authentication module on your Apache Server. Please consult the aut_web plug-in documentation for full instructions on how to configure this feature.

This feature requires CorporateTime Server 5.1 or later.

[ACE_PLUGINS_CLIENT]

Setting a shared key for certificate authentication

Parameter

web_cal_sharedkey

Description

Defines the shared key to be used by the aut_web plug-in. Make sure this value is the same as the one specified in the [ACE_PLUGINS_SERVER] section of unison.ini.

Accepted values

Any text string.

Setting an attribute name to match the SSL environment variable

Parameter

web_attribute_name

Description

Specifies the value that matches the environment variable used by the Web server to provide the user's calendar user ID. For example:

web_attribute_name = SSL_CLIENT_S_DN_UID

Setting an attribute type for the SSL environment variable

Parameter

web_attribute_type

Description

Defines the attribute of the environment variable specified by web_attribute_name. Only the userid attribute type is currently supported.

Accepted values

userid

Setting a directory for error logs

Parameter

web_logfile

Description

Defines the path to the log file used to generate errors and warnings.

Accepted values

Any valid path.

---

[href]

Choosing a link for synchronizing a PDA with CorporateTime for the Web

Parameter

pda_sync_url

Description

Specifies a URL for the PDA Agenda Sync option on the Toolbar.

Accepted values

Any URL.

Default values

ftp://ftp.steltor.com

Redirecting a user after session timeout

Parameter

login_page_url

Description

Redirects a user to the URL of your choice if the user times out during a session. It is commented out in the webcal.ini.

Accepted values

Any valid URL (complete with http://).

Default values

http://www.steltor.com

Appending the originating URL to the sign-in page

Parameter

login_return_param

Description

Appends the originating URL to login_page_url whenever it is called by the application. The originating URL is encoded and is automatically assigned by CorporateTime for the Web.

Accepted values

N/A

Default values

No value

Setting a page for failed sign-in

Parameter

login_fail_url

Description

Provides a separate redirect page for failed sign-ins. Commented out by default.

Accepted values

Any valid URL

Default values

/swc/images/<language-dir>/login_fail.htm

Redirecting invalid sign-in attempts

To set the maximum number of sign-in attempts, use the signinmaxattempts parameter found in the [LIMITS] section of unison.ini (the default is 5). Use the following two parameters to redirect users to another page if they have reached the maximum number of sign-in attempts.

Parameter

max_login_attempts_url

Description

Allows you to redirect a user to a URL of your choice if the user has reached the maximum permitted number of sign-in attempts. A default HTML file is provided in the package.

Accepted values

Any valid HTML file path.

Default values

The HTML file provided in the package (relative to the language-specific images directory).

Parameter

max_quiet_login_attempts_url

Description

Allows you to redirect a user to a URL of your choice if the user has reached the maximum permitted number of sign-in attempts. Use this parameter only if you have quiet sign-in enabled (see Quiet sign-in for more information).

Accepted values

Any valid HTML file path.

Default values

The HTML file provided in the package (relative to the language-specific images directory).

---

[pref_attr]

Setting default viewing states for preferences

Parameters

• mobile_phone (mobile device number)
• smsc_phone (preferred service center number)
• autolog (automatic sign-in)

Description

Makes certain preferences read-only or hidden when a user accesses the Preferences page of the Web Calendar. These parameters are commented out by default.

Accepted values

read_only (user can view the setting but cannot modify it)

hidden (user cannot view the setting)

normal (user can view and modify the setting)

Default values

None

---

[taskview]

Setting a start time for the Quick Create Task option

Parameter

quickCreateStartTime

Description

Defines the start time for the Quick Create Task option available from the Task View. The time cannot be later than the value defined in quickCreateEndTime.

Accepted values

Any hourly value in 24-hour format

Default values

9 (9:00 a.m.)

Setting an end time for the Quick Create Task option

Parameter

quickCreateEndTime

Description

Defines the end time for the Quick Create Task option available from the Task View. The time cannot be earlier than the time defined in quickCreateStartTime.

Accepted values

Any hourly value in 24-hour format

Default values

18 (6:00 p.m.)

9 (9:00 a.m.)

Displaying the Quick Create completion option

Parameter

showQCCompletion

Description

Defines the end time for the Quick Create Task option available from the Task View. The time cannot be earlier than the time defined in quickCreateStartTime.

Accepted values

TRUE (enables the feature)

FALSE (disables the feature)

Default values

TRUE

---

[calendar_view]

Setting a default view for the application

Parameter

default_view

Description

Sets the default view when signing in to CorporateTime for the Web.

Accepted values

1 (Day View: Daily List)

2 (Week View)

3 (Month View)

4 (Day View: Daily Planner)

Default values

4

Setting a default viewing mode for the Daily Agenda

Parameter

default_dayview_mode

Description

Sets the default viewing mode when a user opens the Daily Agenda.

Accepted values

1 (Daily List)

2 (Daily Planner)

Default values

1

Default values

FALSE

Choosing a location for displaying Tasks, Daily Notes and Day Events in the Daily Planner

Parameter

pdv_notes_top_task_bottom

Description

When set to TRUE, this parameter displays Daily Notes and Day Events at the top of the Daily Planner and Tasks at the bottom of the view. When set to FALSE, it displays Daily Notes and Day Events at the bottom of the Daily Planner and Tasks at the top of the view. This parameter is commented out by default.

Accepted values

TRUE or FALSE

Default values

TRUE

Choosing a start time for the Daily Planner grid

Parameter

pdv_grid_start_time

Description

Sets a start time for the display grid in the Daily Planner. This parameter is commented out by default.

Accepted values

Any time, provided it is not greater than the value provided in pdv_grid_end_time.

Default values

7 (a.m.)

Choosing an end time for the Daily Planner grid

Parameter

pdv_grid_end_time

Description

Sets an end time for the display grid in the Daily Planner. This parameter is commented out by default.

Accepted values

Any time, provided it is not less than the value provided in pdv_grid_start_time.

Default values

18 (6:00 p.m.)

---

[cookies]

Setting a domain name for http cookies

Parameter

domain

Description

Sets domain information for cookies generated by CorporateTime for the Web. The path must be identical on all hosts. This parameter is commented out by default.

Accepted values

Any path.

Default values

.yourdomain.com (placeholder)

[Sync]

Controlling host name display on the Preferences page

Parameter

enable

Description

Determines whether the host name and node information in the Edit Preferences section of the application is displayed to users. Commented out by default in webcal.ini.

Accepted values

TRUE (displays information)

FALSE (hides information)

Default values

FALSE

Choosing a host name to display on the Preferences page

Parameter

hostname

Description

The host name that appears in the Edit Preferences of the web application. Will only be visible to users if the parameter enable is set to TRUE. Commented out by default in webcal.ini.

Accepted values

Any string.

Default values

N/A

[system]

Choosing a connection type for the application

Parameter

connection

Description

Controls whether the master node setup for CorporateTime for the Web is used.

Accepted values

masternode (use master node setup)

traditional (use traditional non-connected node setup)

Default values

traditional

[download_extension]

Setting file types for downloading attachments

Use this section to specify which types of files users can be download. You must include a mime type for each file extension. For example:

.wav = audio/wav
.doc = application/msword
.txt = text/plain
.html = text/html

Optionally, associate a different icon for each file extension. If you do not associate an icon with a file extension, the default icon (paper clip) appears. For example:

.wav = audio/wav, wav.gif
.doc = application/msword, doc.gif

Note: Make sure your icon paths are relative to your htdocs directory.