Personator Consumer:Notice: Difference between revisions

From Melissa Data Wiki
Jump to navigation Jump to search
No edit summary
No edit summary
Line 2: Line 2:
{{CustomTOC}}
{{CustomTOC}}


==Personator Version 4 Update==
==Personator 2017 Update==
''Released: 8/14/2015''
'''Released 02/17/2017'''


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


:;rcpersonator.melissadata.net
<code>rcpersonator.melissadata.net</code>


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.
Personator continues to grow with demand for new demographic information and input properties to help track a specific target. The 2017 update includes the addition of new elements in the Request/Response Strucutre 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.  


===Timeline===
The official Personator Endpoint (personator.melissadata.net) will be updated to the new version on April 3rd, 2017. The rcpersonator endpoint will continue to be online until May 17th, 2017, after which it will be taken offline.
Here is the official timeline:
Here is the official timeline:


[[File:Personator_Timeline.png|link=]]
{|class="alternate01" cellspacing="0"
!&rarr;!!&rarr;!!&rarr;!!
|-
! !!02/17/2017!!04/03/2017!!05/17/2017
|-
|Release Candidate Endpoint<br>(rcpersonator.melissadata.net)||Release: Version 5||Version 5||Offline
|-
|Official Endpoint<br>(personator.melissadata.net)||Offline||Update: Version 5||Version 5
|}




Line 22: Line 29:
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:
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:


#All applications must be re-compiled to use the Release Candidate Endpoint (rcpersonator.melissadata.net) before September 30, 2015.
#All applications must be re-compiled to use the Release Candidate Endpoint (rcpersonator.melissadata.net) before April 3rd, 2017.
#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.
#Come April 3, we will be updating the Official Endpoint with Version 5 of Personator. At this time, all applications must be switched back to use the Official Endpoint before May 17th, 2017 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.
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:
===Version 5 Changes===
The following elements have been added as a request field:


{|class="alternate01" cellspacing="0"
{|class="alternate01" cellspacing="0"
!Element
!Input Field
|-
|-
|CensusKey
|SocialSecurity
|}
 
 
The following elements have been added as part of the default response structure:
 
{|class="alternate01" cellspacing="0"
!Default Output Field
|-
|-
|CountySubdivisionCode
|MelissaAddressKeyBase
|-
|}
|CountySubdivisionName
 
 
The following elements have been added as part of the response structure:
 
{|class="alternate01" cellspacing="0"
!Additional Output Fields
|-
|-
|ElementarySchoolDistrictCode
|MoveDate
|-
|-
|ElementarySchoolDistrictName
|HouseholdSize
|-
|-
|SecondarySchoolDistrictCode
|CreditCardUser
|-
|-
|SecondarySchoolDistrictName
|PresenceOfSenior
|-
|-
|UnifiedSchoolDistrictCode
|ChildrenAgeRange
|-
|-
|UnifiedSchoolDistrictName
|Education
|-
|-
|StateDistrictUpper
|PoliticalParty
|-
|-
|StateDistrictLower
|TypeOfVehicles
|}
|}


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


<pre><Columns>StateDistrictUpper,StateDistrictLower</Columns></pre>
<pre>
 
<Columns>MoveDate,HouseholdSize,CreditCardUser,PresenceOfSenior,ChildrenAgeRange,Education,PoliticalParty,TypeOfVehicles</Columns>
Alternatively, you may also request for GrpCensus2 in the Columns Request to retrieve all of the new elements:
</pre>
 
<pre><Columns>GrpCensus2</Columns></pre>


====MelissaAddressKey Column====
;Please Note:
The MelissaAddressKey Column has been added as part of the response structure.  
:These new columns are only placeholders for the web service structure. They currently do not output any data/values. A separate announcement will be sent for the activation of these new fields and features at a future time.




[[Category:Personator]]
[[Category:Personator]]

Revision as of 21:07, 14 February 2017

← Personator


Personator 2017 Update

Released 02/17/2017

The new version of Personator can now be consumed using the following endpoint:

rcpersonator.melissadata.net

Personator continues to grow with demand for new demographic information and input properties to help track a specific target. The 2017 update includes the addition of new elements in the Request/Response Strucutre 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 the new version on April 3rd, 2017. The rcpersonator endpoint will continue to be online until May 17th, 2017, after which it will be taken offline. Here is the official timeline:

02/17/2017 04/03/2017 05/17/2017
Release Candidate Endpoint
(rcpersonator.melissadata.net)
Release: Version 5 Version 5 Offline
Official Endpoint
(personator.melissadata.net)
Offline Update: Version 5 Version 5


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 April 3rd, 2017.
  2. Come April 3, we will be updating the Official Endpoint with Version 5 of Personator. At this time, all applications must be switched back to use the Official Endpoint before May 17th, 2017 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 5 Changes

The following elements have been added as a request field:

Input Field
SocialSecurity


The following elements have been added as part of the default response structure:

Default Output Field
MelissaAddressKeyBase


The following elements have been added as part of the response structure:

Additional Output Fields
MoveDate
HouseholdSize
CreditCardUser
PresenceOfSenior
ChildrenAgeRange
Education
PoliticalParty
TypeOfVehicles


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

<Columns>MoveDate,HouseholdSize,CreditCardUser,PresenceOfSenior,ChildrenAgeRange,Education,PoliticalParty,TypeOfVehicles</Columns>
Please Note
These new columns are only placeholders for the web service structure. They currently do not output any data/values. A separate announcement will be sent for the activation of these new fields and features at a future time.