如何在 Optic API 中使用 optic-fn, optic-json, optic-xdmp, optic-xs

Question

我们正在探索 Optic API 并进行一些 POC，以用 Optic API 查询替换我们现有的代码。

作为我们新要求的一部分，我们要使用 optic-fn、optic-json、optic-xdmp、optic-xs、我们花了很多时间使用 optic-fn、optic-json、optic-xdmp、optic-xs 查找示例或示例代码，但找不到任何示例代码供参考。

任何人都可以帮助我们为每个（optic-fn、optic-json、optic-xdmp、optic-xs）提供示例代码片段，这样对我们很有帮助吗？

感谢任何帮助。

Answer 1

在 XQuery 中，您不仅要导入核心 Optic 库

import module namespace op="http://marklogic.com/optic"
  at "/MarkLogic/optic.xqy";

还有提供查询中所需的任何表达式函数的库。使用以下库的任意组合：

import module namespace octs="http://marklogic.com/optic/expression/cts"
  at "/MarkLogic/optic/optic-cts.xqy"; 
import module namespace ofn="http://marklogic.com/optic/expression/fn"
  at "/MarkLogic/optic/optic-fn.xqy";
import module namespace ogeo="http://marklogic.com/optic/expression/geo"
  at "/MarkLogic/optic/optic-geo.xqy";
import module namespace ojson="http://marklogic.com/optic/expression/json"
  at "/MarkLogic/optic/optic-json.xqy";
import module namespace omap="http://marklogic.com/optic/expression/map"
  at "/MarkLogic/optic/optic-map.xqy";
import module namespace omath="http://marklogic.com/optic/expression/math"
  at "/MarkLogic/optic/optic-math.xqy";
import module namespace ordf="http://marklogic.com/optic/expression/rdf"
  at "/MarkLogic/optic/optic-rdf.xqy"; 
import module namespace osem="http://marklogic.com/optic/expression/sem"
  at "/MarkLogic/optic/optic-sem.xqy"; 
import module namespace ospell="http://marklogic.com/optic/expression/spell"
  at "/MarkLogic/optic/optic-spell.xqy";
import module namespace osql="http://marklogic.com/optic/expression/sql"
  at "/MarkLogic/optic/optic-sql.xqy"; 
import module namespace oxdmp="http://marklogic.com/optic/expression/xdmp"
  at "/MarkLogic/optic/optic-xdmp.xqy"; 
import module namespace oxs="http://marklogic.com/optic/expression/xs"
  at "/MarkLogic/optic/optic-xs.xqy";

此后，您以相同的方式调用函数，重要的区别在于参数不仅可以包含文字，还可以包含 op:col("NAME") 以指定列值或来自其他嵌套表达式的 return 值功能如下：

=> op:where(
    ofn:starts-with(
       op:col("col1"),
       ofn:substring-before(op:col("col2"), "prefix")
       )
   )

注意在执行查询期间对值进行操作时，您只能使用 Optic 表达式库中的函数。要在构建计划时对作为参数传递的文字值进行操作，请使用普通函数。

特别是，cts:query() 参数总是在 cts 命名空间而不是 octs 命名空间中构建。

有关哪些函数公开为表达式函数以及表达式函数如何在 SJS 中公开的详细信息，另请参阅：

希望对您有所帮助，

如何在 Optic API 中使用 optic-fn, optic-json, optic-xdmp, optic-xs

How to use optic-fn, optic-json, optic-xdmp, optic-xs in Optic API

marklogic

marklogic-10