Installation & Configuration Custom Selector SE

Eddon Software BV Rietveldenweg 82 5222 AS s Hertogenbosch The Netherlands T +31 (0)88-235 66 66 F +31 (0)88-235 66 77 E info@eddon.nl W www.eddon.nl Installation & Configuration Custom Selector SE Block: Custom Selector SE Artikel software: BSE017 Datum: 16-10-2013 Behorende bij release vanaf: 3

Inhoudsopgave Inhoudsopgave... 2 1 Inleiding... 3 2 Uitgangspunten en randvoorwaarden... 4 2.1 Systeemeisen server... 4 2.2 Systeemeisen client... 4 2.3 Benodigde rechten... 4 2.4 Afhankelijkheden andere applicaties... 4 2.5 Technische uitgangspunten... 4 2.6 Benodigde licenties... 4 2.7 Functionele uitgangspunten... 4 3 Installatie Custom Selector SE... 5 3.1 Add-on Maatwerkmenu SE... 5 3.2 Installatie software... 5 3.3 Bijwerken database... 6 4 Configuratie Custom Selector SE... 7 4.1 Beveiliging in Synergy... 7 4.1.1 Benodigde rol Enabling add-on solutions... 7 4.1.2 Benodigde functierechten... 7 4.2 Onderhoud Add-on Maatwerkmenu... 7 4.3 Onderhoud Instellingen... 8 4.3.1 Installatie licentiesleutel... 8 4.4 Zoekvensters definiëren... 9 4.4.1 Kolommen definiëren... 12 4.4.2 Browser testen... 15 4.5 Redirects definiëren... 16 4.5.1 Knoppen toevoegen... 18 4.5.2 Redirect parameters toevoegen... 21 4.6 Deploy... 24 4.7 Browsers en redirects exporteren en importeren... 25 4.7.1 Exporteren... 25 4.7.2 Importeren... 26 5 Bekende meldingen... 28 5.1 DLL-bestanden geblokkeerd... 28 5.2 Contactpersonen browser in verzoek toont geen gegevens... 28 6 Termen onderhouden... 29 6.1 Nieuwe term toevoegen... 30 6.2 Talen toevoegen... 30 7 Technische eigenschappen... 31 7.1 Databasetabellen... 31 Copyright Eddon 2013 Pagina 2 van 31

1 Inleiding De Custom Selector SE biedt de gebruiker de mogelijkheid om zelf de standaard zoek- en selectievensters van Synergy Enterprise aan te passen. Deze aanpassing bestaat niet alleen uit de getoonde informatie, maar ook de invoervelden, achterliggende selectie op de database, knoppen en zoekvelden zijn volledig naar eigen wens in te richten. De Custom Selector wordt ingezet wanneer de standaard functionaliteit van Synergy niet voldoende is. Zo is het mogelijk om eigen knoppen toe te voegen met daarbij zelfgedefinieerde zoekcriteria. Of u stelt in welk veld bij het openen van een zoekvenster als eerste standaard geselecteerd wordt. De zoekvensters zijn via een onderhoudspagina te bewerken. Als er een nieuw criterium toegevoegd moet worden aan een zoekvenster, kan dit dus zonder aanpassing in de software. De naamgeving, queries, welke knoppen en zoekvelden er aanwezig moeten zijn en hoe het resultaat getoond moet worden is volledig instelbaar. Copyright Eddon 2013 Pagina 3 van 31

2 Uitgangspunten en randvoorwaarden 2.1 Systeemeisen server Voor de server(s) zijn de standaard systeemeisen voor Synergy Enterprise van toepassing. Deze zijn te vinden op de Exact portal. 2.2 Systeemeisen client Voor de clients zijn de standaard systeemeisen voor Synergy Enterprise clients van toepassing. Deze zijn te vinden op de Exact portal. 2.3 Benodigde rechten Voor de installatie zijn de volgende rechten van belang: System administrator (om de database te kunnen updaten en initialiseren) Synergy administrator (om rechten/rollen aan te maken) 2.4 Afhankelijkheden andere applicaties Om een of meerdere bouwstenen te kunnen gebruiken moet men ook de bouwsteen Add-on Maatwerkmenu SE hebben geïnstalleerd. 2.5 Technische uitgangspunten Er is bij de ontwikkeling gebruik gemaakt van de Software Development Kit (SDK) voor Synergy Enterprise. Deze werkwijze zorgt ervoor dat de bouwsteen zoveel mogelijk onafhankelijk van de standaard software kan functioneren. Hierdoor wordt het eenvoudiger om een update van de standaard software uit te voeren. Ondanks dat dient u toch contact met uw partner op te nemen wanneer u een update wilt uitvoeren naar een nieuwere versie van Synergy Enterprise. 2.6 Benodigde licenties De module YA5301 - Enabling add-on solutions role is vereist in de Synergy Enterprise licentie. Voor de Custom Selector SE is een licentiesleutel van Eddon Software vereist. 2.7 Functionele uitgangspunten Er wordt gebruik gemaakt van de standaard oplossing van Exact Synergy Enterprise vanaf batch 245. Eventueel kan dit uitgebreid worden met andere bouwstenen. Copyright Eddon 2013 Pagina 4 van 31

