设置E-mail的外部通知

介绍邮件外部通知的设置。
要将Garoon以外的系统发出的通知邮件作为通知处理时,需要此设置。
设置后,Garoon可将来自Garoon以外的系统的通知邮件识别为来自安全系统的邮件。
收到通知邮件后,在用户的“邮件”页面中将显示“已收到n条外部通知。”。

E-mail页面的图片

收到的通知将显示在“通知列表”组件和“通知列表”页面中。不显示在“邮件”页面中。

通知列表组件的图片

以下情况下,通知邮件将被处理为邮件:

  • 未设置邮件外部通知。
  • 邮件外部通知中设置的信息与通知邮件的header信息不匹配。
  • 用户设置不使用外部通知。

添加邮件外部通知

添加邮件外部通知。

操作步骤:
  1. 点击页眉处齿轮状的管理员菜单图标。

  2. 点击[Garoon系统管理]。

  3. 选择“各应用程序的管理”标签页。

  4. 点击[通知列表]。

  5. 点击[外部通知的设置]。

  6. 在“设置外部通知”页面中,点击[添加外部通知]。

    用红色边框圈出添加外部通知的操作链接的图片

  7. 在“添加外部通知”页面中,在“允许外部通知”项目中,勾选“E-mail”复选框。

    用红色边框圈出邮件的图片

  8. 输入“外部通知代码”项目。

    必须设置外部通知代码。
    外部通知代码是用于识别外部通知的唯一代码。
    该代码必须与通知邮件的"X-Cybozu-Notify-App-Name"header中指定的字符串一致。
    详情请参考邮件外部通知处理所需的header
    外部通知代码的输入框的图片

  9. 在“显示名称”项目中,输入外部通知的显示名称。

    必须设置显示名称。
    显示名称的输入框的图片
    设置的名称将用于“通知列表”组件和“通知列表”页面中显示的应用程序名称。
    通知列表页面的图片

  10. 在“许可URL”项目中,输入通知的链接URL。

    必须设置许可URL。
    每行输入一个。可使用通配符“*”。
    必须与通知邮件的"X-Cybozu-Notify-App-URL"header中指定的URL一致。
    如果要设置通知图标,还需输入通知图标的 URL。
    详情请参考邮件外部通知处理所需的header
    许可URL的输入框的图片

  11. 在“状态”项目中,选择“有效”。

    用红色边框圈出有效的单选按钮的图片

  12. 确认设置内容,点击[添加]。

处理邮件外部通知所需的header

邮件外部通知的式样为在通知的显示中显示通知中的信息。

通知列表组件的图片

a) :标题

b) :内容

c) :发件人姓名

d) :接收时间

在来自Garoon以外的系统的通知邮件的header中设置以下信息:"X-Cybozu-Notify-App-Name"和"X-Cybozu-Notify-App-URL"是必填项。必须设置。
header名称 概要 说明
X-Cybozu-Notify-App-Name 外部通知代码 设置外部通知代码的header。
设置不区分全角半角。
X-Cybozu-Notify-App-Ver 产品版本 用于设置产品版本信息的header。
用于管理版本信息。
X-Cybozu-Notify-App-UniqueID 通知的识别 ID 用于设置通知的识别ID的header。
通知的识别ID将用于检查重复通知。
如果有重复的通知,将根据E-mail的发送时间(设置为“X-Cybozu-Notify-Date”时,优先“X-Cybozu-Notify-Date”的时间),覆盖最新的通知。
省略此header时,将使用“X-Cybozu-Notify-App-URL”(目标 URL)中设置的字符串作为识别 ID。
X-Cybozu-Notify-App-URL 目标 URL 用于设置通知链接到的 URL 的header。
如果通知邮件中未设置"X-Cybozu-Notify-App-UniqueID",则此header中设置的字符串将成为通知的识别ID。此时"*"之后的字符串将被忽略。
X-Cybozu-Notify-Date 接收时间 用于设置接收时间的header。在比较新旧通知时使用。
如果识别ID重复的通知已显示在最新信息中,则优先接收时间较新的通知。
省略此header时,邮件header"Date"将成为接收时间。
X-Cybozu-Notify-Name 发件人姓名 用于设置通知的发件人姓名的header。
省略此header时,邮件header"From"将成为通知的发件人姓名。
X-Cybozu-Notify-Subject 標題 用于设置通知标题的header。
省略此header时,邮件header"Subject"将成为通知的标题。
X-Cybozu-Notify-Abstract 内容 用于设置通知内容的header。
省略此header时,邮件的正文将成为通知的内容。
X-Cybozu-Notify-Version 通知邮件版本 用于设置通知版本的header。
X-Cybozu-Notify-Icon-URL 图标 URL 通知图标的 URL。
省略时,邮件外部通知的内置地球图标将被设置为通知图标。
如果要另外创建图标,建议图标大小为“20*20”。

通知邮件的格式

来自Garoon以外的系统的通知邮件请设置为以下格式:

项目
Content-Type text/plain
charset JIS(iso-2022-jp)、us-ascii
Content-Transfer-Encoding 7bit、base64、quote-printable

用户进行的设置

邮件外部通知的处理方式由用户设置。
初始设置为来自Garoon以外的系统的通知邮件作为通知处理。
如果要作为邮件处理,请要求用户更改设置。详情请参考外部通知的使用

更改邮件外部通知

更改邮件外部通知的设置。

操作步骤:
  1. 点击页眉处齿轮状的管理员菜单图标。

  2. 点击[Garoon系统管理]。

  3. 选择“各应用程序的管理”标签页。

  4. 点击[通知列表]。

  5. 点击[外部通知的设置]。

  6. 在“外部通知的设置”页面中,点击要更改的邮件外部通知的外部通知代码。

  7. 在“外部通知的详情”页面中,点击[更改]。

    用红色边框圈出变更的操作链接的图片

  8. 在“更改外部通知”页面中,设置所需的项目。

  9. 确认设置内容,点击[更改]。

删除邮件外部通知

删除邮件外部通知。
来自Garoon以外的系统的通知邮件,如外部通知被删除,将作为邮件处理。
删除邮件外部通知的设置,不会删除已收到的通知。但将无法筛选“通知列表”组件和“通知列表”页面中的通知。

逐个删除邮件外部通知

一次删除一个邮件外部通知。

操作步骤:
  1. 点击页眉处齿轮状的管理员菜单图标。

  2. 点击[Garoon系统管理]。

  3. 选择“各应用程序的管理”标签页。

  4. 点击[通知列表]。

  5. 点击[外部通知的设置]。

  6. 在“设置外部通知”页面中,点击要删除的邮件外部通知的外部通知代码。

  7. 在“外部通知的详情”页面中,点击[删除]。

    用红色边框圈出删除的操作链接的图片

  8. 在“删除外部通知”页面中,点击[是]。

批量删除多个邮件外部通知

选择要删除的邮件外部通知,批量删除。

操作步骤:
  1. 点击页眉处齿轮状的管理员菜单图标。

  2. 点击[Garoon系统管理]。

  3. 选择“各应用程序的管理”标签页。

  4. 点击[通知列表]。

  5. 点击[外部通知的设置]。

  6. 在“设置外部通知”页面中,选中要删除的邮件外部通知的复选框,然后点击[删除]。

    用红色边框圈出删除按钮的图片

  7. 在“批量删除外部通知”页面中,点击[是]。