# Filter rules reference

This appendix lists of all the filter rules currently defined in &app;. Each of these rules is available for use when creating custom filters. The rules are listed by their categories.

## General filters

This category includes the following most general rules:

Has complete record

  This rule matches all people whose records are marked as complete. Currently, the completeness of personal information is marked manually, in the Edit Person dialog.

Everyone

  This rule matches any person in the database. As such it is not very useful on its own except for testing purposes. However, it may be useful in combinations with other rules.

Has a name

  This rule matches any person whose name matches the specified value in full or in part. For example, Marta Ericsdotter will be matched by the rule using the value "eric" for the family name.

  Separate values can be used for Given name, Family name, Suffix, and the Title. The rule returns a match if and only if all non-empty values are (partially) matched by a person's name. To use just one value, leave the other values empty.

Has the Id

  This rule matches any person with a specified &app; ID. The rule returns a match only if the ID is matched exactly.

  You can either enter the ID into a text entry field, or select a person from the list by clicking Select... button. In the latter case, the ID will appear in the text field after the selection was made.

Is a female

  This rule matches any female person.

Is a male

  This rule matches any male person.

## Event filters

This category includes the following rules that match people based on their recorded events:

Has the birth

  This rule matches people whose birth event matches specified values for Date, Place, and Description. The rule returns a match even if the person's birth event matches the value partially. The matching rules are case-insensitive. For example, anyone born in Sweden will be matched by the rule using the value "sw" for the Place.

  The rule returns a match if and only if all non-empty values are (partially) matched by a person's birth. To use just one value, leave the other values empty.

Has the death

  This rule matches people whose death event matches specified values for Date, Place, and Description. The rule returns a match even if the person's death event matches the value partially. The matching rules are case-insensitive. For example, anyone who died in Sweden will be matched by the rule using the value "sw" for the Place.

  The rule returns a match if and only if all non-empty values are (partially) matched by a person's death. To use just one value, leave the other values empty.

Has the personal event

  This rule matches people that have a personal event matching specified values for the Event type, Date, Place, and Description. The rule returns a match even if the person's event matches the value partially. The matching rules are case-insensitive. For example, anyone who graduated in Sweden will be matched by the rule using the Graduation event and the value "sw" for the Place.

  The personal events should be selected from a pull-down menu. The rule returns a match if and only if all non-empty values are (partially) matched by the personal event. To use just one value, leave the other values empty.

Has the family event

  This rule matches people that have a family event matching specified values for the Event type, Date, Place, and Description. The rule returns a match even if the person's event matches the value partially. The matching rules are case-insensitive. For example, anyone who was married in Sweden will be matched by the rule using the Marriage event and the value "sw" for the Place.

  The family events should be selected from a pull-down menu. The rule returns a match if and only if all non-empty values are (partially) matched by the personal event. To use just one value, leave the other values empty.

## Family filters

This category includes the following rules that match people based on their family relationships:

Has the relationships

  This rule matches people with a particular relationship. The relationship must match the type selected from the menu. Optionally, the number of relationships and the number of children can be specified.

  The rule returns a match if and only if all non-empty values are (partially) matched by a person's relationship. To use just one value, leave the other values empty.

Is spouse of filter match

  This rule matches people married to someone who is matched by the specified filter. The specified filter name should be selected from the menu.

Is a child of filter match

  This rule matches people for whom either parent is matched by the specified filter. The specified filter name should be selected from the menu.

Is a parent of filter match

  This rule matches people whose child is matched by the specified filter. The specified filter name should be selected from the menu.

## Ancestral filters

This category includes the following rules that match people based on their ancestral relations to other people:

Is an ancestor of

  This rule matches people who are ancestors of the specified person. The Inclusive option determines whether the specified person should be considered his/her own ancestor (useful for building reports).

  You can either enter the ID into a text entry field, or select a person from the list by clicking Select... button. In the latter case, the ID will appear in the text field after the selection was made.

Is an ancestor of person at least N generations away

  This rule matches people who are ancestors of the specified person and are at least N generations away from that person in their lineage. For example, using this rule with the value of 2 for the number of generations will match grandparents, great-grandparents, etc., but not the parents of the specified person.

Is an ancestor of person not more than N generations away

  This rule matches people who are ancestors of the specified person and are no more than N generations away from that person in their lineage. For example, using this rule with the value of 2 for the number of generations will match parents and grandparents, but not great-grandparents, etc., of the specified person.

Has a common ancestor with

  This rule matches people who have common ancestors with the specified person.

Has a common ancestor with filter match

  This rule matches people who have common ancestors with someone who is matched by the specified filter. The specified filter name should be selected from the menu.

Is an ancestor of filter match

  This rule matches people who are ancestors of someone who is matched by the specified filter. The specified filter name should be selected from the menu.

## Descendant filters

This category includes the following rules that match people based on their descendant relations to other people:

Is a descendant of

  This rule matches people who are descendants of the specified person. The Inclusive option determines whether the specified person should be considered his/her own descendant (useful for building reports).

  You can either enter the ID into a text entry field, or select a person from the list by clicking Select... button. In the latter case, the ID will appear in the text field after the selection was made.

Is a descendant of person at least N generations away

  This rule matches people who are descendants of the specified person and are at least N generations away from that person in their lineage. For example, using this rule with the value of 2 for the number of generations will match grandchildren, great-grandchildren, etc., but not the children of the specified person.

Is a descendant of person not more than N generations away

  This rule matches people who are descendants of the specified person and are no more than N generations away from that person in their lineage. For example, using this rule with the value of 2 for the number of generations will match children and grandchildren, but not great-grandchildren, etc., of the specified person.

Is a descendant of filter match

  This rule matches people who are descendants of someone who is matched by the specified filter. The specified filter name should be selected from the menu.

Is a descendant family member of

  This rule not only matches people who are descendants of the specified person, but also those descendants' spouses.

## Relationship filters

This category includes the following rules that match people based on their mutual relationship:

Relationship path between two people

  This rule matches all ancestors of both people back to their common ancestors (if exist). This produces the "relationship path" between these two people, through their common ancestors.

  You can either enter the ID of each person into the appropriate text entry fields, or select people from the list by clicking their Select... buttons. In the latter case, the ID will appear in the text field after the selection was made.

## Miscellaneous filters

This category includes the following rules which do not naturally fit into any of the above categories:

Has the personal attribute

  This rule matches people who have the personal attribute of the specified value. The specified personal attribute name should be selected from the menu. The specified value should be typed into the text entry field.

Has the family attribute

  This rule matches people who have the family attribute of the specified value. The specified family attribute should be selected from the menu. The specified value should be typed into the text entry field.

Matches the filter named

  This rule matches people who are matched by the specified filter. The specified filter name should be selected from the menu.