电子邮件通知
通知使您可以随时了解 GitCode 中发生的事情,启用通知后,您可以接收有关 Issue、合并请求和 Epic 活动的更新,通知将通过电子邮件发送。
接收通知
您将由于以下原因之一收到通知:
- 您参与 Issue、合并请求或 Epic,在这种情况下, 参与意味着评论或编辑
- 您在 Issue、合并请求或 Epic 中启用了通知。要启用通知,请单击侧栏中的通知切换至开
启用通知后,您将收到有关该 Issue、合并请求或 Epic 中发生的操作的通知。
注意: 通知可能会被管理员阻止,从而阻止发送通知。
调整你的通知
通知的数量可能是巨大的,GitCode 允许您调整收到的通知。例如,您可能希望收到有关特定项目中所有活动的通知,而对于其他项目,仅当您的名字被提及时才得到通知。
您可以通过组合通知设置来调整收到的通知:
编辑通知设置
编辑通知设置:
- 点击您的个人资料图片,然后选择设置
- 点击左侧边栏中的通知
- 编辑所需的通知设置,编辑的设置将自动保存并启用
这些通知设置仅适用于您,它们不会影响同一项目或组中其他任何人收到的通知。
全局通知设置
全局通知设置是默认设置,除非您为项目或组选择不同的值:
- 通知电子邮件
- 这是您的通知将发送到的电子邮件地址
- 全局通知级别
- 这是适用于所有通知的默认通知级别
- 接收有关您自己的活动的通知
- 如果您想接收有关自己活动的通知,请选中此复选框。 默认值:未选中
通知范围
您可以通过为每个项目和组选择不同的通知级别来调整通知的范围。
通知范围按优先级顺序应用(从高到低):
- 项目
- 对于每个项目,您可以选择一个通知级别,您的项目设置将覆盖组设置
- 组织
- 对于每个组,您可以选择一个通知级别,您的群组设置会覆盖您的默认设置
- 全局(默认)
- 如果尚未为发生活动的项目或组选择通知级别,则将应用全局或默认通知级别
项目通知
您可以为每个项目选择一个通知级别,如果您需要密切监视选定项目中的活动,这将很有用。
要为项目选择通知级别,请使用以下两种方法之一:
- 点击您的个人资料图片,然后选择设置
- 点击左侧边栏中的通知
- 在项目部分中找到该项目
- 选择所需的通知级别
或者:
- 导航到项目页面
- 单击带有下拉图标的通知下拉列表
- 选择所需的通知级别
组织通知
您可以为每个组织选择通知级别和电子邮件地址。
组织通知级别
要为组选择通知级别,请使用以下两种方法之一:
- 点击您的个人资料图片,然后选择设置
- 点击左侧边栏中的通知
- 在组部分中找到该项目
- 选择所需的通知级别
- 导航到组的页面
- 单击带有下拉图标的通知下拉列表
- 选择所需的通知级别
组织通知邮件地址
您可以选择一个电子邮件地址,以接收您所属的每个组的通知。例如,如果您是自由职业者,并且希望将有关客户项目的电子邮件分开存放,这可能会很有用。
- 点击您的个人资料图片,然后选择设置
- 点击左侧边栏中的通知
- 在组织部分中找到该项目
- 选择所需的电子邮件地址
通知级别
对于每个项目和组织,您可以选择以下级别之一:
级别 | 描述 |
---|---|
全局 | 您的全局设置适用 |
关注 | 接收任何活动的通知 |
提及 |
@mentioned 在评论中@mentioned 接收通知 |
参与 | 接收有关您参与的线程的通知 |
停用 | 关闭通知 |
自定义 | 接收有关自定义选定事件的通知 |
通知事件
将通知用户以下事件:
事件 | 发给 | 设定等级 |
---|---|---|
添加了新的 SSH 密钥 | User | 安全电子邮件,始终发送 |
添加了新电子邮件 | User | 安全电子邮件,始终发送 |
电邮已变更 | User | 安全电子邮件,始终发送 |
密码已更改 | User | 安全电子邮件,始终发送 |
用户已添加到项目 | User | 将用户添加到项目时发送 |
项目访问权限级别已更改 | User | 更改用户项目访问级别时发送 |
用户已添加到组 | User | 将用户添加到组时发送 |
群组访问权限级别已更改 | User | 更改用户组访问级别时发送 |
项目已移 | 项目成员(1) | (1)不禁用 |
新品发布 | 项目成员 | 自定义通知 |
Issue / Epic / 合并请求活动
在以下大多数情况下,通知将发送到:
- 参与:
- 发行/合并请求的作者和受让人
- 关于问题/合并请求的评论的作者
-
@username
在问题,合并请求或史诗的标题或描述中提到的任何人 -
@username
在有关问题,合并请求或史诗的任何评论中提及的"参与"或更高通知级别的任何人
- 观察者:通知级别为"观察"的用户
- 订阅者:手动订阅问题,合并请求或史诗的任何人
- 自定义:通知级别为"自定义"的用户针对下表中显示的任何事件打开了通知
Event | 发给 |
---|---|
新问题 | |
结束期 | |
重新分配问题 | 以上,加上旧的受让人 |
重新打开问题 | |
到期问题 | 选择此事件的参与者和自定义通知级别 |
更改里程碑问题 | 选择了此事件的订户,提及的参与者和自定义通知级别 |
消除里程碑问题 | 选择了此事件的订户,提及的参与者和自定义通知级别 |
新合并请求 | |
推送合并请求 | 选择此事件的参与者和自定义通知级别 |
重新分配合并请求 | 以上,加上旧的受让人 |
关闭合并请求 | |
重新打开合并请求 | |
合并合并请求 | |
更改里程碑合并请求 | 选择了此事件的订户,提及的参与者和自定义通知级别 |
删除里程碑合并请求 | 选择了此事件的订户,提及的参与者和自定义通知级别 |
新评论 | 以上内容,加上评论中@username 提及的任何人,通知级别为"提及"或更高 |
新史诗 | |
接近史诗 | |
重新开启史诗 |
此外,如果发布或合并请求的标题或描述发生了更改,则通知将通过@username
发送到任何新提及的内容,就像在原始文本中提到的一样。
您不会收到有关您自己创建的问题,合并请求或里程碑的通知(除非由于问题而定)。仅当其他人对您创建或提及的内容进行评论或添加更改时,您才会收到自动通知。
如果开放的合并请求由于冲突而变得不可合并,则将通知其原因。
过滤 email
通知电子邮件包括特定于 GitCode 的标题。您可以根据这些标头的内容过滤通知电子邮件,以更好地管理您的通知。 例如,您可以过滤特定项目的所有电子邮件,在该项目中您将被分配合并请求或问题。
下表列出了所有特定于 GitCode 的电子邮件标题:
标题 | 描述 |
---|---|
X-GitLab-Group-Id |
组的 ID,仅在史诗的通知电子邮件中显示 |
X-GitLab-Group-Path |
组的路径,仅在史诗的通知电子邮件中显示 |
X-GitLab-Project |
通知所属的项目的名称 |
X-GitLab-Project-Id |
项目的 ID |
X-GitLab-Project-Path |
项目的路径 |
X-GitLab-(Resource)-ID |
通知所针对的资源的 ID,该资源例如可以是Issue , MergeRequest , Commit 或其他此类资源 |
X-GitLab-Discussion-ID |
注释所属的线程的 ID,用于注释的通知电子邮件中 |
X-GitLab-Pipeline-Id |
通知所针对的管道的 ID,在管道的通知电子邮件中. |
X-GitLab-Reply-Key |
支持通过电子邮件回复的唯一令牌 |
X-GitLab-NotificationReason |
通知原因. 可以mentioned , assigned 或own_activity
|
List-Id |
The path of the project in an RFC 2919 mailing list identifier. This is useful for email organization with filters, for example |
X-GitLab-NotificationReason
X-GitLab-NotificationReason
标头包含X-GitLab-NotificationReason
的原因,该值是按优先级顺序的以下值之一:
own_activity
assigned
mentioned
通知的原因也包含在通知电子邮件的页脚中, 例如有原因的电子邮件assigned
都会有这句话的注脚:
You are receiving this email because you have been assigned an item on <configured GitLab hostname>.
**注意:**正在考虑将其他事件的通知包含在X-GitLab-NotificationReason
标头中,有关详细信息,请参见此相关问题