[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]
Subject: RE: [ws-brsp] Two problems that need to be fixed for the WS-BRSP machine readable files
<ter> I fixed the problems, see inserted comments below </ter> ________________________________________ From: ws-brsp@lists.oasis-open.org [ws-brsp@lists.oasis-open.org] On Behalf Of Robin Cover [robin@oasis-open.org] Sent: Thursday, August 29, 2013 3:51 AM To: Jacques Durand Cc: Chet Ensign; ws-brsp@lists.oasis-open.org; Paul Knight; Robin Cover Subject: Re: [ws-brsp] Two problems that need to be fixed for the WS-BRSP machine readable files Thanks, Jacques. And again I regret that I did not keep track of the spec so as to catch the anomaly sooner. I neglected to provide the URI reference for the explanation as to why "real" (tangible, aka "information resources") assets are not located or stored physically in the file system beneath the fictitious /ns/... here it is http://docs.oasis-open.org/specGuidelines/ndr/namingDirectives.html#ns-pathElementReserved As Paul suggested, it should be straight-forward to locate the XSD schema in a real directory as a child to the main prose spec document, for example, and use the path to that XSD file in/as the value of the (pseudo) attribute "schemaLocation". The main thing is to get the XML namespace name itself correct (no /ws-i/ component for a TC-shortName) per the Naming Directives and per our current server configs that support URI rewrites. Paul: let me know if I've overlooked anything more subtle: the fixup seems simple enough. - Robin ================ Earlier: Secondly, one of your resources (or maybe more than one) presents a value for a schemaLocation (pseudo) attribute as: http://docs.oasis-open.org/ns/ws-i/ws-brsp/Profile-TAs/201305 Profile-TAs.xsd That will not work, for at least two reasons: a) the illegal SPACE in the filename: we never install resources in the OASIS Library with SPACE in the directory/file name [SOP] <ter> this is not a file name. this is an xsi:schemaLocation (not an import SchemaLocation). the syntax is xsi:schemaLocation="http://docs.oasis-open.org/ns/ws-i/ws-brsp/Profile-TAs/201305 Profile-TAs.xsd" which states that the namespace http://docs.oasis-open.org/ns/ws-i/ws-brsp/Profile-TAs/201305 is located using the relative uri Profile-TAs.xsd" b) the path portion /ns/ws-i/ws-brsp/Profile-TAs/ does not exist because the /ns/ URI component is just imaginary: no user file or directory is ever stored literally under the /ns/ path portion, which exists just for namespace management <ter> this is not a path, see explanation of xsi:schemaLocation. However i removed the production, since it is not needed and we do not now know the actual schema location for the xsd file for the test assertions. </ter> The explanation for "b)" immediately above is presented also in the Naming Directives: "The pattern specified above for HTTP scheme URIs uses the /ns/ path element in a syntax reserved for identifying non-information resources only. Therefore, no (file-system) regular files, directories/folders, or symbolic links matching information resources may make use of these URI strings for resource identification." BTW: the use of a /ns/ element just for namespace name construction is not an OASIS invention: it's used widely in other SSOs/SDOs. On Wed, Aug 28, 2013 at 8:38 PM, Jacques Durand <JDurand@us.fujitsu.com<mailto:JDurand@us.fujitsu.com>> wrote: Thanks Chet: We’ll look into this with our schema editor, Tom. I think we should be able to fix and submit new CSDs by electronic ballot early September. -jacques From: ws-brsp@lists.oasis-open.org<mailto:ws-brsp@lists.oasis-open.org> [mailto:ws-brsp@lists.oasis-open.org<mailto:ws-brsp@lists.oasis-open.org>] On Behalf Of Chet Ensign Sent: Monday, August 26, 2013 11:29 AM To: Jacques Durand; ws-brsp@lists.oasis-open.org<mailto:ws-brsp@lists.oasis-open.org> Cc: Paul Knight; Robin Cover Subject: [ws-brsp] Two problems that need to be fixed for the WS-BRSP machine readable files Jacques & members of the WS-BRSP TC, In processing the requests for Committee Spec Drafts and public reviews for WS-BRSP, I encountered two problems in the associated machine artifact files that I need the TC to fix. These problems occur in the associated machine readable files for Reliable Secure Profile v1.0, Basic Profile v1.2 and Basic Profile v2.0. 1. The OASIS namespace coined does not follow the namespace rules in the Naming Directives (http://docs.oasis-open.org/specGuidelines/ndr/namingDirectives.html#xml-namespaces). Specifically, the namespace in the schemas and other related files is http://docs.oasis-open.org/ns/ws-i/ws-brsp/Profile-TAs/201305. The legal form is http://docs.oasis-open.org/[tc-shortname]/ns/xxxx<http://docs.oasis-open.org/%5btc-shortname%5d/ns/xxxx> where xxxx is a character string picked by the TC. 2. There is at least one instance (in TestAssertionsBasicProfile-1.2.xml) of an element using a blank space in what appears to be a file name ( <profile… xsi:schemaLocation="http://docs.oasis-open.org/ns/ws-i/ws-brsp/Profile-TAs/201305 Profile-TAs.xsd"). Per the Naming Directives, filenames cannot contain blank spaces. Note that there was also a file submitted with space characters in the name - Test Assertions Reliable Secure Profile - Version 1.0.htm. I removed those blank spaces from the filename. <ter> I also removed the blanks from the file names for the test assertions html files in all three packages </ter> Here is what I need the TC to do to remediate this: 1. The Naming Directives state that a namespace must use the pattern: http://docs.oasis-open.org/[tc-shortname]/ns/xxxx<http://docs.oasis-open.org/%5btc-shortname%5d/ns/xxxx> where xxxx can be a string picked by the TC. Based on the namespace submitted, I believe that http://docs.oasis-open.org/ws-brsp/ns/Profile-TAs-201305 would be acceptable to the TC. If it is, then please revise all namespaces where they occur in the computer language files to reflect this pattern. <ter> i changed this namespace wherever used </ter> 2. Remove the blank space from xsi:schemaLocation="http://docs.oasis-open.org/ns/ws-i/ws-brsp/Profile-TAs/201305 Profile-TAs.xsd"any place it occurs in the files. It can be deleted or replaced with a hyphen. <ter> I removed the production, since the relative URI will not work unless the schema is in the same directory as the xml file. It is not needed for the xslt. Sometime in the future, when actual publication occurs, we could put in an xsi:schemaLocation production with the full url for the schema location, however we could live without it. </ter> 3. Once you have these fixed, email the revised files to me so that I can replace them in the CSDs and CSPRDs. <ter> I placed the fixed packages, with all the changes indicated above at: https://www.oasis-open.org/apps/org/workgroup/ws-brsp/download.php/50512/BP20-WD05.zip https://www.oasis-open.org/apps/org/workgroup/ws-brsp/download.php/50513/BP12-WD05.zip https://www.oasis-open.org/apps/org/workgroup/ws-brsp/download.php/50514/RSP10-WD05.zip </ter? Please let me know if you have any questions. /chet ---------------- Chet Ensign Director of Standards Development and TC Administration OASIS: Advancing open standards for the information society http://www.oasis-open.org Primary: +1 973-996-2298<tel:%2B1%20973-996-2298> Mobile: +1 201-341-1393<tel:%2B1%20201-341-1393> Check your work using the Support Request Submission Checklist at http://www.oasis-open.org/committees/download.php/47248/tc-admin-submission-checklist.html TC Administration information and support is available at http://www.oasis-open.org/resources/tcadmin Follow OASIS on: LinkedIn: http://linkd.in/OASISopen Twitter: http://twitter.com/OASISopen Facebook: http://facebook.com/oasis.open -- Robin Cover OASIS, Director of Information Services Editor, Cover Pages and XML Daily Newslink Email: robin@oasis-open.org<mailto:robin@oasis-open.org> Staff bio: http://www.oasis-open.org/people/staff/robin-cover Cover Pages: http://xml.coverpages.org/ Newsletter: http://xml.coverpages.org/newsletterArchive.html Tel: +1 972-296-1783
[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]