Installatiehandleiding ‘Business Assistent’
Wijzigingsgeschiedenis Versie 0.1
Datum 25-09-2014
1.0 1.1
04-11-2014 06-01-2014
1.2
25-02-2015
Omschrijving Eerste opzet van het installatie document. Geen: Commercieel maken Toevoegen nieuwe instelling “deactiveren” Toegevoegd: extra installatie tips/ controles
Versie 1.2 Business Assistent – Installatie handleiding
Status Concept Definitief: Commercieel 1.0 Definitief: Commercieel 1.1 Definitief: Commercieel 1.2
|1
Inhoud WIJZIGINGSGESCHIEDENIS ............................................................................................................................... 1 INHOUD ........................................................................................................................................................... 2 1.
INTRODUCTIE ........................................................................................................................................... 3 DOELSTELLING DOCUMENT......................................................................................................................................... 3 GERELATEERDE DOCUMENTEN .................................................................................................................................... 3 GEBRUIK VAN HET DOCUMENT .................................................................................................................................... 3 LEZERS DOELGROEP .................................................................................................................................................. 3
2.
DE SOFTWARE .......................................................................................................................................... 4 INHOUD VAN DE INSTALLATIESET. ................................................................................................................................ 4 (INSTALLATIE) EISEN ................................................................................................................................................. 4
3.
INSTALLATIE BUSINESS ASSISTENT ............................................................................................................ 5 INSTALLATIE STAPPEN OP EXACT SYNERGY ENTERPRISE .................................................................................................... 5
4.
STAPPEN NA DE INSTALLATIE ................................................................................................................... 6 INSTELLINGEN EXACT SYNERGY ENTERPRISE ................................................................................................................... 6 CONTROLE WERKING BUSINESS ASSISTENT .................................................................................................................... 6 BEKENDE (FOUT)MELDINGEN ...................................................................................................................................... 7
5.
BACKGROUNDJOB VOOR BINNENHALEN INDICATIE VAN WIJZIGING........................................................ 8 DE URL ................................................................................................................................................................. 8
APPENDIX A – DETAIL INHOUD VAN DE INSTALLATIE MAP............................................................................... 9
Versie 1.2 Business Assistent – Installatie handleiding
|2
1. Introductie In dit document wordt de installatie en configuratie van Business Assistent besproken. In dit document wordt de nadruk gelegd op de volgende onderwerpen: 1. Installatie van de Exact Synergy Enterprise software. 2. Inrichting van Business Assistent. Doelstelling document Na het lezen van dit document kan een consultant of een beheerder van de Exact Software de installatie van Business Assistent op de juiste manier uitvoeren. Daarnaast is de lezer in staat om de installatie te testen en goed te keuren. Indien er problemen ontstaan, kan de lezer eventueel oplossingen definiëren of de juiste gegevens aan de helpdesk van Webservices.nl doorsturen. Gerelateerde documenten De volgende documenten zijn een aanvulling op de informatie rondom Business Assistent: Documentnaam Handleiding voor Applicatiebeheerders Business Assistent Gebruikers handleiding Business Assistent
Omschrijving Handleiding met extra informatie voor applicatiebeheerders van Business Assistent. Gebruikershandleiding waarin de werking van Business Assistent wordt besproken.
Gebruik van het document Gebruik dit document als ondersteuning bij het installeren Business Assistent. Door het document goed door te lezen kunt u deze installatie eenvoudig zelf uitvoeren. Lezers doelgroep Het document is bestemd voor de volgende doelgroepen:
Doelgroep Consultants Systeembeheerders
Omschrijving Consultants die vanuit hun opdracht de software voor Business Assistent moeten installeren. Persoon verantwoordelijke voor het onderhoud en inrichten van het Exact Synergy Enterprise systeem.
Versie 1.2 Business Assistent – Installatie handleiding
|3
2. De software Business Assistent bestaat uit een aantal verschillende componenten. In de volgende hoofdstukken worden deze componenten kort besproken. Inhoud van de installatieset. De installatie set bestaat uit een aantal verschillende software componenten. Onderstaande tabel laat zien welke componenten dat zijn. Voor een volledige inhoud van de mappen kunt u bijlage A raadplegen. Map BIN Docs SQL
XML
Omschrijving Bevat alle DLL’s voor Business Assistent. Bevat alle ASPX en Images van Business Assistent. Bevat de SQL scripts voor Business Assistent en is onder andere verantwoordelijk voor het aanmaken van tabellen en functies. Bevat alle XML files voor Business Assistent.
Figuur 1: Installatieset van Business Assistent
(Installatie) Eisen U dient minimaal te voldoen aan de volgende (installatie) eisen, voordat u Business Assistent installeert en in gebruik kan nemen: • • • • • •
•
De installatie dient minimaal op batch versie 253 (vanaf oktober 2014) van Exact Synergy Enterprise of hoger te worden uitgevoerd. Let op: zorgt dat u de installatieset gebruikt welke overeenkomt met de Telerik.Web.UI.dll (uit de Synergy\bin map) van uw omgeving. U dient rekening te houden met de systeemeisen van de Exact Synergy Enterprise voor de batch waarmee gewerkt wordt. Installeren van het maatwerk dient uitgevoerd te worden door iemand met de Administrator rol in Exact Synergy Enterprise én Administrator rechten binnen het netwerk. Add-ons moeten ingeschakeld staan (Synergy, Inrichting, Add-ons, Instellingen. Vinkje bij “Add-ons deactiveren” moet uitgevinkt staan. Om als gebruiker gebruik te kunnen maken van de module dient men de licentierol: YA53011 Enabling add-on solutions role te gebruiken in combinatie met de licentierol YA0020 Professional Role of de licentierol YA0023 CRM role. Uw User account bij Webservices.nl dient geactiveerd te zijn.
Versie 1.2 Business Assistent – Installatie handleiding
|4
3. Installatie Business Assistent Voor een volledige werkende omgeving zijn een aantal verschillende installatie stappen nodig. In dit hoofdstuk worden deze per onderdeel besproken. Let op dat al deze zaken worden uitgevoerd! Indien er stappen worden vergeten dan loopt u het risico dat de installatie niet compleet is en bepaalde functies niet werken. Installatie stappen op Exact Synergy Enterprise Voer de volgende stappen uit om Business Assistent softwarematig te installeren voor Exact Synergy Enterprise: • • • •
•
•
•
Zorg voor een back-up van de Exact Synergy Database; Lokaliseer de installatie map van Exact Synergy Enterprise en stel deze veilig; Kopieer de Business Assistent installatie bestanden naar de server; Kopieer de inhoud van de installatie map naar de gelijknamige mappen in Synergy. Dus de bin naar de bin, de XML naar de XML, de docs naar de docs, de images naar de docs/images map en de SQL naar de SQL map; Open Exact Synergy Enterprise. Wanneer u Business Assistent voor de eerste keer installeert zal Exact Synergy Enterprise opnieuw gaan opbouwen. Dit betekent dat er een SQL script wordt uitgevoerd en nieuwe tabellen worden aangemaakt. Ook zal de repository van Exact worden aangepast. Het bijwerken van de database dient uitgevoerd te worden door iemand met de Administrator rol binnen Exact Synergy Enterprise en met Administrator rechten binnen het netwerk. Na het bijwerken zal Exact Synergy Enterprise worden geopend en kan Business Assistent zichtbaar gemaakt worden via de voorkeur instellingen pagina. Let op: werkt uw database niet bij, controleer dan of de add-ons geactiveerd kunnen worden (Systeem, inrichting, Add-ons, Instellingen). Controleer of u als Administrator in Exact Synergy ÉN het netwerk inlogt en dat deze login beschikt over de ‘Enable Add-on rol’. Indien u een upgrade doet, worden SQL wijzigingen door middel van batch to batch scripts uitgevoerd. Dit wordt automatisch gedaan bij het openen van Exact Synergy Enterprise.
Versie 1.2 Business Assistent – Installatie handleiding
|5
4. Stappen na de installatie Nadat u de software heeft geïnstalleerd dient u de koppeling naar Webservices.nl te leggen. Instellingen Exact Synergy Enterprise Voor een correcte werking van Business Assistent dient u de volgende instelling in te vullen 1. Webservices.nl>Inrichting>Algemeen>Instellingen. 2. Vul de volgende gegevens bij de sectie ‘Inloggegevens’; Gebruikersnaam bij Webservices.nl en het wachtwoord van Webservices.nl. De gegevens komen uit de ‘USER’ login van Webservices.nl. U dient deze login eerst te activeren door in te loggen via de link bij Webview.
Figuur 2: E-mail met login gegevens vanuit Webservices.nl
3. In de sectie ‘Standaardwaarde’ is het mogelijk een standaard ‘bron’ op te geven voor relaties aangemaakt via Business Assistent. Dit is niet een verplicht veld. 4. Vanaf versie 2015.01 is een extra instelling toegevoegd. Hiervoor is de sectie “Deactiveren” toegevoegd aan het menu. In deze sectie is de optie “Tijdelijk: Deactiveren” toegevoegd. Indien dit vinkje ‘uit’ gevinkt staat, dan zou Business Assistent (mits juist ingericht) netjes moeten werken. Staat dit vinkje ‘aan’ gevinkt, dan wordt het aanmaken van relaties via Business Assistent (tijdelijk) uitgeschakeld. Bij het aanmaken van de relatie, komt u na het kiezen van de juiste type, direct in het aanmaken relatie scherm. Controle werking Business Assistent Bij het aanmaken van een nieuwe relatie zal het ‘Bedrijven: Zoeken’ geopend worden.
Figuur 3: Bedrijven: Zoeken scherm
Zoek een willekeurig bedrijf. Indien de koppeling juist werkt, zal een resultaat teruggegeven worden.
Versie 1.2 Business Assistent – Installatie handleiding
|6
Bekende (fout)meldingen •
Indien de login gegevens incorrect zijn, zal Business Assistent de volgende melding teruggeven:
Figuur 4: Authenticatie probleem. Controleer de Webservices.nl gebruikersnaam en wachtwoord.
Controleert u login gegevens van de USER login nog een keer. Zijn deze correct én geactiveerd? Neem dan contact op met Webservices.nl. •
Indien een probleem met de internetverbinding zich voordoet, dan zal de volgende melding getoond worden:
Figuur 5: Webservices.nl is onbereikbaar. Controleer de internetverbinding op de server
Controleer de internetverbinding van de webserver (‘Synergy’ server). •
Krijgt u bij het zoeken geen foutmelding, maar ook geen resultaat terug? Neem dan contact op met Webservices.nl, het kan zijn dat het ‘tegoed’ bij Webservices.nl op is.
Versie 1.2 Business Assistent – Installatie handleiding
|7
5. Backgroundjob voor binnenhalen indicatie van wijziging Het binnenhalen van indicaties van wijzigingen kan functioneel via Webservices.nl, Overzichten, Bijwerken, Haal gewijzigde relaties op. Echter kan dit ook via een ‘backgroundjob’ opgehaald worden. De URL De te gebruiken jobnaam is: CSCaneWebNL.Jobs De te gebruiken class is: GetUpdatedDossiers De url ziet er als volgt uit: “*BestandenPadSynergy*\bin\Exact.Process.exe" /DBCONFIG:*VIRTUALDirectory van Synergy* /ASSEMBLY:CSCaneWebNL.Jobs /CLASS:GetUpdatedDossiers Voorbeeld: "C:\Exact\Synergy Enterprise\bin\Exact.Process.exe" /DBCONFIG:Synergy /ASSEMBLY:CSCaneWebNL.Jobs /CLASS:GetUpdatedDossiers Deze url is te gebruiken in een Windows Taak of via de SQL Server Agent. Let op: bij het inrichten van de background job via SQL Server Agent is het van belang dat het account waaronder de SQL Server Agent draait toegang heeft (Professional Licentierol + Administrator rol) tot Synergy.
Versie 1.2 Business Assistent – Installatie handleiding
|8
Appendix A – Detail inhoud van de installatie map MAP
Inhoud
Bin
CSCaneWebNL.Data.dll CSCaneWebNL.dll CSCaneWebNL.Extension.dll CSCaneWebNL.General.dll CSCaneWebNL.Jobs.dll
Docs/Images
CSCaneWebNL.png CSCaneWebNL-equal.png CSCaneWebNL-s.ico CSCaneWebNL-s.png CSCaneWebNL-transparent.png
DOCS
CSCaneWebNLAccountSearch.aspx CSCaneWebNLAccountsToBeUpdated.aspx CSCaneWebNLAccountsUpdate.aspx CSCaneWebNLAddressSearch.aspx CSCaneWebNLSettings.aspx CSCaneWebNLUpdateAccount.aspx
SQL
CSCaneWebNL.sql
XML
Applications.CSCaneWebNL.xml Custom.CSCaneWebNL.xml Menu.CSCaneWebNL.xml Repository.CSCaneWebNL.xml Terms.CSCaneWebNL.xml
Versie 1.2 Business Assistent – Installatie handleiding
|9
