Aranda Service Management （预览版）

提高公司的工作效率，并通过 Aranda Service Management Suite（多租户解决方案）实现用户体验的转换，该解决方案允许你管理、集成和自动化业务流程和服务。

此连接器在以下产品和区域中可用：

服务	Class	区域
Copilot Studio	高级	除以下各项外的所有 Power Automate 区域： - 美国政府（GCC） - 美国政府（GCC High） - 由世纪互联运营的中国云 - 美国国防部（DoD）
逻辑应用程序	标准	除以下各项外的所有逻辑应用区域： - Azure 政府区域 - Azure 中国区域 - 美国国防部（DoD）
Power Apps	高级	除以下各项外的所有 Power Apps 区域： - 美国政府（GCC） - 美国政府（GCC High） - 由世纪互联运营的中国云 - 美国国防部（DoD）
Power Automate	高级	除以下各项外的所有 Power Automate 区域： - 美国政府（GCC） - 美国政府（GCC High） - 由世纪互联运营的中国云 - 美国国防部（DoD）

联系人
Name	Aranda Software
URL	https://arandasoft.com/
Email	soporte@arandasoft.com

连接器元数据
发布者	Aranda Software Corporation
网站	https://arandasoft.com/
隐私策略	https://arandasoft.com/politica-de-privacidad/
类别	业务管理;协作

Aranda Service Management Suite （ASMS）

提高公司的工作效率，并通过 Aranda Service Management Suite（多租户解决方案）实现用户体验的转换，该解决方案允许你管理、集成和自动化业务流程和服务。创建、搜索和更新存储在 ASMS 的任何工作区（项目）中的记录，包括事件、要求和更改等。

先决条件

请记住以下先决条件才能继续：

一个订阅和一个 Aranda Service Management Suite 实例（ASMS）。从此处开始： https://arandasoft.com/
具有高级连接器功能的活动Microsoft Power Automate 订阅。

获取凭据

若要执行身份验证，请使用集成令牌。在以下链接中，可以找到有关如何获取集成令牌的信息

连接器入门

需要向 Aranda Service Management Suite（ASMS）订阅。
获取集成令牌
获取 Aranda Service Management ASMS API（ApiAsms）的实例 URL。
与 Aranda Service Management Suite 连接器建立连接。
选择连接器提供的以下函数之一：
有关连接器的详细文档，请参阅 https://docs.arandasoft.com/connectors

可以在以下情况下使用此连接器：

创建、搜索和更新票证以及其他可用作。
获取票证可跟踪性。
下载与票证相关的附件。
在 Aranda Service Management Suite 中搜索知识库（KB）文章。
从知识库（KB）文章下载附件。
创建、搜索和更新配置项目（CIs）。
它允许组织解决其内部支持请求，管理和简化技术问题解决过程。
允许跟踪请求者和支持代理之间的通信。
提供自动响应，以通知请求者其票证的状态。

成功的响应

Code	Name	Description
200	好的	请求已成功
204	无内容	请求中未找到任何数据

常见错误和补救措施

