Installeren Serviceapplicatie
5 december 2011; Versie:1.0
Handleiding voor het installeren van Serviceapplicatie Brondocument D:\WebServer\Handleiding\ServiceApplicatie\InstallerenServiceApplicatie.odt
Versiebeheer Versie
Datum
Uitleg
1.0v
22-05-06
Installeren + Werking Urenboeken
Tabel 1: Versiebeheer
Algemeen Alle benodigde bestanden voor de Serviceapplicatie worden in één bestand verzameld. Het grote voordeel van een één bestand is het eenvoudig installeren. Vanuit het bestand wordt expliciet gebruik gemaakt van een Java-versie. Dit kost meer ruimte in de vorm van bestanden, maar voorkomt eventuele conflicten met andere Java-versies in de toekomst. Daarnaast geeft een eventueel verouderde Java-versie geen beveiligingsproblemen, omdat Windows deze niet echt kent en niet automatisch kan gebruiken bij andere programma's. Hierdoor wordt een installatie het gewoon goed kopiëren van bestanden. Een gewone gebruiker zonder bijzondere bevoegdheden of kennis zou het moeten kunnen installeren. In principe zou de applicatie ook bij andere operating systemen kunnen werken. Momenteel is deze echter alleen op Windows getest.
Technische details Database De Serviceapplicatie heeft de volgende technische kenmerken: De applicatie communiceert middels een JDBC-driver met een database en is dus in principe in staat om met iedere database te communiceren. De applicatie werkt nu echter in een Sybaseomgeving en is globaal getest met een MS SQL-omgeving. Sybase Gebruiker
service
Sybase Wachtwoord
Op verzoek beschikbaar te stellen door Wilhelm Tell
Rechten
Public, uitvoeringsrechten op de WT_F_1544 procedures
Tabel 2: Database gegevens
Organisatie&Adviesbureau “Wilhelm Tell”
1 Van 8
Installeren Serviceapplicatie
5 december 2011; Versie:1.0
De WT_F_1544 procedures zijn specifiek voor de Serviceapplicatie in de database geschreven en worden automatisch bij een update geïnstalleerd of op verzoek verwijderd. Omgeving Het maakt de applicatie in principe niet uit waar het wordt geïnstalleerd, echter is het wel handig voor de eenvoud om er een eenduidige plek voor te geven. De gebruikersbestanden worden opgeslagen in de map “Mijn documenten” van de betreffende gebruiker. Hierbinnen wordt een nieuwe map aangemaakt, namelijk: ServiceData en hier worden de locale *.xml bestanden opgeslagen. Er is hiervoor gekozen, zodat in principe verschillende gebruikers op 1 computer met verschillende gebruikersnamen met de Serviceapplicatie kunnen werken. Bronbestanden De bronbestanden zijn te vinden in de ERP-map en dan UwBedrijfsnaam + Service, bijvoorbeeld WilhelmTellService als uw bedrijfsnaam WilhelmTell is. Indien u deze niet kunt vinden dan worden deze op verzoek naar u toegestuurd.
Installatie In deze handleiding wordt uitgelegd hoe de Serviceapplicatie wordt geïnstalleerd binnen de map d:/Service. In principe kan er een andere map worden gekozen. In dat geval dient binnen de handleiding d:/Service worden vervangen voor de door u gekozen map. Het installeren van de Serviceapplicatie bestaat uit de volgende stappen: 1. Maak de map d:/service aan. 2. Maak 2 mappen Java en ServiceApp in de map d:/service aan. 3. Kopieer de Java-bestanden naar de map Java. 4. Kopieer de service.jar naar de Map ServiceApp 5. Maak een opstartbestand aan. 6. Start de Serviceapplicatie succesvol op.
Organisatie&Adviesbureau “Wilhelm Tell”
2 Van 8
Installeren Serviceapplicatie
5 december 2011; Versie:1.0
Ad 1 Maak de map d:/Service aan
Afbeelding 1: Maak de map Service aan Ad 2 Maak 2 mappen Java en ServiceApp in de map d:/service aan. Ga naar de map d:/Service en maak hier 2 mappen aan, namelijk Java en ServiceApp
Afbeelding 2: Maak de mappen Java en ServiceApp aan
Organisatie&Adviesbureau “Wilhelm Tell”
3 Van 8
Installeren Serviceapplicatie
5 december 2011; Versie:1.0
Ad 3 Kopieer de Java-bestanden naar de map Java. Ga naar de map Java en kopieer de bestanden van de beschikbare Java-Versie in dit geval jre1.6.0_22 naar de map Java. De inhoud van de map Java zal er dan als volgt uitzien:
Afbeelding 3: Map Java met Java-bestanden gekopieerd Ad 4 Kopieer de service.jar naar de Map ServiceApp Ga vervolgens naar de map ServiceApp en kopieer het bestand Uwbedrijfsnaam + service.jar naar deze map. De map zal er dan als volgt uitzien:
Afbeelding 4: Service.jar gekopieerd binnen de map ServiceApp Prima nu zijn de benodigde bronbestanden geïnstalleerd. Ad 5 Maak een opstartbestand aan Om het opstarten voor de gebruiker eenvoudig te maken wordt er een extra bestand aangemaakt, maak namelijk een nieuw tekstbestand aan, namelijk opstarten.txt. P.S. Indien u de Serviceapplicatie op een vaste locatie installeert, kunt u uiteraard dit bestand uit uw bronbestanden kopiëren.
Organisatie&Adviesbureau “Wilhelm Tell”
4 Van 8
Installeren Serviceapplicatie
5 december 2011; Versie:1.0
Afbeelding 5: Bestand opstarten.txt aangemaakt binnen ServiceApp Open het bestand en vul de volgende tekst in. •
D:\Service\Java\jre1.6.0_22\bin\java.exe -jar WilhelmTellservice.jar. Hierbinnen is uw installatiemap D:\Service en uw bestand UwBedrijfsNaam + service.jar
•
Sla dit bestand op.
•
Wijzig vervolgens de *.txt extensie in *.bat
De map serviceapp zal er dan als volgt uitzien
Afbeelding 6: Opstarten.txt gewijzigd in Opstarten.bat
Organisatie&Adviesbureau “Wilhelm Tell”
5 Van 8
Installeren Serviceapplicatie
5 december 2011; Versie:1.0
Ad 6 Start de Serviceapplicatie succesvol op. Dubbelklik vervolgens op het bestand Opstarten.bat en als het goed is zal het opstartscherm van de Serviceapplicatie verschijnen.
Afbeelding 7: Hoofdmenu Service Applicatie Prima de Serviceapplicatie is met succes geïnstalleerd en is klaar voor gebruik.
Organisatie&Adviesbureau “Wilhelm Tell”
6 Van 8
Installeren Serviceapplicatie
5 december 2011; Versie:1.0
Inboeken Uren Er is heel wat aandacht besteed om het inboeken van de uren eenvoudig te maken waarbij een goede vertaling van de geboekte uren naar het ERP-pakket wordt gemaakt. Binnen het scherm urenboeken op een serviceorder kunnen gebruikers als volgt boeken.
Afbeelding 8: Scherm Inboeken Uren Per dag wordt gekozen voor een vertrektijd een aankomsttijd bij de klant een vertrektijd bij de klant en een aankomsttijd. Deze tijden worden omgezet in de gewenste urencodes en deze zijn: Vertrektijd – Aankomstklant
Reistijd
Aankomstklant – Vertrektijd
Werktijd
Vertrektijd – Aankomst
Reistijd
Tabel 3: Vertaling tijden in uurcode soorten Binnen uw ERP-pakket kan voor reistijd een andere uurcode worden gekozen dan de werktijd en de Serviceapplicatie kan dan ook als zodanig worden geconfigureerd. Het urenboeken zet de geboekte tijden om in een vast rooster waarbij kan worden aangegeven op welk tijdstip het rooster dient te beginnen en te eindigen voor de normale uren. Zo kan er bijvoorbeeld standaard gewerkt worden van 07.30 tot en met 16.00. Aan deze uren kan afhankelijk van de gekozen activiteit (Reistijd/Werktijd) een unieke uurcode worden gehangen voor het gewone werk. Vervolgens kan voor 1 pauzeperiode binnen de standaard werktijd worden gekozen. In deze periode boekt de applicatie geen werktijd, omdat wordt aangenomen dat men pauze heeft. Zo zou bijvoorbeeld de periode tussen 12.00 en 12.30 als pauzetijd worden geconfigureerd. Op dat moment wordt de tijd van urenregels welke binnen deze periode vallen niet meegerekend als werktijd. Tevens zijn er andere urencodes in te stellen afhankelijk van de extra afwijkende tijd dat een Organisatie&Adviesbureau “Wilhelm Tell”
7 Van 8
Installeren Serviceapplicatie
5 december 2011; Versie:1.0
medewerker boekt. De volgende extra urencodes zijn mogelijk, namelijk; Uurcode voor zondagen
Aparte uurcode voor het werk op zondagen
Twee uurcodes voor het werk op zaterdagen waarbij een tijdstip kan worden aangegeven dat deze gebruik maakt van een andere uurcode
Bijvoorbeeld voor een tijdstip uurcode x en na een tijdstip uurcode y.
Uurcode voor overwerk
Aparte uurcode voor het overwerk welke binnen een bepaalde tijdsduur valt
Uurcode voor extra overwerk na een tijdsperiode Een aparte uurcode voor het overwerk welke na van overwerken. een bepaalde tijdsduur valt Tabel 4: Extra mogelijke uurcodes voor het boeken van tijden Afhankelijk van de gemaakte boeking binnen de Serviceapplicatie zal deze in de gewenste uurcodes worden uitgesplitst en aan het gekoppelde ERP-pakket worden aangeboden. Na het verwerken binnen het ERP-pakket zal de Serviceapplicatie verder geen gegevens meer van de boekingen vasthouden. U kunt echter ook besluiten deze verrekening over te slaan en deze binnen uw ERP-pakket te laten uitvoeren, hetgeen eenvoudiger en eenduidiger zou kunnen zijn, indien uw pakket deze verrekening goed ondersteunt of u dit goed heeft ingeregeld. Dit zou in principe eenvoudiger kunnen zijn.
Organisatie&Adviesbureau “Wilhelm Tell”
8 Van 8