云服务器内容精选

  • 接口对接指导 应用需要完成的逻辑 在用户访问应用时,应用需要判断是否已经登录,如果没有登录,需要重定向到CraftArts IPDCenter登录页面,重定向的地址为下面接口中的获取授权码接口。 用户在CraftArts IPDCenter登录成功后,CraftArts IPDCenter会自动重定向到应用页面,同时会携带授权码,此时,应用在后端需要通过授权码调用 CraftArts IPDCenter的2个接口(getToken接口、getUserInfo接口),换取具体的用户信息。 接口信息地址 应用实例授权登录,获取授权码接口 用户级Token获取 Token刷新 退出登录接口
  • 为用户授权 进入“用户管理”页面,搜索需要授权的用户。 单击操作列的,进入“授予权限”页签,选择“新增行”。 选择“角色编码”中的下拉列表,根据表1中的角色说明,设置系统角色。 表1 角色权限 角色名称 角色说明 系统管理员(System Admin) 拥有系统操作的最高权限,可以添加用户,对除自身外的其他用户进行业务数据授权。 业务管理员(Business Admin) 业务数据管理员角色,可对业务数据进行管控。 操作用户(Operator) 具有常规操作权限,可进行创建文档、创建部件、创建分类等常规业务操作。 访客角色(Guest) 仅能访问产品主数据协同服务首页。 在“数据范围”中输入“ProgramAll”,单击“搜索”,勾选列表中的数据,单击“确定”。 图4 设置数据范围 设置权限的有效时间,“开始时间”及“结束时间”。 单击“保存”,完成授权设置。
  • 流程应用 打开浏览器访问如下地址。 http://{ 域名 }/pdmcore/ipdcworkflowservice/console/ui/definition_micro/{example1}/{example2}/index.html 其中,example1为流程的英文名称,example2为版本号。 按照定义好的流程顺序,填写流程信息及审批人。 各节点审批通过后,流程结束。 流程申请人可以在过程中关闭流程,或撤回重新填写流程。
  • 流程应用 打开浏览器访问如下地址。 http://{域名}/pdmcore/ipdcworkflowservice/console/ui/definition_micro/{example1}/{example2}/index.html 其中,example1为流程的英文名称,example2为版本号。 按照定义好的流程顺序,填写流程信息及审批人。 各节点审批通过后,流程结束。 流程申请人可以在过程中关闭流程,或撤回重新填写流程。
  • 接口对接配置 应用需要完成的逻辑 在用户访问应用时,应用需要判断是否已经登录,如果没有登录,需要重定向到OrgID登录页面,获取认证集成配置中的“首页URL”地址。 用户在OrgID登录成功后,OrgID会自动重定向到应用页面,同时会携带授权码,此时,应用在后端需要通过授权码调用OrgID的2个接口(getToken接口、getUserInfo接口),换取具体的用户信息。 OrgID接口信息地址 获取AccessToken 获取用户信息 图5 通过授权码获取token接口 图6 通过token获取用户信息接口
  • 授权管理配置 在授权管理页面对用户进行授权(配置哪些账号可以登录此应用)。 单击“授权设置”,在“授权设置”界面中选择被授权成员信息,单击“下一步”。 图3 授权设置-1 选择可用成员范围,可勾选“全员可用”或“自定义人员范围”,勾选“自定义人员范围”后还需要选择指定的部门与成员或者用户组。 图4 授权设置-2 设置后,应用授权范围中会显示授权部门、授权成员或授权用户组信息。同时,授权用户列表中也会展示授权账号的详细情况(包括姓名、账号名、应用侧角色、来源、更新时间和同步状态),支持按照时间或账号名进行过滤查询。 单击“确定”。
  • 基本信息配置 登录管理中心。 选择左侧导航栏的“应用管理”。 单击“添加自建应用”。 图1 添加自建应用 输入应用名称,如“自建App”。 上传应用图标,图标要求必须为JPG或PNG格式,大小不超过20KB,尺寸240*240px。 选择应用类型,当前仅支持选择“Web”。 设置应用负责人,输入并选择成员姓名,将成员设置为应用负责人。 应用负责人即该应用的应用管理员,只有应用管理员才能更新该应用配置,其他管理员没有操作该应用的权限。 普通成员不能成为应用负责人,需先成为组织管理员、部门管理员才能被设置为应用负责人。 单击“确定”,进入认证集成页面。
  • 认证集成配置 OrgID的登录集成方式推荐使用OAuth2。 图2 选择认证方式 表1 参数说明 认证集成方式 参数名称 参数说明 OAuth2 首页URL 应用首页的URL地址,例:https://xx.xx。 支持设置多个首页的URL地址,可单击“新建URL”,添加新的URL地址。 管理员登录URL 可选项,管理员登录应用的URL地址。 退出地址 可选项,应用的退出地址,请以http或https开头,例:https://xx.xx/logout。 Refresh Token有效期(秒) 允许用户在多久时间内不用重新登录应用的时间。 Access Token有效期(秒) 允许用户在多久时间内保持登录应用的时间。 配置“首页URL”,此参数配置为产品首页的URL,集成OrgID后,在OrgID登录成功后会跳转到此地址,并携带认证参数。
  • 创建流程节点 流程申请单创建完成后,返回至申请单列表页面,单击操作列的“编辑”,进入流程编辑页面。 绘制如图1所示的流程图。 图1 自制件BOM审核发布流程 添加“开始事件”“结束事件”“用户任务”“并行网关”和“内嵌子流程”组件到画布中。 修改组件名称:双击组件修改名称,或单击组件,在右侧的属性面板中修改组件名称。 “重新提交”用户任务组件,支持提交人发起流程后,将流程撤回到“重新提交”节点,重新修改内容后再次提交流程。 提交人在Start节点可关闭流程,在其他用户任务节点可撤回重填。 单击组件,使用箭头连接线,连接组件。 连接时注意箭头的走向。 选择连接线,在右侧的面板中设置“中文名称”及“英文名称”。 对于用户任务,如果有不止一个走向,还需要在“通过条件”中选择“表达式”来判断走向。 图2 通过条件 设置任务组件中的责任人信息。 单击“用户任务”组件,在“责任人”中选择已配置的团队角色。即任务由该角色处理,在提交页面也需要配置对应的参与者。 图3 设置审批责任人 修改完成后,单击右上角的“保存”。
  • BGBU优选等级说明 主要针对采购件。新物料选型后,进行综合评估,优选等级根据结果从高到低分为“B优选”“D可选”“DXX禁选”三种等级,分为集团级优选等级和产品线级优选等级。 B优选:综合评估结果好,能保障和提升产品安全性/功能/性能/稳定性的部件等。 D可选:综合评定结果一般,但对产品使用场景有价值或需要限制使用的部件。使用时需要人工技术评审,评估通过后才能使用。 DXX禁选:综合评定结果差,如果选用,将对产品安全性/功能/性能/稳定性等造成负面影响,或者引入知识产权等风险。对于鉴定为“DXX禁选”的部件,不允许产品使用,如有例外,需要去对应决策团队评审。
  • API规范示例 为了对外API在调用时有用户信息,API调用时需要在header中传递Modifier、Creator字段。 值格式为:用户名+空格+用户id,如图1所示。 图1 示例 具有AccessControlled功能的实体,其API做了权限管控,权限管理依赖团队信息,因此在传递机机token时需要添加团队信息,即机机的jwt token中iss字段。 格式为:用户名:用户id:租户id:团队名
  • 响应示例 状态码: 200 轻量化状态响应Vo对象 { "id" : "4f2bddfa-dee7-4858-b41c-34705e9642a3", "name" : "010758215.stp", "status" : "SUC CES S", "is_chunked" : true, "chunk_total" : 29, "source" : "temp", "type" : "PART", "create_time" : "2024-06-21 10:18:10", "update_time" : "2024-06-21 10:18:32", "file_lightweight_task_result" : { "file_id" : "4f2bddfa-dee7-4858-b41c-34705e9642a3", "file_name" : "010758215.stp", "status" : "MOUNTING", "task_id" : "3bfe5727-ec30-4539-bbc0-4be54fbdaee2", "create_time" : "2024-06-21 10:18:10", "update_time" : "2024-06-21 10:18:37" } } 状态码: 400 错误响应 示例一: { "error_code" : "01090001", "error_msg" : "系统错误,请联系管理员!" } 示例二: { "error_code" : "01099901", "error_msg" : "请求参数无效!" } 示例二: { "error_code" : "01099902", "error_msg" : "认证失败!" }
  • 响应参数 状态码: 200 表3 响应Body参数 参数 参数类型 描述 id File 文件id 最小长度:36 最大长度:40 name String 文件名称 最小长度:2 最大长度:512 status String 上传状态: 上传中UPLOADING/上传完成SUCCESS/上传失败FAILED 枚举值: UPLOADING SUCCESS FAILED is_chunked Boolean 是否分片:true,false chunk_total Integer 分片总数 最小值:0 最大值:1000 source String 来源 最小长度:1 最大长度:255 type String 文件类型:PART,ASSEMBLY 枚举值: PART ASSEMBLY create_time String 创建时间 最小长度:1 最大长度:30 update_time String 更新时间 最小长度:0 最大长度:30 file_lightweight_task_result FileLightweightTaskResultRspVo object 文件轻量化转换任务Vo对象 file_chunk_upload_result Array of FileChunkUploadRspVo objects 文件分片上传响应Vo对象 数组长度:0 - 1000 表4 FileLightweightTaskResultRspVo 参数 参数类型 描述 file_id String 文件id 最小长度:36 最大长度:40 file_name String 文件名称 最小长度:2 最大长度:255 status String 轻量化状态:UPLOADING,UNMOUNTED,MOUNTING,SUCCESS,FAILED 枚举值: UPLOADING UNMOUNTED MOUNTING SUCCESS FAILED failed_reason String 失败原因 最小长度:0 最大长度:500 task_id String 轻量化任务id 最小长度:1 最大长度:40 create_time String 创建时间 最小长度:1 最大长度:30 update_time String 更新时间 最小长度:0 最大长度:30 lightweight_file_path String 轻量化文件路径 最小长度:0 最大长度:500 表5 FileChunkUploadRspVo 参数 参数类型 描述 chunk_id String 文件分片id 最小长度:36 最大长度:40 chunk_status String 上传状态: 上传中UPLOADING/上传完成SUCCESS/上传失败FAILED 枚举值: UPLOADING SUCCESS FAILED chunk_index Integer 分片索引 最小值:0 最大值:1000 create_time String 创建时间 最小长度:1 最大长度:30 update_time String 更新时间 最小长度:0 最大长度:30 状态码: 400 表6 响应Body参数 参数 参数类型 描述 error_code String 错误码 最小长度:8 最大长度:36 error_msg String 错误描述 最小长度:2 最大长度:512
  • 功能介绍 查询轻量化任务状态 图纸上传完成后,即可调用该接口获取图纸轻量化转换状态,该接口可能需要调用多次,直到返回的数据轻量化状态为SUCCESS或FAILED,即代表轻量化转换结束。 如果轻量化状态为SUCCESS,则代表图纸轻量化转换成功,此时可通过lightweight_file_path字段获取的路径进行轻量化文件下载。 如果轻量化状态为FAILED,则代表图纸轻量化转换失败,此时可以根据返回的失败原因进行排查处理。 如果获取的轻量化状态为其他值,说明该图纸处于上传获取转换等阶段,此时继续轮询该接口即可。
  • 请求参数 表1 请求Header参数 参数 是否必选 参数类型 描述 Authorization 是 String 机机认证token,获取token请参考链接:https://support.huaweicloud.com/devg-craftartsipdcenter/ipdcenter_08_0015.html 表2 请求Body参数 参数 是否必选 参数类型 描述 task_id 是 String 任务id 最小长度:32 最大长度:36