Code	Name	Description	解决方案
400	错误请求	CriteriaNeedsSomeArguments	检查搜索参数是否不为空
400	错误请求	InvalidAdditionalFieldId	检查其他字段的 ID 是否正确
400	错误请求	InvalidItemType	大小写类型不正确，更改大小写类型 ID
400	错误请求	InvalidProjectId	项目 ID 不正确，请更改将事例关联到的项目 ID
400	错误请求	InvalidStateId	在创建或更新票证时检查添加的状态
400	错误请求	InvalidUploadType	附加文件时出错，请从系统管理员请求帮助
400	错误请求	RequestNeedsSomeArguments	检查票证的必填字段，并在连接器中添加相应的值
400	错误请求	SearchListIsRequired	从系统管理员请求帮助
400	错误请求	参数名称：{Name parameter}	检查错误中提到的属性是否不为 null
400	错误请求	为 null 参数名称： {Name parameter}	检查错误中提到的属性是否不为 null
400	错误请求	ItemTypeIsRequired	添加事例类型
400	错误请求	ModelIdIsEmpty	添加 modelId 参数。它是必需的。
400	错误请求	StateIdIsEmpty	添加 stateId 参数。它是必需的。
400	错误请求	ServiceIdIsEmpty	添加 serviceId 参数。它是必需的。
400	错误请求	CategoryIdIsEmpty	添加 categoryId 参数。它是必需的。
400	错误请求	TypesListNeedsSomeArguments	要求在搜索票证时添加案例类型，请求系统管理员的帮助
400	错误请求	“{PARAMETER_NAME}” AdditionalFieldIsRequired	其他字段“{PARAMETER_NAME}”是必需的
400	错误请求	ModelNotActive	与事例关联的模型未处于活动状态
400	错误请求	FailedToCloseTaskPendingCloseTasksPredecessors	如果尝试关闭事例，并且父案例有待关闭的任务
400	错误请求	DuplicatedObject	Ci 已存在于数据库中
400	错误请求	EmptyValue 参数名称： {PARAMETER_NAME}	需要 {PARAMETER_NAME} 参数
400	错误请求	EmptyEnumeration 参数名称： {PARAMETER_NAME}	{PARAMETER_NAME} 参数是列表，并且是必需的
403	已禁止	DoNotHavePermissionForThisAction	与系统管理员联系以分配权限

Code	Name	Description	解决方案
500	内部服务器错误		从系统管理员请求帮助
500	内部服务器错误	FailureExportExcel	从系统管理员请求帮助
500	内部服务器错误	FailureGetAdditionalFields	从系统管理员请求帮助
500	内部服务器错误	FailureGetCategoriesByService	从系统管理员请求帮助
500	内部服务器错误	FailureGetChangeFSC	从系统管理员请求帮助
500	内部服务器错误	FailureGetFields	从系统管理员请求帮助
500	内部服务器错误	FailureGetFieldsList	从系统管理员请求帮助
500	内部服务器错误	FailureGetFiles	从系统管理员请求帮助
500	内部服务器错误	FailureGetLookupValues	从系统管理员请求帮助
500	内部服务器错误	FailureGetMailTemplates	从系统管理员请求帮助
500	内部服务器错误	FailureGetModelByCategory	从系统管理员请求帮助
500	内部服务器错误	FailureGetOperators	从系统管理员请求帮助
500	内部服务器错误	FailureGetReassignmentReasons	从系统管理员请求帮助
500	内部服务器错误	FailureGetSimilarItems	从系统管理员请求帮助
500	内部服务器错误	FailureSearchQuickManagement	从系统管理员请求帮助

FAQ

如何检索连接器中使用不同作所需的属性 ID（例如项目、服务、类别、组、专家）？

可以通过多种方式检索 ID：
- 使用 Aranda Query Manager，可以创建一个报表，用于查询所需数据的 Aranda Service Management Suite （ASMS）表。如果需要有关解决方案中的数据对象的指南，请访问以下链接 https://docs.arandasoft.com/docs/database.html 并识别与 ASMS 安装对应的 Aranda 数据库版本。
- 如果使用 ASMS 本地安装，可以通过 SQL 客户端查询所需数据的 ASMS 表。
- 通过 Aranda 支持中心，通过以下网站支持中指示的联系人渠道创建支持请求。
使用“添加附件”作时要附加的文件的最大大小是多少？

最大大小取决于 ASMS 实例/安装的特定配置。请询问 ASMS 管理员。
在连接器所需的 ASMS 连接配置中使用令牌的技术员帐户需要哪些数据访问级别？

访问级别与定期在 ASMS 中使用的技术人员帐户相同。换句话说，根据 ASMS 中相应技术人员的角色和权限，可以使用连接器访问数据。
连接器中将使用其令牌的技术人员帐户应为命名或并发帐户吗？

