Architectural Data Editor

Manage architectural data

Since R2023b

Description

The Architectural Data Editor lets you edit the Architectural Data section of a Simulink^® data dictionary. By using the Architectural Data Editor, you can manage interfaces, data types, and constants that are used by Simulink and shared across architectural models.

With the Architectural Data Editor you can:

• Create and configure definitions for interfaces, data types, and constants.

• Filter, sort, and search architectural data in the main Contents pane. See Filter and Manage Entries in Contents Pane for more information.

• Manage the architectural data of multiple data dictionaries.

• Configure AUTOSAR Classic platform properties of architectural data:

  • Configure AUTOSAR XML options and share them across models.

  • Export architectural data and AUTOSAR definitions to ARXML and other support files.

• Save requirements when there are changes in the requirements.

For more information about shared interfaces and data types, see Graphically Manage Shared Interfaces, Data Types, and Constants and Create Architectural Data Object and Use It to Configure Architectural Data.

×

Open the Architectural Data Editor

You can open the Architectural Data Editor using any of the following methods:

• Open Model Explorer by double-clicking an .sldd file, then navigate to the Architectural Data section and click the Open Architectural Data Editor button.

• From the Interface Editor (System Composer) of a system architecture model, click the Manage interfaces, data types and dictionary references in the Architectural Data Editor button.

• From the Modeling tab of a system architecture model, select Design > Architectural Data Editor.

• Use the show function on an Architectural Data object.

  archDataObj = Simulink.dictionary.archdata.create("newDictionary.sldd");
  show(archDataObj)

• At the MATLAB^® command prompt, enter archdataeditor.

Examples

Manage Architectural Data Section of Simulink Data Dictionary

You can create a data dictionary from the Architectural Data Editor and then edit the architectural data.

From the Architectural Data Editor, to create a new data dictionary, from the File section, click New.

To configure architectural data for an existing data dictionary, click Open and select the data dictionary. Add interfaces, data types, and constants by navigating to the Create tab and selecting the desired data object.

Manage Architectural Data Section in Simulink Data Dictionary Programmatically

You can create a data dictionary and return the Architectural Data object programmatically.

Use the Simulink.dictionary.archdata.create function to create an Architectural Data object and an associated data dictionary.

archDataObj = Simulink.dictionary.archdata.create('newDictionary.sldd');

To begin editing architectural data in an existing data dictionary use the Simulink.dictionary.archdata.open function.

archDataObj = Simulink.dictionary.archdata.open('dataDictionary.sldd');

Add interfaces, data types, and constants by using the Simulink.dictionary.ArchitecturalData programmatic interfaces. For more information see Create Architectural Data Object and Use It to Configure Architectural Data.

Manage Architectural Data of Multiple Simulink Data Dictionaries

You can open multiple data dictionaries in a single editor window and switch between them by using the Sources pane.

To manage architectural data of multiple data dictionaries:

1. From the File section, click Open to open existing data dictionaries or click New to create new data dictionaries.

2. From the Sources pane, select a data dictionary.

3. Select the Interfaces, Data Types, Constants, or platform-specific tabs to view and edit architectural data. See Create and Configure Interface, Data Type, and Constant Definitions for more information.

On the Interfaces and Data Types tabs, the Architectural Data Editor provides a DataSource column indicating the source data dictionary for each interface or data type.

To reference a data dictionary from another data dictionary:

1. Open both data dictionaries.

2. From the Sources pane, double-click the name of the data dictionary to which you want to add a referenced data dictionary. The Details pane displays the Referenced Dictionaries section.

3. In the Details pane, click Add to add a referenced dictionary. The main Contents pane displays the architectural data in the referenced data dictionary.

4. On the toolstrip, under Settings, select or clear Include content from referenced dictionaries to show or hide the data from referenced data dictionaries.

Once a data dictionary is referenced, architectural data from the referenced dictionary can be used by the open dictionary that references it. For example, the image shows that the data element in data interface MyDataInterface2 uses enumeration OtherEnum from the referenced dictionary OtherDictionary for its data type.

From the Referenced Dictionaries section of the Details pane, you can add references to existing data dictionaries, remove references, or open referenced data dictionaries in the Sources pane.

Create and Configure Interface, Data Type, and Constant Definitions

You can create interfaces, data types, and constants to be shared among both architecture models and other Simulink models and configure their associated properties.

