<?xml version='1.0' encoding='UTF-8' ?>
<!DOCTYPE html
  SYSTEM "about:legacy-compat">
<html xmlns:mml = "http://www.w3.org/1998/Math/MathML" lang = "en"><head><meta charset = "UTF-8"/><meta name = "copyright" content = "(C) Copyright 2020"/><meta name = "DC.rights.owner" content = "(C) Copyright 2020"/><meta name = "DC.type" content = "concept"/><meta name = "abstract" content = "The Choose Update File dialog box lets you apply changes in CAD files to the corresponding Composer (.smg or .smgXml) documents while preserving all 3D scene enrichments and animations."/><meta name = "description" content = "The Choose Update File dialog box lets you apply changes in CAD files to the corresponding Composer (.smg or .smgXml) documents while preserving all 3D scene enrichments and animations."/><meta name = "DC.format" content = "HTML5"/><meta name = "DC.identifier" content = "cps-c-ui-DialogBoxes-UpdateComposerDocument"/><meta name = "DC.language" content = "en"/><link rel = "stylesheet" type = "text/css" href = "../DSDocUI_XML34.css"/><title>Update Composer Document</title>
<script type = "text/javascript" src = "../DSDocUI_Highlight34.js">
  	/* */
  	</script></head><body onLoad = "highlightSearchTerms();" id = "cps-c-ui-DialogBoxes-UpdateComposerDocument">
<a name = "hj-top"> </a><table class = "table1" id = "table11"><tr><td><table class = "DocHeader"><tr><td class = "DocHeader1" colspan = "2"><h1>Update Composer Document</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">Choose Update File</span> dialog box lets you apply changes in CAD files to the corresponding Composer (<span class = "ph filepath filepath">.smg</span> or 
<span class = "ph filepath filepath">.smgXml</span>) documents while preserving all 3D scene enrichments and animations.</span>


<table class = "Remark" id = "table132"><tr><td class = "Remark"><span class = "run-in.important">Important:
				</span><span class = "notecontent"> Perform updates while in Animation 

<img class = "image" src = "../Icons3DVIA/I_CPSCameraVideo.png" title = "Animation Mode"/>
 
mode to avoid changes to collaborative actor visibility in animations.
</span></td></tr></table>
<p>To display this dialog box, click 
<span class = "ph uicontrol">File</span> 
<span class = "ph uicontrol">&gt; Update</span> 
<img class = "image" src = "../Icons3DVIA/I_CPSFileUpdate.png"/> 
<span class = "ph uicontrol">&gt; Composer Document</span> 
<img class = "image" src = "../Icons3DVIA/I_CPSFileUpdate.png"/>.</p><p>Updates work by matching net GUIDs (globally unique identifiers) of actors in the Composer file you are updating to those in the up-to-date CAD file. Net GUIDs are character strings that uniquely identify each actor and are based on actor names. For example, a car assembly has a 
<span class = "ph uicontrol">Door</span> subassembly and a 
<span class = "ph uicontrol">Handle</span> part. The net GUID for the handle is 
<span class = "ph uicontrol">ADoor-1.PHandle-1</span>, where 
<span class = "ph uicontrol">A</span> means assembly, 
<span class = "ph uicontrol">P</span> means part, and 
<span class = "ph uicontrol">-1</span> is the instance number.
</p><p>
<table class = "Remark" id = "table132"><tr><td class = "Remark"><span class = "run-in.important">Important:
				</span><span class = "notecontent"> Updates require that net GUIDs never change. Because net GUIDs are based on actor names, do not rename actors in the Composer document or CAD file and do not rearrange actors in the Composer Assembly tree. </span></td></tr></table>
</p><p>
<table class = "Remark" id = "table132"><tr><td class = "Remark"><span class = "run-in.tip">Tip:
				</span><span class = "notecontent"> You can view net GUIDs from the Properties pane; see 
<a class = "xref" href = "cps-r-Properties-Debug.htm#cps-r-Properties-Debug" title = "Debug properties give information about the selected actor, or the model if the background is selected, that can aid debugging.">Debug Properties</a>.

</span></td></tr></table>
<div class = "notes collapse"><span class = "run-in.notes">Notes:
    		</span><span class = "notecontent"/></div>
</p><ul class = "ul"><li class = "li">You can update from original CAD files or different versions of Composer 

<span class = "ph filepath filepath">.smg</span> or 
<span class = "ph filepath filepath">.smgXml</span> files.</li><li class = "li">New geometry is automatically added to and old geometry is automatically deleted from the updated file.</li><li class = "li">The 
<span class = "ph uicontrol">Define actor visibility in views by</span> option (see <a class = "xref" href = "cps-r-DocumentProperties-Update.htm#cps-r-DocumentProperties-Update" title = "The Update page lets you configure updates of your model geometry from CAD sources.">[Default] Document Properties - Update</a>) determines whether new actors resulting from updates are visible or hidden in views.
</li><li class = "li">Some import options can affect net GUIDs; for example, for SOLIDWORKS files, you must select 
<span class = "ph uicontrol">Merge file in one actor by part</span>.</li><li class = "li">
 For SOLIDWORKS and Pro/ENGINEER, update from the same assembly level only. Subassembly names might differ in Composer and these CAD systems (SOLIDWORKS and Pro/ENGINEER), in which case the update would fail.
