Quickstart#

Introduction#

Listware Plus is a desktop application designed to allow you to consume several of our web services. Listware Plus makes it easy to create a custom job to process your files and generates interactive HTML Reports to showcase and explain the results of these processes.

Listware Plus is an extension of the Listware Desktop product and includes several advantages over its predecessor:

  • Expanded coverage to most of our web services.

  • Automatic File and Service Configurations for more efficient job setup and debugging.

  • Polished, interactive HTML Reports.

  • Reporting functions even for files that were processed using other Melissa tools.

  • Intelligent problem detection to indicate issues such as duplicate column headers, missing inputs, or mismapped columns.

Note: This free software is provided as-is with no guarantees and is not intended as a long-term solution or production application. Support for this product is minimal.

Requirements#

Minimum Requirements#

  • Microsoft Windows Vista or Newer

  • .NET Framework 4.5+

  • 20 MB hard disk space

Description#

Listware Plus is a program designed to fully use our web services without having to write any code. Currently, the program is able to process delimited flat files through many of our web services and can generate an interactive HTML report for several of these services.

Please note: This application is not intended as a long-term or production/enterprise solution.

Though the software is designed for powerful batch processing capabilities, this is freeware provided as-is to consume our premium web services.

The following web services are available:

  • Business Coder

  • Global Address

  • Global Email

  • Global IP

  • Global Name

  • Global Phone

  • Personator

  • Personator Search

  • Property Lookup

  • Property Lookup Deeds

  • Property Lookup Homes By Owner

  • Reverse GeoCoder

  • SmartMover

Getting Started#

Extract the ZIP archive into the desired location on your machine. Run the application by

Enter your valid Melissa license key in the text box above, then press Enter to enable the UI.

Application Flow#

When running the program, the typical flow goes like this:

  1. Enter your input file.

    1. You can paste the path into the text box or click the “Select Input File” button to open the file selection box.

  2. Select your Delimiters and Qualifiers.

  3. Click “Check File” to start scanning your file for data shifts.

    1. If your file has a data shift, or if you selected the wrong delimiter/qualifier, the program will report this error to you and undo your input file so that you can fix the issue.

    2. After scanning your file, you can click “Preview” to view a sample of your file.

  4. Select your desired service from the drop-down box.

  5. Click “Set Configuration” to access the options available to that service

  6. Click “Set Input Columns” to open the input column window

    1. Ensure all columns are mapped. Some columns may be auto-detected.

  7. Click “Set Output Columns” to open the output column window

    1. You can click the boxes in the first column to select all fields in that group.

    2. If you’re outputting columns from a non-default group, make sure you’ve also selected that group in Step 5.

  8. Choose where to output your files

    1. By default, the program will use the same delimiter and qualifier as the input file.

    2. You can select a directory to output all of your files. By default your run will be saved in “C:Template:UserDocumentsListwarePlusProcessed Files[Job_Name]". You can change the job folder name when configuring the application.

  9. If you would like an HTML report to be generated after the run, check “Enable Reporting”.

    1. Fill in the info boxes as well. These can be edited later.

  10. Click “Run” to start the batch process.

After your run is finished, all relevant files will be saved to the job folder. You will notice some extra .json files, these are saves that you can come back to later.

Saving and Loading#

Saving#

Whenever a run starts, settings are automatically saved to the job folder. There are two types of saves, Service Saves and File Saves. Additionally, in the toolbar you can go to File > Save Settings to save whatever state the program is in. Every setting in the “Configuration” box must be set in order to save.

Loading#

To load a saved file, go to File > Load Settings in the toolbar. This opens the Loading window.

Here you can select a saved setting from the dropdowns and click “Apply Save” to load the program with the saved settings. Additionally, you can click the “Select Save” button and load a save that may be stored in another folder, such as from “Processed Files”.

Tips#

  • The saves in the dropdown boxes are being loaded from the folder “Saved Settings”. Whenever you save via File > Save Settings, the saves are stored here. You can also move saves into this folder with the File Explorer. Do this for common Services so you can save time

  • You can rename Service Saves to use as a template for common processes.

  • If you need to replicate how another user ran a file, get a copy of their save from Listware Plus, or open their save in a text editor and you can see what settings they used. The file save may not work if the file is in a different format, but the service save should still work.