Entering LCO Attribute Values

The Local Configuration Object (LCO) is created when a collaborative product is assigned to a user and includes defaults for that collaborative product as defined in the GCO.

When the user sets preferences (see the X-CAD Design Management User's Guide the values are stored in the LCO for that user.

Any changes made to a GCO after it has been assigned to a user will not be propagated to that user unless you also update assignments as described in Updating Assignments and Assigning GCO.

If you do not want users to be able to change values for certain attributes, set the "Rule to Apply" for the attribute to "Enforce To" in the GCO.


Before you begin:
  1. Run the following MQL commands.
    Run MQL from the Live Collaboration Server folder or from 3DSpace. For more information, see Installation and Setup | Administrate | 3DEXPERIENCE Platform | 3DSpace | Collaboration and Approvals | Administrative Utilities | Running MQL

    MQL>print MCADInteg-LocalConfig object of connected user

    MQL>print bus MCADInteg-LocalConfig <USER_NAME> TEAM

  2. Modify attributes of the MCADInteg-LocalConfig object of connected user using

    MQL>modify bus MCADInteg-LocalConfig <USER_NAME> TEAM <ATTRIBUTE_NAME> <ATTRIBUTE_VALUE>;

    For example:

    MQL>modify bus MCADInteg-LocalConfig user1 TEAM MCADInteg-PingInterval 2;

  3. Edit any of these attributes copied from the GCO as needed. The GCO prefaces the attribute names with IEF-Pref-.

    • IEF-IntegrationToGCOMapping
    • IEF-UseBulkLoading
    • MCADInteg-ShowDetailsPopUpOnCheckin
    • MCADInteg-SelectedDerivedOutputs
    • MCADInteg-CopyRelAttribOnCheckout
    • MCADInteg-CopyRelAttribOnCheckin
    • MCADInteg-UseZipInFileOperations
    • MCADInteg-ViewRegistryName
    • MCADInteg-CreateVersionOnCheckin
    • MCADInteg-SelectChildItems
    • MCADInteg-ApplyToChildren
    • MCADInteg-DeleteLocalFileOnCheckin
    • MCADInteg-LoadObjectsInCADTool
    • MCADInteg-CheckOutDirectory
    • MCADInteg-LockObjectOnCheckin
    • MCADInteg-LockObjectOnCheckout
    • MCADInteg-SelectFirstLevelChildren
    • IEF-BackgroundCheckinDirectory
    • IEF-EnableProgressiveLoading
    • MCADInteg-BackgroundCheckin
    • MCADInteg-DefaultTypePolicySettings
    • IEF-DefaultConfigTables
    • MCADInteg-WarnForFileOverwrite
    • MCADInteg-PreCheckInEvaluation
    • IEF-DefaultExpandLevel
    • IEF-AllowAutoGenerationForManualDerivedOutput
    • MCADInteg-PreCheckOutEvaluation
    • IEF-SelectedManualDerivedOutputs
    • IEF-SelectedBackgroundDerivedOutputs
    • IEF-UserDirectoryAlias-Mode
    • IEF-LocalCheckout
    • IEF-SelectRequiredChildren
    • IEF-DefaultVerticalView
    • IEF-DefaultLateralView
    • IEF-DefaultFolder
    • IEF-ApplyViewToChildrenOnly
    • IEF-DefaultWebforms
    • IEF-ImplicitlyIncludeUnrequiredChildren

    For details about the attributes, see Entering GCO Attribute Values.

  4. Edit any of these attributes that are not defined in the GCO:

    Attribute Description
    IEF-AppletFreeUI

    Function: You can use this attribute to choose Applet Free UI option. This can be used when the browser do not support the Applet UI.

    Possible Values:

    • True-- Applet Free UI is enabled.
    • False-- With Applet UI is enabled.

    For enabling Applet Free UI and it's prerequisites refer Prerequisite for Enabling Applet Free UI .

    IEF-DesignChangesReportInterval

    Function: Indicates the time interval in minutes after which the notification dialog for Design Change Report is displayed. Users can change this value on the Preferences page.

    Syntax: n

    where n is an integer.

    Default Value: 0

    MCADInteg-PingInterval

    Function: This attribute is used to set the interval between the pings of applet to server (to avoid time out).

    Syntax: n

    where n is an integer which signifies the time interval (in secs) to ping server to avoid timeout.

    Default Value: 1

    IEF-UserDirectoryAlias-Map

    Function: For CATIA users only, identifies the directories used as aliases.

    Syntax: MxCATIAV5|<<AliasName1>>=<<Absolutepath>>,<<AliasName2>>=<<Absolute Path>>

    Example:

    MXCATIAV5|out=c:\temp,in=c:\checkin

    where out and in are the alias directories

    MCADInteg-TurnOnDebug

    Function: Enables or disables debugging for both the server and the applet. Users can change this value in the Preferences page. The IEFAppletDebug.log is located in the User Profile directory and contains all debug statements related to the applet and to current user's session.

    Similarly, a the server log file is created in the application server which contains debug statements related to the servlet and to current user's session.

    Possible Values:

    • True--Debug messages written to a log file. Used for troubleshooting.
    • False--No debugging.

    Default Value: False

    IEF-RecentCheckinMaxFileDisplayed

    Function: Defines the maximum number of recently checked in files to display on the Recently Checked tab of the PowerView page.

    Syntax: nn

    where nn is an integer.

    Default Value: 50

    IEF-RecentCheckinFiles

    Function: Stores information about the recently checked in files for display in the Recently Checked tab of the PowerView page. This attribute is updated by the system and should not be edited.

    IEF-ClientSideRenamedFileDetails

    Function: For UGS NX, Pro/ENGINEER and CATIA collaborative products only, stores information about checked out objects that were affected by the Rename, Saved As, and Start Design functions. This attribute is updated by the system and should not be edited.

    Syntax: ENOVIA Type@RenamedObjectName|Filename

    IEF-SharedDrivesList

    Function: Stores the network location of the CAD files in which the user is working irrespective of the client machine. If user checks in a file from network path from one client machine then the network path will be recognized from another client machine with same X-CAD Design Management user. If more than one network path is used, they should be separated by comma.

    Syntax:

    If UNC path is used,

    \\mymachine\shared,\\commonmachine\outgoing\shared

    If Mapped Drive is used,

    X:\temp,Z:\

    (Where X:\ is mapped to <machine1>\<folder1> and Z:\ is mapped to <machine2>\<folder2>.

    IEF-DeleteFilesBehaviourOnCheckin

    Function: Determines whether all files on the checkin page or only those selected on the checkin page will be deleted after the checkin operation completes

    Possible Values:

    • Delete Selected Local Files--Only selected files will be deleted
    • Delete All Local Files--All files, even those with EXISTS and EXIST_TypeChange statuses, are deleted
    IEF-AutoRFAUpdate

    Function: The DSCAutoRFAUpdate process updates this attribute with a list of hardlinks that require updates based on the information in the working set compared to the last update of the actual design, see Configuring Automatic RFA Updates for details.

    IEF-AutoRFAUpdate attribute is updated by the system and should not be edited.

    IEF-PreferredIntegrationName

    Function: This flag is used to set the a preferred integration, that is used more frequently than others in case of multiple integrations. Once set, the page relevant for the integration set as preferred integration opens by default.

    Example: SolidWorks

    Once the flag is set to SolidWorks, the GCO Chooser page is not displayed for functions such as Start design or Design Change Report where the user needs to select the integration. The relavant page of the preferred integration directly opens.

    IEF-EBOMSync-ObjectAttrMapping

    Function: Maps attribute values from the CAD object to the corresponding Part object. Each line in this attribute value defines the mapping of 1 CAD object attribute to the associated Part object attribute, and the attribute can contain as many lines as needed.

    Syntax: CADType1|Attr1|PartType1|Attr2

    Example:

    SW Component|Test01|Part|Test01

    SW Assembly|Test01|Part|Test01

    SW Drawing|Test01|Part|Test01

    These attribute mappings can be added / modified / removed by the user using the local preference settings.

    IEF-EBOMSync-RelAttrMapping

    Function: Maps attribute values from the CAD relation to the corresponding Part relation. Each line in this attribute value defines the mapping of 1 CAD relation attribute to the associated Part object attribute, and the attribute can contain as many lines as needed.

    Syntax: CAD Rel1|Attr1|PartRel1|Attr2

    If using 3DLive, enter this value:

    CAD SubComponent|Spatial Location|EBOM|Component Location