getMetadata

R2026b

Get metadata for variable or connected data source

Since R2024a

Syntax

metadata = getMetadata(connectionObj)

metadata = getMetadata(connectionObj,varName)

Description

metadata = getMetadata(connectionObj) returns the metadata (for example, the name of the data source) for the connected data source connectionObj. The metadata provided depends on the type of connected data source.

metadata = getMetadata(connectionObj,varName) returns the metadata (for example, date last modified) for the variable varName and its connected data source connectionObj.

If the data connection can see multiple definitions of the same variable (for example, in a data dictionary and in a referenced dictionary), the function returns an array that contains metadata for each definition.

Examples

Get Metadata for Variable in Data Dictionary

dd = Simulink.data.connect("myDictionary.sldd");
md = getMetadata(dd,"x")

md = 

dictionary (string --> cell) with 5 entries

    "Source"                --> {'myDictionary.sldd'}
    "Section"               --> {'Design Data'}
    "LastModified"          --> {'2023-Jun-04 02:34:37.530062'}
    "LastModifiedBy"        --> {'user'}
    "Status"                --> {'Unchanged'}
    "isArchitecturalData"   --> {0}

Input Arguments

connectionObj — Connection to data source

Simulink.data.DataConnection object

Connection to data source, specified as a Simulink.data.DataConnection object.

varName — Variable name

string | character vector

Variable name, specified by a string or character vector.

Output Arguments

metadata — Metadata for variable and its data source

dictionary object | array of dictionary objects

Metadata for variable and its data source, returned as a dictionary object or an array of dictionary objects. The metadata provided depends on the type of connected data source.

Metadata for Base Workspace

Property Name	Value
Source	'base workspace'
Section	''

Metadata for MAT file

Property Name	Value
Source	MAT file name
Section	''

Metadata for Model Workspace

Property Name	Value
Source	Model name
Section	'model workspace'
DataSource	'Model File' | 'MATLAB code' | 'MAT File' | 'MATLAB File'

Metadata for Variable in Model Configurations

Property Name	Value
Source	Model name
Section	'Configurations'

Metadata for Data Dictionary (variable name specified)

Property Name	Value
Source	Name of data dictionary
Section	'Design Data'
LastModified	character vector
LastModifiedBy	character vector
Status	character vector
isArchitecturalData	Boolean — true when the variable corresponds to an entry in the Architectural Data or DDS Libraries sections, and false otherwise.
ArchitecturalObject (when the variable corresponds to an entry in the Architectural Data section)	Name of data object
DDSObject (when the variable corresponds to an entry in the DDS Libraries section)	Name of data object

Metadata for Data Dictionary (no variable name specified)

Property Name	Value
Section	'Design Data'
filepath	character vector
DataSources	cell array of data dictionary references
HasAccessToBaseWorkspace	boolean
EnableAccessToBaseWorkspace	boolean
HasUnsavedChanges	boolean
NumberOfEntries	integer

Metadata for Configurations Section of Data Dictionary (variable name specified)

Property Name	Value
Source	Name of data dictionary
Section	'Configurations'
LastModified	character vector
LastModifiedBy	character vector
Status	character vector

Metadata for Configurations Section of Data Dictionary (no variable name specified)

Property Name	Value
Section	'Configurations'
filepath	character vector
DataSources	cell array of data dictionary references

Version History

Introduced in R2024a