华为云用户手册

  • 响应示例 状态码: 200 Success { "code" : "200", "message" : "操作成功!", "data" : [ { "gmtCreate" : "2022-04-24 14:15:34", "gmtModified" : "2022-04-24 14:15:37", "taskName" : "1650780934247", "productName" : "华为", "batchCode" : "962cc65f20674ebeb67b765f83bcaa24", "status" : 1, "resultInfo" : [ "string" ], "readStatus" : 1, "merchant" : "1748189792481312769", "hmsUid" : "4939f7d0301c4ec281f1ff9ee8bba770" } ] } 状态码: 500 Error response { "code" : "500", "message" : "系统异常" }
  • 响应参数 状态码: 200 表4 响应Body参数 参数 参数类型 描述 code String 返回码 message String 响应消息 data Array of data objects 数据 表5 data 参数 参数类型 描述 gmtCreate String 创建时间 gmtModified String 修改时间 taskName String 任务名称 productName String 产品名称 batchCode String 批次码 status Integer 状态 resultInfo Array of strings 结果信息 readStatus Integer 状态 merchant String 商户ID hmsUid String UID 状态码: 500 表6 响应Body参数 参数 参数类型 描述 code String 错误码 最小长度:1 最大长度:100 message String 错误描述 最小长度:1 最大长度:100
  • 基本概念 CMDB用于组织应用结构信息以及相关配置信息,主要概念如下: 企业项目: 华为云企业项目,一个项目可以包含一个或者多个应用。 应用管理:管理资源对象与应用之间的关系。CMDB层次结构遵循“应用 + 子应用(可选)+ 组件 + 环境”的应用管理模型。 应用:应用资源管理的基础对象,资源管理模型的根节点。一个应用代表一个逻辑单元,可以理解为项目、产品、业务。应用创建后,每个region都可以看到相同的应用拓扑信息。 子应用:应用管理的可选节点,同一个应用下,最多可创建三层子应用。子应用可以理解为服务,对组件/微服务的归组分类。 组件:构成应用的最小单元,可以理解为应用程序或者应用依赖的一个中间件云服务组件,例如RDS,DMS。组件一般跟下面的环境一起组合使用,一个组件可以包含一个或者多个环境。比如一个订单的应用程序,包含功能测试环境,压力测试环境,预发环境以及现网环境等。 环境:一个组件或者程序,由于部署不同的配置参数,形成多个环境。每个环境都有region属性,可以通过region信息实现环境的过滤,也可以在创建环境时打上一个或多个标签,通过标签进行环境过滤。例如按照环境类型区分包括:正式、测试。按照区域区分包括:华东、华南。按照DevOps流水线阶段区分包括:alpha,beta,gamma,product。 环境标签:环境标签是为环境设置的一个属性,多个环境可能具有相同的的标签,通过标签可过滤显示需要的环境。同一个标签只能添加在本应用下的不同环境,不能跨应用添加。 资源绑定:将资源对象与应用下的环境建立关联关系,在同一个应用下资源对象实例可属于多个环境。 资源解绑:关联资源后,当组件或环境信息变化,不需要资源时,可将资源从原应用节点解除绑定。 资源转移:关联资源后,当组件或环境信息变化,需要及时转移资源时,可将资源从原应用节点转移到目标应用的节点下。
  • 功能说明 表1 功能说明 类别 说明 首页 提供应用、主机等资源的检索功能,支持通过关键字、名称等方式快速检索资源。 应用管理 用于管理云服务对象与应用之间的关系,层次结构遵循应“应用 + 子应用(可选)+ 组件 + 环境”的应用管理模型。 资源管理 对用户所有的各类云服务进行统一管理。可全局查看所有的云服务资源对象与应用的关联关系,包括未绑定应用的云资源,便于用户对资源进行分析和管理。 环境标签 根据实际的使用场景,为已创建的应用环境添加标签,便于用户快速过滤和查找相同属性的应用环境。 企业项目 华为云企业项目,一个项目可以包含一个或者多个应用。
  • 监控日志 AOM可以对日志数据进行监控分析,首先您需要对日志进行结构化配置,具体请参考结构化配置。 在左侧导航栏中选择“指标浏览”。 默认显示“指标源”页签,单击“日志源”,切换至日志源页签。 依次在下拉框选择“日志组名称”和“日志流名称”。 在SQL查询条件框中输入SQL语句,单击“查询”即可查看该日志流下日志数据分析。目前支持的SQL语句详见SQL查询语法。 依照业务需求选择不同图表类型,呈现查询结果。图标类型与配置的详细说明请参见日志数据类图表(表格、柱状图、折线图、饼图、数字图、数字折线图、地图)。 单击:以表格形式展示当前日志数据。 单击:以折线图形式展示当前日志数据。 单击:以柱状图形式展示当前日志数据。 单击:以饼图形式展示当前日志数据。 单击:以数字图形式展示当前日志数据。 单击:以数字折线图形式展示当前日志数据。 单击:以国级、省级等地图形式展示当前日志数据。 对查询结果可执行以下操作: 单击“新建”,在弹出的“创建可视化图表”中,根据业务需求填写“图表名称”、“可视化对象”,选择需要展示的“图表类型”,单击“确定”,可视化图表保存成功。 单击“保存”,在弹出的“保存可视化图表”对话框中,根据业务需求填写“图表名称”,单击“确定”,可视化图表保存成功;当选中某个可视化图表时,单击“保存”,可对该图表进行修改。 单击“另存为”,在弹出的“保存可视化图表”中,根据业务需求填写“图表名称”,单击“确定”,对已有可视化图表进行复制。 须先保存一个图表后,才可另存为可视化图表。 单击“下载”,可下载当前SQL查询结果的可视化数据,该文件为.csv。 单击“展开图表”,可展开当前日志流下的可视化图表。 单击“收起图表”,可收起当前日志流下展开的可视化图表。
  • 监控指标 登录AOM 2.0控制台。 在左侧导航栏中选择“指标浏览”。 从下拉列表选择需要监控的Prometheus实例。 通过“全量指标”或“按普罗语句添加”方式选择一个或多个关注的指标。 通过“全量指标”方式选择指标 图1 通过“全量指标”方式选择指标 监控条件设置的详细说明请参见表2。 选择某个关注的指标后,可根据条件属性过滤显示指标。例如,不同的RDS实例均有CPU使用率指标,用户需要查看特定RDS实例类型的CPU使用率指标。具体操作如下: 在“指标”输入框搜索并选择对应的RDS实例的CPU使用率指标,然后在“条件”设置处设置维度名称为RDS for MySQL实例、RDS for PostgreSQL实例等RDS实例类型,并选择对应维度值,即可过滤显示出特定RDS实例类型的CPU使用率指标。 单击“新增指标”可多次添加监控指标,并为指标设置统计周期等信息。将光标移动到指标数据和对应监控条件后,还可以根据需要执行以下操作: 单击监控条件后的,可将对应行的指标数据在当前图表中隐藏。 单击监控条件后的,可将对应行的指标数据和监控条件转换为Prometheus命令。 单击监控条件后的,可快速复制对应行的指标数据及监控条件等信息,并根据需要修改。 单击监控条件后的,可删除对对应行指标数据的监控。 通过“按普罗语句添加”方式选择指标,普罗语句输入的详细说明请参见普罗语句说明。 图2 通过“按普罗语句添加”方式选择指标 参考表1设置指标参数信息,查看页面上方的指标图表,多角度对指标数据进行分析。 表1 指标参数说明 参数名称 说明 统计方式 指标数据按照所设置的统计方式进行聚合,包括:平均值、最小值、最大值、总计、样本个数。 说明: 样本个数为指标数据点的计数。 统计时段 指标数据按照所设置的时间范围进行聚合。设置时间范围的方式包括:近30分钟、近1小时、近6小时、近1天、近1周、自定义时间段。 刷新频率 指标数据按照所设置的频率进行刷新。包括:手动刷新、30秒、1分钟、5分钟。 (可选)设置指标数据的展示形式。 在页面右侧单击图表类型后的向下箭头,从下拉列表中选择合适的图表类型,并设置图表的配置参数,例如X轴名称、Y轴名称及显示数值等,配置参数的说明具体请参见指标数据类图表(折线图、数字图、TopN、表格、柱状图、数字折线图)。 1个折线图最多支持展示200条指标数据。 图3 选择图表类型
  • 查看Recording Rule指标 Recording Rule配置完成后,可通过AOM的“指标浏览”界面查看和通过Grafana系统查看Recording Rule指标。 方式一:通过AOM的“指标浏览”界面查看 在“指标浏览”界面,从下拉列表选择已配置Recording Rule的Prometheus实例。 单击“全量指标”,在搜索框中输入对应的Recording Rule指标名称来查看该指标的详细信息。 方式二:通过Grafana查看 具体操作请参见通过Grafana查看AOM中的指标数据。
  • 查看和管理接入配置 您可以在日志接入界面对已添加的接入配置进行搜索、查看、编辑和删除。 搜索 在“日志接入”界面左侧选择需要查看接入配置的应用与组件,在右侧搜索框中输入关键词进行搜索。 查看 您可以在“日志接入”界面查看已创建的接入配置。单击“所属日志组”列的日志组名称,可以跳转到LTS控制台的日志组详情。 编辑 在“日志接入”界面,单击“操作”列的“编辑”,可以编辑该接入配置。 删除 在“日志接入”界面,单击“操作”列的“删除”,可以删除该接入配置。或勾选接入配置名称,进行批量删除。 删除接入配置或删除映射日志流不可恢复,请您谨慎操作。
  • 更多应用发现规则操作 应用发现规则添加完成后,您还可以执行表2中的操作。 表2 相关操作 操作 说明 查看规则详情 在“名称”列单击规则的名称。 启、停规则 单击“操作”列的“启用”。 单击“操作”列的“停用”。停用后,AOM将不采集进程的指标数据。 删除规则 删除一个发现规则:在“操作”列选择“删除”。 删除一个或多个发现规则:选中一个或多个发现规则前的复选框,单击页面左上角的“删除”。 说明: 内置发现规则不支持删除操作。 修改规则 在“操作”列选择“修改”。 说明: 内置发现规则不支持修改操作。
  • 内置发现规则 AOM提供了Sys_Rule和Default_Rule两个内置的发现规则,内置的发现规则会在所有主机上执行,包括后续新增的主机。其中Sys_Rule优先级大于Default_Rule,即优先在主机上执行Sys_Rule,如果满足Sys_Rule,则不执行Default_Rule,如果不满足Sys_Rule,则执行Default_Rule。规则内容如下: Sys_Rule(不能停用) 使用Sys_Rule规则的场景下,组件名和应用名配对使用,必须同时设置组件名和应用名信息,取值优先级如下: 应用名称取值优先级: 取进程的启动命令中“Dapm_application”字段的值。 如果1为空,则取环境变量“JAVA_TOOL_OPTIONS”中“Dapm_application”字段的值。 如果2为空,则取环境变量“PAAS_MONITORING_GROUP”的值。 如果3为空,则取进程的启动命令中“DAOM.APPN”字段的值。 组件名称取值优先级: 取进程的启动命令中“DAOM.PROCN”字段的值,如果为空则取“Dapm_tier”字段的值。 如果1为空,则取环境变量“JAVA_TOOL_OPTIONS”中“Dapm_tier”字段的值。 如果2为空,则取环境变量“PAAS_APP_NAME”的值。 如下示例所示,则组件名为atps-demo,应用名为atpd-test。 PAAS_MONITORING_GROUP=atpd-test PAAS_APP_NAME=atps-demo JAVA_TOOL_OPTIONS=-javaagent:/opt/oss/servicemgr/ICAgent/pinpoint/pinpoint-bootstrap.jar -Dapm_application=atpd-test -Dapm_tier=atps-demo Default_Rule(可停用) 如果进程的“COMMAND”列的值为“java”,则组件名依次按照优先级从命令行中的jar包名、命令行中主类名、命令行中第一个非-开头的关键字获取,应用名使用默认值unknownapplicationname。 如果进程的“COMMAND”列的值为“python”,则组件名取命令行中第一个py/pyc脚本名,应用名使用默认值unknownapplicationname。 如果进程的“COMMAND”列的值为“node”,则组件名取命令行中第一个js脚本名,应用名使用默认值unknownapplicationname。
  • 过滤规则 ICAgent会在目标主机上进行周期性探测,类似ps -e -o pid,comm,lstart,cmd | grep -v defunct命令的效果,查出目标主机的所有进程。然后将每一个进程分别与过滤规则(过滤规则详见表1)进行匹配。如果进程满足过滤规则,则进程会被过滤掉,不会被AOM发现;如果进程不满足过滤规则,则进程不会被过滤,会被AOM发现。 探测结果类似如下回显信息: PID COMMAND STARTED CMD 1 systemd Tue Oct 2 21:12:06 2018 /usr/lib/systemd/systemd --switched-root --system --deserialize 20 2 kthreadd Tue Oct 2 21:12:06 2018 [kthreadd] 3 ksoftirqd/0 Tue Oct 2 21:12:06 2018 (ksoftirqd/0) 1140 tuned Tue Oct 2 21:12:27 2018 /usr/bin/python -Es /usr/sbin/tuned -l -P 1144 sshd Tue Oct 2 21:12:27 2018 /usr/sbin/sshd -D 1148 agetty Tue Oct 2 21:12:27 2018 /sbin/agetty --keep-baud 115200 38400 9600 hvc0 vt220 1154 docker-containe Tue Oct 2 21:12:29 2018 docker-containerd -l unix:///var/run/docker/libcontainerd/docker-containerd.sock --shim docker-containerd-shim --start-timeout 2m --state-dir /var/run/docker/libcontainerd/containerd --runtime docker-runc --metrics-interval=0 表1 过滤规则 过滤规则 举例 如果进程的“COMMAND”列的值为“docker-containe”、“vi”、“vim”、“pause”、“sshd”、“ps”、“sleep”、“grep”、“tailf”、“tail”或“systemd-udevd”,且为非容器内的进程,则该类进程会被过滤掉,不会被AOM发现。 例如,上面信息中“PID”为“1154”的进程,因为其“COMMAND”列的值为“docker-containe”,所以该进程不会被AOM发现。 如果进程的“CMD”列的值以“[”开头,且以“]”结尾,则该类进程会被过滤掉,不会被AOM发现。 例如,上面信息中“PID”为“2”的进程,因为其“CMD”列的值为“[kthreadd]”,所以该进程不会被AOM发现。 如果进程的“CMD”列的值以“(”开头,且以“)”结尾,则该类进程会被过滤掉,不会被AOM发现。 例如,上面信息中“PID”为“3”的进程,因为其“CMD”列的值为“(ksoftirqd/0)”,所以该进程不会被AOM发现。 如果进程的“CMD”列的值以“/sbin/”开头,则该类进程会被过滤掉,不会被AOM发现。 例如,上面信息中“PID”为“1148”的进程,因为其“CMD”列的值以“/sbin/”开头,所以该进程不会被AOM发现。
  • 前提条件 已购买弹性云服务器ECS,具体操作请参见《弹性云服务器快速入门》。 已购买弹性公网IP,并绑定到购买的弹性云服务器ECS上,具体操作请参见《弹性公网IP快速入门》。 服务已接入可观测Prometheus 监控。具体操作,请参见: Prometheus实例 for 云服务 Prometheus实例 for ECS Prometheus实例 for CCE Prometheus实例 for Remote Write Prometheus实例 for 多账号聚合实例
  • 账号类型问题导致无法登录 故障现象:账号类型使用错误导致无法登录。 定位原因: 根据应用部署的数据建模引擎类型,检查登录时使用的账号类型是否正确。如果账号类型不对,请参考创建iDME操作用户。 如果应用部署在体验版数据建模引擎上,请使用华为账号下的IAM用户登录应用运行态。 如果应用部署在基础版数据建模引擎上,请使用组织成员账号和对应密码登录应用运行态。 基础版应用运行态更详细的登录流程指引请参见公有云场景下如何登录基础版应用运行态?。
  • iDME常见错误提示及解决方法 本章节主要介绍iDME控制台常见错误提示信息及对应的解决方法。 表1 常见错误提示及解决方法 错误提示 报错场景 原因及解决方法 配额不足 购买服务(如基础版数据建模引擎、节点、增量包、用户、MCU)或创建应用时失败 原因:剩余配额不足。 解决方法:可通过申请扩大配额来解决,详细请参见配额管理。 只能购买一个数字主线引擎 购买数字主线引擎时不成功 原因:已购买数字主线引擎,一个华为账号下只能购买一个数字主线引擎。 解决方法:根据已有数字主线引擎的实际计费模式执行删除或退订操作后再重新购买,详细请参见管理数字主线引擎。 该运行环境状态异常或不支持变更 变更基础版数据建模引擎时不成功 原因:资源状态不正常。 解决方法:参考资源异常状态说明及处理方案解决,详情请参见服务状态说明。 该应用当前为已部署状态,如需删除请先卸载应用 删除应用时不成功 原因:已部署的应用无法直接删除。 解决方法:卸载应用后重新删除,详情请参见卸载应用。 该应用已部署在其他运行服务,请先将该应用卸载后再进行部署 部署应用时不成功 原因:一个应用只能部署在一个数据建模引擎上。 解决方法:卸载应用后重新部署,详情请参见卸载应用。 该运行服务已部署其他应用,请先卸载旧应用后再部署新应用 部署应用时不成功 原因:一个数据建模引擎上只能部署一个应用,应用部署的数量超过限制。 解决方法:卸载应用后重新部署,详情请参见卸载应用。 应用环境和APP数据库未匹配 部署应用时不成功 原因:数据建模引擎的数据库类型与待部署应用的数据库类型必须一致,才能保证应用顺利部署。 解决方法:重新购买与应用数据库类型一致的数据建模引擎再次部署,或者新建与数据建模引擎数据库类型一致的应用,详情请参见购买数据建模引擎或创建应用。 无可部署的应用版本,请先到业务面设计态发布应用 部署应用时选不到应用版本 原因:未发布过应用或应用发布失败,所以无可选的应用版本。 解决方法:进行应用发布后重新部署,详情请参见发布应用。 仅当资源状态与应用状态为运行中时可登录 登录运行态时按钮置灰 原因:资源状态或应用状态不正常。 解决方法:参考资源或应用异常状态说明及处理方案解决,详情请参见服务状态说明。 该运行服务没有绑定公网IP,无法公网访问 登录运行态时按钮置灰 原因:基础版数据建模引擎未绑定弹性公网IP。 解决方法:为服务绑定弹性公网IP后重新登录,详情请参见绑定弹性公网IP。 无效Key值 添加标签键时失败 原因:输入的标签键不符合规范。 解决方法:参考标签键填写规范重新输入,详情请参见标签管理。 输入的账号ID无效,请检查 分享组织时不成功 原因:未填写正确的账号ID。 解决方法:重新分享时确保输入正确的账号ID,详细请参见分享组织。 父主题: 一般性相关问题
  • 使用流程 图1 轮转密码流程 流程说明如下: 定时触发器到期后,会发布定时触发事件。 函数工作流接收到事件后,会生成新的随机密码,替换凭据模板内容中的占位符,随后将替换后的内容作为新版本存入凭据中。 应用程序定期通过调用API/SDK获取最新凭据版本。 凭据管理服务检索并解密凭据密文,将凭据中保存的信息通过凭据管理API安全地返回到应用程序中。 应用程序获取到解密后的凭据明文信息,使用新密码更新目标对象(数据库、服务器等),使新密码生效,后续使用新密码对目标对象进行访问。
  • 解决方案 用户需要在KMS中创建一个用户主密钥。 用户计算文件的摘要,调用KMS的“sign”接口对摘要进行签名。用户得到摘要的签名结果。将摘要签名结果和密钥ID与文件一同传输或者存储。签名流程如图 签名流程所示。 图1 签名流程 用户需要使用文件时,先进行完整性校验,确保文件未被篡改。 用户重新计算文件的摘要,连同签名值调用KMS的“verify”接口对摘要进行验签。用户得到验签结果。如果能正常验签,则表明文件未被篡改。验签流程如图 验签流程所示。 图2 验签流程
  • 在线工具加解密 加密数据 单击目标自定义密钥的别名,进入密钥信息页面后,默认进入工具页签。 在“加密”文本框中输入待加密的数据,如图1所示。 图1 加密数据 单击“执行”,右侧文本框显示加密后的密文数据。 加密数据时,使用当前指定的密钥加密数据。 用户可单击“清除”,清除已输入的数据。 用户可单击“复制到剪切板”拷贝加密后的密文数据,并保存到本地文件中。 解密数据 解密数据时,可单击任意“启用”状态的非默认密钥别名,进入该密钥的在线工具页面。 单击“解密”,在左侧文本框中数据待解密的密文数据,如图2所示。 在线工具自动识别并使用数据被加密时使用的密钥解密数据。 如果该密钥已被删除,会导致解密失败。 图2 解密数据 单击“执行”,右侧文本框中显示解密后的明文数据。 用户可直接单击“复制到剪切板”拷贝解密后的明文数据,并保存到本地文件中。 在控制台输入的明文,会进行base64编码得到加密后的字符。 如果直接调用API接口进行解密,得到的解密结果是进行了base64编码的内容。需再进行一次base64解码才能得到与控制台输入明文一致的内容。
  • 调用API接口加解密 以保护服务器HTTPS证书为例,采用调用KMS的API接口方式进行说明,如图3所示。 图3 保护服务器HTTPS证书 流程说明如下: 用户需要在KMS中创建一个用户主密钥。 用户调用KMS的“encrypt-data”接口,使用指定的用户主密钥将明文证书加密为密文证书。 用户在服务器上部署密文证书。 当服务器需要使用证书时,调用KMS的“decrypt-data”接口,将密文证书解密为明文证书。 由于控制台输入的加密原文会经过一次Base64转码后才传至后端,所以当调用API接口解密密文的时候,返回的明文就是加密原文经过Base64转码得到的字符串,故API加密密文后需要调用API进行解密,如果使用控制台解密API加密密文则会产生乱码。
  • 建模流程 图1 反向建模流程图 预置反向建模策略 建模范围:反向建模前,您需要根据业务需求确定需要将哪些物理表反向生成为数据模型。 此过程需要确定数据库类型,物理表名称,物理表中的字段名称和类型。读取到的物理表和表字段后续将会被反向生成相应数据模型和模型属性。 建模规则:确定反向生成的数据模型的类型、属性及命名规范。 添加数据源 连接本地数据库,是读取数据和反向建模的前提。具体操作请参见创建数据源。 读取数据 xDM-F会根据您设置的反向建模策略进行读取,生成出待创建的建模信息。具体操作请参见读取数据库数据。 确认建模信息 xDM-F初步生成的建模信息可能会存在偏差,您需要根据业务需求进行建模信息的调整。例如,更改物理表中建模信息的实体类型、中英文名称、沿用表名称、父模型等基本信息。具体操作请参见修改建模信息。 生成最终模型 建模完成后,您可以查看生成的模型信息和状态。查看建模失败的错误信息,快速定位问题并及时处理。 建模成功的数据模型会被存放至“数据模型管理”中,您可以前往“数据模型管理”页面查看并进行后续的管理操作。具体操作请参见数据模型管理。
  • 使用说明 仅支持同步同类型数据库的应用数据。即,支持将MySQL数据库的应用A同步至MySQL数据库的应用B,不支持将MySQL数据库的应用A同步至PostgreSQL数据库的应用B。 如果目标应用中存在具有“多维视图&多维分支”功能的同名数据模型,不支持同步没有“多维视图&多维分支”功能的同名数据模型。 在工业数据模型模板库生成的同步任务不支持下载离线文件。如果应用中存在同名的数据模型或者枚举类型,“工作中”的同名数据模型会直接被发布,并修订更新新版本,“已发布”的数据模型直接修订更新新版本,同名枚举类型。
  • 注意事项 导入文件只支持Excel类型文件,结尾处需标注#EOF。 导入的数据实体或属性若已存在则进行更新或修订,若不存在则进行创建。 导入的数据实体如存在参考对象,导入时支持自动解耦。 导入数据实体时,系统会对如下相关数据进行修正。 如果导入的数据实体是M-V模型中的版本对象,会将属性的“唯一键”修正为“否”。 如果数据实体的属性将“唯一键”设置为“是”,会将“默认值”修正为空字符("")。 如果导入的数据实体属性类型为“文件”类型,会将“必填”、“列表属性”、“入库”和“唯一键”修正为“否”。 如果导入的数据实体属性类型为“参考对象”类型,会将“唯一键”修正为“否”。 如果“参考对象”类型的属性将“组合关系”设置为“是”,会将“必填”修正为“是”。 如果“文本”类型的属性将“值加密”设置为“是”,会将“列表属性”修正为“否”。 如果导入的数据实体属性类型为“JSON”类型,会将“唯一键”、“列表属性”和“多值”修正为“否”。 如果导入的数据实体属性类型为“URL”类型,会将“唯一键”修正为“否”。
  • 背景信息 在国际化的大趋势下,业务系统/平台不仅需要具备适用国内企业用户的中文环境,还需要根据合资企业、进出口贸易企业的语言环境适配/支持多国语言(例如英文、德文、日文、韩文、法文、俄文等)的应用与切换,从而保证各类型企业在不同业务运转过程中的稳定和顺畅。 此外,在工艺设计、制图等过程中,需要制定统一的装配、机加、焊接专业等符号,以规范化、专业化的形式完整和准确传递工业设计意图,保证工艺数据传递和理解的精确高效,保证数据规范和一致性。 为此,工业数字模型驱动引擎-数据建模引擎(xDM Foundation,简称xDM-F)提供多语言&工程符号功能,用户可自定义配置多语言及其显示值的映射关系以及工程符号图标的存储,并可通过系统提供的接口按需查询多语言配置项用于前端界面等场景下的自助显示切换。
  • 关系实体 关系实体用于描述两个或更多数据实体相互如何关联,是xDM-F原子接口的承载体之一。 基于xDM-F支持的数据关系,提供如下关系类型: 表3 元模型关系 类型 说明 1:N组合关系 又称“参考关系”,主要用于为对象之间建立1:N或主外键关系,可分为: 组合关系:1:N组合关系,即整体和部分的关系。例如公司和部门,如果公司不存在了,部门也不存在了。 非组合关系:1:N聚合关系,即普通的1:N参考关系或主外键关系。例如部门和员工,一个部门有多个员工。 在创建属性时,将属性的“类型”定义为“参考对象”,则属性对应的数据模型具有参考关系。 适用于传统主外键数据的关联。例如,一个部门可以有多个员工,它们之间为一对多聚合关系;公司是部门的父项,部门随着公司而存在,它们之间为一对多组合关系。 说明: 关系实体和M-V模型实体只支持定义非组合关系的参考对象属性。 1:N聚合关系 M:N关系 即多对多关系,用于为数据实体/接口模型建立M:N关系。 创建关系实体时,“关系类型”为“多对多”的关系实体均具有此关系能力。可为应用运行态提供:创建/删除关系实体实例,查询关系实体,获取关联实体/被关联实体清单等操作。 适用于为不同数据实体/接口模型建立多对多关系。例如,在汽车电器相关的零件开发中,工程师和零件开发为多对多关系。一个工程师可进行多个零件开发,一个零件可由多个工程师进行开发。 M:xN关系 又称“单边不确定关系”,用于为一边不确定的数据实体/接口模型建立M:N关系,不确定的数据实体或接口模型(目标端)默认为基类抽象模型“basicObject”。 创建关系实体时,“关系类型”为“单边不确定”的关系实体均具有此关系能力。可为应用运行态提供:创建/删除关系实体实例,查询关系实体,查询目标端对象等操作。 适用于基础数据与业务数据的关联。例如,标签数据与业务数据的关联。标签可给任何对象打标签,在创建实例时确定打标签的目标端对象。 UsageLink使用关系 又称“多叉树关系”,适用于实现复杂的数据结构的存储,高效地查找数据,方便管理节点数据的场景。例如,部件和部件之间的使用和被使用关系。一辆汽车有四个轮子,汽车和轮胎都是部件,创建一个关系实体承载汽车和轮胎的使用关系,并在关系实体上定义一个“使用数量”属性用于标识一辆汽车使用了四个轮胎。 自循环树形关系 又称“树形结构”,是数据对象之间存在着“一对多”的树形关系的数据结构,适用于数据间上下级的关联。例如,企业的组织结构、软件应用的结构、工作计划、项目管理等。 创建数据实体/关系实体时,通过勾选xDM-F内置的“树形结构”、“分类管理”、“文件夹管理”等能力实现。
  • 数据实体 实体指现实世界中客观存在的并可以相互区分的对象或事物,可以是具体的人、事或物,也可以是抽象的概念或联系。这些独立事物个体的特性称为实体属性,每个实体都具有多个属性。在xDM-F中,这些独立的事物个体都可以看做是数据实体。数据实体是xDM-F原子接口的承载体之一,用于定义数据对象的基本信息、业务属性以及配置所需的功能(如基础数据服务、树形结构、生命周期管理等)。 数据实体按元模型类型的维度分为如表1所示类型。 表1 元模型实体 类型 说明 独立实体 又称“单实体”,适用于关系上不依附、不隶属,单独存在的业务对象。例如,企业的组织架构、部门、机房等。 创建数据实体时,“父模型”为“BusinessObject”或“BasicObject”的数据实体均为单实体。 多版本实体 又称“Master-Version(M-V)模型实体”,适用于只对同一业务对象进行局部的改进,或者需要对业务对象的历史演变过程进行记录和维护。例如,研发过程的技术文档、部件等业务对象会不断修改,需要能够随时查看历史版本数据及修改记录。 创建数据实体时,“父模型”为“VersionObject”的数据实体均为M-V模型实体。
  • 接口模型 xDM-F内置了多种功能,在创建数据实体/关系实体时,不仅自具备从xDM-F继承的基本功能能力,还可根据实际业务需求勾选xDM-F提供的可选功能,每个功能会继承一个或者多个属性。每勾选一个功能,该实体会自动生成相应功能继承的一个或者多个属性。当xDM-F内置的功能无法满足您实际业务需求时,可通过接口模型进行定义。自定义的接口模型将作为自定义功能,在创建数据实体时,被数据实体通过勾选自定义功能的方式被继承和使用。 在已经确定的应用数据模型结构上,需要对具有相似功能、相似结构、相同属性的数据模型进行归一化处理,可通过接口模型定义这些相似功能、相似结构和相同属性。为这些数据模型提供了标准接口,降低参数的重复性,方便管理模型属性。 例如机械产品中,各部件间有一部分是通过销、铆钉、螺栓等常用标准件直接连接,有一部分是通过联轴器、减速器等部件间接连接。尽管这些常用的零部件大多都已经实现系列化或标准化,但这些零部件易损坏,产品在多次更换过程中需要反复操作和记录。您可以分别创建包含这些具有相似功能的零部件接口模型,然后在创建数据实体时,勾选对应接口模型即可继承该接口模型的属性和关系。
  • 修订记录 发布日期 修改说明 2024-5-11 第十四次正式发布。 修改 发布应用 创建数据实体 管理数据实体属性 创建关系实体 管理关系实体属性 创建接口模型 管理接口模型属性 2024-3-31 第十三次正式发布。 修改 创建数据实体 管理数据实体属性 创建关系实体 管理关系实体属性 创建接口模型 管理接口模型属性 2024-02-23 第十二次正式发布。 新增联合索引管理 修改 应用发布历史 创建数据实体 管理数据实体属性 创建关系实体 管理关系实体属性 创建接口模型 管理接口模型属性 2023-12-25 第十一次正式发布。 新增工业数据模型模板库 修改简介 2023-11-27 第十次正式发布。 修改 创建数据实体 管理数据实体属性 创建关系实体 管理关系实体属性 创建接口模型 管理接口模型属性 创建数据源 创建枚举 全量数据服务 2023-10-29 第九次正式发布。 修改 创建数据实体 管理数据实体属性 管理功能配置 创建关系实体 管理关系实体属性 管理功能配置 创建接口模型 管理接口模型属性 简介 XDM应用 2023-07-22 第八次正式发布。 新增 下载离线文件 导入离线文件 修改 创建数据实体 创建关系实体 创建接口模型 查看数据图谱 应用同步 2023-06-17 第七次正式发布。 修改 创建数据实体 管理功能配置 查看数据实体 创建关系实体 2023-05-20 第六次正式发布。 新增用户管理 修改 创建数据实体 管理数据实体属性 创建关系实体 管理关系实体属性 2023-04-15 第五次正式发布。 修改 删除数据实体 删除关系实体 删除接口模型 管理数据实体属性 管理关系实体属性 管理接口模型属性 2023-03-18 第四次正式发布。 新增关系实体概述 修改 数据看板 创建数据实体 管理数据实体属性 管理功能配置 发布数据实体 创建关系实体 管理关系实体属性 查看关系实体 2023-02-18 第三次正式发布。 新增 XDM应用 导出API 导入Erwin 修改 创建数据实体 创建关系实体 管理数据实体属性 管理关系实体属性 管理接口模型属性 管理功能配置 2023-01-15 第二次正式发布。 新增反向建模 修改 创建数据实体 管理功能配置 应用发布历史 2022-11-30 第一次正式发布。 父主题: 设计态使用指南
  • 步骤5:实例界面布局设置 创建数据实体时,如果“基本信息”中的“实例界面显示”为“是”,可通过如下操作对属性进行布局。 选择“实例界面布局设置”页签,进入实例界面布局设置页面。 图9 实例界面布局设置 根据实际业务需求进行如下设置,单击“保存”。 支持对数据实体的属性和关联的关系实体进行布局。 布局属性:您可以根据页面提示,复制其他数据实体的布局,也可以自定义设置界面布局。 布局关系:布局方式支持无、自定义和复制其他数据实体。
  • 修订记录 发布日期 修改说明 2024-5-11 第十四次正式发布。 新增 值集 流程引擎 修改 创建扩展属性 服务编排概述 2024-3-31 第十三次正式发布。 新增 属性库概述 属性目录管理 合法值概述 合法值目录管理 修改 属性库 合法值 创建搜索服务 索引定义管理 2024-02-23 第十二次正式发布。 新增 权限管理概述 索引管理 修改 数据实体 关系实体 接口模型 属性库 创建授权 管理数据实例授权 服务编排概述 搜索服务定义概述 2023-11-27 第十一次正式发布。 新增 初始化异常 创建关系实体 作废关系实体 修改 数据实体 关系实体 属性库 全量数据服务 2023-10-29 第十次正式发布。 新增 配置模型实例管理 导出团队角色 导入团队角色 导出群组 导入群组 导出全局角色 导入全局角色 失效授权 生效授权 修改 我的工作空间 创建扩展属性 修改数据实体 管理数据实例授权 权限管理 2023-09-16 第九次正式发布。 新增 语言实例管理 多语言&工程符号 2023-07-22 第八次正式发布。 修改 搜索服务定义概述 同步搜索服务的数据 搜索实例 添加分组 添加标签 2023-06-17 第七次正式发布。 新增文件类型白名单 修改 查看数据实体 修改数据实体 2023-05-20 第六次正式发布。 新增 下载离线文件 搜索实例 修改服务编排概述 2023-04-15 第五次正式发布。 新增 另存团队 另存群组 修改 服务编排概述 创建Java服务编排 创建JavaScript服务编排 创建搜索服务 索引定义管理 服务配置管理 搜索日志 下线搜索配置 2023-03-18 第四次正式发布。 新增修订服务编排 修改 数据看板 创建合法值类型 创建生命周期模板 创建Java服务编排 创建JavaScript服务编排 2023-02-18 第三次正式发布。 新增导出API 修改 修改数据实体 删除单位类型 编辑单位类型 失效单位类型 2023-01-15 第二次正式发布。 新增 搜索服务管理 应用中心 2022-11-30 第一次正式发布。 父主题: 运行态使用指南
  • 操作场景 应用同步指两个应用之间的数据同步,工业数字模型驱动引擎-数据建模引擎(xDM Foundation,简称xDM-F)支持跨环境、跨租户同步应用设计态数据。例如, 同一租户下,将数据同步至不同环境标识的同名应用。例如,将“环境标识”为“dev”的A应用同步至“环境标识”为“sit”的同名应用。 同一租户下,将数据同步至除源应用自身以外的环境。例如,将广州友好区域的B应用同步至北京四区域的C应用。 不同租户下,但源应用和目标应用都属于iDME应用,这种应用之间的数据同步。
  • 不支持的范围 在应用设计态添加索引时,不支持选择RdmDeleteFlag和MasterId属性。 不支持JSON、文件、URL和长文本类型的属性。 选择“普通索引”时,如果属性的约束信息包含如下定义,则不支持。 “入库”为“否”的属性。 “多值”为“是”的属性。 “唯一键”为“是”的属性。 选择“唯一索引”时,如果属性的约束信息包含如下定义,则不支持。 “入库”为“否”的属性。 “多值”为“是”的属性。 “唯一键”为“是”的属性。 选择“唯一索引忽略大小写”时,如果属性的约束信息包含如下定义,则不支持。 “入库”为“否”的属性。 “多值”为“是”的属性。 “唯一键”为“是”的属性。
共100000条