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

updateFromDocument

类: slreq.Reference
命名空间: slreq

从外部需求文档更新引用需求

全页展开

语法

[status,changeList] = updateFromDocument(topRef)
[status,changeList] = updateFromDocument(topRef,docURI)

说明

[status,changeList] = updateFromDocument(topRef) 更新导入节点 topRef 下的引用需求。该函数返回更新状态和更新需求的列表。

示例

[status,changeList] = updateFromDocument(topRef,docURI) 从 docURI 指定的外部需求文档更新导入节点下引用需求。当外部需求文档的名称或路径发生变化时，使用此语法来更新引用需求。

示例

输入参数

全部展开

导入节点，指定为 slreq.Reference 对象。

外部需求文档的资源标识符，指定为字符串标量或字符向量。

示例: [status,changelist] = updateFromDocument(topRef,"myDoc.docx")

输出参量

全部展开

需求集更新状态，以字符向量形式返回。

更新的引用需求列表，以字符向量形式返回。该列表包括该函数改变的每个引用需求的属性。

示例

全部展开

打开实时脚本

此示例显示如何检查导入节点是否有可用的更新并更新引用需求。

加载 crs_req 需求集。

rs = slreq.load("crs_req");

获取需求集的导入节点的句柄。

topRef = children(rs);

检查导入节点是否有可用的更新。

tf = hasNewUpdate(topRef)
tf = logical
   1

1 的结果意味着 topRef 自上次导入后已经更新。更新导入节点下引用需求。

[status,changelist] = updateFromDocument(topRef)
status = 
'Update completed. Refer to Comments on Import1.'

changelist = 
    'Updated: CC003_01. Properties: description
     Updated: CC003_02. Properties: description
     Updated: CC003_03. Properties: description
     Updated: CC003_04. Properties: description
     Updated: Cruise Control SET Indicator Light. Properties: description
     Updated: Cruise control buttons. Properties: description
     Updated: Cruise control mode indicator. Properties: description
     Deleted: Cruise control modes
     Updated: Dashboard image. Properties: description
     Inserted: Dashboard image_1
     Updated: Deactivating cruise control. Properties: description
     Deleted: Disabling cruise control
     Updated: Enabling cruise control. Properties: description
     Updated: Other inputs. Properties: description
     Updated: ROM. Properties: description
     Updated: Resuming cruise control. Properties: description
     Inserted: Simulink_requirement_item_1
     Inserted: Simulink_requirement_item_10
     Inserted: Simulink_requirement_item_11
     Inserted: Simulink_requirement_item_12
     Inserted: Simulink_requirement_item_13
     Inserted: Simulink_requirement_item_14
     Inserted: Simulink_requirement_item_15
     Inserted: Simulink_requirement_item_2
     Inserted: Simulink_requirement_item_3
     Inserted: Simulink_requirement_item_4
     Inserted: Simulink_requirement_item_5
     Inserted: Simulink_requirement_item_6
     Inserted: Simulink_requirement_item_7
     Inserted: Simulink_requirement_item_8
     Inserted: Simulink_requirement_item_9
     Updated: System Inputs. Properties: description
     Updated: System outputs. Properties: description
     Updated: Throttle value calculation. Properties: description
     Inserted: When the vehicle is started. Cru
     Inserted: boolean
     Inserted: boolean_1
     Inserted: boolean_2
     Inserted: boolean_3
     Inserted: boolean_4
     Inserted: boolean_5
     Inserted: single
     Inserted: single_1
     Inserted: single_2
     Inserted: uint8
     Inserted: uint8_1
     '
打开实时脚本

此示例显示如何从具有与原始需求文档不同名称的外部需求文档更新所引用需求。

加载 crs_req 需求集。

rs = slreq.load("crs_req");

获取需求集的导入节点的句柄。

topRef = children(rs);

获取导入需求的外部需求文档的名称。

oldDoc = topRef.Artifact
oldDoc = 
'crs_req.docx'

使用名称 crs_req_new.docx 更新文档中引用需求。

[status,changelist] = updateFromDocument(topRef,"crs_req_new.docx")
status = 
'Update completed. Refer to Comments on Import1.'

changelist = 
    'Updated: CC003_01. Properties: description
     Updated: CC003_02. Properties: description
     Updated: CC003_03. Properties: description
     Updated: CC003_04. Properties: description
     Updated: Cruise Control SET Indicator Light. Properties: description
     Updated: Cruise control buttons. Properties: description
     Updated: Cruise control mode indicator. Properties: description
     Deleted: Cruise control modes
     Updated: Dashboard image. Properties: description
     Inserted: Dashboard image_1
     Updated: Deactivating cruise control. Properties: description
     Deleted: Disabling cruise control
     Updated: Enabling cruise control. Properties: description
     Updated: Other inputs. Properties: description
     Updated: ROM. Properties: description
     Updated: Resuming cruise control. Properties: description
     Inserted: Simulink_requirement_item_1
     Inserted: Simulink_requirement_item_10
     Inserted: Simulink_requirement_item_11
     Inserted: Simulink_requirement_item_12
     Inserted: Simulink_requirement_item_13
     Inserted: Simulink_requirement_item_14
     Inserted: Simulink_requirement_item_15
     Inserted: Simulink_requirement_item_2
     Inserted: Simulink_requirement_item_3
     Inserted: Simulink_requirement_item_4
     Inserted: Simulink_requirement_item_5
     Inserted: Simulink_requirement_item_6
     Inserted: Simulink_requirement_item_7
     Inserted: Simulink_requirement_item_8
     Inserted: Simulink_requirement_item_9
     Updated: Successive Target Speed Increment. Properties: description
     Updated: System Inputs. Properties: description
     Updated: System outputs. Properties: description
     Updated: Target Speed Increment. Properties: description
     Updated: Target speed decrement. Properties: description
     Updated: Throttle value calculation. Properties: description
     Inserted: When the vehicle is started. Cru
     Inserted: boolean
     Inserted: boolean_1
     Inserted: boolean_2
     Inserted: boolean_3
     Inserted: boolean_4
     Inserted: boolean_5
     Updated: crs_req_new. Properties: summary
     Inserted: single
     Inserted: single_1
     Inserted: single_2
     Inserted: uint8
     Inserted: uint8_1
     '

提示

  • 当您的需求集包含从多个外部需求文档导入的需求时，请使用 updateReferences 方法仅更新从指定的外部需求文档中引用需求。

  • 要更改外部需求文档的存储名称和路径而不更新导入的引用需求，请使用 updateSrcFileLocation 方法。

版本历史记录

在 R2019a 中推出

全部展开

另请参阅

类

函数

主题