Printer Services Mail Archive: RE: PS> Last call ready Event

RE: PS> Last call ready Events schema v0.41 (14 July 2004)

From: Zehler, Peter (PZehler@crt.xerox.com)
Date: Thu Jul 15 2004 - 08:14:58 EDT

  • Next message: McDonald, Ira: "RE: PS> Last call ready Events schema v0.41 (14 July 2004)"

    Ira,

    One thing I noticed is that VendorEventType values (i.e. extensions) are not
    federated through the use of namespaces. The way this is handled in the
    rest of the PWG schema is a restriction that requires a ':' in the value.

    To accomplish this the definition would change from:
    <xsd:simpleType name="VendorEventType">
                    <xsd:restriction base="xsd:NMTOKEN"/>
                    <!-- vendor event type - for site or vendor extensions -->
                    <!-- see PWG Print Service Interface/1.0 [PWG-PSI] -->
            </xsd:simpleType>
     
    to:
    <xsd:simpleType name="VendorEventType">
                    <xsd:restriction base="xsd:NMTOKEN">
                    <!-- vendor event type - for site or vendor extensions -->
                    <!-- see PWG Print Service Interface/1.0 [PWG-PSI] -->
                        <xsd:restriction base="xsd:NMTOKEN">
                            <xsd:pattern value="\w+:[\w_\-\.]+"/>
                          </xsd:restriction>
                </xsd:simpleType>

    The other thing I noticed is that since the events are specified as
    enumerations a major revision will be necessary to add any new values. The
    way the rest of the schema handles this is through the use of a union. If
    the intent is these are a type I enumeration the definition is fine. If
    they are type II or III enumerations the definitions should be changed.

    For example DocumentEventType would change from:
    <xsd:simpleType name="DocumentEventType">
                    <xsd:restriction base="xsd:NMTOKEN">
                            <xsd:enumeration value="DocumentStateChanged"/>
                            <xsd:enumeration value="DocumentStateOnlyChanged"/>
                            <xsd:enumeration value="DocumentCreated"/>
                            <xsd:enumeration value="DocumentCompleted"/>
                            <xsd:enumeration value="DocumentConfigChanged"/>
                            <xsd:enumeration value="DocumentProgress"/>
                            <xsd:enumeration value="DocumentError"/>
                            <xsd:enumeration value="DocumentWarning"/>
                    </xsd:restriction>
                    <!-- document event type - derived from job event type -->
                    <!-- see PWG Print Service Interface/1.0 [PWG-PSI] -->
                    <!-- see document-state - section 9.1.25 [PWG5100.5] -->
                    <!-- see document-state-message - section 9.1.26 [PWG5100.5]
    -->
                    <!-- see document-state-reasons - section 9.1.27 [PWG5100.5]
    -->
            </xsd:simpleType>

    To (Note DocumentEventTypes not required and can be replaced with
    DocumentEventWKVs):
    <xsd:simpleType name="DocumentEventWKVs">
            <xsd:restriction base="xsd:NMTOKEN">
                    <xsd:enumeration value="DocumentStateChanged"/>
                    <xsd:enumeration value="DocumentStateOnlyChanged"/>
                    <xsd:enumeration value="DocumentCreated"/>
                    <xsd:enumeration value="DocumentCompleted"/>
                    <xsd:enumeration value="DocumentConfigChanged"/>
                    <xsd:enumeration value="DocumentProgress"/>
                    <xsd:enumeration value="DocumentError"/>
                    <xsd:enumeration value="DocumentWarning"/>
              </xsd:restriction>
            </xsd:simpleType>

    <xsd:simpleType name="DocumentEventType">
            <xsd:restriction base="DocumentEventWKVs"/>
    </xsd:simpleType>

    <xsd:complexType name="DocumentEvents">
            <xsd:sequence>
                    <xsd:element name="DocumentEvent" minOccurs="0"
    maxOccurs="unbounded">
                            <xsd:simpleType>
                                    <xsd:union memberTypes="DocumentEventType
    KeywordNsExtensionPattern"/>
                            </xsd:simpleType>
                    </xsd:element>
                    <xsd:element name="VendorEvent" type="VendorEventType"
    minOccurs="0" maxOccurs="unbounded"/>
            </xsd:sequence>
            <!-- list of document events -->
    </xsd:complexType>

    (from PwgWellKnownValues:
            <xsd:simpleType name="KeywordNsExtensionPattern">
                    <xsd:restriction base="xsd:NMTOKEN">
                            <xsd:pattern value="\w+:[\w_\-\.]+"/>
                    </xsd:restriction>
            </xsd:simpleType>
    )

    Pete

    Peter Zehler
    XEROX
    Xerox Innovation Group
    Email: PZehler@crt.xerox.com
    Voice:    (585) 265-8755
    FAX:      (585) 422-7961
    US Mail: Peter Zehler
                  Xerox Corp.
            800 Phillips Rd.
            M/S 128-25E
                  Webster NY, 14580-9701

    -----Original Message-----
    From: McDonald, Ira [mailto:imcdonald@sharplabs.com]
    Sent: Wednesday, July 14, 2004 6:35 PM
    To: 'ps@pwg.org'
    Subject: PS> Last call ready Events schema v0.41 (14 July 2004)

    Hi folks, Wednesday (14 July 2004)

    Ready for PWG 'last call', I just posted the Events XML schema v0.41
    in the PSI working group directory tree. It validates without
    warnings using XML SPY 2004, XRay 2.0, and XSV 2.5 (the free XML Schema
    Validator):

        ftp://ftp.pwg.org/pub/pwg/ps/schemas/events-20040714.xsd

    NOTE: The _next_ version of PSI/1.0 (for PWG 'last call') will include
    definitions of standard print system events in a new Appendix. This
    Events schema references that (to be published) version of PSI/1.0.

    **** We intend to submit PSI/1.0 and this companion Events schema for
    PWG 'last call' no later than 26 July 2004, for conclusion at the
    Plenary on Wednesday 18 August 2004 at the PWG face-to-face in Montreal.

    Cheers,
    - Ira

    Ira McDonald (Musician / Software Architect)
    Blue Roof Music / High North Inc
    PO Box 221 Grand Marais, MI 49839
    phone: +1-906-494-2434
    email: imcdonald@sharplabs.com

    ------------------------------------------------------------------------

    [changes from Events v0.40 to v0.41]

    (1) Minor editorial changes.

    (2) Added standard PWG SM/1.0 target namespace to schema declaration,
        per request of Masonori Itoh (Ricoh).

    (3) Added type names (e.g., <xsd:complexType name="JobEvents">) to all
        event groups (e.g., JobEvents), for support of PSI parameters,
        per PSI WG telecon 6 July 2004.

    (4) Added normative reference to PSI/1.0 spec for event definitions
        (new appendix to be added w/ Std Print System Events spec content),
        per PSI WG telecon 6 July 2004.

    (5) Added detailed informative references to IPP/1.1 (RFC 2911),
        IPP Document Object (PWG 5100.5), Printer MIB v2 (RFC 3805), and
        IPP Event Notifications and Subscriptions (IESG-approved),
        for implementor convenience.

    ------------------------------------------------------------------------



    This archive was generated by hypermail 2b29 : Thu Jul 15 2004 - 08:20:34 EDT