The Ancestry query is used to query the application for an ascending pedigree rooted at a person and for a specific number of generations. The result of the query is a list of persons. Each person comes with an ascendancy number in the display properties for the person. The ascendancy number is interpreted as an ahnen number that determines the position of each person in the pedigree.

Note:

• The person parameter is the ID for the person at the root of the pedigree. The person parameter is required. The ancestor number of the person identified by the person parameter will be 1, unless the spouse parameter is provided.
• The presence of the spouse parameter indicates that the pedigree of both the person and the person's spouse is requested. When the spouse parameter is supplied, the ascendancy number of the person and the spouse is either 2 or 3, depending on the role of the person.
  • If the value of the spouse parameter is empty, the application may select a spouse for the person.
  • Otherwise, the value of the spouse parameter is interpreted as the ID of the spouse selected for the pedigree.