Skip to content

帮助文档
帮助文档

GitCode / 帮助文档

通知 1756
Star 576
Fork 455
帮助文档
帮助文档

前往新版Gitcode，体验更适合开发者的 AI 搜索 >>

提交 7e95325c 编写于 作者: Lab机器人's avatar Lab机器人
浏览文件
操作

sorted_issue

上级 b3304897
隐藏空白更改
内联 并排
Showing with 63 addition and 176 deletion
.DS_Store
浏览文件 @ 7e95325c
无法预览此类型文件
docs/.DS_Store
浏览文件 @ 7e95325c
无法预览此类型文件
docs/user/project/issues/due-date.md
浏览文件 @ 7e95325c
......@@ -13,7 +13,7 @@
* `/due <date>` ：设置到期日， 有效的`<date>`示例包括`in 2 days` 、`this Friday`和`December 31st`
* `/remove_due_date` ：删除到期日
## 利用好截止日期[](#making-use-of-due-dates "Permalink")
## 截止日期的用法[](#making-use-of-due-dates "Permalink")
设置了截止日期的 Issue 可以在 Issue 跟踪器中轻松查看到，并在它们旁边显示了截止日期，日期过期的 Issue 会将图标和日期显示为红色。您可以从右侧的下拉菜单中按截止日期倒叙/顺序对 Issue 进行排序。
......
docs/user/project/issues/manage.md
浏览文件 @ 7e95325c
# 管理Issue[](#管理Issue "Permalink")
# 管理 Issue[](#managing-issues "Permalink")
[GitLab 问题](index.html)是在[GitLab](index.html)中就想法和计划工作进行协作的基本介质. [创建](#create-a-new-issue) ， [移动](#moving-issues) ， [关闭](#closing-issues)和[删除](#deleting-issues)是可以解决问题的关键操作.
Issue 是通过想法和计划进行协工作的基本要素。 [创建](#create-a-new-issue) ， [移动](#moving-issues) ， [关闭](#closing-issues)和[删除](#deleting-issues) Issue 是 Issue 中的关键操作。
## Create a new issue[](#create-a-new-issue "Permalink")
## 创建 Issue[](#create-a-new-issue "Permalink")
创建新问题时，系统将提示您填写问题的[数据和字段，](issue_data_and_actions.html)如下所示. 如果知道要分配给问题的值，则可以使用" [快速操作"](../quick_actions.html)功能输入值，而不用从列表中选择它们.
创建新 Issue 时，系统将提示您填写 Issue 的[数据和字段](issue_data_and_actions.html)，如下所示。如果您清楚要分配给Issue 的值，则可以使用" [快速操作"](../quick_actions.html)功能输入相应的内容，而不用从列表中选择它们。
创建问题时，您可以使用**Epic**下拉列表将其与当前组中的现有史诗相关联.
### 获取新建 Issue 的表单[](#accessing-the-new-issue-form "Permalink")
### Accessing the New Issue form[](#accessing-the-new-issue-form "Permalink")
有多种方法可以从项目中获取"新建 Issue"表单：
有多种方法可以从项目中获取"新问题"表单：
* 进入**项目** > ** Issue** > **新建 Issue** ：
* 从项目中**未解决的 Issue**中，点击**新建 Issue**以在同一项目中创建一个新的 Issue
* 在**项目的仪表板中** ，单击加号（ **+** ）打开带有一些选项的下拉菜单，选择**新建 Issue**以在该项目中创建一个 Issue：
* 在**看板**中，通过单击列表顶部的加号（ **+** ）创建新 Issue，将新建一个带有对应标签的 Issue
* 导航到**项目的仪表板** > **问题** > **新问题** ：
### 认识新建 Issue 的表单[](#elements-of-the-new-issue-form "Permalink")
[![New issue from the issue list view](img/ee0396a1cb32367d7ba7c6f4a7262c7f.png)](img/new_issue_from_tracker_list.png)
[![New issue from the issues list](/../../docs/img/new_issue_v13_2.png)](img/new_issue_v13_2.png)
* 从项目中未**解决的问题**中，单击**"**新问题"以在同一项目中创建一个新问题：
创建新 Issue 时，可以填写以下字段：
[![New issue from an open issue](img/eb851fa4a367081c86d0a2eac3bdca65.png)](img/new_issue_from_open_issue.png)
1. **标题**
2. **描述**
3. **问题机密性设置**
4. **指派人**
5. **截止日期**
6. **里程碑**
7. **标记**
* 在**项目的仪表板中** ，单击加号（ **+** ）以打开带有一些选项的下拉菜单. 选择" **新问题"**以在该项目中创建一个问题：
## 移动 Issue[](#moving-issues "Permalink")
[![New issue from a project's dashboard](img/04b61606f38fddf21d194ee3e13abaa3.png)](img/new_issue_from_projects_dashboard.png)
移动 Issue 会将其复制到新位置（项目），并在旧项目中将其关闭，但不会被删除。这两个 Issue 上还将添加一个系统注释，以指示它来自何处。
* 在**发行板中** ，通过单击列表顶部的加号（ **+** ）创建新发行. 它为该项目打开了一个新问题，并预先标记了各自的列表.
移动 Issue 的按钮位于 Issue 详情页右侧最底部。
[![From the issue board](img/7f1a1847005ab07ba8259a9e67005213.png)](img/new_issue_from_issue_board.png)
## 关闭 Issue[](#closing-issues "Permalink")
### Elements of the New Issue form[](#elements-of-the-new-issue-form "Permalink")
当您确定 Issue 已解决或不再需要解决时，可以使用"关闭"按钮关闭该 Issue。
> 在[GitLab Premium](https://about.gitlab.com/pricing/) 13.1 中[引入](https://gitlab.com/gitlab-org/gitlab/-/issues/13847)了将新版本添加到史诗的功能.
您还可以通过在看板中将从其拖放到**已关闭**列表中来**关闭** Issue。
[![New issue from the issues list](img/94be136c7407855701b88eaded7db929.png)](img/new_issue_v13_1.png)
### 自动关闭 Issue[](#closing-issues-automatically "Permalink")
创建新期刊时，可以填写以下字段：
**注意：**由于性能原因，从现有代码仓库的第一次推送将禁用自动关闭 Issue 功能。
* Title
* Description
* 复选框以使问题保密
* Assignee
* Weight
* Epic
* 截止日期
* Milestone
* Labels
当提交或合并请求解决了一个或多个 Issue 时，在将提交或合并请求推送到项目的默认分支时将会自动关闭这些 Issue。
### New issue from the group-level Issue Tracker[](#new-issue-from-the-group-level-issue-tracker "Permalink")
如果提交消息或合并请求描述包含与[定义的模式](#default-closing-pattern)相匹配的文本，则匹配文本中引用的所有 Issue 均将被关闭。将提交推送到项目的[**默认**分支时](../repository/branches/index.html#default-branch) ，或者将提交或合并请求合并到默认分支时，Issue 就会自动关闭。
转到"小组"仪表板，然后单击侧边栏中的" **问题** "以访问"小组"中所有项目的问题跟踪器. 使用页面右上方的下拉按钮，选择要添加问题的项目.
例如，如果合并请求描述中包含`Closes #4, #6, Related to #5`，则合并合并请求时问题`#4`和`#6`将自动关闭，但不会合并`#5`，只会将其标记为[相关 Issue](related_issues.html) ，但不会自动关闭。
[![Select project to create issue](img/31f0a42465a379e152ef6c0c7a6395e9.png)](img/select_project_from_group_level_issue_tracker.png)
如果 Issue 与 合并请求位于不同的代码仓库中，则需要提供完整的 Issue URL地址：
我们将跟踪您最近选择的项目，并将其用作下次访问的默认项目. 如果您主要是为同一项目创建问题，这应该可以节省大量时间和点击次数.
[![Create issue from group-level issue tracker](img/75ca9285f50e058d4d85796b4d0b8e69.png)](img/create_issue_from_group_level_issue_tracker.png)
### New issue via Service Desk[](#new-issue-via-service-desk-starter "Permalink")
为您的项目启用[Service Desk](../service_desk.html)并提供电子邮件支持. 这样，当您的客户发送新电子邮件时，可以在适当的项目中创建一个新的问题，然后从那里进行后续操作.
### New issue via email[](#new-issue-via-email "Permalink")
如果您的 GitLab 实例配置了[传入电子邮件](../../../administration/incoming_email.html) ，则在项目的" **问题列表"**页面的底部会显示**一个"将新问题发送到该项目的电子邮件** "链接.
[![Bottom of a project issues page](img/fd1e35952a7538923376d54325798b24.png)](img/new_issue_from_email.png)
当您单击此链接时，将生成并显示一个电子邮件地址，该电子邮件地址**仅供您自己使用** ，以在此项目中创建问题. 您可以将此地址另存为联系人，以方便访问.
**注意：**这是一个私人电子邮件地址，仅为您生成. **保密** ，因为任何知道它的人都可以创建问题或合并请求，就好像它们是您一样. 如果地址被盗用，或者您出于任何原因希望重新生成该地址，请再次单击"通过**电子邮件将新问题发送到此项目"** ，然后单击"重置"链接.
向该地址发送电子邮件将以您的名字在此项目中创建一个新问题，其中：
* The email subject becomes the issue title.
* 电子邮件正文成为问题描述.
* 支持[降价](../../markdown.html)和[快速行动](../quick_actions.html) .
**注意：**在 GitLab 11.7 中，我们更新了生成的电子邮件地址的格式. 但是，仍支持较旧的格式，从而允许现有别名或联系人继续工作.
### New issue via URL with prefilled fields[](#new-issue-via-url-with-prefilled-fields "Permalink")
您可以使用 URL 中的查询字符串参数，使用预填充的字段值直接链接到给定项目的新问题页面. 这对于在外部 HTML 页面中嵌入 URL 以及在某些情况下（希望用户创建带有预填某些字段的问题）很有用.
标题，描述，描述模板和机密字段可以使用此方法进行预填充. 您不能在同一 URL 中预先填写描述和描述模板字段（因为描述模板也会填充描述字段）.
| Field | URL 参数名称 | Notes |
| --- | --- | --- |
| title | `issue[title]` |   |
| description | `issue[description]` |   |
| 描述模板 | `issuable_template` |   |
| confidential | `issue[confidential]` | 参数值必须为`true`才能设置为机密 |
请按照以下示例使用预填字段来形成新的问题 URL.
* 对于 GitLab 社区版项目中的新问题，带有预填充的标题和预填充的描述，URL 为`https://gitlab.com/gitlab-org/gitlab-foss/-/issues/new?issue[title]=Validate new concept&issue[description]=Research idea`
* 对于 GitLab 社区版项目中的新问题，带有预填充的标题和预填充的描述模板，URL 为`https://gitlab.com/gitlab-org/gitlab-foss/-/issues/new?issue[title]=Validate new concept&issuable_template=Research proposal`
* 对于 GitLab 社区版项目中的新问题，其中包含预填充的标题，预填充的描述以及机密标志集，其 URL 为`https://gitlab.com/gitlab-org/gitlab-foss/-/issues/new?issue[title]=Validate new concept&issue[description]=Research idea&issue[confidential]=true`
## Moving Issues[](#moving-issues "Permalink")
移动问题会将其复制到新位置（项目），并在旧项目中将其关闭，但不会被删除. 这两个问题上还将添加一个系统注释，以指示它来自何处.
The “Move issue” button is at the bottom of the right-sidebar when viewing the issue.
[![move issue - button](img/1bc92f79d9645e6ae51aff10100e5c0d.png)](img/sidebar_move_issue.png)
### Moving Issues in Bulk[](#moving-issues-in-bulk "Permalink")
如果您具有高级技术技能，也可以在 Rails 控制台中将所有问题从一个项目批量转移到另一个项目. 下面的脚本会将所有问题从一个项目移至另一个状态尚未**关闭的项目** .
要访问 rails 控制台，请在 GitLab 服务器上运行`sudo gitlab-rails console`并运行以下脚本. 请确保将**project** ， **admin_user**和**target_project**更改为您的值. 我们也建议您在尝试对控制台进行任何更改之前先[创建备份](../../../raketasks/backup_restore.html#back-up-gitlab) .
```
project = Project.find_by_full_path('full path of the project where issues are moved from')
issues = project.issues
admin_user = User.find_by_username('username of admin user') # make sure user has permissions to move the issues
target_project = Project.find_by_full_path('full path of target project where issues moved to')
issues.each do |issue|
if issue.state != "closed" && issue.moved_to.nil?
Issues::MoveService.new(project, admin_user).execute(issue, target_project)
else
puts "issue with id: #{issue.id} and title: #{issue.title} was not moved"
end
end; nil
```markdown
Closes #4, #6, and https://codechina.csdn.net/<username>/<projectname>/issues/<xxx>
```
## Closing issues[](#closing-issues "Permalink")
#### 默认关闭表达式[](#default-closing-pattern "Permalink")
当您确定问题已解决或不再需要时，可以使用"关闭"按钮关闭该问题：
如果未指定，将使用如下所示的表达式来用作默认 Issue 关闭的表达式：
[![close issue - button](img/4635aba96009dfb3ab93ab6f4b92ee4c.png)](img/button_close_issue.png)
您还可以通过将发行卡从其发行版列表中拖放到" **已关闭"**列表中来**关闭** [发行板中](../issue_board.html)的发行.
[![close issue from the Issue Board](img/0f7aab3f307e6b54ebe4d00d94f1da0a.png)](img/close_issue_from_board.gif)
### Closing issues automatically[](#closing-issues-automatically "Permalink")
**注意：**由于性能原因，从现有存储库的第一次推送将禁用自动问题关闭.
当提交或合并请求解决了一个或多个问题时，当提交或合并请求到达项目的默认分支时，可能会自动关闭这些问题.
如果提交消息或合并请求描述包含与[定义的模式](#default-closing-pattern)匹配的文本，则匹配文本中引用的所有问题均将关闭. 将提交推送到项目的[**默认**分支时](../repository/branches/index.html#default-branch) ，或者将提交或合并请求合并到其中时，就会发生这种情况.
例如，如果合并请求描述中包含`Closes #4, #6, Related to #5`则合并 MR 时问题`#4`和`#6`将自动关闭，但不会合并`#5` . 将" `Related to` `#5`标记[相关"](related_issues.html)用作[相关问题](related_issues.html) ，但不会自动关闭.
[![merge request closing issue when merged](img/fee3cc5116f884089066af3908605cbe.png)](img/merge_request_closes_issue.png)
如果问题与 MR 位于不同的存储库中，请添加问题的完整 URL：
```
Closes #4, #6, and https://gitlab.com/<username>/<projectname>/issues/<xxx>
```
#### Default closing pattern[](#default-closing-pattern "Permalink")
如果未指定，将使用如下所示的默认问题关闭模式：
```
```markdown
\b((?:[Cc]los(?:e[sd]?|ing)|\b[Ff]ix(?:e[sd]|ing)?|\b[Rr]esolv(?:e[sd]?|ing)|\b[Ii]mplement(?:s|ed|ing)?)(:?) +(?:(?:issues? +)?%{issue_ref}(?:(?: *,? +and +| *,? *)?)|([A-Z][A-Z0-9_]+-\d+))+)
```
这将匹配以下关键字：
这将转换为以下关键字：
* Close, Closes, Closed, Closing, close, closes, closed, closing
* Fix, Fixes, Fixed, Fixing, fix, fixes, fixed, fixing
* Resolve, Resolves, Resolved, Resolving, resolve, resolves, resolved, resolving
* Implement, Implements, Implemented, Implementing, implement, implements, implemented, implementing
* 关闭，关闭，关闭，关闭，关闭，关闭，关闭，关闭
* 修正，修正，修正，修正，修正，修正，修正，修正
* 解决，解决，解决，解决，解决，解决，解决，解决
* 实施，实施，实施，实施，实施，实施，实施，实施
请注意， `%{issue_ref}`是在源代码中定义的复杂正则表达式，可以匹配对以下内容的引用：
请注意， `%{issue_ref}`是在 GitLab 的源代码中定义的复杂正则表达式，可以匹配对以下内容的引用：
* 本地问题（ `#123` ）.
* 跨项目问题（ `group/project#123` ）.
* 指向问题的链接（ `https://gitlab.example.com/group/project/issues/123` ）.
* 本地 Issue（ `#123` ）.
* 跨项目 Issue（ `group/project#123` ）.
* 指向 Issue 的链接（ `https://gitlab.example.com/group/project/issues/123` ）.
例如以下提交消息：
```
```markdown
Awesome commit message
Fix #20, Fixes #21 and Closes group/otherproject#22.
This commit is also related to #17 and fixes #18, #19
and https://gitlab.example.com/group/otherproject/issues/23.
and https://codechina.csdn.net/group/otherproject/issues/23.
```
将在提交被推送到的项目中关闭`#18` ， `#19` ， `#20`和`#21` ，以及`group/otherproject`项目中`#22`和`#23`，`#17`将不会关闭，因为它与关闭模式不匹配，当从命令行与`git commit -m`一起使用时，它可以处理多行/多行提交消息。
将在提交被推送到的项目中关闭`#18` ， `#19` ， `#20`和`#21` ，以及`group/otherproject` `#22`和`#23` . `#17`将不会关闭，因为它与模式不匹配. 当从命令行与`git commit -m`一起使用时，它可以处理多行提交消息以及单行代码.
#### Disabling automatic issue closing[](#disabling-automatic-issue-closing "Permalink")
在 GitLab 12.7 中[引入](https://gitlab.com/gitlab-org/gitlab/-/issues/19754) .
可以在[项目的存储库设置中](../settings/index.html)针对每个项目禁用自动关闭问题功能. 引用的问题仍将按原样显示，但不会自动关闭.
[![disable issue auto close - settings](img/a3802569c81d8f8dd179fd218322a4ca.png)](img/disable_issue_auto_close.png)
这仅适用于受新合并请求或提交影响的问题. 已经解决的问题仍然保持原样. 禁用自动关闭的问题仅影响到项目*中*的合并请求，并不会阻止其他项目从通过跨项目的问题，将其关闭.
#### Customizing the issue closing pattern[](#customizing-the-issue-closing-pattern-core-only "Permalink")
为了更改默认的问题关闭模式，GitLab 管理员必须编辑安装的[`gitlab.rb`或`gitlab.yml`文件](../../../administration/issue_closing_pattern.html) .
#### 禁用自动关闭 Issue[](#disabling-automatic-issue-closing "Permalink")
## Deleting issues[](#deleting-issues "Permalink")
可以在[项目的设置中](../settings/index.html)禁用项目的自动关闭 Issue 功能。引用的问题仍将按原样显示，但不会自动关闭。
在 GitLab 8.6 中[引入](https://gitlab.com/gitlab-org/gitlab-foss/-/merge_requests/2982)
这仅影响被新合并请求或提交关联的 Issue，已经解决的 Issue 仍然保持原样，禁用自动关闭 Issue 的设置仅影响当前项目中的合并请求，并不会阻止其他项目从通过跨项目的 Issue将其关闭。
具有[项目所有者权限的](../../permissions.html)用户可以通过编辑问题并单击删除按钮来删除问题.
## 删除 Issue[](#deleting-issues "Permalink")
[![delete issue - button](img/51e7561422b1e74237ea14e916cffc78.png)](img/delete_issue.png)
\ No newline at end of file
具有项目 [Owner](../../permissions.html) 权限的用户可以通过编辑 Issue 并单击删除按钮来删除 Issue。
docs/user/project/issues/sort.md
浏览文件 @ 7e95325c
# Issue排序[](#Issue排序 "Permalink")
# Issue 排序[](#Issue排序 "Permalink")
您可以通过多种方式对问题列表进行排序，包括按问题创建日期，里程碑到期日期等进行排序.可用的排序选项可以根据列表的上下文进行更改. 有关按发布优先级排序的信息，请参见[标签优先级](../labels.html#label-priority) .
您可以通过多种方式对 Issue 列表进行排序，包括按 Issue 创建日期、里程碑、截止日期等进行排序。可用的排序选项可以根据列表的上下文进行更改。有关按发布优先级排序的信息，请参见[标签优先级](../labels.html#label-priority)。
在组和项目问题清单中，也可以手动订购问题，类似于[问题委员会](../issue_board.html#issue-ordering-in-a-list) .
在项目的 Issue 列表清单中，也可以手动对 Issue 进行排序，类似于看板中的手动排序。
## Manual sorting[](#manual-sorting "Permalink")
## 手动排序[](#manual-sorting "Permalink")
在 GitLab 12.2 中[引入](https://gitlab.com/gitlab-org/gitlab-foss/-/issues/62178) .
选择**手动**排序时，可以通过拖放移动 Issue 来更改顺序，更改后的排序自动保留。除了某些个别情况外，访问同一列表的每个人都将看到重新排序的 Issue 列表。
选择" **手动**排序"时，可以通过拖放问题来更改顺序. 更改后的订单将保留. 除了某些例外，访问同一列表的每个人都将看到重新排序的列表.
每个 Issue 都分配有一个相对顺序值，代表其相对于列表中其他 Issue 的相对顺序，当您拖放 Issue 并重新排序时，其相对顺序值也会进行相应地更改。
每个问题都分配有一个相对顺序值，代表其相对于列表中其他问题的相对顺序. 当您拖放问题的重新排序时，其相对顺序值也会相应更改.
此外，任何出现在手动排序列表中的 Issue ，更新后的相对顺序将用于排序。这也意味着，如果您具有相应权限的任何用户将问题`A`拖放到问题`B`上方，则随后将这两个问题在任何列表中（可能是不同的）例如项目 Issue 列表或组织 Issue 列表），都将维持相同的排序。
此外，任何问题出现在手动排序的列表中时，更新的相对订单值将用于订购. 这意味着，如果您的 GitLab 实例内给定列表中的任何用户将问题`A`拖放到问题`B`上方，则随后将这两个问题随后加载到同一实例的任何列表中（可能是不同的）例如项目专案清单或其他群组专案清单），即可维持订购顺序.
此顺序还会影响[发行板](../issue_board.html#issue-ordering-in-a-list) . 更改问题列表中的顺序会更改问题面板中的顺序，反之亦然.
\ No newline at end of file
此顺序还会影响看板中 Issue 的排序，更改 Issue 列表中的顺序会更改看板中的顺序，反之亦然。
\ No newline at end of file
Markdown is supported
0% 或 .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑！
想要评论请 注册 或