
<!DOCTYPE html
  PUBLIC "html5" "about:legacy-compat">
<html xml:lang="en" lang="en">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
<meta name="copyright" content="(C) Copyright 2012"/>
<meta name="DC.rights.owner" content="(C) Copyright 2012"/>
<meta name="DC.Type" content="concept"/>
<meta name="DC.Title" content="Meta-Properties"/>
<meta name="abstract" content="The Meta-Properties dialog box lets you manage CAD metadata and user-defined properties."/>
<meta name="description" content="The Meta-Properties dialog box lets you manage CAD metadata and user-defined properties."/>
<meta name="DC.Format" content="XHTML"/>
<meta name="DC.Identifier" content="cps-c-ui-DialogBoxes-MetaProperties"/>
<meta name="DC.Language" content="en"/>
<link rel="stylesheet" type="text/css" href="../DSDocXML.css"/>
<title xmlns:mml="http://www.w3.org/1998/Math/MathML">Meta-Properties</title>
<script xmlns:mml="http://www.w3.org/1998/Math/MathML" type="text/javascript" src="../DSDocHighlight.js">
  	/* */
  	</script></head>
<body onLoad="highlightSearchTerms();" id="cps-c-ui-DialogBoxes-MetaProperties">
<a xmlns:mml="http://www.w3.org/1998/Math/MathML" name="hj-top"> </a><table xmlns:mml="http://www.w3.org/1998/Math/MathML" class="table1" id="table11"><tr><td><table class="DocHeader"><tr><td class="DocHeader1" colspan="2"><h1>Meta-Properties</h1></td></tr><tr><td class="DocHeader4" colspan="2"/></tr><tr><td class="DocHeader3" colspan="2"><table class="DocThemeIntro" id="table12"><tr><td class="Intro1Only"><p class="header"><p class="abstract"><span class="shortdesc">The <span class="keyword wintitle">Meta-Properties</span> dialog box lets you manage CAD metadata and user-defined properties.</span>
<p>To display this dialog box, click 
<span class="ph uicontrol">Manage Meta-Properties 
<img class="image" src="../Icons3DVIA/I_CPSPropertiesAddMetadata.png"/></span> in the Properties pane toolbar.</p><p>The following topics are discussed:</p></p>
<ul><li><a href="#c-GeneralInformation" id="toc_rg" title="Meta-properties have a number of similarities with regular properties.">General Information</a></li><li><a href="#c-Definition" id="toc_rg" title="">Definition</a></li><li><a href="#c-Property" id="toc_rg" title="">
Property

</a></li><li><a href="#c-ExampleXMLDescription" id="toc_rg" title="The following example shows meta-property definitions defined in a .smgXml file.">
Example XML Description
</a></li></ul>
</p></td></tr></table></td></tr></table>

<div class="topic concept nested1" id="c-GeneralInformation"><h2 class="title topictitle2">General Information</h2>

<div class="body conbody"><p class="abstract"><span class="shortdesc">Meta-properties have a number of similarities with regular properties.</span>
</p>
<ul class="ul"><li class="li">View and edit meta-properties in the Properties pane. CAD metadata and user-defined properties are listed under 
<span class="ph uicontrol">User properties</span>.</li>
<li class="li">Change meta-property values as needed in views or during animations.</li>
<li class="li">Meta-property definitions and neutral values are stored in Composer 
<span class="ph filepath">.smgXml</span> files. Meta-property values for views and animations are stored in 
<span class="ph filepath">.smgView</span> and 
<span class="ph filepath">.smgSce</span> files, respectively.
</li>
</ul>
<p>Create user-defined properties to add complementary information to products.</p><p>For metadata from customer systems, such as PLM environments, a Composer integration is required to extract the correct metadata. Create an XML file to describe your meta-properties (see 
<a class="xref" href="cps-c-ui-DialogBoxes-MetaProperties.htm#c-ExampleXMLDescription" title="The following example shows meta-property definitions defined in a .smgXml file.">Example XML Description</a> below).</p><div class="section" id="c-GeneralInformation__cs-CreationofMetaProperties"><h3 class="title sectiontitle">Creation of Meta-Properties</h3><p>To create a meta-property, click 
<img class="image" src="../CpsUserImages/ProfileNew.png"/>. In the <span class="keyword wintitle">Create meta-property</span> dialog box, type the property name and click 
<span class="ph uicontrol">OK</span>.