On the toolstrip, in the Create section, add interface, data type, and constant definitions on the Interfaces, Data Types, and Constants tabs, respectively, by clicking the data type, interface, and constant icons.

To configure interfaces, data types, and constants, on the Interfaces, Data Types, Constants tabs, select an interface, data type, or constant object and edit its properties in the main Contents pane and in the Details pane.

On the Interfaces tab, you can view service interfaces previously created in System Composer or by using the getInterface and getInterfaceNames functions.

You can also add interfaces, data types, and constants programmatically. Add data types by using the addAliasType, addEnumType, addNumericType, addStructType, and addValueType functions.

Supported Data Types	Architectural Data Editor Operations
Alias Type	Add a Simulink.AliasType data type with the specified name to the Architectural Data section. For information about performing this operation programmatically, see addAliasType.
Enumerated Type	Add a Simulink enumeration data type Simulink.data.dictionary.EnumTypeDefinition with the specified name to the Architectural Data section. For information about performing this operation programmatically, see addEnumType.
Numeric Type	Add a Simulink.NumericType data type with the specified name to the Architectural Data section. For information about performing this operation programmatically, see addNumericType.
Structured Type	Add a Simulink.Bus type with the specified name to the Architectural Data section. For information about performing this operation programmatically, see addStructType (AUTOSAR Blockset).
Value Type	Add a Simulink.ValueType data type with the specified name to the Architectural Data section. For information about performing this operation programmatically, see addValueType.

Add interfaces using the addDataInterface, addServiceInterface, addPhysicalInterface functions.

Add elements to interfaces using the programmatic interfaces of the Simulink.dictionary.archdata.DataInterface object and configure those elements using the Simulink.dictionary.archdata.DataElement object.

Supported Interface Elements	Architectural Data Editor Operations
Data Interface	Add a data interface object to the Architectural Data section. For information about performing this operation programmatically, see addDataInterface.
Data Element	Add a data element object to the selected data interface. For information about performing this operation programmatically, see addElement.
Physical Interface	Add a physical interface object to the Architectural Data section. For information about performing this operation programmatically, see addPhysicalInterface.
Physical Element	Add a physical element object to the selected physical interface. For more information about performing this operation programmatically, see addElement.
Service Interface	Add a service interface object to the Architectural Data section. For information about performing this operation programmatically, see addServiceInterface.
Service Element	Add a service element object to the selected service interface. For more information about performing this operation programmatically, see addElement.
Function Element	Function elements are Simulink.dictionary.archdata.FunctionElement objects and are derived from the prototype of their service element

Add a Simulink.dictionary.archdata.Constant object to the dictionary by using the addConstant function.

When you save the Architectural Data section, the properties that you configured are stored in the .sldd file.

Filter and Manage Entries in Contents Pane

The main Contents pane provides an interactive table with information about the interface, data types, and constants objects, such as hierarchy and properties. You can select which columns appear in the table by selecting Columns in the toolstrip.

Use the main Contents pane to:

• Filter objects — Enter a universal filter or a column-specific filter.

• Edit objects — Double-click a value in the table and enter a new value. When you enter a value that is not supported, a diagnostic message appears in the pane.

• Batch edit objects — Select objects of the same type that you want to edit. Double-click a value of one of the selected objects and enter a new value. The new value applies to all selected objects.

• Reorder interface and structure type element objects — Drag an element object to a new position, or select an element object and click the Move Up and Move Down buttons in the toolstrip.

• Copy, cut, and paste objects — Select an object and press keyboard shortcuts or click the corresponding buttons in the toolstrip.

• Delete objects — Select an element object and press the Delete key or click the Delete button in the toolstrip. When you delete an interface object, you also delete the interface element objects it contains.

For more information about using the Contents pane, see Manage Interfaces with Data Dictionaries (System Composer).

Version History

Introduced in R2023b

R2024a: Cut and paste in Architectural Data Editor

Cut and paste architectural data entries across permitted tabs and data dictionaries. Select the architectural data entry and click the Cut icon located in the Edit section of the Architectural Data Editor toolstrip. You can also right-click the architectural data entry and select the Cut option from the context menu, or use the keyboard shortcut Ctrl + X.

R2023b: Architectural Data Editor replaces Interface Editor (AUTOSAR Blockset)

In R2023b, the Architectural Data Editor replaced the Interface Editor (AUTOSAR Blockset) that was introduced in R2022b.