1. What is a Person?

The Person entity is used to represent any individual involved in tennis. This is most often a player but can also be a coach, a parent, an umpire, an organiser, an officer in a national association - anyone with a role in tennis. Sources can use a Person entity to keep a single reference to a person throughout his or her tennis life - for example from junior player, through to professional player, then coach, umpire, club chairperson, and senior's circuit player. This person entity can include multiple roles, for example senior player, professional umpire and parent of a junior player.

2. Person Schema

To see a graphical representation of the data model (schema) for the Person entity please expand the link below:

3. Creating a Person

The minimum information required to create a Person entity is an ID and a name (StandardFamilyName or StandardGivenName, both where available).

<Person>
	<Updated>2019-12-31</Updated>
	<PersonId>349C4B46-9EB6-4E52-9486-38C02911FF03<PersonId>
	<StandardGivenName>Jane</StandardGivenName>
	<StandardFamilyName>Smith</StandardFamilyName>
</Person>

{
  "Person": {
    "Updated": "2019-12-31",
    "PersonId": "349C4B46-9EB6-4E52-9486-38C02911FF03",
    "StandardGivenName": "Jane",
	"StandardFamilyName": "Smith"
  }
}

4. PersonID

In PersonID you must supply your unique identifier for the Person.

The value of PersonID must be unique within your data. To make IDs unique globally TODS uses a URN-style system, so the full globally unique tournament ID is:

Tennis:Person:<SourceID>:<PersonID>

5. Person Names

TODS allows for different forms or representations of names for a Person providing flexibility for use of across different languages.

• NativeGivenName/NativeFamilyName: the name written in the local language script of source/client (as agreed between parties).
• StandardGivenName/StandardFamilyName: the name, in Latin script, that the person is usually known by. For example Andy Murray rather than Andrew Murray. This will usually be a translation or transliteration of the Native Name.
• PassportGivenName/PassportFamilyName: the person's name in ASCII characters (A-Z only), as shown in the person's passport. This form of the name is commonly used to aid deduplication of records across different databases and data systems.

For more information on use of names see Transliteration of Names to Latin Script

6. Adding more information

Once the minimum information has been supplied you can add additional information if it is available or as it becomes available. There are attributes for key information like date of birth, gender, nationality.

There are attributes defined for providing links to a person's social media profiles, web site and other contact information. Finally there is a section to provide more general biographical information about a person such as hobbies, interests, sporting career and so forth.

Related Information:

• Transliteration of Names to Latin Script
• Introduction to Events
• Introduction to the MatchUp

Go back to TODS home page.