Naar de inhoud

Referentiedata beheren

Mapping­datasets

Maak codevertalingen tussen systemen expliciet en beheerbaar.

Verschillende systemen gebruiken vaak verschillende codes voor hetzelfde bedrijfsbegrip.

Een ERP, CRM, datawarehouse of rapportageplatform kan klanten, producten of kostenplaatsen elk anders indelen.

Een mappingdataset legt die relaties vast als beheerde referentiedata, zodat elke afnemer dezelfde vertaling gebruikt.

ERP-codeCRM-segment
WH_LOCAL→B2B
WH_INTL→B2B
RETAIL→B2C
ERP naar CRM-segmenten · Versie 2Eigenaar: DatamanagementGepubliceerd
CRMRapportageWarehouseKoppelingen
Eén gepubliceerde mapping, gebruikt door meerdere systemen.

Definitie

Wat is een mappingdataset?

Een mappingdataset legt de relatie vast tussen waarden die verschillende systemen gebruiken.

Daarmee vertalen koppelingen, applicaties en rapportages de ene code steeds op dezelfde manier naar de andere.

  • ERP → CRM
  • Oud platform → nieuw platform
  • Interne code → externe standaard
  • Kostenplaats → rapportagesegment
ERPWH_LOCAL
↓
MappingdatasetWH_LOCAL → B2B
↓
CRMB2B

Waar het misgaat

Waarom mappings in code belanden

Mappings beginnen vaak als spreadsheet, opzoektabel of vastgeprogrammeerde transformatie.

Na verloop van tijd gebruiken verschillende systemen verschillende vertalingen voor dezelfde waarde.

  • Verschillende uitkomsten
  • Verschillende mappings
  • Verborgen bedrijfslogica
  • Onbekend eigenaarschap
  • Geen beoordeling
  • Lastige audit

Verborgen mappings

CASE-expressieWHEN WH_LOCAL THEN B2B
Spreadsheetlookup.xlsx
JSON-configuratiemapping.json
ETL-configuratieetl_config.yml
ERP naar CRM-segmentenVersie 2Eigenaar: DatamanagementIngangsdatum: 2026-01-01Gepubliceerd
Verborgen mappings → één gepubliceerde vertaaltabel

Eenduidig opzoeken

Eén broncode, één antwoord

Elke bronwaarde komt één keer voor.

Elke afnemer krijgt voor dezelfde opzoekvraag hetzelfde antwoord.

Meerdere broncodes mogen bewust naar hetzelfde doel verwijzen, maar binnen één publicatie geeft een broncode nooit tegenstrijdige antwoorden.

MogelijkVeel op één
WH_LOCAL→B2B
WH_INTL→B2B
Niet mogelijkEén op veel
WH_LOCAL→B2B
WH_LOCAL→SMB

Elke broncode leidt tot één gepubliceerd antwoord.

Zichtbare uitzonderingen

Wat gebeurt er als er een nieuwe code bijkomt?

De meeste mappingproblemen beginnen als een bronsysteem een waarde introduceert die nog niet in de mapping staat.

Die beslissing hoort expliciet beoordeeld te worden, niet verstopt in koppelingscode.

Krijgt de brondataset een nieuwe versie, dan laat de draft van de mapping zien welke codes nieuw en nog niet gekoppeld zijn, en welke uit de bron zijn verdwenen.

Een draft van de mapping Kostenplaatsen naar rapportage nadat de bron naar Kostenplaatsen V3 is gegaan: code 1030 is uit de bron verdwenen en gemarkeerd voor verwijdering, en de nieuwe code 1450 is nog niet gekoppeld.

Beheerste wijziging

Beheer mappings met een beheerst proces

Wijzigingen in mappings doorlopen hetzelfde beoordelings- en publicatieproces als andere beheerde referentiedata.

VoorbereidenDraft
→
GoedkeurenBeoordelen
→
VersiePublicerenVersie 3Geldig vanaf 2026-06-01
→
APIAfnemen
  1. Baseer de mapping op een brondataset

    Kies de gepubliceerde bronwaarden en het veld dat elke code identificeert.

  2. Beoordeel koppelingen en uitzonderingen

    Bevestig elke vertaling en houd ontbrekende doelen zichtbaar.

  3. Publiceer de afgesproken vertaaltabel

    Maak een onveranderlijke mappingversie met een releasenotitie en ingangsdatum.

  4. Laat afnemers de publicatie gebruiken

    Applicaties en koppelingen halen dezelfde vertaaltabel op via de API.

Ingangsdatums

Publiceer mappingversies met een ingangsdatum

Mappings veranderen in de loop van de tijd.

Een nieuwe bedrijfsindeling of migratie kan in de toekomst een andere vertaling vragen.

Beide mappingversies blijven beschikbaar, zodat afnemers de vertaling kunnen gebruiken die op een bepaalde datum gold.

Versie 2Gepubliceerd
Geldig tot 2026-06-01WH_LOCAL→B2B
↓
Versie 3Gepubliceerd
Geldig vanaf 2026-06-01WH_LOCAL→SMB
Afnemers krijgen de versie die geldt op de datum die ze opvragen.

Duidelijke afbakening

Een mappingdataset is geen veldmapping

Veldmapping beantwoordt:
Welke invoerkolom vult welk veld?

Mappingdatasets beantwoorden:
Welke bedrijfswaarde hoort bij welke bedrijfswaarde?

VeldmappingKlanttype↓Segment
MappingdatasetWH_LOCAL↓B2B

Voorbeelden

Veelvoorkomende mappingdatasets

ERP naar CRM

Vertaal klant- en segmentindelingen.

SAP-kostenplaatsen naar Salesforce-regio's

Koppel organisatiestructuren tussen applicaties.

Oud naar nieuw platform

Ondersteun migraties zonder dat de betekenis verloren gaat.

Kostenplaatsmapping

Relateer operationele en rapportagestructuren.

Interne codes naar branchestandaarden

Koppel bedrijfsindelingen aan branchestandaarden.

Warehouse-dimensies

Stem rapportagedata uit verschillende bronnen op elkaar af.

Waarom refrncr

Waarom teams refrncr gebruiken voor mappingdatasets

  • Gepubliceerde vertaaltabellen
  • Eén broncode, één antwoord
  • Beoordelingsstappen
  • Ontbrekende mappings blijven zichtbaar
  • Ingangsdatums
  • Versiegeschiedenis
  • Audittrail
  • Toegang via API

Begin met echte data

Begin met één mapping die te vaak in code verandert

Kies een mapping die nu in spreadsheets, ETL-jobs of applicatiecode wordt bijgehouden.

Vervang verborgen vertalingen door één gepubliceerde mappingdataset en maak die beschikbaar via de API.