3 Installatie Custom Selector SE 3.1 Add-on Maatwerkmenu SE Voor een correcte werking van de bouwstenen dient het Add-on Maatwerkmenu SE geïnstalleerd te worden. Het Add-on Maatwerkmenu is een aparte installatieset en voegt het Add-on menu toe aan Synergy. Hiervandaan kunnen meerdere maatwerkonderdelen worden aangeroepen. 3.2 Installatie software Het maatwerk dient op de server geïnstalleerd te worden waar ook Synergy Enterprise staat. Door middel van het bestand CSSetup_NL.exe kan de set-up van de bouwsteen opgestart worden. LET OP: Voor het installeren dienen alle gebruikers Synergy te verlaten. Bij Installatie soort wordt gekozen voor CD installatie Bij Lokale installatiedirectory moet worden gekozen voor de directory waar Synergy Enterprise in geïnstalleerd staat. Door te kiezen voor OK wordt de installatie gestart. Het volgende scherm verschijnt. Copyright Eddon 2013 Pagina 5 van 31

Door te kiezen voor Yes wordt de installatie verder uitgevoerd. Wanneer de installatie voltooid is, wordt het onderstaande scherm getoond. 3.3 Bijwerken database Na het installeren van de bouwsteen moet de database opnieuw geïnitialiseerd worden. Hierom zal automatisch worden gevraagd bij het opstarten van Synergy. Door te kiezen voor Bijwerken wordt het initialiseren van de database uitgevoerd. * De instellingen bij het onderdeel Login zijn afhankelijk van de beveiligingsinstellingen van de Synergy database. ** Iedere database dient apart bijgewerkt te worden. Copyright Eddon 2013 Pagina 6 van 31

4 Configuratie Custom Selector SE 4.1 Beveiliging in Synergy 4.1.1 Benodigde rol Enabling add-on solutions Alle medewerkers die gebruik moeten kunnen maken van de Custom Selector, dienen gekoppeld te zijn aan de licentierol Enabling add-on solutions op niveau Bedrijf. Koppel hiervoor allereerst een willekeurige licentierol aan de medewerkers, waarmee bepaald wordt op welke Synergy-portal (ESS, CRM, etc.) ze kunnen inloggen. Hierna kunt u de rol Enabling add-on solutions koppelen aan de gebruikers op niveau Bedrijf. U kunt de Custom Selector NIET gebruiken op de dealer- en/of klantenportal, omdat dealers en klanten niet de juiste rechten toegewezen kunnen krijgen. Voor meer informatie over de rollenstructuur binnen Synergy Enterprise verwijzen wij u naar documenten 20.997.555 en 20.708.246 op de Exact Customer Portal. 4.1.2 Benodigde functierechten Bij de installatie van de Custom Selector is automatisch een nieuw functierecht aangemaakt. Deze is te vinden via het menupad Systeem Inrichting Beveiliging: Functierechten. Bovenstaand functierecht moet gekoppeld worden aan een rol. Automatisch zorgt Synergy ervoor dat standaard de rol Administrator de Custom Selector mag onderhouden en gebruiken. Door functierecht 1710000 te koppelen aan bepaalde rollen en die rollen vervolgens te koppelen aan medewerkers, kunt u zelf bepalen wie er verantwoordelijk is voor de inrichting van de bouwsteen. Na opnieuw inloggen kan de medewerker de bouwsteen verder onderhouden. 4.2 Onderhoud Add-on Maatwerkmenu Klik in het topmenu op Add-on. De eerste keer dat een administrator dit doet, zal er gevraagd worden om de inloggegevens. Vul uw gegevens in en klik op Bewaren. Dit is een eenmalige handeling en het wordt aangeraden dit onder het administrator account uit te voeren. Hiermee wordt het maatwerkmenu aangepast wanneer er een wijziging (update of toevoeging) heeft plaatsgevonden in het maatwerk. Na het bijwerken, zal Addon Inrichting er als volgt uitzien: Copyright Eddon 2013 Pagina 7 van 31

U heeft hier de mogelijkheid om nieuwe zoekvensters aan te maken en bestaande standaard browsers van Synergy te vervangen door uw eigen aangemaakte zoekvensters. Ook kunt u de browsers en/of redirects exporteren of importeren. 4.3 Onderhoud Instellingen Nadat de bouwsteen voor Synergy is geïnstalleerd moeten er een aantal instellingen ingevuld worden. De instellingen zijn te onderhouden via het menupad Add-on Inrichting Custom Selector: Instellingen. 4.3.1 Installatie licentiesleutel Voor een correcte werking van deze bouwsteen is het noodzakelijk een licentiesleutel in te voeren. De licentiesleutel wordt via een tekstbestand verstrekt door uw leverancier. LET OP: De sleutel dient te worden aangeleverd in een tekstbestand. Direct kopiëren en plakken in een e-mail leidt tot een verminkte sleutel. Het tekstbestand heeft de volgende naamgeving: License_1710_Custom Selector SE_[Naam klant in Exact]_[Einddatum]_[Aantal gebruikers].txt Als u dit bestand opent met Kladblok, ziet u bijvoorbeeld onderstaande (fictieve) licentiesleutel: De licentiesleutel is te onderhouden via het menupad Add-on Inrichting Custom Selector: Instellingen. U kopieert de licentiesleutel vanuit het tekstbestand en in de instelling Algemeen: Licentiesleutel. Copyright Eddon 2013 Pagina 8 van 31

