您可以以三种基本格式将信息展示给用户:横幅,告警,通知。
横幅
横幅是通知用户关于系统和应用事件的消息。横幅被明显的显示在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横幅
如何显示
参看显示横幅消息。
告警
告警是情态消息,出现在用户当前工作的环境中。您可以使用告警来确认动作是否应该被执行,告诉用户有害的后果,或是报告长时间运行的动作的进度。由于告警是情态性的,它们会阻止用户界面。
不要用告警来收集任何用户输入。对于快速输入,您可以使用简捷对话框。简捷对话框可以承载一套小的表单域,仍然与普通对话框类似。对于复杂的输入,使用普通对话框来实现。在呈现调整用户档案里页面属性或设置的表单时,应该使用对话框。如果您需要通过多个步骤来指导用户,您甚至可以使用一个向导对话框。
行为
- 告警在用户当下工作的环境中显示,离开环境它们则没有意义。
- 短暂性——告警不会被储存,所以它们不会在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通知
如何显示
参看显示通知。
Overview
Content Tools