[XML-DEV Mailing List Archive Home] [By Thread] [By Date] [Recent Entries] [Reply To This Message]

RE: Schematron Question: proper way to express the text versio

  • From: "Costello, Roger L." <costello@m...>
  • To: <xml-dev@l...>
  • Date: Mon, 12 Feb 2007 09:09:26 -0500

RE:  Schematron Question: proper way to express the text versio
Michael Kay wrote:

> You can't design error messages ...

No, it's not an error message that is being specified within the
<sch:assert> element.  Error messages are specified in a diagnostic:

<sch:assert test="EndTime &gt; StartTime" diagnostics="lessThan">
             -- text version of assertion --

      <sch:diagnostic id="lessThan">
                        -- Put error message here --

The message that is specified within the <sch:assert> element is a
natural language version of the XPath expression (in the assertion's
test attribute).  

My question is with regards to the proper way to express that natural
language statement.  Namely, is it expressed using "is", or "should
be", or "must be".


-----Original Message-----
From: Michael Kay [mailto:mike@s...] 
Sent: Monday, February 12, 2007 8:58 AM
To: Costello, Roger L.; xml-dev@l...
Subject: RE:  Schematron Question: proper way to express the
text version of assertions?

You can't design error messages without knowing the audience they are
designed for. The right answer to your question depends on who you
expect to
see the messages and act on them.

Michael Kay

> -----Original Message-----
> From: Costello, Roger L. [mailto:costello@m...] 
> Sent: 12 February 2007 12:44
> To: xml-dev@l...
> Subject:  Schematron Question: proper way to express 
> the text version of assertions?
> Hi Folks,
> Consider this simple XML document:
> <Meeting>
>       <StartTime>0900</StartTime>
>       <EndTime>1000</EndTime>
> </Meeting>
> With Schematron I can express this data constraint: 
>        "The Meeting's EndTime must be after its StartTime"
> This is expressed using a Schematron rule:
> <sch:rule context="Meeting">
>      <sch:assert test="EndTime &gt; StartTime">
>              -- text version of assertion --
>      </sch:assert>
> </sch:rule>
> Read as: "In the context of the Meeting element, I assert 
> that the value of EndTime must be greater than the value of
> Question:
> Within the <sch:assert> element you can provide a textual 
> description of the assertion (which I indicate above using 
> "-- text version of assertion --").  What is the best way of 
> stating the text version of an
> assertion: 
>          "is", "should be", or "must be"?
> For the above example, which of these is best:
> (a) EndTime is greater than StartTime
> (b) EndTime should be greater than StartTime 
> (c) EndTime must be greater than StartTime
> Or perhaps something else?
> What is recommended?
> /Roger
> ______________________________________________________________
> _________
> XML-DEV is a publicly archived, unmoderated list hosted by 
> OASIS to support XML implementation and development. To 
> minimize spam in the archives, you must subscribe before posting.
> [Un]Subscribe/change address: http://www.oasis-open.org/mlmanage/
> Or unsubscribe: xml-dev-unsubscribe@l...
> subscribe: xml-dev-subscribe@l... List archive: 
> http://lists.xml.org/archives/xml-dev/
> List Guidelines: http://www.oasis-open.org/maillists/guidelines.php

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index]


Purchasing Stylus Studio from our online shop is Easy, Secure and Value Priced!

Buy Stylus Studio Now

Download The World's Best XML IDE!

Accelerate XML development with our award-winning XML IDE - Download a free trial today!

Don't miss another message! Subscribe to this list today.
First Name
Last Name
Subscribe in XML format
RSS 2.0
Atom 0.3

Stylus Studio has published XML-DEV in RSS and ATOM formats, enabling users to easily subcribe to the list from their preferred news reader application.

Stylus Studio Sponsored Links are added links designed to provide related and additional information to the visitors of this website. they were not included by the author in the initial post. To view the content without the Sponsor Links please click here.

Site Map | Privacy Policy | Terms of Use | Trademarks
Free Stylus Studio XML Training:
W3C Member
Stylus Studio® and DataDirect XQuery ™are products from DataDirect Technologies, is a registered trademark of Progress Software Corporation, in the U.S. and other countries. © 2004-2013 All Rights Reserved.