您可以在本页中了解如何添加新项目、配置现有项目或将现有项目转换为其他项目类型。

JIRA 项目是多个事务的集合。您的团队可以使用 JIRA 项目来协调产品的开发、跟踪项目、管理客服中心以及执行更多操作，具体取决于您的需求。也可以配置和自定义 JIRA 项目以满足您个人和团队的需求。

本页内容：

开始之前

要执行以下所有步骤，您必须以具有 JIRA Administrators 全局权限的用户身份登录。JIRA 管理员能够为所有安装的应用创建项目，但如果管理员对该应用没有应用访问权，将不能在创建项目之后查看项目。

创建项目

  1. 单击 Projects（在标题中）> Create project。
  2. 按照向导说明创建项目。

关于项目类型：

  • 根据您所安装的 JIRA 应用，您可能有多个可用的项目类型。
  • 每个项目类型都有一组特定的功能。
  • JIRA 实例中的所有用户将能够查看所有项目，但他们可见的功能和可采取的操作由其应用访问权和项目特定权限决定。

关于共享配置：

  • 从模板创建新项目时，该项目将采用自带的模型集进行创建。这些模型为：
    • 一个权限模型（默认）
    • 一个通知模型（默认）
    • 一个事务安全模型
    • 一个工作流模型
    • 一个事务类型模型
    • 一个事务类型屏幕模型
    • 一个字段配置模型（默认）
  • 有时您可能希望在项目之间共享模型，这样，编辑一个模型即可一次在多个项目中更改该模型。
  • 您可以选择 Create with shared configuration 来选择现有项目并使用该项目的模型。请注意，当您共享模型时，对模型的任何更改都将影响使用该模型的所有项目。

关于项目详细信息：

  • Project Key 将用作此项目的事务唯一标识的前缀（例如“TEST-100”）。请选择一个描述性强、易于输入的标识。
  • Project Lead 是很特别的一个项目角色。选择作为项目负责人来管理项目的人员。如果 JIRA 系统中只有一个用户，则 Project Lead 将默认设置为该用户且此字段将不可用。
  • 如果使用与您目前无权访问的应用相关的项目类型来创建项目，JIRA 将显示一个复选框，允许您对自己授权访问该应用。这将添加您到该应用的默认群组，并且会将您算作该许可证的一个用户。

转换项目类型

有时您可能希望将现有项目转换为其他项目类型。例如，您可以在 JIRA Software 评估期结束时或团队壮大时，将 JIRA Software 项目转换为 JIRA Core 项目。您只能转换为已安装的 JIRA 应用的项目类型。请注意，项目管理员也可以更改项目类型。

  1. 选择 > Projects，然后选择相关项目。。
  2. 选择 Project settings 菜单中的 Details。
  3. 更改项目类型，然后单击 Save details。只有您已安装的应用的项目类型可用。

您可以在项目类型和应用概述页面回顾有关项目类型和用户可见内容的更多信息。

对项目重新生成索引

要提供快速搜索，JIRA 对事务字段中输入的文本创建一个索引。有时，有必要手动重新生成此索引；例如， 在数据库中手动输入了事务，或索引已丢失或损坏时，需要重新生成索引。您可以为整个 JIRA 实例重新生成索引，也可以针对每个项目重新生成索引。按照以下说明对单个项目重新生成索引。

  1. 选择 > Projects，然后选择相关项目。。
  2. 选择 Project settings 菜单中的 Re-index project 。
  3. 单击 Start project re-index。

删除项目

如果您考虑从 JIRA 实例删除项目，请记住您不能从 JIRA 中恢复该项目。一旦删除了项目，则只能从备份或 XML 副本恢复项目，而这不是一件小事。继续操作之前，确保您可以放心地删除项目。删除项目只会删除与项目有关的事务、版本和组件。不会删除任何相关的模型、工作流或事务类型，或者可与其他项目共享的任何内容。

  1. 选择 > Projects，然后选择相关项目。。
  2. 在 Project settings 菜单中，选择 Delete project。
  3. 单击 Delete 开始删除项目。
  4. 确认项目已删除。

配置项目

  1. 通过以下方法之一，导航至项目的设置页面：
    • 选择 > Projects，然后选择相关项目。
    • 在 Project 下拉菜单中找到所需的项目描述，然后单击 Project settings 链接。
  2. 使用左侧的链接在不同项目设置之间进行切换。请阅读以下部分，了解每个设置的描述。
