| Pré. | Proc. |
EA_GetSharedAddinName
As an Add-In writer you can distribute keys to your Add-In via the Enterprise Architect Keystore, provided that your keys are added using a prefix that allows the system to identify the Add-In to which they belong. EA_GetSharedAddinName is called to determine what prefix the Add-In is using. If a matching key is found in the keystore the 'License Management' dialog will display the name returned by EA_AddinLicenseGetDescription to your users. Finally, when the user selects a key, that key will be passed to your Add-In to validate by calling EA_AddinLicenseValidate.
Syntax
Function EA_GetSharedAddinName (Repository as EA.Repository) As String
Parameter |
Type |
See also |
|---|---|---|
|
Repository |
EA.Repository Direction: IN Description: An EA.Repository object representing the currently open model. Poll its members to retrieve model data and user interface status information. |
Repository Class |
Return Value
A String containing a product name code for the provided Add-In, such as MYADDIN. This will be shown in plain text in any keys added to the keystore.
Notes
Shared Add-In keys have the format:
EASK-YOURCODE-REALKEY
- EASK - Constant string that identifies a shared key for an Enterprise Architect Add-In
- YOURCODE - The code you select and verify with us:
- Displayed to the administrator of the keystore
- Recommended length of 6-10 characters
- Contains ASCII characters 33-126, except for '-' (45) - REALKEY - Encoding of the actual key or checksums
- Recommended length of 8-32 characters
- Contains ASCII characters 33-126
We recommend that you contact Sparx Systems directly with proposed values to ensure that you don't clash with any other Add-Ins.
For example, these keys would all be interpreted as belonging to an Add-In returning MYADDIN from this function:
- EASK-MYADDIN-Test
- EASK-MYADDIN-{7AC4D426-9083-4fa2-93B7-25E2B7FB8DC5}
- EASK-MYADDIN-7AC4D426-9083-4fa2-93B7
- EASK-MYADDIN-25E2B7FB8DC5
- EASK-MYADDIN-2hDfHKA5jf0GAjn92UvqAnxwC13dxQGJtH7zLHJ9Ym8=