由于连接器每小时可以多次访问相关的 ASMS 实例，因此强烈建议该帐户是命名类型。
使用连接器创建或修改事例是否遵循 ASMS 接口中存在的相同数据验证规则？

是的，它遵循相同的验证规则。例如，在为特定项目、服务和类别创建事例时，如果必须填写本机字段和其他字段，则通过连接器提交事例时也需要这些数据。
连接器是否可用于云和本地环境中的 ASMS 实例？

是的，可以在 ASMS 的云和本地安装中使用。在本地安装中，必须考虑 ASMS 服务器与 Power Automate 环境之间的连接。
我有一个 Power Automate 许可证，它只允许我使用标准连接器。是否可以使用 ASMS 连接器？

不可能，ASMS 连接器是高级类型。
我想在 Power Automate 中创建从 ASMS 中的事件开始的流（例如，创建案例时，将事例分配给特定组时）。是否可以使用从 ASMS 中发生的事件开始的触发器？

是的，这是可能的。建议执行以下步骤：
- 初始化触发器“收到 HTTP 请求时”，并创建包含应从 ASMS 接收的数据结构的请求正文 JSON 架构。创建触发器后，你将获得在 ASMS 实例中使用的 HTTP POST URL（WebHook URL）。不要忘记考虑访问 WebHook URL 的身份验证机制（例如令牌）。
- 在 ASMS 中为满足条件集创建业务规则，这些条件应在 Power Automate 中启动流。作为规则中的作，选择“调用 Webhook”并在调用目标 URL 中输入之前获取的 WebHook URL、要发送的参数和请求正文（这必须与请求正文 JSON 架构匹配）。有关如何从 ASMS 中的规则调用 Webhook 的详细信息，请访问以下链接： Webhook 规则
- 测试创建的规则并验证 HTTP 请求是否已发送到 WebHook URL，并在 Power Automate 中初始化流。
是否可以从 Power Automate 中的流调用 ASMS REST API 终结点作为作？

是的，这是可能的。使用“HTTP”作并填写其中所需的数据（URI、方法、标头、正文等）。

创建连接

连接器支持以下身份验证类型：


默认	用于创建连接的参数。	所有区域	不可共享

违约

适用：所有区域

用于创建连接的参数。

这是不可共享的连接。如果 Power App 与另一个用户共享，系统会提示其他用户显式创建新连接。

Name	类型	Description	必选
主机 ASMS	字符串	主机 ASMS	True
授权令牌	securestring	授权令牌	True

限制

名称	调用	续订期
每个连接的 API 调用数	100	60 秒

操作

下载事例附件	下载与文章相关的附件。
下载文章附件	下载与文章相关的附件。
创建案例	在 ASMS 中创建新事例记录。
创建配置项目	在 Aranda CMDB 中创建 CIS。
向事例添加附件	将文件附加到 ASMS 中的特定事例记录。
向案例添加备注	向 ASMS 中的特定案例记录添加备注。
搜索事例	根据查询中添加的搜索条件检索 ASMS 事例记录的列表。
搜索文章	根据查询中添加的搜索条件检索文章列表。
搜索配置项目	根据查询中添加的搜索条件检索 CMDB CIS 记录的列表。
更新案例	更新 ASMS 事例的记录。
更新配置项目	更新 Aranda CMDB 中的 CIS。
获取案例	获取 ASMS 事例元数据的记录。
获取案例历史记录	获取案例历史记录，默认情况下不包括备注。
获取配置项目	按名称和串行获取 CI。

下载事例附件

操作 ID:: DownloadCaseFile

下载与文章相关的附件。

参数

名称	密钥	必需	类型	说明
按项目 ID	ticketId	True	string	记录的代码
附件标识符	fileId	True	integer	表示附件的标识符。

附件的内容。

文件内容: binary

下载文章附件

操作 ID:: DownloadArticleFile

下载与文章相关的附件。

参数

名称	密钥	必需	类型	说明
项目 ID	articleId	True	integer	项目标识符。
附件 ID	fileId	True	integer	表示附件的标识符。