项目详情 | 事务类型 | 工作流 | 屏幕 | 字段 | 设置 | 角色 | 版本 | 组件 | 权限 | 通知 | 开发工具

项目详情

单击 Project settings 侧边栏中的 Details，然后根据需要编辑项目详情。编辑完成后，请务必单击 Save 按钮。请注意以下事项：

  • 编辑项目键：这不是一项简单的任务。在编辑项目键之前，请阅读此页面：编辑项目键。
  • 在项目描述中使用“Wiki Style Renderer”：您可以使用 Wiki Style Renderer 在项目描述中显示更丰富的文本格式 (HTML)。
  • 选择项目图标：如果您不想使用项目图标，可以上传透明像素。这实际上会加载透明像素，也就是说您不会看到图片。

关于项目大类：

可以通过 > Projects > Project Categories 查看/创建大类。

大类为何有用？JIRA 可以搜索特定项目大类中的所有事务（例如高级搜索中的 category = "buildeng"），还可以显示按项目大类排序的项目。一个 JIRA 项目只能属于一个大类。请注意，项目大类不属于项目层级结构。此外，JIRA 不支持子项目或父项目。

事务类型

JIRA 可以通过使用不同的事务类型来跟踪不同类型的事务：缺陷、任务、客服中心问题单等。您还可以将每个事务类型配置为以不同的方式进行操作，例如，遵循不同的流程或跟踪不同的信息。

单击左侧菜单中的 Issue Types 或其中任一事务类型，例如Bug、Task、Story 等。

  • Issue Types：单击此选项可配置适用于该项目的事务类型（选择一个事务类型模型或编辑现有模型）。此外，您还可以为项目中的事务类型配置工作流、字段和屏幕，但通过单击任一事务类型来执行这一操作更为简单。
  • 任一事务类型（例如“Bug”、“Task”、“Story”）：单击此选项可为项目中的事务类型配置工作流/屏幕。工作流屏幕（Workflow 选项卡）会显示工作流设计器。屏幕（View 选项卡）会显示屏幕设计器。

工作流

您的 JIRA 事务可以遵循反映您团队实践的流程。工作流定义了事务将要遵循的步骤（或状态）的顺序，例如“Open”、“In Progress”、“Resolved”。您可以配置事务在不同状态之间转换的方式，例如，谁可以执行转换、在什么条件下、每次转换将显示哪个屏幕。

  • 工作流模型 — 项目的工作流模型确定了哪些工作流（事务状态转换）适用于该项目中的事务类型。

屏幕

借助 JIRA，您可以通过定义屏幕在特定时间显示特定的事务信息。屏幕就是字段的集合。您可以配置当事务被创建、被查看、被修改，抑或经由工作流的特定步骤进行状态转换的时候，什么屏幕将会被显示。

  • 屏幕模型 — 项目的屏幕模型确定了对于不同的事务操作（查看、编辑、创建），应该显示哪些屏幕；
    或
  • 事务类型屏幕模型 — 项目的事务类型屏幕模型确定了对于不同事务类型的不同事务操作（查看、编辑、创建），应该显示哪些屏幕。

字段

您可以使用 JIRA 来定义字段行为：每个字段都可以是必填/可选、丰富格式文本/纯文本、隐藏/可见的。您可以通过使用字段配置来定义此行为。

  • 字段配置模型 — 项目的字段配置模型确定了将哪种字段配置应用于该项目中的事务类型。（字段配置确定了每个字段的整体可见性、必填性、格式 [wiki/丰富格式文本或纯文本] 和帮助文本）。

设置

  • 应用链接（配置项目链接）— 如果您已将 JIRA 实例与其他 Atlassian 应用（如 Confluence、FishEye 或其他 JIRA 实例）相关联，就可以将此 JIRA 项目与这些应用中包含您的项目或团队相关信息的区域关联起来，例如，Confluence 空间、FishEye 代码库、JIRA 项目（位于其他 JIRA 实例中），等等。您从而可以利用这些应用之间的集成点。请参见 Using AppLinks to link to other applications，了解有关应用链接和项目链接的信息。

角色

