Person

Important

The functionality noted in this article is currently available in both the stand-alone Dynamics 365 Human Resources and the merged Finance infrastructure. Navigation might be different than noted while we make updates. If you need to find a specific page, you can use Search.

Applies to these Dynamics 365 apps:
Human Resources

This article describes the Person entity for Dynamics 365 Human Resources.

Physical name: mshr_dirpersonentity

Description

This entity provides the personal information for the individual who is the candidate.

JSON representation

{
    "mshr_partynumber": "String",
    "mshr_name": "String",
    "mshr_namealias": "String",
    "mshr_knownas": "String",
    "mshr_languageid": "String",
    "mshr_addressbooks": "String",
    "mshr_anniversaryday": Int,
    "mshr_anniversarymonth": Int,
    "mshr_anniversaryyear": Int,
    "mshr_birthday": Int,
    "mshr_birthmonth": Int,
    "mshr_birthyear": Int,
    "mshr_childrennames": "String",
    "mshr_gender": Int,
    "mshr_hobbies": "String",
    "mshr_initials": "String",
    "mshr_maritalstatus": Int,
    "mshr_phoneticfirstname": "String",
    "mshr_phoneticlastname": "String",
    "mshr_phoneticmiddlename": "String",
    "mshr_personalsuffix": "String",
    "mshr_personaltitle": "String",
    "mshr_professionalsuffix": "String",
    "mshr_professionaltitle": "String",
    "mshr_fullprimaryaddress": "String",
    "mshr_addresscity": "String",
    "mshr_addresscountryregionid": "String",
    "mshr_addresscountryregionisocode": "String",
    "mshr_addresscounty": "String",
    "mshr_addressdistrictname": "String",
    "mshr_addresslatitude": Decimal,
    "mshr_addresslocationid": "String",
    "mshr_addresslocationroles": "String",
    "mshr_addresslongitude": Decimal,
    "mshr_addressstate": "String",
    "mshr_addressstreet": "String",
    "mshr_addressvalidfrom": "Date",
    "mshr_addressvalidto": "Date",
    "mshr_addresszipcode": "String",
    "mshr_addressisprivate": Int,
    "mshr_addressdescription": "String",
    "mshr_primarycontactemail": "String",
    "mshr_primarycontactemaildescription": "String",
    "mshr_primarycontactemailisim": Int,
    "mshr_primarycontactemailpurpose": "String",
    "mshr_primarycontactfax": "String",
    "mshr_primarycontactfaxdescription": "String",
    "mshr_primarycontactfaxextension": "String",
    "mshr_primarycontactfaxpurpose": "String",
    "mshr_primarycontactphone": "String",
    "mshr_primarycontactphonedescription": "String",
    "mshr_primarycontactphoneextension": "String",
    "mshr_primarycontactphoneismobile": Int,
    "mshr_primarycontactphonepurpose": "String",
    "mshr_primarycontacttelex": "String",
    "mshr_primarycontacttelexdescription": "String",
    "mshr_primarycontacttelexpurpose": "String",
    "mshr_primarycontacturl": "String",
    "mshr_primarycontacturldescription": "String",
    "mshr_primarycontacturlpurpose": "String",
    "mshr_primarycontactfacebook": "String",
    "mshr_primarycontactfacebookdescription": "String",
    "mshr_primarycontactfacebookisprivate": Int,
    "mshr_primarycontactfacebookpurpose": "String",
    "mshr_primarycontactlinkedin": "String",
    "mshr_primarycontactlinkedindescription": "String",
    "mshr_primarycontactlinkedinisprivate": Int,
    "mshr_primarycontactlinkedinpurpose": "String",
    "mshr_primarycontacttwitter": "String",
    "mshr_primarycontacttwitterdescription": "String",
    "mshr_primarycontacttwitterisprivate": Int,
    "mshr_primarycontacttwitterpurpose": "String",
    "mshr_partytype": "String",
    "mshr_namesequencedisplayas": "String",
    "mshr_firstname": "String",
    "mshr_lastnameprefix": "String",
    "mshr_lastname": "String",
    "mshr_middlename": "String",
    "mshr_electroniclocationid": "String",
    "mshr_dirpersonentityid": "Guid",
    "mshr_addresstimezone": Int
}

