About Cables Synchronization

The synchronization between your cables and their cable routes persists the routing information of your cable routes to your cables.

This page discusses:

See Also
Synchronizing Cables with Cable Routes

Persisted Information

When you route your cables, routing information stored in the attributes of your cable routes are modified. Synchronizing your cables with your cable routes ensures that the routing information validated for your cable routes is stored on your cables.

During a synchronization, the routing information that is persisted to a cable is the following:

Routing Information Retrieved from cable route's attribute Stored in the cable's attribute
Validation status ValidationStatus ListRouteValidation

This attribute is an ordered list of the validation status of every cable route owned by a cable.
Route status ValidatedRouteStatus ListRouteStatus

This attribute is an ordered list of the route status of every cable route owned by a cable.
Route length ValidatedLength ListRouteLength

This attribute is an ordered list of the length of every cable route owned by a cable.
Itinerary elements ValidatedItinerary Itinerary

This attribute is an ordered list of the supports and junction points that belong to the itinerary of a cable route.
Itinerary length ValidatedItineraryLength ItineraryLength

This attribute lists the lengths between the ends of itinerary elements.

Cable Manager Assistant Panel

The Cable Manager Assistant panel provides in a table a complete view of the attributes of your cables and cable routes.

This panel helps you synchronize routing information. It also provides additional commands that are useful in the synchronization process.

Table. See Columns Description.
Commands. See Command Bar.
Preferences. See Preferences.

Columns Description

Cable View tab

Name of the column Description
Cable Instance name of the cable.

The following icons can be displayed:

  • : all cable routes belonging to the cable are available in session.
  • : at least one cable route belonging to the cable is not available in session.
  • : the cable is not editable.
  • : the cable is not editable and at least one of its cable routes is not available in session.
Sync Status Indicates the synchronization status of a cable.

Icons and labels help you understand the synchronization status.

Icons:

  • : new information is available on cable routes previously synchronized.
  • : synchronized cable routes are in revision or are unvalidated.
  • : non-synchronized cable routes are now validated and ready for synchronization.

Labels:

  • Updates Available: New information is validated on the cable routes, and it is possible to persist this information to the cable.
  • No updates available: The cable is synchronized with all its cable routes.
Validation Status Indicates the global validation status of a cable.

This global status is a combination of all the validation status of cable routes stored in the cable's ListRouteValidation attribute.

A colored icon summarizes this combination based on the validation status of cable routes available in the Cable Route View.

The status can be:

  • Fully validated: on the cable, all cable routes have a "Fully validated" validation status.
  • Partially validated: on the cable, at least one cable route has a "Fully validated" route status and at least one cable route has a "Not validated" validation status.
  • Not validated: on the cable, all cable routes have a "Not validated" validation status.
Route Status Indicates the global route status of a cable.

This global status is a combination of all the route status of cable routes stored in the cable's ListRouteStatus attribute.

The status can be:

  • Fully routed: on the cable, all cable routes have a "Fully routed" route status.
  • Partially routed: on the cable, at least one cable route has a "Fully routed" route status and at least one cable route has a "Not routed" route status.
  • Not routed: on the cable, all cable routes have a "Not routed" route status.

For cables without From and To extremities, the route status cannot be Fully Routed.
Extra Length From Indicates the extra length of a cable from the start extremity.
Note: To edit this value, double-click the cell or right-click the cell and select Extra Length > Edit Extra Length From.
Extra Length To Indicates the extra length of a cable from the end extremity.
Note: To edit this value, double-click the cell or right-click the cell and select Extra Length > Edit Extra Length From.
Length Indicates the global length of a cable.

This global length is the sum of all the lengths of the cable routes stored in the cable's ListRouteLength attribute, plus the Boundary Length From value and the Boundary Length To value.
Cutting Length Indicates the cutting length of a cable specified while creating it.

The business rule,EWR_Compute_CableCuttingLength, is executed to compute the cutting length.

