How can I to use XML Catalog for OSM 7.0.3?

Question

I have a xquery that execute a business rules in view.When I put it inside Data Instance Behavior, tab Data, inline, and
XQUERY the deploy in OSM doesn't work because it is a large xquery, more than 4000 characters.
So, I saw in OSM 7.0.3 doc (Developer’s Guide,Release 7.0.3 - Using XML Catalogs in OSM) that there is a possibility
of import resources files (xquery file in my case) in OSM Data Instance Behavior through XML Catalog.
I executed the follow steps
1) Add entry
*<rewriteURI uriStartString="http://br.com.ctbc" rewritePrefix="osmmodel:///XQuery/1.0.0/resources"/>*
to my catalog.xml, which is in path <My_Cartridge>/xmlCatalogs/core/catalog.xml
2) Set XML_CATALOG_SUPPORT variable in Design Studio with "enable"
3)Add *<oms-parameter>*
*<oms-parameter-name>oracle.communications.ordermanagement.util.net.CatalogUriResolver.DefaultXmlCatalogsUris</oms-parameter-name>*
*<oms-parameter-value>file://<My_domin>/XQuery/catalog.xqy</oms-parameter-value>*
*</oms-parameter>* to oms-config.xml, after unpack osm.ear
4) Created a Data Instance Behavior, inline and type XQuery whith source
declare namespace ctbcoms = "http://br.com.ctbc";
let $result := ctbcoms:retorna()
*return <DadosOrdem><Fim>{$result}</Fim></DadosOrdem>*
The XQuery that has the method retorna() has name: catalog.xqy. Code:
module namespace ctbcoms = "http://br.com.ctbc.xquery";
declare function ctbcoms:retorna()
let $retorno := 'teste'
return $retorno
So, when I deployed my cartridge I get the mensage:
Error on line 2
XPST0017: Cannot find a matching 0-argument function named {http://br.com.ctbc}retorna()
<11-Jan-2012 6:40:47,906 VET PM> <WARN> <impl.e> <ExecuteThread: '14' for queue:
'oms.xml'> <failed to compile xquery expression for xqueryInstanceType: xquery[
declare namespace ctbcoms = "http://br.com.ctbc";
let $result := ctbcoms:retorna()
return <DadosOrdem><Fim>{$result}</Fim></DadosOrdem>
]>
; Line#: 2; Column#: -1
net.sf.saxon.trans.XPathException: Cannot find a matching 0-argument function named {http://br.com.ctbc}retorna()
I am using Design Studio 3.1.3 with OSM 7.0.3.
Could have I a example these procedure? thank you !!!

Answer 1

Two observations:
1) Your inline xquery expression need to use the "import" xquery module expression. see point a) in my example below.
2) the change in oms-config.xml is to support the case for overriding the cartridge xml catalog ( for example developer, qa tester, etc) so this step is not mandatory to get your cartridge working.
=============================
For example, In OSM Order To Activate Cartridges 703, the OrderLifeCycle, Amending State/Submit Amendment Transition has the following inline xquery which delegates xquery implementation details to a PoinOfNoReturn.xqy xquery module
a) Inline Expression in Design Studio Entity
CommunicationsSalesOrderFulfillmentPIP\Orders\POLICY\CommunicationsSalesOrderLifeCyclePolicy
import module namespace pipponrfn = "http://xmlns.oracle.com/communications/ordermanagement/pip/ponr" at "http://xmlns.oracle.com/communications/ordermanagement/pip/ponr/PointOfNoReturn.xqy";
let $taskData := fn:root(.)/GetOrder.Response
let $checkPointOfNoReturn := pipponrfn:checkPointOfNoReturn($taskData)
if ($checkPointOfNoReturn ..........
b) xquery module
module namespace pipponrfn = "http://xmlns.oracle.com/communications/ordermanagement/pip/ponr";
declare function pipponrfn:checkPointOfNoReturn($taskData as element()) as xs:boolean { ....};
c) cartridge xml catalog
CommunicationsSalesOrderFulfillmentPIP\xmlCatalogs\core\catalog.xml
<rewriteURI uriStartString="http://xmlns.oracle.com/communications/ordermanagement/pip/ponr" rewritePrefix="osmmodel:///CommunicationsSalesOrderFulfillmentPIP/1.0.0/resources"/>
=======================
Optinally if you have OSM 703.3 path you can use <oms-parameter><oms-parameter-name> in oms-config.xml if you need to OVERRIDE the cartridge xml catalog.
d) osm-config.xml
<oms-parameter>
<oms-parameter-name>oracle.communications.ordermanagement.util.net.CatalogUriResolver.DefaultXmlCatalogsUris</oms-parameter-name>
<oms-parameter-value>file:///<My_test_folder>/XQuery/catalog.xqy</oms-parameter-value>
</oms-parameter>
e) your developer xml catalog overrideing the cartridge catalog:
your_full_path_to_xml_catalog.xml
<rewriteURI uriStartString="http://xmlns.oracle.com/communications/ordermanagement/pip/ponr" rewritePrefix="file:///d:/your_full_path_to_test_folder"/>