Main Content

updateAttribute

Class: slreq.ReqSet
Package: slreq

Update information for requirement set custom attribute

Syntax

updateAttribute(rs,atrb,Name,Value)

Description

updateAttribute(rs,atrb,Name,Value) updates the custom attribute specified by atrb with properties specified by the name-value pairs Name and Value in the requirement set rs.

Input Arguments

expand all

Requirement set, specified as an slreq.ReqSet object.

Custom attribute name, specified as a character array.

Name-Value Pair Arguments

Specify optional comma-separated pairs of Name,Value arguments. Name is the argument name and Value is the corresponding value. Name must appear inside quotes. You can specify several name and value pair arguments in any order as Name1,Value1,...,NameN,ValueN.

Example: 'Description','My new description.'

Custom attribute description, specified as the comma-separated pair consisting of 'Description' and a character array.

Example: 'Description','My new description.'

Combobox list options, specified as the comma-separated pair consisting of 'List' and a cell array. The list of options is valid only if 'Unset' is the first entry. 'Unset' indicates that the user hasn't chosen an option from the combo box. If the list does not start with 'Unset', it will be automatically appended as the first entry.

Example: 'List',{'Unset','A','B','C'}

Note

You can only use this name-value pair when the Type property of the custom attribute that you're updating is Combobox.

Examples

expand all

This example shows how to update custom attribute information for a requirement set.

Load crs_req_func_spec, which describes a cruise control system. Find a requirement set in the files and assign it to a variable.

slreq.load('crs_req_func_spec');
rs = slreq.find('Type','ReqSet');

Update an Edit Custom Attribute

Add an Edit custom attribute that has a description to the requirement set. Get the attribute information with inspectAttribute.

addAttribute(rs,'MyEditAttribute','Edit','Description','Original attribute.')
inspectAttribute(rs,'MyEditAttribute')
ans = struct with fields:
           name: 'MyEditAttribute'
           type: Edit
    description: 'Original attribute.'

Update the custom attribute with a new description. Confirm the change by getting the attribute information with inspectAttribute.

updateAttribute(rs,'MyEditAttribute','Description','Updated attribute.')
inspectAttribute(rs,'MyEditAttribute')
ans = struct with fields:
           name: 'MyEditAttribute'
           type: Edit
    description: 'Updated attribute.'

Update a Combobox Custom Attribute

Add a Combobox custom attribute that has a list of options to the requirement set. Get the attribute information with inspectAttribute.

addAttribute(rs,'MyCombobox','Combobox','List',{'Unset','A','B','C'})
inspectAttribute(rs,'MyCombobox')
ans = struct with fields:
           name: 'MyCombobox'
           type: Combobox
    description: ''
           list: {'Unset'  'A'  'B'  'C'}

Update the custom attribute with a new list of options. Confirm the change by getting the attribute information with inspectAttribute.

updateAttribute(rs,'MyCombobox','List',{'Unset','1','2','3'})
inspectAttribute(rs,'MyCombobox')
ans = struct with fields:
           name: 'MyCombobox'
           type: Combobox
    description: ''
           list: {'Unset'  '1'  '2'  '3'}

Update the custom attribute with a new list of options and a new description. Confirm the change by getting the attribute information with inspectAttribute.

updateAttribute(rs,'MyCombobox','List',{'Unset','A1','B2','B3'},'Description',...
    'Updated attribute with new options.')
inspectAttribute(rs,'MyCombobox')
ans = struct with fields:
           name: 'MyCombobox'
           type: Combobox
    description: 'Updated attribute with new options.'
           list: {'Unset'  'A1'  'B2'  'B3'}

Cleanup

Clear the open requirement sets and close the open models without saving changes.

slreq.clear;
bdclose all;
Introduced in R2020b