<p>Note:
		 Meta-properties must have a 
<span class="ph filepath">"Meta."</span> prefix. The prefix is added automatically when you create a meta-property from this dialog box. If you create XML to import meta-properties, ensure that the property names start with 
<span class="ph filepath">"Meta."</span>.</p>
</p></div>
<div class="section" id="c-GeneralInformation__cs-DeletionofMetaProperties"><h3 class="title sectiontitle">Deletion of Meta-Properties</h3><p>To delete a meta-property, click 
<img class="image" src="../CpsUserImages/ChoiceList.png"/>, select the meta-property to delete, click <img class="image" src="../CpsUserImages/ProfileDelete.png"/> and then click <span class="ph uicontrol">Yes</span>.<table class="Remark" id="table132"><tr><td class="Remark"><span class="run-in">Warning:
				</span> Deleting a meta-property removes the property from all actors.
</td></tr></table>
</p></div>
</div>
</div>
<div class="topic concept nested1" id="c-Definition"><p><map name="FPMap1"><area href="#hj-top" title="Back to Top" shape="rect" coords="416, 0, 435, 10"/></map><img border="0" src="../IconsReference/butix_top_wline.png" width="436" height="11" usemap="#FPMap1"/></p><h2 class="title topictitle2">Definition</h2>
<div class="body conbody"><p class="abstract"><span class="shortdesc"/>
</p>

<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" class="table" frame="void" border="1" rules="all"><thead class="thead" align="left"><tr class="row"><th class="entry" valign="top" id="d22205e109">Command Name</th>
<th class="entry" valign="top" id="d22205e111">Description</th>
</tr>
</thead>
<tbody class="tbody"><tr class="row"><td class="entry" valign="top" headers="d22205e109 "><span class="ph uicontrol">Name</span></td>
<td class="entry" valign="top" headers="d22205e111 ">Shows the name of the meta-property you are creating, or an existing meta-property you selected by clicking 
<img class="image" src="../CpsUserImages/ChoiceList.png"/>.

<p>Notes:
		<ul class="ul"><li class="li">A meta-property name can only contain Latin alphanumeric characters.</li>
<li class="li">You cannot modify the definition of existing meta-properties. When you select an existing meta-property, all fields are read-only.
</li>
<li class="li">For  technical illustrations generated in the CGM format, and compliant with the S1000D 4.x standard,  <span class="ph filepath">CGM_ApplicationStructureIdent</span>, <span class="ph filepath">CGM_ApplicationStructureName</span>, <span class="ph filepath">CGM_Id</span>, and <span class="ph filepath">CGM_hotspotTitle</span> specify  the value used in the XML companion file for the corresponding attribute of the hotspot element.  See <a class="xref" href="cps-r-Workshops-TechnicalIllustration.htm#r-OptionsTab" title="The Options tab lets you manage output page format, CGM options, and Tech Illustrator options.">Options Tab</a>.</li>
</ul>
</p>
</td>
</tr>
<tr class="row"><td class="entry" valign="top" headers="d22205e109 "><span class="ph uicontrol">Label</span></td>
<td class="entry" valign="top" headers="d22205e111 ">Specifies the name of the meta-property without the 
<span class="ph filepath">"Meta."</span> prefix.
<p>Note:
		The label corresponds to the text that is displayed in Composer wherever the meta-property is used (Properties pane, workshops, etc.). You can use non-Latin alphanumeric characters for this label.</p>
