Управляйте пользовательскими атрибутами для требований при помощи Simulink® Requirements™ API

То В этом примере показано, как использовать Simulink® Requirements™ API, чтобы создать пользовательские атрибуты для требования, устанавливает и устанавливать значения пользовательского атрибута для требований.

Установите набор требования

Загрузите файл требования crs_req_func_spec, который описывает систему круиз-контроля, и присвойте ее переменной.

rs = slreq.load('crs_req_func_spec');

Добавьте пользовательский атрибут каждого типа

Добавьте пользовательский атрибут каждого типа к набору требования. Создайте Edit пользовательский атрибут с описанием.

addAttribute(rs,'MyEditAttribute','Edit','Description',...
    'You can enter text as the custom attribute value.')

Создайте Checkbox атрибут type и набор его DefaultValue свойство к true.

addAttribute(rs,'MyCheckboxAttribute','Checkbox','DefaultValue',true)

Создайте Combobox пользовательский атрибут. Поскольку правом преимущественной покупки должен быть 'Unset', добавьте опции 'Unset', 'A', 'B', and 'C'.

addAttribute(rs,'MyComboboxAttribute','Combobox','List',{'Unset','A','B','C'})

Создайте DateTime пользовательский атрибут.

addAttribute(rs,'MyDateTimeAttribute','DateTime')

Проверяйте заданные пользовательские атрибуты на набор требования. Получите информацию о MyComboboxAttribute чтобы видеть опции, вы добавили.

rs.CustomAttributeNames
ans = 1x4 cell
  Columns 1 through 3

    {'MyCheckboxAttr...'}    {'MyComboboxAttr...'}    {'MyDateTimeAttr...'}

  Column 4

    {'MyEditAttribute'}

atrb = inspectAttribute(rs,'MyComboboxAttribute')
atrb = struct with fields:
           name: 'MyComboboxAttribute'
           type: Combobox
    description: ''
           list: {'Unset'  'A'  'B'  'C'}

Установите значение пользовательского атрибута для требования

Найдите требование в наборе требования и установите значение пользовательского атрибута для всех четырех пользовательских атрибутов, которые вы создали.

req = find(rs,'Type','Requirement','SID',3);
setAttribute(req,'MyEditAttribute','Value for edit attribute.');
setAttribute(req,'MyCheckboxAttribute',false);
setAttribute(req,'MyComboboxAttribute','B');

Установите MyDateTimeAttribute с желаемой локалью, чтобы гарантировать, что дата и время установлена в правильном формате в системах в других локалях. Смотрите Локаль для получения дополнительной информации.

localDateTimeStr = datestr(datetime('15-Jul-2018 11:00:00','Locale','en_US'),'Local');
setAttribute(req,'MyDateTimeAttribute',localDateTimeStr);

Просмотрите значения атрибута.

getAttribute(req,'MyEditAttribute')
ans = 
'Value for edit attribute.'
getAttribute(req,'MyCheckboxAttribute')
ans = logical
   0

getAttribute(req,'MyComboboxAttribute')
ans = 
'B'
getAttribute(req,'MyDateTimeAttribute')
ans = datetime
   15-Jul-2018 11:00:00

Отредактируйте пользовательские атрибуты

После того, как вы зададите пользовательский атрибут для набора ссылки, можно внести ограниченные изменения в пользовательский атрибут.

Добавьте описание в MyCheckboxAttribute и MyComboboxAttribute, и измените список опций для MyComboboxAttribute. Поскольку вы не можете обновить значение по умолчанию Checkbox атрибуты, можно только обновить описание MyCheckboxAttribute. Просмотрите изменения.

updateAttribute(rs,'MyCheckboxAttribute','Description',...
    'The checkbox value can be true or false.');
updateAttribute(rs,'MyComboboxAttribute','Description',...
    'Choose an option from the list.','List',{'Unset','1','2','3'});
