- 最新动态
- 功能总览
- 产品介绍
- 计费说明
- 快速入门
- 控制台操作指南
-
数据建模引擎用户指南
- 设计态使用指南
- 运行态使用指南
- 流程引擎使用指南
- 数字主线引擎用户指南
- 最佳实践
- 开发指南
-
API参考
- 使用前必读
- API概览
- 如何调用API
-
API
- 应用管理
- 运行服务管理
-
数据建模引擎
- 基础数据服务
-
版本服务
- 管理员更新M-V模型数据实例
- 管理员批量更新M-V模型数据实例
- 管理员撤销检出M-V模型数据实例
- 管理员批量撤销检出M-V模型数据实例
- 获取指定M-V模型实例的版本列表
- 获取指定版本的M-V模型实例数据
- 检出M-V模型数据实例
- 批量检出M-V模型数据实例
- 检出并更新M-V模型
- 批量检出并更新M-V模型
- 撤销检出M-V模型数据实例
- 批量撤销检出M-V模型数据实例
- 检入M-V模型数据实例
- 批量检入M-V模型数据实例
- 更新并检入M-V模型数据实例
- 批量更新并检入M-V模型数据实例
- 修订M-V模型数据实例
- 批量修订M-V模型数据实例
- 修订并更新M-V模型数据实例
- 批量修订并更新M-V模型数据实例
- 批量升级M-V模型实例的版本号
- 删除版本对象下最新分支的最新版本实例数据
- 软删除版本对象下最新分支的最新版本实例数据
- 删除最新大版本下的所有小版本
- 批量删除最新大版本下的所有小版本
- 软删除M-V模型实例下最新分支的所有小版本数据
- 批量软删除最新大版本下的所有小版本
- 对比M-V模型实例
- 失效管理
- 业务编码生成器
- 标签管理
- 生命周期管理
- 系统版本
- 多维视图和多维分支
- 关系实体服务
- 树形结构
- 流程引擎
- 应用示例
- 权限和授权项
- 附录
- SDK参考
-
常见问题
- 一般性相关问题
- 计量计费相关问题
-
数据建模引擎相关问题
- 设计态与运行态有什么区别?
- 为什么无法登录应用运行态?
- 为什么用户管理中会有“用户不存在”的用户?
- 为什么登录应用运行态时提示“缺少参数或参数错误”?
- 为什么设置输入型参数时提示安全校验失败?
- 应用发布后,在运行态为什么看不到构建的模型数据?
- 如何验证已设置的用户权限已生效?
- 什么是XDM应用?
- 什么是M-V模型?
- 数据建模引擎支持哪些属性类型?
- 枚举、合法值和参考对象的区别是什么?
- 入图和不入图有什么不同?
- 数据建模引擎支持哪些层级的缓存?
- 如何进行应用同步?
- 可以通过API方式使用应用设计态吗?
- 体验版数据建模引擎和基础版数据建模引擎提供的API有什么不同?
- 如何查看数据建模引擎的版本号?
- 如何避免数据模型互相引用形成环?
- 使用JDK 17版本应用运行态时,服务编排存在哪些约束与限制?
-
数字主线引擎相关问题
- 什么是企业租户和应用租户?
- 创建实体时选择构建表的作用是什么?
- 复杂实体属性太多,创建麻烦怎么办?
- 什么是源端映射和目标端映射?
- 什么是增量字段?
- 关系型数据库映射配置中DelFlag字段的作用是什么?
- 创建数据质量任务时,怎么选不出数据实体?
- 为什么LinkX-F中xDM-F来源的实例数据的最后更新时间显示与xDM-F中不一致
- 什么是入图调度的数据起止时间和数据分片间隔?
- 聚合服务编排中非纯脚本服务选择入参时,提示错误“初始数据实体必填入参为空,请选择必填入参”?
- 发布聚合服务后生成的API如何调用?
- 调用聚合服务时提示“查找不到该企业用户”
- 为什么操作时提示WSF参数校验失败?
- 描述类信息中输入英文双引号导致系统错误提示
- 全量数据服务API相关问题
- 文档下载
- 通用参考
链接复制成功!
常见问题
为什么我在应用设计态中看不到生成SDK和下载SDK的入口?
应用设计态的生成/下载SDK入口仅对已购买“部署位置”为“SDK”的基础版数据建模引擎的用户展示。如需使用xDM-F SDK,请先前往iDME控制台购买。具体操作请参见开通数据建模引擎。
数据建模引擎运行SDK包含了哪些内容?
数据建模引擎运行SDK仅包含runtime的内容,即仅包含xDM-F预置的管理页面和应用运行态的功能,不包含应用设计态的功能。
您可以在您的本地通用服务器/容器中部署数据建模引擎运行SDK并配置License授权文件后使用,也可以将数据建模引擎运行SDK作为JAR包引入到您的代码工程中调用API。
为什么有些应用发布任务不能生成SDK?
xDM-F SDK于2024年6月30日上线,2024年6月30日之前的应用发布任务不支持生成SDK。您可以重新发布应用,待应用发布成功后,即可在该应用发布任务所在行生成SDK。
SDK包的生成逻辑是什么?
生成的SDK包会基于应用发布任务及其发布时配套的iDME版本生成。
如果我想基于最新的iDME版本生成SDK包,要怎么做?
- 如果您的应用发布任务发布成功后,iDME仅进行补丁版本升级,您只需基于此应用发布任务重新单击“生成SDK”,系统会自动使用最新的iDME补丁版本进行更新。
- 如果您的应用发布任务发布成功后,iDME进行版本升级,您需要重新发布应用,待应用发布成功后,再基于此应用发布任务生成SDK。此时,生成的SDK包版本即为最新的iDME版本。
重新生成SDK包,需要更换License文件吗?
升级SDK包版本不需要更换License文件。
什么时候需要更换License文件?
当您存在如下变更场景时,需要更换License文件:
下单后如何获取License文件,需要提供哪些信息?
当您购买的“通用SDK”基础版数据建模引擎订单付款成功后,需要通过提交工单的方式申请License文件。在此之前,您需要提前准备如下相关信息:
- SDK所属应用的应用ID(License文件不支持跨应用使用)。
- 已支付订单中购买的用户数量。
- 已支付订单中订阅的时长。
- SDK部署机器的信息。
- 如果SDK部署机器为本地通用服务器,则需要准备如下信息:
- Windows系统:提供机器MAC地址。
- Linux系统:提供机器的UUID。
- 如果SDK部署机器为容器,则提供容器的ESN。
- 如果SDK部署机器为本地通用服务器,则需要准备如下信息:
如何一键获取数据建模引擎运行SDK部署机器的信息?
如果您已在本地通用服务器/容器中部署了数据建模引擎运行SDK,可通过调用API的方式一键获取部署机器的信息。
http://{部署机器的IP地址}:{部署机器的端口号}/rdm_{应用的唯一标识}_app/services/rdm/basic/api/v1/runtime/sdk/esn
如何查看License文件的可用时长?
当您已将数据建模引擎运行SDK部署至本地通用服务器/容器,并已在单点登录配置时将“XDM_SDK_DEPLOY_ENABLE”设置为“true”,即可以通过如下方式查看License文件的可用时长。
- 方式一:通过可视化页面查看
登录应用运行态后,您可以在页面底部查看License文件可用时长。
图1 查看License文件可用时长 - 方式二:通过API方式查看
调用xDM-F在应用运行态预置的“全量数据服务 > 系统管理API > 许可证管理 > XDM_v1_runtime_sdk_get-sdk-info”接口进行查看,更多详情请参见全量数据服务。
如何生成jwt-token?
xDM-F在JSON Web Token(JWT)这种结构化令牌的基础上实现了一套基于用户体系对用户的API进行授权访问的机制,满足用户个性化安全设置的需求。xDM-F支持的jwt-token的加密算法为RSA非对称加密算法,密钥的加密位数推荐为3072。
您可以通过如下方式生成用于jwt-token生成与验证的私钥与公钥。其中,私钥用于授权服务签发JWT,公钥配置到JWT插件中用于API网关对请求验签。
在本地通用服务器中,执行如下命令,生成对应私钥与公钥。
# 生成一个3072位的RSA密钥对 openssl genpkey -algorithm RSA -out private.key -pkeyopt rsa_keygen_bits:3072 openssl rsa -pubout -in private.key -out public.key # 查看私钥 cat private.key # 查看公钥 cat public.key
如何在本地通用服务器中部署流程运行服务依赖的Node.js环境?
通过流程引擎的流程编排服务生成的流程元模板需要通过Node.js编译后,才能在流程运行服务中启动。如果您的本地通用服务器未部署Node.js,可以参考如下操作进行部署。
准备事项
- 操作系统:Linux 系统,本文以CentOS 7.6 64位操作系统为例。
- Node.js:流程运行服务的运行环境,推荐安装Node.js 16.15.0或Node.js 16.20.2版本。
- Python:Node.js的依赖环境,推荐安装Python 2.6或Python 2.7版本,不建议安装Python 3.0及以上版本。
操作步骤
- 登录Linux弹性云服务器。
- 执行如下命令,查看当前ECS是否已经安装Python 2.6或2.7版本。
python --version
- 如果未安装,则依次执行如下命令,安装Python。
wget http://www.python.org/ftp/python/2.6/Python-2.6.tgz
本步骤以下载Python 2.6安装包为例,您可以前往Node.js 官网获取更多安装信息。
tar -xzf Python-2.6.tgz
cd Python-2.6 ./configure --prefix=/usr/local make && make install
ln -sf /usr/local/bin/python2.6 /usr/bin/python2.6
- 如果已安装,则执行3。
- 如果未安装,则依次执行如下命令,安装Python。
- 执行如下命令,下载Node.js Linux 64位二进制安装包。
wget https://nodejs.org/dist/v16.20.2/node-v16.20.2-linux-x64.tar.xz
本步骤以下载Node.js 64位二进制安装包为例,请对应您实际云服务器的规格,前往Node.js 官网获取更多安装信息。
- 执行如下命令,解压安装包。
tar -xf node-v16.20.2-linux-x64.tar.xz
- 依次执行如下命令,创建软链接。
ln -sf /usr/local/node/node-v16.15.0-linux-x64/bin/npm /usr/local/bin/
ln -sf /usr/local/node/node-v16.15.0-linux-x64/bin/node /usr/local/bin/
成功创建软链接后,即可在弹性云服务器任意目录下使用node及npm命令。
- 执行如下命令,查看Node.js及npm版本信息。
node -v
npm -v
显示Node.js的版本信息,即表示部署成功。