HAALCENTRAAL English translation
BRP API / Personen / Features / adellijk

Use of the name in running text for a person with a title of nobility

# language: en

Feature: Use of the name in running text for a person with a title of nobility
  The gebruikInLopendeTekst for a person is filled by the provider, so that a person can be referred to unambiguously.

  The gebruikInLopendeTekst can be used, for example, in a sentence in a letter such as "In uw brief van 12 mei jongstleden, geeft u het overlijden van uw vader, de heer In het Veld, aan.", where "de heer In het Veld" has been taken from the attribute gebruikInLopendeTekst.

  # In the tables below the abbreviations mean:
  # GA = "mevrouw", "de heer" or the initials
  # VL = initials
  # VV = voorvoegselGeslachtsnaam (surname prefix)
  # GN = surname
  # VP = voorvoegselGeslachtsnaam of the partner
  # GP = surname of the partner
  # AT = title of nobility
  # PR = predicate
  # HT = courtesy title or 'titre de courtoisie'

  Rule: gebruikInLopendeTekst for a person with a title of nobility or a predicate is composed depending on the gender and the value of aanduidingNaamgebruik, whereby:
    - gebruikInLopendeTekst is composed from the name components of the person and of any (former) partner, on the basis of aanduidingNaamgebruik:
      | aanduidingNaamgebruik | gebruikinlopendetekst |
      | E                     | PR AT VV GN           |
      | P                     | GA VP GP              |
      | V                     | GA VP GP-PR AT VV GN  |
      | N                     | PR AT VV GN-VP GP     |
    - The title of nobility or the predicate is included in gebruikInLopendeTekst in the form matching the gender of the person:
      | adellijkeTitelPredicaat | vrouw     | man      | onbekend |
      | G                       | gravin    | graaf    | -        |
      | GI                      | gravin    | graaf    | -        |
      | B                       | barones   | baron    | -        |
      | BS                      | barones   | baron    | -        |
      | H                       | hertogin  | hertog   | -        |
      | HI                      | hertogin  | hertog   | -        |
      | M                       | markiezin | markies  | -        |
      | MI                      | markiezin | markies  | -        |
      | P                       | prinses   | prins    | -        |
      | PS                      | prinses   | prins    | -        |
      | R                       | -         | ridder   | -        |
      | JH                      | jonkvrouw | jonkheer | -        |
      | JV                      | jonkvrouw | jonkheer | -        |
    - Where the title of nobility or the predicate has no form matching the gender (shown in the table above as a - sign), it is not included
    - Where gebruikInLopendeTekst does not begin with a title of nobility or a predicate, it is preceded by "mevrouw", "de heer" or the initials, depending on the gender:
      | geslacht | gebruikInLopendeTekst begint met (GA) |
      | M        | de heer                               |
      | V        | mevrouw                               |
      | O        | VL                                    |
    - A title of nobility or a predicate is written in lower case
    - The first name component directly after "mevrouw" or "de heer" begins with a capital letter
    - Where a name component has no value or an empty value, the superfluous space is not included: no leading space, no trailing space, no double space, no space after a hyphen

    The gebruikInLopendeTekst is composed in the same way as for a person without a title of nobility or predicate in the following cases:
    - Where the combination of adellijkeTitelPredicaat and gender does not occur in the table above: gender "O", or a woman with the title "R" (knight)
    - Where the person uses the surname of the spouse/partner without their own surname: aanduidingNaamgebruik is "P"
    - Where the person has a predicate and the gender equals "V" (female) and the person concerned has a partner
    - Where the person has a predicate and the gender equals "V" (female) and the person concerned uses the name of the (former) partner (aanduidingNaamgebruik is not equal to "E")

    Scenario Outline: a person with a title of nobility has aanduidingNaamgebruik "<naamgebruik>"
      Given the person with citizen service number '000000176' has the following data
        | naam                                 | waarde        |
        | geslachtsaanduiding (04.10)          | V             |
        | voornamen (02.10)                    | Jo Anne       |
        | adellijke titel of predicaat (02.20) | BS            |
        | voorvoegsel (02.30)                  | van den       |
        | geslachtsnaam (02.40)                | Aedel         |
        | aanduiding naamgebruik (61.10)       | <naamgebruik> |
        And the person has a 'partner' with the following data
        | naam                                 | waarde |
        | adellijke titel of predicaat (02.20) |        |
        | voorvoegsel (02.30)                  | de     |
        | geslachtsnaam (02.40)                | Boer   |
        When persons are searched with the following parameters
        | naam                | waarde                            |
        | type                | RaadpleegMetBurgerservicenummer   |
        | burgerservicenummer | 000000176                         |
        | fields              | adressering.gebruikInLopendeTekst |
        Then the response has a person with the following 'adressering' data
        | naam                  | waarde                  |
        | gebruikInLopendeTekst | <gebruikInLopendeTekst> |

        Examples:
        | naamgebruik | gebruikInLopendeTekst                 |
        | E           | barones van den Aedel                 |
        | P           | mevrouw De Boer                       |
        | V           | mevrouw De Boer-barones van den Aedel |
        | N           | barones van den Aedel-de Boer         |

    Scenario Outline: a person with a predicate and geslacht "<geslacht>" and aanduidingNaamgebruik "<naamgebruik>" has a partner
      Given the person with citizen service number '000000188' has the following data
        | naam                                 | waarde        |
        | geslachtsaanduiding (04.10)          | <geslacht>    |
        | voornamen (02.10)                    | Jo Anne       |
        | adellijke titel of predicaat (02.20) | JV            |
        | voorvoegsel (02.30)                  | van den       |
        | geslachtsnaam (02.40)                | Aedel         |
        | aanduiding naamgebruik (61.10)       | <naamgebruik> |
        And the person has a 'partner' with the following data
        | naam                                 | waarde    |
        | burgerservicenummer (01.20)          | 000000218 |
        | adellijke titel of predicaat (02.20) |           |
        | voorvoegsel (02.30)                  | de        |
        | geslachtsnaam (02.40)                | Boer      |
        When persons are searched with the following parameters
        | naam                | waarde                            |
        | type                | RaadpleegMetBurgerservicenummer   |
        | burgerservicenummer | 000000188                         |
        | fields              | adressering.gebruikInLopendeTekst |
        Then the response has a person with the following 'adressering' data
        | naam                  | waarde                  |
        | gebruikInLopendeTekst | <gebruikInLopendeTekst> |

        Examples:
        | geslacht | naamgebruik | gebruikInLopendeTekst                  |
        | M        | E           | jonkheer van den Aedel                 |
        | M        | P           | de heer De Boer                        |
        | M        | V           | de heer De Boer-jonkheer van den Aedel |
        | M        | N           | jonkheer van den Aedel-de Boer         |
        | V        | E           | mevrouw Van den Aedel                  |
        | V        | P           | mevrouw De Boer                        |
        | V        | V           | mevrouw De Boer-van den Aedel          |
        | V        | N           | mevrouw Van den Aedel-de Boer          |

    Scenario Outline: a person with a predicate and geslacht "<geslacht>" has a dissolved marriage or partnership and aanduidingNaamgebruik "<naamgebruik>"
      Given the person with citizen service number '000000206' has the following data
        | naam                                 | waarde        |
        | geslachtsaanduiding (04.10)          | <geslacht>    |
        | voornamen (02.10)                    | Jo Anne       |
        | adellijke titel of predicaat (02.20) | JV            |
        | voorvoegsel (02.30)                  | van den       |
        | geslachtsnaam (02.40)                | Aedel         |
        | aanduiding naamgebruik (61.10)       | <naamgebruik> |
        And the person has no current partner
        And the person has a 'ex-partner' with the following data
        | naam                                                         | waarde    |
        | burgerservicenummer (01.20)                                  | 000000218 |
        | adellijke titel of predicaat (02.20)                         |           |
        | voorvoegsel (02.30)                                          | de        |
        | geslachtsnaam (02.40)                                        | Boer      |
        | datum ontbinding huwelijk/geregistreerd partnerschap (07.10) | 20211109  |
        When persons are searched with the following parameters
        | naam                | waarde                            |
        | type                | RaadpleegMetBurgerservicenummer   |
        | burgerservicenummer | 000000206                         |
        | fields              | adressering.gebruikInLopendeTekst |
        Then the response has a person with the following 'adressering' data
        | naam                  | waarde                  |
        | gebruikInLopendeTekst | <gebruikInLopendeTekst> |

        Examples:
        | geslacht | naamgebruik | gebruikInLopendeTekst                  |
        | M        | E           | jonkheer van den Aedel                 |
        | M        | P           | de heer De Boer                        |
        | M        | V           | de heer De Boer-jonkheer van den Aedel |
        | M        | N           | jonkheer van den Aedel-de Boer         |
        | V        | E           | jonkvrouw van den Aedel                |
        | V        | P           | mevrouw De Boer                        |
        | V        | V           | mevrouw De Boer-van den Aedel          |
        | V        | N           | mevrouw Van den Aedel-de Boer          |

    Scenario Outline: a person with adellijkeTitelPredicaat "<adellijkeTitelPredicaat>" and geslacht "<geslacht>"
      Given the person with citizen service number '000000231' has the following data
        | naam                                 | waarde                    |
        | geslachtsaanduiding (04.10)          | <geslacht>                |
        | voornamen (02.10)                    | Jo Anne                   |
        | adellijke titel of predicaat (02.20) | <adellijkeTitelPredicaat> |
        | voorvoegsel (02.30)                  | van den                   |
        | geslachtsnaam (02.40)                | Aedel                     |
        | aanduiding naamgebruik (61.10)       | E                         |
        When persons are searched with the following parameters
        | naam                | waarde                            |
        | type                | RaadpleegMetBurgerservicenummer   |
        | burgerservicenummer | 000000231                         |
        | fields              | adressering.gebruikInLopendeTekst |
        Then the response has a person with the following 'adressering' data
        | naam                  | waarde                  |
        | gebruikInLopendeTekst | <gebruikInLopendeTekst> |

        Examples:
        | adellijkeTitelPredicaat | geslacht | gebruikInLopendeTekst   |
        | G                       | M        | graaf van den Aedel     |
        | G                       | V        | gravin van den Aedel    |
        | G                       | O        | J.A. van den Aedel      |
        | JV                      | M        | jonkheer van den Aedel  |
        | JV                      | V        | jonkvrouw van den Aedel |
        | JV                      | O        | J.A. van den Aedel      |
        | R                       | M        | ridder van den Aedel    |
        | R                       | V        | mevrouw Van den Aedel   |
        | R                       | O        | J.A. van den Aedel      |