atrb2 = inspectAttribute(rs,'MyCheckboxAttribute')
atrb2 = struct with fields:
           name: 'MyCheckboxAttribute'
           type: Checkbox
    description: 'The checkbox value can be true or false.'
        default: 1

atrb3 = inspectAttribute(rs,'MyComboboxAttribute')
atrb3 = struct with fields:
           name: 'MyComboboxAttribute'
           type: Combobox
    description: 'Choose an option from the list.'
           list: {'Unset'  '1'  '2'  '3'}

Найдите Требования тем Значением Пользовательского атрибута Соответствия

Ищите набор требования все требования где 'MyEditAttribute' установлен в 'Value for edit attribute.'

req2 = find(rs,'Type','Requirement','MyEditAttribute','Value for edit attribute.')
req2 = 
  Requirement with properties:

            Type: 'Functional'
              Id: '#3'
         Summary: 'Avoid repeating commands'
     Description: '<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd">...'
        Keywords: {}
       Rationale: ''
       CreatedOn: 27-Feb-2017 10:15:38
       CreatedBy: 'itoy'
      ModifiedBy: 'batserve'
             SID: 3
    FileRevision: 46
      ModifiedOn: 25-Aug-2021 21:19:22
           Dirty: 1
        Comments: [0x0 struct]
           Index: '1.2'

Ищите набор требования все требования где 'MyCheckboxAtribute' установлен в true.

reqsArray = find(rs,'Type','Requirement','MyCheckboxAttribute',true)
reqsArray=1×69 object
  1x69 Requirement array with properties:

    Type
    Id
    Summary
    Description
    Keywords
    Rationale
    CreatedOn
    CreatedBy
    ModifiedBy
    SID
    FileRevision
    ModifiedOn
    Dirty
    Comments
    Index

Ищите набор требования все требования где 'MyComboboxAttribute' установлен в 'Unset'.

reqsArray2 = find(rs,'Type','Requirement','MyComboboxAttribute','Unset')
reqsArray2=1×70 object
  1x70 Requirement array with properties:

    Type
    Id
    Summary
    Description
    Keywords
    Rationale
    CreatedOn
    CreatedBy
    ModifiedBy
    SID
    FileRevision
    ModifiedOn
    Dirty
    Comments
    Index

Удалите пользовательские атрибуты

Можно использовать deleteAttribute удалить атрибуты. Однако, потому что пользовательские атрибуты, созданные в этом примере, присвоены требованиям, необходимо установить 'Force' к true удалить атрибуты. Удалите 'MyEditAttribute' и подтвердите изменение.

deleteAttribute(rs,'MyEditAttribute','Force',true);
rs.CustomAttributeNames
ans = 1x3 cell
    {'MyCheckboxAttri...'}    {'MyComboboxAttri...'}    {'MyDateTimeAttri...'}

Добавьте новый пользовательский атрибут, но не устанавливайте значения пользовательского атрибута требования для требований.

addAttribute(rs,'NewEditAttribute','Edit');
rs.CustomAttributeNames
ans = 1x4 cell
  Columns 1 through 3

    {'MyCheckboxAttr...'}    {'MyComboboxAttr...'}    {'MyDateTimeAttr...'}

  Column 4

    {'NewEditAttribute'}

Поскольку 'NewEditAttribute' не используется никакими требованиями, можно удалить его с deleteAttribute установкой 'Force' к false. Подтвердите изменение.

deleteAttribute(rs,'NewEditAttribute','Force',false);
rs.CustomAttributeNames
ans = 1x3 cell
    {'MyCheckboxAttri...'}    {'MyComboboxAttri...'}    {'MyDateTimeAttri...'}

Очистка

Очистите открытые наборы требования, не сохраняя изменения и закройте открытые модели, не сохраняя изменения.

slreq.clear;
bdclose all;

Смотрите также

| | | | | |

Связанные примеры

Больше о