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

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

Установление набора ссылок

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

slreq.load('crs_req');
ls = slreq.find('Type','LinkSet','Name','crs_req')
ls = 
  LinkSet with properties:

             Description: ''
                Filename: '/tmp/BR2021ad_1657350_5204/mlx_to_docbook2/tp7613b4d1/slrequirements-ex23809012/crs_req.slmx'
                Artifact: '/tmp/BR2021ad_1657350_5204/mlx_to_docbook2/tp7613b4d1/slrequirements-ex23809012/crs_req.slreqx'
                  Domain: 'linktype_rmi_slreq'
                Revision: 8
                   Dirty: 0
    CustomAttributeNames: {'Target Speed Change'}

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

В наборе ссылок существует пользовательский атрибут Target Speed Change. Удалите пользовательский атрибут и подтвердите результаты путем проверки существующих пользовательских имен атрибутов для набора ссылок.

deleteAttribute(ls,'Target Speed Change','Force',true);
ls.CustomAttributeNames
ans =

  0x0 empty cell array

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

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

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

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

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

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

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

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

addAttribute(ls,'MyDateTimeAttribute','DateTime')

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

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

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

  Column 4

    {'MyEditAttribute'}

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

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

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

lk = find(ls,'SID',3);
setAttribute(lk,'MyEditAttribute','Value for edit attribute.');
setAttribute(lk,'MyCheckboxAttribute',false);
setAttribute(lk,'MyComboboxAttribute','B');

Задайте MyDateTimeAttribute с требуемой локалью, чтобы убедиться, что дата и время установлены в правильном формате в системах в других локалях. Дополнительные сведения см. в локали».

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

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

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

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

Редактирование пользовательских атрибутов

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

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

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

atrb3 = inspectAttribute(ls,'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.'

lk2 = find(ls,'MyEditAttribute','Value for edit attribute.')
lk2 = 
  Link with properties:

           Type: 'Derive'
    Description: '#8: Set Switch Detection'
       Keywords: {}
      Rationale: ''
      CreatedOn: 20-May-2017 13:14:40
      CreatedBy: 'itoy'
     ModifiedOn: 23-Apr-2021 10:46:04
     ModifiedBy: 'batserve'
       Revision: 5
            SID: 3
       Comments: [0x0 struct]

Поиск по набору ссылок для всех ссылок, где MyCheckboxAttribute установлено в true.

lkArray = find(ls,'MyCheckboxAttribute',true)
lkArray=1×11 object
  1x11 Link array with properties:

    Type
    Description
    Keywords
    Rationale
    CreatedOn
    CreatedBy
    ModifiedOn
    ModifiedBy
    Revision
    SID
    Comments

Поиск по набору ссылок для всех ссылок, где MyComboboxAttribute установлено в 'Unset'.

lkArray2 = find(ls,'MyComboboxAttribute','Unset')
lkArray2=1×12 object
  1x12 Link array with properties:

    Type
    Description
    Keywords
    Rationale
    CreatedOn
    CreatedBy
    ModifiedOn
    ModifiedBy
    Revision
    SID
    Comments

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

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

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

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

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

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

  Column 4

    {'NewEditAttribute'}

Потому что NewEditAttribute не используется никакими ссылками, вы можете удалить его с помощью deleteAttribute путем установки Force на false. Подтвердите изменение.

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

Очистка

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

slreq.clear;
bdclose all;

См. также

| | | | | |

Похожие примеры

Подробнее о