A given document entry can have zero, one, or multiple schedules for conversion. If an entry has one or more schedules for conversion then when a scheduled conversion is called upon for the conversion list file containing it, then its schedules are checked to see whether it is scheduled for conversion at that time. A schedule can be set to cause a conversion to happen once, hourly, daily, weekly, monthly, or always whenever a scheduled conversion occurs.
An example of where multiple schedules can come in handy is in the case of a news site that has daily, weekly, and monthly summaries of the corresponding period's most popular news articles. The daily schedule might be set to occur every weekday at 8PM, the weekly schedule might be set to occur every week on Saturday at 9AM, and the monthly schedule might be set to occur every month on the last day of the month at 10PM.
See Setting Up Schedules for more information on how to set up schedules.
<Scheduling>
<Disable value="no"/>
<LastConversion>2003/03/11 16:23:02</LastConversion>
<NextConversion>2003/03/12 15:17:00</NextConversion>
<Schedules>
<Schedule>
<Disable value="no"/>
<LastConversion>2003/03/11 16:23:02</LastConversion>
<NextConversion>2003/03/12 15:17:00</NextConversion>
<Frequency value="hourly"/>
<Time value="17"/>
<Weekday value="Mon"/>
<Day value="31"/>
<Type value="every"/>
<Every value="1"/>
</Schedule>
</Schedules>
</Scheduling>
| Tag | Type | Default | Description |
|---|---|---|---|
<Disable>
| value | no | Whether to disable scheduled conversions. |
<LastConversion>
| string | n/a | The date and time of the last scheduled conversion. |
<NextConversion>
| string | n/a | The date and time of the next scheduled conversion. |
<Schedules>
| container | n/a | Holds the scheduled conversion schedules. |
yes
to disable scheduled conversions of the document entry
or no to enable them. If a document
entry has no schedules, then it is never converted during
a scheduled conversion.<Disable value="yes"/>This example specifies that scheduled conversions are enabled.
<Disable value="no"/>
<LastConversion>2003/03/15 13:05:00</LastConversion>This example specifies that the last scheduled conversion occurred on October 10, 2010 at 10:10AM.
<LastConversion>2010/10/10 10:10:00</LastConversion>
The next conversion date and time specified here should be the earliest next conversion date and time of all enabled schedules specified for the entry. Normally you do not set this element manually unless you want to override the next scheduled conversion date and time.
When iSiloX and iSiloXC perform a scheduled conversion,
they check the next conversion date and time specified by
this element. If the current date and time are at or after
the specified next conversion date and time, then the
entry is converted and the next conversion date and time
is updated to the earliest next scheduled conversion date
and time as determined by the schedules for the entry.
Examples
This example specifies that the next scheduled conversion will occur on
April 1, 2003 at 1:05PM.
<NextConversion>2003/04/01 13:05:00</NextConversion>This example specifies that the next scheduled conversion will occur on October 10, 2010 at 10:10AM.
<NextConversion>2010/10/10 10:10:00</NextConversion>
| Tag | Type | Default | Description |
|---|---|---|---|
<Schedule>
| container | n/a | Holds information about a schedule. |
| Tag | Type | Default | Description |
|---|---|---|---|
<Disable>
| value | no | Whether to disable the schedule. |
<LastConversion>
| string | n/a | The date and time of the last scheduled conversion. |
<NextConversion>
| string | n/a | The date and time of the next scheduled conversion. |
<StartDate>
| string | n/a | The starting date and time when the schedule is enabled. |
<EndDate>
| string | n/a | The date and time after which the schedule becomes disabled. |
<Frequency>
| value | n/a | How often to schedule a conversion. |
<Time>
| value | 0 | The time of the scheduled conversion. |
<Weekday>
| value | Mon | For weekly schedules, the weekday of the scheduled conversion. |
<Day>
| value | 1 | For monthly schedules, the day of the month for the scheduled conversion. |
<Type>
| value | every | Specifies periodic or chosen times. |
<Every>
| value | 1 | Specifies the periodic time interval. |
<Only>
| string | n/a | Specifies chosen times. |
yes
to disable the schedule or no to enable it.<Disable value="yes"/>This example specifies that schedule is not disabled.
<Disable value="no"/>
If the NextConversion element for the schedule is missing,
then the last conversion date and time as specified by the
LastConversion element is used to determine
when the next next scheduled conversion for the schedule should
occur.
Examples
This example specifies that the last scheduled conversion for this
schedule occurred on March 15, 2003 at 1:05PM.
<LastConversion>2003/03/15 13:05:00</LastConversion>This example specifies that the last scheduled conversion occurred on October 10, 2010 at 10:10AM.
<LastConversion>2010/10/10 10:10:00</LastConversion>
Normally you do not set this element manually unless you want to override the next scheduled conversion date and time for the schedule.
After iSiloX and iSiloXC perform a scheduled conversion
for a schedule, the next conversion element of the schedule
is updated to the next scheduled conversion date and time.
For example, if a schedule specifies a daily conversion
frequency that is to occur every day at 10:00AM, then if
today is March 15, 2003 and the time is 10:00AM, and a
scheduled conversion occurs, then the next scheduled conversion
is updated to be on March 16, 2003 at 10:00AM.
Examples
This example specifies that the next scheduled conversion
for the schedule will occur on March 16, 2003 at about 10:00AM.
<NextConversion>2003/03/16 10:00:00</NextConversion>This example specifies that the next scheduled conversion for the schedule will occur on October 10, 2010 at 10:10AM.
<NextConversion>2010/10/10 10:10:00</NextConversion>
The first scheduled conversion using the schedule containing this element does not occur until at or after the specified start date and time. A schedule that does not specify a start date and time is immediately in effect.
For a one-time scheduled conversion, the StartDate
element gives the date and time of the one-time scheduled
conversion.
Examples
This example specifies that the schedule does not take effect
until June 10, 2003 at 12:00AM.
<StartDate>2003/06/10 00:00:00</StartDate>
After the end date and time have been reached, scheduled
conversions according to the schedule containing this element
no longer occur. A schedule that does not specify an end date
and time remains in effect indefinitely.
Examples
This example specifies that scheduled conversions according
to the schedule containing this element no longer occur
after July 2, 2003 at 11:30PM.
<EndDate>2003/07/02 23:30:00</EndDate>
<Frequency value="once">This example schedules an hourly scheduled conversion.
<Frequency value="hourly">This example schedules a daily scheduled conversion.
<Frequency value="daily">This example schedules a weekly scheduled conversion.
<Frequency value="weekly">This example schedules a monthly scheduled conversion.
<Frequency value="monthly">This example specifies that the document should be converted anytime there is a scheduled conversion.
<Frequency value="always">
<Time value="18">For a daily, weekly, or monthly schedule, the following example schedules the conversion to occur at 1:20PM.
<Time value="1320">
<Weekday value="Mon">For a weekly schedule, the following example schedules the conversion to occur on Saturday.
<Weekday value="Sat">
<Day value="1">For a monthly schedule, the following example schedules the conversion to occur on the tenth day of the month.
<Day value="10">For a monthly schedule, the following example schedules the conversion to occur on the last day of the month.
<Day value="31">
<Type value="every"> <Every value="2">Examples
<Type value="only"> <Only>3,6</Only>
every.
For an hourly schedule, set the value attribute of the tag
to the number of hours between conversions.
For a daily schedule, set the value attribute of the tag
to the number of days between conversions.
For a weekly schedule, set the value attribute of the tag
to the number of weeks between conversions.
For a monthly schedule, set the value attribute of the tag
to the number of monthly between conversions.<Type value="every"> <Every value="1">For a daily schedule, the following example schedules the conversion to occur once every five days.
<Type value="every"> <Every value="5">For a weekly schedule, the following example schedules the conversion to occur once every two weeks.
<Type value="every"> <Every value="2">For a monthly schedule, the following example schedules the conversion to occur once every three months.
<Type value="every"> <Every value="3">
only.
For an hourly schedule, set the element content to a comma-separated list of the hours of the day during which to schedule a conversion. The hours of the day are represented by the numbers 0 through 23 as follows:
For a daily schedule, set the element content to a comma-separated list of the days of the week during which to schedule a a conversion. The days of the week are specified using their three letter abbreviations:
For a weekly schedule, set the element content to a comma-separated list of the weeks of the month during which to schedule a conversion. The weeks of the month are represented by the numbers 1 through 5 as follows:
For a monthly schedule, set the element content to a comma-separated list of the months of the year during which to schedule a conversion. The months of the year are represented by the numbers 1 through 12 as follows:
<Type value="only"> <Only>15,22,0</Only>For a daily schedule, the following example schedules the conversion to occur only on Monday and Friday.
<Type value="only"> <Only>Mon,Fri</Only>For a weekly schedule, the following example schedules the conversion to occur only on the first and last weeks of the month.
<Type value="only"> <Only>1,5</Only>For a monthly schedule, the following example schedules the conversion to occur only in January, May, July, and September.
<Type value="only"> <Only>1,5,7,9</Only>
once.
<Schedule>
<Frequency value="once">
<StartDate>2003/06/10 00:00:00</StartDate>
</Schedule>
This example schedules a one-time conversion to occur
on May 29, 2005 at 2:18PM.
<Schedule>
<Frequency value="once">
<StartDate>2005/05/29 14:18:00</StartDate>
</Schedule>
hourly.
every
and specify the hourly interval in the value attribute of the
Every tag.
only
and provide a comma-separated list of the hours of the day
in the content of the Only element.
<Schedule>
<Frequency value="hourly">
</Schedule>
This example schedules conversions to occur every hour
at 15 minutes after the hour.
<Schedule>
<Frequency value="hourly">
<Time value="15">
</Schedule>
This example schedules conversions to occur every six
hours at the beginning of the hour.
<Schedule>
<Frequency value="hourly">
<Type value="every">
<Every value="6">
</Schedule>
This example schedules conversions to occur every eight
hours at fifty minutes after the hour.
<Schedule>
<Frequency value="hourly">
<Time value="50">
<Type value="every">
<Every value="8">
</Schedule>
This example schedules conversions to occur only
at 1PM, 3PM, and 4PM.
<Schedule>
<Frequency value="hourly">
<Type value="only">
<Only>13,15,16</Only>
</Schedule>
This example schedules conversions to occur only
at 6:30AM and 8:30PM.
<Schedule>
<Frequency value="hourly">
<Time value="30">
<Type value="only">
<Only>6,20</Only>
</Schedule>
This example schedules conversions to occur every hour
at 59 minutes after the hour starting from June 3, 2003.
<Schedule>
<Frequency value="hourly">
<Time value="59">
<StartDate>2003/06/03 00:00:00</StartDate>
</Schedule>
This example schedules conversions to occur every hour
at the beginning of the hour
until and including October 31, 2003 at 5PM.
<Schedule>
<Frequency value="hourly">
<EndDate>2003/10/31 17:00:00</EndDate>
</Schedule>
This example schedules conversions to occur every hour
at the beginning of the hour only from December 20, 2003
at 2AM to December 30, 2003 at 1AM.
<Schedule>
<Frequency value="hourly">
<StartDate>2003/12/20 02:00:00</StartDate>
<EndDate>2003/12/30 01:00:00</EndDate>
</Schedule>
daily.
every
and specify the daily interval in the value attribute of the
Every tag.
only
and provide a comma-separated list of the days of the week
in the content of the Only element.
<Schedule>
<Frequency value="daily">
</Schedule>
This example schedules conversions to occur every day
at 8:15AM.
<Schedule>
<Frequency value="daily">
<Time value="0815">
</Schedule>
This example schedules conversions to occur every five
days at 12AM.
<Schedule>
<Frequency value="daily">
<Type value="every">
<Every value="5">
</Schedule>
This example schedules conversions to occur every six
days at 3:08PM.
<Schedule>
<Frequency value="daily">
<Time value="1508">
<Type value="every">
<Every value="6">
</Schedule>
This example schedules conversions to occur only
on Monday, Wednesday, and Friday at 12AM.
<Schedule>
<Frequency value="daily">
<Type value="only">
<Only>Mon,Wed,Fri</Only>
</Schedule>
This example schedules conversions to occur only
Saturday and Sunday at 6:00AM.
<Schedule>
<Frequency value="daily">
<Time value="0600">
<Type value="only">
<Only>Sat,Sun</Only>
</Schedule>
This example schedules conversions to occur every day
at 9:10AM starting from July 4, 2003.
<Schedule>
<Frequency value="daily">
<Time value="0910">
<StartDate>2003/07/04 00:00:00</StartDate>
</Schedule>
This example schedules conversions to occur every day
at 12AM until and including September 1, 2003 at 12AM.
<Schedule>
<Frequency value="daily">
<EndDate>2003/09/01 00:00:00</EndDate>
</Schedule>
This example schedules conversions to occur every day
at 1:20AM from November 13, 2003 12AM
to November 17, 2003 12AM.
Note that the last scheduled conversion will actually
be November 16 at 1:20AM, since the time 1:20AM
of the following day is after the end date and time
of November 17, 2003 12AM.
<Schedule>
<Frequency value="daily">
<Time value="0120">
<StartDate>2003/11/13 00:00:00</StartDate>
<EndDate>2003/11/17 00:00:00</EndDate>
</Schedule>
weekly.
every
and specify the weekly interval in the value attribute of the
Every tag.
only
and provide a comma-separated list of the weeks of the month
in the content of the Only element.
<Schedule>
<Frequency value="weekly">
</Schedule>
This example schedules conversions to occur every week
on Monday at 3:05PM.
<Schedule>
<Frequency value="weekly">
<Time value="1505">
</Schedule>
This example schedules conversions to occur every week
on Thursday at 5:11PM.
<Schedule>
<Frequency value="weekly">
<Time value="1711">
<Weekday value="Thu">
</Schedule>
This example schedules conversions to occur every two
weeks on Monday at 12AM.
<Schedule>
<Frequency value="weekly">
<Type value="every">
<Every value="2">
</Schedule>
This example schedules conversions to occur every three
weeks on Tuesday at 7:00AM.
<Schedule>
<Frequency value="weekly">
<Time value="0700">
<Weekday value="Tue">
<Type value="every">
<Every value="3">
</Schedule>
This example schedules conversions to occur only
on the first and last weeks of the month on Friday at 12AM.
<Schedule>
<Frequency value="weekly">
<Weekday value="Fri">
<Type value="only">
<Only>1,5</Only>
</Schedule>
This example schedules conversions to occur only
on the second and fourth weeks of the month on Monday at 5:45AM.
<Schedule>
<Frequency value="weekly">
<Time value="0545">
<Type value="only">
<Only>2,4</Only>
</Schedule>
This example schedules conversions to occur every week
on Monday at 8:53AM starting from August 29, 2003.
<Schedule>
<Frequency value="weekly">
<Time value="0853">
<StartDate>2003/08/29 00:00:00</StartDate>
</Schedule>
This example schedules conversions to occur every week
on Monday at 12AM until and including June 30, 2003 at 12AM.
<Schedule>
<Frequency value="weekly">
<EndDate>2003/06/30 00:00:00</EndDate>
</Schedule>
This example schedules conversions to occur every week
on Saturday at 1:14PM from December 1, 2003 12AM
to January 31, 2004 12AM.
Note that the last scheduled conversion will actually
be January 27, 2004 at 1:14PM, since the time 1:14PM
of the following Monday is after the end date and time
of January 31, 2004 12AM.
<Schedule>
<Frequency value="weekly">
<Time value="1314">
<Weekday value="Sat">
<StartDate>2003/12/01 00:00:00</StartDate>
<EndDate>2004/01/31 00:00:00</EndDate>
</Schedule>
monthly.
every
and specify the monthly interval in the value attribute of the
Every tag.
only
and provide a comma-separated list of the months of the year
in the content of the Only element.
<Schedule>
<Frequency value="monthly">
</Schedule>
This example schedules conversions to occur every month
on the first day of the month at 6:39PM.
<Schedule>
<Frequency value="monthly">
<Time value="1839">
</Schedule>
This example schedules conversions to occur every month
on the tenth day of the month at 9:30AM.
<Schedule>
<Frequency value="monthly">
<Time value="0930">
<Day value="10">
</Schedule>
This example schedules conversions to occur every three
months on the first day of the month at 12AM.
<Schedule>
<Frequency value="monthly">
<Type value="every">
<Every value="3">
</Schedule>
This example schedules conversions to occur every five
months on the 21st day of the month at 6:00AM.
<Schedule>
<Frequency value="monthly">
<Time value="0600">
<Day value="21">
<Type value="every">
<Every value="5">
</Schedule>
This example schedules conversions to occur only
on January and February on the last day of the month at 12AM.
<Schedule>
<Frequency value="monthly">
<Day value="31">
<Type value="only">
<Only>1,2</Only>
</Schedule>
This example schedules conversions to occur only
on February, October, and November on the first day
of the month at 6:51AM.
<Schedule>
<Frequency value="monthly">
<Time value="0651">
<Type value="only">
<Only>2,10,11</Only>
</Schedule>
This example schedules conversions to occur every month
on the first day of the month at 10:11AM
starting from November 9, 2003.
<Schedule>
<Frequency value="monthly">
<Time value="1011">
<StartDate>2003/11/09 00:00:00</StartDate>
</Schedule>
This example schedules conversions to occur every month
on the first day of the month at 12AM until and including
December 1, 2003 at 12AM.
<Schedule>
<Frequency value="monthly">
<EndDate>2003/12/01 00:00:00</EndDate>
</Schedule>
This example schedules conversions to occur every month
on the 25th day of the month at 8:38PM from
December 1, 2003 12AM to December 1, 2004 12AM.
Note that the first scheduled conversion will occur
on December 25, 2003 and the last scheduled conversion
will occur on November 25, 2004 at 8:38PM.
<Schedule>
<Frequency value="monthly">
<Time value="2038">
<Day value="25">
<StartDate>2003/12/01 00:00:00</StartDate>
<EndDate>2004/12/01 00:00:00</EndDate>
</Schedule>
always.
<Schedule>
<Frequency value="always">
</Schedule>
This example schedules conversions to occur whenever any
other document entry has a scheduled conversion that occurs
from February 1, 2004 at 2AM to March 3, 2004 at 12AM.
<Schedule>
<Frequency value="always">
<StartDate>2004/02/01 02:00:00</StartDate>
<EndDate>2004/03/03 00:00:00</EndDate>
</Schedule>
<Scheduling>
<Schedules>
<Schedule>
<Frequency value="daily"/>
<Time value="2000"/>
<Type value="only">
<Only>Mon,Tue,Wed,Thu,Fri</Only>
</Schedule>
<Schedule>
<Frequency value="weekly"/>
<Time value="0900"/>
<Weekday value="Sat"/>
</Schedule>
<Schedule>
<Frequency value="monthly"/>
<Time value="2200"/>
<Day value="31"/>
</Schedule>
</Schedules>
</Scheduling>