Person

A (natural or legal) person as used in crm databases, online user databases etc.

This is the snapshot of a person's personal data. Some attributes like name and marital status can change in time.    

<person><addresses><address><country>CA</country> <placeName>Arnprior, Ontario</placeName><postalCode>K2S 0Z7</postalCode><streetInfo> <streetName>Knightbridge Road</streetName><streetNumber>77</streetNumber></streetInfo> </address><usageForAll>true</usageForAll></addresses><ageInfo> <birthDay>16</birthDay><birthMonth>7</birthMonth><birthYear>1984</birthYear> </ageInfo><correspondenceLanguage>en</correspondenceLanguage><emailAddresses> <emailAddress>[email protected]</emailAddress></emailAddresses> <gender>MALE</gender><personName><givenNames>John</givenNames> <surnames>Doe</surnames></personName><telNumbers> <fullNumber>(999) 999-9999</fullNumber></telNumbers></person>

Defines a person's names such as given name(s) and surname(s).

Multiple given names may appear in one field. Or they can be added as multiple name items if they are available separately already. The same applies for other name types such as surnames.

false

<personName><givenNames>John</givenNames> <surnames>Doe</surnames></personName>

The gender of the person.

MALE, FEMALE, UNKNOWN

false (defaults to UNKNOWN)

<gender>MALE</gender>

Information about a person's age.

For a NaturalPerson this is the birth-date/age info. For a LegalPerson this is the founding date (activation date).

The information may be a complete date such as 1980-12-31, or a year with month such as 1980-12, or just a year such as 1980, or a year range such as 1980-1989.
The month range is 1-12, not 0-11.    

Depends on the service. A validator service may check for valid dates, and report problems (such as 1986-02-31). A genderizer service may use it to filter irrelevant birth statistics.

The behavior on illegal input depends on the web service that is called. Invalid (xml) input such as a non-numeric string should always result in an illegal input exception. An invalid date such as 1986-02-31 may trigger an illegal input exception, or it may just be ignored.

false

complete date

<ageInfo><birthDay>16</birthDay><birthMonth>7</birthMonth><birthYear>1984</birthYear></ageInfo>

year only

<ageInfo><birthYear>1984</birthYear></ageInfo>

year range

(todo: add example)

Addresses that are used by this person.

Multiple addresses may be passed (domicile, mailing/delivery address, ...) or a single address may be responsible for all purposes.

Depends on the service. A validator service may check for valid addresses, and report problems (such as invalid zip codes). A genderizer service may use it to better classify the names.

The behavior on illegal input depends on the web service that is called. A validator service may report problems with an address. Other services mostly just ignore invalid address data as it is not their task to validate, and the information is just helping to better understand the input and is not essential.

false. Also, all the address fields are optional too.

one complete address

<addresses><address><country>CA</country> <placeName>Arnprior, Ontario</placeName><postalCode>K2S 0Z7</postalCode><streetInfo> <streetName>Knightbridge Road</streetName><streetNumber>77</streetNumber></streetInfo> </address><usageForAll>true</usageForAll></addresses>

one partial address

<addresses><address><country>CA</country> <placeName>Arnprior, Ontario</placeName></address><usageForAll>true</usageForAll></addresses>

multiple addresses

(todo: add example)

Phone, fax etc numbers that are used by this person.

        Multiple numbers may be added    

        Depends on the service.         A data validator service may check for problems. A fake checker may look for suspicious input.    

        The behavior on illegal input depends on the web service that is called. A validator service may report problems with an address. Other services mostly just ignore invalid phone data as it is not their task to validate, and the information is just helping to better understand the input and is not essential.    

false

        as a single string        

<telNumbers> <fullNumber>01234/56789</fullNumber></telNumbers>        

   

Email addresses that are used by this person.

        Multiple addresses may be added.    

        Depends on the service. A data validator service may check for problems such as illegal syntax or inexistent domain. A service may check for disposable email addresses. It may be used to extract name information. A validator service may compare the name in the email address with the person's name.    

        The behavior on illegal input depends on the web service that is called. A validator service may report problems with invalid email address syntax, or inexistent domain names, etc. Services may throw an invalid input exception.    

false

        as a single string        

<emailAddress>[email protected]</emailAddress></emailAddresses>

   

The language code for the correspondence language of the person (with you, the company).

        ISO-639 code of the language. Either 639-1 or 639-3, for example "it" or "ita" for Italian.    

        In combination with the Context.geo it helps the services to better classify the culture of the person.    

        The behavior on illegal input depends on the web service that is called. It may ignore it, or throw an invalid input exception.    

false

        as a single string        

<correspondenceLanguage>it</correspondenceLanguage>