|
|
地点属性应和动作一起定义，格式如下述：
|
注意
|
1. 通过API可对地点进行添加、更新和删除操作。 2. 地点的操作只有具有管理员权限的技术员才能操作，SiteAdmin的技术员也无法进行添加/删除的操作。 3. 属性区分大小写，必须按照定义的方式使用。 4. 如果对示例表单中的按钮重命名，请指定 'operation' 为隐藏参数。 |
添加地点需要在HttpRequest 请求参数中设置如下属性，并且应确保'operation'动作为'AddSite'。
|
属性 |
备注 |
|
targetURL= "/servlets/SiteServlet" |
target url for adding site |
|
operation='AddSite' |
operation command for Adding site. |
|
siteName |
Organization Name |
|
description |
Description for the site |
|
region |
The Region to which the site belongs |
|
timeZone |
Time Zone of the site |
|
doorNo |
Address of the organization. |
|
street |
Address where the company is located in the specified site. |
|
landmark |
Provide a landmark if required. |
|
city |
City where the company is located. |
|
postalCode |
Address where the company is located in the specified site. |
|
state |
Address where the company is located in the specified site. |
|
country |
Address where the company is located in the specified site. |
|
|
Email address of the organization. |
|
phone |
contact information of the organization. |
|
fax |
Fax number of the organization. |
|
webUrl |
website of the organization. |
|
OperationalHoursSettings |
Related Settings for Operational hours of the site. Allowed values: copy (Copy Default Settings), refer (Refer Default Settings), custom (Custom Settings) |
|
HolidaysSettings |
Related Settings for Holidays setting of the site. Allowed values: copy (Copy Default Settings), refer (Refer Default Settings), custom (Custom Settings) |
|
DepartmentsSettings |
Related Settings for Departments setting of the site. Allowed values: copy (Copy Default Settings), custom (Custom Settings) |
|
TechSiteAssociationSettings |
Related Settings for Technicians/Site Association setting of the site. Allowed values: copy (Copy Default Settings), refer (Refer Default Settings), custom (Custom Settings) |
|
GroupsSettings |
Related Settings for Groups setting of the site. Allowed values: refer (Refer Default Settings), custom (Custom Settings) |
|
BusinessRulesSettings |
Related Settings for Business Rules setting of the site. Allowed values: refer (Refer Default Settings), custom (Custom Settings) |
|
SLASettings |
Related Settings for Service Level Agreements setting of the site. Allowed values: copy (Copy Default Settings), refer (Refer Default Settings), custom (Custom Settings) |
|
username |
Login Name for SDP Authentication |
|
password |
Password for SDP Authentication |
|
DOMAIN_NAME |
Domain Name to which the user belongs. Domain Name should be specified on enabling AD authentication. |
|
logonDomainName |
Authentication Mode [AD or Local Authentication]. "AD_AUTH" refers to Active Directory Authentication. 'Local Authentication" or empty value refers to Local Authentication. |
注意:
如果在ServiceDesk Plus没有配置区域，则不会自动添加区域的信息。, then the region field does not get populated in the application.
如果DepartmentSettings 以外的其它相关设置没有选择，则默认将使用'Refer Default Settings' 选项，而 DepartmentSettings则默认为Custom Default Settings
如果下述参数（即：TechSiteAssociationSettings, GroupsSettings, BusinessRulesSettings or SLASettings ）有一个选择为“Refer Default Settings”，则其它的三个参数也被设置为“Refer”
具有 SDSiteAdmin 权限的技术员，只能编辑地点的信息，但是，不能编辑 'Related Settings.'
点击这里可查看创建地点的示例表单。.
HTML表单被提交到 http://machinename:Portnumber/servlets/SiteServlet ，并返回XML格式的应答消息，其中包括成功信息 及地点ID。
如果有下述情况，则返回失败消息：
在HTTP请求参数栏中必须输入参数‘oldSiteName ’[该参数为必填项]，同时要将请求参数中的‘operation’设定为‘UpdateSite’。
|
属性 |
说明 |
|
targetURL= "/servlets/SiteServlet" |
target url for adding site |
|
operation='UpdateSite' |
operation command for Adding site. |
|
oldSiteName |
Site Name for update |
|
siteName |
New Organization Name |
|
description |
Description for the site |
|
region |
The Region to which the site belongs |
|
timeZone |
Time Zone of the site |
|
doorNo |
Address of the organization. |
|
street |
Address where the company is located in the specified site. |
|
landmark |
Provide a landmark if required. |
|
city |
City where the company is located. |
|
postalCode |
Address where the company is located in the specified site. |
|
state |
Address where the company is located in the specified site. |
|
country |
Address where the company is located in the specified site. |
|
|
Email address of the organization. |
|
phone |
contact information of the organization. |
|
fax |
Fax number of the organization. |
|
webUrl |
website of the organization. |
|
OperationalHoursSettings |
Related Settings for Operational hours of the site. Allowed values: copy (Copy Default Settings), refer (Refer Default Settings), custom (Custom Settings) |
|
HolidaysSettings |
Related Settings for Holidays setting of the site. Allowed values: copy (Copy Default Settings), refer (Refer Default Settings), custom (Custom Settings) |
|
DepartmentsSettings |
Related Settings for Departments setting of the site. Allowed values: copy (Copy Default Settings), custom (Custom Settings) |
|
TechSiteAssociationSettings |
Related Settings for Technicians/Site Association setting of the site. Allowed values: copy (Copy Default Settings), refer (Refer Default Settings), custom (Custom Settings) |
|
GroupsSettings |
Related Settings for Groups setting of the site. Allowed values: refer (Refer Default Settings), custom (Custom Settings) |
|
BusinessRulesSettings |
Related Settings for Business Rules setting of the site. Allowed values: refer (Refer Default Settings), custom (Custom Settings) |
|
SLASettings |
Related Settings for Service Level Agreements setting of the site. Allowed values: copy (Copy Default Settings), refer (Refer Default Settings), custom (Custom Settings) |
|
username |
Login Name for SDP Authentication |
|
password |
Password for SDP Authentication |
|
DOMAIN_NAME |
Domain Name to which the user belongs. The Domain Name should be specified on enabling AD authentication. |
|
logonDomainName |
Authentication Mode [AD or Local Authentication]. "AD_AUTH" refers to Active Directory Authentication. "Local Authentication" or empty value refers to Local Authentication. |
点击这里查看示例表单。
正常的更新之后的应答消息为成功消息。
在HTTP请求参数栏中必须输入参数‘siteName’[该参数为必填项]，同时要将请求参数中的‘operation’设定为'DeleteSite'。
|
属性 |
说明 |
|
targetURL="/servlets/SiteServlet" |
target url for Adding site |
|
operation='DeleteSite' |
operation command for deleting site |
|
siteName |
Organization Name |
|
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. |
点击这里查看示例表单。
删除成功后，返回 成功消息。
以下情况，将删除失败：
|
|
