Concur公司的参会者。此资源可用于检索Concur公司中的任何参与者的信息,无论他们是私有还是共享的。在未来的版本中,该资源将得到增强,以提供完整的与会者管理功能。
这个API允许开发人员在Concur中管理与会者。与会者资源可用于检索私有与会者或共享与会者的与会者信息。在未来的版本中,Attendee资源将被更新为管理Concur中的所有参与者的附加功能。
Attendee资源用于批量管理与会者,可用于添加、更新或去激活与会者。此资源提供的功能类似于在Concur中导入与会者列表。使用该资源添加的与会者将被添加到“共享与会者列表”中(系统所有,所有用户均可使用)。
Concur产品是高度可配置的,并不是所有客户都可以访问所有特性。
在评审过程之前,合作开发人员必须确定他们的解决方案需要哪些配置。
现有客户端可以使用Concur Advantage Technical Services创建使用其配置的自定义应用程序。
https://www.concursolutions.com/api/expense/v2.0/attendees
检索与指定搜索条件匹配的参与者。开发人员可以指定一个或多个外部ID或参与者ID来搜索Expense数据库。
参数 | 必需的/可选 | 描述 |
---|---|---|
attendeeID | 可选 | 路径:在Concur中参与者的唯一标识符。该信息在AttendeeID元素的响应得到报告细节函数。 |
externalid | 可选 | 查询:与会者在Concur之外的唯一标识符。该信息在ExternalID元素的响应得到报告细节函数。最多可以以逗号分隔的列表提供10个外部id。 |
例子:
https://www.concursolutions.com/apiexpense/v2.0/attendees?externalid= https://www.concursolutions.com/api/expense/v2.0/attendees/ https://www.concursolutions.com/apiexpense/v2.0/attendees?externalid= {attendeeID} {externalID} {externalID1}, {externalID2}, {externalID3}
应用程序/ xml
或application / json
这个请求将返回一个与会者父元素包含出席者子元素。
元素 | 描述 |
---|---|
AttendeeType | 与会者的类型。最大40个字符。 |
FirstName | 与会者的名字。最大的50个字符。 |
姓 | 与会者的姓。最多132个字符。 |
公司 | 与会者的公司名称。最多150个字符。 |
标题 | 出席者的头衔。最多32个字符。 |
ExternalID | 与会者的唯一标识符,在Concur之外管理。最大48个字符。 |
通过Custom20 Custom1 | 来自自定义字段的详细信息。它们可能没有数据,这取决于配置。有关此父元素的子元素的信息,请参见自定义子元素下面的表。 |
HasExceptionsPrevYear | 参加者在前一年是否有例外,根据每年参加者的总限额。最大1字符。格式:Y / N |
HasExceptionsYTD | 参加者在本年度是否有例外,根据每年参加者的总限额。最大1字符。格式:Y / N |
IsDeleted | 与会者是否被删除。最大1字符。格式:Y / N |
OwnerEmpName | 拥有与会者记录的员工的姓名。 |
TotalAmountPrevYear | 上一历年用于出席者的总金额。 |
TotalAmountYTD | 在本日历年度用于出席者的总金额。 |
VersionNumber | 与会者的版本号。 |
AttendeeID | 与会者在Concur中的唯一标识符。 |
AttendeeTypeCode | 参与者类型的唯一标识符。 |
AttendeeOwnerID | 与会者所属的个人或系统的唯一标识符。 |
CurrencyCode | 的3个字母的ISO 4217货币代码与参加者有关的金额。 |
元素 | 描述 |
---|---|
类型 | 自定义字段类型。将是下列之一:数量,布尔值,ConnectedList,日期,整数,列表,数字,文本。 |
价值 | 自定义字段中的值。最多100个字符。 |
代码 | 自定义列表字段将在此元素中包含列表项代码。 |
得到https://www.concursolutions.com/api/expense/v2.0/attendees/nFaAj0ncBsvkgnPMY5QWfBbbWyvsQh2oW美元授权:OAuth{令牌}
得到https://www.concursolutions.com/api/expense/v2.0/attendees?externalid=234567年授权:OAuth{令牌}
HTTP/1.1 200 OK内容类型:application/xml
<与会者xmlns =“http://www.concursolutions.com/api/expense/expensereport/2012/07”xmlns:我=“http://www.w3.org/2001/XMLSchema-instance”><出席者>< AttendeeType >BUSGUEST< / AttendeeType ><名>克里斯< / FirstName >< LastName >米勒< / LastName ><公司/><标题/>< ExternalID >234567< / ExternalID >< Custom1/>< Custom2/>< Custom3/>< Custom4/>< Custom5/>< Custom6/>< Custom7/>< Custom8/>< Custom9/>< Custom10/>< Custom11/>< Custom12/>< Custom13/>< Custom14/>< Custom15/>< Custom16/>< Custom17/>< Custom18/>< Custom19/>< Custom20/>< HasExceptionsPrevYear >N< / HasExceptionsPrevYear >< HasExceptionsYTD >N< / HasExceptionsYTD >< IsDeleted >N< / IsDeleted >< OwnerEmpName >戴维斯,帕特< / OwnerEmpName >< TotalAmountPrevYear >0.00000000< / TotalAmountPrevYear >< TotalAmountYTD >0.00000000< / TotalAmountYTD >< VersionNumber >1< / VersionNumber >< AttendeeID >nFaAj0ncBsvkgnPMY5QWfBbbWyv sQh2oW美元< / AttendeeID >< AttendeeTypeCode >BUSGUEST< / AttendeeTypeCode >< AttendeeOwnerID >pd123456< / AttendeeOwnerID >< CurrencyCode >美元< / CurrencyCode >< /与会者>< /与会者>
指的是HTTP规范页以了解常见响应和错误的详细信息。
web服务不会为批处理操作返回4xx HTTP响应代码,即使批处理中的每个项目都未能创建或更新。客户必须检查响应,以查找单个批处理项目的警告或错误。
当批处理项出现错误时,前十个错误将在< >错误
元素,其中包括错误代码、导致错误的项和错误消息。任何附加的错误消息都会被截断。这可以防止在出现格式化错误时产生大量错误数据。
XML响应错误码
错误代码 | 消息 |
---|---|
1101 | 找不到参与者批处理元素。 |
1102 | 解析与会者记录X时出错 |
1201 | 与会者记录缺少外部id |
1202 | 失踪的出席者类型 |
1203 | 失踪的货币代码 |
1204 | 外部id太长 |
1205 | 与会者类型太长 |
1206 | 无效活动的价值。 |
1207 | NOSHOWS类型的参与者被忽略。 |
1208 | 无效的货币代码 |
1209 | 缺少必需字段X |
1210 | 字段X的时间戳无效 |
1211 | X字段的货币或货币价值无效 |
1212 | X字段的金钱或数值无效 |
1213 | 字段X的无效整数 |
1214 | 字段X的布尔值无效 |
1215 | 字段X的字符值无效 |
1216 | 字段X的varchar值无效 |
1217 | 值对字段X太长 |
1218 | 无效的出席者类型 |
1219 | 在记录X中为X字段指定了多个值 |
1221 | 字段X的代码无效 |
1222 | 字段X缺少代码 |
1301 | 创建与会者时出现意外错误 |
1302 | 更新与会者时出现意外错误 |
1303 | 获取与会者类型列表时出现意外错误 |
1304 | 处理批处理请求时出现意外错误。 |
1305 | 无法为不存在的与会者更新与会者数据。 |