Class XCN

All Implemented Interfaces:
Composite, Type, Visitable, Serializable

public class XCN extends AbstractComposite

Represents an HL7 XCN (extended composite ID number and name for persons) data type. This type consists of the following components:

  • ID number (ST) (ST)
  • family name (FN)
  • given name (ST)
  • second and further given names or initials thereof (ST)
  • suffix (e.g., JR or III) (ST)
  • prefix (e.g., DR) (ST)
  • degree (e.g., MD) (IS)
  • source table (IS)
  • assigning authority (HD)
  • name type code (ID)
  • identifier check digit (ST)
  • code identifying the check digit scheme employed (ID)
  • identifier type code (IS) (IS)
  • assigning facility (HD)
  • Name Representation code (ID)
  • name context (CE)
  • name validity range (DR)
  • name assembly order (ID)
See Also:
  • Constructor Details

    • XCN

      public XCN(Message message)
      Creates a new XCN type
  • Method Details

    • getComponents

      public Type[] getComponents()
      Returns an array containing the data elements.
    • getComponent

      public Type getComponent(int number) throws DataTypeException
      Returns an individual data component.
      Parameters:
      number - The component number (0-indexed)
      Throws:
      DataTypeException - if the given element number is out of range.
    • getIDNumber

      public ST getIDNumber()
      Returns ID number (ST) (component 1). This is a convenience method that saves you from casting and handling an exception.
    • getXcn1_IDNumber

      public ST getXcn1_IDNumber()
      Returns ID number (ST) (component 1). This is a convenience method that saves you from casting and handling an exception.
    • getFamilyName

      public FN getFamilyName()
      Returns family name (component 2). This is a convenience method that saves you from casting and handling an exception.
    • getXcn2_FamilyName

      Returns family name (component 2). This is a convenience method that saves you from casting and handling an exception.
    • getGivenName

      public ST getGivenName()
      Returns given name (component 3). This is a convenience method that saves you from casting and handling an exception.
    • getXcn3_GivenName

      Returns given name (component 3). This is a convenience method that saves you from casting and handling an exception.
    • getSecondAndFurtherGivenNamesOrInitialsThereof

      Returns second and further given names or initials thereof (component 4). This is a convenience method that saves you from casting and handling an exception.
    • getXcn4_SecondAndFurtherGivenNamesOrInitialsThereof

      Returns second and further given names or initials thereof (component 4). This is a convenience method that saves you from casting and handling an exception.
    • getSuffixEgJRorIII

      Returns suffix (e.g., JR or III) (component 5). This is a convenience method that saves you from casting and handling an exception.
    • getXcn5_SuffixEgJRorIII

      Returns suffix (e.g., JR or III) (component 5). This is a convenience method that saves you from casting and handling an exception.
    • getPrefixEgDR

      public ST getPrefixEgDR()
      Returns prefix (e.g., DR) (component 6). This is a convenience method that saves you from casting and handling an exception.
    • getXcn6_PrefixEgDR

      Returns prefix (e.g., DR) (component 6). This is a convenience method that saves you from casting and handling an exception.
    • getDegreeEgMD

      public IS getDegreeEgMD()
      Returns degree (e.g., MD) (component 7). This is a convenience method that saves you from casting and handling an exception.
    • getXcn7_DegreeEgMD

      Returns degree (e.g., MD) (component 7). This is a convenience method that saves you from casting and handling an exception.
    • getSourceTable

      public IS getSourceTable()
      Returns source table (component 8). This is a convenience method that saves you from casting and handling an exception.
    • getXcn8_SourceTable

      Returns source table (component 8). This is a convenience method that saves you from casting and handling an exception.
    • getAssigningAuthority

      Returns assigning authority (component 9). This is a convenience method that saves you from casting and handling an exception.
    • getXcn9_AssigningAuthority

      Returns assigning authority (component 9). This is a convenience method that saves you from casting and handling an exception.
    • getNameTypeCode

      public ID getNameTypeCode()
      Returns name type code (component 10). This is a convenience method that saves you from casting and handling an exception.
    • getXcn10_NameTypeCode

      Returns name type code (component 10). This is a convenience method that saves you from casting and handling an exception.
    • getIdentifierCheckDigit

      Returns identifier check digit (component 11). This is a convenience method that saves you from casting and handling an exception.
    • getXcn11_IdentifierCheckDigit

      Returns identifier check digit (component 11). This is a convenience method that saves you from casting and handling an exception.
    • getCodeIdentifyingTheCheckDigitSchemeEmployed

      Returns code identifying the check digit scheme employed (component 12). This is a convenience method that saves you from casting and handling an exception.
    • getXcn12_CodeIdentifyingTheCheckDigitSchemeEmployed

      Returns code identifying the check digit scheme employed (component 12). This is a convenience method that saves you from casting and handling an exception.
    • getIdentifierTypeCode

      Returns identifier type code (IS) (component 13). This is a convenience method that saves you from casting and handling an exception.
    • getXcn13_IdentifierTypeCode

      Returns identifier type code (IS) (component 13). This is a convenience method that saves you from casting and handling an exception.
    • getAssigningFacility

      Returns assigning facility (component 14). This is a convenience method that saves you from casting and handling an exception.
    • getXcn14_AssigningFacility

      Returns assigning facility (component 14). This is a convenience method that saves you from casting and handling an exception.
    • getNameRepresentationCode

      Returns Name Representation code (component 15). This is a convenience method that saves you from casting and handling an exception.
    • getXcn15_NameRepresentationCode

      Returns Name Representation code (component 15). This is a convenience method that saves you from casting and handling an exception.
    • getNameContext

      public CE getNameContext()
      Returns name context (component 16). This is a convenience method that saves you from casting and handling an exception.
    • getXcn16_NameContext

      Returns name context (component 16). This is a convenience method that saves you from casting and handling an exception.
    • getNameValidityRange

      Returns name validity range (component 17). This is a convenience method that saves you from casting and handling an exception.
    • getXcn17_NameValidityRange

      Returns name validity range (component 17). This is a convenience method that saves you from casting and handling an exception.
    • getNameAssemblyOrder

      Returns name assembly order (component 18). This is a convenience method that saves you from casting and handling an exception.
    • getXcn18_NameAssemblyOrder

      Returns name assembly order (component 18). This is a convenience method that saves you from casting and handling an exception.