An icon appears if the cutting length is greater than 0 and less than the design length.

Note: To edit this value, double-click the cell or right-click the cell and select Cutting Length > Edit Cutting Length.
Cutting Length Mode Indicates the cutting length mode of a cable, Automatic or Manual. By default, the cutting length mode is Automatic.

  • Automatic: When this mode is selected:
    • A business rule, EWR_Compute_CableCuttingLength is executed to compute cutting length.
    • If the business rule is not available, cutting length and cutting length itinerary are computed and updated automatically according to cutting length formula.
    • Cutting length and cutting length itinerary are computed and updated after sync, cable route estimation, extra length modification, boundary length modification, tolerance value modification, and cutting length mode change.
  • Manual: When this mode is selected:
    • Cutting length needs to be set and updated manually
    • Cutting length attribute is editable in Electrical tab of the properties, cable management assistant, spread sheet, and knowledge function.

You can specify whether to keep the mode editable using preferences. For more information, see Cutting Length.

Note: To edit this value, double-click the cell or right-click the cell and select Cutting Length > Edit Cutting Length Tolerance.
Cutting Length Tolerance Indicates the cutting length mode of a cable specified while creating a cable. By default, the cutting length tolerance is 0%.
Note: To edit this value, double-click the cell or right-click the cell and select Cutting Length > Edit Cutting Length Tolerance.
From Start extremity of the cable.

If the device is not loaded in session, a warning icon and the label "Not Loaded" appear.
Boundary Length From Cable length inside its start extremity.
Note: To edit this value, double-click the cell or right-click the cell and select Boundary Length > Edit Boundary Length From.
To End extremity of the cable.

If the device is not loaded in session, a warning icon and the label "Not Loaded" appear.
Boundary Length To Cable length inside its end extremity.
Note: To edit this value, double-click the cell or right-click the cell and select Boundary Length > Edit Boundary Length To.
Segregation Segregation attribute of the cable.
Diameter Diameter value of the cable.
Bend Radius Bend radius value of the cable.
Reference Name of the reference cable of the cable.
Electrical System Electrical physical system aggregating the cable.
Maturity Maturity state of the cable reference.

Cable Route View Tab

Name of the column Description
Cable Instance name of the cable that owns the cable route.
Route Name of the cable route.

If the cable route is not loaded in session, a label "Not Loaded" appears.

Sync Status Indicates the synchronization status of a cable route stored in its cable.

Information in the column helps you understand if a cable route is synchronized with its cable.

Icons and labels:

  • New version available: appears when, for a previously synchronized cable route, new validated information is available (For example, a new itinerary is defined and validated).

    Synchronization is available.

  • In revision: appears when, for a previously synchronized cable route, the validation status is now "Not validated" (For example, the itinerary is modified and not validated).

    Synchronization is not available.

  • Ready for sync: the cable route is validated but is not synchronized with its cable.

    Synchronization is available.

  • Up to date: routing information between the cable route and its cable is synchronized.

    Synchronization is not available.

  • Not loaded: the cable route is not loaded in session.

    Synchronization is not available.

  • Route not found: the connection between the cable route and its cable is broken or not valid.

    Synchronization is not available.
Validation Status Indicates the validation status of a cable route stored in its cable's ListRouteValidation attribute.

A colored icon summarizes this status based on the Validation status and Route status of the cable route. The following colors can appear:

  • : the cable route is routed and fully validated. This color appears when a fully routed and validated cable route is synchronized.
  • : the cable route is not routed but is validated. This color appears if you edit the length of a cable route to specify an estimated value.
  • Not validated: the cable route is not validated and not routed. This color appears when you unsynchronize a cable route.

Status can be:

  • Validated: on the cable, the cable route has a "Fully validated" validation status.
  • Not validated: on the cable, the cable route has a "Not validated" validation status.
Validation Status Indicates the validation status of cable routes.

The following status can appear:

  • Validated
  • Not validated
  • In revision