附件的内容。

文件内容: binary

创建案例

操作 ID:: CreateCase

在 ASMS 中创建新事例记录。

参数

名称	密钥	必需	类型	说明
Subject	subject	True	string	主题。
Description	description		string	事例的详细说明。
病例类型	itemType	True	string	选择事例类型或手动输入事例类型名称。
项目	projectId	True	integer	选择项目或手动输入项目标识符。
服务	serviceId	True	integer	选择服务或手动输入服务标识符。
类别	categoryId	True	integer	选择类别或手动输入类别标识符。
原因	reasonId		integer	选择原因或手动输入原因标识符。
组	groupId		integer	选择组或手动输入组标识符。
负责	responsibleId		integer	选择一个负责任的或手动输入负责任的标识符。
公司	companyId		integer	选择公司或手动输入公司标识符。
Provider	providerId		integer	选择提供程序或手动输入提供程序标识符。
组织区域	unitId		integer	选择组织区域或手动输入组织区域标识符。
申请人 ID	applicantId		integer	申请人标识符。
客户 ID	customerId		integer	客户端标识符。
CI 标识符	ciId		integer	CI 标识符。
注册表类型	registryTypeId		integer	选择注册表类型或手动输入注册表类型标识符。
紧急性	urgencyId		integer	选择紧急或手动输入紧急标识符。
影响	impactId		integer	选择影响或手动输入影响标识符。
ID	fieldId		string	字段标识符。
values	values		array of string	价值。

名称	路径	类型	说明
大小写 ID	id	integer	大小写标识符
按项目 ID	idByProject	string	记录的按项目 ID

创建配置项目

操作 ID:: CreateCI

在 Aranda CMDB 中创建 CIS。

参数

名称	密钥	必需	类型	说明
Name	name	True	string	Name
Description	description		string	CI 的详细说明。
串行	serial		string	串行。
资产标记	assetTag		string	资产标记。
项目	projectId	True	integer	选择项目或手动输入项目标识符。
类别	categoryId	True	integer	选择类别或手动输入类别标识符。
负责任的 ID	responsibleId	True	integer	负责任的标识符。
许可证号	licenseNumber		string	许可证号。
制造者	manufacturerId		integer	选择制造商或手动输入制造商标识符。
品牌	brandId		integer	选择品牌或手动输入品牌标识符。
型号	modelId		integer	选择模型或手动输入模型标识符。
提供程序 ID	providerId		integer	选择提供程序或手动输入提供程序标识符。
原因 ID	reasonId		integer	原因标识符。
价格	price		number	价格。
刷卡	rfid		string	刷卡
接受日期	acceptDate		date-time	接受日期。
交付给公司的日期	checkInDate		date-time	交付给公司的日期。
责任的初始日期	responsibilityDate		date-time	责任的初始日期。
条码	barCode		string	条形码。
度量单位值	unitSize		string	度量单位值。
度量单位	unitId		integer	选择度量单位或手动输入度量单位标识符。
成本中心	costCenterId		integer	选择成本中心或手动输入成本中心标识符。
影响	impactId		integer	选择影响或手动输入影响标识符。
风险	riskId		integer	选择风险或手动输入风险标识符。
位置	locationId		integer	选择位置或手动输入位置标识符。
fieldId	fieldId		string	字段标识符。
values	values		array of string	价值

名称	路径	类型	说明
配置项目标识符	id	integer	配置项目标识符。

向事例添加附件

操作 ID:: AttachFile

将文件附加到 ASMS 中的特定事例记录。

参数

名称	密钥	必需	类型	说明
按项目 ID	ticketId	True	string	记录的代码
文件	file	True	byte	字节文件。
文件名	fileName	True	string	文件名（例如'Vacation_Approval_Form.docx'）。

向案例添加备注

操作 ID:: AttachNote

向 ASMS 中的特定案例记录添加备注。

参数