Zonder deze licentiesleutel zal de Custom Selector SE niet functioneren. Zodra de samenvoegactie wordt uitgevoerd, zal een foutmelding worden getoond. U kunt de bouwsteen alleen gebruiken in uw eigen Synergy Enterprise omgeving: de licentiesleutel wordt namelijk uitgegeven op naam zoals die in uw Exact Synergy Enterprise licentie is vastgelegd. In de volgende gevallen wordt een foutmelding getoond: 1. Verlopen van de einddatum. Dit geldt voornamelijk voor proeflicenties. 2. Foutieve / verminkte licentiesleutel. Indien de licentiesleutel ontbreekt of niet overeenstemt met de gegevens uit uw Exact licentie, wordt hier melding van gemaakt. 4.4 Zoekvensters definiëren De definities van de zoekvensters zijn te bewerken via Add-on Inrichting Custom Selector: Browsers. Op deze pagina staat een overzicht van gedefinieerde zoekvensters. Door te kiezen voor Nieuw kunt u een nieuwe browserdefinitie aanmaken. Handiger is echter te kiezen voor Kopie: Nieuw, waarmee u de definitie van een standaard browser kopieert, welke u vervolgens naar uw eigen wensen kunt aanpassen. In de pop-up die verschijnt, kunt u de standaard browser van Synergy opzoeken. Wat de naam van de standaard browser is, kunt u achterhalen via de bron van de betreffende pagina waar het zoekvenster vervangen moet worden. U wilt bijvoorbeeld het zoekvenster van een verzoek aanpassen. Maak een nieuw verzoek aan en klik met de rechter muisknop op de pagina. Kies voor Bron weergeven. Copyright Eddon 2013 Pagina 9 van 31

In dit voorbeeld willen we de browser van het veld Mederwerker vervangen. Zoek dit veld in de bron op. Hier vindt u de code SysBrowseData Name=RequestEmployees. De naam van de browser staat achter Name ; in dit voorbeeld is de naam de standaard browser van Synergy dus RequestEmployees. Zodra u deze browser in de pop-up heeft opgezocht en geselecteerd, worden de gegevens van deze browser al voorgevuld in de nieuwe browserdefinitie. U kunt nu de definitie aanpassen naar uw eigen wensen. LET OP: Bij het aanpassen van de browserdefinitie is enige kennis van SQL een vereiste. Name Group Caption Hier vult u de naam in van de browser. Wanneer u heeft gekozen voor Kopie: Nieuw wordt deze waarde automatisch gevuld. Wij raden u in dit geval aan de waarde niet aan te passen. U kunt aangeven bij welke groep deze browser dient te behoren. Dit wordt alleen gebruikt voor sorteerdoeleinden onder Systeem Inrichting Repository: Explorer. Deze waarde wordt voorgevuld en wij raden aan dit niet te wijzigen, zodat u altijd een aparte groep heeft voor uw maatwerkbrowsers. Geef de browser een naam. Let er hierbij dat u veld Term ID correct vult of zelfs leeg laat. Log opnieuw in om een wijziging te activeren. Copyright Eddon 2013 Pagina 10 van 31

Term ID Caption suffix U kunt uw browser taalonafhankelijk maken door middel van terms. Een term ID is een getal dat aan een bepaalde term is gekoppeld. Deze term is in meerdere talen aanwezig. Zie voor meer informatie over termen hoofdstuk 6. Aan de titel kunt u een toevoeging meegeven. De suffix wordt tussen haakjes toegevoegd aan de naam van de browser. Bijvoorbeeld: Query Column info Result columns De waarde (van mij) is de suffix. Log opnieuw in om een wijziging te activeren. Hier vult u de SQL-query is die uitgevoerd moet worden als de browser wordt aangeroepen. Wanneer u voor Kopie: Nieuw heeft gekozen, wordt de query voorgevuld. Dit veld vult u met alle kolomnamen uit de hiervoor ingevulde query in, gescheiden door een puntkomma. Wanneer u de kolomdefinities heeft aangepast (meer hierover in paragraaf 4.4.1), worden de waardes in dit veld automatisch aangevuld met extra parameters. Nadat u in het zoekvenster een regel heeft geselecteerd, wordt de waarde uit de hier ingevulde kolom teruggegeven aan de pagina. Bijvoorbeeld: Wanneer u de medewerker uit de browser selecteert, wordt het veld gevuld met de res_id en daarachter de naam en functienaam: Het veld Medewerker wordt dan als volgt gevuld: Query parameters Table list Security level Placeholders Maintenance Application Enterprise search entity Security provider Security provider parameters LET OP: Wanneer er in de programmacode al result columns zijn gedefinieerd, dan kunt u geen gebruik maken van eigen Result columns. Of dit zo is, kunt u achterhalen in de broncode van de pagina of door te proberen. Zijn er al result columns gedefinieerd, dan verschijnt een foutmelding bij het opvragen van de browser. Hier kunt u een afhankelijkheid opgeven voor het aanroepen van de browser. Bijvoorbeeld op basis van @securitylevel, @humresid, @customerid. NVT Hiermee bepaalt u welke medewerkers met welk beveiligingsniveau de browser mogen zien. NVT NVT NVT NVT NVT Copyright Eddon 2013 Pagina 11 van 31

