9.2. Red Hat Developer Hub 中支持的 ServiceNow 自定义操作
ServiceNow 自定义操作允许您管理 Red Hat Developer Hub 中的记录。自定义操作支持以下 API 请求的 HTTP 方法:
-
GET:从指定的资源端点检索指定信息 -
POST:创建或更新资源 -
PUT:修改资源 -
PATCH: 更新资源 DELETE:删除资源- [GET] servicenow:now:table:retrieveRecord
从 Developer Hub 中的表检索指定记录的信息。
Expand 表 9.1. 输入参数 Name 类型 要求 描述 tableNamestring必填
从中检索记录的表的名称
sysIdstring必填
要检索的记录的唯一标识符
sysparmDisplayValueenum("true", "false", "all")选填
返回字段显示值,如
true,实际值为false,或两者。默认值为false。sysparmExcludeReferenceLink布尔值选填
设置为
true以排除参考字段的 Table API 链接。默认值为false。sysparmFieldsstring[]选填
要在响应中返回的字段数组
sysparmViewstring选填
根据指定的 UI 视图呈现响应。您可以使用
sysparm_fields覆盖此参数。sysparmQueryNoDomain布尔值选填
将 设置为
true,以在域间访问数据(如果授权)。默认值为false。Expand 表 9.2. 输出参数 Name 类型 描述 resultrecord<PropertyKey, unknown>请求的响应正文
- [GET] servicenow:now:table:retrieveRecords
从 Developer Hub 中的表检索有关多个记录的信息。
Expand 表 9.3. 输入参数 Name 类型 要求 描述 tableNamestring必填
从中检索记录的表的名称
sysparamQuerystring选填
用于过滤结果的编码查询字符串
sysparmDisplayValueenum("true", "false", "all")选填
返回字段显示值,如
true,实际值为false,或两者。默认值为false。sysparmExcludeReferenceLink布尔值选填
设置为
true以排除参考字段的 Table API 链接。默认值为false。sysparmSuppressPaginationHeader布尔值选填
设置为
true以阻止分页标头。默认值为false。sysparmFieldsstring[]选填
要在响应中返回的字段数组
sysparmLimitint选填
每个页面返回的最大结果数。默认值为
10,000。sysparmViewstring选填
根据指定的 UI 视图呈现响应。您可以使用
sysparm_fields覆盖此参数。sysparmQueryCategorystring选填
用于查询的查询类别的名称
sysparmQueryNoDomain布尔值选填
将 设置为
true,以在域间访问数据(如果授权)。默认值为false。sysparmNoCount布尔值选填
不要在表中执行所选 countrolebinding。默认值为
false。Expand 表 9.4. 输出参数 Name 类型 描述 resultrecord<PropertyKey, unknown>请求的响应正文
- [POST] servicenow:now:table:createRecord
在 Developer Hub 的表中创建记录。
Expand 表 9.5. 输入参数 Name 类型 要求 描述 tableNamestring必填
保存记录的表的名称
requestBodyrecord<PropertyKey, unknown>选填
在指定记录中定义的每个参数的字段名称和关联值
sysparmDisplayValueenum("true", "false", "all")选填
返回字段显示值,如
true,实际值为false,或两者。默认值为false。sysparmExcludeReferenceLink布尔值选填
设置为
true以排除参考字段的 Table API 链接。默认值为false。sysparmFieldsstring[]选填
要在响应中返回的字段数组
sysparmInputDisplayValue布尔值选填
使用其显示值(如
true或实际值)设置字段值,如false。默认值为false。sysparmSuppressAutoSysField布尔值选填
设置为
true以禁止自动生成系统字段。默认值为false。sysparmViewstring选填
根据指定的 UI 视图呈现响应。您可以使用
sysparm_fields覆盖此参数。Expand 表 9.6. 输出参数 Name 类型 描述 resultrecord<PropertyKey, unknown>请求的响应正文
- [PUT] servicenow:now:table:modifyRecord
修改 Developer Hub 中的表中的记录。
Expand 表 9.7. 输入参数 Name 类型 要求 描述 tableNamestring必填
修改记录的表的名称
sysIdstring必填
要修改的记录的唯一标识符
requestBodyrecord<PropertyKey, unknown>选填
在指定记录中定义的每个参数的字段名称和关联值
sysparmDisplayValueenum("true", "false", "all")选填
返回字段显示值,如
true,实际值为false,或两者。默认值为false。sysparmExcludeReferenceLink布尔值选填
设置为
true以排除参考字段的 Table API 链接。默认值为false。sysparmFieldsstring[]选填
要在响应中返回的字段数组
sysparmInputDisplayValue布尔值选填
使用其显示值(如
true或实际值)设置字段值,如false。默认值为false。sysparmSuppressAutoSysField布尔值选填
设置为
true以禁止自动生成系统字段。默认值为false。sysparmViewstring选填
根据指定的 UI 视图呈现响应。您可以使用
sysparm_fields覆盖此参数。sysparmQueryNoDomain布尔值选填
将 设置为
true,以在域间访问数据(如果授权)。默认值为false。Expand 表 9.8. 输出参数 Name 类型 描述 resultrecord<PropertyKey, unknown>请求的响应正文
- [PATCH] servicenow:now:table:updateRecord
更新 Developer Hub 中的表中的记录。
Expand 表 9.9. 输入参数 Name 类型 要求 描述 tableNamestring必填
更新记录的表的名称
sysIdstring必填
要更新记录的唯一标识符
requestBodyrecord<PropertyKey, unknown>选填
在指定记录中定义的每个参数的字段名称和关联值
sysparmDisplayValueenum("true", "false", "all")选填
返回字段显示值,如
true,实际值为false,或两者。默认值为false。sysparmExcludeReferenceLink布尔值选填
设置为
true以排除参考字段的 Table API 链接。默认值为false。sysparmFieldsstring[]选填
要在响应中返回的字段数组
sysparmInputDisplayValue布尔值选填
使用其显示值(如
true或实际值)设置字段值,如false。默认值为false。sysparmSuppressAutoSysField布尔值选填
设置为
true以禁止自动生成系统字段。默认值为false。sysparmViewstring选填
根据指定的 UI 视图呈现响应。您可以使用
sysparm_fields覆盖此参数。sysparmQueryNoDomain布尔值选填
将 设置为
true,以在域间访问数据(如果授权)。默认值为false。Expand 表 9.10. 输出参数 Name 类型 描述 resultrecord<PropertyKey, unknown>请求的响应正文
- [DELETE] servicenow:now:table:deleteRecord
从 Developer Hub 中的表中删除记录。
Expand 表 9.11. 输入参数 Name 类型 要求 描述 tableNamestring必填
从中删除记录的表的名称
sysIdstring必填
要删除记录的唯一标识符
sysparmQueryNoDomain布尔值选填
将 设置为
true,以在域间访问数据(如果授权)。默认值为false。