不同的人可能会在不同的项目中扮演不同的角色 — 同一个人可能是一个项目的领导者，却是另一个项目的观察者。借助 JIRA，您可以将特定人员分配给项目中的特定角色。

  • 项目负责人 — 担当项目负责人角色的用户。被用作“默认经办人”（除了该选项被设为“Unassigned”的 JIRA Software 项目外），并且可存在于 JIRA 的其他部分（例如权限模型、通知模型，事务安全模型和工作流）中。
  • 默认经办人 — 此项目中的事务在创建时，最初指派给的用户。可以是“项目负责人”（如上所述），或者，如果 JIRA 常规配置中的 Allow unassigned issues 被设置为“On”，则默认经办人为“Unassigned”。还有默认组件经办人。
    (info)默认情况下，新项目也会将其“默认经办人”设置为“Unassigned”。如果您要将其设置为特定角色（即“项目负责人”），可在此处进行变更。
  • 项目角色 — 成员是履行该项目特定功能的用户/群组。项目角色用于权限模型、通知模型、事务安全模型和工作流。

版本

您可以通过将事务分配给不同版本，将其在 JIRA 中分组。例如，如果您使用 JIRA 来管理产品的开发或房屋的建造，可能需要定义不不同的版本，以帮助跟踪哪些事务与产品或房屋建造的不同阶段相关（例如 1.0、1.1、1.2、2.0、2.0.1）。JIRA 可以帮助您管理、发布和归档版本。版本还可以具有发布日期，如果在此日期过去时版本仍未发布，将自动突出显示为“逾期”。

  • 版本 — 项目中定义的版本。请参见版本管理页面了解详情。

组件

您可能需要定义不同的组件来分类和管理不同的事务。例如，对于软件开发项目，您可以定义名为“数据库”、“可用性”、“文档”的组件（请注意，事务可以属于多个组件）。您可以为每个组件选择一个默认经办人，如果您在项目中指派了不同的人员领导不同的子团队，这一点将非常有用。

  • 组件 — 该项目的事务可以分属其中的逻辑群组。请参见组件管理页面了解详情。

权限

借助 JIRA，您可以通过使用项目权限来控制哪些用户可以访问您的项目，以及他们具体可以做些什么（例如“解决事务”、“评论事务”、“指派事务”）。您还可以通过使用安全级别来控制对单个事务的访问。您可以选择授予特定用户、群组或角色的访问权限（请注意，角色通常最容易管理）。

  • 权限模型 — 项目的权限模型确定了哪些用户有权查看或变更项目中的事务。
  • 安全事务模型 — 项目的事务安全模型确定了该项目中的事务可拥有的可见性级别。

通知

JIRA 可在您的项目中发生特定事件（例如“事务已创建”、“事务已解决”）时通知相关人员。当不同的事件发生时，您可以选择特定的个人、群组或角色来接收电子邮件通知。（请注意，角色通常最容易管理。）

  • 通知模型 — 项目的通知模型确定了由哪些用户来接收有关该项目中事务变更的电子邮件通知。

  • 电子邮件 — 为该项目发送的电子邮件指定“发件人”地址。仅在 JIRA 中配置了 SMTP 电子邮件服务器时才可用。

(warning)请注意，默认情况下，默认通知模型（随 JIRA 提供）与所有新项目相关联。这意味着如果您设置了传出 (SMTP) 电子邮件服务器，那么电子邮件通知将在新项目中发生任何活动（例如事务已创建）时立即发送。 

开发工具

“开发工具”部分仅在 JIRA Software 项目中提供，且仅供 JIRA Software 用户查看。它会列示出连接的开发工具，以及哪些用户可以使用这些工具之间的集成功能：

  • 查看权限 — 这部分列出了哪些用户可以在查看事务屏幕上看到开发工具集成功能（如 Create Branch 链接），以及其他与开发相关的信息，如提交、审查和构建信息。此功能由“View Development Tools”项目权限控制。
  • 应用 - 这部分显示哪些开发工具通过“应用”链接与 JIRA 关联、哪些可使用 JIRA 中的开发工具功能。

关于项目管理员的说明

JIRA 中的项目管理员拥有特定于项目的 Administer Projects 项目权限，但不一定拥有 JIRA Administrator 全局权限。

但是，尽管没有 JIRA Administrator 全局权限，项目管理员仍可执行以下操作：

  • 编辑项目名称
  • 编辑项目描述
  • 编辑项目图标图片
  • 编辑项目 URL
  • 编辑项目负责人
  • 编辑项目角色成员资格
  • 变更项目类型
  • 定义项目组件
  • 定义项目版本
  • 查看但不选择或编辑项目的模型（通知模型、权限模型等）

 要更改 JIRA 项目的项目类型，必须具有  JIRA Administrator  全局权限。