Eplan Platform API
EPLAN API / User Guide / API Framework / Add-ons / Shadow Copying
In This Topic
    Shadow Copying
    In This Topic

    Since version 2.6, EPLAN API assemblies are shadow copied, i.e. during registration, they are stored into a temporary folder, and loaded from there (See API Help: Shadow Copying API Assemblies).

    This concerns both add-ons and add-ins.

    In case of add-ons, the whole add-on's bin directory with subdirectories will be copied to the user application roaming directory (%appdata%\EPLAN\ShadowCopyAssemblies\Process-ID\Addon-Name). 

    Example :

     

     

                      Application roaming directory                                                                                          Process-ID

    So all files (*.dlls, *.xml etc.) and all bin subdirectories (language subdirectories etc.) are also copied. This is done when EPLAN starts and an add-on is registered or when an add-on is manually registered from Add-ons dialogue. 

    Eplan will load add-on's assemblies from the shadow directory and not from the original add-on directory. So an add-on could be updated without the need to stop all Eplan instances using the add-on.

     

    What EPLAN does ?

    At any start of EPLAN, the registry or the path for server add-ons is scanned for new add-ons. The install.xmlis read and the following things are done:

    ·      Does this add-on fit to the main version?

    ·      Is the correct license option booked?

    ·      Is the version correct?

    When everything is done so far EPLAN then:

    ·      registers the new add-on:

    ·      Read all *.xmlfiles from the CFGfolder. The settings are copied to the settings of the main version.

    ·      Read the eplset<applicationmodifer>.xml: All binaries defined there are loaded now.

    ·      Load the API modules.

    ·      Register the API references.

    ·      Register the scripts.

    ·      Copy the base data of the add-on to the base data of EPLAN.