# 调查模块接口

# 接口调用方式

本接口为主OA Http Rest，允许被异构系统远程调用，调用前需要调用Rest接口文档 (opens new window)获取Restful token身份凭证。

# 调查相关结构说明

调查由多个版块组成，版块下有若干调查，故需要知道“调查版块”和“调查”的数据对象结构。

# 调查版块对象示例

{
  "id" : -7049823740074835176,
  "typeName" : " 测试调查",
  "surveyDesc" : "",
  "censorDesc" : 1,
  "flag" : 0,
  "spaceType" : 2,
  "accountId" : 5269865115340261356,
  "sort" : 999,
  "createDate" : 1491532288000,
  "authType" : 0,
  "inquirySurveytypeextends" : [ {
    "id" : -3301430647411948050,
    "managerDesc" : 0,
    "managerId" : -3941577936688034522,
    "surveytypeId" : -7049823740074835176,
    "sort" : 0,
    "new" : false,
    "extraMap" : { }
  } ],
  "inquiryAuthorities" : null,
  "new" : false,
  "extraMap" : { }
}

# 调查版块属性说明

参数	说明
id	调查版块主键
typeName	板块名称
surveyDesc	调查描述
censorDesc	审核标识，0-需要审核，1-不需要审核
flag	删除标记，0-正常，1-删除，2-模板
spaceType	调查所属空间类型(1，部门；2，单位；3，集团；4，自定义团队；17，自定义单位；18，自定义集团)
accountId	单位ID
sort	排序
createDate	创建时间
authType	发起授权类型，0：全部；1：指定范围
inquirySurveytypeextends
inquiryAuthorities
new
extraMap	-

# 调查对象示例

{
  "inquirySurveybasic" : {
    "id" : 3120564525559072332,
    "totals" : 5,
    "censor" : 8,
    "censorId" : 0,
    "clickCount" : 0,
    "closeDate" : null,
    "createrId" : -3941577936688034522,
    "issuerId" : -3941577936688034522,
    "issueDate" : 1491552325000,
    "cryptonym" : 1,
    "departmentId" : 5485888616457063756,
    "flag" : 0,
    "sendDate" : 1491552325000,
    "surveyName" : "接口发起调查",
    "surveydesc" : "调查描述",
    "surveyDescAfter" : "",
    "voteCount" : 0,
    "checkMind" : null,
    "surveyTypeId" : -7049823740074835176,
    "attachmentsFlag" : false,
    "allowViewResult" : true,
    "allowViewResultAhead" : false,
    "showVoters" : true,
    "surveyDescImg" : null,
    "spaceType" : 2,
    "accountId" : 5269865115340261356,
    "inquiryScopes" : null,
    "inquirySubsurveys" : null,
    "inquirySubsurveyitems" : null,
    "inquirySurveytype" : null,
    "inquirySurveydiscusses" : null,
    "inquiryVotedefinites" : null,
    "new" : false,
    "extraMap" : { }
  },
  "id" : 3120564525559072332,
  "createUserImgUrl" : "/seeyon/apps_res/v3xmain/images/personal/pic.gif",
  "createUserName" : "李世民",
  "createUserId" : -3941577936688034522,
  "issueUserImgUrl" : "/seeyon/apps_res/v3xmain/images/personal/pic.gif",
  "issueUserName" : "李世民",
  "issueUserId" : -3941577936688034522,
  "departmentName" : "开发部",
  "departmentId" : 5485888616457063756,
  "myState" : true,
  "myRead" : false,
  "per" : "0%",
  "surveyName" : "RES接口发起调查",
  "surveyTypeId" : -7049823740074835176,
  "surveyTypeName" : "NET 测试 讨论",
  "surveyState" : "8",
  "sendDate" : 1491552325000,
  "issueDate" : 1491552325000,
  "closeDate" : null,
  "dateFormat" : null
}

# 调查对象属性说明

参数	说明
id	调查主键ID
createUserName	创建人
createUserId	创建人ID
issueUserName	发布人名称
issueUserId	发布者
departmentName	部门名称
departmentId	发布部门ID
myState	状态
myRead
per	进度
surveyName	调查名称
surveyTypeId	板块ID
surveyTypeName	板块名称
surveyState	状态
sendDate	发起时间
issueDate	发布时间
closeDate	关闭时间
dateFormat
totals	发布范围总人数
censor	调查状态1-审核未通过，2-审核通过未发布,3-保存待发，4-未审核，5-终止,8-发布，10-归档，-1-发布未开始
censorId	审核员ID
clickCount	点击次数
cryptonym	是否匿名，0-实名，1-匿名
surveyDescAfter	后言
voteCount	投票次数
attachmentsFlag	调查附件，0-无附件，1-有附件
allowViewResult	默认为1，0-不允许查看调查结果，1-允许
allowViewResultAhead	默认为1，0-不允许提交前查看调查结果，1-允许
showVoters	管理员是否可查看投票人，0-不可查看，1-可查看

