入门

一. 概述

1.1. 业务场景

企业自建应用是企业为了满足业务拓展需求,由企业内部开发人员或者委托第三方软件 服务商开发的,仅供企业用户内部人员使用的应用。企业需要将自建应用接入到用友云工作 台,或者需要对接用友开放平台对外开放的 OpenAPI,则需要企业创建应用,并对应用赋予 接口权限,开发人员才能够进行免登和接口调用开发。 线上文档地址:https://open.diwork.com/#/doc-center/ 如需要更详细信息请查看

undefined

图 1

1.2. 使用流程

undefined

图 2

二. 开发流程

2.1. 创建应用

企业管理员登录用友云工作台( https://yonsuite.diwork.com ) 。注意必须是企业管理员用户,否则没有应用管理节点权限。选择租户,点击左上角的快捷应用中的 “数字化建模”-“系统管理”-“我的应用”,点击“我的应用”菜单,如下图所示:

undefined

图 3

进入我的应用页面,点击【添加自建应用】-【集成开发】,如下图所示:

undefined

图 4

打开添加自建应用页面,填写应用基本信息,如下图所示:

undefined

图 5

2.2. 接口授权

登录用友云工作台,点击左上角菜单按钮,选择【数字化建模】-【系统管理】-【我的应用】菜单,打开【我的应用】页面,点击【开放平台】按钮

接口授权操作指南

  • 常见注意事项

报以下错误说明接口没有授权,请按照上面文档对指定接口授权

403 Forbidden: [{"code":"310037","message":"API未被授权:APPKEY[d9ff741295044f63a99bf198950c7bb9]未获得要调用的API[/yonbip/uspace/rest/todo/upesn/v2/items]的授权"}]

2.3. 创建服务列表 (不需要页面集成的可跳过)

返回到应用列表,点击服务列表,如下图所示:(如果只是接口通信,则跳过后续操作,不用做服务列表)

undefined

图 6

点击【添加自建服务】,打开添加自建服务页面,填写服务信息,如下图所示:

undefined

图 7

字段 说明
服务基本属性配置
服务名称 名称不能多于6个汉字或者12个字母
服务图标 支持选择默认图标和上传本地图标2种方式;本地图标尺寸必须为120*120的JPG、GIF、PNG图片,且尺寸不大于5M
发布客户端 应用的客户端类型,包括 Web端、PC Client端、友空间、微信、钉钉,至少选择一类,选择后需要填写相应的配置信息
Web端,即用友工作台
web端主页 当客户端选择web端时显示,填写web端的主页地址,必填项
web端打开方式 在当前页面打开和在新页面打开;当前页面表示就在浏览器的当前页面跳转到web端的主页地址;新页面表示在新窗口或新的标签页打开web端的主页地址
集成免登策略 选项包括:无、友空间;选择友空间则按照友空间的免登机制进行免登
PC Client端,即友空间桌面端
PC客户端主页 输入在友空间桌面端打开时跳转地址
pcClient打开方式 支持PC客户端内、浏览器新页、本地3种方式
友空间,即友空间APP端
app原生导航 如果移动应用使用友空间APP原生的导航栏则勾选是,如果使用应用自己的导航栏则勾选否
是否原生 移动应用是原生开发的应用,还是H5轻应用
移动端主页 当是否原生选择否时显示,填写移动端的主页地址
summerId 请输入上传到IUAP平台的安装包ID
推荐到移动端首页 当前移动应用是否推荐到友空间APP首页,如果推荐,是放在最前面,还是最后面

调用接口报

三. 代码Demo

3.1. git地址

undefined

图 10

3.2. 注意事项

 查看 `app.key` `app.secret` `app.code
【我的应用】->选择自己建的应用->浮动行上点击右侧【开放平台】->【API授权】

undefined

图 10

3.3. 接口文档 (根据需求判断是否使用)

获取租户所在数据中心域名

获取access token接口文档

  • 注意:【获取access token接口文档】的基础域名替换为【获取租户所在数据中心域名】返回的域名

举例:如果 【获取租户所在数据中心域名】的返回值为(注意不同租户返回结果不一样): {"code":"00000","message":"成功!","data":{"gatewayUrl":"https://yonbip.diwork.com/iuap-api-gateway","tokenUrl":"https://yonbip.diwork.com/iuap-api-auth"}}

那么获取token的请求地址为:

https://yonbip.diwork.com/iuap-api-auth/open-auth/selfAppAuth/getAccessToken

Copyright © 用友 -【生态技术部】 2021 all right reserved,powered by Gitbook修订时间: 2022-07-03 18:42:59

results matching ""

    No results matching ""