Properties

Property
Physical name
Type
Use Description
Person Entity ID
mshr_dirpersonentityid
GUID
Read-only
Required
System-generated
A system-generated unique identifier for the entity record.
Party Number
mshr_partynumber
String
Read-only
Required
System-generated
A user-readable, system-generated unique identifier for the person.
Name
mshr_name
String
Read-only
Required
The field value is a concatenation of First Name, Middle Name, Last Name Prefix, and Last Name in the order defined in the Name Sequence Display As field.
Name Alias
mshr_namealias
String
Read/write
Optional
A name alias that may be provided for the person.
Known As
mshr_knownas
String
Read/write
Optional
A name that may be used for the person if typically known as another name.
Language ID
mshr_languageid
String
Read/write
Optional
The language ID of the person’s primary language, as defined in ISO 639-1 format.
Address books
mshr_addressbooks
String
Read/write
Optional
Address book to which the person may be assigned. Address books that have been set up for the organization are listed in the mshr_diraddressbooksentity entity.
Anniversary Day
mshr_anniversaryday
Int
Read/write
Optional
The day of the person’s anniversary date.
Anniversary Month
mshr_anniversarymonth
mshr_monthsofyear option set
Read/write
Optional
The month of the person’s anniversary date.
Anniversary Year
mshr_anniversaryyear
Int
Read/write
Optional
The year of the person’s anniversary date.
Birth Day
mshr_birthday
Int
Read/write
Optional
The day of the person’s birthdate.
Birth Month
mshr_birthmonth
mshr_monthsofyear option set
Read/write
Optional
The month of the person’s birthdate.
Birth Year
mshr_birthyear
Int
Read/write
Optional
The year of the person’s birthdate.
Children Names
mshr_childrennames
String
Read/write
Optional
String for the names of the person’s children. There is no required delimitation.
Gender
mshr_gender
mshr_hcmpersongender option set
Read/write
Optional
The person’s gender.
Hobbies
mshr_hobbies
String
Read/write
Optional
The person’s hobbies.
Initials
mshr_initials
String
Read/write
Optional
The initials of the person’s name.
Marital Status
mshr_maritalstatus
mshr_hcmpersonmaritalstatus option set
Read/write
Optional
The person’s marital status.
Phonetic First Name
mshr_phoneticfirstname
String
Read/write
Optional
The phonetic pronunciation of the person’s first name.
Phonetic Last Name
mshr_phoneticlastname
String
Read/write
Optional
The phonetic pronunciation of the person’s last name.
Phonetic Middle Name
mshr_phoneticmiddlename
String
Read/write
Optional
The phonetic pronunciation of the person’s last name.
Personal Suffix
mshr_personalsuffix
String
Read/write
Optional
The person’s personal suffix. Valid values in the mshr_dirnameaffixentity entity where mshr_type is Suffix (200000001).
Personal Title
mshr_personaltitle
String
Read/write
Optional
A personal title for the person. Valid values in the mshr_dirnameaffixentity entity where mshr_type is Title (200000000).
Professional Suffix
mshr_professionalsuffix
String
Read/write
Optional
A professional suffix.
Professional Title
mshr_professionaltitle
String
Read/write
Optional
A professional title.
Full Primary Address
mshr_fullprimaryaddress
String
Read/write
Optional
The person’s full primary address, a concatenation of the primary address fields.
Address City
mshr_addresscity
String
Read/write
Optional
The city of the person’s primary address. Set up in mshr_logisticsaddresscityentity entity.
Address Country Region
mshr_addresscountryregionid
String
Read/write
Optional
The country/region of the person’s primary address. Valid values in the mshr_logisticsaddresscountryregionentity entity.
Address Country Region ISO Code
mshr_addresscountryregionisocode
String
Read/write
Optional
The ISO code of the country/region of the person’s primary address.
Address County
mshr_addresscounty
String
Read/write
Optional
The county of the person’s primary address. Set up in mshr_logisticsaddresscountyentity entity.
Address District Name
mshr_addressdistrictname
String
Read/write
Optional
The district of the person’s primary address. Set up in mshr_logisticsaddressdistrictentity entity.
Address Latitude
mshr_addresslatitude
Decimal
Read/write
Optional
The latitude of the person’s primary address.
Address Location ID
mshr_addresslocationid
String
Read/write
Optional
The unique identifier for the location of the person’s primary address. Valid values in mshr_logisticspostaladdresslocationcdsentity entity.
Address Location Roles
mshr_addresslocationroles
String
Read/write
Optional
The location role of the person’s primary address. Set up in the mshr_logisticslocationrolecdsentity entity.
Address Longitude
mshr_addresslongitude
Decimal
Read/write
Optional
The longitude of the person’s primary address.
Address State
mshr_addressstate
String
Read/write
Optional
The state of the person’s primary address. Set up in mshr_logisticsaddressstateentity entity.
Address Street
mshr_addressstreet
String
Read/write
Optional
The street address of the person’s primary address.
Address Valid From
mshr_addressvalidfrom
Date
Read/write
Optional
The date from which the person’s primary address is valid.
Address Valid To
mshr_addressvalidto
Date
Read/write
Optional
The date to which the person’s primary address is valid.
Address Zip Code
mshr_addresszipcode
String
Read/write
Optional
The postal code of the person’s primary address. Set up in mshr_logisticsaddresspostalcodeentity entity.
Address Is Private
mshr_addressisprivate
mshr_noyes option set
Read/write
Optional
Determines whether the person’s primary address is shared with others in the organization.
Address Description
mshr_addressdescription
String
Read/write
Optional
Description for the person’s primary address.
Primary Contact Email
mshr_primarycontactemail
String
Read/write
Optional
The person’s primary email address.
Primary Contact Email Description
mshr_primarycontactemaildescription
String
Read/write
Optional
A description provided for the primary email address.
Primary Contact Email is IM
mshr_primarycontactemailisim
mshr_noyes option set
Read/write
Optional
Determines whether the primary email address is available for instant messages.
Primary Contact Email Purpose
mshr_primarycontactemailpurpose
String
Read/write
Optional
The purpose for the primary email address. Set up in mshr_logisticslocationroleentity entity.
Primary Contact Fax
mshr_primarycontactfax
String
Read/write
Optional
Primary fax number.
Primary Contact Fax Description
mshr_primarycontactfaxdescription
String
Read/write
Optional
Description provided for the primary fax number.
Primary Contact Fax Extension
mshr_primarycontactfaxextension
String
Read/write
Optional
The extension of the primary fax number.
Primary Contact Fax Purpose
mshr_primarycontactfaxpurpose
String
Read/write
Optional
The purpose for the primary fax number. Set up in mshr_logisticslocationroleentity entity.
Primary Contact Phone
mshr_primarycontactphone
String
Read/write
Optional
Primary phone number.
Primary Contact Phone Description
mshr_primarycontactphonedescription
String
Read/write
Optional
Description provided for the primary phone number.
Primary Contact Phone Extension
mshr_primarycontactphoneextension
String
Read/write
Optional
The extension of the primary phone number.
Primary Contact Phone Is Mobile
mshr_primarycontactphoneismobile
mshr_noyes option set
Read/write
Optional
Determines whether the primary phone number is a mobile phone.
Primary Contact Phone Purpose
mshr_primarycontactphonepurpose
String
Read/write
Optional
The purpose for the primary phone number. Set up in mshr_logisticslocationroleentity entity.
Primary Contact Telex
mshr_primarycontacttelex
String
Read/write
Optional
Primary telex number.
Primary Contact Telex Description
mshr_primarycontacttelexdescription
String
Read/write
Optional
Description provided for the person’s primary telex number.
Primary Contact Telex Purpose
mshr_primarycontacttelexpurpose
String
Read/write
Optional
The purpose for the person’s primary telex number. Set up in mshr_logisticslocationroleentity entity.
Primary Contact URL
mshr_primarycontacturl
String
Read/write
Optional
The primary URL.
Primary Contact URL Description
mshr_primarycontacturldescription
String
Read/write
Optional
Description provided for the person’s primary URL.
Primary Contact URL Purpose
mshr_primarycontacturldescription
String
Read/write
Optional
The purpose for the person’s primary URL. Set up in mshr_logisticslocationroleentity entity.
Primary Contact Facebook
mshr_primarycontactfacebook
String
Read/write
Optional
Primary Facebook account. Identified by User ID.
Primary Contact Facebook Description
mshr_primarycontactfacebookdescription
String
Read/write
Optional
Description provided for the person’s primary Facebook account.
Primary Contact Facebook is Private
mshr_primarycontactfacebookisprivate
mshr_noyes option set
Read/write
Optional
Determines whether the primary Facebook account is visible to other users.
Primary Contact Facebook Purpose
mshr_primarycontactfacebookpurpose
String
Read/write
Optional
The purpose for the person’s primary Facebook account. Set up in mshr_logisticslocationroleentity entity.
Primary Contact LinkedIn
mshr_primarycontactlinkedin
String
Read/write
Optional
Primary LinkedIn account. Identified by user name.
Primary Contact LinkedIn Description
mshr_primarycontactlinkedindescription
String
Read/write
Optional
Description provided for the person’s primary LinkedIn account.
Primary Contact LinkedIn Is Private
mshr_primarycontactlinkedinisprivate
mshr_noyes option set
Read/write
Optional
Determines whether the person’s primary LinkedIn account information is shared with other users.
Primary Contact LinkedIn Purpose
mshr_primarycontactlinkedinpurpose
String
Read/write
Optional
The purpose for the person’s primary LinkedIn account. Set up in mshr_logisticslocationroleentity entity.
Primary Contact Twitter
mshr_primarycontacttwitter
String
Read/write
Optional
The person’s primary Twitter account. Identified by @username.
Primary Contact Twitter Description
mshr_primarycontacttwitterdescription
String
Read/write
Optional
Description provided for the person’s primary Twitter account.
Primary Contact Twitter Is Private
mshr_primarycontacttwitterisprivate
mshr_noyes option set
Read/write
Optional
Determines whether the person’s primary Twitter account information is shared with other users.
Primary Contact Twitter Purpose
mshr_primarycontacttwitterpurpose
String
Read/write
Optional
The purpose for the person’s primary Twitter account. Set up in mshr_logisticslocationroleentity entity.
Party Type
mshr_partytype
String
Read/write
Optional
The party type of the person. Will always be Person for candidates.
Name Sequence Display As
mshr_namesequencedisplayas
String
Read/write
Optional
The sequence in which the person’s name properties are concatenated to form the Name (mshr_name) property value.
First Name
mshr_firstname
String
Read/write
Required
The person’s first name.
Middle Name
mshr_middlename
String
Read/write
Optional
The person’s middle name.
Last Name Prefix
mshr_lastnameprefix
String
Read/write
Optional
The prefix of the person’s last name.
Last Name
mshr_lastname
String
Read/write
Optional
The person’s last name.
Electronic Location ID
mshr_electroniclocationid
String
Read/write
Optional
The ID of the person’s electronic location.
Address Time Zone
mshr_addresstimezone
Int
Read/write
Optional
The time zone of the person’s primary address.

See also

Applicant Tracking System integration API introduction
Example query for Candidate to hire