Unison:Address Object Tutorial
The following steps will guide you in the basic usage of an Address Cleansing task in Unison by Melissa.
Login
You must first enter your login credentials at the login page.
New Project
To start a new project, first click Projects, then click the + next to Data Enrichment. Enter a name for your project here. This name can be changed later.
Add Source
Then select a source for your new project. In this instance I'll use a file as a source.
After clicking File, navigate to your desired file to upload it.
Input File Preview
Once the file is uploaded, the Input File Preview window will open. Here you can preview how your file will be used. You can change the delimiter, enclosure, select if your file includes a header row, and specify which fields to use.
Once you save your choices from the preview, you'll be sent to the Project Configuration screen.
Select Service
Then select which service you want to use on your data. Here we'll use Address Cleansing (US Only).
Address Cleansing
Input Fields
Select which fields to use as input and how they map. Clicking on a field will open a drop-down menu with a list of available fields from your input file.
Output Fields
You can also control your output fields. Clicking the rollout arrow will show the default output fields. Here you can choose which fields to output, and optionally rename the fields.
If you click the Settings cog icon next to the output fields this will open the Address Task Settings dialog. Here you can set service-specific settings.
Once you save your choices from the output fields, you'll be sent back to the Project Configuration screen.
Outputs
Now click Add an Output to select your Outputs. Here you can choose to write to file or to table. Here we'll write to a file. Enter a file name and then select your enclosure and delimiter. You can also choose your compression method, to append a timestamp, or include the header.
Filter
To get specific data from your file you can use a filter by selecting one from the drop-down menu. This will filter your resulting data, using the result codes of the records to limit your results. For example, selecting the Full Address Matches (USPS) filter shows that any records with an AS01 result code will be output.
Output Fields
Clicking the rollout arrow next to Output Fields will show the default output fields and their order. You can delete unwanted fields from your output by clicking the trashcan icon next to each field. You can also re-order your fields by drag and drop.
Run/Schedule Project
The project is now ready to be run or scheduled.
Run Now
If you click the Run Now button on the top right corner of the Project Configuration window, your project will begin processing immediately.
Schedule
To schedule your project, click the Schedule button on the top right corner of the Project Configuration window.
In the Schedule Project Execution window, enter a description of your scheduled project, a frequency of execution, a start date, and a start time.
Job Status
Once a job has started, you can check the job status to view it's state, number of rows processed, time elapsed, date started, and date completed.
Output Files
When the job has completed, you can also view any output files generated. After clicking the job name you may view the output file by clicking either the view or download button.
Detailed Reports
A completed job will also have detailed reports. You can access these by clicking the View Detailed Reports button under Reports.
These reports will depend on which service you use and display generated result codes. These codes will detail the overall status of your project, changes made to the data, and any errors encountered.