4.4.1 Kolommen definiëren In de nieuwe browser klik op Bewaren + Edit column info om de kolomdefinitie aan te passen. Bij Repository browser is de betreffende nieuwe browser al voorgevuld. Wij raden u aan dit NIET aan te passen. Bij Browser query en Column info zijn de gegevens automatisch overgenomen uit de nieuwe browser. Deze gegevens kunt u niet aanpassen en zijn alleen ter info. In het linker deel (1) staan de kolommen vermeld die u heeft gedefinieerd in de query. Deze kolommen zullen in de nieuwe browser verschijnen als zoekcriteria, maar ook als kolommen in het resultaat. U kunt de volgorde hiervoor bepalen door middel van de knoppen Omhoog en Omlaag (2). Zodra u een kolom in het linker deel heeft geselecteerd, kunt u in het rechter deel (3) de parameters aanpassen. Copyright Eddon 2013 Pagina 12 van 31

Column name Header / TermID Header Suffix / TermID In het uitklapmenu kunt u de betreffende kolom opzoeken, waarvan u de definitie wilt aanpassen. De waardes komen overeen met de kolommen vermeld in het linker deel. U geeft de kolom een naam. U kunt uw browser taalonafhankelijk maken door middel van terms. Een term ID is een getal dat aan een bepaalde term is gekoppeld. Deze term is in meerdere talen aanwezig. Zie voor meer informatie over termen hoofdstuk 6. Geef een toevoeging voor de kolomnaam mee, die tussen haakjes achter de kolomnaam zal verschijnen. Bijvoorbeeld: De waarde (ST) is de suffix. Visible Sorting U kunt uw browser taalonafhankelijk maken door middel van terms. Een term ID is een getal dat aan een bepaalde term is gekoppeld. Deze term is in meerdere talen aanwezig. Zie voor meer informatie over termen hoofdstuk 6. Wilt u dat deze kolom zichtbaar is in de browser of niet? Geef op welke sorteermogelijkheid u voor deze kolom in de browser wenst. Bijvoorbeeld: Quick search column U heeft de mogelijkheid om de kolom zowel van A-Z als van Z-A (instelling Both ) te sorteren door middel van de driehoekicoontjes. NVT Copyright Eddon 2013 Pagina 13 van 31

Checkmark Op de waarde vervangen moet worden door een groen vinkje. Bijvoorbeeld: humres.blocked geeft 1 of 0 terug. In de browser moet een groen vinkje verschijnen voor waarde 1. Domain Hier geeft u een domein op, waarbij gedefinieerd is of er bijvoorbeeld een string of number waarde ingevuld mag worden en hoeveel karakters er ingevuld mogen worden in het zoekveld. Bijvoorbeeld: U wilt bij zoekveld MedewerkerID alleen numerieke waardes invullen en dit mogen niet meer dan 10 karakters zijn. U kiest domein HumresID : Scale Currency column Selection values In uw query dient u een valuta op te vragen om hier goed gebruik van te kunnen maken. Kies de valutakolom. De waardes in de kolom worden omgezet naar bedragen. Middels Scale geeft u het aantal decimalen op waaruit het bedrag moet bestaan. Bijvoorbeeld: 123 wordt omgezet naar 123,00 Hiermee kunt u een uitklapmenu maken van het zoekveld. Bijvoorbeeld: U wilt op medewerkertype kunnen zoeken. Laat u dit veld leeg, dan moet u zelf het type invullen bij de zoekcriteria in de browser. Vult u een select-query in, dan wordt het veld een uitklapmenu en staan de beschikbare medewerkertypes al voorgevuld. U hoeft dan alleen het juiste type te selecteren. De instelling is dan gevuld met de volgende query: "SELECT DatabaseChar,Description,TermID FROM DDTests WHERE TableName='humres' AND FieldName='emp_type'" Selection column In Selection values maakt u een subselectie die uitgevoerd wordt op de Browser query. Met dit veld geeft u aan op basis van welk veld uit de Browser query de subselectie uitgevoerd moet worden. In bovenstaand voorbeeld kiest u types.databasechar in het uitklapmenu. Copyright Eddon 2013 Pagina 14 van 31

TermID column Suffix - / TermID column Right aligned Human ID Date/time format Search options U kunt uw browser taalonafhankelijk maken door middel van terms. Een term ID is een getal dat aan een bepaalde term is gekoppeld. Deze term is in meerdere talen aanwezig. Zie voor meer informatie over termen hoofdstuk 6. U kunt uw browser taalonafhankelijk maken door middel van terms. Een term ID is een getal dat aan een bepaalde term is gekoppeld. Deze term is in meerdere talen aanwezig. Zie voor meer informatie over termen hoofdstuk 6. Geef op of u de waardes in de kolom rechts wilt uitlijnen. Bijvoorbeeld: 123 wordt omgezet naar 00.000.123 Ute van Riel wordt omgezet naar Ute. va.n R.iel In welk format u een datum en tijd wilt weergeven. Op welke manier er gezocht kan worden op dit veld. U heeft de volgende mogelijkheden: 4.4.2 Browser testen In uw nieuwe browser heeft u de mogelijkheid om op Bewaren + Test te klikken om het zoekvenster te testen. De velden onder de bovenste sectie Criteria hoeft u niets mee te doen, de Repository browser is automatisch voorgevuld met uw nieuwe browser. Bij de onderste sectie klikt u op het loep-icoon om de nieuwe browser aan te roepen. Copyright Eddon 2013 Pagina 15 van 31