名称	密钥	必需	类型	说明
按项目 ID	ticketId	True	string	记录的代码
注释	message	True	string	要附加到记录的注释。

搜索事例

操作 ID:: SearchTickets

根据查询中添加的搜索条件检索 ASMS 事例记录的列表。

参数

名称	密钥	必需	类型	说明
筛选器之间的关系	logicOperator	True	string	指定搜索条件之间的关系。
要筛选的字段	field	True	string	要筛选的事例字段（例如“stateName”）。
搜索运算符	operator	True	string	搜索运算符。
要查找的值	value	True	string	要查找的字段值。

名称	路径	类型	说明
		array of object
大小写 ID	id	integer	记录的系统标识符。
按项目 ID	idByProject	string	记录的按项目 ID。
Subject	subject	string	案例主题。
Description	description	string	事例的详细说明。
项目标识	projectId	integer	项目标识符。
项目	projectName	string	项目名称。
病例类型	itemTypeName	string	大小写类型名称。
事例类型 ID	itemTypeId	integer	大小写类型标识符。
服务编号	serviceId	integer	服务标识符。
服务	serviceName	string	服务名称。
模型 ID	modelId	integer	模型标识符。
型号	modelName	string	模型名称。
类别 ID	categoryId	integer	类别标识符。
类别	categoryName	string	类别名称。
申请人 ID	applicantId	integer	申请人标识符。
CI ID	ciId	integer	配置项目标识符。
CI	ciName	string	主配置项目名称。
客户 ID	customerId	integer	客户端标识符。
客户	customerName	string	客户端名称。
公司 ID	companyId	integer	公司标识符。
公司	companyName	string	公司名称。
SLA ID	slaId	integer	SLA 标识符。
SLA	slaName	string	SLA 名称。
状态 ID	stateId	integer	状态标识符。
状态	stateName	string	状态名称。
原因 ID	reasonId	integer	原因标识符。
原因	reasonName	string	原因名称。
群组标识符	groupId	integer	组标识符。
组	groupName	string	组名称。
负责任的 ID	responsibleId	integer	负责任的标识符。
负责	responsibleName	string	负责任的名称。
影响 ID	impactId	integer	影响标识符。
影响	impactName	string	影响名称。
注册表日期	openedDate	string	注册表日期。
作者 ID	authorId	integer	作者标识符。
作者	authorName	string	作者名称。

搜索文章

操作 ID:: GetArticle

根据查询中添加的搜索条件检索文章列表。

参数

名称	密钥	必需	类型	说明
项目	projectId	True	integer	选择项目或手动输入项目标识符。
搜索文章	search	True	string	按文章标题、关键字或说明搜索文章。
类别	folderId		integer	选择类别或手动输入类别标识符。
类型	typeId		integer	选择类型或手动输入类型标识符。

名称	路径	类型	说明
		array of object
Title	title	string	标题。
Description	description	string	Description.
Content	content	html	内容。
文章关键字	keyword	string	文章关键字。
项目 ID	identifier	string	项目标识符。
创建日期	createdDate	string	创建日期。
修改日期	lastModifiedDate	string	修改日期。
类 ID	classId	integer	类标识符。
项目 ID	id	integer	记录的系统标识符。
ID	type.id	integer	类型标识符。
姓名	type.name	string	类型名称。
URL	url	string	URL
附件文章	attachments	array of object	与文章相关的附件。
ID	attachments.id	integer	附件标识符。
姓名	attachments.name	string	附件名称。

搜索配置项目

操作 ID:: SearchCIs

根据查询中添加的搜索条件检索 CMDB CIS 记录的列表。

参数

名称	密钥	必需	类型	说明
筛选器之间的关系	logicOperator	True	string	指定搜索条件之间的关系。
要筛选的字段	field	True	string	要筛选的 CI 字段（例如“stateName”）
搜索运算符	operator	True	string	搜索运算符。
要查找的值	value	True	string	要查找的字段值。

