About Update

Before running the Update, you should be familiar with the operations involved in such a process. This section describes how to configure and use the Update commands.

This page discusses:

Configure Preferences

The Update preferences can be configured to control the calculation of the update status and the update behavior at Save, as well as to determine whether error and warning messages should be displayed while the update is running.

See Update.

Update Command

The Update command in the standard area of the action bar runs the update process of the current root product.

  • Deactivated: up-to-date.
  • Activated: not up-to-date .
  • Activated with a red cross: not up-to-date with an error: .
  • Activated with a yellow triangle: not up-to-date with a warning .
  • Deactivated with a yellow triangle: up-to-date with a warning.

Context Commands

Context commands are available by selecting a product (active or not) or a representation (in a product app context) in the tree.

These commands are available regardless of the product update status.

By clicking a product or a representation, a context toolbar suggests the two following commands:

  • The Update command updates the selected product or representation while considering its relations and dependencies.
  • The Local Update command updates the selected product or representation while considering its relations only.

Right-clicking a product or a representation displays a context menu that proposes the two following commands:

  • The Update Assistant > Update command runs the Update Assistant for the selected product or representation considering all of its relations and dependencies.
  • The Update Assistant > Local Update command runs the Update Assistant for the selected product or representation considering its relations only.

Since the update status is calculated for each product before running the command, updating a product does not affect the update performance.

Update in Relational Design

The update takes modifications that are made to the design or the positioning into account.

  • The update process ignores modifications that do not affect the update of data.
  • The update process result is relevant when the icon is deactivated and the design is up to date; otherwise you are notified about inconsistencies.
  • The update process takes account of:
    • Deactivated components: warning messages are displayed for actors (product instances, components, engineering connections, etc.) pointing the deactivated components.
      Note: You can deactivate product instances using a product table.
    • Non-editable or not loaded components in session: warning messages are displayed for actors pointing the non-editable or not loaded components. Optionally you can open the considered component.
    • The network of engineering connections, gathering all engineering connections belonging to the same component: engineering connections pointing a non-editable, a not loaded or a deactivated component are ignored.
  • The update process takes the frozen maturity of product instances or components into account. Error messages indicating frozen product instances or components affected by the update are displayed.

    You can customize the business logic specific to the maturity of product instances using the dedicated INFRAMaturityStateInformation opening ID.

Update Assistant

The Update Assistant provides tools to understand encountered warnings or to update an assembly step by step.

The Update Assistant panel comprises two modes:

  • Global Update: all the dependencies that belong to the component to update and the update statuses for external dependencies are accounted for.
  • Local Update: only the dependencies that belong to the component to update are accounted for.

The Global Update option is selected.

The Activate 3D coloring option lets you color the dependencies according to the different statuses.

Dependency Status 3D Coloring
Up to date green
Up to date with warnings yellow
Component is out of date orange
Instance position is out of date purple
Component in error red

By default, the Activate 3D coloring option is selected.

Important:
  • Using the Local Update option, external dependencies appear semi-transparent.
  • By clicking a component in the 3D area or in the tree, the Selected Actor label is displayed with its current update status and the suggested to-do action.

The More Actions section provides tools to update your assembly step by step.

This section indicates the total number of steps and the next step to update.

  • Update Next: updates the next out of date step.
  • Update All: updates all steps.
  • Display Update Report: displays the Update Report dialog box.
  • Launch Update Wizard: runs the Update Wizard.
  • Update Graph: displays the dependency interactions between the assembly components in the PLM Update Graph panel. For more information, see About the PLM Update Graph.

Update Batch

A batch program is available to enable the update of specific components without opening a session: CATBatchPLMUpdate.

This batch allows you to run to update assembly components, or xCAD components from CATIA V5 or SOLIDWORKS V1, without opening session.

The Batches and Plug-in Methods section in the 3DEXPERIENCE Native Apps describes the common capabilities of the 3DEXPERIENCE batch monitor (remote mode, and so on).

See Running a Batch from the Command Line for more information.