U kunt op deze manier controleren of de gegevens op de juiste manier worden weergegeven, of dat u op een correcte manier kunt zoeken en of alle knoppen naar behoren functioneren. 4.5 Redirects definiëren Om specifiek aan te geven op welke pagina s de op maat gemaakte zoekvensters geopend moeten worden, dient u de redirects in te stellen via Add-on Inrichting Customer Selector: Redirects. Klik op Nieuw om een nieuwe redirect aan te maken: Copyright Eddon 2013 Pagina 16 van 31

Geef een logische Naam in voor de redirect. Bij Te vervangen browser kiest u door middel van het loep-icoon het standaard zoekvenster van Synergy. Wilt u bijvoorbeeld het zoekvenster voor het veld Relatie in een verzoek vervangen, dan zoekt u RequestCustomers op. Bij het veld Nieuwe browser kiest u het zojuist nieuw aangemaakte zoekvenster. U vinkt de optie Verberg standaard knoppen aan wanneer u de standaard knoppen Herstellen, Nieuw, Wissen en Sluiten, die Synergy normaal in browsers zet, niet meer wilt gebruiken. In referentievelden, zoals een relatieveld in een verzoek, kunt u standaard zoeken via het loep-icoon, maar ook door een (deel van) zoekterm in te vullen in een invulveld. Met de optie Verberg invulveld bepaalt u of dit invulveld beschikbaar is of niet. Wanneer de optie is aangevinkt, zal alleen het loep-icoon gebruikt kunnen worden. Om een redirect te kunnen gebruiken, dient u deze te activeren door de optie Actief aan te vinken. Tot slot dient u een Redirect op aan te geven in combinatie met de betreffende Pagina. Wilt u zoals in ons voorbeeld het zoekvenster voor het relatieveld in een verzoek vervangen, dan kiest u bij Redirect op in het uitklapmenu voor Verzoeken. Bij Pagina komen in het uitklapmenu vervolgens alle pagina s beschikbaar die betrekking hebben op verzoeken. De meest gebruikte pagina zal voorgevuld zijn. Welke pagina u precies nodig heeft om de browser in te vervangen, kunt u achterhalen door een verzoek aan te maken en in de pagina met de rechter muisknop te klikken. Kies voor Eigenschappen. Copyright Eddon 2013 Pagina 17 van 31

Bij Adres: (URL) staat de betreffende ASPX-pagina vermeld. In ons voorbeeld kiest u bij Pagina voor WflRequest.aspx. U heeft bij Redirect op de keuze uit Verzoeken, Relaties, Medewerkers, Documenten en Projecten. Bij Pagina worden in het uitklapmenu de mogelijke pagina s voor het gekozen onderdeel getoond. Kiest u bij Redirect op voor Anders, dan komen alle mogelijke pagina s uit Synergy beschikbaar bij Pagina. Klik op Bewaren en open de redirect opnieuw om de overige instellingen te doen: Zoals u in deze schermafdruk kunt zien, is er een nieuwe knop Zoeken automatisch toegevoegd. 4.5.1 Knoppen toevoegen U kunt nu zelf nieuwe knoppen Toevoegen of de automatisch aangemaakte knop aanpassen door op de omschrijving te klikken. Op deze manier kunt u bijvoorbeeld een knop maken die als resultaat alle relaties oplevert en een knop die als resultaat alleen de relaties weergeeft die aan een bepaalde manager zijn gekoppeld. Copyright Eddon 2013 Pagina 18 van 31

Geef een Knop omschrijving. Wanneer dat wenselijk is, kunt u een TermId invullen. U dient verplicht een door u gedefinieerde Browser te kiezen. Geef desgewenst een Positie, waarmee u de volgorde voor de knoppen in het zoekvenster bepaalt. Klik op Bewaren en open de knop opnieuw om de overige instellingen te doen: De betreffende Browser query wordt nu automatisch getoond. U krijgt de mogelijkheid om een Aanvullende where clausule toe te voegen. U kunt hierbij gebruik maken van harde waardes, maar u kunt ook eigen parameters definiëren. Bijvoorbeeld: U wilt dat alleen de relaties van de gekoppelde medewerker in het verzoek worden weergegeven als u op de knop klikt. Hiervoor gaat u als volgt te werk: Klik op de knop Toevoegen bij Beschikbare where clausule parameters : Bij Query parameter ID geeft u een willekeurige naam op. LET OP: De naam van de parameter moet uniek zijn. U kunt hierbij bijvoorbeeld gebruik maken van een @ voor de naam zoals in het voorbeeld in de schermafdruk. Copyright Eddon 2013 Pagina 19 van 31

