请求人的属性及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 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'. |
approvePurchaseOrder | Purchase Order Approver |
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 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'. |
approvePurchaseOrder | Purchase Order Approver |
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. |
点击这里查看删除请求人的表单示例。
如果删除成功，则返回 成功消息。
