# NC基础集成插件手册

# 目录 {#目录 .TOC-Heading}

[致远A8+协同管理软件V8.0 1](#_Toc465347638)

[用户操作手册 1](#_Toc3780)

[NC基础集成插件手册 1](#_Toc41323508)

[一、总体概述 6](#总体概述)

[1.1 核心价值 6](#核心价值)

[1.2 功能清单 6](#功能清单)

[二、集成环境配置要求 8](#集成环境配置要求)

[2.1 硬件配置 8](#硬件配置)

[2.2 软件环境 9](#软件环境)

[三、安装配置 10](#安装配置)

[3.1 操作前提（重要） 10](#操作前提重要)

[3.2 A8应用配置（组织数据同步先决条件，此处配置完成，可直接进行组织数据同步） 13](#a8应用配置组织数据同步先决条件此处配置完成可直接进行组织数据同步)

[3.2.1 NC插件启动参数设置 13](#nc插件启动参数设置)

[3.1.2 说明 25](#说明)

[3.2 NC相关配置 25](#nc相关配置)

[3.2.1 NC插件配置 25](#nc插件配置)

[3.2.2 NC应用配置 26](#nc应用配置)

[3.3 NC集成A8（只针对NC 5.5，NC 5.6，NC5.7） 28](#nc集成a8只针对nc-5.5nc-5.6nc5.7)

[3.3.1 NC配置 28](#nc配置)

[3.3.2 NC-Portal与A8-Portal账户绑定 29](#nc-portal与a8-portal账户绑定)

[3.3.3 配置A8单点登录信息 31](#配置a8单点登录信息)

[3.3.4 解决NC-Portal中A8被迫下线 32](#解决nc-portal中a8被迫下线)

[3.4 nccheck 34](#nccheck)

[四、使用指南 35](#四使用指南)

[4.1 组织数据同步 36](#组织数据同步)

[4.2 单点登录 43](#单点登录)

[4.3 任务集成 45](#任务集成)

[4.4 消息集成 46](#消息集成)

[4.5 多NC集成 47](#多nc集成)

[五、常见问题与解决方案 49](#五常见问题与解决方案)

[5.1 安装配置常见问题与解决方案 49](#安装配置常见问题与解决方案)

[5.2 使用中常见问题与解决方案 50](#使用中常见问题与解决方案)

[六、支持服务 54](#支持服务)

# 总体概述
1. # 核心价值

实现业务流程与管控流程的一体化。
统一企业门户、消除信息孤岛、业务关联展现。
通过和业务系统的深度整合，加强黏着度，为老客户经营提供利器。
缩短项目开发周期、减少实施难度，降低维护成本。
1. # 功能清单

门户平台整合：

利用A8现有的Portal，实现NC系统的多账户登录；

 利用NC-Portal，实现A8与NC系统的单点登录，集成展示；

内容整合：

 在A8-m协同系统中，实现NC待办事项处理的无缝集成；

 在A8-m协同系统中，实现NC消息集成，及时获得NC系统公告信息；

数据整合：

 实现NC中HR提供的组织架构(单位/人员等)的手工或自动同步；

 实现NC中多账户信息与A8中人员的手工关联；

 实现NC-Portal与A8账户关联；

集成方式：

 单点登录方案一：A8-Portal + NC

 单点登录方案二：NC-Portal + A8

现有NC基础集成插件适用环境：

 NC版本： NC5.7、NC6.3、NC6.5

# 集成环境配置要求
1. # 硬件配置

+---------------+----------------------+------------------------------+ | 配件 | 最低配置 | 推荐配置 | +===============+======================+==============================+ | CPU | 英特尔® 奔腾®4 | Intel core双核3.0GHz； | | | 3.0GHz | | | | | AMD 64位3.0GHz | +---------------+----------------------+------------------------------+ | 内存 | 大于等于1G Bytes | 大于等于4G Bytes | +---------------+----------------------+------------------------------+ | 显示器分辨率 | 1280以上 | 128 | | | | 0*768、1280*800、1366*768 | +---------------+----------------------+------------------------------+ | 网卡 | 100M | 100M | +---------------+----------------------+------------------------------+

# 软件环境

+------------------+-----------------------------+---------------------+ | 名称 | 版本 | 备注 | +==================+=============================+=====================+ | Windows系统 | 中文(简/繁)、英文； | 无 | | | | | | | Windows | | | | 2000/2003/XP/Vista/7/8 | | +------------------+-----------------------------+---------------------+ | 浏览器 | IE7/8/9/10/11 | 1、不支持IE6； | | | | | | | | 2、 | | | | 不支持64位浏览器； | +------------------+-----------------------------+---------------------+ | NC | NC | 安装HR模块 | | | 5.5/NC5.6/NC5.7/NC6.3/NC6.5 | | +------------------+-----------------------------+---------------------+

# 安装配置

# 操作前提（重要）

+------+---------------------------------------------------------------+ | ![]( | **说明一：**OA中部门编码、人员编码不能为空 | | /dat | | | a/ap | 编码为空，组织数据 | | p/op | 同步时有可能会出现人员名称被占用、或者名称为null等若干问题； | | ense | | | eyon | **说明二：**只有行政类组织可以同步过来 | | -man | | | agem | 组织机构同步时查询同步机构必要条件为机构必须为行政类 | | ent/ | | | pand | **说明三：**V8.0及其以后版本： | | oc/i | | | mage | 使用NC基 | | s/12 | 础插件做组织同步，同步人员信息时，不同步NC中"相关人员信息"； | | NC基 | | | 础集 | **说明四：**同步前检查数据库驱动以及jar是否配置正确 | | 成插 | | | 件手 | A8 为7.0版本: | | 册_ | | | v8.0 | <1>如果NC是Oracle数据 | | _202 | 库，A8是MySQL或者SQLServer数据库，需要从Oracle的客服端下拷贝o | | 0042 | jdbc14.jar文件到【A8_home】/lib下,例如：E:\Seeyon\A8\lib； | | 1/me | | | dia/ | <2>如果NC | | imag | 是Oracle11g数据库，NC-OA协同是SQLServer数据库，需要从Oracle的 | | e4.p | 客户端下【Oracle_clIEnt_home】/clIEnt_1/jdbc/lib下的ojdbc5.j | | ng){ | ar文件到【A8_home】/lib下（如果【A8_home】/lib存在classes12.j | | widt | ar和ojdbc14.jar，则必须删除这两个文件，否则将不能正常运行）。 | | h="0 | | | .427 | A8 为6.1版本: | | 0833 | | | 3333 | <1\ | | 3333 | >如果NC是Oracle数据库，A8是MySQL或者SQLServer数据库，需要从Or | | 3in" | acle的客服端下拷贝ojdbc14.jar文件到【A8_home】/ApacheJetspeed | | hei | /lib下,例如：D:\Seeyon\6.1SP1\ApacheJetspeed\lib； | | ght= | | | "0.5 | <2>如果NC是Oracle11g数据库， | | in"} | NC-OA协同是SQLServer数据库，需要从Oracle的客户端下【Oracle_cl | | | IEnt_home】/clIEnt_1/jdbc/lib下的ojdbc5.jar文件到【A8_home】/ | | | ApacheJetspeed/lib下（如果【A8_home】/ApacheJetspeed | | | /lib存在classes12.j | | | ar和ojdbc14.jar，则必须删除这两个文件，否则将不能正常运行）。 | | | | | | **说明五：**检查OA的ip地址是否配置正确 | | | | | | 在NC安装目录下找到E:\nc65home\modules\trans 下的 | | | system.properties文件 | | | | | | 查看OA的地址是否配置正确，以及webservice密码是否配置正确 | | | | | | ![](/data/app/openseeyon-management/pandoc/images/12NC基 | | | 础集成插件手册_v8.0_20200421/media/image5.png){width="6.0in" | | | height="2.9520833333333334in"} | | | | | | **说明六：**手动同步时间系统默认设置为2000-01-01 00:00 | | | | | | ![](/data/app/openseeyon-management/pandoc/images/12NC基 | | | 础集成插件手册_v8.0_20200421/media/image6.png){width="6.0in" | | | height="2.7625in"} | | | | | | 如果手动同步后数据有问题，可修改该时 | | | 间，比如2018-01-02对同步数据做出修改，可设置时间为2018-01-01 | | | | | | **说明七：**组织数据同步后，出现问题可参考 [五 | | | 常见问题与解决方案] | +======+===============================================================+ +------+---------------------------------------------------------------+

# A8应用配置（组织数据同步先决条件，此处配置完成，可直接进行组织数据同步）

功能说明：CIP集成平台中对NC插件进行参数配置(A8的7.0版本将6.1版本中SeeyonConfig脚本文件中对NC的相关配置移动到CIP集成平台中设置）

角色权限：集团管理员group-admin账号登录。

先决条件：已购买NC基础插件，并且注册授权成功。

操作步骤：

# NC插件启动参数设置

主页面选择CIP集成平台-ERP集成平台-NC插件-启动参数如下图；

{width="6.768055555555556in" height="3.70625in"}

# 3.1.1.1基础配置

{width="6.768055555555556in" height="2.464583333333333in"}

输入规则：*为比填项

编码：手动输入，不可重复；

<!-- -->

账套名称：手动输入，不可重复；

<!-- -->

账套编码：NC中账套编码，查找方式查看3.1.1.4参数获取；
**集团编码：**NC中集团编码，查找方式参考3.1.1.4参数获取；

<!-- -->

服务地址：NC插件访问地址，查找方式查看3.1.1.4参数获取；

<!-- -->

集成类型：选择基础集成+业务集成

{width="6.768055555555556in" height="2.5069444444444446in"}

NC版本：选择NC对应的版本（nc5/nc6）;
是否同步组织机构：是

<!-- -->

排序号：非必填

# 3.1.1.2单点登录/消息待办/NC门户参数设置

{width="6.768055555555556in" height="2.0118055555555556in"}

输入规则：*为必填项

nc-portal服务地址：输入NC插件访问地址

<!-- -->

单点登录打开模式：三种选择方式(Uclient,web,close),Uclient为使用NC客户端方式打开，web为使用浏览器方式打开，close为关闭单点登录入口；

<!-- -->

消息/待办穿透类型：两种选择方式(Uclient,web),Uclient为使用NC客户端方式打开，web为使用浏览器方式打开；
消息获取: 两种选择方式(启用,停用),启用为在协同消息列表中获取并显示NC对应人员的未查看消息，停用为不再获取并显示对应未查看消息；
待办获取: 两种选择方式(启用,停用),启用为在协同待办列表中获取并显示NC对应人员的待办，停用为不再获取并显示对应待办；

{width="6.0in" height="2.3805555555555555in"}

NC打开方式：分为两种打开方式（内嵌工作区与弹出窗口），

如果单点登录打开模式和消息/待办穿透类型选择web打开，则此处需要选择内嵌工作区，效果图如下，

{width="7.032468285214348in" height="3.4747233158355204in"}

如果单点登录打开模式和消息/待办穿透类型选择Uclient打开，则此处需要选择弹出窗口；即NC使用客户端打开

# 3.1.1.3组织同步信息设置

{width="6.768055555555556in" height="5.4631944444444445in"}

NC数据库驱动：根据NC数据库驱动选择为OracleDriver驱动
数据数据库连接URL、用户名、密码：查找方式查看3.1.1.4说明；
**部门编码类型：**三种选择方式（NC部门编码/NC单位编码+NC部门编码/NC部门主键）
- NC部门编码：A8部门编码=NC部门编码
- NC单位编码+NC部门编码： A8部门编码= "NC单位编码"-"NC部门编码"
- NC部门主键：A8部门编码=NC部门主键。
**部门主管同步：**两种选择方式（是/否），选择是时同步部门主管，选择否时则不同步部门主管。
**组织同步-职务级别来源：**分为两种选择方式（同步ERP职务名称到A8职务级别、同步ERP级别到A8职务级别）；

NC65：选择同步ERP职务名称到A8职务级别，则同步NC职务信息中的职务名称

选择同步ERP职务级别到A8职务级别，则同步NC职务信息中的职务类别

{width="6.0in" height="1.2347112860892389in"}

**NC57：**选择同步ERP职务名称到A8职务级别，则同步NC职务信息中的职务名称

选择同步ERP职务级别到A8职务级别，则同步NC职务信息中的职务级别

{width="6.0in" height="1.0006944444444446in"}

**岗位合并同步：**两种选择方式（是/否）。
- **是：**则岗位/职务在同步时按照"名称"合并。
- **否：**如果是单位到单位同步，则岗位编码/职务编码前增加部门编码，岗位名称/职务名称前增加部门编码；如果是单位到部门同步，则在岗位编码/职务编码前增加单位编码+部门编码，岗位名称/职务名称前增加单位编码+部门编码
**组织同步-岗位来源：**分为两种选择方式（同步ERP岗位到A8岗位、同步ERP岗位等级到A8岗位）；

NC6.5：选择同步ERP岗位等级到A8岗位，则同步NC基准岗位中的岗位序列

选择同步ERP岗位到A8岗位，则同步NC基准岗位中的岗位名称

{width="6.0in" height="2.115972222222222in"}

NC5.7：选择同步ERP岗位等级到A8岗位，则同步NC基准岗位中的岗位序列

选择同步ERP岗位到A8岗位，则同步NC基准岗位中的岗位名称

{width="6.0in" height="1.257638888888889in"}

**组织同步-账号同步：**分为两种选择方式（同步ERP账号为OA登录名、不同步ERP账号为OA登录名）；即组织同步后NC人员账号作为OA登录名；

{width="6.0in" height="1.4284722222222221in"}

**组织同步-账号自动绑定：**分为两种选择方式（自动账号绑定、不需要自动账号绑定）；

如果选择自动账号绑定：组织同步时，自动将NC账号绑定到对应的OA账号，即可实现单点登录、消息待办等业务；

如果选择不需要自动账号绑定：则需要手动绑定NC账号，在个人设置中绑定，如下图，绑定后可进行单点登录、消息待办操作；

{width="6.0in" height="1.71875in"}

**组织同步-新员工状态:**如果选择启用，组织同步后，OA中新员工状态为正常可用状态；选择不启用，组织同步后OA中新员工状态为停用，如果需要更改为状态为正常，则要手动修改；
**组织同步-主管/副岗：**分为（是、否）选择是，则组织同步时同步主管/副岗，否则不同步

# 3.1.1.4参数获取说明

①当NC数据库为Oracle时配置：

+-------------------------+--------------------------------------------+ | 名称 | 值 | +=========================+============================================+ | nc.db.driverClassName | oracle.jdbc.driver.OracleDriver | +-------------------------+--------------------------------------------+ | nc.db.hibernateDialect | org.hibernate.dialect.OracleDialect | +-------------------------+--------------------------------------------+ | nc.db.url | jdbc:oracle:thin:@[DATABASE IP | | | ADDRESS]:[PORT]:[SID] | | | | | | 例 | | | 如：jdbc:oracle:thin:@128.2.2.28:1521:nc | +-------------------------+--------------------------------------------+

注意：

A8 为7.0版本，数据库jar包拷贝路径：

<1>如果NC是Oracle数据库，A8是MySQL或者SQLServer数据库，需要从Oracle的客服端下拷贝ojdbc14.jar文件到【A8_home】/lib下,例如：E:\Seeyon\A8\lib；

<2>如果NC是Oracle11g数据库，NC-OA协同是SQLServer数据库，需要从Oracle的客户端下【Oracle_clIEnt_home】/clIEnt_1/jdbc/lib下的ojdbc5.jar文件到【A8_home】/lib下（如果【A8_home】/lib存在classes12.jar和ojdbc14.jar，则必须删除这两个文件，否则将不能正常运行）。

A8 为6.1版本，数据库jar包拷贝路径：

<1>如果NC是Oracle数据库，A8是MySQL或者SQLServer数据库，需要从Oracle的客服端下拷贝ojdbc14.jar文件到【A8_home】/ApacheJetspeed /lib下,例如：D:\Seeyon\6.1SP1\ApacheJetspeed\lib；

<2>如果NC是Oracle11g数据库，NC-OA协同是SQLServer数据库，需要从Oracle的客户端下【Oracle_clIEnt_home】/clIEnt_1/jdbc/lib下的ojdbc5.jar文件到【A8_home】/ ApacheJetspeed/lib下（如果【A8_home】/ApacheJetspeed /lib存在classes12.jar和ojdbc14.jar，则必须删除这两个文件，否则将不能正常运行）。

②当NC数据库为SQL Server时配置：

+-------------------+--------------------------------------------------+ | 名称 | 值 | +===================+==================================================+ | nc.d | net.sourceforge.jtds.jdbc.Driver | | b.driverClassName | | +-------------------+--------------------------------------------------+ | nc.db | org.hibernate.dialect.SQLServerDialect | | .hibernateDialect | | +-------------------+--------------------------------------------------+ | nc.db.url | jdbc:jtds:sqlserver://[DATABASE IP | | | ADDRESS]:[PORT]/[dbName] | | | | | | 例如Jdbc:jtds:sqlserver://128.2.2.28:1433/nc | +-------------------+--------------------------------------------------+

③NC5.7中如何查看相关信息

a)可以通过nchome\bin\ncSysConfig.bat程序在Data Source页签找到以下信息。"NC数据库连接用户名"、"NC数据库连接密码"、"NC数据库连接oracle URL"。

{width="6.312084426946631in" height="4.753816710411199in"}

b)可以通过nchome\bin\ncSysConfig.bat程序在Server页签找到NC访问地址信息。

{width="6.295606955380578in" height="4.213005249343832in"}

c)可以通过root账号登录NC系统管理-账套管理，找到NC账套编码信息。

{width="6.444224628171479in" height="3.7014949693788277in"}

或者可以通过root账号登录NC:手动加载界面，找到NC公司编码信息。nc57集团编码可默认填写0001或是公司编码。

{width="6.768055555555556in" height="3.129166666666667in"}

④NC65中如何查看相关信息

a)获取NC65账套信息

{width="5.768055555555556in" height="5.077083333333333in"}

{width="6.768055555555556in" height="2.0430555555555556in"}

b)获取NC65数据源链接信息

{width="5.768055555555556in" height="3.36002624671916in"}

# 3.1.2 说明

完成NC插件启动参数设置即可登录A8系统进行"组织数据同步"，可跳转到手册"使用指南-组织数据同步"部分进行查看。如果还需要进行"单点登录"、"任务集成"和"消息集成"请继续按照手册"NC相关配置"进行相关操作。

# NC相关配置

# 3.2.1 NC插件配置

**功能说明：**NC插件自动化配置工具，简称"ncdeploy"，可选择多种集成方式。

**角色权限：**服务器管理员，有访问ncdeploy目录权限。

**先决条件：**NC系统和A8系统都可以正常启动访问。

{width="7.284027777777778in" height="4.416666666666667in"}**操作步骤：**将ncdeploy放在nchome文件夹下，启动Setup.bat。patch.id集成方案选择方案一A8-Portal集成NC。并填写NC和OA的IP地址。如图1所示：

# 3.2.2 NC应用配置

**功能说明：**NC应用配置器，配置NC系统"外部信任地址"。

**角色权限：**服务器管理员，有访问nchome目录权限。

**先决条件：**已完成A8应用配置和ncdeploy配置。

# NC5.7

{width="6.858333333333333in" height="4.552083333333333in"}操作步骤：进入nchome/bin目录启动ncSysconfig.bat。左侧选择SystemConfig，在页签"外部地址信任"增行，分别输入A8和NC服务器IP地址。

# NC6.5

**操作步骤：（如果3.2.1配置无效，再进行如下操作）**进入nc65home/ierp/sf目录，修改ssoConfig.xml文件，在<String></String>中分别添加A8和NC服务器IP地址。

{width="5.768055555555556in" height="3.8413648293963254in"}

# NC集成A8（只针对NC 5.5，NC 5.6，NC5.7）

功能说明：NC-Portal集成A8，使用Portal帐号单点登录。（如果只进行A8集成NC相关操作，可跳过此节）

角色权限：服务器管理员。

先决条件：A8与NC-Portal实现账户绑定；A8服务器使用标准端口(80)部署；按照方案一进行配置A8与NC的信任关系，并建立Design数据源；NC Portal能够正常运行。

操作步骤：

# NC配置

配置NC，添加A8页签。

使用域名访问Portal，以Admin用户登录，进入布局管理，新建系统布局，建立"A8首页"系统布

局（NC5.6需要公司管理员来建立布局，较NC5.5有大的改变，具体操作请见NC5.6portal操作手册。）

{width="5.28125in" height="2.6458333333333335in"}

在设置布局信息区点击右键，添加资源。选择"A8MainPortlet"后，点击保存。

进入资源管理，确保A8布局和A8 Portlet不受权限控制（未勾选状态），保存。

{width="3.4270833333333335in" height="1.6458333333333333in"}

# NC-Portal与A8-Portal账户绑定

注意：请勿使用A8服务器的浏览器登录，否则登录A8后会被迫下线。

方法一：用户自服务

首次使用NC-Portal登录A8-Portal时，页面将显示A8身份验证页面（或点击右上角"A8登录"），

输入A8登录名/密码后，系统自动完成账户绑定，并登录系统.第二次登录时，将实现单点登录。

首次使用时A8账户绑定页。

方法二：系统管理员完成账户绑定

NC-Portal账户管理员，在账户管理页面完成NC-portal页面与A8账户的绑定工作，用户使用时只

需要输入NC-Portal就可以完成单点登录。

步骤1： NC-Portal登录管理员账户。

{width="5.302083333333333in" height="2.6458333333333335in"}

步骤2：增加一个Portal账户，并保存(例如u2-admin)。

{width="5.28125in" height="1.8541666666666667in"}

步骤3：在该界面进入"A8"用户绑定界面，点【修改】按钮，录入A8账户的登录名和密码，勾

上"是否关联"，并保存。

{width="6.354166666666667in" height="3.1458333333333335in"}

步骤4：用户单点登录NC-Portal，并实现单点登录。

# 配置A8单点登录信息

以Portal管理员的身份登录NC-Portal进行配置。

步骤1：点击左边的"配置管理"，点击"单点登录配置"，确认有没有"A8"单点登录配置信息，

如果没有则点击"增加"，有配置信息则可以跳过此步。

{width="6.354166666666667in" height="3.1458333333333335in"}

步骤2："配置项标识"和"配置值"如下：

systemCode:A8；systemName:A8；enableMapping:true；

authClass: nc.portlet.thirdintegration.a8.A8Login；gateUrl: [http://$/login/sso]{.underline}

步骤3：配置"集成设置"直接点击"行操作""增行"。

registryUrl: [http://$/remotereg]{.underline} (opens new window)；relogin:yes

{width="2.5in" height="1.0729166666666667in"}

步骤4："IP映射"中"来源IP"指的是NC-Portal的地址，"目标IP"是A8的地址，在此处配

置上IP和域名。

# 解决NC-Portal中A8被迫下线

解决问题描述：解决问题描述：点击门户的注销按钮后，再次登录门户访问OA，会报OA被迫下线。

这个补丁解决在点击门户注销时直接调用A8的注销服务注销A8系统。

修改logout.jsp中的127.0.0.1为A8正式环境的ip+port。将logout.jsp复制到portal的nchome下的\hotwebs\portal目录，覆盖原有同名文件。无需重启portal服务，刷新浏览器测试即可。找到NC-Portal安装目录：\nchome\hotwebs\portal\logout.jsp文件，在此文件的<% %>标签中注释掉如下语句:

//response.sendRedirect("c");

然后在文件最后添加如下语句：

<%

String force = request.getParameter("force");

if(force != null){

nc.bs.portal.util.SecurityUtil.addSession(session);

}

else{

nc.bs.portal.util.SecurityUtil.clearLicenseInfo(session);

session.invalidate();

//response.sendRedirect("c");

}

%

<iframe src="http://127.0.0.1/login/logout" frameborder="0"></iframe>

<script>

function openDomain()

{

window.location.HRef = '/portal/c';

}

openDomain();

</script>

a8.seeyon.cn改为A8的真实IP或域名，切记是英文状态输入。如果NC-Portal部署在WAS环境下，需要再次执行deployment,以便将修改的信息发布到WAS使其生效。

单点登录客户端浏览器设置

由于IE和NC Portal的安全限制，单点登录必须对客户端浏览器进行下面的设置：

第一步：将A8、NC和NC Portal（NC与Portal分开部署时）设置为IE可信站点。

打开IE，进入【工具】-【Internet选项】-【安全】；选择可信站点；点击站点；在弹出的对话框中输入A8（NC、NC Portal）服务器的域名和IP地址；点击添加。

{width="6.0in" height="3.71875in"}

第二步：在隐私的允许站点中添加A8、NC和NC Portal。

打开IE，进入【工具】-【Internet选项】-【隐私】；点击站点；在弹出的对话框中输入A8（NC、NC Portal）服务器的基础域名或IP地址；点击允许。

# 3.4 nccheck

**功能说明：**nc部署检测工具

**操作步骤：**使用管理员账户登录OA，进入CIP集成平台，然后进入集成维护模块，点击部署检测，点击检测，检查nc部署情况

{width="6.0in" height="2.5166666666666666in"}

{width="6.0in" height="2.6006944444444446in"}

# 四、使用指南

NC基础插件主要有四大功能：组织数据同步、单点登录、任务集成和消息集成。

其中"组织数据同步"是基础，只有先完成此项才能进行后面三项操作。

同时"单点登录-NC账号匹配"又是"任务集成"和"消息集成"的基础，只有完成此项配置才能继续。

# 4.1 组织数据同步

功能说明：将NC中的单位、部门、岗位等级（岗位）、职务级别（职务名称）、人员（以下简称组织数据）同步到A8-V5协同管理软件的组织信息中。可进行自动和手工两种同步方式。关于人员同步，A8-V5协同管理软件同步NC系统中HR模块的所有在职用户，并可同步绑定这些用户对应的帐号。

角色权限：集团管理员。

先决条件：已完成"A8应用配置器"NC基础集成插件相关配置。

特别注意：

如果需要完成与NC的eHR组织同步，必须保证eHR模块与NC其他模块为同一数据源或同一。

②**人员同步：**初次同步只同步在职人员，同步到A8的人员在NC中离职后自动更新A8人员状态，设为离职。NC中人员的单位、部门、岗位和职务级别变更自动同步到A8。

同步信息：

+-----+--------------+------------------+------------+----------------+ | **N | | | A8名称 | 备注 | | C名 | | | | | | 称 | | | | | | ** | | | | | +=====+==============+==================+============+================+ | 部 | 客户 | 上级部门 | （无） | A8 | | 门 | 化-部门档案 | | | 中构建部门路径 | +-----+--------------+------------------+------------+----------------+ | | | 负责人 | 部门主管 | 客 | | | | | | 户化-部门档案 | +-----+--------------+------------------+------------+----------------+ | | | 部门名称 | 部门名称 | | +-----+--------------+------------------+------------+----------------+ | | | 部门编码 | 部门编码 | | +-----+--------------+------------------+------------+----------------+ | | HR-部门管理 | 是否撤销 | 是否启用 | | +-----+--------------+------------------+------------+----------------+ | | | 部门负责人 | 部门主管 | | +-----+--------------+------------------+------------+----------------+ | | | 部门负责岗位人员 | | | +-----+--------------+------------------+------------+----------------+ | 岗 | HR-岗位信息 | 岗位编码 | 岗位编码 | | | 位 | | | | | +-----+--------------+------------------+------------+----------------+ | | | 岗位名称 | 岗位名称 | | +-----+--------------+------------------+------------+----------------+ | | | 所属部门 | （无） | A8中构建部 | | | | | | 门与岗位的关联 | +-----+--------------+------------------+------------+----------------+ | | | 是否已撤消 | 是否启用 | | +-----+--------------+------------------+------------+----------------+ | 人 | HR-人员信息 | 人员编码 | 人员编码 | | | 员 | | | | | +-----+--------------+------------------+------------+----------------+ | | | 人员姓名 | 姓名 | | +-----+--------------+------------------+------------+----------------+ | | | 部门名称 | 所属部门 | | +-----+--------------+------------------+------------+----------------+ | | | 岗位 | 主岗 | 可在 | | | | (部门的岗位名称) | | seeyonConfig配 | | | | | | 置将NC岗位或岗 | | | | | | 位等级同步到A8 | +-----+--------------+------------------+------------+----------------+ | | | 职务名 | 职务级别 | 可在seey | | | | 称（或职务级别） | | onConfig配置将 | | | | | | NC职位名称或职 | | | | | | 务级别同步到A8 | +-----+--------------+------------------+------------+----------------+ | | | 兼职借用信息 | 副岗 | 将所有 | | | | | | 本单位的兼职借 | | | | | | 用同步到A8副岗 | +-----+--------------+------------------+------------+----------------+ | | | 性别 | 性别 | | +-----+--------------+------------------+------------+----------------+ | | | 出生日期 | 出生日期 | | +-----+--------------+------------------+------------+----------------+ | | | 办公电话 | 固定电话 | | +-----+--------------+------------------+------------+----------------+ | | | 手机 | 手机 | | +-----+--------------+------------------+------------+----------------+ | | | 电子邮件 | Email | | +-----+--------------+------------------+------------+----------------+ | | 客户 | 人员关 | 登录名 | 如果在NC中没有 | | | 化-用户管理 | 联用户的用户编码 | | 登录名，NC中的 | | | | （在用户管理中为 | | 人员编号自动同 | | | | 用户设置业务员） | | 步为A8的登录名 | | | | | | | | | | | | seeyonco | | | | | | nfig中的nc.use | | | | | | r.syn.switch设 | | | | | | 置为add时生效 | +-----+--------------+------------------+------------+----------------+

操作步骤：

第一步：用集团管理员登录，进入"CIP集成平台-ERP集成插件-NC插件-同步设置"。选择要同步的组织机构然后点"新建"。填写组织名称、选择对应的ERP组织、勾选需要同步的内容。

{width="6.776665573053369in" height="3.1153838582677165in"}

{width="6.768055555555556in" height="3.517361111111111in"}

协同V8.0版本：支持NC人员没有岗位、没有职务也可以同步至协同，如上图所示，对没有岗位和职务的人员同步时可设置默认岗位和默认职务；

默认岗位设置后：

人员首次同步时，NC人员对应岗位为空时，会按照设置的默认岗位同步；NC人员对应岗位不为空时，则以NC中岗位为准；

人员非首次同步时：NC人员对应岗位为空时，协同中人员已有岗位，则协同中人员对应岗位不更新，协同中人员岗位为空，则按照默认岗位更新；NC人员对应岗位不为空时，则以NC中岗位为准；

默认职务设置后：同步逻辑同默认岗位同步逻辑；

注意：如果有一些NC数据不需要同步，可按照下面"过滤设置"操作进行配置。

在"同步设置"列表过滤状态点击"未启用。
{width="6.768055555555556in" height="1.1756944444444444in"}点击"过滤设置"，在弹出页面进行配置。
"过滤设置"页面显示所有NC系统中部门名称。可针对每个部门配置过滤选项。

过滤选项共有三种：

部门。即哪些部门不同步到A8系统。f
岗位。可设置哪些岗位不同步到A8系统。
职务。即哪些职务不同步到A8系统。
人员。即哪些人员不同步到A8系统。

{width="6.0in" height="1.1993055555555556in"}

{width="4.120926290463692in" height="2.9223818897637797in"}

第二步：进入"同步操作"，选择"同步方式"以及要同步的组织名称，然后点击确定，如果是"手动同步"会立即执行同步，同步时会有提示"手动数据同步进行中，请稍等"，同步完成后右下角会有消息提醒"手工同步完成"。如果是选择自动同步要到设置的时点系统自动进行同步。

{width="6.0in" height="3.282638888888889in"}

{width="6.0in" height="3.4611111111111112in"}

点击确定后，会有'手动同步数据正在进行，请等待'，同步完成后右下角会提示'手动同步完成'如下图：

{width="6.0in" height="3.377083333333333in"}

第三步：进入"同步历史"，可查看同步的相关明细。分为三部分：部门、岗位、人员。点击"操作明细"穿透查看同步明细。点击失败数字可穿透查看同步失败明细及失败原因。

{width="6.712599518810149in" height="2.1085640857392827in"}

{width="5.025441819772529in" height="1.6988517060367454in"}

{width="5.082340332458442in" height="1.4085159667541558in"}

# 4.2 单点登录

功能说明：将A8人员和NC帐号进行绑定，实现无需输入用户名口令，直接选择NC帐号进入NC系统。

角色权限：集团管理员或个人账号。

先决条件：已完成A8应用配置、NC基础集成插件相关配置。

操作步骤：第一步：NC账号匹配。

{width="6.0in" height="3.092361111111111in"}

个人账号登录配置："个人设置-NC账号匹配"点击新建。输入NC账号和密码。

系统管理员登录配置：同样系统管理员可以在"账号匹配"进行NC账号修改。如果人员编号在A8系统和NC系统一致会自动进行账号匹配。

{width="6.7692311898512685in" height="3.7340452755905513in"}

第二步：使用个人账号登录A8系统后，即可在顶部空间处找到"ERP"，点击"ERP"空间即可单点登录至NC系统。如果想修改空间名称，可以在A8应用配置-基础配置中找到"自定义空间名称"修改。

{width="6.769233377077866in" height="3.5192311898512685in"}

# 4.3 任务集成

功能说明：将A8人员和NC帐号进行绑定，实现无需输入用户名和口令，直接选择NC帐号进入NC系统。。

角色权限：个人账号。

先决条件：已完成NC账号匹配。

操作步骤：

第一步：首页"添加栏目"，增加"扩展栏目-ERP待办事项"。

{width="4.734928915135608in" height="3.6087696850393702in"}

第二步：点击"ERP待办"列表中事项可穿透至NC系统处理。

{width="6.0in" height="3.2819444444444446in"}

弹出NC系统处理单据界面

{width="6.0in" height="2.0840277777777776in"}

# 4.4 消息集成

功能说明：将A8人员和NC帐号进行绑定，实现无需输入用户名和口令，直接选择NC帐号进入NC系统。。

角色权限：集团管理员或个人账号。

先决条件：已完成NC账号绑定。

操作步骤：

NC账号绑定成功后，即可在A8系统接收NC系统消息。

{width="6.692307524059492in" height="3.2725688976377953in"}

# 4.5 多NC集成

功能说明：多NC集成，可以实现A8与多个NC集成，包括消息、待办、空间的集成

角色权限：集团管理员、个人账号。

先决条件：已完成"A8应用配置器"NC基础集成插件相关配置。

操作步骤：

第一步：集团管理员进入到【CIP集成平台】-【NC插件】-【参数配置】，可以新建、编辑多NC环境的配置。其中编码、名称、序号可以自定义，不重复即可。URL、账套编码可参考手册"3.1.1.4说明"中获取方法找到。

{width="6.0in" height="4.426388888888889in"}

第二步：多NC账号匹配。若管理员进行了NC集成参数设置，在【NC账号匹配】界面出现ERP页签及对应NC集成参数的页签，可在不同的页签下独立进行OA账号与NC账号的匹配。人用户登录A8，选择个人设置也可以自助绑定不同NC中的帐号。

{width="6.144779090113736in" height="3.322804024496938in"}

第三步：多NC单点登录。账号匹配成功后，即可实现多个NC的单点登录。

第四步：多NC任务集成。账号匹配后，可在OA个人空间中配置多个NC待办栏目。

第五步：多NC消息集成。账号匹配成功后，可在OA中接收多NC中对应用户的消息。不同NC的消息以前缀区分。

# 五、常见问题与解决方案

# 5.1 安装配置常见问题与解决方案

问：内网正常访问ERP空间，而外网不可以访问。

答：请在"协同系统配置"把NC服务器的地址前缀改为外网IP，并且保证A8服务器上可以正常访问到此IP。

问：启动A8中间件失败，提示"无法初始化数据库连接池"。

答：第一步：检查"协同系统配置"中NC相关信息是否正确。

第二步：检查数据库驱动以及jar包

A8 为7.0版本，数据库jar包拷贝路径：

<1>如果NC是Oracle数据库，A8是MySQL或者SQLServer数据库，需要从Oracle的客服端下拷贝ojdbc14.jar文件到【A8_home】/lib下,例如：E:\Seeyon\A8\lib；

<2>如果NC是Oracle11g数据库，NC-OA协同是SQLServer数据库，需要从Oracle的客户端下【Oracle_clIEnt_home】/clIEnt_1/jdbc/lib下的ojdbc5.jar文件到【A8_home】/lib下（如果【A8_home】/lib存在classes12.jar和ojdbc14.jar，则必须删除这两个文件，否则将不能正常运行）。

A8 为6.1版本，数据库jar包拷贝路径：

<1>如果NC是Oracle数据库，A8是MySQL或者SQLServer数据库，需要从Oracle的客服端下拷贝ojdbc14.jar文件到【A8_home】/ApacheJetspeed /lib下,例如：D:\Seeyon\6.1SP1\ApacheJetspeed\lib；

<2>如果NC是Oracle11g数据库，NC-OA协同是SQLServer数据库，需要从Oracle的客户端下【Oracle_clIEnt_home】/clIEnt_1/jdbc/lib下的ojdbc5.jar文件到【A8_home】/ ApacheJetspeed/lib下（如果【A8_home】/ApacheJetspeed /lib存在classes12.jar和ojdbc14.jar，则必须删除这两个文件，否则将不能正常运行）。

问：配置的NC数据库库连不上。

答： oracle驱动过多或版本不对，只使用ojdbc5.jar一个驱动。

问：启动报错，出现webservice token error错误，

答：在NC安装目录下找到E:\nc65home\modules\trans 下的 system.properties文件

查看OA的地址是否配置正确，以及webservice密码是否配置正确。

问：启动时数据库提示锁住（oracel）。

答：核实，数据库信息是否正确，核实后，依次执行以下命令

sqlplus /log

conn /as sysdba

alter user 用户名称 account unlock

# 使用中常见问题与解决方案

1、问：NC账号配置，人员不存在或绑定时报错，提示没有服务或接口。

答：①没有部署ncdeploy；

②NC没有部署EJB。

2、问：NC中下级部门同步到OA后，变为一级部门。

答：因为其上级部门没有同步成功导致。

①修改上级部门编码OA与NC保持一致；

②如果修改编码后还不行，可执行下面脚本：delete from ctp_guidmapper where type='com.seeyon.v3x.organization.domain.V3xOrgDepartment' ;然后重启OA环境再同步

3、问：消息待办、单点登录NC63/65时，提示信任地址IP问题。

答：在NChome下nc65nchome\ierp\sf\ssoConfig.xml中添加OA地址。

4、问：点击ERP待办事项，提示：NC加载失败，请检查是否安装JAVA虚拟机，如果不能解决请及时联系管理员。

答：①IE浏览器为例：工具-兼容性视图设置：添加NC网址为信任地址。

{width="1.4889402887139107in" height="2.796570428696413in"}{width="1.9628313648293962in" height="2.820803805774278in"}

②IETERNER选项：添加NC网址为受信任的站点；并且在自定义级别启用："对标记为可安全执行脚本ActiveX控件执行脚本"、"对未标记为可安全执行脚本的ActiveX控件初始化并执行脚本"、"二进制文件和脚本行为"这三项。

{width="1.588234908136483in" height="2.427303149606299in"}{width="1.4288156167979003in" height="2.423751093613298in"}{width="2.8970188101487313in" height="2.4639621609798774in"}

用浏览器访问NC，安装弹出的jdk。
在控制台中选择JAVA,并设置JAVA高级，更新设置为不更新

{width="3.538478783902012in" height="2.0698458005249343in"}

5、问：组织同步，重新绑定NC部门后无法同步，部门结构树混乱。

答：清除映射关系表中的垃圾数据。

6、问：NC审核异常。

答：OA配置中相关NC或OA的url配置，没有加http。

**7、问：组织同步问题，**NC中人员刘家成，之前部门为运营部，现在调整该人员部门为综合部，进行组织同步操作，OA查看该人员信息，部门未更新，

思路：

一、清楚近期有没有对问题数据对应的部门或者人员作出操作，以及作出什么操作；

**二、**出现问题的数据是批量出现还是个别数据问题；

三、使用集团管理员看同步历史，查看问题部门是否同步成功，如果失败，查看问题描述，同时也可以在OA的安装目录下D:\a8\103958apps\logs_sy 目录下查看ctp.log日志文件，在该文件中查看同步日志；

{width="5.768055555555556in" height="2.2444444444444445in"}

四、通过查看问题部门同步失败，查询相关数据库（明确数据字典表版本）：

注意如果数据库为oracle，查询id是需要 to_char(id) 转换否则查不出来，具体

根据刘家成从OA人员表中org_member 查询该人员对应的部门id;
根据部门id 到OA部门表org_unit

表中查询该部门的id，并查看数据状态，是否禁用、编码、名称
根据查询到部门id到oa**映射表

ctp_guidmapper**中查询,localid就是OA系统的部门id ，guid 就是nc系统中的部门id,具体sql如下

{width="6.0in" height="2.11875in"}

SELECT * FROM ctp_guidmapper WHERE localid =' -6638516745549429464'

注意此处查询出来的正常情况下数据仅为一条，组织同步时根据该映射进行一对一匹配映射

如果出现多条，就是问题所在，应该是之前错误操作产生的；

第一步：备份ctp_guidmapper表

第二步：根据localid删除多余的数据

DELETE FROM ctp_guidmapper WHERE localid =-6638516745549429464'

第三步：重启OA服务，系统会重新创建映射数据，重新组织同步，查看问题是否解决

如果只有一条，根据guid
到nc数据库部门表中查看是否存在该部门的数据，以及编码、名称等信息是否正确，如果不存在，或者信息不匹配，执行上一步操作，删除映射表数据

8、问：组织同步后，在部门管理中查看，上级部门显示为空。

答：查看上级部门是否同步成功，查看是组织同步问题，同步历史中数据信息是否与NC中设置的一致，如果一致，但数据显示不正确，申请报bug单处理，会提供补丁包处理；

# 支持服务

致远NC+OA集成交流QQ群：543810393。
项目咨询、开发等请在公司协同发起"研发支持申请单"。

{width="6.0in" height="3.7472222222222222in"}

创建人：suyj

快速跳转

NC基础集成插件手册
目录 {#目录 .TOC-Heading}
总体概述
- 核心价值
- 功能清单
集成环境配置要求
- 硬件配置
- 软件环境
安装配置
四、使用指南
五、常见问题与解决方案
- 5.1 安装配置常见问题与解决方案
- 使用中常见问题与解决方案
支持服务

← NC业务集成 SAP凭证集成插件手册 →

# NC基础集成插件手册

# 目录 {#目录 .TOC-Heading}

# 总体概述

# 核心价值

# 功能清单

# 集成环境配置要求

# 硬件配置

# 软件环境

# 安装配置

# 操作前提（重要）

# A8应用配置（组织数据同步先决条件，此处配置完成，可直接进行组织数据同步）

# NC插件启动参数设置

# 3.1.1.1基础配置

# 3.1.1.2单点登录/消息待办/NC门户参数设置

# 3.1.1.3组织同步信息设置

# 3.1.1.4参数获取说明

# 3.1.2 说明

# NC相关配置

# 3.2.1 NC插件配置

# 3.2.2 NC应用配置

# NC5.7

# NC6.5

# NC集成A8（只针对NC 5.5，NC 5.6，NC5.7）

# NC配置

# NC-Portal与A8-Portal账户绑定

# 配置A8单点登录信息

# 解决NC-Portal中A8被迫下线

# 3.4 nccheck

# 四、使用指南

# 4.1 组织数据同步

# 4.2 单点登录

# 4.3 任务集成

# 4.4 消息集成

# 4.5 多NC集成

# 五、常见问题与解决方案

# 5.1 安装配置常见问题与解决方案

# 使用中常见问题与解决方案

# 支持服务

快速跳转