本页采用了机器翻译。点击此处可查看英文原文。

使用自定义文档界面链接外部应用程序需求

此示例使用:

打开实时脚本

您可以使用自定义文档界面将 Simulink® 模型、子系统和模块链接到外部应用程序中的需求。您还可以使用自定义文档界面来导入需求。在链接或导入需求之前，您必须首先定义并注册自定义文档界面。

例如，在此示例中，您将 Simulink 模块与包含需求内容的 PowerPoint® 演示文稿建立关联。之后，您将需求导入模型。该模型代表汽车车窗的控制装置。

The model includes Stateflow and Simulink blocks

定义并注册自定义文档界面

在此示例中，您将使用文件 rmidemo_pp.m 中包含的现成自定义文档接口。自定义文档接口用于设置属性并提供回调函数，从而使 Requirements Toolbox™ 能够与外部应用程序进行交互。有关详细信息，请参阅定义自定义文档界面以直接链接到需求。

rmidemo_pp.m 文件：

  • 将 PPT 和 PPTX 设置为支持的文件类型。

  • 定义 Requirements Toolbox 如何解释 PowerPoint 文档。

  • 使用 Office VBA 语言访问和导航到 PowerPoint 文档。有关 PowerPoint 的 Office VBA 的更多信息，请参阅 Microsoft 开发人员参考页面。

要使用自定义文档界面，请在 Requirements Toolbox 中注册关联文件。

rmi register rmidemo_pp

使用幻灯片编号创建链接

注册自定义文档界面后，您可以链接到 PowerPoint 演示文稿中的特定幻灯片编号。如果幻灯片顺序发生变化，链接不会更新以匹配新的位置。

链接到第五张幻灯片，其中包含对驱动程序输入的需求。

  1. 右键点击 Truth Table 模块，该模块连接到 driver 图的 control 输入。在上下文菜单中，将鼠标悬停在选择 App 上，然后点击“需求管理器”按钮 。

  2. 右键点击 Truth Table 模块，在“需求管理器” 部分中，点击“出向链接编辑器”按钮 。

  3. 在“出向链接”对话框中，点击新建。

  4. 在描述中，输入 Driver input。

  5. 在文档类型下拉菜单中，选择 Microsoft PowerPoint。

  6. 点击浏览。选择 powerwindowController.pptx 并点击打开。

  7. 在位置（类型/标识符）文本字段中，输入 5。

  8. 点击确定。

  9. 右键点击 Truth Table 模块。在“需求管理器” 部分的上下文菜单中，会出现选项驱动程序输入。点击此菜单选项后，MATLAB® 会打开 PowerPoint 文档并跳转至第五张幻灯片。

The Outgoing Links dialog box. All the fields except the keywords field are specified

使用幻灯片 ID 创建永久链接

您可以使用幻灯片 ID 创建幻灯片的永久链接。如果幻灯片顺序发生变化，链接仍会继续指向正确的幻灯片。

要查找第五张幻灯片的 ID，请打开 powerwindowController.pptx 并使用 MATLAB 命令行查询 Office VBA：

hApp = actxGetRunningServer('powerpoint.application');
hDoc = hApp.ActivePresentation;
hDoc.Slides.Item(5).SlideID 
ans = 
260

将模块链接到幻灯片。

  1. 右键点击 Truth Table 模块，在“需求管理器” 部分中，点击“出向链接编辑器”按钮 。

  2. 在“出向链接”对话框中，点击新建。

  3. 在描述中，输入 Driver input (ID)。

  4. 在文档类型下拉菜单中，选择 Microsoft PowerPoint。

  5. 点击浏览。选择 powerwindowController.pptx 并点击打开。

  6. 在位置（类型/标识符）下拉菜单中，选择 Named Item。

  7. 在位置（类型/标识符）文本中，输入 260。

  8. 点击确定。

  9. 右键点击 Truth Table 模块。在“需求管理器” 部分的上下文菜单中，会出现选项多个出向链接... > 驱动程序输入 (ID)。当您点击此菜单选项时，MATLAB 将打开 PowerPoint 文档的相应幻灯片。

使用文档索引选项卡创建持久链接

