Global Address Object:Licensing: Difference between revisions
m Admin moved page Global Address Object:Using Global Address Object to Global Address Object:Licensing without leaving a redirect |
No edit summary |
||
| (2 intermediate revisions by the same user not shown) | |||
| Line 1: | Line 1: | ||
{{GlobalAddressObjectNav | |||
|IntroductionCollapse= | |||
}} | |||
{ | |||
{ | |||
| | |||
{{CustomTOC}} | {{CustomTOC}} | ||
==Licensing== | ==Licensing== | ||
The | The License Key is a software key that unlocks the full functionality of the component. Without the License Key, Global Address Object will not function.There are two methods of setting the License Key, using an environment variable called MD_LICENSE or passing it as a parameter using the SetLicenseString function. Global Address Object employs a shared License Key and environmental variable with the rest of the Melissa Data product line of programming tools. This is important to consider if you are using Global Address Object with other Melissa Data products. If you are using multiple products, you only need one License Key as long as that License Key is enabled for all the products you intend to use. | ||
===Environment Variable=== | ===Environment Variable=== | ||
You can set the | You can set the License Key using an environment variable called MD_LICENSE. If MD_LICENSE is set, it will override any value set using the SetLicenseString function. | ||
Using an environment variable is the recommended best practice. It is much easier to manage and update the | Using an environment variable is the recommended best practice. It is much easier to manage and update the License Key when it is stored in an environment variable. | ||
The environment variable is shared with the Melissa Data product line of programming tools. | The environment variable is shared with the Melissa Data product line of programming tools. | ||
| Line 85: | Line 22: | ||
#Click New. | #Click New. | ||
#Enter “MD_LICENSE” in the Variable Name box. | #Enter “MD_LICENSE” in the Variable Name box. | ||
#Enter the | #Enter the License Key in the Variable Value box, and then click OK. | ||
Please remember that these settings take effect only upon initialization of the application. It may be necessary to stop and restart the program to utilize the | Please remember that these settings take effect only upon initialization of the application. It may be necessary to stop and restart the program to utilize the License Key. | ||
===Parameter=== | ===Parameter=== | ||
You can also pass in the | You can also pass in the License Key as a parameter to the SetLicenseString function. | ||
As mentioned above, it is recommended to use an environment variable. If you set the | As mentioned above, it is recommended to use an environment variable. If you set the License Key in a parameter you run the risk of needing to edit and recompile any application using the Global Address Object any time you need to manage or update the License Key. | ||
===Demo License=== | ===Demo License Key=== | ||
If you have an existing MD_LICENSE but was given a demo | If you have an existing MD_LICENSE but was given a demo License Key to try out Global Address Object, you can use the environment variable MD_LICENSE_DEMO. This avoids conflicts or confusion if you already have active subscriptions to other Melissa Data object products. | ||
| Line 109: | Line 46: | ||
†Not required for all countries but are for most | †Not required for all countries but are for most | ||
[[Category:Global Address Object]] | [[Category:Global Address Object]] | ||
[[Category:Reference]] | [[Category:Reference]] | ||
Latest revision as of 18:42, 16 December 2016
← Global Address Object Reference
| Global Address Object Navigation | |||||
|---|---|---|---|---|---|
| |||||
| |||||
| |||||
| |||||
|
Licensing
The License Key is a software key that unlocks the full functionality of the component. Without the License Key, Global Address Object will not function.There are two methods of setting the License Key, using an environment variable called MD_LICENSE or passing it as a parameter using the SetLicenseString function. Global Address Object employs a shared License Key and environmental variable with the rest of the Melissa Data product line of programming tools. This is important to consider if you are using Global Address Object with other Melissa Data products. If you are using multiple products, you only need one License Key as long as that License Key is enabled for all the products you intend to use.
Environment Variable
You can set the License Key using an environment variable called MD_LICENSE. If MD_LICENSE is set, it will override any value set using the SetLicenseString function.
Using an environment variable is the recommended best practice. It is much easier to manage and update the License Key when it is stored in an environment variable.
The environment variable is shared with the Melissa Data product line of programming tools.
Windows users can set environment variables using the following steps:
- Select Start > Settings, and then click Control Panel.
- Double-click System and then click the Advanced tab.
- Click Environment Variables, and then select either System Variables or Variables for the user X.
- Click New.
- Enter “MD_LICENSE” in the Variable Name box.
- Enter the License Key in the Variable Value box, and then click OK.
Please remember that these settings take effect only upon initialization of the application. It may be necessary to stop and restart the program to utilize the License Key.
Parameter
You can also pass in the License Key as a parameter to the SetLicenseString function.
As mentioned above, it is recommended to use an environment variable. If you set the License Key in a parameter you run the risk of needing to edit and recompile any application using the Global Address Object any time you need to manage or update the License Key.
Demo License Key
If you have an existing MD_LICENSE but was given a demo License Key to try out Global Address Object, you can use the environment variable MD_LICENSE_DEMO. This avoids conflicts or confusion if you already have active subscriptions to other Melissa Data object products.
Minimum Inputs
The Global Address Object has a set of minimum values it needs to have a chance at verifying an address record. The minimum fields required are as follows:
- Address Line 1
- Country
Within those minimum required fields, the minimum required content are:
- Delivery address
- (Locality and Administrative Area) or Postal Code†
- Country Name or Country Code
†Not required for all countries but are for most