TodoAdd()

Adds a to-do task to the Time and Task Manager.

Syntax

TodoAdd(<cTaskName>, <[dDueDate]>, <[cNotes]>, <[cStatus]>, <[cPriority]>, <[lRemind]>, <[dRemindDate]>, <[cTime]>, <[cArea]>, <[cTranNo]>, <[cAccount]>, <[cRef]>, <[cUser]>) --> lSuccess

Arguments

<cTaskname> --> The description of the todo list task.

<dDueDate> --> The optional date the task is due to be completed.

<cNotes> --> Optional notes relating to the task.

<cStatus> --> The status of the task. If not specified the default is I (In Progress). Acceptable codes are listed in the following table:

Status Code	Description/Meaning
C	Cancelled
T	Tentative
D	Delegated
F	Finished
I	In Progress
O	On Hold

<cPriority> --> The priority of the task. If not specified the default is M. Acceptable codes are listed in the following table:

Priority Code	Description/Meaning
U	Urgent
H	High
M	Medium
L	Low

<lRemind> --> TRUE = add a reminder to this task. If not specified the default is FALSE.

<dRemindDate> --> If lRemind is TRUE then the reminder date must be specified.

<cTime> --> The time when the reminder should appear. This variable applies only if lRemind is TRUE. If not specified it defaults to 9:00am. You should pass a character value in the format: HH:MMam or HH:MM:pm

<cArea> --> The area where the reminder applies. The default if not specified is A. Acceptable codes are listed in the following table

Area Code	Description/Meaning
A	All areas
G	General
C	Customers
S	Suppliers
J	Job/Service Manager
H	Hire Manager

<cTranNo> --> An optional transaction number.

<cAccount> --> An optional account code.

<cRef> --> An optional reference code that may be up to 20 characters.

<cUser> --> The user name. The default is the currently logged in user.

Returns

This function returns TRUE if a todo task was successfully added to the system.

Description

This function creates a todo list task and adds it to the Appointments & Task Manager.

____________________________