HAALCENTRAAL English translation
BRP API / Personen / Features / lege-waarden

Supplying empty values

# language: en

Feature: Supplying empty values

  Rule: A boolean field with value false is not supplied

    Scenario: the person has the field: 'indicatie geheim (70.10)'
      Given the person with citizen service number '000000139' has the following 'inschrijving' data
      | naam                     | waarde    |
      | indicatie geheim (70.10) | 0         |
      When persons are searched with the following parameters
      | naam                | waarde                                            |
      | type                | RaadpleegMetBurgerservicenummer                   |
      | burgerservicenummer | 000000139                                         |
      | fields              | burgerservicenummer |
      Then the response has a person with only the following data
      | naam                | waarde    |
      | burgerservicenummer | 000000139 |

  Rule: A string (text) field with an empty value is not supplied
      - This also applies to a default/unknown value: see onbekend_waardes.feature

    Scenario: the voorvoegsel of the name is empty
      Given the person with citizen service number '000000176' has the following data
      | naam                           | waarde |
      | voornamen (02.10)              | Jan    |
      | voorvoegsel (02.30)            |        |
      | geslachtsnaam (02.40)          | Boer   |
      | aanduiding naamgebruik (61.10) | E      |
      When persons are searched with the following parameters
      | naam                | waarde                                             |
      | type                | RaadpleegMetBurgerservicenummer                    |
      | burgerservicenummer | 000000176                                          |
      | fields              | naam.voornamen,naam.voorvoegsel,naam.geslachtsnaam |
      Then the response has a person with only the following 'naam' data
      | naam          | waarde |
      | voornamen     | Jan    |
      | geslachtsnaam | Boer   |

    Scenario: geslachtsnaam has the default value
      Given the person with citizen service number '000000176' has the following data
      | naam                           | waarde |
      | voornamen (02.10)              | Jan    |
      | voorvoegsel (02.30)            |        |
      | geslachtsnaam (02.40)          | .      |
      | aanduiding naamgebruik (61.10) | E      |
      When persons are searched with the following parameters
      | naam                | waarde                                             |
      | type                | RaadpleegMetBurgerservicenummer                    |
      | burgerservicenummer | 000000176                                          |
      | fields              | naam.voornamen,naam.voorvoegsel,naam.geslachtsnaam |
      Then the response has a person with only the following 'naam' data
      | naam      | waarde |
      | voornamen | Jan    |

  Rule: An object (group) is not supplied where the underlying category does not exist or must not be supplied

    Scenario: the person has not died and has no verblijfstitel
      Given the person with citizen service number '000000176' has the following data
      | naam                           | waarde |
      | voornamen (02.10)              | Jan    |
      And the person has no 'overlijden' data
      And the person has no 'verblijfstitel' data
      When persons are searched with the following parameters
      | naam                | waarde                                        |
      | type                | RaadpleegMetBurgerservicenummer               |
      | burgerservicenummer | 000000176                                     |
      | fields              | burgerservicenummer,overlijden,verblijfstitel |
      Then the response has a person with only the following data
      | naam                | waarde    |
      | burgerservicenummer | 000000176 |

  Rule: an array (list, collection) field is supplied as an empty array where it contains no items

    Scenario: the person has no partner and no children
      Given the person with citizen service number '000000176' has the following data
      | naam                           | waarde |
      | voornamen (02.10)              | Jan    |
      And the person has no 'partners' data
      And the person has no 'kinderen' data
      When persons are searched with the following parameters
      | naam                | waarde                                |
      | type                | RaadpleegMetBurgerservicenummer       |
      | burgerservicenummer | 000000176                             |
      | fields              | burgerservicenummer,partners,kinderen |
      Then the response has a person with only the following data
      | naam                | waarde    |
      | burgerservicenummer | 000000176 |
      And the person has no 'partner' data
      And the person has no 'kind' data

    Scenario: ZoekMetGeslachtsnaamEnGeboortedatum finds no person at all
      When persons are searched with the following parameters
      | naam          | waarde                              |
      | type          | ZoekMetGeslachtsnaamEnGeboortedatum |
      | geslachtsnaam | Bestaat                             |
      | voorvoegsel   | het                                 |
      | voornamen     | Niet                                |
      | geboortedatum | 1887-09-14                          |
      | fields        | burgerservicenummer                 |
      Then the response has 0 persons

    Scenario: RaadpleegMetBurgerservicenummer finds no person at all (the BSN does not satisfy the 11--check)
      When persons are searched with the following parameters
      | naam                | waarde                          |
      | type                | RaadpleegMetBurgerservicenummer |
      | burgerservicenummer | 999999999                       |
      | fields              | burgerservicenummer             |
      Then the response has 0 persons

  Rule: An object (group) is supplied as an empty object where at least one item of data exists in that group but no field in that group must be supplied
    - A field that was not requested with fields also counts here towards the existence of the group
    - a field with a default value, an empty value or boolean false also counts here towards the existence of the group

    Scenario: An unknown name of the child gives naam as an empty object
      Given the person with citizen service number '000000310' has a 'kind' with the following data
      | naam                  | waarde |
      | geslachtsnaam (02.40) | .      |
      When persons are searched with the following parameters
      | naam                | waarde                          |
      | type                | RaadpleegMetBurgerservicenummer |
      | burgerservicenummer | 000000310                       |
      | fields              | kinderen.naam                   |
      Then the response has a person with a 'kind' with an empty 'naam' object

    Scenario: The child has no voorvoegsel, and requesting only voorvoegsel gives naam as an empty object
      Given the person with citizen service number '000000310' has a 'kind' with the following data
      | naam                  | waarde  |
      | voornamen (02.10)     | William |
      | geslachtsnaam (02.40) | Postma  |
      When persons are searched with the following parameters
      | naam                | waarde                          |
      | type                | RaadpleegMetBurgerservicenummer |
      | burgerservicenummer | 000000310                       |
      | fields              | kinderen.naam.voorvoegsel       |
      Then the response has a person with a 'kind' with an empty 'naam' object

    Scenario: A child with an unknown place of birth gives geboorte as an empty object without the plaats field
      Given the person with citizen service number '000000322' has a 'kind' with the following data
      | naam                   | waarde   |
      | geboortedatum (03.10)  | 20070421 |
      | geboorteplaats (03.20) | 0000     |
      | geboorteland (03.30)   | 0000     |
      When persons are searched with the following parameters
      | naam                | waarde                          |
      | type                | RaadpleegMetBurgerservicenummer |
      | burgerservicenummer | 000000322                       |
      | fields              | kinderen.geboorte.plaats        |
      Then the response has a person with a 'kind' with an empty 'geboorte' object