marklogic - 协调流程中的makeReferenceObject - 如何使用对象引用？

Question

在协调产品和订单的 DHF 教程中，使用 SKU 通过引用将产品包含在订单中：

https://marklogic.github.io/marklogic-data-hub/tutorial/harmonizing-order-data/

// or a reference to a Product
products.push(makeReferenceObject('Product', order.sku));

...

function makeReferenceObject(type, ref) {
  return {
    '$type': type,
    '$ref': ref
  };
}

统一订单记录示例：

"Order": {
  "id": 1,
  "products": [
    { "Product": {
      "$type": "Product", 
      "$ref": "12345"
    }},
    { "Product": {
      "$type": "Product", 
      "$ref": "54321"
    }}
  ],
  "price": 100
}

现在我们如何使用订单记录中的产品对象引用呢？entity service内置函数是否应该es.instanceJsonFromDocument能够解析引用并将产品信息合并到输出中？还是只是供开发者实现自己的自定义逻辑的参考？

Answer 1

我最终在实体服务文档中找到了这些信息。它指出实体服务 API 将简单地将此类外部引用视为字符串。

不对外部参考的值进行验证。当您使用实体服务 API 生成代码和其他工件时，引用被视为不透明字符串。

https://docs.marklogic.com/guide/entity-services/models#id_15972