名称	路径	类型	说明
		array of object
接受日期	acceptDate	date-time	接受日期
资产标记	assetTag	string	资产标记
责任名称	responsibleName	string	责任名称
ID	category.id	integer	类别标识符
姓名	category.name	string	类别名称
交付给公司的日期	checkinDate	date-time	交付给公司的日期。
创建日期	createdDate	date-time	创建日期
Description	description	string	CI 的详细说明。
CI ID	id	integer	记录的系统标识符。
ID	impact.id	integer	影响标识符
姓名	impact.name	string	影响名称
修改日期	modifiedDate	date-time	修改日期
CI 名称	name	string	配置项目名称。
责任的初始日期	responsibilityDate	date-time	责任的初始日期。
串行	serial	string	串行
ID	state.id	integer	状态标识符。
姓名	state.name	string	状态名称。
CI 类型	type	string	配置项目类型。

更新案例

操作 ID:: UpdateCase

更新 ASMS 事例的记录。

参数

名称	密钥	必需	类型	说明
按项目 ID	ticketId	True	string	记录的代码
Subject	subject		string	主题。
Description	description		string	事例的详细说明。
解决方案	commentary		string	案例解决方案。
服务编号	serviceId		integer	服务标识符。
类别 ID	categoryId		integer	类别标识符。
状态 ID	stateId		integer	状态标识符。
原因 ID	reasonId		integer	原因标识符。
群组标识符	groupId		integer	组标识符。
负责任的 ID	responsibleId		integer	负责任的标识符。
申请人 ID	applicantId		integer	申请人标识符。
客户 ID	customerId		integer	客户端标识符。
公司 ID	companyId		integer	公司标识符。
CI ID	ciId		integer	CI 标识符。
提供程序 ID	providerId		integer	提供程序标识符。
组织区域 ID	unitId		integer	组织区域标识符。
注册表类型	registryTypeId		integer	选择注册表类型或手动输入注册表类型标识符。
紧急性	urgencyId		integer	选择紧急或手动输入紧急标识符。
影响	impactId		integer	选择紧急性或手动输入影响标识符。
接口	interfaceId		string	案例与第三方的关系。
字段标识符	fieldId		string	字段标识符。
价值观	values		array of string	值。

名称	路径	类型	说明
结果	result	boolean	结果

更新配置项目

操作 ID:: UpdateCI

更新 Aranda CMDB 中的 CIS。

参数

名称	密钥	必需	类型	说明
名称或串行 CI	request	True	string	输入配置项的名称或串行。
Description	description		string	CI 的详细说明。
串行	serial		string	串行
资产标记	assetTag		string	资产标记。
类别	categoryId		integer	选择类别或手动输入类别标识符。
负责任的 ID	responsibleId		integer	负责任的标识符。
状态 ID	stateId		integer	状态标识符。
许可证号	licenseNumber		string	许可证号。
制造商 ID	manufacturerId		integer	制造商标识符。
品牌	brandId		integer	选择品牌或手动输入品牌标识符。
型号	modelId		integer	选择模型或手动输入模型标识符。
提供程序 ID	providerId		integer	提供程序标识符。
原因 ID	reasonId		integer	原因标识符。
价格	price		number	价格。
刷卡	rfid		string	刷卡
接受日期	acceptDate		date-time	接受日期。
交付给公司的日期	checkInDate		date-time	交付给公司的日期。
责任的初始日期	responsibilityDate		date-time	责任的初始日期。
条码	barCode		string	条形码。
度量单位值	unitSize		string	度量单位值。
度量单位	unitId		integer	选择度量单位或手动输入度量单位标识符。
成本中心 ID	costCenterId		integer	成本中心标识符。
影响	impactId		integer	选择影响或手动输入影响标识符。
风险	riskId		integer	选择风险或手动输入风险标识符。
位置 ID	locationId		integer	位置标识符。
fieldId	fieldId		string	字段标识符
values	values		array of string	价值