# 单位调查板块列表(Since:V61)

获取单位下的调查版块列表。

接口请求说明

http请求方式：GET
http://ip:port/seeyon/rest/inquiry/inquiriesType/unit/{unitId}?pageSize=20&pageNo=1

注：请求需要携带token，否则无法使用，获取并传递token方法参考：https://open.seeyoncloud.com/seeyonapi/781/

参数说明：

参数	是否必须	说明
unitId	是	单位ID

返回说明

正常情况下，会返回的是JSON格式调查板块信息，JSON数据包参考：调查版块对象示例

参数说明请参考：调查版块参数说明

# 集团调查板块列表(Since:V61)

获取集团下的调查版块列表。

接口请求说明

http请求方式：GET
http://ip:port/seeyon/rest/inquiry/inquiriesType/group?pageSize=20&pageNo=1

注：请求需要携带token，否则无法使用，获取并传递token方法参考：https://open.seeyoncloud.com/seeyonapi/781/

返回说明

正常情况下，会返回的是JSON格式调查板块信息，JSON数据包参考：调查版块对象示例

参数说明请参考：调查版块参数说明

# 调查列表(指定板块)(Since:V61)

获取指定调查板块下指定人员有权限的调查列表。

接口请求说明

http请求方式：GET
http://ip:port/seeyon/rest/inquiry/inquiriesType/{boardId}/{loginName}?pageSize=20&pageNo=1

注：请求需要携带token，否则无法使用，获取并传递token方法参考：https://open.seeyoncloud.com/seeyonapi/781/

参数说明：

参数	是否必须	说明
boardId	是	板块ID
loginName	是	用户的OA登录名，或使用SSO单点登录认证提取的ticket，可以尝试用调查管理员帐号获取最大权限

返回说明

正常情况下，会返回的是JSON格式调查信息，JSON数据包参考：调查对象示例

参数说明请参考：调查对象属性说明

# 调查列表(指定单位)(Since:V61)

获取指定单位下指定人员有权限的调查列表。

接口请求说明

http请求方式：GET
http://ip:port/seeyon/rest/inquiry/unit/{unitId}/{loginName}?pageSize=20&pageNo=1

注：请求需要携带token，否则无法使用，获取并传递token方法参考：https://open.seeyoncloud.com/seeyonapi/781/

参数说明：

参数	是否必须	说明
unitId	是	单位ID
loginName	是	用户的OA登录名，或使用SSO单点登录认证提取的ticket，可以尝试用调查管理员帐号获取最大权限

返回说明

正常情况下，会返回的是JSON格式调查信息，JSON数据包参考：调查对象示例

参数说明请参考：调查对象属性说明

# 创建调查(Since:V61)

创建调查接口。

接口请求说明

http请求方式：POST
http://ip:port/seeyon/rest/inquiry

注：请求需要携带token，否则无法使用，获取并传递token方法参考：https://open.seeyoncloud.com/seeyonapi/781/

DEMO：

       Map res = new HashMap();
       res.put("createUserId", "-3941577936688034522");//调查发起人
       res.put("surveytypeId", "-7049823740074835176");//调查类型 inquiry_surveytype表
       res.put("surveyname", "RES接口发起调查");//调查标题
       res.put("surveydesc", "调查描述");//调查描述
       res.put("cryptonym", "1");//调查是否实名
       res.put("allowViewResult", "true");//调查是否允许查看调查结果
       res.put("allowViewResultAhead", "false");//调查是否允许提交前看调查结果
       res.put("allowAdminViewResult", "true");//调查发起人/版块管理员查看已投票和未投票人
       res.put("questionSort", "0,1");//调查问题的个数
       res.put("question0Title", "调查题目1");//调查问题0题目
       res.put("question0Desc", "单选题目描述");//调查问题0描述
       res.put("question0SingleOrMany", "0");//调普问题0的形式
       res.put("question0Discuss", "1");//调查问题0讨论
       res.put("question0OtherItem", "1");//调查问题0题目列表
       res.put("question0Item", "不是,肯定不是");//讨论题目
       res.put("question1Title", "调查题目2");//调查问题1题目
       res.put("question1Desc", "单选题目2");//调查问题1描述
       res.put("question1SingleOrMany", "0");//调普问题1的形式
       res.put("question1Discuss", "1");//调查问题1讨论
       res.put("question1OtherItem", "1");//调查问题1题目列表
       res.put("question1Item", "对,太对了");
       res.put("scopeId", "Account|5269865115340261356");//发布范围
       String result = client.post("inquiry" ,res, String.class);

返回说明

发布成功，会返回{"state":"0","msg":"新建调查《接口发起调查》成功！"}

创建人：het

修改人：het

快速跳转

调查模块接口

← 讨论模块 Event事件使用说明 →