Bij Bron veldnaam vult u de naam in van het veld waaruit de waarde gehaald moet worden. Deze naam kunt u halen uit de bron van de pagina. Open de betreffende pagina waarin de browser vervangen moet worden in Internet Explorer, in dit voorbeeld maakt u een nieuw verzoek aan. Klik met de rechter muisknop op de pagina en kies voor Bron weergeven. In de code die weergegeven wordt, zoekt u het veld op waar de waarde uit gehaald moet worden. In dit voorbeeld is dat het veld Medewerker. Hierbij vindt u voor dit voorbeeld de <input id= EmployeeID >. Bij Source name gebruikt u voor dit voorbeeld dan de waarde EmployeeID. LET OP: De waarde die u bij Bron veldnaam invult is hoofdlettergevoelig. Een andere optie is bij Bron veldnaam een parameter in de te vullen uit de URL van de pagina. Deze URL is te vinden door met de rechter muisknop te klikken op de pagina en te kiezen voor Eigenschappen. Bijvoorbeeld de URL voor een nieuw verzoekpagina: http://vm-nbl/synergy/docs/wflrequest.aspx?bcaction=0&type=1 De parameters staan vermeld achter het?-teken en zijn gescheiden door een &- teken. In dit geval kunt u dus de parameters BCAction en Type gebruiken. Wilt u dat het zoekvenster afhankelijk is van het type verzoek, dan maakt u een parameter aan met als Bron veldnaam de waarde Type. In ons voorbeeld moet de waarde uit de pagina zelf gehaald worden, dus u dient de instelling Waarde ophalen uit pagina-element aan te vinken. Wanneer u de waarde uit de URL van de pagina haalt, vinkt u de instelling uit. Zodra u de parameter heeft opgeslagen, kunt u deze gebruiken in de Aanvullende where clausule. Voor ons voorbeeld typt u dan het volgende in: c.cmp_acc_man = @AccountManager De parameter @AccountManager zal bij het opvragen van het zoekvenster vervangen worden door de betreffende waarde, dus het nummer van de medewerker die gekoppeld wordt aan het verzoek. Copyright Eddon 2013 Pagina 20 van 31

LET OP: Wanneer de teruggegeven waarde uit de parameter een lettercombinatie is, dient u in de Aanvullende where clausule gebruik te maken van enkele aanhalingstekens om de waarde correct mee te kunnen geven aan de query. Bijvoorbeeld: U koppelt in een verzoek een project. Vervolgens wilt u een ander verzoek koppelen, maar daarbij alleen de keuze hebben uit alle aan het gekoppelde project gekoppelde verzoeken. U definieert een parameter @ProjectNumber en de Aanvullende where clausule wordt: absences.projectnr = @ProjectNumber Zoals eerder beschreven moet de naam van de parameter uniek zijn. Wanneer de naam gelijk is aan een lettercombinatie in de Aanvullende where clausule wordt die lettercombinatie vervangen door de waarde uit de parameter. Heeft u de parameter de naam acc_man gegeven, en de waarde hiervan wordt 1, dan wordt de where-clausule c.cmp_acc_man = acc_man vervangen door c.cmp_1 = 1. Dit geeft een foutmelding bij het opvragen van de browser. 4.5.2 Redirect parameters toevoegen Nadat u knoppen heeft toegevoegd, kunt u redirect parameters toevoegen door middel van de knop Toevoegen. Bij Naam vult u de naam voor de parameter in en bij Waarde de waarde. U kunt standaard parameters type en status gebruiken. Met type geeft u op dat de browser alleen in bijvoorbeeld een bepaald verzoektype of bepaalde documenttypes vervangen moet worden. Door status te gebruiken, bepaalt u dat de browser alleen in bepaalde statussen van het verzoek of document vervangen wordt. LET OP: Geeft u geen type of status op, dan zal de browser voor alle verzoektypes in alle statussen vervangen worden. Wilt u zoals in ons voorbeeld het zoekvenster voor het relatieveld in een verzoek uit alleen voor verzoektypes Appointment, Checked task en Day Planning vervangen, dan vult u bij Naam type in. De Waarde zal een loep-icoon worden. Klikt u hierop, dan verschijnt een nieuw scherm. U heeft bij Omschrijving, Categorie of ID de mogelijkheid om een verzoektype op te zoeken. Vul de betreffende zoekcriteria in en klik op Actualiseren. Copyright Eddon 2013 Pagina 21 van 31

Onder Selectie (1) vinkt u de gewenste verzoektypes aan, waarna u op het pijltje naar rechts (2) kunt klikken om de verzoektypes naar Sub: Selectie te verplaatsen. Dit zijn de verzoektypes die toegevoegd gaan worden. U kunt ze ook weer verwijderen, door ze bij Sub: Selectie aan te vinken en op het pijltje naar links (2) te klikken. Klik tot slot op OK (3) om de verzoektypes toe te voegen. Ook wanneer u bij Naam status invult, wordt Waarde een loep-icoon. In het scherm dat dan verschijnt, kunt u de betreffende statussen van in ons voorbeeld een verzoek kiezen. Copyright Eddon 2013 Pagina 22 van 31

Een andere parameter die u standaard kunt gebruiken is source. Hiermee specificeert u voor welk veld u het zoekvenster wilt vervangen. Heeft u in een verzoek bijvoorbeeld naast een relatieveld een vrij guidveld toegevoegd met een referentie naar relaties, dan wordt voor beide velden standaard dezelfde browser gebruikt door Synergy. U wilt echter dat alleen de browser voor het relatieveld wordt vervangen door uw eigen gedefinieerde browser. Maak dan een parameter source aan. De waarde hiervoor haalt u uit de broncode van de pagina. Open de betreffende pagina waarin de browser vervangen moet worden in Internet Explorer, in dit voorbeeld maakt u een nieuw verzoek aan. Klik met de rechter muisknop op de pagina en kies voor Bron weergeven. In de code die weergegeven wordt, zoekt u het veld op waar de waarde uit gehaald moet worden. In dit voorbeeld is dat het veld Relatie. Hierbij vindt u voor dit voorbeeld {this.click()}" id="pcustomerid" Bij Waarde gebruikt u voor dit voorbeeld dan de waarde die begint met p, in dit geval dus pcustomerid : LET OP: De waarde die u invult bij Waarde voor de parameter source is hoofdlettergevoelig. Maakt u gebruik van de bouwsteen Solution Builder SE, dan kunt u naast type (voor het vervangen van browsers in alle entiteiten binnen bepaalde entiteittypes), status (vervangen van browsers in entiteiten binnen bepaalde statussen) ook nog de standaard parameter group gebruiken. Met group vervangt u browsers in alle entiteiten binnen bepaalde entiteitgroepen. Copyright Eddon 2013 Pagina 23 van 31

