您可以以三种基本格式将信息展示给用户:横幅,告警,通知。

横幅

横幅是通知用户关于系统和应用事件的消息。横幅被明显的显示在Magnolia Shell的顶部或底部,能有效的吸引用户的注意,但又不影响用户正在进行的工作。横幅是唯一一个永久的消息类型。用户可以安全的关闭横幅,并稍后在Pulse信息中心中阅读。

行为 

  • 横幅必须由用户来关闭。除非用户点击,否则横幅将一直停留在页面上。
  • 并非按情态显示,不会阻断用户正在进行的工作。
  • 永久性——消息被存储在messages工作区
  • 只有标题和一个可有可无的短描述。消息全文可在Pulse里查看。
  • 点击横幅上的More按钮会在Pulse中打开该消息。
  • 横幅可以显示给当前用户,指定名字的用户,一组用户,或广播给所有用户。

级别

所有消息都有至少以下几种不同的紧急级别,如
$webResourceManager.requireResource("info.magnolia.sys.confluence.artifact-info-plugin:javadoc-resource-macro-resources") MessageType
中的定义一样:
  • ERROR消息报告出现的严重问题。
  • WARNING消息警告用户系统探测到需要用户注意的情况。
  • INFO消息仅仅通知用户一个变化或情况。
  • WORKITEM是一个特殊类型,专为工作流通知准备。

样例

  • 一个错误消息,捕获在应用中出现且不可被预知的例外。(应用发送的ERROR消息)
  • 当特定应用的许可即将过期时,系统就会发送警告了。(应用发送的WARNING消息)
  • 当特定Magnolia实例的许可即将过期时,系统发送警告给管理员。(系统发送的WARNING消息)
  • 特定应用的新版本可用时,管理员会收到通知。(应用发送的INFO消息)
  • 管理员发送实例范围内的消息给所有用户,告知实例将被关闭并在一个小时内重启。(系统应用定义和发送给所有用户的INFO消息)

近似外观


INFO横幅


Pulse的消息列表


WARNING横幅


Pulse里打开的消息全文


ERROR横幅

如何显示

参看显示横幅消息

告警

告警是情态消息,出现在用户当前工作的环境中。您可以使用告警来确认动作是否应该被执行,告诉用户有害的后果,或是报告长时间运行的动作的进度。由于告警是情态性的,它们会阻止用户界面。

(warning) 不要用告警来收集任何用户输入。对于快速输入,您可以使用简捷对话框。简捷对话框可以承载一套小的表单域,仍然与普通对话框类似。对于复杂的输入,使用普通对话框来实现。在呈现调整用户档案里页面属性或设置的表单时,应该使用对话框。如果您需要通过多个步骤来指导用户,您甚至可以使用一个向导对话框。

行为

  • 告警在用户当下工作的环境中显示,离开环境它们则没有意义。
  • 短暂性——告警不会被储存,所以它们不会在Pulse中出现。
  • 由应用、子应用或是Shell应用发送。告警通常源于一个应用内的特定UI元素。
  • 情态性——告警阻止产生它们的UI元素。
  • 专属性——只对引起告警的用户显示,不可被发送给其他用户。
  • 不要用告警收集用户输入,只可用单一按钮回答:是/否,确定/取消。

级别

所有消息都有至少以下几种不同的紧急级别,如
$webResourceManager.requireResource("info.magnolia.sys.confluence.artifact-info-plugin:javadoc-resource-macro-resources") MessageType
中的定义一样:
  • ERROR消息报告出现的严重问题。
  • WARNING消息警告用户系统探测到需要用户注意的情况。
  • INFO消息仅仅通知用户一个变化或情况。
  • WORKITEM是一个特殊类型,专为工作流通知准备。

何时使用

  • 是-否问题:告警询问用户一个动作是否继续。
  • 确认:告警通知用户重要事实,并要求用户确认已阅读和了解。
  • 取消确认:告警确认用户中止动作成功,并通知由此产生的后果。
  • 进度报告:告警报告一个长时间运行的动作的进度,这个动作需要完全阻断或阻断大部分UI。

样例

  • 用户删除一个或多个联系人时,告警会询问用户是否确认删除,因为该行为不可逆转。(是-否问题)
  • 用户中止几个页面的同时发布时,告警确认该行为被取消,并列出已激活和未激活的页面。(取消确认)
  • 告警询问用户是否确认一个发布请求,同样的消息也允许用户发布所有的子条目,只需选中一个勾选框。(简单表单+是-否问题)

近似外观


WARNING告警

如何显示

参看显示告警

通知

通知是非侵入性消息,通知用户动作是否被成功完成或放弃。通常它们是用来确认事情。通知看起来像是便利贴,它们自动消失,不需要用户操作。使用通知来确认用户所作的动作,可以为他们提供信心和保证。

行为

  • 通知一个动作已被执行或正被执行。通知同时也会告知动作执行任务时失败。
  • 在用户当前工作的环境中显示,在环境外则没有意义。
  • 短暂性——通知不被储存,所以它们不会在Pulse里显示。
  • 由应用、子应用或是Shell应用发送。
  • 非情态性——通知不会阻止UI,它们大概3秒之后就会消失。
  • 专属性——只对引起通知的用户显示,不能被发送给其他用户。
  • 不要用通知收集用户输入,只用它来通知用户变化。

级别

所有消息都有至少以下几种不同的紧急级别,如
$webResourceManager.requireResource("info.magnolia.sys.confluence.artifact-info-plugin:javadoc-resource-macro-resources") MessageType
中的定义一样:
  • ERROR消息报告出现的严重问题。
  • WARNING消息警告用户系统探测到需要用户注意的情况。
  • INFO消息仅仅通知用户一个变化或情况。
  • WORKITEM是一个特殊类型,专为工作流通知准备。

何时使用

  • 成功确认:通知确认动作被成功执行。
  • 取消确认:通知确认动作被用户成功中止。
  • 进度报告:通知报告长时间运行,不阻断的动作的进度。
  • 快速消息:报告影响用户正在运行的任务的事件发生。

样例

  • 用户一次发布多个页面时,通知报告发布进行的程度和还需要多长时间完成。(进度报告)
  • 在长发布进程的结束,通知确认20个页面都被成功发布。(成功确认)
  • 在图片被上传期间,通知使用进度条表示上传进度。(进度报告)
  • 用户放弃图像上传时,通知确认上传被取消。(取消确认)
  • 另一个用户刚开始和您编辑同一个条目时,通知告诉你们正在相同的内容上工作。(快速消息)

近似外观


INFO通知


WARNING通知


ERROR通知

如何显示

参看显示通知

  • No labels