The API Parts Management Extension feature can be used to add you own custom information to parts stored in the EPLAN parts database. It is meant for information, which you don't want to set as part properties.
You store this information in your own database and can attach it to the part and visualize it. When a part which references such custom information is exported or stored in a project, the information is stored as a sting in the indexed properties ARTICLE_CUSTOM_DATA_INDEX and ARTICLE_CUSTOM_DATA_VALUE. The first property contains the name of the add-in to which the information belongs, the second property contains the data string at the same index position.
To use this feature, you need to call the methods MDPartsManagement.RegisterAddin(<Add-inName>, <ActionName>) and MDPartsManagement.RegisterItem(<Add-inName>, <ItemType>) in your add-in. As <ItemType> you set the string "eplan.part"(There is also the possibility to register other custom items in the parts management tree, by setting other values for<ItemType>.). As <Add-inName>, you set the assembly name of your add-in, which is normally the dll title without the extension dll. In your add-in, you implement an action with the name you set in the parameter <ActionName>.
Upon this, your action is called on different events in the parts management. It has a different set of parameters passed in the ActionCallingContext on each occasion. The parameter 'action' tells you, which kind of 'event' is called. The parameter can contain the following values:
"Action" value | Description | Parameters | |
---|---|---|---|
input | output | ||
GetRootLevel | The first tree level is requested. | itemtype : type of item for which the root node is requested | key : identifying key text : text to display in the tree subnode : (bool) are further sub nodes available ? (1 : yes, 0 : no) |
GetNextLevel | The next level of the tree is requested. | itemtype : type of item which is expanded in the tree key : node, below which the next tree level is requested |
key : Identifying key text : text to display in the tree subnode : (bool) are further sub nodes available ? (1 : yes, 0 : no) |
CreateDatabase | A new parts database was created. | database : name of the created database | |
OpenDatabase | A new parts database was opened. | database (string) : name of the newly opened database readonly =(bool) read-only status of the opened parts database (1 : read-only, 0 : read/write |
|
CloseDatabase | The current database was closed. | ||
SelectItem | An item / part was selected in parts management. | itemtype : type of item of the selected element partnr : selected part number (if only one part is selected) variant : selected part variant ((if only one variant is selected) key : identifying key of the selected element |
|
PreShowTab | An item/part was selected in parts management.You have now the possibility to show/hide tab sheets, which are registered for this element. | itemtype : type of item of the selected element partnr : selected part number (if only one part is selected) variant : selected part variant ((if only one variant is selected) key : identifying key of the selected element tabsheet : tab sheet, to be checked. The tab sheet was previously registered using MDPartsManagement.RegisterTabsheet(...) |
show : (bool) should the tab sheet be displayed? (1 : yes (default), 0 : no) |
SaveItem | An item/part was saved in parts management. | partnr : selected part number (if only one part is selected) variant : selected part variant ((if only one variant is selected) itemtype : type of item of the selected element key : identifying key of the selected element |
|
CopyItem | An item/part was copied in parts management (by the context menu items 'Copy' and 'Paste'). | itemtype : type of item of the copied element key : identifying key of the currently selected element (optional) sourcekey : identifying key of the element to copy |
|
CutCopyItem | An item/part was cut in parts management (by the context menu items 'Cut' and 'Paste'). | itemtype : type of item of the cut element key : identifying key of the currently selected element (optional) sourcekey : identifying key of the element to cut |
key : identifying key of the created element |
SelectCopyItem | The context menu item 'Copy' was clicked in parts management tree. | itemtype : type of item of the copied element key : identifying key of the selected element (optional) |
|
SelectCutItem | The context menu item 'Cut' was clicked in parts management tree. | itemtype : type of item of the cut element key : identifying key of the selected element (optional) |
|
SelectPasteItem | The context menu item 'Paste' was clicked in parts management tree. | itemtype : type of item of the pasted element key : identifying key of the selected element (optional) |
|
NewItem | An item/part was created in parts management. | itemtype : type of item of the newly created element key : identifying key of the currently selected element (optional) |
key : identifying key of the created element |
DeleteItem | item/part is being deleted from parts management. | itemtype : type of item of the currently selected to be deleted element partnr : selected part number (if only one part is selected) variant : selected part variant ((if only one variant is selected) key : identifying key of the element to be deleted |
|
AddPartToProject | A part from parts management is stored in the project. The add-in can add additional custom data to the stored part. | itemtype : type of the stored part (always 'eplan.part') key : identifying key of the stored part |
value = (string) custom part data to be stored with the part inside the project (In properties ARTICLE_CUSTOM_DATA_INDEX and ARTICLE_CUSTOM_DATA_VALUE). |
AddPartToDatabase | A part is synchronized from the project to the parts management. The additional custom data can now be extracted and stored by the add-in. | itemtype : type of the synchronized part (always 'eplan.part') key : identifying key of the synchronized part value : (string) custom part data which was stored with the part inside the project |
|
AddItemToProject | An item (part, manufacturer, drilling pattern, ...) is stored in the project. The add-in can add additional custom data to the stored item. | itemtype : item types of stored items (eplan.part, eplan.manufacturer, ...) key : identifying field of stored items name : name of the stored items (abbreviated name of the manufacturer, name of drilling pattern, ...) |
value = (string) custom data which was stored with an item inside a project (in properties ARTICLE_CUSTOM_DATA_INDEX and ARTICLE_CUSTOM_DATA_VALUE). |
ExportEplanItem | A part is exported from parts management to a file. The additional custom data from the add-in can now be added to the export file. | itemtype : type of the item to export (always 'eplan.part') key : identifying key of the part to export |
value : (string) custom part data to be added to the export file |
ImportEplanItem | A part is imported to parts management. The additional custom data from the file can now be extracted and stored by the add-in. | itemtype : type of the part to import (always 'eplan.part') key : identifying key of the imported part mode : import mode. Possible values: 0: append new records only 1: update existing records only 2: update existing records and append new ones value : (string) custom part data to be extracted from the file and stored by the add-in. |
|
ExportCustomItem | All custom items of the respective itemtype are exported from parts management. Please mind, that this only works with the XML export (Converter:"XPamExportXml"). | itemtype : type of the item to export | value : custom data of all items to be exported. |
ImportCustomItem | All custom items of the respective itemtype are imported from a file into parts management. They have to be saved by the add-in. Please mind, that this only works with the XML import (Converter:"XPamExportXml"). | itemtype : type of the item to import value : custom data of all items to be imported mode : import mode. 0: append new records only 1: update existing records only 2: update existing records and append new ones |
|
WillDeleteItem | An item / article is to be deleted in article management | itemtype = name of the type of the selected item key = key field of the currently selected element partnr = selected item number (only if an item is selected) variant = selected variant (only if an article is selected) objectid = id of a transient object being modified, (before changes) |
allow : if set to 0, then DeleteItem is not called (Delete is not executed) |
WillSaveItem | An item/part will be saved in parts management | itemtype : type of item of the selected element key : identifying key of the selected element partnr : selected part number (if only one part is selected) variant : selected part variant ((if only one variant is selected) objectid : id of a transient object being modified, (before changes) |
allow : when set to 0, SaveItem is not called (save is not performed) |