Registering User Exits

You can configure connector app to support User Exits. User Exits are customized function calls used by collaborative apps to do specific operations before or after certain functions in the application. A template is provided for each user function. These functions are delivered with the collaborative apps as UserExits.dll and must be programmed to perform the required tasks.

  1. Set the GCO attribute, IEF-UserExitEventRegistration, to comma-separated User Exit Registration values.

    The following table lists the supported user exit registration values for each command:

    CommandSupported values
    Checkin
    CheckinDialogPre,CheckinStart,CheckinPartPre,CheckinPartPost
    
    Checkout
    CheckoutPartPre,CheckoutPartPost,OpenPartPre,OpenPartPost
    
    AttribSynch
    UpdateAttributesInCADPre,UpdateAttributesInCADPost
    
    Notes:
    • In AutoCAD, OpenPartPost is called before opening each selected file during checkout.
    • User exits solution needs to be built using Microsoft Visual Studio 2012. For further customizing the user exits, use the source code from src_UserExitsProject.zip file which is located at <ConnectorForAutoCADClient-Installation-Folder>\UserExits.

  2. To register all possible User Exits, specify the following values in the GCO attribute, IEF-UserExitEventRegistration:

    CheckinDialogPre,CheckinStart,CheckinPartPre,CheckinPartPost,CheckoutPartPre,CheckoutPartPost,UpdateAttributesInCADPre,UpdateAttributesInCADPost,OpenPartPre,OpenPartPost
    
    Note: The following user exits are not called:
    • LockPartPre
    • LockPartPost

The User Exits are registered.

Note: If user exit functions fail, the corresponding operation is not aborted for the following user exits:
  • CheckinPartPost
  • CheckoutPartPost
  • OpenPartPost
  • UpdateAttributesInCadPost
Note: If user exits, OpenPartPre, fails while updating designs using global refresh from the PLM Status dialog box, an error message, "UserExits failed. UE_OpenPartPre. Global Refresh operation will still continue successfully." appears. The designs and the PLM information in the PLM Status dialog box are updated.
Note: You cannot implement user exit messages for objects of type ACAD Insert.