内联消息
您可以开发内联消息以捕获某些用户操作的成功或失败。也可以使用它来显示警告或任何信息性消息。但是,内联消息不能用于发布任何需要用户输入的消息。
背景
本主题将详细介绍有关使用预设组件作为构建块开发内联消息所需的信息。
预期结果
内联消息将在浏览器中向最终用户显示预期消息。
解决方案
使用通用的 JavaScript 和 java 类组件显示内联消息,可向用户反馈有关其操作成功、失败的消息或警告消息。
必备知识
要应用此过程,需要了解以下内容:
Java 编程
使用 JavaScript、JSP、自定义标记和 HTML 表单的基本 web 开发
解决方案元素
元素
说明
Java 方法
getSuccessFeedbackMessage()
此方法由 DefaultObjectFormProcessorsetResultNextAction() 调用,且在 FormResultSUCCESS 时进行调用。这将针对所创建的对象构建包含消息标题、附加消息和信息页面链接的 FeedbackMessage。
如果对象没有任何标识,则只有对象图标和对象类型会显示为信息页面链接。这会在 UI 中以内联成功消息的形式显示,通知用户已成功创建对象。
这个方法可能会被需要不同行为的子类所覆盖。有关详细信息,请参阅 JavaDoc。
Javascript
PTC.messaging.showInlineMessage()
在主窗口中呈现内联消息的 javascript 方法。它会将消息 JSON 对象数组作为自变量。每个消息 JSON 对象都必须具有 MessageTitle,一个消息数组和 Message 类型。
有效的消息类型包括:SUCCESSFAILUREWARNINGFATALINFO。不应将其用于任何确认类型的消息。
有关详细信息,请参阅 JavaDoc。
位置:<Windchill>\codebase\netmarkets\javascript\util
自定义点
预设 JCA 框架具有在成功创建对象时 UI 中将显示的内联成功消息。
对于单一对象创建,内联消息如下所示:
对于多个对象创建,UI 中将显示如下内联消息:
如何为成功创建对象自定义消息标题?
在上述屏幕截图中,消息标题为“确认:创建成功”
如果应用程序需要覆盖消息标题,则其需要覆盖对象表单处理器中的公共 WTMessage getSuccessMessageTitle() 方法并提供其自己的本地化消息标题。
如何为成功创建对象自定义消息正文?
在上述单一对象创建的屏幕截图中,消息正文是“已成功创建对象”
如果应用程序需要覆盖为单一对象创建的消息正文,则其需要覆盖对象表单处理器中的 public WTMessage getSuccessMessageBody() 方法并提供自己的本地化消息正文。
对于多个对象的创建,覆盖消息正文的方法是表单处理器中的 public WTMessage getSuccessMessageBodyForMulti()
示例代码
使用 JavaScript 函数为消息类型 SUCCESS 显示内联消息的示例代码:
PTC.messaging.showInlineMessage(
[{
MessageType:'SUCCESS',
MessageTitle:'Confirmation: Create successful',
Messages:["Object created successfully."],
OidIdentity: [{oid: "OR:wt.part.WTPart:11021", icon: "wtcore/images/part.gif", objType: "Part"}]
}]);
更多资源
以下自定义主题包含相关信息:
这对您有帮助吗?