Orbis Software Debman4U Installatie Handleiding Debman4U v210 Dit document bevat de Installatie Handleiding voor Debman4U van versie 2x naar 210
Inhoudsopgave 1 0 1 1 1 2 1 3 1 4 1 5 1 6 Aandachtspunten update Debman4U Inleiding Import views aanpassen Instellingen controleren Nieuwe processen / pagina s Controleren / aanpassen taken / instellingen Com object vervangen met vb script 0 1 0 1 0 1 02 02 02 03 2 0 2 1 2 2 Debman4U v210 Voordat u begint Systeemeisen 06 06 06 3 0 3 1 3 2 3 3 Nieuwe installatie Debman4U Database Applicatie Orbis taken 06 06 0 7 09 4 0 4 1 4 2 Update Debman4U Database Applicatie 09 09 1 0
10 Aandachtspunten update Debman4U 11 Inleiding Wanneer u Debman4U update van versie 207 of 208, dan dient u met onderstaande zaken rekening te houden: 12 Import views aanpassen Er zijn een aantal veranderingen in de synchronisatie doorgevoerd Om deze na de update uit te kunnen voeren, dienen de volgende velden aan de import views per administratie toegevoegd te worden: Import view relaties Uitvoertype toevoegen, mogelijke waarden: NULL: niet aanpassen Lege string: leegmaken E, F, : Email, Fax of print Import view Openstaande posten Veld RelatieCode (zelfde bron-veld als voor import view Relaties) toevoegen (ivm synchronisatie logboek) Import view facturen mutaties Veld UwReferentie toevoegen aan de import view 13 Instellingen controleren Van een aantal instellingen in Debman4U is de functionaliteit aangepast Controleer deze instellingen na de update van Debman4U Dossier activeren na dagen vervallen Dossier activeren na dagen vervallen is aangepast naar Dossier activeren na dagen vervallen/factuurdatum Er wordt voor het activeren van het dossier gekeken naar het uitgangspunt van de eerste trajectactiviteit binnen het traject Controleer voor alle trajecten of het uitgangspunt de factuur-datum is en als dat zo is, verander dan de waarde van deze instelling 01
Nieuwe iconen selecteren bij de activiteiten In het nieuwe design van Debman4U zijn de iconen van de activiteiten aangepast U dient voor de activiteiten nieuwe iconen te selecteren via de instellingen pagina van de activiteiten 14 Nieuwe processen / pagina s Synchronisatie logboek uitleggen bij de klant Wanneer in de backoffice relaties samengevoegd / verwijderd / hernummerd zijn kan dit in Debman4U voor problemen zorgen Deze problemen worden in het synchronisatie logboek opgeslagen en kunnen via de nieuwe pagina Synchronisatie logboek opgelost worden 15 Controleren / aanpassen taken / instellingen Handmatig rekeningoverzicht Om optimaal gebruik te kunnen maken van de nieuwe mogelijkheid om handmatig de contactpersoon-gegevens in het nieuwe Start Taak scherm in te vullen, dient u te controleren of de taak voor het versturen van een handmatig rekeningoverzicht gebruik maakt van de standaard view _OSB_vw_Orbis_VerstuurRekeningOverzicht Voor een voorbeeld hoe u deze view gebruikt kan worden, kunt u kunt de voorbeeld-taak 0103 Rekeningoverzicht handmatig bekijken Handmatig kopiefactuur Om optimaal gebruik te kunnen maken van de nieuwe mogelijkheid om handmatig de contactpersoon-gegevens in het nieuwe Start Taak scherm in te vullen, dient u te controleren of de taak voor het versturen van kopie-facturen gebruik maakt van de standaard view _OSB_vw_Orbis_VerstuurKopieFactuur Upload van documenten Indien de Debman4U taken nog gebruik maken van een COM object om documenten te uploaden in Debman4U, moet dit vervangen worden door TaskCentre functie Debman4u_ Upload_document U kunt deze functie importeren in TaskCentre door het bestand Functie Debman4u_Upload_documenttks uit de Taken map te importeren Voor een voorbeeld hoe deze functie gebruikt kan worden, kunt u de voorbeeld-taak 0103 Rekeningoverzicht handmatig bekijken 02
Com object vervangen met vb script Indien er een com object aanwezig is raden wij u aan om, voor het uitvoeren van een update van Debman4U, onderstaande stappen te volgen Indien niet aanwezig, dan is onderstaande niet van toepassing 1: Maak een globale functie, genaamd Debman4u_Upload_document aan, als deze nog niet aanwezig is Kies voor Functions onder System en vervolgens rechter-muis klik aan de rechterkant en kies Add Function 2: Definieer parameters met ByVal: ByVal strbestandsnaam ByVal stromschrijving ByVal strbesandsnaamlog ByVal strdossieruid ByVal intwerkstroomid 3: Code functie, pas servernaam en/of database aan indien nodig Wat men aan dient te passen is ROOD aangegeven 4: In plaats van Trusted connection, waarbij de windows gebruiker waaronder de taak uitgevoerd wordt (impersonation op taak of server-niveau of iwtsksvr-service) kan men ook kiezen voor Standard security, vervang hiervoor Integrated Security=SSI; met User ID=user;assword=password; Constants Const adopenstatic = 3 Const adlockoptimistic = 3 Const aduseclient = 3 Bepaal hier de bestandsnaam a=split(strbestandsnaam, \ ) For Each x in a stronlyfile=x Next 03
Open a database connection Dim conn : Set conn=createobject( ADODBConnection ) connconnectionstring = rovider=sqloledb;data Source=Orbis-SQL;Initial Catalog=Debman4u;Integrated Security=SSI; connopen Set objcmd = CreateObject( ADODBCommand ) ObjCmdActiveConnection = conn ObjCmdCommandType = 4 Stored rocedures ObjCmdCommandText = _OSB_sp_Document_Toevoegen ObjCmdarametersRefresh If strdossieruid<> Then ObjCmdarameters( @DOSSIERUID )Value = strdossieruid If intwerkstroomid<>0 Then ObjCmdarameters( @WERKSTROOMID )Value = intwerkstroomid If stromschrijving<> Then ObjCmdarameters( @OMSCHRIJVING )Value = stromschrijving If stronlyfile<> Then ObjCmdarameters( @BESTANDSNAAM )Value = stronlyfile ObjCmdExecute() DocumentID = ObjCmdarameters(5)Value Set objcmd = Nothing Const adtypebinary = 1 Create Stream object Dim BinaryStream : Set BinaryStream = CreateObject( ADODBStream ) Specify stream type - we want To get binary data BinaryStreamType = adtypebinary Open the stream BinaryStreamOpen Load the file data from disk To stream object BinaryStreamLoadFromFile strbestandsnaam Open the stream And get binary data from the object BinaryFile = BinaryStreamRead Dim rs : Set rs=createobject( ADODBRecordset ) Open the record Dim strsql : strsql = SELECT Bestand FROM _OSB_tb_Documenten WHERE DocumentID= & CStr(DocumentID) rsopen strsql, conn, adopenstatic, adlockoptimistic rs( Bestand ) = Binaryfile rsupdate rsclose connclose Call Debman4u_Upload_document( e:\orders importerentks,, orders importeren,,0) 5: Open de browser van de taak en ga naar het Environment tabblad en verwijder de com-objecten 04
6: Maak een VB-script actie aan en roep de globale functie Debman4u_Upload_document aan Dit kan door de functie vanuit de browser te slepen naar het VB-script Die moet gekoppeld zijn aan de recordset waar men de gegevens ophaalt die gebruikt worden voor het aanmaken van de herinnering documenten Voorbeeld van een aanroep Debman4u_Upload_document ThisStepRecordSource( Attachment ), ThisStep RecordSource( Omschrijving ), c:\orbis\debman4utxt, ThisStepRecordSource( DossierUID ), ThisStepRecordSource( WerkstroomID ) Eerste parameter strbestandsnaam : Volledige path en filenaam van het bestand Tweede parameter stromschrijving : Omschrijving die getoond wordt bij het document Derde parameter strbesandsnaamlog : Wordt niks mee gedaan Vierde parameter strdossieruid : DossierUID van het dossier waar je de document aan wil koppelen DossierUID moet een GUID zijn In oudere versies was die een varchar, maar in deze versie moet het een GUID zijn Vijfde parameter intwerkstroomid : De werkstroomactiviteit waarbij het document aan gekoppeld wordt 7: Als in de functie gebruik gemaakt wordt van een Trusted connection, controleer of impersonation op taak- of serverniveau ingesteld is op of de TaskCentre service uitgevoerd wordt als een gebruiker die rechten heeft in de Debman4U database 05
20 Debman4U v210 21 Voordat u begint Wij raden u aan om voor het uitvoeren van een update van Debman4U aan de hand van deze installatie handleiding, een back-up te maken van de Debman4U database Wij raden u aan om de updates voor Microsoft Net Framework via Windows update te installeren 22 Systeemeisen Op Debman4U zijn de volgende systeemeisen van toepassing: NET Framework versie 20 of hoger, IIS versie 60 of hoger, SQL Server 2005 of hoger In SQL server dient SQL Server authenticatie ingeschakeld te zijn om vanuit de webapplicaties met de database te kunnen verbinden met de standaard instellingen Om de standaard- / voorbeeldtaken te kunnen importeren heeft u minimaal TaskCentre versie 45 nodig 30 Nieuwe installatie Debman4U 31 Database U kunt met behulp van het script Create Debman4U Database v210sql een nieuwe Debman4U database aanmaken en initialiseren 1: Open het bestand Create Debman4U Database v210sql in Microsoft SQL Server Management Studio 06
2: Maak verbinding met de SQL Database Server als gebruiker met voldoende rechten om een nieuwe database aan te kunnen maken 3: Optioneel: In het script staat de code om nieuwe SQL login en een SQL gebruiker aan te maken in commentaar, u kunt in het bestand /* en */ op resp regels 12 en 25 verwijderen om ook de login voor de database en de gebruiker aan te maken 4: Gebruik het Specify Values for Template arameters commando (Ctrl + Shift + M) om oa de naam van de nieuwe database en de gebruikersnaam te vervangen door heel het bestand Databasename: de naam van de nieuw aan te maken database DatabaseUsername: de naam van zowel de (nieuw aan te maken) SQL login als de SQL gebruiker in de database Als u het aanmaken van de login / gebruiker niet uit commentaar gehaald heeft, kunt u dit leeg laten Databaseassword: het wachtwoord voor de (nieuw aan te maken) SQL login Als u het aanmaken van de login / gebruiker niet uit commentaar gehaald heeft, kunt u dit leeg laten AdministrationId: Een (numeriek) ID voor de aan te maken administratie (er dient altijd tenminste een administratie in Debman4U aanwezig te zijn) AdministrationCode: De code van de aan te maken administratie Administrator_Login: Gebruikersnaam van de administrator gebruiker voor Debman4U Met deze gebruikersnaam en onderstaande wachtwoord kunt u na installeren van de applicatie inloggen in Debman4U Administrator_assword: Wachtwoord van de administrator gebruiker voor Debman4U 5: Voer het script uit met het Execute commando (F5) 32 Applicatie 1: Kopieer de bestanden voor de applicatie van de folder AS naar een lokale folder op de webserver (met IIS 6 of hoger) 2: Optioneel: Maak een aparte Application pool aan voor de applicatie In IIS 6 wordt de Net Framework versie per virtuele directory ingesteld in plaats van op Appliction ool niveau, als twee virtuele directories in deze versie conflicterende Framework versies gebruiken, geeft dit een foutmelding 07
IIS 6: Geef een naam in bij de Application ool ID en kies voor Use default settings for the new application pool IIS 7: Geef een naam voor de application pool en kies bij Net Framework version voor Net Framework v20 of Net Framework v4x en bij Managed ipeline mode voor Integrated 3: Maak een nieuwe virtual directory (IIS 6) of Application (IIS 7) aan IIS 6: Kies bij de Default Web Site voor New en vervolgens Virtual directory Vul de naam van applicatie in (Debman4U) bij Alias en kies Next Voer de locatie naar de AS folder (zie stap 1) in bij ath en kies Next Vink bij ermissions de opties Read en Run scripts (such as AS) aan en kies Next Optioneel: Open de eigenschappen van de nieuw aangemaakte virtual directory en kies bij Application ool de in stap 2 aangemaakte application pool Voeg op het Documents tabblad Homeaspx als default document toe Open de Net instellingen via het ASNET tabblad, Edit Configuration as beide database verbindingen (Debman4U en OrbisLicentie) aan Sluit het ASNET Configuration Settings scherm en het eigenschappen scherm van de virtual directory beiden met de OK knop IIS 7: Kies bij Default Web Site voor Add Application Vul de naam van de applicatie (Debman4U) in bij Alias en de locatie naar de AS folder (zie stap 1) bij hysical path Optioneel: Kies de in stap 2 aangemaakte application pool met behulp van de knop Select Open de instellingen voor Default Document en voeg Homeaspx toe Open de instellingen voor Connection Strings en pas beide database verbindingen (Debman4U en OrbisLicentie) aan 4: Open Debman4U en log in met de administrator gebruiker (zie Database stap 4) U komt nu op het licentie scherm van Debman4U Vul uw relatie code en wachtwoord in om de relatiegegevens op te halen en klik vervolgens bij het kopje Licentie gegevens op de knop Gegevens ophalen om de licentie gegevens te downloaden 08
5: U kunt nu aan de slag met de inrichting van Debman4U Klik op het icoon om de instellingen van Debman4U te openen Op de verschillende instellingen-pagina s kunt u met behulp van het help icoon de helptekst voor het betreffende onderwerp opvragen 33 Orbis Taken Er worden een aantal standaard- / voorbeeldtaken met Debman4U meegeleverd om u op weg te helpen (Bijvoorbeeld taak 0101 Synchroniseren administraties voor de synchronisatie van Debman4U en 0103 Rekeningoverzicht Handmatig ), u dient zelf de layout van de E-mails en rapporten aan te passen U kunt de voorbeeldtaken importeren met de Import optie in TaskCentre (ten minste versie 45) 40 Update Debman4U 41 Database 1: We raden u aan om een backup te maken van de Debman4U database alvorens u deze update 2: 3: Controleer de versie van de Debman4U database in de tabel _OSB_tb_Versie Open het update-script om de huidige versie van Debman4U database naar de laatste versie te brengen in Microsoft SQL Server Management Studio Bijvoorbeeld, als de huidige versie 208 is, opent u het bestand Updatescript from v208 to v210sql uit 4: Maak verbinding met de SQL Database Server als gebruiker met voldoende rechten om de bestaande database aan te kunnen passen 5: Gebruik het Specify Values for Template arameters commando (Ctrl + Shift + M) om de naam van de database te vervangen door heel het bestand Databasename: de naam van de te updaten database 6: Voer het script uit met het Execute commando (F5) 09
42 Applicatie 1: Kopieer de bestanden voor de applicatie van de folder AS naar een lokale folder op de webserver (met IIS 6 of hoger) 2: Optioneel: Maak een aparte Application pool aan voor de applicatie In IIS 6 wordt de Net Framework versie per virtuele directory ingesteld in plaats van op Appliction ool niveau, als twee virtuele directories in deze versie conflicterende Framework versies gebruiken, geeft dit een foutmelding IIS 6: Geef een naam in bij de Application ool ID en kies voor Use default settings for the new application pool IIS 7: Geef een naam voor de application pool en kies bij Net Framework version voor Net Framework v20 of Net Framework v4x en bij Managed ipeline mode voor Integrated 3: 4: Verwijder de bestaande virtual directory / Application van Debman4U Maak een nieuwe virtual directory (IIS 6) of Application (IIS 7) aan IIS 6: Kies bij de Default Web Site voor New en vervolgens Virtual directory Vul de naam van applicatie in (Debman4U) bij Alias en kies Next Voer de locatie naar de AS folder (zie stap 1) in bij ath en kies Next Vink bij ermissions de opties Read en Run scripts (such as AS) aan en kies Next Optioneel: Open de eigenschappen van de nieuw aangemaakte virtual directory en kies bij Application ool de in stap 2 aangemaakte application pool Voeg op het Documents tabblad Homeaspx als default document toe Open de Net instellingen via het ASNET tabblad, Edit Configuration as beide database verbindingen (Debman4U en OrbisLicentie) aan Sluit het ASNET Configuration Settings scherm en het eigenschappen scherm van de virtual directory beiden met de OK knop 10
IIS 7: Kies bij Default Web Site voor Add Application Vul de naam van de applicatie (Debman4U) in bij Alias en de locatie naar de AS folder (zie stap 1) bij hysical path Optioneel: Kies de in stap 2 aangemaakte application pool met behulp van de knop Select Open de instellingen voor Default Document en voeg Homeaspx toe Open de instellingen voor Connection Strings en pas beide database verbindingen (Debman4U en OrbisLicentie) aan 5: Open Debman4U en log in met de administrator gebruiker Wanneer u update van Debman4U versie 207 of eerder, komt u hierna op het licentie scherm van Debman4U Vul uw relatie code en wachtwoord in om de relatiegegevens op te halen en klik vervolgens bij het kopje Licentie gegevens op de knop Gegevens ophalen om de licentie gegevens te downloaden 11
Meer informatie omtrent onze producten en/of diensten? Neem dan contact met ons op: Orbis Software Benelux BV Geldropseweg 250 5643 TR Eindhoven, Nederland Tel: +31 (0) 40 290 1640 Fax: +31 (0) 40 290 1649 Email: verkoop@orbis-softwarenl WWW: http://wwworbis-softwarenl