Overige parameters die u kunt gebruiken, haalt u uit de URL van de betreffende pagina. De URL is, zoals eerder beschreven, te vinden door met de rechter muisknop te klikken op de pagina en te kiezen voor Eigenschappen. Bijvoorbeeld de URL voor een nieuwe verzoekpagina: http://vm-nbl/synergy/docs/wflrequest.aspx?bcaction=0&type=1 De parameters staan vermeld achter het?-teken en zijn gescheiden door een &- teken. De meeste parameters uit dergelijke URL s zijn al afgevangen met de hiervoor beschreven standaard parameters. Zo is BCAction de status en Type is redirect parameter type. Eventuele overige redirect parameters maakt u zelf aan door de URL-parameter bij Naam in te vullen met de bijbehorende Waarde die achter het =-teken in de URL staat. LET OP: Parameters mag u per redirect slechts 1 keer gebruiken. 4.6 Deploy Nadat u een redirect heeft aangemaakt, gewijzigd of verwijderd, dient u een deployment uit te voeren. Hiermee worden de wijzigingen definitief doorgevoerd. Een deployment voert u uit via Add-on Inrichting Custom Selector: Deploy. Na klikken op Deploy verschijnt onderaan de pagina een statusbalk. Is de deployment correct verlopen, zal het bericht Gereed verschijnen. LET OP: Zorg ervoor dat tijdens de deployment alle gebruikers zijn uitgelogd uit Synergy! Copyright Eddon 2013 Pagina 24 van 31

4.7 Browsers en redirects exporteren en importeren U heeft de mogelijkheid om gedefinieerde browsers en redirects te exporteren vanuit bijvoorbeeld uw testomgeving en deze te importeren in uw productieomgeving. 4.7.1 Exporteren Om browsers en redirects te exporteren gaat u naar Add-on Inrichting Custom Selector: Exporteren. Ook kunt u vanuit het onderhoudscherm van browsers en redirects door middel van de knop Exporteren naar de exportfunctionaliteit gaan. Vink de browsers en/of redirects aan die u wilt exporteren. Exporteert u een redirect, dan worden automatisch de gekoppelde browsers mee geëxporteerd. Deze hoeft u dus niet afzonderlijk aan te vinken. Klik vervolgens op Exporteren. In de pop-up die verschijnt, kunt u het betreffende XML-bestand eventueel Openen om deze desgewenst nog te bewerken. Dit is echter af te raden, dus u kiest voor Opslaan. Kies vervolgens de locatie waar u het XML-exportbestand wilt opslaan en klik nogmaals op Opslaan. Copyright Eddon 2013 Pagina 25 van 31

Het XML-bestand kunt u desgewenst openen in Kladblok: Zoals gezegd kunt u eventueel wijzigingen aanbrengen, maar dit is af te raden. 4.7.2 Importeren Het XML-bestand dat u geëxporteerd heeft, kunt u in een andere omgeving importeren. Ga hiervoor naar Add-on Inrichting Custom Selector: Importeren. Ook vanuit het onderhoudscherm van browsers en redirects kunt u naar de import-functionaliteit gaan door middel van de knop Importeren. Copyright Eddon 2013 Pagina 26 van 31

Vanuit het import-scherm kunt u naar het onderhoud van browsers en redirects gaan middels de knoppen Browsers respectievelijk Redirects. Klik bij Bestand op Bladeren om een geëxporteerd XML-bestand te selecteren. U kunt ervoor kiezen om eventueel al bestaande browsers en/of redirects te overschrijven door de optie Bestaande overschrijven aan te vinken. Vinkt u deze niet aan, dan zullen nieuwe browsers en redirects aangemaakt worden. Klik vervolgens op de knop Importeren. Onderaan het scherm verschijnen meldingen van de acties die zijn uitgevoerd. Zo krijgt u te zien of de import is geslaagd. Zijn er al browsers en/of redirects met dezelfde naam aanwezig, dan zal hier ook melding van gemaakt worden. Copyright Eddon 2013 Pagina 27 van 31