</td>
</tr>
<tr class="row"><td class="entry" valign="top" headers="d22205e109 "><span class="ph uicontrol">Type</span></td>
<td class="entry" valign="top" headers="d22205e111 ">Specifies the property data type, which determines the values you can assign the property. Select one of the following:
<ul class="ul"><li class="li">
<span class="ph uicontrol">String</span>
</li>
<li class="li">
<span class="ph uicontrol">Bool</span> (Boolean true or false)
</li>
<li class="li">
<span class="ph uicontrol">Int</span> (integer)
</li>
<li class="li">
<span class="ph uicontrol">Float</span> (floating point number)
</li>
<li class="li">
<span class="ph uicontrol">Date</span>
</li>
<li class="li">
<span class="ph uicontrol">Color</span>
</li>
</ul>
</td>
</tr>
<tr class="row"><td class="entry" valign="top" headers="d22205e109 "><span class="ph uicontrol">Animatable</span></td>
<td class="entry" valign="top" headers="d22205e111 ">Allows the meta-property to change during animations. The Properties pane marks properties that cannot be animated with 
<img class="image" src="../CpsUserImages/PropertyCannotAnimate.png" title="Cannot Animate"/>.</td>
</tr>
<tr class="row"><td class="entry" valign="top" headers="d22205e109 "><span class="ph uicontrol">Mergeable</span></td>
<td class="entry" valign="top" headers="d22205e111 ">Specifies the property is mergeable. When cleared, Composer hides the property with merging actors with different property values.
</td>
</tr>
<tr class="row"><td class="entry" valign="top" headers="d22205e109 "><span class="ph uicontrol">Visible</span></td>
<td class="entry" valign="top" headers="d22205e111 ">Displays the property in the Properties pane.
</td>
</tr>
<tr class="row"><td class="entry" valign="top" headers="d22205e109 "><span class="ph uicontrol">Unit</span></td>
<td class="entry" valign="top" headers="d22205e111 ">(Available when 
<span class="ph uicontrol">Type</span> is 
<span class="ph uicontrol">Int</span> or 
<span class="ph uicontrol">Float</span>.) Specifies the units for integer and floating-point properties.
</td>
</tr>
<tr class="row"><td class="entry" valign="top" headers="d22205e109 "><span class="ph uicontrol">Bounded</span></td>
<td class="entry" valign="top" headers="d22205e111 ">(Available when 
<span class="ph uicontrol">Type</span> is 
<span class="ph uicontrol">Int</span> or 
<span class="ph uicontrol">Float</span>.) Specifies minimum (<span class="ph uicontrol">Min</span>) and maximum (<span class="ph uicontrol">Max</span>) values for integer and floating-point properties.
</td>
</tr>
</tbody>
</table>
</div>
</div>
</div>
<div class="topic concept nested1" id="c-Property"><p><map name="FPMap1"><area href="#hj-top" title="Back to Top" shape="rect" coords="416, 0, 435, 10"/></map><img border="0" src="../IconsReference/butix_top_wline.png" width="436" height="11" usemap="#FPMap1"/></p><h2 class="title topictitle2">
Property

</h2>
<div class="body conbody"><p class="abstract"><span class="shortdesc"/>
</p>

<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" class="table" frame="void" border="1" rules="all"><thead class="thead" align="left"><tr class="row"><th class="entry" valign="top" id="d22205e268">Command Name</th>
<th class="entry" valign="top" id="d22205e270">Description</th>
</tr>
</thead>
<tbody class="tbody"><tr class="row"><td class="entry" valign="top" headers="d22205e268 "><span class="ph uicontrol">Include the meta-property to the selection
</span></td>
<td class="entry" valign="top" headers="d22205e270 ">Adds the new meta-property to the  selected actors.
</td>
</tr>
</tbody>
</table>
</div>
</div>
</div>
<div class="topic concept nested1" id="c-ExampleXMLDescription"><p><map name="FPMap1"><area href="#hj-top" title="Back to Top" shape="rect" coords="416, 0, 435, 10"/></map><img border="0" src="../IconsReference/butix_top_wline.png" width="436" height="11" usemap="#FPMap1"/></p><h2 class="title topictitle2">
Example XML Description
</h2>
<div class="body conbody"><p class="abstract"><span class="shortdesc">The following example shows meta-property definitions defined in a 
<span class="ph filepath">.smgXml</span> file.</span>

