getMetadata

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. The metadata provided depends on the type of connected data source.

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

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

Metadata for variable and its data source, specified by a dictionary object.

Metadata for Base Workspace

Property Name	Value
Source	'base workspace'
Section	''

Metadata for Model Workspace

Property Name	Value
Source	Model name
Section	'model workspace'
DataSource	'Model File' | 'MATLAB code' | 'MAT-File' | 'MATLAB File'
ExternalFile	External file that stores or creates variables
isModelArgument (when the function specifies a variable name argument)	boolean

Metadata for Data Dictionary (variable name specified)

Property Name	Value
Source	Name of data dictionary
Section	'Design Data'
LastModified	string
LastModifiedBy	string
Status	string
isArchitecturalData	boolean — true when the variable corresponds to an entry in the Architectural Data or DDS Libraries sections
ArchitecturalObject (when 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	string
DataSources	cell array of data dictionary references
HasAccessToBaseWorkspace	boolean
EnableAccessToBaseWorkspace	boolean
HasUnsavedChanges	boolean
NumberOfEntries	integer

Version History

Introduced in R2024a