Personator Consumer:Notice

From Melissa Data Wiki
Revision as of 21:28, 14 August 2015 by Admin (talk | contribs)
Jump to navigation Jump to search

← Personator


Personator Version 4 Update

Released: 8/14/2015

The new version of Personator (Version 4) can now be consumed using the following endpoint:

rcpersonator.melissadata.net

Personator is a continuously growing product that requires the addition of new properties in order to satisfy the demand for new data. The Version 4 update includes the addition of new elements in the Request/Response Structure which in effect also changes the WSDL structure. Please follow proper update procedures to prevent sudden disruption of service.

TimeLine

The official Personator Endpoint (personator.melissadata.net) will be updated to Version 4 on September 30, 2015. The rcpersonator.melissadata.net endpoint will continue to be online until November 11, 2015, after which it will be taken offline.

Here is the official timeline:


Update Procedures

Clients whose Web Service Integrations do not support WSDL changes due to the addition of new elements in the request/response structure are strongly advised to follow these update procedures:

  1. All applications must be re-compiled to use the Release Candidate Endpoint (rcpersonator.melissadata.net) before September 30, 2015.
  2. Come September 30, we will be updating the Official Endpoint with Version 4 of Personator. At this time, all applications must be switched back to use the Official Endpoint before November 11, 2015 when the Release Candidate endpoint goes offline.

Clients whose Web Service Integrations support structure/WSDL additions are still strongly encouraged to follow this update procedure, but are not required to.

Version 4 Changes

New Census Output Elements

The following Elements have been added as part of the Response Structure:

Element
CensusKey
CountySubdivisionCode
CountySubdivisionName
ElementarySchoolDistrictCode
ElementarySchoolDistrictName
SecondarySchoolDistrictCode
SecondarySchoolDistrictName
UnifiedSchoolDistrictCode
UnifiedSchoolDistrictName
StateDistrictUpper
StateDistrictLower

In order to retrieve these new elements in the Response, you may enumerate each field in the Columns Request:

Eg. <Columns>StateDistrictUpper,StateDistrictLower</Columns>

Alternatively, you may also request for GrpCensus2 in the Columns Request to retrieve all of the new elements :

Eg. <Columns>GrpCensus2</Columns>

MelissaAddressKey Column

The MelissaAddressKey Column has been added as part of the response structure.