请求人的属性及XML应答

以下将介绍怎样定义请求人的属性及动作：

Note	1. 通过API可对请求人进行添加、更新和删除操作。 2. 访问权限受限制的技术员，可以执行添加、编辑、和删除请求人的操作，但其操作的请求人只能是与该技术员的地点相关联的请求人。 3. 属性区分大小写，必须按照定义的方式使用。 4. 如果对示例表单中的按钮重命名，请指定 'operation' 为隐藏参数。

添加请求人
更新请求人
删除请求人

添加请求人

添加技术员需要在HttpRequest 请求参数中设置如下属性，并且应确保'operation'动作为'AddRequester'。

属性	说明
targetURL= "/servlets/RequesterServlet"	target URL for Adding requester
operation='Addrequester'	operation command for Adding requester
name	Requester name
employeeId	Employee ID of the requester
description	Description about employee
email	Email Address of the requester
phone	Phone Number of the requester
mobile	Mobile number of requester
site	site to which requester is associated to
departmentName	department name to which the requester is associated to
jobTitle	Job title of the requester.
requestViewPermission	permission for 'Requester allowed to view'. Allowed Values: OWN REQUEST:for Requester allowed to view- Show only their own requests, DEPARTMENT REQUEST:for Requester allowed to view-Show all their Department requests, SITE REQUEST:for Requester allowed to view-Show all their Site requests
approvePurchaseOrder	Purchase Order Approver Allowed Values:true,false.
UDF aliases name	additional fields should be specified based on their column names
loginName	login name
pwd	password
userDomainName	Domain with which the requester is associated to
username	Login Name for SDP Authentication
password	Password for SDP Authentication
DOMAIN_NAME	Domain Name to which the user belongs
logonDomainName	Authentication Mode [AD or Local Authentication]. “AD_AUTH” refers to Active Directory Authentication. “Local Authentication” or empty value refers to Local Authentication.

注意:

如果请求人没有关联到某个地点的任何部门，则该请求人的地点值将被自动置为'not associated to any site'。
approvePurchaseOrder的缺省值为false.
'approvePurchaseOrder' 只有在该请求人的电子邮件地址被指定时，才能启用。
如果 'requestViewPermission' 的值为空，则它的值被设置为：'Show only their request'.
如果创建请求人的技术员为'SDAdmin'角色，当表单中提供的 'SiteName' 和 'departmentName' 在系统中不存在时，会将所指定的“SiteName”和“departmentName”添加到系统中，并将该请求人关联到所指定的地点和部门。
如果创建请求人的技术员具有访问限制，当表单中提供的 'SiteName' 和 'departmentName' 在系统中不存在时，该请求人将不被关联到 'Not associated to any site'（不添加新的地点和部门）。

点击这里要查看添加请求人的示例表单，

HTML表单被提交到 http://machinename:Portnumber/servlets/RequesterServlet ,并返回XML格式的应答消息，其中包括成功消息及被创建的用户ID或请求人ID。

有以下情况时，返回失败信息：

创建请求人的技术员有访问限制，并且没有关联到所指定的地点。
没有管理员权限的技术员尝试创建请求人。[ 点击这里查看失败的消息]

更新请求人

在HTTP请求参数栏中要将请求参数中的‘operation’设定为‘Updaterequester’，并指定以下参数：

属性	说明
targetURL= "/servlets/requesterServlet"	target URL for Updating requester.
operation='Updaterequester'	operation command for Updating requester.
reqUserName	Requester Name to update
reqLoginName	Requester Login Name to update
reqdomainName	Domain Name to which the requester belongs to
reqEmailId	Requester Email ID to update
userid	Requester ID
name	Requester name
employeeId	Employee ID of the requester
description	Description about employee
email	Email Address of the requester
phone	Phone Number of the requester
mobile	Mobile number of requester
site	site to which requester is associated to
departmentName	department name to which the requester is associated to
jobTitle	Job title of the requester
requestViewPermission	permission for 'Requester allowed to view'. Allowed Values: OWN REQUEST:for Requester allowed to view- Show only their own requests, DEPARTMENT REQUEST:for Requester allowed to view-Show all their Department requests, SITE REQUEST:for Requester allowed to view-Show all their Site requests
approvePurchaseOrder	Purchase Order Approver Allowed Values:true,false.
UDF aliases name	additional fields should be specified based on their column names
loginName	login name
pwd	password
userDomainName	Domain with which the requester is associated to
username	Login Name for SDP Authentication
password	Password for SDP Authentication
DOMAIN_NAME	Domain Name to which the user belongs
logonDomainName	Authentication Mode [AD or Local Authentication]. “AD_AUTH” refers to Active Directory Authentication. “Local Authentication” or empty value refers to Local Authentication.

注意:

执行编辑操作时，将按照以下顺序鉴别请求人：

首先根据所指定的'reqLoginName' 和 'reqDomainName'来鉴别用户。
如果 'reqDomainName' 为空，则根据 'reqLoginName' 及空值的 'reqDomainName' 来鉴别用户。
如果无法通过上述标准，找到对应的请求人，则根据 'reqEmailid'来鉴别用户。
如果仍然不能确定请求人，则使用'reqUserName'来鉴别用户。
如果上述标准仍无法确定用户，则使用 'userid'来鉴别用户。
根据 reqUserName 或 reqEmailId来鉴别用户时，如果有一个以上的用户满足条件，则所有用户都不作任何更新或删除。

不能通过API来编辑请求人的登录信息。
如果在编辑请求人时，启用 '定购单审批人'的角色选项，则必须同时提供'email'和 'approvePurchaseOrder' 的值（即使 'email' 在配置请求人时已经指定）
只是关联到 'Not associated to any site' 的技术员，不允许创建/编辑请求人、
如果编辑请求人的技术员为'SDAdmin'角色，且当表单中提供的 'SiteName' 和 'departmentName' 在系统中不存在时，会将所指定的“SiteName”和“departmentName”添加到系统中，并将该请求人关联到所指定的地点和部门。
如果创建请求人的技术员具有访问限制，且当表单中提供的 'SiteName' 和 'departmentName' 在系统中不存在时，该请求人将不被关联到 'Not associated to any site'（不添加新的地点和部门）。

点击这里要查看编辑请求人的示例表单。

如果更新成功，显示成功消息。

删除请求人

在HTTP请求参数栏中要将请求参数中的‘operation’设定为‘Deleterequester’，并指定以下参数：

属性	说明
targetURL= "/servlets/requesterOperationServlet"	target URL for deleting requester
operation='Deleterequester'	operation command for deleting requester
name	requester Name
loginName	Requester's Login Name
domainName	Requester's login domain name
emailId	Requester's email ID
userid	Requester id
username	Login Name for SDP Authentication
password	Password for SDP Authentication
DOMAIN_NAME	Domain Name to which the user belongs.
logonDomainName	Authentication Mode [AD or Local Authentication]. “AD_AUTH” refers to Active Directory Authentication. “Local Authentication” or empty value refers to Local Authentication.

点击这里查看删除请求人的表单示例。

如果删除成功，则返回成功消息。