5 Bekende meldingen 5.1 DLL-bestanden geblokkeerd Bij het gebruik van de Custom Selector op een Windows 2008 R2 Server kan de volgende foutmelding verschijnen: Request for the permission of type 'System.Web.AspNetHostingPermission, System, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089' failed., Application = WflSearch.aspx, Source = CSNOBWord.Extension, Function = Void AfterInit(), Stack = CSNOBWord.Extension.WflSearchWordMerge.AfterInit() Deze melding heeft ermee te maken dat Windows de DLL-bestanden van de Custom Selector heeft geblokkeerd. De DLL-bestanden van de Custom Selector vindt u in de Bin-map van de Synergy installatiemap: CSNobCSE.Extension.dll CSNobCSE.Repository.dll Wanneer u in de eigenschappen van de DLL-bestanden (klik met de rechter muisknop op de bestanden en kies Eigenschappen ) de volgende melding ziet, dient u op Unblock te klikken om de DLL-bestanden te deblokkeren: 5.2 Contactpersonen browser in verzoek toont geen gegevens Wanneer u het veld Contactpersoon in een verzoek afhankelijk heeft gemaakt van het veld Relatie en u klikt op het loep-icoon, dan krijgt u foutmeldingen of helemaal geen gegevens te zien in de betreffende browser. Met de Custom Selector is het helaas niet mogelijk om met de standaard afhankelijkheid van Exact Synergy Enterprise te werken. U dient zelf de contactpersoonbrowser te vervangen met de Custom Selector. Zet allereerst in de verzoekdefinitie bij veld Contactpersoon het vinkje Afhankelijk van: Relatie uit: Vervang daarna de betreffende contactpersoon browser zoals in deze handleiding beschreven. In de vervangende browser kunt u vervolgens de afhankelijkheid van het gewenste relatieveld instellen. Copyright Eddon 2013 Pagina 28 van 31

6 Termen onderhouden Voor bouwstenen kunt u maatwerktermen opgeven voor onder andere label- en omschrijvingvelden. Tevens is er een veld Term ID aanwezig in de verschillende onderhoudschermen van de bouwsteen. Hierin vult u een nummer in. Dit nummer bepaalt de term die gebruikt moet worden voor het label of de omschrijving, maar dit bepaalt ook de taal waarin het label of de omschrijving verschijnt, afhankelijk van de taalinstellingen binnen Synergy. U kunt gebruik maken van termnummers die standaard in Synergy aanwezig zijn, maar u kunt ook eigen termen definiëren. Ook voor de onderhoudschermen van de bouwsteen zelf zijn termen gedefinieerd, welke u desgewenst kunt aanpassen voor de verschillende talen waaronder u Synergy gebruikt. Termen onderhoudt u in Synergy via Add-on Inrichting Termen: Zoeken. LET OP: Om termen te komen onderhouden heeft u functierecht 439 nodig. Door dit functierecht te koppelen aan bepaalde rollen en die rollen vervolgens te koppelen aan medewerkers, kunt u zelf bepalen wie er verantwoordelijk is voor het onderhouden van de termen. Na opnieuw inloggen kan de medewerker de termen verder onderhouden. Het volgende scherm wordt geopend: Copyright Eddon 2013 Pagina 29 van 31

Kies bij Taal de taal waarin de term voorkomt, vink eventueel Alle aan of geef een waarde in bij Termen, ID en/of Aangepast. Klik op Tonen (of Actualiseren ) om het overzicht van alle beschikbare termen te tonen die aan uw zoekcriteria voldoen. Open een term om wijzigingen aan te brengen. TIP: Over het algemeen zijn de maatwerktermen te vinden door te zoeken via het veld Aangepast met de optie Alle aangevinkt. 6.1 Nieuwe term toevoegen Klik op de knop Nieuw. Het veld ID is standaard ingevuld met een nieuw nummer. U kunt nu een nieuwe term aanmaken. Vul de term bij de gewenste taal in. Wanneer u op Bewaren klikt, zal de term automatisch in de overige velden gevuld worden. U kunt desgewenst ook per taalveld de term invullen in de betreffende taal. Wanneer u het nummer in het ID -veld aanpast en er bestaat al een term met dat nummer, dan zal die term weergegeven worden in de beschikbare talen zodra u de cursor in een van de taalvelden plaatst. U kunt nu desgewenst de termen per taal aanpassen. 6.2 Talen toevoegen Bij termen wordt uitgegaan van actieve talen bij medewerkers en contactpersonen en talen die zijn toegevoegd aan de databasetabel CSNobMnuLanguages. Desgewenst kunt u talen toevoegen voor het gebruik van de maatwerktermen. Ga naar Add-on Inrichting Termen: Zoeken en kies een gewenste taal in het uitklapmenu bij Taal. Klik op Toevoegen. De nieuwe taal wordt aan alle aanwezige termen toegevoegd. U kunt nu bestaande termen zoeken en de nieuw toegevoegde taal vullen of nieuwe termen aanmaken in de nieuwe taal. Copyright Eddon 2013 Pagina 30 van 31

7 Technische eigenschappen 7.1 Databasetabellen Na installatie van de Custom Selector SE worden in de database automatisch tabellen toegevoegd. Tabel CSNobCSEBrowserButtons CSNobCSEBrowserReplacements CSNobCSEDocumentStatus CSNobCSEParameters CSNobCSERedirectOn CSNobCSERequestStatus Omschrijving Alle knoppen die zijn ingesteld in de redirects. Alle redirects die zijn ingesteld. Statussen van documenten die gebruikt kunnen worden bij redirect parameter status wanneer bij redirect instelling Redirect op Documenten is gekozen. Alle parameters in redirects en in buttons. Beschikbare opties in uitklapmenu bij redirect instelling Redirect op. Statussen van verzoeken die gebruikt kunnen worden bij redirect parameter status wanneer bij redirect instelling Redirect op Verzoeken is gekozen. Copyright Eddon 2013 Pagina 31 van 31