Table Of Contents

TimeCardView Commands

copy timecardview timesheets url

daily

database purge schedule days

disable (TimeCardView user configuration mode)

enable (TimeCardView configuration mode)

enable (TimeCardView user configuration mode)

groupname tcv-payroll-specialists

groupname tcv-payroll-specialists privilege tcv-payroll

maxsessions

notification email address

payroll server quickbooks address

payroll server synchronization schedule

service timecardview

service timecardview purge now

service timecardview session terminate

service timecardview synchronize now

session-expiry-time

shift limit

show supervisor

show supervisors

show timecardview configuration

show timecardview sessions

show timecardview status

show timecardview users

show user detail username

show user supervisor username

timecardview username

user-interface phone-call

user-interface phone-service

username

username (epage)

week-start day

TimeCardView Commands

---

First published: January 2009
Revised: January 22, 2009

This guide contains TimeCardView configuration mode commands, and also Cisco Unity Express commands that are relevant to TimeCardView.

copy timecardview timesheets url

daily

database purge schedule days

disable (TimeCardView user configuration mode)

enable (TimeCardView configuration mode)

enable (TimeCardView user configuration mode)

groupname tcv-payroll-specialists

groupname tcv-payroll-specialists privilege tcv-payroll

maxsessions

notification email address

payroll server quickbooks address

payroll server synchronization schedule

service timecardview

service timecardview purge now

service timecardview session terminate

service timecardview synchronize now

session-expiry-time

shift limit

show supervisor

show supervisors

show timecardview configuration

show timecardview sessions

show timecardview status

show timecardview users

show user detail username

show user supervisor username

timecardview username

user-interface phone-call

user-interface phone-service

username

username (epage)

week-start day

copy timecardview timesheets url

To create a comma-separated values (CSV) file and copy it to an FTP server for later processing, use the copy timecardview timesheets url command in Cisco Unity Express EXEC mode.

copy timecardview timesheets url url

Syntax Description

url url

Quoted Universal Resource Location, for example, "ftp://ftp.nowhere.com/dir/filename".

Command Default

This command has no default value.

Command Modes

