Over records: velden mappen binnen een scenario
Records: velden mappen
1. Ga naar Interfaces
2. Open de interface
4. Ga naar het tabblad Scenarios
Let op: stap 1-3 en 7 hoef je niet voor elk toegevoegd record opnieuw te doen. Je kunt meerdere records in één draft toevoegen door stap 5-6 te herhalen en ze daarna in één keer te publiceren.
Veelgestelde vragen
Wordt de interface direct uitgevoerd nadat ik een nieuw record heb toegevoegd en gepubliceerd? Worden er dus meteen gegevens van het bron- naar het doelsysteem overgezet?
Nee. Het publiceren van de interface start geen synchronisatie. De interface draait pas als je handmatig op de knop Run klikt, of als er een planning is ingesteld.
Kan ik een record toevoegen aan een scenario dat volgens een planning draait?
Ja. Voor het toevoegen van een record ga je naar de Draft-modus, en dat onderbreekt of beïnvloedt geplande runs niet. Het nieuwe record wordt pas actief zodra de draft is gepubliceerd. Geplande runs die plaatsvinden voordat je publiceert, gebruiken nog de vorige gepubliceerde versie van de interface.
Let op: Als er precies op het moment dat je publiceert een geplande run bezig is, wordt die run afgerond met de versie waarmee hij is gestart. De nieuwe versie wordt vanaf de volgende geplande run gebruikt.
Wat is het verschil tussen een record toevoegen en een veld toevoegen aan een bestaand record?
Een record legt een mapping vast tussen een of meer bronvelden en een of meer doelvelden. Met een nieuw record voeg je een volledig nieuwe mapping toe: een doelveld dat eerder niet gemapt was, krijgt nu gegevens.
Een veld toevoegen aan een bestaand record betekent dat je een bestaande mapping uitbreidt. Als een record bijvoorbeeld al First Name naar Full Namemapt, kun je Last Name aan hetzelfde record toevoegen, zodat beide velden in hetzelfde doelveld worden samengevoegd.
Kunnen twee records in hetzelfde scenario hetzelfde doelveld gebruiken?
Nee. Elk doelveld kan maar in één record per scenario worden gebruikt. Gebruik je hetzelfde doelveld twee keer, dan toont BrynQ de waarschuwing: "The same library field cannot be used multiple times as a target field in this scenario." Wil je meerdere bronvelden naar hetzelfde doelveld laten lopen? Voeg ze dan toe aan hetzelfde record.
Kunnen meerdere bronvelden naar hetzelfde doelveld gaan?
Ja. Eén record kan aan de bronkant meerdere bronvelden hebben. De instellingen voor Logic en Transformation van het record bepalen hoe die bronwaarden in het doelveld worden gecombineerd, bijvoorbeeld door First Name en Last Name samen te voegen tot Full Name. Gebruik deze aanpak als je één doelveld wilt verrijken in plaats van een aparte mapping te maken.
Geldt een nieuw toegevoegd record ook met terugwerkende kracht voor gegevens die al eerder zijn gesynchroniseerd?
Nee. Een nieuw record heeft pas effect vanaf de volgende synchronisatierun. Gegevens die al waren gesynchroniseerd voordat het record werd toegevoegd, worden niet met terugwerkende kracht bijgewerkt.
Kan ik een record dat ik net heb toegevoegd ongedaan maken als ik nog niet heb gepubliceerd?
Ja. Tot je publiceert, bestaan alle wijzigingen alleen in de draft en blijft de live versie ongewijzigd. Je kunt het record verwijderen of de hele draft verwerpen, en de live interface blijft precies zo draaien als voorheen.
Wat gebeurt er met gegevens die al in het doelsysteem staan als ik een record verwijder?
Er wordt niets uit het doelsysteem verwijderd. Door een record te verwijderen schrijven toekomstige runs niet meer naar dat doelveld, maar gegevens die BrynQ al naar het doelsysteem heeft gestuurd, blijven daar staan. BrynQ ruimt eerder gesynchroniseerde gegevens in het doelsysteem niet op.
Kan ik een record tijdelijk uitschakelen zonder het te verwijderen?
Ja. Klik op het pauze-icoon rechts in de rij van het record om het uit te schakelen. Het record verhuist naar de sectie Inactive en blijft bewaard met al zijn instellingen, maar het scenario synchroniseert het niet meer. Je kunt het op elk moment weer inschakelen om de synchronisatie te hervatten.
Het bronveld dat ik wil mappen wordt niet getoond. Wat moet ik doen?
De veldkiezer toont alleen velden die in het gepubliceerde schema van de bron-app bestaan. Ontbreekt een veld, dan is het nog niet toegevoegd aan de connectordefinitie (dat is een wijziging op beheerdersniveau). Je kunt ook een veldtype Fixed, Customof Configuration op het record gebruiken in plaats van een Library-veld.
Welke rechten heb ik nodig om een record toe te voegen?
Je hebt Edit -rechten op de interface nodig. Gebruikers met alleen-lezen toegang kunnen de interface openen, maar geen records wijzigen of de Draft-modus starten.
Waarom is de knop Publish grijs nadat ik mijn record heb toegevoegd?
Dit betekent dat nog niet aan een of meer validatie-eisen is voldaan. Veelvoorkomende oorzaken zijn:
- Het scenario mist een record met een unieke sleutel.
- Het tabblad Authorization heeft openstaande waarschuwingen.
- Hetzelfde doelveld wordt in meer dan één record gebruikt.
Kijk in de rij met tabbladen naar gele waarschuwingsdriehoeken. Die wijzen naar de tabbladen waar je het probleem moet oplossen.
Bestaande records kun je wijzigen. Je kunt velden in een record toevoegen, verwijderen of aanpassen.
In het voorbeeld hieronder wordt een bestaand record aangepast door een bronveld te vervangen door een ander bronveld. Het resultaat: als de interface draait, wordt het doelveld voortaan gevuld met gegevens uit het nieuwe bronveld.
5b.1: Verwijder het oude veld
Veelgestelde vragen
Wordt de interface direct uitgevoerd nadat ik hem heb aangepast en gepubliceerd? Worden er dus meteen gegevens van het bron- naar het doelsysteem overgezet?
Nee. Het publiceren van de interface start geen synchronisatie. De interface draait pas als je handmatig op de knop Run klikt, of als er een planning is ingesteld.
Kan ik wijzigingen aan een record na het publiceren ongedaan maken?
Ja. Je hebt twee opties: je kunt teruggaan naar een eerdere versie van de interface [link], of je maakt de wijzigingen handmatig ongedaan door opnieuw de Draft-modus te starten en ze terug te draaien met de stappen hierboven.
Is er een limiet aan het aantal velden dat ik aan een record kan toevoegen?
Er is geen harde limiet. Het wordt echter niet aangeraden om meer dan 3 bron- of doelvelden aan één record toe te voegen, tenzij daar een duidelijke reden voor is.
Werkt de interface direct correct als ik hem na het aanpassen van een record uitvoer?
Dat hangt af van de aard van de wijziging. Kleine aanpassingen werken waarschijnlijk meteen, terwijl grotere wijzigingen soms eerst getest en verder bijgesteld moeten worden voordat de synchronisatie goed werkt.
Als ik een veld uit een record verwijder, worden gegevens die al naar het doelsysteem zijn overgezet dan verwijderd?
Niet per se, maar het kan onbedoelde gevolgen hebben.
Stel bijvoorbeeld dat de volgende mapping is ingesteld:
First Name + Last Name → Full Name
Bij de eerste synchronisatie levert dit op:
John + Doe → John Doe
Als je daarna First Name uit het record verwijdert, wordt de mapping:
Last Name → Full Name
Bij de volgende synchronisatie wordt het doelveld overschreven met alleen de achternaam:
Doe → John Doe wordt Doe
De eerder gesynchroniseerde waarde gaat verloren, omdat de interface nu anders bepaalt wat Full Name moet bevatten.
Veelgestelde vragen
Wat doet uitschakelen precies? Wordt het record definitief verwijderd?
Nee. Een record uitschakelen is geen definitieve verwijdering. Het record verhuist van de actieve tabel naar de sectie Inactive van het scenario. De volledige configuratie (bronveld, doelveld, mapping en logica) blijft bewaard. Het record wordt bij de volgende run gewoon niet meer gesynchroniseerd. Je kunt het op elk moment herstellen vanuit de sectie Inactive.
Waarom is het pauze-icoon bij sommige records grijs?
Er zijn twee redenen waarom een record niet uitgeschakeld kan worden:
- Het is de unieke sleutel van het scenario (🔑). Elk scenario heeft één record nodig dat als unieke identificatie is gemarkeerd. Zonder dat record kan BrynQ medewerkers niet van elkaar onderscheiden. Wil je het uitschakelen, markeer dan eerst een ander record als unieke sleutel.
- Het is gemarkeerd als verplicht. Het doelsysteem vereist dat veld in elk record dat het ontvangt (zonder dat veld zou de synchronisatie mislukken), of de interface is gebouwd op een template waarin het record als verplicht is gedefinieerd. Uitschakelen zou de interface laten vastlopen, daarom maakt BrynQ het icoon grijs.
Worden gegevens die ik al naar het doelsysteem heb gesynchroniseerd verwijderd als ik een record uitschakel?
Nee. Door een record uit te schakelen schrijven toekomstige runs niet meer naar dat doelveld. Gegevens die BrynQ al heeft verstuurd, worden niet verwijderd of teruggedraaid. Wil je de bestaande waarden ook in het doelsysteem leegmaken, dan doe je dat rechtstreeks in het doelsysteem zelf.
Kan ik het uitschakelen ongedaan maken voordat ik publiceer?
Ja. Het uitschakelen gebeurt in de Draft-modus, dus de live interface blijft ongewijzigd. Tot je op Publish klikt en bevestigt, kun je het record herstellen vanuit de sectie Inactive of de hele draft verwerpen om alle wijzigingen terug te draaien.
Kan ik een record uitschakelen terwijl de interface volgens een planning draait?
Ja. De wijziging bestaat alleen in de Draft-modus en heeft geen invloed op geplande runs tot je publiceert. Geplande runs die starten voordat je publiceert, synchroniseren dat veld nog met de vorige gepubliceerde versie.
Let op: Als er precies op het moment dat je publiceert een geplande run bezig is, wordt die afgerond met de oude versie. De volgende geplande run neemt de wijziging mee.
Past de volgende geplande run mijn uitschakeling met terugwerkende kracht toe?
Nee. Uitschakelen heeft alleen effect op runs die starten nadat het is gepubliceerd. Eerdere runs worden niet opnieuw uitgevoerd en historische gegevens die al in het doelsysteem staan, blijven zoals ze zijn.
Is er een bevestigingsstap voordat een uitschakeling live gaat?
Het uitschakelen zelf gebeurt direct in de draft: de rij verhuist naar de sectie Inactive zodra je op het pauze-icoon klikt. De veiligheidscontrole komt bij het publiceren: BrynQ toont het dialoogvenster "Warning! You are about to publish your draft" dat je moet bevestigen voordat wijzigingen live gaan. Tot je bevestigt, kun je het uitschakelen nog terugdraaien.
Kan ik meerdere records tegelijk uitschakelen?
Op dit moment niet: records worden één voor één uitgeschakeld. Je kunt wel meerdere records achter elkaar in dezelfde draft uitschakelen en daarna één keer publiceren, zodat alle wijzigingen samen als één update live gaan.
Wat is het verschil tussen een record uitschakelen en een heel scenario uitschakelen?
Als je een record uitschakelt, zet je één mapping binnen een scenario uit. De rest van het scenario blijft normaal synchroniseren. Als je een scenario uitschakelt, zet je alle records daarin uit en stopt de volledige gegevensstroom voor dat onderwerp.
Schakel een record uit als je het grootste deel van het scenario wilt laten synchroniseren maar één veld wilt overslaan. Schakel het scenario uit als de hele gegevensstroom voor dat onderwerp moet pauzeren.
Wat gebeurt er met de waardemapping (conversietabel) die het uitgeschakelde record gebruikte?
De waardemapping wordt niet beïnvloed. Waardemappings staan op het tabblad Mapping , los van een specifiek record. Als je een record uitschakelt dat naar een mapping verwees, blijft die mapping intact en beschikbaar voor andere records.
Heeft het uitschakelen van een record op enige manier invloed op het bronsysteem?
Nee. BrynQ leest alleen uit het bronsysteem en wijzigt nooit brongegevens of het schema ervan. Een record uitschakelen betekent alleen dat dit scenario bij de volgende run niet meer uit dat bronveld leest. Het veld blijft ongewijzigd bestaan in het bronsysteem.