This code showcases the Melissa Right Fielder Object using Java.
Please feel free to copy or embed this code to your own project. Happy coding!
For the latest Melissa Right Fielder Object release notes, please visit: https://releasenotes.melissa.com/on-premise-api/rightfielder-object/
For further details, please visit: https://docs.melissa.com/on-premise-api/rightfielder-object/rightfielder-object-quickstart.html
The console will ask the user for:
- Right Fielder Input (rfinput)
And return
- Address Line 1
- Address Line 2
- Address Line 3
- City
- State
- Zip
- Result Codes
- Windows 10 64-bit Java 19, Powershell 5.1
- Melissa data files for 2024-Q2
This is the c++ code of the Melissa Object. This file will be downloaded by Melissa Updater!
This file needs to be added as a Project Dependency. This wrapper will need to be in the same directory as the program using it.
- mdRightFielder.cfg
- mdRightFielder.dat
These instructions will get you a copy of the project up and running on your local machine for development and testing purposes. This project is compatible with Java 19
Before starting, make sure that Java has been correctly installed on your machine and your environment paths are configured.
You can download Java here: https://www.oracle.com/java/technologies/downloads/
You can check that your environment is set up correctly by opening a command prompt window and typing the following:
java --version
If you see the version number then you have installed Java and set up your environment paths correctly!
If running Powershell for the first time, you will need to run this command in the Powershell console: Set-ExecutionPolicy RemoteSigned
.
The console will then prompt you with the following warning shown in the image below.
- Enter
'A'
.- If successful, the console will not output any messages. (You may need to run Powershell as administrator to enforce this setting).
$ git clone https://github.com/MelissaData/RightFielderObject-Java
$ cd RightFielderObject-Java
Melissa Updater is a CLI application allowing the user to update their Melissa applications/data.
- Download Melissa Updater here: https://releases.melissadata.net/Download/Library/WINDOWS/NET/ANY/latest/MelissaUpdater.exe
- Create a folder within the cloned repo called
MelissaUpdater
. - Put
MelissaUpdater.exe
inMelissaUpdater
folder you just created.
- Using Melissa Updater
- It will handle all of the data download/path and dll(s) for you.
- If you already have the latest release zip, you can find the data file(s) in there
- To pass in your own data file path directory, you may either use the '-dataPath' parameter or enter the data file path directly in interactive mode.
- Comment out this line "DownloadDataFiles -license $License" in the powershell script.
- This will prevent you from having to redownload all the files.
Parameters:
-
-rfinput: a test right fielder input to parse
This is convenient when you want to get results for a specific right fielder input in one run instead of testing multiple right fielder inputs in interactive mode.
-
-dataPath (optional): a data file path directory to test the Right Fielder Object
-
-license (optional): a license string to test the Right Fielder Object
-
-quiet (optional): add to the command if you do not want to get any console output from the Melissa Updater
When you have modified the script to match your data location, let's run the script. There are two modes:
-
Interactive
The script will prompt the user for the right fielder input, then use the provided right fielder input to test the Right Fielder Object. For example:
$ .\MelissaRightFielderObjectWindowsJava.ps1
For quiet mode:
$ .\MelissaRightFielderObjectWindowsJava.ps1 -quiet
-
Command Line
You can pass a right fielder input in
-rfinput
parameter and a license string in-license
parameter to test the Right Fielder Object. For example:$ .\MelissaRightFielderObjectWindowsJava.ps1 -rfinput "22382 Avenida Empresa, Rancho Santa Margarita, CA 92688" $ .\MelissaRightFielderObjectWindowsJava.ps1 -rfinput "22382 Avenida Empresa, Rancho Santa Margarita, CA 92688" -license "<your_license_string>"
For quiet mode:
$ .\MelissaRightFielderObjectWindowsJava.ps1 -rfinput "22382 Avenida Empresa, Rancho Santa Margarita, CA 92688" -quiet $ .\MelissaRightFielderObjectWindowsJava.ps1 -rfinput "22382 Avenida Empresa, Rancho Santa Margarita, CA 92688" -license "<your_license_string>" -quiet
This is the expected output from a successful setup for interactive mode:
Troubleshooting for errors found while running your program.
Error | Description |
---|---|
ErrorRequiredFileNotFound | Program is missing a required file. Please check your Data folder and refer to the list of required files above. If you are unable to obtain all required files through the Melissa Updater, please contact technical support below. |
ErrorLicenseExpired | Expired license string. Please contact technical support below. |
For free technical support, please call us at 800-MELISSA ext. 4 (800-635-4772 ext. 4) or email us at tech@Melissa.com.
To purchase this product, contact Melissa sales department at 800-MELISSA ext. 3 (800-635-4772 ext. 3).