ALM软件：Jama Connect二次开发_（13）.用户界面定制.docx

PAGE1

PAGE1

用户界面定制

在JamaConnect中，用户界面的定制是提高用户体验、满足特定业务需求的重要手段。通过定制用户界面，用户可以更高效地管理需求、测试用例和项目文档，同时保持一致性和专业性。本节将详细介绍如何在JamaConnect中进行用户界面的定制，包括自定义字段、表单布局、视图和报告等方面。

自定义字段

自定义字段允许用户在JamaConnect中添加特定的属性，以满足项目的特定需求。这些字段可以是文本、数字、日期、选择列表或链接等类型。通过自定义字段，用户可以更好地组织和管理项目数据。

创建自定义字段

进入项目设置：

登录JamaConnect。

选择要定制的项目。

点击项目设置（齿轮图标）。

添加自定义字段：

在项目设置中，选择“字段”选项。

点击“添加字段”按钮。

填写字段名称、描述和字段类型。

选择适用的项类型（如需求、测试用例等）。

点击“保存”按钮。

示例：添加一个自定义选择列表字段

假设我们需要在需求项中添加一个选择列表字段，用于记录需求的状态（如“未开始”、“进行中”、“已完成”）。

#示例代码：使用JamaConnectAPI添加自定义选择列表字段

importrequests

importjson

#API端点

base_url=/rest/v1/

#项目ID

project_id=12345

#认证信息

auth=(your_username,your_password)

#定义自定义字段

custom_field={

name:需求状态,

description:记录需求的当前状态,

type:CHOICE,

itemType:Requirement,

choices:[未开始,进行中,已完成]

}

#发送POST请求创建自定义字段

response=requests.post(f{base_url}projects/{project_id}/fields,json=custom_field,auth=auth)

#检查响应

ifresponse.status_code==201:

print(自定义字段创建成功)

else:

print(f自定义字段创建失败，状态码：{response.status_code})

print(f错误信息：{response.text})

编辑自定义字段

进入项目设置：

登录JamaConnect。

选择要定制的项目。

点击项目设置（齿轮图标）。

编辑现有字段：

在项目设置中，选择“字段”选项。

找到要编辑的字段，点击“编辑”按钮。

修改字段名称、描述、类型或选择列表等属性。

点击“保存”按钮。

示例：修改一个自定义选择列表字段

假设我们需要将“需求状态”字段的选择列表添加一个新选项“暂停”。

#示例代码：使用JamaConnectAPI修改自定义选择列表字段

importrequests

importjson

#API端点

base_url=/rest/v1/

#项目ID

project_id=12345

#字段ID

field_id=67890

#认证信息

auth=(your_username,your_password)

#定义修改后的自定义字段

updated_custom_field={

choices:[未开始,进行中,已完成,暂停]

}

#发送PUT请求修改自定义字段

response=requests.put(f{base_url}projects/{project_id}/fields/{field_id},json=updated_custom_field,auth=auth)

#检查响应

ifresponse.status_code==200:

print(自定义字段修改成功)

else:

print(f自定义字段修改失败，状态码：{response.status_code})

print(f错误信息：{response.text})

表单布局

表单布局允许用户自定义项类型（如需求、测试用例）的显示方式。通过调整表单布局，用户可以确保重要信息在界面上突出显示，提高数据输入的效率和准确性。

自定义表单布局

进入项目设置：

登录JamaConnect。

选择要定制的项目。

点击项目设置（齿轮图标）。

编辑表单布局：