Cisco Unity Express EXEC (#)

Command History

Cisco Unity Express Version	Modification
7.0	This command was introduced on the Cisco Unity Express network module.

Usage Guidelines

After you enter this command, unless your FTP server accepts anonymous login, it prompts you first for username and then for password.

You can customize this CSV file to create new types of timesheet reports. It contains the following fields:

•Employee user-id

•Work date

•Work duration (hh:mm:ss)

•Lunch duration (hh:mm:ss)

•Break duration (hh:mm:ss)

•Overtime duration (hh:mm:ss)

•Approved

•Approved time

•Approver user-id

•Modification time

•Remarks

•Synced

Examples

The following example illustrates copying timesheets to an FTP server:

se-10-0-0-0# copy timecardview timesheets url ftp://ftp.nowhere.com/dir/

username: user

password: pword

  % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current

                                 Dload  Upload   Total   Spent    Left  Speed

  0    24    0     0    0    24      0     64 --:--:-- --:--:-- --:--:--     0

se-10-0-0-0# 

Related Commands

Command	Description
daily	Limits the number of regular and overtime hours TimeCardView users can work.
shift limit	Limits the amount of time TimeCardView users can spend in the work, lunch, and break states.
show timecardview configuration	Displays TimeCardView configuration.
show timecardview users	Displays the TimeCardView users.

daily

To limit the number of regular and overtime hours per day employees can work, use the daily command in TimeCardView configuration mode. Use the no form of this command to remove any limitations on employees' regular and overtime hours.

daily { working-duration minutes 1-1440 | overtime-duration minutes 0-1440 }

Syntax Description

overtime-duration minutes 0-1440	Maximum number of overtime minutes employees are allowed to work.
working-duration minutes 1-1440	Maximum number of regular minutes employees are allowed to work.

Command Default

Employees can work up to 24 regular and 0 overtime hours per day.

Command Modes

TimeCardView configuration (config-timecardview)

Command History

TimeCardView Version	Modification
7.0	This command was introduced.

Usage Guidelines

If you do not set either of these parameters, employees can work up to 24 hours per day; however, the system logs all their hours as regular hours.

If an employee does not log out before reaching the limit, the system locks that person's status so that he or she cannot log in again to change their status. Only the employee's supervisor can unlock the person's account.

If you limit the number of regular hours employees can work and set a limit of zero on their overtime hours (range: 0-24 hours), they cannot accrue overtime.

If you limit the number of regular hours employees can work and do not set a limit on their overtime, they will automatically start to accrue overtime when they exceed their regular working hours.

Examples

The following example illustrates setting working and overtime hours:

se-10-0-0-0# config t

Enter configuration commands, one per line.  End with CNTL/Z.

se-10-0-0-0(config)# service timecardview

se-10-0-0-0(config-timecardview)# daily working-duration minutes 1300

se-10-0-0-0(config-timecardview)# daily overtime-duration minutes 90

se-10-0-0-0(config-timecardview)# end

se-10-0-0-0(config)# end

se-10-0-0-0# show timecardview configuration

[...]Maximum Daily Working Duration (mins): 1300

Maximum Daily Overtime Duration (mins): 90

[...]

se-10-0-0-0#

Related Commands

Command	Description
copy timecardview timesheets url	Creates a comma-separated values (CSV) file and copies it to an FTP server.
service timecardview	Enters TimeCardView configuration mode.
shift limit	Limits the amount of time TimeCardView users can spend in the work, lunch, and break states.
show timecardview configuration	Displays TimeCardView configuration,

database purge schedule days

To configure the TimeCardView database purge schedule and the minimum number of days to keep data, use the database purge schedule days command in TimeCardView configuration mode.

database purge schedule days 1-365 days-to-keep 0-364

Syntax Description

days 1-365	Number of days between purges.
days-to-keep 0-364	Minimum number of days to keep data. This number is always less than the number of days between purges.

Command Default

TimeCardView purges its database every 90 days.

TimeCardView keeps its data for 30 days.

Command Modes

TimeCardView configuration (config-timecardview)

Command History

TimeCardView Version	Modification
7.0	This command was introduced.

Usage Guidelines

•TimeCardView purges itself when it overruns its maximum capacity or when it is scheduled to purge, whichever comes first.

•The system checks its database every day at 11:30 p.m. When its database reaches 70% of its capacity, it sends notification e-mails if configured to do so, and does so again when it reaches 80%, and again when it reaches 85% capacity. If the database reaches 90% capacity, the system deletes the oldest 70% of the records, keeping the most recent 20%.

•Because purging is likely to be time-consuming, the system performs this task in the background. To view the progress of a purge, use the show timecardview status command.

---

Note You can also purge TimeCardView data manually using the service timecardview purge now command.

---

Examples

The following example illustrates setting the number of days between purges and the minimum number of days data is to be kept.

se-10-0-0-0# config t

Enter configuration commands, one per line.  End with CNTL/Z.

se-10-0-0-0(config)# service timecardview

se-10-0-0-0(config-timecardview)# database schedule days 90 days-to-keep 30

se-10-0-0-0(config-timecardview)# end

se-10-0-0-0(config)# end

se-10-0-0-0# show timecardview configuration

[...]

Purge Cycle (days): 90

Purge Days-to-Keep (days): 30

Purge Time: 00:30

[...]

Notification Email(s): 

se-10-0-0-0#

Related Commands

Command	Description
copy timecardview timesheets url	Creates a comma-separated values (CSV) file and copies it to an FTP server.
notification email address	Configures TimeCardView to automatically notify specified e-mail recipients when certain database usage threshholds are reached and when database purges occur.
service timecardview	Enters TimeCardView configuration mode.
service timecardview purge now	Executes an immediate purge of the TimeCardView database.
show timecardview configuration	Displays TimeCardView configuration.
show timecardview status	Displays TimeCardView status.

disable (TimeCardView user configuration mode)

To disable the TimeCardView service for an individual user, use the disable command in TimeCardView user configuration mode.

disable

Syntax Description

This command has no arguments or keywords.

Command Default

TimeCardView service to individual Cisco Unity Express subscribers is disabled by default.

TimeCardView service to employees imported from Intuit's QuickBooks is enabled by default.

Command Modes

TimeCardView user configuration (config-tvuser)

Command History

TimeCardView Version	Modification
7.0	This command was introduced.

Usage Guidelines

Although TimeCardView is globally enabled by default, to add a Cisco Unity Express subscriber to the TimeCardView users, you must enable him or her individually.

You do not need to individually enable TimeCardView users imported from QuickBooks. You can, however, disable them (and then re-enable them).

Examples

The following example illustrates disabling the TimeCardView service for an individual user specified by his or her Cisco Unity Express user ID:

se-10-0-0-0# config t

Enter configuration commands, one per line.  End with CNTL/Z.

se-10-0-0-0(config)# timecardview username theirname1

se-10-0-0-0(config-tvuser)# disable

se-10-0-0-0(config-tvuser)# end

se-10-0-0-0(config)# end

se-10-0-0-0# show timecardview users

theirname1              [Disabled]

1 total timecardview user(s)

se-10-0-0-0#

Related Commands

Command	Description
enable (TimeCardView user configuration mode)	Enables the TimeCardView service for individuals.
show timecardview users	Displays the list of TimeCardView users.
timecardview username	Specifies either the individual for whom the TimeCardView service is to be enabled or disabled, or the TimeCardView user who is to be deleted.

enable (TimeCardView configuration mode)

To globally enable the TimeCardView service for all users, use the enable command in TimeCardView configuration mode. To globally disable the TimeCardView service for all users, use the no form of this command in TimeCardView configuration mode.

enable

no enable

Syntax Description

This command has no arguments or keywords.

Command Default

After installation and activation on the Cisco NME-CUE, TimeCardView is globally globally enabled by default.

Command Modes

TimeCardView configuration (config-timecardview)

Command History

TimeCardView Version	Modification
7.0	This command was introduced.

Usage Guidelines

After executing an immediate purge of the TimeCardView database, you must enable the service globally.

Examples

The following example illustrates globally enabling the TimeCardView service:

se-10-0-0-0# config t

Enter configuration commands, one per line.  End with CNTL/Z.

se-10-0-0-0(config)# service timecardview

se-10-0-0-0(config-timecardview)# enable

se-10-0-0-0(config-timecardview)# end

se-10-0-0-0(config)# end

se-10-0-0-0# show timecardview status

Service: Enabled

Related Commands

Command	Description
service timecardview	Enters TimeCardView configuration mode.
service timecardview purge now	Executes an immediate purge of the TimeCardView database.
show timecardview status	Displays TimeCardView status.

enable (TimeCardView user configuration mode)

To enable the TimeCardView service for an individual user, use the enable command in TimeCardView user configuration mode.

enable

Syntax Description

This command has no arguments or keywords.

Command Default

TimeCardView service to individual Cisco Unity Express subscribers is disabled by default.

TimeCardView service to employees imported from Intuit's QuickBooks is enabled by default.

Command Modes

TimeCardView user configuration mode (config-tvuser)

Command History

TimeCardView Version	Modification
7.0	This command was introduced.

Usage Guidelines

Although TimeCardView is globally enabled by default, to add a Cisco Unity Express subscriber to the TimeCardView users, you must enable him or her individually.

You do not need to individually enable TimeCardView users imported from QuickBooks. You can, however, disable them (and then re-enable them).

Examples

The following example illustrates enabling the TimeCardView service for an individual user:

se-10-0-0-0# config t

Enter configuration commands, one per line.  End with CNTL/Z.

se-10-0-0-0(config)# timecardview username theirname1

se-10-0-0-0(config-tvuser)# enable

se-10-0-0-0(config-tvuser)# end

se-10-0-0-0(config)# end

se-10-0-0-0# show timecardview users

theirname1              [Enabled]

1 total timecardview user(s)

se-10-0-0-0#

Related Commands

Command	Description
disable (TimeCardView user configuration mode)	Disables the TimeCardView service for a specified individual.
show timecardview users	Displays the list of TimeCardView users.
timecardview username	Specifies either the individual for whom the TimeCardView service is to be enabled or disabled, or the TimeCardView user who is to be deleted.

groupname tcv-payroll-specialists

To create TimeCardView payroll specialists, use the groupname tcv-payroll-specialists command in Cisco Unity Express configuration mode.

groupname tcv-payroll-specialists { member user-id | owner user-id }

Syntax Description

member user-id	The username of a TimeCardView payroll specialist. The user-id is case-sensitive.
owner user-id	The username of a TimeCardView payroll specialist who controls the payroll specialists group. The user-id is case-sensitive.

Command Default

This command has no default value.

Command Modes

Cisco Unity Express configuration (config)

Command History

Cisco Unity Express Version	Modification
7.0	This command was introduced on the Cisco Unity Express network module.

Usage Guidelines

•Use this command to create payroll specialists by assigning owners and members to the payroll-specialist group.

•You cannot designate as a payroll specialist someone who is not already in the TimeCardView system. If you try to do so, you receive an error message.

•You can have multiple owners for a group.

Examples

The following example illustrates adding an owner and a member to a group of payroll specialists, and also verifying the configuration:

se-10-0-0-0# config t

Enter configuration commands, one per line.  End with CNTL/Z.

se-10-0-0-0(config)# groupname tcv-payroll-specialists privilege tcv-payroll

se-10-0-0-0(config)# groupname tcv-payroll-specialists owner theirname1

se-10-0-0-0(config)# groupname tcv-payroll-specialists member theirname2

se-10-0-0-0(config)# end

se-10-0-0-0# show user detail username theirname1

Username:           theirname1

Full Name:          Joe Theirname

First Name:         Joe

Last Name:          Theirname

Nickname:           Joe Theirname1

Phone:              

Phone(E.164):       

Fax:                

Email:              

Epage:              

Language:           systemDefault

GroupMember:        <none>

GroupOwner:         tcv-payroll-specialists 

Privileges:         <none>

se-10-0-0-0# show user detail username theirname2

Username:           theirname2

Full Name:          Jane Theirname

First Name:         Jane

Last Name:          Theirname

Nickname:           Jane Theirname2

Phone:              

Phone(E.164):       

Fax:                

Email:              

Epage:              

Language:           systemDefault

GroupMember:        tcv-payroll-specialists 

GroupOwner:         <none>

Privileges:         tcv-payroll 

se-10-0-0-0# 

Related Commands

Command	Description
groupname tcv-payroll-specialists privilege tcv-payroll	Grants TimeCardView payroll-specialist privileges to a group.
show timecardview users	Displays the list of TimeCardView users.
show user detail username	Displays details related to a TimeCardView user's privileges.

groupname tcv-payroll-specialists privilege tcv-payroll

To grant payroll-specialist privileges to a group, use the groupname tcv-payroll-specialists privilege tcv-payroll command in Cisco Unity Express configuration mode.

groupname tcv-payroll-specialists privilege tcv-payroll

Syntax Description

This command has no arguments or keywords.

Command Default

This command has no default value.

Command Modes

Cisco Unity Express configuration (config)

Command History

Cisco Unity Express Version	Modification
7.0	This command was introduced on the Cisco Unity Express network module.

Usage Guidelines

Grant this privilege before you add owners and members to the group of TimeCardView payroll specialists.

Examples

The following example illustrates granting payroll specialist privileges to a group:

se-10-0-0-0# config t

Enter configuration commands, one per line.  End with CNTL/Z.

se-10-0-0-0(config)# groupname tcv-payroll-specialists privilege tcv-payroll

se-10-0-0-0(config)# groupname tcv-payroll-specialists owner theirname1

se-10-0-0-0(config)# groupname tcv-payroll-specialists member theirname2

se-10-0-0-0(config)# end

se-10-0-0-0#

Related Commands

Command	Description
groupname tcv-payroll-specialists	Creates payroll specialists by assigning owners and members to the payroll-specialist group.
show user detail username	Displays the list of TimeCardView users.

maxsessions

To set the maximum number of TimeCardView sessions, use the maxsessions command in TimeCardView configuration mode.

maxsessions number

Syntax Description

maxsessions number

Maximum number of sessions.

Command Default

This command has no default value.

Command Modes

TimeCardView configuration (config-timecardview)

Command History

TimeCardView Version	Modification
7.0	This command was introduced.

Usage Guidelines

The number of TimeCardView sessions ranges from 2 to the maximum number of sessions for your platform. Both the default number of sessions and the maximum number of sessions depend on your platform, as shown below in Table 1.

Table 1 Number of Sessions per Platform

Platform	Maximum or Default Number of Sessions
Cisco 1861	2
Cisco NME	8
Cisco UC 500	2

.

Examples

The following example illustrates the process of setting the maximum number of TimeCardView sessions:

se-10-0-0-0# config t

Enter configuration commands, one per line.  End with CNTL/Z.

se-10-0-0-0(config)# service timecardview

se-10-0-0-0(config-timecardview)# maxsessions 2

se-10-0-0-0(config-timecardview)# end

se-10-0-0-0(config)# end

se-10-0-0-0# show timecardview configuration

Service: Enabled

Maximum Sessions: 2

[...]

se-10-0-0-0#

Related Commands

Command	Description
session-expiry-time	Sets automatic IP phone session logout time for TimeCardView users.
service timecardview	Enters TimeCardView configuration mode.
service timecardview session terminate	Clears any or all ongoing TimeCardView sessions.
show timecardview configuration	Displays TimeCardView configuration.
show timecardview sessions	Displays the TimeCardView sessions in progress,
show timecardview status	Displays TimeCardView status.

notification email address

To have TimeCardView automatically notify specified e-mail recipients when the database reaches certain usage threshholds (described in "Database Design Guidelines") and when database purges occur, use the notification email address command in TimeCardView configuration mode.

notification email address name@domain.com

Syntax Description

email address name@domain.com

Single or multiple email addresses separated by commas.

Command Default

This command has no default value.

Command Modes

TimeCardView configuration (config-timecardview)

Command History

TimeCardView Version	Modification
7.0	This command was introduced.

Usage Guidelines

The system has a 64 character limit (including commas).

Database Design Guidelines

The system checks its database every day at 11:30 p.m. If you configure TimeCardView to send notification e-mails, it does so when its database reaches:

•70% capacity

•80% capacity

•85% capacity

•90% capacity, at which point it deletes the oldest 70% of the records. It keeps the most recent 20%. This ensures that at least one month's worth of the latest data remains after a purge of this type.

Examples

The following example illustrates configuring e-mail notification of specified individuals about TimeCardView database capacity threshholds being reached and purges.

se-10-0-0-0# config t

Enter configuration commands, one per line.  End with CNTL/Z.

se-10-0-0-0(config)# service timecardview

se-10-0-0-0(config-timecardview)# notification email address 
user1@example.com,supervisor1@example.com,payroll-specialist1@example.com

se-10-0-0-0(config-timecardview)# end

se-10-0-0-0(config)# end

se-10-0-0-0# show timecardview configuration

Service: Enabled

Phone-call User Interface: Enabled

Maximum Sessions: 2

Supervisor Session logout time (secs): 60

Employee Session logout time (secs): 60

Week Start Day: Monday

Maximum Daily Working Duration (mins): 480

Maximum Daily Overtime Duration (mins): 90

Maximum In-Shift Break Time (mins): 1440

Maximum In-Shift Work Time (mins): 1440

Maximum In-Shift Lunch Time (mins): 1440

Purge Cycle (days): 90

Purge Days-to-Keep (days): 30

Purge Time: 00:30

Notification Email(s): 

user1@example.com,supervisor1@example.com,payroll-specialist1@example.com

se-10-0-0-0#

Related Commands

Command	Description
database purge schedule days	Configures the database purge schedule and the minimum number of days data is to be kept.
enable (TimeCardView configuration mode)	Globally enables the TimeCardView service.
service timecardview	Enters TimeCardView configuration mode.
show timecardview users	Displays the TimeCardView users.

payroll server quickbooks address

To configure Intuit's QuickBooks payroll server integration, use the payroll server quickbooks address command in TimeCardView configuration mode.

payroll server quickbooks address hostname-or-ip-address [ port integer ]

Syntax Description

port integer	Integer from dynamic port range; same as default server port number.
quickbooks address hostname-or-ip-address	Hostname of IP address of the QuickBooks server.

Command Default

None

Command Modes

TimeCardView configuration (config-timecardview)

Command History

TimeCardView Version	Modification
7.0	This command was introduced.

Examples

The following example illustrates configuring the QuickBooks payroll server integration:

se-10-0-0-0# config t

Enter configuration commands, one per line.  End with CNTL/Z.

se-10-0-0-0(config)# service timecardview

se-10-0-0-0(config-timecardview)# payroll server quickbooks address qbserver

se-10-0-0-0(config-timecardview)# end

se-10-0-0-0(config)# end

se-10-0-0-0# show timecardview configuration

Service: Enabled

Phone-call User Interface: Disabled

Maximum Sessions: 16

Supervisor Session logout time (secs): 60

Employee Session logout time (secs): 60

Week Start Day: Monday

Maximum Daily Working Duration (mins): 1440

Maximum Daily Overtime Duration (mins): 0

Maximum In-Shift Break Time (mins): 1440

Maximum In-Shift Work Time (mins): 1440

Maximum In-Shift Lunch Time (mins): 1300

Payroll Server Type: QuickBooks

Quickbooks Server Address: qbserver

Quickbooks Server Port: 57343

Synchronization Schedule: Weekly

Sync Transfer Mode: All Timesheets

Sync Day: Saturday

Sync Time (HH:MM 24 hour): 22:00

Purge Cycle (days): 90

Purge Days-to-Keep (days): 30

Purge Time (HH:MM 24 hour): 00:30

Notification Email(s): name@company.com

se-10-0-0-0

Related Commands

Command	Description
payroll server synchronization schedule	Configures the schedule for synchronizing TimeCardView with QuickBooks.
service timecardview	Enters TimeCardView configuration mode.
service timecardview synchronize now	Immediately synchronizes TimeCardView with QuickBooks.
show timecardview configuration	Displays TimeCardView configuration.

payroll server synchronization schedule

To configure the schedule for synchronizing TimeCardView with Intuit's QuickBooks, use the payroll server synchronization schedule command in TimeCardView configuration mode.

payroll server synchronization schedule { daily | weekly day 1-7 } time hh:mm timesheets { all | approved }

Syntax Description

all	Synchronizes all timesheets.
approved	Synchronizes only approved timesheets.
time hh:mm	Time at which synchronization takes place.
weekly day 1-7	Day of the week when synchronization occurs. 1 = Monday 2 = Tuesday 3 = Wednesday 4 = Thursday 5 = Friday 6 = Saturday 7 = Sunday

Command Default

None

Command Modes

TimeCardView configuration (config-timecardview)

Command History

TimeCardView Version	Modification
7.0	This command was introduced.

Examples

The following example illustrates configuring the QuickBooks payroll server synchronization schedule:

se-10-0-0-0# config t

Enter configuration commands, one per line.  End with CNTL/Z.

se-10-0-0-0(config)# service timecardview

se-10-0-0-0(config-timecardview)# payroll server synchronization schedule weekly day 7 
time 22:00 timesheets all

se-10-0-0-0(config-timecardview)# end

se-10-0-0-0(config)# end

se-10-0-0-0# show timecardview configuration

Service: Enabled

Phone-call User Interface: Disabled

Maximum Sessions: 0

Supervisor Session logout time (secs): 60

Employee Session logout time (secs): 60

Week Start Day: Monday

Maximum Daily Working Duration (mins): 1440

Maximum Daily Overtime Duration (mins): 0

Maximum In-Shift Break Time (mins): 1440

Maximum In-Shift Work Time (mins): 1440

Maximum In-Shift Lunch Time (mins): 1300

Payroll Server Type: QuickBooks

Quickbooks Server Address: qbserver

Quickbooks Server Port: 57343

Synchronization Schedule: Weekly

Sync Transfer Mode: All Timesheets

Sync Day: Saturday

Sync Time (HH:MM 24 hour): 22:00

Purge Cycle (days): 90

Purge Days-to-Keep (days): 30

Purge Time (HH:MM 24 hour): 00:30

Notification Email(s): name@company.com

se-10-0-0-0

Related Commands

Command	Description
database purge schedule days	Configures the database purge schedule and the minimum number of days data is to be kept.
maxsessions	Sets the maximum number of TimeCardView sessions.
payroll server quickbooks address	Configures QuickBooks payroll server integration.
service timecardview synchronize now	Immediately synchronizes TimeCardView with QuickBooks.
show timecardview configuration	Displays TimeCardView configuration.
show timecardview status	Displays TimeCardView status.

service timecardview

To enter TimeCardView configuration mode, use the service timecardview command in Cisco Unity Express configuration mode.

service timecardview

Syntax Description

This command has no arguments or keywords.

Command Default

This command has no default value.

Command Modes

Cisco Unity Express configuration (config)

Command History

Cisco Unity Express Version	Modification
7.0	This command was introduced on the Cisco Unity Express network module.

Examples

The following example illustrates the use of the service timecardview command:

se-10-0-0-0# config t

Enter configuration commands, one per line.  End with CNTL/Z.

se-10-0-0-0(config)# service timecardview

se-10-0-0-0(config-timecardview)# enable

se-10-0-0-0(config-timecardview)# end

se-10-0-0-0(config)# end

se-10-0-0-0# show timecardview configuration

Service: Enabled

Related Commands

Command	Description
enable (TimeCardView configuration mode)	Globally enables the TimeCardView service.
disable (TimeCardView user configuration mode)	Disables the TimeCardView service for individual TimeCardView users.
show timecardview configuration	Displays TimeCardView configuration.
show timecardview status	Displays TimeCardView status.

service timecardview purge now

To execute an immediate purge of the TimeCardView database, use the service timecardview purge now command in Cisco Unity Express EXEC mode.

service timecardview purge now

Syntax Description

This command has no arguments or keywords.

Command Default

This command has no default value.

Command Modes

Cisco Unity Express EXEC (#)

Command History

Cisco Unity Express Version	Modification
7.0	This command was introduced on the Cisco Unity Express network module.

Examples

The following example illustrates disabling the TimeCardView service, then purging its database.

se-10-0-0-0# config t

Enter configuration commands, one per line.  End with CNTL/Z.

se-10-0-0-0(config)# service timecardview

se-10-0-0-0(config-timecardview)# no enable

se-10-0-0-0(config-timecardview)# end

se-10-0-0-0(config)# end

se-10-0-0-0# service timecardview purge now

!!!WARNING!!!: This will *COMPLETELY ERASE* timecardview historical records. It is highly 
recommended to backup timecardview before excecuting this command since it is 
irreversible.

Are you sure you want to Purge? (y/n) [n]: y

Purge started successfully. Please check its status later.

se-10-0-0-0# show timecardview status

Service: Disabled

Active Sessions: 0

DB Status: IDLE

DB Usage: 0

Last Purge (04/12/2008 18:06:43): 

Payroll Sync Status (dd/MM/yyyy HH:mm:ss): 

se-10-0-0-0#

Related Commands

Command	Description
copy timecardview timesheets url	Creates a comma-separated values (CSV) file and copies it to an FTP server.
database purge schedule days	Configures the database purge schedule and the minimum number of days data is to be kept.
notification email address	Configures TimeCardView to automatically notify specified e-mail recipients when certain database usage threshholds are reached and when database purges occur.
show timecardview configuration	Displays TimeCardView configuration.
show timecardview status	Displays TimeCardView status.

service timecardview session terminate

To clear any or all ongoing TimeCardView sessions, use the service timecardview session terminate command in Cisco Unity Express EXEC mode.

service timecardview session terminate { all | user user-id }

Syntax Description

all	All TimeCardView users.
user user-id	Username of a TimeCardView user.

Command Default

This command has no default value.

Command Modes

Cisco Unity Express EXEC (#)

Command History

Cisco Unity Express Version	Modification
7.0	This command was introduced.

Usage Guidelines

Use the show timecardview sessions command to display all ongoing sessions.

Examples

The following example illustrates displaying sessions and clearing all of them.

se-10-0-0-0# show timecardview sessions

theirname1,

theirname3.

se-10-0-0-0# service timecardview session terminate all

se-10-0-0-0# show timecardview sessions

No active sessions.

se-10-0-0-0#

Related Commands

Command	Description
session-expiry-time	Sets automatic IP phone session logout time for TimeCardView users.
show timecardview sessions	Displays the TimeCardView sessions in progress,
show timecardview status	Displays TimeCardView status.

service timecardview synchronize now

To immediately synchronize TimeCardView with Intuit's QuickBooks, use the service timecardview synchronize now command in Cisco Unity Express EXEC mode.

service timecardview synchronize now timesheets { all | approved }

Syntax Description

all	Synchronizes all timesheets.
approved	Synchronizes only approved timesheets.

Command Default

This command has no default value.

Command Modes

Cisco Unity Express EXEC (#)

Command History

Cisco Unity Express Version	Modification
7.0	This command was introduced on the Cisco Unity Express network module.

Examples

The following example illustrates disabling the TimeCardView service, then purging its database.

se-10-0-0-0# service timecardview synchronize now timesheets approved

Payroll Sync started successfully. Please check its status later.

se-10-0-0-0# show timecardview status

Service: Enabled

Active Sessions: 0

DB Status: IDLE

DB Usage: 0

Last Purge (dd/MM/yyyy HH:mm:ss): 17/12/2008 10:06:25

Payroll Sync Status (dd/MM/yyyy HH:mm:ss): 20/12/2008 07:13:19

se-10-0-0-0#

Related Commands

Command	Description
database purge schedule days	Configures the database purge schedule and the minimum number of days data is to be kept.
payroll server quickbooks address	Configures QuickBooks payroll server integration.
payroll server synchronization schedule	Configures the schedule for synchronizing TimeCardView with QuickBooks.
show timecardview configuration	Displays TimeCardView configuration.
show timecardview status	Displays TimeCardView status.

session-expiry-time

To set automatic IP phone session logout time for TimeCardView users, use the session-expiry-time command in TimeCardView configuration mode.

session-expiry-time { supervisor | employee } secs

Syntax Description

employee secs	The number of seconds before the system automatically logs out employees. The range is 60 to 600 seconds (1 to 10 minutes).
supervisor secs	The number of seconds before the system automatically logs out supervisors. The range is 60 to 600 seconds (1 to 10 minutes).

Command Default

Automatic logout for both supervisors and employees is 300 seconds (5 minutes).

Command Modes

TimeCardView configuration (config-timecardview)

Command History

TimeCardView Version	Modification
7.0	This command was introduced.

Examples

The following example illustrates setting automatic session logout.

se-10-0-0-0# config t

Enter configuration commands, one per line.  End with CNTL/Z.

se-10-0-0-0(config)# service timecardview

se-10-0-0-0(config-timecardview)# session-expiry-time supervisor 600

se-10-0-0-0(config-timecardview)# session-expiry-time employee 120

se-10-0-0-0(config-timecardview)# end

se-10-0-0-0(config)# end

se-10-0-0-0# show timecardview configuration

Service: Enabled

Maximum Sessions: 2

Supervisor Session logout time (secs): 600

Employee Session logout time (secs): 120

[...]

se-10-0-0-0# 

Related Commands

Command	Description
service timecardview	Enters TimeCardView configuration mode.
service timecardview session terminate	Clears any or all ongoing TimeCardView sessions.
show timecardview configuration	Displays TimeCardView configuration.
show timecardview sessions	Displays the TimeCardView sessions in progress.

shift limit

To limit the amount of time TimeCardView users spend in the work, lunch, and break states, use the shift limit command in TimeCardView configuration mode.

shift limit {work-duration | lunch-duration | break-duration } minutes 1-1440

Syntax Description

minutes 1-1440

Maximum number of minutes TimeCardView users can remain in any status — work, lunch, or break.

Command Default

TimeCardView users can accumulate 1440 minutes (24 hours) in any combination of the three states.

Command Modes

TimeCardView configuration (config-timecardview)

Command History

TimeCardView Version	Modification
7.0	This command was introduced.

Usage Guidelines

When employees log in to TimeCardView, they can set their status to one of the following:

•Work

•Lunch

•Break

You can limit the amount of time employees can spend in each state. The maximum number of hours per day they can remain in any state is 1440 minutes or 24 hours. If you do not change these parameters, the system allows an employee to accumulate 24 hours per day in any combination of the three states.

The system automatically logs out any user who does not change their state before 24 hours have elapsed or before the limit time you set (whichever number is smaller) has elapsed.

Examples

The following example illustrates setting time limits on employee status:

se-10-0-0-0# config t

Enter configuration commands, one per line.  End with CNTL/Z.

se-10-0-0-0(config)# service timecardview

se-10-0-0-0(config-timecardview)# shift limit work-duration minutes 480

se-10-0-0-0(config-timecardview)# shift limit lunch-duration minutes 60

se-10-0-0-0(config-timecardview)# shift limit break-duration minutes 40

se-10-0-0-0(config-timecardview)# end

se-10-0-0-0(config)# end

se-10-0-0-0# show timecardview configuration

Service: Enabled

Maximum Sessions: 2

Supervisor Session logout time (secs): 600

Employee Session logout time (secs): 120

Week Start Day: Monday

Maximum Daily Working Duration (mins): 1440

Maximum Daily Overtime Duration (mins): 0

Maximum In-Shift Break Time (mins): 40

Maximum In-Shift Work Time (mins): 480

Maximum In-Shift Lunch Time (mins): 60

Payroll Server Type: QuickBooks

Quickbooks Server Address: 192.0.2.3

Quickbooks Server Port: 57343

Synchronization Schedule: Daily

Sync Transfer Mode: All Timesheets

Sync Time: 21:00

Purge Cycle (days): 90

Purge Days-to-Keep (days): 30

Purge Time: 21:30

Notification Email(s): 

se-10-0-0-0# copy running-config startup-config

se-10-0-0-0#

Related Commands

Command	Description
copy timecardview timesheets url	Creates a comma-separated values (CSV) file and copies it to an FTP server.
daily	Limits the number of regular and overtime hours TimeCardView users can work.
service timecardview	Enters TimeCardView configuration mode.
show timecardview configuration	Displays TimeCardView configuration.

show supervisor

To display the employees who report to the specified supervisor, use the show supervisor command in Cisco Unity Express EXEC mode.

show supervisor user-id

Syntax Description

supervisor user-id

The supervisor's User ID, which is case-sensitive.

Command Default

This command has no default value.

Command Modes

Cisco Unity Express EXEC (#)

Command History

Cisco Unity Express Version	Modification
7.0	This command was introduced on the Cisco Unity Express network module.

Usage Guidelines

Use this command to verify your supervisory structure.

Examples

The following example illustrates creating a chain of command with two employees, their supervisor and the supervisor's supervisor, and then verifying this:

se-10-0-0-0# config t

Enter configuration commands, one per line.  End with CNTL/Z.

se-10-0-0-0(config)# username Juser20 supervisor designate

se-10-0-0-0(config)# username Juser200 supervisor designate

se-10-0-0-0(config)# username Juser10 supervisor username Juser20

se-10-0-0-0(config)# username Juser11 supervisor username Juser20

se-10-0-0-0(config)# username Juser20 supervisor username Juser200

se-10-0-0-0(config)# end

se-10-0-0-0 # show supervisors

Juser20

Juser200

2 total supervisor(s)

se-10-0-0-0 # show supervisor Juser20

Juser10

Juser11

2 total employee(s)

se-10-0-0-0 # show supervisor Juser200

Juser10

Juser11

Juser20

3 total employee(s)

se-10-0-0-0 # show user supervisor username Juser11

Juser20

se-10-0-0-0 # show user supervisor username Juser10

Juser20

se-10-0-0-0 # show user supervisor username Juser20

Juser200

se-10-0-0-0 # 

Related Commands

Command	Description
show supervisors	Displays the names of the TimeCardView users who are designated supervisors.
show timecardview users	Displays the list of TimeCardView users.
show user supervisor username	Displays the specified user's supervisor.
timecardview username	Specifies either the individual for whom the TimeCardView service is to be enabled or disabled, or the TimeCardView user who is to be deleted.
username	Either creates a supervisor and assigns employees to report to him or her, or removes the privilege or dissolves the relationship.

show supervisors

To display the TimeCardView users who are designated supervisors, use the show supervisors command in Cisco Unity Express EXEC mode.

show supervisor

Syntax Description

This command has no arguments or keywords.

Command Default

This command has no default value.

Command Modes

Cisco Unity Express EXEC (#)

Command History

Cisco Unity Express Version	Modification
7.0	This command was introduced on the Cisco Unity Express network module.

Usage Guidelines

Use this command to verify your supervisory structure.

Examples

The following example illustrates creating a chain of command with two employees, their supervisor and the supervisor's supervisor, and then verifying this:

se-10-0-0-0# config t

Enter configuration commands, one per line.  End with CNTL/Z.

se-10-0-0-0(config)# username Juser20 supervisor designate

se-10-0-0-0(config)# username Juser200 supervisor designate

se-10-0-0-0(config)# username Juser10 supervisor username Juser20

se-10-0-0-0(config)# username Juser11 supervisor username Juser20

se-10-0-0-0(config)# username Juser20 supervisor username Juser200

se-10-0-0-0(config)# end

se-10-0-0-0 # show supervisors

Juser20

Juser200

2 total supervisor(s)

se-10-0-0-0 # show supervisor Juser20

Juser10

Juser11

2 total employee(s)

se-10-0-0-0 # show supervisor Juser200

Juser10

Juser11

Juser20

3 total employee(s)

se-10-0-0-0 # show user supervisor username Juser11

Juser20

se-10-0-0-0 # show user supervisor username Juser10

Juser20

se-10-0-0-0 # show user supervisor username Juser20

Juser200

se-10-0-0-0 # 

Related Commands

Command	Description
show supervisor	Displays the employees who report to the specified supervisor.
show timecardview users	Displays the list of TimeCardView users.
show user supervisor username	Displays the specified user's supervisor.
timecardview username	Specifies either the individual for whom the TimeCardView service is to be enabled or disabled, or the TimeCardView user who is to be deleted.
username	Either creates a supervisor and assigns employees to report to him or her, or removes the privilege or dissolves the relationship.

show timecardview configuration

To display TimeCardView configuration, use the show timecardview configuration command in Cisco Unity Express EXEC mode.

show timecardview configuration

Syntax Description

This command has no arguments or keywords.

Command Default

This command has no default value.

Command Modes

Cisco Unity Express EXEC (#)

Command History

Cisco Unity Express Version	Modification
7.0	This command was introduced.

Usage Guidelines

Use the show timecardview configuration command to display:

•Whether or not the TimeCardView service is enabled

•The maximum number of sessions

•The supervisor and employee session logout times

•The start of the work week

•The maximum daily regular and overtime hours

•The maximum amount of time employees can spend in the work, break, and lunch states

•The payroll server configuration (set using the TimeCardView GUI)

•The database purge schedule

•The minimum number of days data is to be kept in the database

•The time of day when scheduled purges take place

•The e-mail addresses of those whom the system notifies when its database reaches its capacity threshholds.

Examples

The following example illustrates displaying TimeCardView configuration:

se-10-0-0-0# show timecardview configuration

Service: Enabled

Maximum Sessions: 2

Supervisor Session logout time (secs): 600

Employee Session logout time (secs): 120

Week Start Day: Monday

Maximum Daily Working Duration (mins): 1440

Maximum Daily Overtime Duration (mins): 0

Maximum In-Shift Break Time (mins): 40

Maximum In-Shift Work Time (mins): 480

Maximum In-Shift Lunch Time (mins): 60

Payroll Server Type: QuickBooks

Quickbooks Server Address: 192.0.2.3

Quickbooks Server Port: 57343

Synchronization Schedule: Daily

Sync Transfer Mode: All Timesheets

Sync Time: 21:00

Purge Cycle (days): 90

Purge Days-to-Keep (days): 30

Purge Time: 21:30

Notification Email(s): 

se-10-0-0-0# copy running-config startup-config

se-10-0-0-0#

Related Commands

Command	Description
daily	Limits the number of regular and overtime hours TimeCardView users can work.
database purge schedule days	Configures the database purge schedule and the minimum number of days data is to be kept.
enable (TimeCardView configuration mode)	Globally enables the TimeCardView service.
session-expiry-time	Sets automatic IP phone session logout time for TimeCardView users.
maxsessions	Sets the maximum number of TimeCardView sessions.
notification email address	Configures TimeCardView to automatically notify specified e-mail recipients when certain database usage threshholds are reached and when database purges occur,
payroll server quickbooks address	Configures QuickBooks payroll server integration.
payroll server synchronization schedule	Configures the schedule for synchronizing TimeCardView with QuickBooks.
service timecardview purge now	Executes an immediate purge of the TimeCardView database.
shift limit	Limits the amount of time TimeCardView users can spend in the work, lunch, and break states.

show timecardview sessions

To display TimeCardView sessions, use the show timecardview sessions command in Cisco Unity Express EXEC mode.

show timecardview sessions

Syntax Description

This command has no arguments or keywords.

Command Default

This command has no default value.

Command Modes

Cisco Unity Express EXEC (#)

Command History

Cisco Unity Express Version	Modification
7.0	This command was introduced on the Cisco Unity Express network module.

Usage Guidelines

Use this command before or after clearing TimeCardView sessions.

Examples

The following example illustrates displaying sessions and clearing all of them.

se-10-0-0-0# show timecardview sessions

theirname1,

theirname3.

se-10-0-0-0# service timecardview session terminate all

se-10-0-0-0# show timecardview sessions

No active sessions.

se-10-0-0-0#

Related Commands

Command	Description
session-expiry-time	Sets automatic IP phone session logout time for TimeCardView users.
maxsessions	Sets the maximum number of TimeCardView sessions.
service timecardview session terminate	Clears any or all ongoing TimeCardView sessions.

show timecardview status

To display TimeCardView status, use the show timecardview status command in Cisco Unity Express EXEC mode.

show timecardview status

Syntax Description

This command has no arguments or keywords.

Command Default

This command has no default value.

Command Modes

Cisco Unity Express EXEC (#)

Command History

TimeCardView Version	Modification
7.0	This command was introduced.

Usage Guidelines

Use this command to find out:

•Whether the TimeCardView service is globally enabled or disabled

•Whether there are any active sessions

•Whether the database is idle or not

•How full the database is

•When the database was last purged

•When TimeCardView was last synchronized

Examples

The following example illustrates displaying the TimeCardViewstatus after purging its database.

se-10-0-0-0# config t

Enter configuration commands, one per line.  End with CNTL/Z.

se-10-0-0-0(config)# service timecardview

se-10-0-0-0(config-timecardview)# no enable

se-10-0-0-0(config-timecardview)# end

se-10-0-0-0(config)# end

se-10-0-0-0# service timecardview purge now

!!!WARNING!!!: This will *COMPLETELY ERASE* timecardview historical records. It is highly 
recommended to backup timecardview before excecuting this command since it is 
irreversible.

Are you sure you want to Purge? (y/n) [n]: y

Purge started successfully. Please check its status later.

se-10-0-0-0# show timecardview status

Service: Disabled

Active Sessions: 0

DB Status: IDLE

DB Usage: 0

Last Purge (04/12/2008 18:06:43): 

Payroll Sync Status (dd/MM/yyyy HH:mm:ss): 

se-10-0-0-0#

Related Commands

Command	Description
database purge schedule days	Configures the TimeCardView database purge schedule and the minimum number of days to keep data.
enable (TimeCardView configuration mode)	Globally enables the TimeCardView service.
service timecardview purge now	Executes an immediate purge of the TimeCardView database.

show timecardview users

To display the list of TimeCardView users, use the show timecardview users command in Cisco Unity Express EXEC mode.

show timecardview users

Syntax Description

This command has no arguments or keywords.

Command Default

This command has no default value.

Command Modes

Cisco Unity Express EXEC (#)

Command History

Cisco Unity Express Version	Modification
7.0	This command was introduced on the Cisco Unity Express network module.

Examples

The following example illustrates displaying a TimeCardView username after adding the user.

se-10-0-0-0# config t

Enter configuration commands, one per line.  End with CNTL/Z.

se-10-0-0-0(config)# timecardview username theirname1

se-10-0-0-0(config-tvuser)# enable

se-10-0-0-0(config-tvuser)# end

se-10-0-0-0(config)# end

se-10-0-0-0# show timecardview users

theirname1              [Enabled]

1 total timecardview user(s)

se-10-0-0-0#

Related Commands

Command	Description
copy timecardview timesheets url	Creates a comma-separated values (CSV) file and copies it to an FTP server.
disable (TimeCardView user configuration mode)	Disables individual TimeCardView users.
enable (TimeCardView user configuration mode)	Enables the TimeCardView service for individuals.
show supervisor	Displays the employees who report to the specified supervisor.
show user detail username	Displays details related to a TimeCardView user's privileges.
show user supervisor username	Displays the specified user's supervisor.
timecardview username	Specifies either the individual for whom the TimeCardView service is to be enabled or disabled, or the TimeCardView user who is to be deleted.
username	Either creates a supervisor and assigns employees to report to him or her, or removes the privilege or dissolves the relationship.

show user detail username

To display details relating to users with TimeCardView privileges, use the show user detail username command in Cisco Unity Express EXEC mode.

show user detail username user-id

Syntax Description

username user-id

The username of a TimeCardView payroll specialist. The user-id is case-sensitive.

Command Default

This command has no default value.

Command Modes

Cisco Unity Express EXEC (#)

Command History

Cisco Unity Express Version	Modification
7.0	This command was introduced on the Cisco Unity Express network module.

Usage Guidelines

Use this command to verify which TimeCardView users have payroll specialist privileges.

Examples

The following example illustrates adding an owner and a member to a group of payroll specialists, and also verifying the configuration:

se-10-0-0-0# config t

Enter configuration commands, one per line.  End with CNTL/Z.

se-10-0-0-0(config)# groupname tcv-payroll-specialists privilege tcv-payroll

se-10-0-0-0(config)# groupname tcv-payroll-specialists owner theirname1

se-10-0-0-0(config)# groupname tcv-payroll-specialists member theirname2

se-10-0-0-0(config)# end

se-10-0-0-0# show user detail username theirname1

Username:           theirname1

Full Name:          Joe Theirname

First Name:         Joe

Last Name:          Theirname

Nickname:           Joe Theirname1

Phone:              

Phone(E.164):       

Fax:                

Email:              

Epage:              

Language:           systemDefault

GroupMember:        <none>

GroupOwner:         tcv-payroll-specialists 

Privileges:         <none>

se-10-0-0-0# show user detail username theirname2

Username:           theirname2

Full Name:          Jane Theirname

First Name:         Jane

Last Name:          Theirname

Nickname:           Jane Theirname2

Phone:              

Phone(E.164):       

Fax:                

Email:              

Epage:              

Language:           systemDefault

GroupMember:        tcv-payroll-specialists 

GroupOwner:         <none>

Privileges:         tcv-payroll 

se-10-0-0-0# 

Related Commands

Command	Description
groupname tcv-payroll-specialists	Creates payroll specialists by adding owner(s) and member(s) to the group of payroll specialists.
groupname tcv-payroll-specialists privilege tcv-payroll	Grants TimeCardView payroll-specialist privileges to a group.
show timecardview users	Displays the list of TimeCardView users.
timecardview username	Specifies either the individual for whom the TimeCardView service is to be enabled or disabled, or the TimeCardView user who is to be deleted.
username	Either creates a supervisor and assigns employees to report to him or her, or removes the privilege or dissolves the relationship.
username (epage)	Configures an epage address to enable a supervisor to send a text message to an employee reporting to him or her.

show user supervisor username

To display the specified TimeCardView user's supervisor, use the show user supervisor username command in Cisco Unity Express EXEC mode.

show user supervisor username user-id

Syntax Description

username user-id

The Cisco Unity Express username of the TimeCardView user. The user-id is case-sensitive.

Command Default

This command has no default value.

Command Modes

Cisco Unity Express EXEC (#)

Command History

Cisco Unity Express Version	Modification
7.0	This command was introduced on the Cisco Unity Express network module.

Usage Guidelines

Use this command to verify your supervisory structure.

Examples

The following example illustrates creating a chain of command with two employees, their supervisor and the supervisor's supervisor, and then verifying this:

se-10-0-0-0# config t

Enter configuration commands, one per line.  End with CNTL/Z.

se-10-0-0-0(config)# username Juser20 supervisor designate

se-10-0-0-0(config)# username Juser200 supervisor designate

se-10-0-0-0(config)# username Juser10 supervisor username Juser20

se-10-0-0-0(config)# username Juser11 supervisor username Juser20

se-10-0-0-0(config)# username Juser20 supervisor username Juser200

se-10-0-0-0(config)# end

se-10-0-0-0 # show supervisors

Juser20

Juser200

2 total supervisor(s)

se-10-0-0-0 # show supervisor Juser20

Juser10

Juser11

2 total employee(s)

se-10-0-0-0 # show supervisor Juser200

Juser10

Juser11

Juser20

3 total employee(s)

se-10-0-0-0 # show user supervisor username Juser11

Juser20

se-10-0-0-0 # show user supervisor username Juser10

Juser20

se-10-0-0-0 # show user supervisor username Juser20

Juser200

se-10-0-0-0 # 

Related Commands

Command	Description
show supervisor	Displays the employees who report to the specified supervisor.
show supervisors	Displays the names of the TimeCardView users who are designated supervisors.
show timecardview users	Displays the list of TimeCardView users.
timecardview username	Specifies either the individual for whom the TimeCardView service is to be enabled or disabled, or the TimeCardView user who is to be deleted.
username	Either creates a supervisor and assigns employees to report to him or her, or removes the privilege or dissolves the relationship.

timecardview username

To specify the individual Cisco Unity Express subscriber for whom the TimeCardView service is to be enabled or disabled, use the timecardview username command in Cisco Unity Express configuration mode. To delete a TimeCardView user, use the no form of this command.

timecardview username user-id

no timecardview username user-id

Syntax Description

username user-id

The Cisco Unity Express username of the subscriber. The user-id is case-sensitive.

Command Default

This command has no default value.

Command Modes

Cisco Unity Express configuration (config)

Command History

Cisco Unity Express Version	Modification
7.0	This command was introduced on the Cisco Unity Express network module.

Usage Guidelines

•You can also provide TimeCardView service by importing employees from Intuit's QuickBooks using the TimeCardView GUI. Users imported that way are automatically enabled.

•Delete specified TimeCardView users by using the no form of this command.

Examples

The following example illustrates adding the TimeCardView service for a specified Cisco Unity Express subscriber.

se-10-0-0-0# config t

Enter configuration commands, one per line.  End with CNTL/Z.

se-10-0-0-0(config)# timecardview username theirname1

se-10-0-0-0(config-tvuser)# enable

se-10-0-0-0(config-tvuser)# end

se-10-0-0-0(config)# end

se-10-0-0-0# show timecardview users

theirname1              [Enabled]

1 total timecardview user(s)

se-10-0-0-0#

Related Commands

Command	Description
disable (TimeCardView user configuration mode)	Disables the TimeCardView service for a specified individual.
enable (TimeCardView user configuration mode)	Enables the TimeCardView service for a specified individual.
show timecardview users	Displays the list of TimeCardView users.
show user supervisor username	Displays the specified user's supervisor.
username	Either creates a supervisor and assigns employees to report to him or her, or removes the privilege or dissolves the relationship.

user-interface phone-call

To enable or disable the TimeCardView telephone user interface (TUI) voice prompts, use the user-interface phone-call command in TimeCardView configuration mode.

user-interface phone-call { enable | disable }

Syntax Description

disable	Disables the TimeCardView TUI.
enable	Enables the TimeCardView TUI.

Command Default

The TUI is disabled.

Command Modes

TimeCardView configuration (config-timecardview)

Command History

TimeCardView Version	Modification
7.0	This command was introduced.

Usage Guidelines

•TimeCardView provides users with voice prompts to guide them through all its processes, such as logging in and transitioning from one status to the next.

•The output from the show timecardview configuration command indicates whether the TUI is disabled.

---

Note Do not confuse the TUI, which is audible on the phone, with the phone screen user interface, which is visible on the phone.

---

Examples

The following example illustrates enabling the TUI for TimeCardView.

se-10-0-0-0# config t

se-10-0-0-0(config)# service timecardview

se-10-0-0-0(config-timecardview)# user-interface phone-call enable

se-10-0-0-0(config-timecardview)# end

se-10-0-0-0(config)# end

se-10-0-0-0# show timecardview configuration

Service: Enabled

Phone-call User Interface: Enabled

[...]

se-10-0-0-0# 

Related Commands

Command	Description
service timecardview	Enters TimeCardView configuration mode.
show run	Displays the status of the TimeCardView IP phone interface.

user-interface phone-service

To enable or disable the TimeCardView IP phone screen prompts, use the user-interface phone-service command in TimeCardView configuration mode.

user-interface phone-service { enable | disable }

Syntax Description

disable	Disables the TimeCardView IP phone screen interface.
enable	Enables the TimeCardView IP phone screen interface.

Command Default

The phone service screen interface is enabled.

Command Modes

TimeCardView configuration (config-timecardview)

Command History

TimeCardView Version	Modification
7.0	This command was introduced.

Usage Guidelines

By default, TimeCardView provides users with the phone screen user interface to guide them through all its processes, such as logging in and transitioning from one status to the next.

---

Note Do not confuse the phone screen user interface, which is visible on the phone, with the telephone user interface (TUI), which is audible on the phone.

---

Examples

The following example illustrates disabling the screen prompts for TimeCardView.

se-10-0-0-0# config t

se-10-0-0-0(config)# service timecardview

se-10-0-0-0(config-timecardview)# user-interface phone-service disable

se-10-0-0-0(config-timecardview)# end

se-10-0-0-0(config)# end

se-10-0-0-0# show timecardview configuration

Service: Enabled

Phone-service User Interface: Disabled

[...]

se-10-0-0-0# 

Related Commands

Command	Description
service timecardview	Enters TimeCardView configuration mode.
show run	Displays the status of the TimeCardView IP phone interface.

username

To create a supervisor and assign employees to report to him or her, use the username command in Cisco Unity Express configuration mode. Use the no form of this command to remove the privilege or dissolve the relationship.

username user-id supervisor { designate | username user-id [ alternate | primary ]}

no username user-id supervisor { designate | username user-id [ alternate | primary ]}

Syntax Description

username user-id

User ID of a TimeCardView user. The user ID is case-sensitive. When it occurs before the keyword supervisor in the command, the user ID is that of the supervisor, and when it occurs after the keyword supervisor, it is an employee's user ID.

Command Default

A supervisor is an employee's primary supervisor unless otherwise specified.

Command Modes

Cisco Unity Express configuration (config)

Command History

Cisco Unity Express Version	Modification
7.0	This command was introduced.

Usage Guidelines

•After designating supervisors, assign employees to them.

•If you attempt to assign an employee to someone whom you have not already designated a supervisor, you receive an error message.

•If you specify an employee or a supervisor who is not already a TimeCardView user, you receive an error message.

•Employees can have primary and alternate supervisors. Unless you specify otherwise, the supervisor you assign to an employee is that employee's primary supervisor.

•Any assignment overwrites all earlier ones, so that any pre-existing primary supervisory relationship ceases.

•If you attempt to make an employee his or her own supervisor, you receive an error message.

•If you create a circular reporting relationship, you receive an error message.

•Using the no username user-id supervisor designate command reduces the supervisor to employee status, and also removes the direct reports from the supervisor's reporting chain.

•Using the no username user-id supervisor username user-id [primary | alternate] command removes the specified employee from the specified supervisor's list of direct reports.

Examples

The following example illustrates creating a chain of command with two employees, their supervisor and the supervisor's supervisor, and then verifying this:

se-10-0-0-0# config t

Enter configuration commands, one per line.  End with CNTL/Z.

se-10-0-0-0(config)# username Juser20 supervisor designate

se-10-0-0-0(config)# username Juser200 supervisor designate

se-10-0-0-0(config)# username Juser10 supervisor username Juser20

se-10-0-0-0(config)# username Juser11 supervisor username Juser20

se-10-0-0-0(config)# username Juser20 supervisor username Juser200

se-10-0-0-0(config)# end

se-10-0-0-0 # show supervisors

Juser20

Juser200

2 total supervisor(s)

se-10-0-0-0 # show supervisor Juser20

Juser10

Juser11

2 total employee(s)

se-10-0-0-0 # show supervisor Juser200

Juser10

Juser11

Juser20

3 total employee(s)

se-10-0-0-0 # show user supervisor username Juser11

Juser20

se-10-0-0-0 # show user supervisor username Juser10

Juser20

se-10-0-0-0 # show user supervisor username Juser20

Juser200

se-10-0-0-0 #

Related Commands

Command	Description
show supervisor	Displays the employees who report to the specified supervisor.
show supervisors	Displays the names of the TimeCardView users who are designated supervisors.
show timecardview users	Displays the list of TimeCardView users.
show user supervisor username	Displays the specified user's supervisor.
timecardview username	Specifies either the individual for whom the TimeCardView service is to be enabled or disabled, or the TimeCardView user who is to be deleted.

username (epage)

To enable a supervisor to send a text message to an employee reporting to him or her, use the username command in Cisco Unity Express configuration mode to configure an epage address for the employee.

username user-id epage string

Syntax Description

epage string	RFC-2822 e-mail address, for example, name@company.com.
username user-id	User ID of a TimeCardView user. The user ID is case-sensitive. When it occurs before the keyword supervisor in the command, the user ID is that of the supervisor, and when it occurs after the keyword supervisor, it is an employee's user ID.

Command Default

None

Command Modes

Cisco Unity Express configuration (config)

Command History

Cisco Unity Express Version	Modification
7.0	This command was introduced.

Usage Guidelines

If you do not configure an e-page address for each employee, TimeCardView tells supervisors that the epage address is empty when they try to send text messages to their employees.

Examples

The following example illustrates configuring an epage address for an employee so that a supervisor can send text messages to that person:

se-10-0-0-0# config t

Enter configuration commands, one per line.  End with CNTL/Z.

se-10-0-0-0(config)# username Theirname1 epage sample@company.com

se-10-0-0-0(config)# end

se-10-0-0-0# show user detail username Theirname1

Username:           Theirname1

Full Name:          Sample Theirname

First Name:         Sample

Last Name:          Theirname

Nickname:           Theirname1

Phone:              

Phone(E.164):       

Fax:                

Email:              

Epage:              sample@company.com

Language:           systemDefault

GroupMember:        <none>

GroupOwner:         <none>

Privileges:         <none>

se-10-0-0-0#

Related Commands

Command	Description
show timecardview users	Displays the list of TimeCardView users.
show user detail username	Displays details related to a TimeCardView user's privileges.
show user supervisor username	Displays the specified user's supervisor.
timecardview username	Specifies either the individual for whom the TimeCardView service is to be enabled or disabled, or the TimeCardView user who is to be deleted.
username	Either creates a supervisor and assigns employees to report to him or her, or removes the privilege or dissolves the relationship.

week-start day

To configure the day of the week on which work starts, use the week-start day command in TimeCardView configuration mode. Use the no form of this command to reset the start of the work week to Monday.

week-start day 1-7

no week-start day 1-7

Syntax Description

day 1-7

Day of the week on which work starts. 1 = Monday 2 = Tuesday 3 = Wednesday 4 = Thursday 5 = Friday 6 = Saturday 7 = Sunday

Command Default

The work week starts on Monday.

Command Modes

TimeCardview configuration (config-timecardview)

Command History

TimeCardView Version	Modification
7.0	This command was introduced.

Usage Guidelines

Each time you configure the week start day, you overwrite any preceding configuration of it.

Examples

The following example illustrates the process of setting the day of the week on which work is to start and verifying the result:

se-10-0-0-0# config t

Enter configuration commands, one per line.  End with CNTL/Z.

se-10-0-0-0(config)# service timecardview

se-10-0-0-0(config-timecardview)# week-start day 3

se-10-0-0-0(config-timecardview)# end

se-10-0-0-0(config)# end

se-10-0-0-0# show timecardview configuration

Service: Enabled

Maximum Sessions: 2

Supervisor Session logout time (secs): 600

Employee Session logout time (secs): 120

Week Start Day: Wednesday

[...]

se-10-0-0-0#

Related Commands

Command	Description
copy timecardview timesheets url	Creates a comma-separated values (CSV) file and copies it to an FTP server.
daily	Limits the number of regular and overtime hours TimeCardView users can work.
service timecardview	Enters TimeCardView configuration mode.
shift limit	Limits the amount of time TimeCardView users can spend in the work, lunch, and break states.
show timecardview configuration	Displays TimeCardView configuration.