﻿<?xml version="1.0" encoding="utf-8"?>
<?xml-stylesheet href="../scheduler.xsl" type="text/xsl"?>

<!--$Id$-->
<!--         title    = "Zeitplan"-->

<xml_element name     = "schedule"
             title    = "Schedule"
             category = "Configuration"
             base_dir = "../"
             parent_page = "../konfiguration.xml"
             author   = "$Author: jz $"
             date     = "$Date: 2012-06-12 21:25:54 +0200 (Di, 12 Jun 2012) $">

    <xml_parent_elements>
        <xml_parent_element name="schedules"/>
    </xml_parent_elements>


    <xml_attributes>
        <xml_attribute name="name" type="name">
            <description>
                <p>
                    The schedule name.
                <!--Der Name des Zeitplans.-->
                </p>
                <p>
                    A named schedule can be called up using <scheduler_element name="run_time" attribute="schedule"/>.<!-- Bedeutung ok -->
                <!--Ein so benannter Zeitplan kann mit <scheduler_element name="run_time" attribute="schedule"/> abgerufen werden.-->
                </p>
            </description>
        </xml_attribute>
        
        
        <xml_attribute name="substitute" type="schedule_path" title="A schedule for temporary substitution">
    <!--<xml_attribute name="substitute" type="schedule_path" title="Zeitweilig zu überdeckender Zeitplan">-->
            <description>
                <p>
                    The schedule specified using <code>substitute="<i>schedule_path</i>"</code> 
                    should be replaced with the temporary schedule defined here.
                <!--Der mit <code>substitute="<i>schedule_path</i>"</code> angegebene Zeitplan
                    soll zeitweilig durch den hier definierten überdeckt werden.-->
                </p>
                <p>
                    The substitution period is specified using <code>valid_from=</code> and <code>valid_to=</code>.
                <!--Die Zeitspanne wird mit den Attributen <code>valid_from=</code> und <code>valid_to=</code> angegeben.-->
                </p>
                <p>
                    A temporary schedule cannot be directly called using 
                    <scheduler_element name="run_time" attribute="schedule"/>.
                <!--Ein überdeckender Zeitplan kann nicht direkt mit <scheduler_element name="run_time" attribute="schedule"/> abgerufen werden.-->
                </p>
            </description>

            <messages>
                <message level="info"  code="SCHEDULER-705"/>
                <message level="info"  code="SCHEDULER-706"/>
                <message level="error" code="SCHEDULER-463"/>
            </messages>
        </xml_attribute>

        <xml_attribute name="valid_from" type="yyyy-mm-dd HH:MM[:ss]">
            <description>
                <p>
                    If <code>substitute=</code> has been specified and <code>valid_from=</code> not specified,
                    then the schedule specified will be substituted immediately.
                <!--Ist <code>substitute=</code> angegeben und fehlt <code>valid_from=</code>,
                    dann wird der angegebene Schedule ab sofort überdeckt.-->
                </p>
            </description>

            <messages>
                <message level="error" code="SCHEDULER-465"/>
                <message level="error" code="SCHEDULER-466"/>
            </messages>
        </xml_attribute>

        <xml_attribute name="valid_to" type="yyyy-mm-dd HH:MM[:ss]">
            <description>
                <p>
                    If <code>substitute=</code> has been specified and <code>valid_from=</code> not,
                    then substitution will continue indefinitely.
                <!--Ist <code>substitute=</code> angegeben und fehlt <code>valid_to=</code>,
                    dann endet die Überdeckung nicht.-->
                </p>
            </description>

            <messages>
                <message level="error" code="SCHEDULER-464"/>
                <message level="error" code="SCHEDULER-465"/>
                <message level="error" code="SCHEDULER-466"/>
            </messages>
        </xml_attribute>

    </xml_attributes>



    <description>
        <p>
            The other elements and attributes that can be specified for 
            <scheduler_element name="run_time"/> can also be specified here,
            with the exception of <code>schedule=</code> and <code>time-zone</code>.
        <!--Außer den hier beschriebenen Attributen und Elementen können die von <scheduler_element name="run_time"/> angegeben werden,
            aber nicht <code>schedule=</code> oder <code>time-zone</code>.-->
        </p>
        <p>
            With distributed orders, a change in <code>&lt;schedule></code> only takes effect 
            the next time the order proceeds along the job chain.
        <!--Bei verteilten Aufträgen wirkt die Änderung eines <code>&lt;schedule></code> erst, 
            wenn der Auftrag das nächste Mal die Jobkette durchlaufen hat.-->
        </p>
    </description>

</xml_element>
