Definition Type: ComplexType
Name: FamilyNameType
Namespace: http://www.hr-xml.org/3
Type: oa:TextType
Containing Schema: Fields.xsd
Abstract
Documentation:
This contains the name or names that generally would be inherited or indicative of a person's family. In Western contexts, this is what is commonly referred to as a "last name." If a person has multiple family names, the order in which the names appear is deemed significant. Generally, that order should correspond to the order in which the names would appear in a typical formatted representation. The order may be specifically identified by the sequence. A "primary" family name may be indicated using the attribute supplied for this purpose. Where multiple family names are presented, only a single name may be designated as primary = "true" Note that the attribute "prefix" may optionally contain a part of the person’s name that precedes the family name. For example: Van den, Von, Al, de, etc. Some implementers may choose not to represent a prefix separately from a Family Name. However, it may be desirable to do so for a number of reasons: 1. name sorting. For example, to support sorting on first letter of prefix and then by first letter of the family name. 2. formatting. For example, depending on the cultural context in which the name is presented, the type of delimiter (e.g., a space or a hyphen) between the prefix and the family name (or whether a delimiter appears at) all may depend on the "alphabet" and/or cultural context in which the name is presented.
Collapse XSD Schema Diagram:
Drilldown into languageID in schema unqualifieddatatypes_xsd Drilldown into TextType in schema unqualifieddatatypes_xsd Drilldown into TextType in schema fields_xsd1 Drilldown into prefix in schema fields_xsd Drilldown into sequence in schema fields_xsd Drilldown into primaryIndicator in schema fields_xsdXSD Diagram of FamilyNameType in schema fields_xsd (HR-XML - Human Resources XML)
Collapse XSD Schema Code:
<xsd:complexType name="FamilyNameType">
    <xsd:annotation>
        <xsd:documentation>
This contains the name or names that generally would be inherited or indicative of a person's family. 
In Western contexts, this is what is commonly referred to as a "last name." 

If a person has multiple family names, the order in which the names appear is deemed significant.
Generally, that order should correspond to the order in which the names would appear in a
typical formatted representation. The order may be specifically identified by the sequence. 

A "primary" family name may be indicated using the attribute supplied for this purpose.
Where multiple family names are presented, only a single name may be designated 
as primary = "true" 
	
Note that the attribute "prefix" may optionally contain a part of the person’s name that precedes the family name. 
For example:  Van den, Von, Al, de, etc. 
Some implementers may choose not to represent a prefix separately from a Family Name. However,
it may be desirable to do so for a number of reasons: 
1. name sorting.  For example, to support sorting on first letter of prefix and then by first letter of the family name.
2. formatting. For example, depending on the cultural context in which the name is presented, the type of 
delimiter (e.g., a space or a hyphen) between the prefix and the family name (or whether a delimiter appears at) all 
may depend on the "alphabet" and/or cultural context in which the name is presented.</xsd:documentation>
    </xsd:annotation>
    <xsd:simpleContent>
        <xsd:extension base="oa:TextType">
            <xsd:attribute name="primaryIndicator" type="oa:IndicatorType" />
            <xsd:attribute name="sequence" type="oa:PositiveIntegerNumericType" />
            <xsd:attribute name="prefix" type="oa:StringType" />
        </xsd:extension>
    </xsd:simpleContent>
</xsd:complexType>
Collapse Child Attributes:
Name Type Default Value Use
languageID udt:languageID Optional
primaryIndicator nsA:primaryIndicator (Optional)
sequence nsA:sequence (Optional)
prefix nsA:prefix (Optional)
Collapse Derivation Tree:
Collapse References:
nsA:FamilyName, nsA:FormerFamilyName