名称	路径	类型	说明
配置项目标识符	id	integer	配置项目标识符。

获取案例

操作 ID:: GetCase

获取 ASMS 事例元数据的记录。

参数

名称	密钥	必需	类型	说明
按项目 ID	ticketId	True	string	记录的代码

名称	路径	类型	说明
大小写 ID	id	integer	记录的系统标识符。
按项目 ID	idByProject	string	记录的按项目 ID。
Subject	subject	string	主题。
Description	description	string	事例的详细说明。
解决方案	commentary	string	案例解决方案。
项目标识	projectId	integer	项目标识符。
项目	projectName	string	项目名称。
大小写类型	itemTypeName	string	大小写类型名称。
事例类型 ID	itemTypeId	integer	大小写类型标识符。
服务编号	serviceId	integer	服务标识符。
服务	serviceName	string	服务名称。
模型 ID	modelId	integer	模型标识符。
型号	modelName	string	模型名称。
类别 ID	categoryId	integer	类别标识符。
类别名称	categoryName	string	类别。
申请人 ID	applicantId	integer	申请人标识符。
客户 ID	customerId	integer	客户端标识符。
客户	customerName	string	客户端名称。
公司 ID	companyId	integer	公司标识符。
公司	companyName	string	公司名称。
CI ID	ciId	integer	CI 标识符。
CI	ciName	string	CI 名称。
SLA ID	slaId	integer	SLA 标识符。
SLA	slaName	string	SLA 名称。
状态 ID	stateId	integer	状态标识符。
状态	stateName	string	状态名称。
原因 ID	reasonId	integer	原因标识符。
原因	reasonName	string	原因名称。
群组标识符	groupId	integer	组标识符。
组	groupName	string	组名称。
负责任的 ID	responsibleId	integer	负责任的标识符。
负责	responsibleName	string	负责任的名称。
注册表类型 ID	registryTypeId	integer	注册表类型标识符。
注册表类型	registryTypeName	string	注册表类型名称。
影响 ID	impactId	integer	影响标识符。
影响	impactName	string	影响名称。
紧急 ID	urgencyId	integer	紧急标识符。
紧急性	urgencyName	string	紧急名称。
优先级 ID	priorityId	integer	优先级标识符。
Priority	priorityName	string	优先级名称。
风险 ID	riskId	integer	风险标识符。
风险	riskName	string	风险名称。
提供程序 ID	providerId	integer	提供程序标识符。
Provider	providerName	string	提供程序名称。
UC ID	ucId	integer	UC 标识符。
UC	ucName	string	UC 名称。
组织区域 ID	unitId	integer	组织区域标识符。
组织区域	unitName	string	组织区域名称。
OLA ID	olaId	integer	OLA 标识符。
OLA	olaName	string	OLA 名称。
注册表日期	openedDate	string	注册表日期。
关闭日期	closedDate	string	关闭日期。
最终日期	finalDate	string	最终日期（仅适用于任务记录）。
初始日期	initialDate	string	初始日期（仅适用于任务记录）。
成本	cost	number	成本。
实际成本	realCost	number	实际成本。
估算成本	estimatedCost	number	估计成本。
价格	price	number	价格。
接口标识符	interfaceId	string	接口标识符。
已关闭	isClosed	boolean	闭。
进展	currentProgress	number	进展。
实际日期	realDate	string	实际日期。
估计日期	estimatedDate	string	估计日期。
作者 ID	authorId	integer	作者标识符。
作者	authorName	string	作者名称。
附件	attachments	array of object	与事例相关的附件。
ID	attachments.id	integer	附件标识符。
姓名	attachments.name	string	附件名称。
其他字段	additionalFields	array of object	其他字段。
ID	additionalFields.fieldId	integer	字段标识符。
姓名	additionalFields.nameField	string	字段名称。
values	additionalFields.values	array of string	其他字段值。
：ID	additionalFields.valueDetails.id	integer	列表或目录类型字段的规范：标识符。
：价值	additionalFields.valueDetails.value	string	列表或目录类型字段的规范：值。

