- 最新动态
- 功能总览
- 产品介绍
- 计费说明
- 快速入门
- 控制台操作指南
-
数据建模引擎用户指南
- 设计态使用指南
- 运行态使用指南
- 流程引擎使用指南
- 数字主线引擎用户指南
- 最佳实践
- 开发指南
-
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相关问题
- 文档下载
- 通用参考
链接复制成功!
创建并配置数据入图任务(API映射)
通过在LinkX-F中创建API映射类型的数据入图任务,您可以实现将指定模型源端源系统API中对应的实例数据写入到目标端指定的图数据库中。

通过配置手工调度或定时调度,基于数据入图任务生成入图调度,通过队列机制,可以实现有序的将目标实体对应的实例数据成功入图。
调度类型 |
说明 |
---|---|
手工调度 |
按照已配置的手工调度立即执行,即手动触发调度且单次运行。 |
定时调度 |
制定定时调度计划后,系统会按照已设置调度计划中的执行时间和频次自动执行任务调度。相比手工调度,定时任务调度可以自动化定时地完成数据处理过程。 请注意,基础版-Lite租户中的模型数据入图任务不支持进行定时调度配置。 |
前提条件
已获取开发人员及以上权限用户的账号和密码。
步骤1:定义任务信息
- 登录LinkX-F系统首页。
- 选择“数据联接 > 数据入图”,默认进入“数据入图任务”页面。
- 单击“创建”,系统右侧弹出“任务定义”页面。
- 填写基本信息和入图配置信息。如表2所示:
图2 任务配置示例
表2 配置入图任务 参数
说明
基本信息
入图方式
必填,保持默认,暂不支持修改。
任务名称
必填,必须以中文或者字母开头,且只能包含中文、字母、数字、下划线,且不能重复,长度不能超过128个字符。
任务描述
必填,手工输入,必填长度不能超过1024个字符。
任务类型
必填,默认“周期任务”且不支持修改。
导入对象类型
必填,选择导入对象的类型。
- 数据实体&关系:默认选项,表示导入数据实体和非实体型关系类型的对象。
- 关系:表示导入非实体型关系的对象。
- 关系实体:表示导入实体型关系的对象。
任务owner
必填,任务所有者。
数据实体
选择数据实体。
支持下拉选择或手工输入联想,可选值仅展示“已发布”的所有数据实体。
仅当“导入对象类型”选“数据实体&关系”或“关系”时显示该字段且必填。
关系实体
选择关系实体。
支持下拉选择或手工输入联想,可选值仅展示“已发布”的“是否实体”为“是”的关系实体。
仅当“导入对象类型”选“关系实体”时显示该字段且必填。
数据入图类型
必填,选择数据入图类型,可选“数据库映射”、“CSV文件”或“API映射”。
此处选择“API映射”类型。
删除数据
默认为“否”,当设置为“是”后,会将DelFlag为Y的数据在图数据库中进行删除。
必填,仅当导入对象类型选“数据实体&关系”或“关系实体”时显示该字段。
父数据实体
自动写入已选数据实体的父数据实体。
仅当导入对象类型选“数据实体&关系”或“关系”时显示该字段。
优先级
必选,设置任务被调度的优先级,默认值为10。
设置任务优先级目的是为了在执行任务调度时,在所有处于就绪状态的任务中,优先级越高的任务优先会被调度。
源端信息
当“数据入图类型”选择“API映射”时,填写下列配置项。
映射名称
根据“基本信息”中已选择的实体,选择其对应的且已发布的API映射。
根据选择的实体不同,源端信息的映射名称不同,下拉可选值来源于目标实体详情页的“数据源映射 > 源端映射”中的API映射。
源系统
必填,来源于“基础数据管理 > 源系统”。
API名称
必填,来源于“基础数据管理 > 源系统API”。
URL
非必填,URL地址。
目标端信息
映射名称
根据“基本信息”中已选择的实体,选择其对应的且已发布的图数据库映射。
根据选择的实体不同,目标端信息的映射名称不同,下拉可选值来源于目标实体详情页的“数据源映射 > 目标端映射”中的图数据库映射。
数据源名称
必填,由选择的映射名称自动写入不能修改。
数据源类型
根据数据源名称自动写入不能修改。
数据库类型
根据数据源名称自动写入不能修改。
Schema
根据数据源名称自动写入不能修改。
删除标识
仅当“删除数据”选“是”时才显示该字段且必填,可下拉选择。
图标签与映射配置
图标签
必填,根据选择的目标端映射名称自动写入表名,不能修改。
当“导入对象类型”选择“关系实体”时,需配置“源端图标签”和“目标端图标签”。
映射配置
根据“源端信息”中已选API映射返回的参数值自动映射数据实体的对应属性。
根据选择的映射名称自动获取不能修改。
- 填写完成后单击“保存”。
步骤2:选择手工调度配置场景
同一任务可同时开启多个手工调度,且所有任务总计不超过10个调度。需保证处在“执行中”或“待执行”的各调度之间的调度数据起止时间不可重叠,否则无法执行。
- 进入“数据入图任务”页面。
- (可选)通过条件筛选功能,快速筛选出“数据入图类型”为“API映射”的任务。
图3 数据入图类型为API映射的任务
- 找到待操作的目标任务,单击其操作列处的
,弹出手工调度配置窗口。
图4 手工调度配置窗口 - 配置手工调度参数。
表3 手工调度配置参数说明 参数
说明
数据起止时间
确定入图的数据范围,即数据起始时间和数据终止时间。
非首次制定计划数据起止时间根据上次调度数据结束时间与系统当前时间自动填充。
数据分片间隔
数据分片定义了系统从后台取数据的粒度,数据分片间隔根据选择单位和计数器制定。
- 分钟从5起步,自增长步长为5,最大不超过60。
- 小时、天、周和月从1起步,自增长步长为1。小时最大不超过24小时,天最大不超过30天,周最大不超过4周,月最大不超过12月。
业务参数
业务参数区分非Body参数和Body参数。
说明:
仅“数据入图类型”为“API映射”才显示且非必填。
- 如果业务参数选择非Body参数,则支持添加多个且最多不能超过5个,下拉可选值来源于源系统API接入时Swagger里解析出的入参参数。
- 如果业务参数选择Body参数,则需在“Body”框中输入Json格式的Body请求体参数。
Body
输入Json格式的Body请求体参数。
仅当业务参数选择Body参数时显示且必填。
VIP调度
VIP调度可享受最高调度优先级。
请注意,基础版-Lite租户中的模型数据入图任务不支持VIP调度功能。
- 配置完调度参数后单击“确定”,立即执行。
步骤2:选择定时调度配置场景
定时调度是指制定定时调度计划后,系统会按照已设置调度计划中的执行时间和频次自动执行任务调度。
请注意,基础版-Lite租户中的模型数据入图任务不支持进行定时调度配置。
- 进入“数据入图任务”页面。
- (可选)通过条件筛选功能,快速筛选出“数据入图类型”为“API映射”的任务。
图5 数据入图类型为数据库映射的任务
- 找到待操作的目标任务,单击其操作列处的
,弹出调度计划配置窗口。
说明:
批量制定定时调度计划时,不支持选择多个源系统API映射类型的数据入图任务进行操作。
图6 调度计划配置窗口 - 配置调度计划参数。
表4 调度计划配置参数说明 参数
说明
调度周期
调度周期的时间单位,包括分、时、天、周和月。
间隔时间
选择调度执行的间隔时间。
调度首次执行时间
选择调度首次执行时间。
首次执行时间不能早于当前时间,确保调度计划能够正常运行。
调度截至执行时间
选择调度截至执行时间。
截止执行时间不能早于首次执行时间,默认为空表示无限期。
数据起始时间
确定入图的数据起始时间。
数据分片间隔
每次调度按分片间隔时间读取数据。
业务参数
业务参数区分非Body参数和Body参数。
说明:
仅“数据入图类型”为“API映射”才显示且非必填。
- 如果业务参数选择非Body参数,则支持添加多个且最多不能超过5个,下拉可选值来源于源系统API接入时Swagger里解析出的入参参数。
- 如果业务参数选择Body参数,则需在“Body”框中输入Json格式的Body请求体参数。
Body
输入Json格式的Body请求体参数。
仅当业务参数选择Body参数时显示且必填。
- 配置完调度计划后单击“保存”。
- 单击“启动”,启动定时调度任务。
如有需要,您也可进入目标任务的调度计划页面暂停或停止已启动的任务。
说明:
根据实际业务场景,支持批量启动、暂停或停止多个制定计划的任务,但该操作会同时影响对应任务中的所有调度。
- 启动任务:在任务列表中勾选已制定计划的任务,单击“启动”。
- 暂停任务:在任务列表中勾选已启动的任务,单击“暂停”。已暂停的任务再次启动时会延续上一次的进程。
- 停止任务:在任务列表中勾选已启动的任务,单击“停止”。已停止的任务再次启动时会重新开始进程。