</li><li class = "li">
Both geometry and meta-properties are updated.
</li><li class = "li">Significant changes in the CAD product structure, such as changing parent-child relationships, are not supported.</li><li class = "li">When updating sub-parts, updating the same instances under the same node is not supported. When a parent node has child nodes that are instances of the same object, only the first instance and its children are updated.
</li><li class = "li">Updates delete some objects, like assembly groups, primitives, and dummy objects, created in Composer inside the product structure unless created directly under the root node, because these objects do not exist in the CAD files. Updates also delete meta-properties created in Composer for the same reason; meta-properties from CAD files are retained.
</li><li class = "li">Kinematics (parent/child links) cannot be applied to actors in the Composer file.</li><li class = "li">When updating, use the same import options used to create the Composer file. You can view document import options from 
<span class = "keyword wintitle">Document Properties - Input</span>. See <a class = "xref" href = "cps-r-DocumentProperties-Input.htm#cps-r-DocumentProperties-Input" title = "The Input page lets you configure the importing of CAD files.">Input</a></li><li class = "li"><span class = "ph">Detail views (created with Digger, the High Resolution workshop, or the Technical
Illustration workshop) do not update automatically. You must manually update detail views.</span>
</li></ul></p>

</p></td></tr></table></td></tr></table>
<div class = "body conbody"><table class = "table frame-none"><caption/><colgroup><col/><col/></colgroup><thead class = "thead"><tr class = "row"><th class = "entry" id = "cps-c-ui-DialogBoxes-UpdateComposerDocument__entry__1">Command Name</th><th class = "entry" id = "cps-c-ui-DialogBoxes-UpdateComposerDocument__entry__2">Description</th></tr></thead><tbody class = "tbody"><tr class = "row"><td class = "entry" headers = "cps-c-ui-DialogBoxes-UpdateComposerDocument__entry__1"><span class = "ph uicontrol">Preview</span></td><td class = "entry" headers = "cps-c-ui-DialogBoxes-UpdateComposerDocument__entry__2">Displays a thumbnail image in the preview area. Previews are available for all 
<span class = "ph filepath filepath">.smg</span> files and other files previously opened in Composer.</td></tr><tr class = "row"><td class = "entry" headers = "cps-c-ui-DialogBoxes-UpdateComposerDocument__entry__1"><span class = "ph uicontrol">File name</span></td><td class = "entry" headers = "cps-c-ui-DialogBoxes-UpdateComposerDocument__entry__2">Specifies the CAD (or Composer) file from which you are updating. The default is the original CAD file from which the current Composer document was generated. Paths to original CAD files are stored in Composer files.
The scope of the actors to be updated depends on the input file you specify. For example, if you update a document with a sub-part file, only the sub-parts are modified.
<div class = "note collapse"><span class = "run-in.note">Note:
    		</span><span class = "notecontent"> If 
<span class = "ph uicontrol">Open .smg if it exists</span> (
<a class = "xref" href = "cps-c-cu-ApplicationPreferences-Input.htm#cps-c-cu-ApplicationPreferences-Input" title = "The Input page lets you customize how Composer loads models.">Application Preferences - Input</a>) is selected, the update uses the 
<span class = "ph filepath filepath">.smg</span> file with the same name in the same folder instead of the CAD file. You can update using the 
<span class = "ph filepath filepath">.smg</span> file or temporarily disable this option.</span></div>
</td></tr><tr class = "row"><td class = "entry" headers = "cps-c-ui-DialogBoxes-UpdateComposerDocument__entry__1"><span class = "ph uicontrol">Files of type</span></td><td class = "entry" headers = "cps-c-ui-DialogBoxes-UpdateComposerDocument__entry__2">Specifies the type of file. 
You can update from a Composer file or from a native CAD file.</td></tr><tr class = "row"><td class = "entry" headers = "cps-c-ui-DialogBoxes-UpdateComposerDocument__entry__1"><span class = "ph uicontrol">Recent folders</span></td><td class = "entry" headers = "cps-c-ui-DialogBoxes-UpdateComposerDocument__entry__2">Lists folders you have recently visited.</td></tr><tr class = "row"><td class = "entry" headers = "cps-c-ui-DialogBoxes-UpdateComposerDocument__entry__1"><span class = "ph uicontrol">SOLIDWORKS</span></td><td class = "entry" headers = "cps-c-ui-DialogBoxes-UpdateComposerDocument__entry__2">(Available if a SOLIDWORKS file is selected.) Specifies which configuration to open.
If the 
<span class = "ph uicontrol">Import meta-properties</span> import option is selected, the name of the selected configuration is added as a meta-property.
<div class = "note collapse"><span class = "run-in.note">Note:
    		</span><span class = "notecontent"> SpeedPak configurations are not supported.
</span></div>
</td></tr><tr class = "row"><td class = "entry" headers = "cps-c-ui-DialogBoxes-UpdateComposerDocument__entry__1"><span class = "ph uicontrol">Import</span></td><td class = "entry" headers = "cps-c-ui-DialogBoxes-UpdateComposerDocument__entry__2">Lets you configure native CAD imports. For details, see 
<a class = "xref" href = "cps-r-DocumentProperties-Input.htm#r-Import" title = "You can configure Import options.">Import</a>.</td></tr><tr class = "row"><td class = "entry" headers = "cps-c-ui-DialogBoxes-UpdateComposerDocument__entry__1"><span class = "ph uicontrol">Refinement</span></td><td class = "entry" headers = "cps-c-ui-DialogBoxes-UpdateComposerDocument__entry__2">Determines faceting precision, so parametrizes the density of polygons to tessellate the CAD model. For details, see <a class = "xref" href = "cps-r-DocumentProperties-Input.htm#r-Refinement" title = "Refinement settings determine how Composer tessellates (meshes) the model, which affects model accuracy.">Refinement</a>.</td></tr></tbody></table></div>
</td></tr></table><script type = "text/javascript" src = "../DSDocUI_Bottom34.js">/* */</script></body>
</html>