获取案例历史记录

操作 ID:: CaseHistory

获取案例历史记录，默认情况下不包括备注。

参数

名称	密钥	必需	类型	说明
按项目 ID	ticketId	True	string	记录的代码
包括备注	addNote		string	选择要添加的笔记类型。

名称	路径	类型	说明
		array of object
作键	actionId	string	作键
Action	actionName	string	票证生命周期中执行的活动或作的名称。
作者 ID	authorId	integer	作者标识符。
作者	authorName	string	创作谁进行了更改。
创建日期	created	date-time	作的发生日期。
修改后的字段名称	fieldName	string	修改后的字段名称。
新值	newValue	html	表示属性的新值。
旧值	oldValue	html	已修改的值。
备注类型	noteType	string	表示备注的类型（仅适用于“注意”作键）。
相关项标识符	relatedItemId	string	表示添加 Relation 时标识符。（仅适用于“AddedRelated”作键）。

获取配置项目

操作 ID:: GetCI

按名称和串行获取 CI。

参数

名称	密钥	必需	类型	说明
名称或串行 CI	request	True	string	输入配置项的名称或串行。

名称	路径	类型	说明
其他字段	additionalFields	array of object	其他字段。
ID	additionalFields.fieldId	integer	字段标识符
姓名	additionalFields.nameField	string	字段名称
values	additionalFields.values	array of string	其他字段值
：ID	additionalFields.valueDetails.id	integer	列表或目录类型字段的规范：标识符
：价值	additionalFields.valueDetails.value	string	列表或目录类型字段的规范：值
资产标记	assetTag	string	资产标记。
条码	barCode	string	条形码。
ID	brand.id	integer	品牌标识符。
姓名	brand.name	string	品牌。
ID	category.id	integer	类别标识符。
姓名	category.name	string	类别名称。
ID	costCenter.id	integer	成本中心标识符。
姓名	costCenter.name	string	成本中心名称。
接受日期	acceptDate	date-time	接受日期。
交付给公司的日期	checkinDate	date-time	交付给公司的日期。
责任的初始日期	responsibilityDate	date-time	责任的初始日期。
创建日期	createdDate	date-time	创建日期。
修改日期	modifiedDate	date-time	修改日期。
Description	description	string	CI 的详细说明。
CI ID	id	integer	记录的系统标识符。
ID	impact.id	integer	影响标识符。
姓名	impact.name	string	影响名称。
许可证号	licenseNumber	string	许可证号。
ID	manufacturer.id	integer	制造商标识符。
姓名	manufacturer.name	string	制造商名称。
ID	model.id	integer	模型标识符。
姓名	model.name	string	模型名称。
CI 名称	name	string	配置项目名称。
项目	projects	array of object	项目。
ID	projects.id	integer	标识符。
ID	provider.id	integer	制造商标识符。
姓名	provider.name	string	制造商名称。
ID	reason.id	integer	原因标识符。
姓名	reason.name	string	原因名称
ID	responsible.id	integer	负责任的标识符。
姓名	responsible.name	string	负责任的名称。
ID	risk.id	integer	风险标识符。
姓名	risk.name	string	风险名称。
刷卡	rfid	string	刷卡
串行	serial	string	串行
ID	state.id	integer	状态标识符。
姓名	state.name	string	状态名称。
临时项标识符	tempItemId	integer	临时项标识符。
CI 类型	type	string	配置项目类型。
ID	unit.id	integer	单位标识符。
姓名	unit.name	string	单位名称。
度量单位值	unitSize	string	度量单位值。
有用生命	usefulLife	integer	有用的生命。
版本	version	integer	版本

定义

二进制

这是基本数据类型“binary”。

通过

参数

返回

参数

返回

参数

返回

参数

返回

参数

参数

参数

返回

参数

返回

参数

返回

参数

返回

参数

返回

参数

返回

参数

返回

参数

返回