cfschedule

The "result" attribute is undocumented. It is used for the list action. The result attribute should be documented in these 2 places:

1) "History" (ColdFusion Zeus: Added the attributes..)

2) Attributes table

Thanks,

-Aaron

Three more things:

1) The "Chained Task" feature should be documented.

2) The 'Required if action="update"' should be removed from the Req/Opt column for "Operation". This is b/c operation has a default value: HTTPRequest. Thus it is not required to pass this attribute.

3) The interval, startDate, and startTime attributes are no longer required for action="update" in CF10. If omitted, the task will become a chained task. So the 'Required if action="update"' should be removed from the Req/Opt column for each of these 3 attributes as well.

Thanks,

-Aaron Neff

It might be helpful to add this note: "ColdFusion does not invoke Application.cfc methods, when invoking a task's event handler methods."

(This is by design, per: #3151858.)

Thanks!,

-Aaron

The "invokeHandler" should probably be removed from the "Default" column for onComplete, b/c onComplete does not have a default value.

Thanks,

-Aaron

"isDaily" is not a valid attribute and should be removed from the attributes table.

Thanks,

-Aaron

it also looks like the "Group" property is required for deleting tasks

Would be kind of helpful if you were just able to get the status of a scheduled task (on,off,paused...)

@Lucas Sherwood, the group attribute is only required when deleting a task if the task isn't in the 'default' group.  Examples:

(The group attribute is omitted in the 1st example, b/c the default value for the group attribute is 'default'.)

Thanks,

-Aaron

It'd help if comments didn't hide code.  Here are the examples again, just replace the square brackets w/ angle brackets:

[cfschedule action="update" task="myTask" startdate="1/1/2012" starttime="12:00 AM" interval="once" url="http://a" /]

[cfschedule action="delete" task="myTask" /]

[cfschedule action="update" task="myTask" startdate="1/1/2012" starttime="12:00 AM" interval="once" url="http://a" group="default" /]

[cfschedule action="delete" task="myTask" /]

@MrMJackson, here are some examples for returning a task's status (Running/Paused/Expired):

[cfschedule action="update" task="myTask" startdate="1/1/2014" starttime="12:00 AM" interval="monthly" url="http://a" /]

[cfschedule action="list" task="myTask" result="q1" /]

[cfdump var="#q1.status#" /]

[cfschedule action="pause" task="myTask" /]

[cfschedule action="list" task="myTask" result="q2" /]

[cfdump var="#q2.status#" /]

Returns: Running Paused

[cfschedule action="update" task="myTask" startdate="1/1/2011" starttime="12:00 AM" interval="once" url="http://a" /]

[cfschedule action="list" task="myTask" result="q3" /]

[cfdump var="#q3.status#" /]

[cfschedule action="list" result="q4" /]

[cfdump var="#q4.status#" /]

Returns: Running Expired

That should return "Expired Expired". I will file a bug.

Thanks,

-Aaron

The 'file' attribute's description should note: "The file can only have a .txt or .log extension by default. You can add more extensions in cfusion\lib\neo-cron xml."

This restriction is new in ColdFusion 10.  ER #3336106 has been filed to also support .htm & .html extensions by default: https://bugbase.adobe.com/index.cfm?event=bug&id=3336106

Those who may want more information on the new scheduling feature in CF10 should see the corresponding chapter in the "Developing CF Apps" manual of the CF docs: http://help.adobe.com/en_US/ColdFusion/10.0/Developing/WSe61e35da8d31851899e53a51353e87049 3-8000.html