您还可以使用“出向链接”对话框的文档索引选项卡创建持久链接。要使用文档索引选项卡，您的自定义文档界面必须使用 ContentsFcn 方法来存储幻灯片 ID。有关 ContentsFcn 的详细信息，请参阅定义自定义文档界面。

  1. 右键点击 Truth Table1 模块，该模块连接到 passenger 图的 control 输入。在“需求管理器” 部分，点击“出向链接编辑器”按钮 。

  2. 在“出向链接”对话框中，点击新建。

  3. 在文档类型下拉菜单中，选择 Microsoft PowerPoint。

  4. 点击浏览。选择 powerwindowController.pptx 并点击打开。

  5. 点击文档索引选项卡。

  6. 点击刷新。

  7. 双击 Passenger Input consists of a vector with three elements。描述和位置（类型/标识符） 字段会自动填充。

  8. 点击确定。

  9. 右键点击 Truth Table1 模块。菜单选项 Implement: "Passenger Input consists of a vector with three elements in powerwindowController.pptx" 出现在“需求管理器” 的上下文菜单中。当您点击此菜单选项时，MATLAB 将打开 PowerPoint 文档的相应幻灯片。

The Outgoing Links dialog box is set to the Document Index tab and the Passenger Input consists of a vector with three elements in powerwindowController.pptx is selected.

创建当前幻灯片的永久链接

您可以创建指向打开的 PowerPoint 演示文稿中活动幻灯片的永久链接。例如，请创建一个指向第六张幻灯片的链接。要创建链接：

  1. 打开 PowerPoint 演示文稿。

  2. 转到第六张幻灯片 Top or bottom of the window frame is reached。

  3. 在 Simulink 模型中，右键点击 endstop 模块。选择链接到所选需求 > 链接到 Microsoft PowerPoint。Requirements Toolbox 创建指向打开的幻灯片的链接。

  4. 右键点击 endstop 模块。菜单选项 Implement "Top or bottom of the window frame is rea..." 会出现在“需求管理器” 部分的上下文菜单中。当您点击此菜单选项时，MATLAB 将打开 PowerPoint 文档的相应幻灯片。

创建双向链接

您可以启用 Requirements Toolbox 来自动创建双向链接。当您启用双向链接时，链接到外部应用程序中的需求也会创建从外部应用程序到您的模型、子系统或模块的链接。

要创建双向链接，您的自定义文档界面必须使用 SelectLinkFcn 方法插入超链接。有关 SelectionLinkFcn 的详细信息，请参阅定义自定义文档界面。

首先，启用双向链接。

  1. 在 App 选项卡中，打开需求管理器。

  2. 在需求窗格中的视图下拉菜单中，选择 Links。

  3. 在工具栏中选择需求选项卡。

  4. 点击链接设置 > 链接选项以打开需求设置窗口中的选择链接选项卡。

  5. 选中修改双向链接的目标复选框。

  6. 点击关闭。

然后，添加双向链接。

  1. 打开 PowerPoint 演示文稿。

  2. 转到第七张幻灯片 Obstacle is present between the window and its frame。

  3. 在 Simulink 模型中，右键点击 obstacle 模块，然后选择链接到所选需求 > 链接到 Microsoft PowerPoint。幻灯片左上角会出现一个 MATLAB 链接图标。

  4. 返回幻灯片并按住 Control 键点击链接图标。在该模型中，obstacle 模块已被高亮显示。

仅当您启用修改双向链接的目标选项后创建的链接才会显示双向链接。清除在 MATLAB 启动时启用外部连接复选框可能会导致 PowerPoint 在您选择链接时连接到 MATLAB。

导入需求

您可以使用自定义文档界面从外部应用程序导入需求。

  1. 在需求窗格中的视图下拉菜单中，选择 Requirements。

  2. 打开 PowerPoint 文档。

  3. 在需求选项卡中，点击导入。

  4. 在文档类型下拉菜单中，选择 Microsoft PowerPoint。

  5. 点击使用当前。文档位置将自动填充。

  6. 点击导入。

  7. 在需求选项卡的需求集部分中，点击需求编辑器以查看导入的需求。

上述说明可能与 Microsoft® OneDrive™ 或其他网络位置上的文件不兼容。如果您收到一条提示无法导入的错误信息，请按照以下步骤操作：

  1. 关闭 powerwindowController.pptx。

  2. 创建 powerwindowController.pptx 的本地副本。

  3. 打开本地副本。

  4. 再次导入需求。

The Requirements Editor shows the imported Requirement set with eight requirements

删除自定义文档界面

使用取消注册命令删除不再需要的自定义文档界面。取消注册后，使用自定义文档界面的链接不起作用。

rmi unregister rmidemo_pp

另请参阅

主题