1. 二、接入配置

2.1应用注册

参照“应用管理”注册第三方应用。

2.2应用接入

n操作说明:包括用户绑定、消息集成、待办集成、单点登录、事件绑定、菜单绑定、套件配置

图接入列表

2.2.1用户绑定

操作说明:

【绑定类型】支持点对点绑定(可以自动匹配和手工匹配),免绑定,LDAP/AD绑定。

【匹配类型】支持账号匹配、编码匹配、eMail匹配、手机号匹配

图 接入设置页面-用户绑定

图 自动匹配和手工匹配

图 用户绑定接口选择

注意:自动匹配、新建、修改需要有对应接口实现或接口库注册的接口才能使用;详细使用说明参考开发内容部分;免绑定方式可以免去每个用户必须绑定的操作,可以按登录名称,编码,邮件,手机号作为匹配依据。

2.2.2消息集成

l选择已经注册的第三方应用

l选择消息获取模式:第三方推送和第三方读取

l如果选择了第三方读取则可以设置时间间隔,启用后会定时读取消息,可以选择URL、接口模式,如果都不选择为默认内置接口模式

l第三方应用读取如果要灵活的实现,不使用URL和接口则可以自己实现代码,详情参见第三部分的开发内容

l当选择读取模式后如果按致远默认路径URI提供了接口,需要提供服务地址,详情参见第三部分的开发内容

图消息集成设置

【第三方认证】:需要选择认证接口和认证参数名称(第三方提供)

图 穿透认证为第三方认证

【读取方式】:当消息获取模式为读取时,可以选择URL、接口模式,如果都不选择为默认内置接口模式

图 第三方系统读取

注意:所设置的接口需要在第三方接口库中配置。第三方消息内置接口相关信息需要到维护中心启动参数配置。

2.2.3待办集成

待办集成同2.4.2消息集成

l选择已经注册的第三方应用

l选择消息获取模式:第三方推送和第三方读取

l如果选择了第三方读取则可以设置时间间隔,启用后会定时读取消息,可以选择URL、接口模式,如果都不选择为默认内置接口模式

l第三方应用读取如果要灵活的实现,不使用URL和接口则可以自己实现代码,详情参见第三部分的开发内容

l当选择读取模式后如果按致远默认路径URI提供了接口,需要提供服务地址,详情参见第三部分的开发内容

图 待办效果->个人设置->空间栏目->扩展栏目配置第三方待办的栏目

2.2.4单点登录

操作说明:

【认证模式】分为门户认证机制、第三方认证机制、用户密码认证、第三方Token认证机制。

【应用类型】应用系统首页(可用于配置到空间,菜单,M3)、业务操作单元、报表(仅可被报表中心选择)、其他,默认为应用系统首页。

【管理地址】当设置此地址后,会显示在CIP的【应用服务管理】二级菜单下。

【登录授权】除了内置应用,企业用车、携程商旅、formtalk、电话会议外,其他应用均需要配置授权,普通用户才能有权限。

【PC登录地址】如果是PC类型或包含PC类型的接入方式,需要填写此地址。

【H5登录地址】如果是移动URL接入类型或包含移动URL接入类型的接入方式,需要填写此地址。

【门户认证机制】SSO接口配置行会显示出来,为带认证模式。

【第三方认证机制】当目前的认证机制不能满足第三方应用接入,则可以按规范内部实现接口,登录接口会显示在配置页面。

【第三方Token认证机制】此种认证类似于OAuth认证,需要选择认证接口,接口在接口库中定义。

【用户密码认证】支持简单的用户名和密码2个参数的认证机制

【本地原生应用】只有本地原生应用类型会显示出登录命令的配置页面,支持IOS,android,Windows 命令的配置。

图 默认状态

图 门户认证机制

图第三方认证机制

图 用户密码认证

2.2.4.1第三方Token认证机制

l类似于Oauth的认证方式,详情见开发内容部分

图 第三方Token认证

2.2.4.2原生App唤醒

支持主流的app移动端类型,选择对应类型输入对应命令,例如:

sycmpiphone://m1services?serviceParams={'module':'authentication/home','username':'{$userName$}','archiveID':'-1','fromurl':'com.others.path'}

图 原生应用唤醒命令

2.2.4.3管理地址

l管理地址即第三方应用管理员单点登录地址,对应致远协同的集团管理员,单位管理员

图 配置管理地址后的效果

图第三方管理员登录流程图

协同OA返回给第三方数据:{"code": 0,"data": {"userName": "集团管理员/单位管理员","loginName": "group-admin/admin","corpName": "测试集团","telPhone": "11111111111","role": [{"roleName": "集团管理员/单位管理员","roleCode": "GroupAdmin/corpAdmin" }] },"message": ""}
注意:l自定义加密算法需要符合如下:1、必须是加密类的全路径;2、类中需定义方法:encory,方法encory入参为字符串,返回类型也是字符串;l如果不配置登录授权则没有使用权限。

2.2.5事件绑定

n操作说明:通过内置的23个事件绑定,可以做到对应系统事件的操作来触发设置的URL或接口事件。

n【类别】:组织模型事件、新闻公告事件

图 23个事件

n操作步骤:

第一步:选择左面树形结构的一个具体事件

第二步:点击【新建绑定】后,录入对应信息

图 事件设置

【触发条件】:设置触发条件后,只有在条件满足时才会去调用设置的URL或接口,可设置为条件的内容是预制事件的参数。字符串类型的条件符号有==,包含,不包含,数字类型有>,>=,<,<=,==。

图 触发条件

【处理类型】:URL和接口,当设置URL后,事件被触发,事件参数以JSON格式调用URL;当设置接口后,事件参数仅会以接口设置的输入参数去调用。

【接口匹配】:处理类型设置为接口后,可以调用接口库中次产品下的接口,此时【事件关联数据】被激活,可选择,如图。

图 接口参数赋值

例如新增人员触发URL:{"id": "1211023486123131711","name": "张","memberLoginName": "zhangz","telNumber": "13316167890","code": "009","memberOrgDepartmentName": "部门","orgAccountName": "aa","orgPostId": "-1696775289751451665","orgPostCode": "","orgPostName": "岗位"}

2.3多模态展示

2.3.1缺省模式

已配置单点登陆的应用,缺省模式下表现为PC端“门户空间”模式和M3端的应用

2.3.2应用菜单绑定

可以将第三方应用设置为协同菜单(针对PC端)

n操作说明:应用菜单仅支持配置了单点登录的注册应用,并且接入类型是PC或有PC混合类型的接入。

nPC图标需要从图标库中选择,支持自定义上传的图标。

图 新建菜单页面

图 应用选择

图 可供选择菜单的图标库

2.3.3应用套件

可以将多个有相同特征的第三方应用组合成套件在M3端使用

n操作说明:支持9个以内注册应用的选择,支持配置了单点登录并且是移动类型的接入。

图 套件设置

图 移动端显示套件效果

results matching ""

    No results matching ""