在模型中创建新的 ThingWorx 操作
工具栏中提供了可供站点管理员在模型中执行的创建/移除/粘贴操作。这些操作会根据需要更新 <wt home>\codebase\custom-actions.xml 和 <wt home>\codebase\custom-actionmodels.xml 文件,然后重新加载所有操作定义。
1. 创建操作。
2. 在向导的步骤 1 中,提供“标签”、“名称”和“对象类型”。这些选项可以是任何值。
3. 在向导的步骤 2 中,提供 URL。URL 必须为:ptc1/twx?mashup=<name of mashup>
ptc1/twx URL 由 ThingWorxController 处理,它将在 wt.properties 中查找 ThingWorx URL,并根据需要转发/重定向以在弹出窗口中启动 ThingWorx 混搭或将其嵌入到页面中。
此外,ThingWorxController 处理将为混搭提供 oid 和 ContainerOid 作为 URL 参数 (在适用的情况下)。然后,混搭必须进行必要的调用 (使用 Windchill REST 服务) 以获取显示混搭所必需的任何其他数据。有关混搭的详细信息,请参阅 ThingWorx 帮助中心。
| 目前不支持通过操作 URL 将其他参数传递到混搭。 |
弹出窗口与嵌入式页面
如果将操作添加到操作菜单中,则可以将 windowType 设置为弹出窗口,以便 ThingWorx 混搭在其自己的浏览器窗口/选项卡中单独启动。
如果操作没有 windowType 或已指定 windowType=page,则混搭将以嵌入形式显示在 Windchill shell 中。
注意:如果将操作添加到设计为保留 Windchill shell 中内容的模型,则即使您选择 windowType=popup,ThingWorx 混搭也会嵌入到 Windchill shell 中。自定义菜单、信息页面选项卡集和导航模型均为此情况的示例。
支持的类型/不支持的类型
如果将操作添加到 thingworxActionsMenu 或 thingworxCustomizeMenu 模型中,且操作应仅针对特定类型显示,则应该在“创建操作”向导步骤 2 中“支持的类型”/“不支持的类型”属性中填入所需的类型。
窗口和 iframe 大小
对于在 Windchill shell 中以嵌入方式显示的 ThingWorx 混搭,将 iframe 硬编码为混搭应遵循的 1200px 高度。如果 1200px iframe 太小,则可能会存在不必要的滚动条。如果 iframe 过大,则可能存在不必要的空格。在未来的版本中,此类问题可能会得以修复,从而可根据 iframe 的内容自动调整大小。
对于弹出窗口,ThingWorx 内容不会位于任何 iframe 中。弹出窗口的默认大小可能与内容不匹配,但用户可以调整窗口大小。窗口大小不具有粘性。可以在 XML 操作定义中通过 <moreurlinfo>height=1000,width=1200</moreurlinfo> 来控制弹出窗口的大小。必须通过直接编辑操作 xml 文件来进行此更改,因为 moreurlinfo 参数当前不是通过操作模型报告用户界面设置的。
测试新 ThingWorx 操作
在操作模型报告中创建新的 ThingWorx 操作后,请从其启动点对其进行测试。如果您将操作添加到 thingworxActionsMenu 或 thingworxCustomizeMenu 操作模型,则现在应该能够在 menu/tabset/navigator (无任何 jcaDebug=true URL 参数) 中看到 ThingWorx 选项。
此为嵌入在 Windchill 信息页面中的 ThingWorx 混搭的示例: