Samenvatting: Stel Scenarios in een interfacetemplate in, zodat BrynQ weet welke bedrijfsflow de template ondersteunt, welke brondata bij welke doeldata hoort en welke waardemappings gebruikers moeten invullen.

Vereisten: - Je hebt toegang nodig tot Admin portal en rechten om Interface templates te beheren. - De template moet een bewerkbaar concept hebben. Is de templateversie alleen-lezen, gebruik dan eerst Create draft of Continue draft in de koptekst van de template. - De template moet al bron- en doelapps hebben, omdat scenario's de velden uit die apps gebruiken.

Scenario's instellen in een template-interface

Scenario's beschrijven wat BrynQ moet doen voor één bedrijfsflow in een template, zoals medewerkers aanmaken, contracten bijwerken of verzuimregistraties synchroniseren.

Waarom scenario's belangrijk zijn

• Een Scenario groepeert de velden, regels en mappings voor één resultaat. Zo blijven verschillende flows gescheiden en halen gebruikers geen velden voor ongerelateerde acties door elkaar.
• Een scenarioregel vertelt BrynQ: lees deze waarde uit de Source fields, schrijf of vergelijk deze met deze waarde in de Target fields en gebruik Mapping als de waarden anders heten.
• De scenario-instelling is onderdeel van de template. Gebruikers die een interface op basis van de template aanmaken, zien deze scenario's later en vullen alleen de waarden of mappings in die nog klantspecifieke keuzes nodig hebben.

De stap Scenarios openen

• Open in de linkernavigatie Admin portal.
• Open in Admin portal de pagina Interface templates en selecteer de template die je wilt bewerken.
• Open bovenaan de templatepagina de bewerkbare versie met Create draft of Continue draft als de huidige versie niet bewerkt kan worden.
• Selecteer in de stapnavigatie van de template Scenarios. De pagina toont links de lijst met scenario's en rechts de scenario-editor.

Scenario's toevoegen, selecteren of herschikken

• Klik onderaan de linkerlijst met scenario's op Add new scenario om een scenario aan het concept toe te voegen.
• Selecteer in de linkerlijst een scenarionaam om de details rechts te bewerken.
• Gebruik de sleepgreep links van een scenarionaam om de volgorde van de scenario's te wijzigen. Deze volgorde zien gebruikers wanneer ze een interface op basis van de template configureren.
• Gebruik het menu met drie puntjes rechts van een scenarionaam en kies Delete scenario als het scenario uit de template moet worden verwijderd.
• Toont het waarschuwingsicoon This scenario has validation errors, open dan dat scenario en vul de ontbrekende of ongeldige instellingen aan voordat je de template publiceert.

De scenariokop invullen

• Vul bovenaan de editor Name of your scenario in. Gebruik een korte actienaam, bijvoorbeeld Create employee of Update contract.
• Vul onder de naam Description in. Leg uit wanneer gebruikers dit scenario moeten gebruiken en welk resultaat de flow oplevert.
• Wordt Target scheme onder Description getoond, selecteer dan het doelschema dat bij dit scenario past. Het gekozen schema filtert de Target fields, zodat gebruikers geen data naar het verkeerde deel van de doelapp mappen.
• Wijzig je Target scheme terwijl regels al doelvelden bevatten, controleer de regels dan opnieuw. BrynQ verwijdert doelvelden en mappings die niet meer bij het gekozen schema passen.

Scenarioregels configureren

Elke regel verbindt brondata met doeldata. Een regel kan ook verplicht gedrag, unieke matching, transformatie en waardemapping vastleggen.

Bronvelden, doelvelden en mapping begrijpen

• Source fields zijn de velden die BrynQ uit de bronapp leest. In een HR-bronapp kan dit bijvoorbeeld Employee number, Employment status of Department zijn.
• Target fields zijn de velden waar BrynQ naartoe schrijft of die BrynQ controleert in de doelapp. In een salarisdoelapp kan dit bijvoorbeeld Worker ID, Status of Cost center zijn.
• Mapping is de vertaling van waarden tussen de gekozen bronvelden en de gekozen doelvelden. Gebruik het wanneer de bronapp en de doelapp verschillende waarden gebruiken voor dezelfde zakelijke betekenis.
• BrynQ gebruikt de selectie in Source fields en Target fields om de mappingtabel op te bouwen. De bronkant wordt de invoerkolommen. De doelkant wordt de uitvoerkolommen.
• Een regel in de mappingtabel is een conversieregel. Die vertelt BrynQ: als de bronwaarde dit is, gebruik dan deze doelwaarde.
• Voorbeeld: de bronapp stuurt Active, maar de doelapp verwacht Employed. Kies in de scenarioregel Employment status onder Source fields, kies Status onder Target fields, open Mapping en voeg Active toe als bronwaarde met Employed als doelwaarde.

Bron- en doelvelden kiezen

• Gebruik in de regelkop Source fields om de data te kiezen die BrynQ uit de bronapp leest.
• Gebruik daarnaast Target fields om de data te kiezen die BrynQ naar de doelapp schrijft.
• Gebruik in elke veldkiezer het menu voor het veldtype om het soort waarde te kiezen:
• Library field voor standaardvelden uit de gekozen app.
• Configuration field voor antwoorden uit de templatestap Configuration.
• Custom field wanneer de gebruiker van de interface later een klantspecifiek veld mag kiezen.
• Fixed value wanneer altijd dezelfde waarde gebruikt moet worden.
• Empty value wanneer de regel bewust geen waarde moet versturen.
• Klik tussen regels op de plusknop om direct onder de huidige regel een regel toe te voegen.
• Gebruik rechts van een regel de prullenbakknop om een regel te verwijderen die geen deel van het scenario moet zijn.

Mapping en Must fill configureren

• Klik in de kolom Mapping op de mappingknop om het venster Mapping voor die regel te openen.
• Voeg in Mapping conversieregels toe wanneer bronwaarden naar andere doelwaarden vertaald moeten worden, zoals Active naar Employed, Inactive naar Terminated of Temporary naar Fixed term.
• Gebruik Value mapping strategy wanneer BrynQ bronwaarden minder strikt moet vergelijken. Kies bijvoorbeeld een strategie die hoofdletters negeert wanneer active en Active als dezelfde waarde moeten gelden.
• Gebruik Set all unmapped values as wanneer waarden die niet in de mappingtabel staan één standaard doelwaarde moeten krijgen.
• Zet Lock mapping for additions aan wanneer de mapping van de template compleet is en gebruikers geen extra mappingwaarden mogen toevoegen tijdens het configureren van een interface op basis van de template.
• Zet Must fill aan voor een regel wanneer de gebruiker van de interface de mapping van die regel moet invullen of bevestigen voordat de interface afgerond kan worden.
• Laat Must fill uit wanneer de mapping nuttig is, maar niet altijd nodig.
• Mapping is uitgeschakeld voor velden met Fixed value en Empty value, omdat die waarden geen conversietabel van bron naar doel nodig hebben.

Regels markeren als Unique key en Required

• Gebruik rechts van een regel Unique key wanneer het veld BrynQ helpt om bronrecords aan doelrecords te koppelen. Een scenario heeft normaal gesproken minstens één unieke sleutel nodig, zodat BrynQ records veilig kan vergelijken.
• Gebruik Required wanneer de regel aanwezig moet zijn om de interface goed te laten werken.
• Is het gekozen doelveld verplicht in de doelapp, dan zet BrynQ Required automatisch aan en kan de knop niet worden uitgezet.

Logic en Transformation toevoegen

• Klap links van een regel de regel uit met de pijlknop wanneer je extra instellingen nodig hebt.
• Gebruik in de uitgeklapte regel Logic voor korte implementatienotities of bedrijfsregels die uitleggen hoe de regel verwerkt moet worden.
• Gebruik Transformation wanneer een of meer bronvelden een specifieke verwerkingsmethode nodig hebben:
• Automatic (based on relation) laat BrynQ het gedrag kiezen op basis van de relatie tussen bron- en doelvelden.
• Concatenate voegt bronwaarden samen.
• Fill in order mapt bronvelden op positie naar doelvelden.
• Keep source fields laat de gekozen bronvelden ongewijzigd.

De scenario-instelling controleren en opslaan

BrynQ slaat wijzigingen in scenario's automatisch op terwijl je in het concept werkt.

Het concept controleren voor publicatie

• Controleer in de linkerlijst met scenario's dat geen enkel scenario nog This scenario has validation errors toont.
• Controleer elke scenarioregel op de juiste instellingen voor Source fields, Target fields, Mapping, Must fill, Unique key en Required.
• Controleer ook de andere templatestappen, zoals Configuration, Mapping, Variables en Data filters, voordat je de template publiceert.
• Publiceer de template pas wanneer alle scenario's compleet zijn en het concept geen validatiewaarschuwingen meer heeft.

Meer informatie

Houd elk scenario gericht op één bedrijfsflow. Ondersteunt een template meerdere flows, maak dan aparte scenario's in plaats van alle regels in één groot scenario te zetten. Zo is de template makkelijker te configureren voor gebruikers en makkelijker te onderhouden voor je team.