Marketing Add-on SE Installation & Configuration Guide
©2015, Eddon Software B.V., ‘s-Hertogenbosch. Niets van deze uitgave mag worden verveelvoudigd en/of openbaar gemaakt door middel van druk, fotokopie, microfilm of op welke andere wijze ook en evenmin worden opgeslagen in een databank met als doel een terugzoek mogelijkheid te verschaffen aan derden zonder voorafgaande toestemming van Eddon Software B.V. Eddon Software B.V. Ingeschreven bij Kamer van Koophandel onder nr. 32154395
Add-on Artikel software Behorende bij release vanaf Datum Auteur
Marketing Add-on SE BSE031 1.0.0 25-11-2014 Bregje Elemans
Eddon Software BV | Marketing Add-on SE | 24 november 2014 | pagina 2 van 25
Inhoudsopgave 1
Uitgangspunten en randvoorwaarden ................................................................................. 5 1.1 Systeemeisen server en client ............................................................................................ 5 1.2 Benodigde rechten.............................................................................................................. 5 1.3 Afhankelijkheden andere applicaties ................................................................................. 5 1.4 Technische uitgangspunten ................................................................................................ 5 1.5 Benodigde licenties ............................................................................................................. 5 1.6 Functionele uitgangspunten ............................................................................................... 5
2
Installatie Marketing Add-on SE .......................................................................................... 6 2.1 Add-on Maatwerkmenu SE ................................................................................................. 6 2.2 Installatie software ............................................................................................................. 6 2.3 Bijwerken database ............................................................................................................ 7
3
Configuratie Marketing Add-on SE ....................................................................................... 9 3.1 Beveiliging in Synergy ......................................................................................................... 9 3.1.1 Benodigde rol ‘Enabling add-on solutions’............................................................... 9 3.1.2 Benodigde functierechten ........................................................................................ 9 3.2 Onderhoud Add-on Maatwerkmenu ................................................................................ 10 3.3 Onderhoud instellingen .................................................................................................... 10 3.3.1 Installatie licentiesleutel......................................................................................... 10 3.3.2 Algemeen ................................................................................................................ 11 3.4 Onderhoud kenmerken .................................................................................................... 12 3.4.3 Categorieën toevoegen, wijzigen en verwijderen .................................................. 12 3.4.4 Kenmerken toevoegen, wijzigen en verwijderen ................................................... 13 3.5 Toekennen kenmerken aan relaties en contactpersonen ................................................ 15 3.6 Zoeken op kenmerken ...................................................................................................... 16 3.7 Bulkacties .......................................................................................................................... 17 3.7.5 Bulkacties beheren ................................................................................................. 18
4
Achtergrondproces ........................................................................................................... 19 4.1 Bulkacties .......................................................................................................................... 19 4.1.1 SQL Job ................................................................................................................... 19 4.1.1.1 Proxy instellen in SQL 2008............................................................................. 20 4.1.2 Geplande Taak ........................................................................................................ 22 4.2 Troubleshooting ................................................................................................................ 22
5
Termen onderhouden ....................................................................................................... 23 5.1 Nieuwe term toevoegen ................................................................................................... 24 5.2 Talen toevoegen ............................................................................................................... 24
6
Technische eigenschappen ................................................................................................ 25 6.1 Databasetabellen .............................................................................................................. 25
Eddon Software BV | Marketing Add-on SE | 24 november 2014 | pagina 3 van 25
Inleiding De Marketing Add-on SE is een add-on gemaakt voor Exact Synergy Enterprise. Synergy Enterprise kent een beperkte mogelijkheid om marketing gegevens vast te leggen op relatie- of contactpersoon niveau. Hiervoor worden nu meestal vrije velden gebruikt, echter die zijn voor het dynamisch vastleggen niet toereikend. Ook zijn hiermee moeilijk selecties te maken. Via de Marketing Add-on SE kunt u bedrijfsbreed marketing kenmerken definiëren en deze individueel toekennen aan relaties en/of contactpersonen. Ook kunt u via bulk selecties bewerkingen toepassen. Op de marketing kenmerken kunnen beveiligingsniveaus worden ingesteld, zodat u controle heeft over wie welke kenmerken kan toevoegen of verwijderen. Met de Marketing Add-on SE kunt u op een eenvoudige en flexibele manier uw klanten segmenteren en kunt u selecties maken van uw contactpersonen en relaties op basis van de marketing kenmerken. De selecties kunt u gebruiken voor het maken van een exportbestand, e-mailacties, MS Word Merge add-on bulk bewerkingen en voor externe applicaties als bijvoorbeeld Mailplus.
Eddon Software BV | Marketing Add-on SE | 24 november 2014 | pagina 4 van 25
1
Uitgangspunten en randvoorwaarden
1.1
Systeemeisen server en client
Voor de server(s) en clients zijn de standaard systeemeisen voor Exact Synergy Enterprise van toepassing. Deze zijn te vinden in document 21.372.564 op de Exact Customer Portal.
1.2
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)
1.3
Afhankelijkheden andere applicaties
Om een of meerdere add-ons te kunnen gebruiken moet men ook het Add-on Maatwerkmenu SE hebben geïnstalleerd. Indien u de add-on Contact Manager SE geïnstalleerd heeft staan, dient u deze bij te werken naar de meest recente versie (versie 4.0.6 of hoger). Marketing Add-on SE werkt niet volledig, indien een oudere versie van Contact Manager SE geïnstalleerd staat.
LET OP: U dient altijd de recente commerciële versie van bovengenoemde add-ons te installeren.
1.4
Technische uitgangspunten
Er is bij de ontwikkeling gebruik gemaakt van de ‘Software Development Kit’ (SDK) voor Exact Synergy Enterprise. Deze werkwijze zorgt ervoor dat de add-on 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 Exact Synergy Enterprise.
1.5
Benodigde licenties
1.6
Module ‘YA5301 - Enabling add-on solutions role’ in de Exact Synergy Enterprise licentie. Voor de Marketing Add-on SE is een licentiesleutel van Eddon vereist.
Functionele uitgangspunten
Er wordt gebruik gemaakt van de standaard oplossing van Exact Synergy Enterprise vanaf batch 251. Eventueel kan dit uitgebreid worden met andere add-ons en maatwerk.
Eddon Software BV | Marketing Add-on SE | 24 november 2014 | pagina 5 van 25
2 2.1
Installatie Marketing Add-on SE Add-on Maatwerkmenu SE
Voor een correcte werking van de add-ons 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 add-ons en maatwerkonderdelen worden aangeroepen.
2.2
Installatie software
De add-on dient op de server geïnstalleerd te worden waar ook Exact Synergy Enterprise staat. Door middel van het bestand ‘CSSetup_NL.exe’ kan de set-up van de add-on opgestart worden. LET OP: Voor het installeren dienen alle gebruikers Synergy te verlaten. Ook eventuele achtergrondprocessen dient u tijdelijk te stoppen.
Bij “Installatie soort” wordt gekozen voor ‘CD installatie’ Bij “Lokale installatiedirectory” moet worden gekozen voor de directory waar Synergy in geïnstalleerd staat. Door te kiezen voor “OK” wordt de installatie gestart. Het volgende scherm verschijnt. Eddon Software BV | Marketing Add-on SE | 24 november 2014 | pagina 6 van 25
Door te kiezen voor “Ja” wordt de installatie verder uitgevoerd. Wanneer de installatie voltooid is, wordt het onderstaande scherm getoond.
2.3
Bijwerken database
Na het installeren van de add-on moet de database opnieuw geïnitialiseerd worden. Hierom zal automatisch worden gevraagd bij het opstarten van Synergy.
Eddon Software BV | Marketing Add-on SE | 24 november 2014 | pagina 7 van 25
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.
Eddon Software BV | Marketing Add-on SE | 24 november 2014 | pagina 8 van 25
3 3.1 3.1.1
Configuratie Marketing Add-on SE Beveiliging in Synergy Benodigde rol ‘Enabling add-on solutions’
Alle medewerkers die gebruik moeten kunnen maken van Marketing Add-on SE, 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’. Voor meer informatie over de rollenstructuur binnen Exact Synergy Enterprise verwijzen wij u naar documenten 20.997.555 en 20.708.246 op de Exact Customer Portal.
3.1.2
Benodigde functierechten
Bij de installatie van Marketing Add-on SE zijn automatisch een aantal nieuwe functierechten aangemaakt. Deze zijn te vinden via het menupad “Systeem | Inrichting | Beveiliging: Functierechten”, door te klikken op het getal achter “Alle”.
Bovenstaande functierechten moeten gekoppeld worden aan een rol. Automatisch zorgt Synergy ervoor dat standaard de rol ‘Administrator’ Marketing Add-on SE mag onderhouden en gebruiken. Door functierecht 1731000 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 add-on. Na opnieuw inloggen, kan de medewerker de add-on verder onderhouden. Functierecht 1731001 geeft de gebruiker rechten om de marketing categorieën en kenmerken te onderhouden. Functierecht 1731002 is nodig om de marketing kenmerken te kunnen beheren op de relaties en contactpersonen. Functierecht 1731003 geeft de gebruiker de mogelijkheid om relaties en contactpersonen te zoeken met bepaalde marketing kenmerken. Functierecht 1731004 geeft de gebruiker rechten om de marketing categorieën en kenmerken bulksgewijs toe te kennen aan relaties en contactpersonen.
Eddon Software BV | Marketing Add-on SE | 24 november 2014 | pagina 9 van 25
3.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 add-on menu aangepast wanneer er een wijziging (update of toevoeging) heeft plaatsgevonden in de add-ons. Na het bijwerken, zal “Add-on | Inrichting” er als volgt uitzien:
U heeft hier de mogelijkheid om de marketing kenmerken en de bijbehorende categorieën te definiëren en om de status van aangevraagde of uitgevoerde bulkacties te bekijken.
3.3
Onderhoud instellingen
Nadat de add-on voor Synergy is geïnstalleerd, moeten er een aantal instellingen ingevuld worden. De instellingen zijn te onderhouden via het menupad “Add-on | Inrichting | Marketing kenmerken: Instellingen”.
3.3.1 Installatie licentiesleutel Voor een correcte werking van deze add-on 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_1731_Marketing Add-on_[Naam klant in Exact]_[Einddatum]_[Aantal gebruikers].txt
Eddon Software BV | Marketing Add-on SE | 24 november 2014 | pagina 10 van 25
Als u dit bestand opent met Kladblok, ziet u bijvoorbeeld onderstaande (fictieve) licentiesleutel:
De licentiesleutel is te onderhouden via het menupad “Add-on | Inrichting | Marketing kenmerken: Instellingen”. U kopieert de licentiesleutel vanuit het tekstbestand en in de instelling “Licentie: Licentie”.
Zonder deze licentiesleutel zal Marketing Add-on SE niet functioneren. U kunt wel categorieën en kenmerken aanmaken, maar u heeft niet de knoppen tot uw beschikking om deze toe te passen op relaties en contactpersonen. U kunt de add-on alleen gebruiken in uw eigen Synergy-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.
3.3.2
Algemeen
Eddon Software BV | Marketing Add-on SE | 24 november 2014 | pagina 11 van 25
Licentiesleutel Gekoppelde codes kunnen worden aangepast Bulk limiet direct toevoegen /verwijderen
3.4
Marketing Add-on SE licentiesleutel, zie paragraaf 3.3.1. Standaard kunt u categorie- en kenmerkcodes die al gebruikt worden op een relatie of contactpersoon niet meer aanpassen. Door deze optie aan te vinken heeft u de mogelijkheid om deze achteraf nog aan te kunnen passen. U kunt aangeven hoeveel relaties of contactpersonen tijdens een bulkproces direct aangepast kunnen worden. Heeft u een zoekresultaat met meer dan het ingestelde aantal, worden de wijzigingen pas doorgevoerd nadat het achtergrondproces is uitgevoerd. Zie hoofdstuk 4
Onderhoud kenmerken
De marketing kenmerken verdeelt u in categorieën. Eerst maakt u categorieën aan, waaraan u kenmerken kunt koppelen. Hiervoor gaat u naar “Add-on | Inrichting | Marketing kenmerken: Kenmerken”. U krijgt dan een overzicht van alle categorieën.
U kunt in dit scherm zoeken naar kenmerken. U kunt zoeken op categoriecode of –omschrijving, op kenmerkcode of –omschrijving en op de status actief. Door op de knop “Actualiseren” te klikken krijgt u de categorieën te zien die aan uw zoekcriteria voldoen.
3.4.3
Categorieën toevoegen, wijzigen en verwijderen
Om een nieuwe categorie toe te voegen of een bestaande categorie te wijzigen, klikt u op de knop “Nieuw” of op de naam van de categorie in het overzichtsscherm voor de kenmerken. Het volgende scherm wordt dan geopend.
Eddon Software BV | Marketing Add-on SE | 24 november 2014 | pagina 12 van 25
U vult hier de volgende gegevens in. De velden met een Code
Omschrijving + Term
Actief
zijn verplicht.
Een unieke categoriecode, door u zelf te kiezen. Indien u bij de instellingen van de Marketing Add-on SE “Gekoppelde codes kunnen worden aangepast” (zie 3.3.2) niet heeft aangevinkt, kunt u gebruikte categoriecodes niet meer aanpassen. Het vakje is dan grijs en u kunt het niet bewerken. Omschrijving van de categorie + Term ID. Termen definieert u via “Add-on | Inrichting | Termen: Zoeken”. De nummers kunt u vervolgens gebruiken in de “Term ID”-velden (eventueel zoekt u ze op via de link “Zoeken”). Voor het werken met termen verwijzen wij u naar hoofdstuk 5. Actief staat standaard aangevinkt. Als u actief uitzet, kunt u de kenmerken uit deze categorie niet meer koppelen aan relaties of contactpersonen, en niet meer zoeken op kenmerken uit deze categorie. U kunt de kenmerken nog wel zien, als ze al gekoppeld waren aan een relatie of contactpersoon voordat deze categorie op inactief werd gezet.
Indien u een nieuwe categorie aan het toevoegen bent, kunt u kiezen voor “Bewaren” of “Bewaren + Nieuw” Bij klikken op “Bewaren” kunt u direct doorgaan met het koppelen van kenmerken aan de categorie. U kunt ook klikken op “Bewaren + Nieuw”. Hiermee wordt de categorie opgeslagen en krijgt u een leeg scherm om een nieuwe categorie aan te maken. U dient later de kenmerken nog te koppelen aan de categorieën. Heeft u een bestaande categorie geopend, dan kunt u de wijzigingen opslaan door te klikken op “Bewaren”. U kunt categorieën ook verwijderen. In het overzichtsscherm van alle categorieën zet u een vinkje voor de categorieën die u wilt verwijderen. Vervolgens klikt u op de knop “Verwijderen”. U kunt de categorieen ook verwijderen door deze te openen, en vervolgens in het detailscherm te kiezen voor de knop “Verwijderen”. Indien u bij de instellingen van de Marketing Add-on SE “Gekoppelde codes kunnen worden aangepast” niet heeft aangevinkt (zie 3.3.2), kunt u gebruikte categorieën niet selecteren om te verwijderen. LET OP: Indien u “Gekoppelde codes kunnen worden aangepast” wel heeft aangevinkt, kunt u categorieën verwijderen waarvan de kenmerken al gekoppeld zijn aan relaties of contactpersonen. De categorie en de bijbehorende kenmerken worden dan verwijderd van de relaties of contactpersonen.
3.4.4
Kenmerken toevoegen, wijzigen en verwijderen
Na het bewaren van een categorie of het openen van bestaande categorie, kunt u kenmerken aan de categorie koppelen, verwijderen of wijzigen. In het detailscherm van de categorie is de sectie ‘Kenmerken’ zichtbaar.
Eddon Software BV | Marketing Add-on SE | 24 november 2014 | pagina 13 van 25
Code
Omschrijving + Term Gebruikstype Rol + Rolniveau Divisie
Kostenplaats
Actief
Een unieke kenmerkcode, door u zelf te kiezen. Indien u bij de instellingen van de Marketing Add-on SE “Gekoppelde codes kunnen worden aangepast” (zie 3.3.2) niet heeft aangevinkt, kunt u gebruikte kenmerkcodes niet meer aanpassen. Het vakje is dan grijs en u kunt het niet bewerken. Omschrijving + Term ID. Is het kenmerk van toepassing op relaties, contactpersonen of beide. Hier geeft u aan welke rol een gebruiker moet hebben om dit kenmerk toe te kennen of te verwijderen. Indien u gekozen heeft voor “Rolniveau” ‘Divisie’, dient u hier op te geven welke divisie het betreft. Alleen gebruikers die de betreffende waarde als divisie hebben, kunnen dit kenmerk toekennen of verwijderen. Als u geen “Rolniveau” gekozen heeft, kunt u de ‘Divisie’ gebruiken als zoekcriterium bij het zoeken naar relaties of contactpersonen. U kunt een kostenplaats aan een kenmerk koppelen. Alleen gebruikers die de betreffende waarde als kostenplaats hebben, kunnen dit kenmerk toekennen of verwijderen. Als u geen “Rolniveau” gekozen heeft, kunt u de ‘Kostenplaats’ gebruiken als zoekcriterium bij het zoeken naar relaties of contactpersonen. Actief staat standaard aangevinkt. Als u actief uitzet, kunt u dit kenmerk niet meer koppelen aan relaties of contactpersonen, en niet meer zoeken op dit kenmerk. U kunt het kenmerk nog wel zien, als dit al gekoppeld was aan een relatie of contactpersoon voordat het kenmerk op inactief werd gezet.
Zodra u iets gewijzigd heeft in een kenmerkregel, verschijnt er rechts achter de regel een knopje om het kenmerk op te slaan: U kunt een nieuw kenmerk toevoegen door op de knop “Nieuw” te klikken in de sectie ‘Kenmerken’. Om een kenmerk te verwijderen, plaats u in het detailscherm voor de categorie een vinkje voor het betreffende kenmerk. Vervolgens klikt u op de knop “Verwijderen” in het de sectie ‘Kenmerken’. Indien u bij de instellingen van de Marketing Add-on SE “Gekoppelde codes kunnen worden aangepast” niet heeft aangevinkt (zie 3.3.2), kunt u gebruikte kenmerken niet selecteren om te verwijderen. LET OP: Indien u “Gekoppelde codes kunnen worden aangepast” wel heeft aangevinkt, kunt u kenmerken verwijderen die al gekoppeld zijn aan relaties of contactpersonen. Het kenmerk wordt dan verwijderd van de relatie of contactpersoon.
Eddon Software BV | Marketing Add-on SE | 24 november 2014 | pagina 14 van 25
3.5
Toekennen kenmerken aan relaties en contactpersonen
Op de relatie- en contactpersoonkaart is na het installeren van de Marketing Add-on SE een nieuwe sectie ‘Marketing kenmerken’ zichtbaar.
Indien er kenmerken gekoppeld zijn aan een relatie of een contactpersoon, dan zijn deze hier direct zichtbaar. U kunt zelf nieuwe kenmerken toevoegen. Hiervoor heeft u functierecht 1731002 nodig (zie 3.1.2). Door op de knop “Beheren” te klikken, opent u een nieuw scherm.
U ziet hier alleen de kenmerken die u op basis van de ingestelde rol of het niveau mag zien. Vink de kenmerken aan en verplaats ze naar rechts middels de pijltjes (1). Klik vervolgens op “Ok”. LET OP: Indien u een contactpersoon op inactief zet, worden de kenmerken verwijderd. U kunt de relatie niet meer terugvinden via de kenmerken van deze contactpersoon. Eddon Software BV | Marketing Add-on SE | 24 november 2014 | pagina 15 van 25
3.6
Zoeken op kenmerken
Nadat u kenmerken heeft toegekend aan relaties en contactpersonen, kunt u ze gaan gebruiken om selecties te maken. Voor het zoeken op kenmerken heeft u functierecht 1731003 nodig (zie 3.1.2). In het zoekscherm voor Relaties schakelt u de optie “Geavanceerd zoeken” in. Hiervoor klikt u op het onderhoudsicoon rechtsboven in het scherm: Onderaan deze pagina kiest u voor ‘Zoeken via operatoren’ in het onderdeel “Geavanceerd zoeken” en klikt u op “Bewaren”.
Bij het onderdeel ‘Geavanceerd zoeken’ kunt u nu de kenmerken en categorieën waar u op wilt zoeken, toevoegen aan de zoekcriteria.
U vult in op welke eigenschap u wilt zoeken (1). In het tweede vakje (2) kunt u aangeven of het kenmerk juist wel of niet aan de criteria moet voldoen. Vervolgens selecteert u een operator (3), zoals ‘gelijk aan’, of ‘leeg’. Door op het loepicoon (4) te klikken kunt u, afhankelijk van uw keuze bij 3, de waarden selecteren waaraan het kenmerk of de categorie moet voldoen. Door te klikken op de knop “Toevoegen”, bewaart u dit criterium. U heeft de volgende zoekcriteria tot uw beschikking: Contactpersoon: Categorie Contactpersoon: Kenmerk Contactpersoon: Kenmerk divisie Contactpersoon: Kenmerk kostenplaats Relatie: Categorie Relatie: Kenmerk Relatie: Kenmerk divisie Relatie: Kenmerk kostenplaats
Contactpersoon met een kenmerk uit een bepaalde categorie Contactpersoon met een bepaald kenmerk gekoppeld Contactpersoon met een marketingkenmerk waar een divisie in staat vastgesteld Contactpersoon met een marketingkenmerk waar een kostenplaats in staat vastgesteld Relatie met een kenmerk uit een bepaalde categorie Relatie met een bepaald kenmerk gekoppeld Relatie met een marketingkenmerk waar een divisie in staat vastgesteld Relatie met een marketingkenmerk waar een kostenplaats in staat vastgesteld
Eddon Software BV | Marketing Add-on SE | 24 november 2014 | pagina 16 van 25
U heeft de mogelijkheid om op meerdere criteria te zoeken bij “Geavanceerd zoeken”. Na het bewaren van het eerste criterium, wordt de knop “Toevoegen” vervangen door 2 knoppen “en” en “of”. Op deze wijze kunt u meerdere Marketing Kenmerken combineren in uw zoekopdracht.
Door de op knop “Tonen“ te klikken boven in het scherm, past u de zoekcriteria toe, en krijgt u de zoekresultaten te zien.
3.7
Bulkacties
Vanuit de zoekresultaten van relaties of contactpersonen, kunt u bulkacties aanroepen. Door middel van bulkacties kunt u de relaties of de contactpersonen uit uw zoekactie tegelijk bewerken. U kunt nieuw kenmerken toevoegen of bestaande verwijderen. Voor het uitvoeren van bulkacties dient u functierecht 1731004 te hebben (zie 3.1.2). Open het zoekscherm voor relaties of contactpersonen, stel uw selectie in, en klik op “Tonen”. In het resultatenscherm is een knop “Kenmerken” zichtbaar.
Het scherm voor het starten van een bulkactie wordt getoond.
Eddon Software BV | Marketing Add-on SE | 24 november 2014 | pagina 17 van 25
Onderwerp Toevoegen of verwijderen Aanmaken
Gebruiken Relatie: kenmerk
Contactpersoon: kenmerk
Het onderwerp van de bulkactie. Dienen het kenmerk toegevoegd of verwijderd te worden op de relaties of contactpersonen uit de zoekresultaten. U kunt kiezen of het kenmerk direct moet worden toegepast, of via een achtergrondproces. Als het aantal resultaten van uw zoekactie het ingestelde maximum overschrijdt (zie 3.3.2), staat hier alleen achtergrondproces. Zie hoofdstuk 4 U geeft hier aan welke gegevens van de relatie of contactpersoon bewerkt worden: Relaties, contactpersonen en/of hoofdcontactpersonen. Indien u bij “Gebruiken” gekozen heeft voor ‘Relaties’ of ‘Relaties’ in combinatie met contactpersonen, kunt u hier aangeven welk kenmerk u wilt toepassen op de gevonden relaties. Indien u bij “Gebruiken” gekozen heeft voor ‘Contactpersonen’ of ‘Hoofdcontactpersonen’, eventueel in combinatie met relaties, kunt u hier aangeven welk kenmerk u wilt toepassen op de gevonden contactpersonen.
Vervolgens klikt u op de knop “Uitvoeren” om de bulkactie uit te voeren, of aan een achtergrondproces toe te voegen.
3.7.5
Bulkacties beheren
U kunt uw uitgevoerde bulkacties inkijken, om te zien of ze uitgevoerd zijn en succesvol verlopen zijn. Hiervoor gaat u naar het onderdeel ‘Bulkacties’ in de instellingen van de Marketing Add-on SE, via het menupad “Add-on | Inrichting | Marketing kenmerken: Bulkacties”. U kunt ook klikken op de link met het HID nummer in het voortgangsscherm dat u ziet na het uitvoeren van een bulkactie via achtergrondproces.
Bulkacties waarbij gekozen is voor ‘Direct’ aanmaken, staan in het overzicht op status “Afgehandeld”. Indien u gekozen heeft voor ‘Achtergrondproces’, staan de bulkacties in het overzicht op status “Open” tot ze door het achtergrondproces verwerkt worden.
Eddon Software BV | Marketing Add-on SE | 24 november 2014 | pagina 18 van 25
4
Achtergrondproces
Bulkacties die niet direct uitgevoerd worden, dienen uitgevoerd te worden via een achtergrondproces ‘Marketing’.
4.1
Bulkacties
Het proces ‘Marketing’ kan op een aantal manieren worden ingesteld. De standaard en meest stabiele methode is via een SQL Job in de SQL Server Agent. Deze methode wordt daarom ook aangeraden. In specifieke gevallen kan ervoor gekozen worden om hiervan af te wijken. Het proces ‘Marketing’ wordt uitgevoerd door de standaard executable Exact.Process.exe. Deze executable bevindt zich in de Bin-map in de Synergy programmatuurmap en voert alle achtergrondprocessen uit. De verschillende achtergrondprocessen zijn DLL-bestanden die door de executable worden aangeroepen via parameters. U dient de volgende parameters mee te geven: /DBCONFIG /ASSEMBLY /CLASS
De naam van de Synergy virtual directory. Refereert naar de DLL die de betreffende functie bevat. Refereert naar de specifieke functie in de DLL.
LET OP: De parameters zijn hoofdlettergevoelig. U stelt het achtergrondproces als volgt in: “<Synergy directory>\bin\Exact.Process.exe” /DBCONFIG:
/ASSEMBLY:CSNobMarket.Scheduler /CLASS:Scheduler LET OP: Bij het gebruik van spaties in de ‘<Synergy directory>’ dient u het gehele menupad te omsluiten met dubbele aanhalingstekens. Bijvoorbeeld: "C:\Exact Synergy Enterprise\SESB\bin\Exact.Process.exe" /DBCONFIG:SESB /ASSEMBLY:CSNobMarket.Scheduler /CLASS:Scheduler Let op het gebruik van hoofdletters!
4.1.1
SQL Job
Zoals gezegd is het aan te raden de background job in te stellen als SQL Job. Start de SQL Server Management Studio en klik met de rechter muisknop op “<SQL Server> | SQL Server Agent | Jobs”. Kies “New Job”. Vul een logische “Name” in. Bij “Owner” is het meest gebruikelijk om ‘sa’ in te vullen. LET OP: Het account (de owner) waaronder de job draait, moet dezelfde zijn als waaronder de SQL Server Agent draait. Daarnaast moet het account toegang hebben tot de Synergy en Globe databases. Ga naar ‘Steps’ en kies “New”. Geef een “Step name” op en kies bij “Type” voor ‘Operating system (CmdExec)’. Vul bij ‘Command’ het commando zoals hierboven beschreven: “<Synergy directory>\bin\Exact.Process.exe” /DBCONFIG: /ASSEMBLY:CSNobMarket.Scheduler /CLASS:Scheduler
Eddon Software BV | Marketing Add-on SE | 24 november 2014 | pagina 19 van 25
Bij ‘Run as’ kiest u bij gebruik van SQL 2005 voor “SQL Server Agent Service Account”. Bij gebruik van SQL 2008 dient u eerst nog een proxy in te stellen en deze vervolgens te selecteren bij ‘Run as’. Meer informatie over het instellen van een proxy kunt u nalezen in paragraaf 4.1.1.1. Klik op “OK” en vul bij “Scheduled | New” nog een schedule in waarop de job moet draaien. Controleer tot slot bij “General” of “Enabled” is aangevinkt en klik op “OK” om de job te activeren. LET OP: Zorg ervoor dat de SQL Server Agent altijd draait. 4.1.1.1 Proxy instellen in SQL 2008 Zoals eerder vermeld, dient u bij gebruik van SQL 2008 een proxy in te stellen om SQL jobs te kunnen laten draaien. Allereerst maakt u hiervoor een nieuwe credential aan. Klik met de rechter muisknop op ‘Security | Credentials’ en kies voor “New Credential”.
Eddon Software BV | Marketing Add-on SE | 24 november 2014 | pagina 20 van 25
Het account dat u hier instelt, dient voldoende rechten te hebben binnen Synergy en is daarom ook het account waaronder de SQL Server Agent en de job zal draaien. Klik vervolgens met de rechter muisknop op ‘SQL Server Agent | Proxies’ en kies voor “New Proxy”. Geef een ‘Proxy name’ op en kies bij ‘Credential name’ de credential die u zojuist heeft ingesteld. Bij ‘Active to the following subsystems’ vinkt u de optie “Operating system (CmdExec)” aan. Klik tot slot op “OK”.
Eddon Software BV | Marketing Add-on SE | 24 november 2014 | pagina 21 van 25
4.1.2
Geplande Taak
Een soortgelijke methode als de SQL Job is een ‘Geplande Taak’. Deze is toe te voegen via het Windows Configuratiescherm. In de ‘Wizard Taak plannen’ klikt u “Volgende”. Klik in het volgende scherm op “Bladeren” en navigeer naar de Exact.Process.exe. Kies hoe vaak u de job wilt draaien, bijvoorbeeld ‘Dagelijks’. Klik “Volgende” en vul in op welke tijden u de job wilt draaien. Klik “Volgende”. U vult hier de gebruikersnaam in waaronder de job moet draaien. LET OP: De gebruikersnaam dat u hier invult moet toegang hebben tot de Synergy database. Klik “Volgende” en vink de optie “Geavanceerde eigenschappen voor deze taak openen wanneer ik op Voltooien klik” aan en klik “Voltooien”. Vul het veld “Uitvoeren” aan met de parameters zoals hierboven vermeld en zorg ervoor dat “Ingeschakeld (de geplande taak wordt op de ingestelde tijd gestart)” is aangevinkt. Klik op “OK” om de geplande taak te activeren.
4.2
Troubleshooting
Loggegevens worden ook in Synergy weergegeven onder “Systeem | Overzichten | Log: Processen”.
Eddon Software BV | Marketing Add-on SE | 24 november 2014 | pagina 22 van 25
5
Termen onderhouden
Voor add-ons kunt u maatwerktermen opgeven voor onder andere label- en omschrijvingsvelden. Tevens is er een veld “Term ID” aanwezig in de verschillende onderhoudsschermen van de add-on. 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 onderhoudsschermen van de add-on 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 kunnen 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:
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.
Eddon Software BV | Marketing Add-on SE | 24 november 2014 | pagina 23 van 25
5.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.
5.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.
Eddon Software BV | Marketing Add-on SE | 24 november 2014 | pagina 24 van 25
6 6.1
Technische eigenschappen Databasetabellen
Na installatie van Marketing Add-on SE worden in de database automatisch tabellen toegevoegd. Tabel CSNobMarketAccountProperties CSNobMarketCategories CSNobMarketContactProperties CSNobMarketProperties
Omschrijving Hierin worden de relaties met de toegekende kenmerken opgeslagen. Definitie van de categorieën. Tabel om contactpersonen met toegekende kenmerken te bewaren. Definitie van de kenmerken.
Eddon Software BV | Marketing Add-on SE | 24 november 2014 | pagina 25 van 25