Le fichier 'mappings.yaml' est injecté à l'initialisation d'une installation ou au "reset des mappings". Il constitue une base versionnée dans les sources de Koha où on espère stabiliser une liste globale de mappings de base. Lorsqu'il est injecté, les informations vont en base de données dans 3 tables. Le mappings.pl (Administration > Configuration du moteur de recherche) est une interface qui permet de modifier les informations dans ces 3 tables. À aucun moment il ne permet de retourner vers le yaml.

100a_/9-12 ⇒ récupère les caractères 10 à 13 du champs 100$a 100a_/9 ⇒ récupère uniquement le 10eme (les index commencent à 0) caractère

011azy ⇒ Prend les sous-champs a, z et y du 011 et les ajoute séparément dans le champ de recherche Elasticsearch. Exemple:

Dans Koha:

700 $a Hall $b John

Mapping:

author => 700ab

Dans ES:

author => [
  'John',
  'Hall'
]

L'exemple ci-dessus revient au même que d'écrire 2 mapping comme ceci:

author => 700b
author => 700a

215(ajxyz)⇒ récupère les sous-champs a, j, x, y et z et les ajoute dans un seul et même champ ES (concaténation). Exemple:

Dans Koha:

700 $a Hall $b John

Mapping:

author => 700(ab)

Dans ES:

author => [ 'Hall John' ]

Écrire un mapping sans spécifier les sous-champs (i.e. author ⇒ 700), récupère tous les sous-champs du 700 est les ajoute séparément au champ ES correspondant.

Dans Koha:

700 $a Hall $b John $9 123

Dans ES:

author => [
  'Hall',
  'John',
  '123'
]