</p>
<p>
<p>Note:
		 Meta-property names must have a 
<span class="ph filepath">Meta.</span> prefix.</p>
</p><p>
<span class="ph filepath">&lt;Server Type="PropertyDefinitions"&gt;</span>
   
<span class="ph filepath">&lt;MetaProperties&gt;</span>
     
<span class="ph filepath">&lt;Meta Name="Meta.Description" Type="String" DefaultLabel="Description" Mergeable="1" AnimAble="1" VizAble="1" VizOrder="-1"/&gt;</span>
     
<span class="ph filepath">&lt;Meta Name="Meta.PartNumber" Type="String" DefaultLabel="PartNumber" Mergeable="1" AnimAble="1" VizAble="1" VizOrder="-1"/&gt;</span>
     
<span class="ph filepath">&lt;Meta Name="Meta.Revision" Type="String" DefaultLabel="Revision" Mergeable="1" AnimAble="1" VizAble="1" VizOrder="-1"/&gt;</span>
   
<span class="ph filepath">&lt;/MetaProperties&gt;</span>

<span class="ph filepath">&lt;/Server&gt;</span>

<span class="ph filepath">......</span>

<span class="ph filepath">......</span>

<span class="ph filepath">&lt;Actor.Name Value="F0189-CAGE-E1.1"/&gt;</span>

<span class="ph filepath">&lt;Meta.PartNumber Value=</span>
<kbd class="ph userinput">"67725"
</kbd><span class="ph filepath">/&gt;</span>

<span class="ph filepath">&lt;Meta.Revision Value="</span>
<kbd class="ph userinput">1.a</kbd>
<span class="ph filepath">"/&gt;</span></p><p>
You can also store Meta-property definitions in separate 
<span class="ph filepath">.smgMeta</span> files to facilitate reuse. For example, a 
<span class="ph filepath">.smgXml</span> file can reference a meta-property definition file:


<span class="ph filepath">&lt;Server Type="PropertyDefinitions" FileName="metas.smgMeta"/&gt;</span>

where 
<span class="ph filepath">metas.smgMeta</span> contains:

   
<span class="ph filepath">&lt;MetaProperties&gt;</span>
     
<span class="ph filepath">&lt;Meta Name="Meta.Description" Type="String" DefaultLabel="Description" Mergeable="1" AnimAble="1" VizAble="1" VizOrder="-1"/&gt;</span>
     
<span class="ph filepath">&lt;Meta Name="Meta.PartNumber" Type="String" DefaultLabel="PartNumber" Mergeable="1" AnimAble="1" VizAble="1" VizOrder="-1"/&gt;</span>
     
<span class="ph filepath">&lt;Meta Name="Meta.Revision" Type="String" DefaultLabel="Revision" Mergeable="1" AnimAble="1" VizAble="1" VizOrder="-1"/&gt;</span>
   
<span class="ph filepath">&lt;/MetaProperties&gt;
</span></p>
<p>Note:
		 The 
data-path mechanism is used to locate external meta-property files. See <a class="xref" href="cps-c-cu-ApplicationPreferences-DataPaths.htm#cps-c-cu-ApplicationPreferences-DataPaths" title="Data paths are sorted lists of paths used to locate resources such as files, profiles, and links. The application uses data paths to resolve external references when the relative path of a resource cannot be found.">Data Paths</a>.</p>
</div>
</div>

</td></tr></table><script xmlns:mml="http://www.w3.org/1998/Math/MathML" type="text/javascript" src="../DSDocStats.js">/* */</script></body>
</html>