BEALiquid Data for WebLogic™ XQuery Developer’s Guide Version 8.5 Document Date: June 2005 Revised: August 2005 Copyright Copyright © 2005 BEA Systems, Inc. All Rights Reserved. Restricted Rights Legend This software and documentation is subject to and made available only pursuant to the terms of the BEA Systems License Agreement and may be used or copied only in accordance with the terms of that agreement. It is against the law to copy the software except as specifically allowed in the agreement. This document may not, in whole or in part, be copied, photocopied, reproduced, translated, or reduced to any electronic medium or machine readable form without prior consent, in writing, from BEA Systems, Inc. Use, duplication or disclosure by the U.S. Government is subject to restrictions set forth in the BEA Systems License Agreement and in subparagraph (c)(1) of the Commercial Computer Software-Restricted Rights Clause at FAR 52.227-19; subparagraph (c)(1)(ii) of the Rights in Technical Data and Computer Software clause at DFARS 252.227-7013, subparagraph (d) of the Commercial Computer Software--Licensing clause at NASA FAR supplement 16-52.227-86; or their equivalent. Information in this document is subject to change without notice and does not represent a commitment on the part of BEA Systems. THE SOFTWARE AND DOCUMENTATION ARE PROVIDED “AS IS” WITHOUT WARRANTY OF ANY KIND INCLUDING WITHOUT LIMITATION, ANY WARRANTY OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. FURTHER, BEA Systems DOES NOT WARRANT, GUARANTEE, OR MAKE ANY REPRESENTATIONS REGARDING THE USE, OR THE RESULTS OF THE USE, OF THE SOFTWARE OR WRITTEN MATERIAL IN TERMS OF CORRECTNESS, ACCURACY, RELIABILITY, OR OTHERWISE. Trademarks or Service Marks BEA, BEA JRockit, BEA Liquid Data for WebLogic, BEA WebLogic Server, Built on BEA, Jolt, JoltBeans, SteelThread, Top End, Tuxedo, and WebLogic are registered trademarks of BEA Systems, Inc. BEA AquaLogic, BEA AquaLogic Data Services Platform, BEA AquaLogic Enterprise Security, BEA AquaLogic Service Bus, BEA AquaLogic Service Registry, BEA Builder, BEA Campaign Manager for WebLogic, BEA eLink, BEA Manager, BEA MessageQ, BEA WebLogic Commerce Server, BEA WebLogic Enterprise, BEA WebLogic Enterprise Platform, BEA WebLogic Enterprise Security, BEA WebLogic Express, BEA WebLogic Integration, BEA WebLogic Java Adapter for Mainframe, BEA WebLogic JDriver, BEA WebLogic JRockit, BEA WebLogic Log Central, BEA WebLogic Personalization Server, BEA WebLogic Platform, BEA WebLogic Portal, BEA WebLogic Server Process Edition, BEA WebLogic WorkGroup Edition, BEA WebLogic Workshop, and Liquid Computing are trademarks of BEA Systems, Inc. BEA Mission Critical Support is a service mark of BEA Systems, Inc. All other company and product names may be the subject of intellectual property rights reserved by third parties. All other trademarks are the property of their respective companies. August 5, 2005 12:32 pm Contents 1. Introducing the BEA XQuery Engine XML and XQuery . 1-2 XQuery Use in Liquid Data. 1-2 Supported XQuery Specifications . 1-2 Learning More About the XQuery Language . 1-3 2. BEA XQuery Implementation BEA XQuery Function Implementation . 2-2 Function Overview . 2-3 Access Control Functions. 2-5 fn-bea:is-access-allowed. 2-6 fn-bea:is-user-in-group . 2-6 fn-bea:is-user-in-role. .2-6 fn-bea:userid . 2-7 Duration, Date, and Time Functions. 2-8 fn-bea:date-from-dateTime . 2-8 fn-bea:date-from-string-with-format. 2-9 fn-bea:date-to-string-with-format . 2-9 fn-bea:dateTime-from-string-with-format . 2-10 fn-bea:dateTime-to-string-with-format . 2-10 fn-bea:time-from-dateTime . 2-11 fn-bea:time-from-string-with-format. 2-11 XQuery Developer’s Guide iii fn-bea:time-to-string-with-format . .2-12 Date and Time Patterns . .2-12 Execution Control Functions . .2-13 fn-bea:async . .2-13 fn-bea:fence . .2-15 fn-bea:if-then-else . .2-15 fn-bea:timeout . .2-16 Numeric Functions . .2-17 fn-bea:format-number. .2-17 fn-bea:decimal-round . .2-18 fn-bea:decimal-truncate . .2-18 Other Functions. .2-18 fn-bea:get-property . .2-19 fn-bea:inlinedXML. .2-19 fn-bea:rename . .2-19 QName Functions . .2-20 fn-bea:QName-from-string . .2-20 Sequence Functions . .2-21 fn-bea:interleave . .2-21 String Functions . .2-22 fn-bea:match . .2-22 fn-bea:sql-like. .2-25 fn-bea:trim . .2-26 fn-bea:trim-left. .2-26 fn-bea:trim-right . .2-27 Unsupported XQuery Functions. .2-27 Unsupported XQuery Language Features . .2-27 BEA XQuery Language Implementation . .2-28 iv XQuery Developer’s Guide Generalized FLWGOR (group by) . 2-28 Optional Indicator in Direct Element and Attribute Constructors. 2-31 Implementation Specific Details . 2-33 3. Understanding XML Namespaces Introducing XML Namespaces. 3-2 Exploring XML Schema Namespaces . 3-3 Using XML Namespaces in Liquid Data Queries and Schemas . 3-4 4. Best Practices Using XQuery Introducing Data Service Design . 4-1 Understanding Data Service Design Principles. 4-3 Applying Data Service Implementation Guidelines . 4-5 5. Understanding Liquid Data Annotations XDS Annotations. 5-2 General Properties . 5-4 Standard Document Properties. ..