For more information, see Validating Cable Routes
Route Status Indicates the route status of a cable route stored in its cable's ListRouteStatus attribute.

Status can be:

  • Routed: appears when you synchronize a cable route that is routed and validated.
  • Partially routed: appears when you synchronize a cable route that is broken and validated.
  • Not routed
Route Status Indicates the last route status that is validated for a cable route.

The route status can be Routed, Broken, Not Routed.
Length Indicates the length of a cable route stored in its cable's ListRouteLength attribute.
Important: You can specify an estimated length by double-clicking the cell.

When a length is provided by the user, the validation status of the cable route stored on the cable's ListRouteValidation attribute becomes: Validated.
Length Indicates the length of a cable route stored during the validation of its route.
From Start extremity of the cable route.

If the device is not loaded in session, a warning icon appears in the empty cell.
To End extremity of the cable route.

If the device is not loaded in session, a warning icon appears in the empty cell.
Segregation Segregation attribute of the cable.
Diameter Diameter value of the cable.
Bend Radius Bend radius value of the cable.
Reference Name of the cable's reference cable.
Electrical System Electrical physical system aggregating the cable that owns the cable route.
Electrical System Electrical physical system aggregating the cable route.
Maturity Maturity state of the cable reference.

Note: In both the tabs, a blue triangle in the upper-left corner of a cell indicates that the value can be modified:

Double-clicking the cell lets you edit the value.

Customized Columns

Additional customized information can be displayed in the panel thanks to two opening IDs:

In the panel, customized columns are identified with the following icon: .

Preferences

In the 3D area, a color is applied to the cable routes of a selected cable to distinguish the various synchronization status of the cable routes.

You can modify the predefined colors by accessing the Preferences from the top-right corner of the panel.

Under Synchronization Status, clicking a color displays a color picker in which you define your own color.

Command Bar

In the panel, a bar provides the following commands:

Synchronize Cables Synchronizes a cable with all its cable routes to persist routing information from the cable routes to their cable.

The synchronization fails if:

  • The cable is not editable.
  • No updates are available.

The command also computes the route status, validation status, and design length for the cable based on the attributes of its cable routes.

Important: Only validated cable routes are synchronized. Cable routes with the following validation status are ignored:
  • Not validated
  • Partially validated
Unsynchronize Cables Removes the synchronized information from a cable and reset its default values.

The default values are:

  • Validation status: Not validated
  • Route status: Not routed
  • Length: 0
  • Itinerary length and elements are deleted from the cable.

The command fails if:

  • The cable is not editable.
  • The cable is not synchronized.
Load Cables Missing Information Loads the missing end devices, cable routes, or cables.

A "Not found" label appears in the cells if the loading fails.
Routing Assistant Opens the Routing Assistant panel to edit the itinerary of cable routes.

For more information, see Managing Cable Routes.
Associate Junction points Opens the Associate Junction Point panel.

For more information, see Associating Junction Points with Cables.
Replace with Major Revision Creates a version of the cable and replaces the existing version with this new version.

The command is not available for read-only cables.
Generate Report Generates a detailed report of the information provided in the panel in an Excel file.

In the report, the column Itinerary elements provides the following additional information:

  • List of the elements (supports and junction points) that belong to the itinerary of a cable route
  • List of the lengths between the connection points of these elements

Note: Filters and display refinement are not taken into account in the report.
Tip: Before generating a report, click Update Attributes to ensure the information provided in the panel is up-to-date according to the last actions impacting your cables and their routes.

Synchronization Using the Enterprise Knowledge Language

You can use methods on the Elec3DCable type to synchronize your cables.

The following methods are available:

You can combine these methods with the opening ID Execution Triggered During Conductor Validation Status Change (EWR_ChangeConductorValidation). Thanks to this opening, the methods are called during the validation of a cable route, and you can synchronize a cable with its cable routes without using the Cable Management Assistant.

This methodology is useful when a cable has a single cable route or when all its cable routes are aggregated under the same electrical physical system.