Mapping

Samenvatting: Lees hoe Mapping brondata koppelt aan doeldata in een BrynQ-interface, waarom mappings nodig zijn en hoe je ze aanmaakt, importeert, bewerkt, exporteert en onderhoudt.

Vereisten: - Je hebt een interface met bron- en doelapps nodig. - Je hebt een bewerkbare draft nodig om mappings te wijzigen. Gepubliceerde, oude, gedeactiveerde of alleen-lezen versies kun je bekijken, maar niet bewerken.

Mapping gebruiken in een interface

Mapping vertelt BrynQ hoe waarden uit een bronapp moeten worden omgezet naar waarden voor een doelapp.

Begrijpen wat mapping is

Een bronapp is het systeem waaruit BrynQ data leest.
Een doelapp is het systeem waarnaar BrynQ data schrijft.
Een mapping is een tabel met regels tussen bronwaarden en doelwaarden. Elke rij zegt: als BrynQ deze bronwaarde ontvangt, stuur dan deze doelwaarde.
Een inputkolom bevat waarden van de bronkant.
Een outputkolom bevat waarden voor de doelkant.
Een mappingrij is één omzettingsregel in de tabel.
Set all unmapped values as is een terugvalwaarde. BrynQ gebruikt deze als een bronwaarde niet in de mappingtabel staat.

Waarom mapping nodig is

Verschillende apps gebruiken vaak verschillende namen of codes voor dezelfde zakelijke betekenis.
Mapping voorkomt dat BrynQ een bronwaarde stuurt die de doelapp niet begrijpt.
Mapping maakt dataregels ook zichtbaar, zodat gebruikers en implementatieconsultants kunnen controleren welke waarden zijn toegestaan voordat een interface draait.
Zonder correcte mapping kan de interface een verkeerde waarde sturen, waarden overslaan of extra correctie nodig hebben tijdens de implementatie.

Voorbeeld

Een bron-HR-app stuurt het dienstverbandtype als Full-time, Part-time en Contractor.
De doel-payrollapp verwacht FT, PT en EXT.
Maak in Mapping een inputkolom aan voor het dienstverbandtype uit de bron en een outputkolom voor de payrollcode van het doel.
Voeg voor elke omzetting één mappingrij toe:
Full-time wordt FT.
Part-time wordt PT.
Contractor wordt EXT.
Als de interface draait, leest BrynQ de bronwaarde en stuurt het de bijbehorende doelwaarde.

Het tabblad Mapping openen

Open de interface waaraan je wilt werken.
Selecteer in de interfaceheader of de versiekiezer de juiste bewerkbare draft.
Ga in het interfacemenu naar Mapping.
Controleer de paginaheader om zeker te weten dat je de juiste bron- en doelapps mapt.

Een mapping aanmaken of importeren

Je kunt een mapping handmatig aanmaken in BrynQ of importeren uit een bestand als je de waarden al in een spreadsheet hebt.

Handmatig een nieuwe mapping aanmaken

Klik in de lege weergave op New Mapping.
Heeft de interface al mappings, klik dan in de linkerzijbalk onderaan op New Mapping.
Klik bovenaan de mapping-editor op de naam van de mapping als je die wilt wijzigen. Gebruik een naam die de zakelijke waarde uitlegt, zoals Employment type to payroll code.
Gebruik in de tabelheader Add column aan de bronkant als de omzetting nog een inputwaarde nodig heeft.
Gebruik in de tabelheader Add column aan de doelkant als de omzetting nog een outputwaarde nodig heeft.
Vul de tabelrijen in. Elke rij moet één volledige omzetting van bron naar doel bevatten.

Een mapping importeren uit een bestand

Klik op de pagina Mapping op Import mapping.
Gebruik in het venster Import data for mapping de optie File om een .csv of .xlsx bestand te uploaden.
Upload je een Excel-bestand, selecteer dan het juiste Sheet.
Upload je een CSV-bestand, kies dan het juiste Delimiter. Hiermee weet BrynQ hoe het bestand kolommen scheidt, bijvoorbeeld met een komma, puntkomma, pipe of tab.
Geef een naam op in Mapping name.
Gebruik Input range om de kolommen in het bestand te selecteren die bronwaarden bevatten.
Gebruik Output range om de kolommen in het bestand te selecteren die doelwaarden bevatten.
Zet Set first row as column name aan als de eerste rij kolomnamen bevat in plaats van mappingwaarden.
Controleer Sheet preview om te bevestigen dat BrynQ het bestand correct leest.
Klik rechtsonder in het venster op Apply and import.

Kiezen tussen handmatige en geïmporteerde mapping

Gebruik New Mapping als de tabel klein is of als je de regels direct in BrynQ wilt opbouwen.
Gebruik Import mapping als de mapping veel rijen heeft, al in Excel of CSV bestaat of eerst buiten BrynQ moet worden gecontroleerd.
Controleer de rijen na het importeren toch nog in BrynQ. Een verkeerd scheidingsteken, verkeerd sheet of verkeerde instelling voor de eerste rij kan waarden in de verkeerde kolommen zetten.

Mappings bewerken en onderhouden

Wijzigingen in mappings worden automatisch opgeslagen terwijl je in een bewerkbare draft werkt.

Een bestaande mapping bewerken

Selecteer in de linkerzijbalk Mappings de mapping die je wilt bewerken.
Klik bovenaan de editor op de naam van de mapping om die te wijzigen.
Gebruik Add column alleen als één omzetting meer dan één inputwaarde of meer dan één outputwaarde nodig heeft.
Werk tabelcellen bij als bron- of doelwaarden veranderen.
Gebruik Set all unmapped values as alleen als alle ontbrekende bronwaarden dezelfde doelwaarde moeten krijgen. Laat het leeg als niet-gemapte waarden zichtbaar moeten blijven voor controle.

Een mapping exporteren of verwijderen

Selecteer in de linkerzijbalk Mappings de mapping die je wilt gebruiken.
Klik rechtsboven in het actiegebied van de mapping-editor op het exporticoon om de huidige mapping als CSV-bestand te downloaden.
Om een mapping te verwijderen, gebruik je het prullenbakicoon naast de mapping in de linkerzijbalk.

Mappings overzichtelijk houden

Gebruik duidelijke mappingnamen die de bronwaarde en doelwaarde beschrijven.
Houd één zakelijke betekenis per mapping aan. Houd bijvoorbeeld de mapping voor dienstverbandtype gescheiden van de mapping voor afdeling.
Controleer geïmporteerde bestanden voor en na het importeren.
Verwijder oude mappings die niet meer worden gebruikt.
Controleer mappings opnieuw als een bronapp of doelapp de toegestane waarden wijzigt.

Meer informatie

Mapping op het tabblad Mapping is iets anders dan het kiezen van velden in Scenarios. Scenarios bepalen welke data in een flow thuishoort. Mapping bepaalt hoe de ene set waarden wordt omgezet naar een andere set waarden. Beide onderdelen helpen BrynQ om data correct van de bronapp naar de doelapp te verplaatsen.