Handleiding Notificatie

Transcriptie

1 Handleiding Notificatie TimeTell versie 8 TIMETELL BV Willem de Bijelaan KV Voorburg info@timetell.nl Helpdesk helpdesk@timetell.nl

2 Inhoud 1. Inleiding notificatie notificatie... 4 Standaard notificatie bewerken notificatie definitie... 8 Nieuwe notificatie definitie aanmaken Algemeen De SQL tabbladen Rapport tab De tabbladen Parameters tab Rapporten inplannen Ingeplande rapporten beheren Handleiding Notificatie 2/24 Versie 25 april 2018

3 1. Inleiding Deze handleiding is bedoeld voor de functionele applicatiebeheerders die de applicatie TimeTell beheren, of in de toekomst gaan beheren. Voor alle functionaliteiten in deze handleiding, is de module nodig. Deze module biedt twee mogelijkheden. Enerzijds kunnen met notificaties massaal berichten verzonden worden aan groepen medewerkers o.b.v. criteria. Anderzijds is het voor medewerkers mogelijk om rapporten zelf in te plannen om deze periodiek te ontvangen per . Om s te kunnen versturen moet dit eerst worden geconfigureerd op de TimeTell server. Dit staat beschreven in de Handleiding Technische Opzet. Tip: Wanneer dit plaatje getoond wordt staat er een handigheid beschreven die het werken met TimeTell nog makkelijker maakt. Handleiding Notificatie 3/24 Versie 25 april 2018

4 2. notificatie Dit hoofdstuk behandelt de mogelijkheid om massaal berichten te sturen aan individuele medewerkers. notificatie De notificaties zijn te vinden via menu Beheer, , notificatie. Dit onderdeel maakt het mogelijk om automatisch berichten te laten verzenden door de TimeTell applicatieserver, op basis van bepaalde criteria. Er wordt standaard een aantal definities meegeleverd (in de lijst zijn deze lichtgrijs gekleurd en ze zijn onderdeel van de TimeTell groep) m.b.t. achterstanden van het tijdschrijven en de goed te keuren boekingen/weken. Deze standaard definities kunnen niet inhoudelijk worden gewijzigd. Wanneer en aan wie ze gestuurd worden kan wel worden aangepast. Het is echter ook mogelijk om eigen definities toe te voegen met eigen criteria. Zo zou er bijvoorbeeld een gestuurd kunnen worden naar een projectleider als de realisatie-uren meer bedragen dan het projectbudget. Zie hiervoor verderop in deze handleiding. Handleiding Notificatie 4/24 Versie 25 april 2018

5 Standaard notificatie bewerken Handleiding Notificatie 5/24 Versie 25 april 2018

6 Bij selectie van een standaard notificatie definitie (bijv. Weken achterstand lijst voor Manager ) kan aangegeven worden of het bericht aan Iedereen moet worden verzonden of aan specifieke medewerkers. Wanneer, bij de optie Verzender aan de optie Team/organisatie gekozen wordt, worden berichten niet aan alle medewerkers verzonden. De berichten worden dan alleen verzonden aan medewerkers die of op het tabblad Team zijn toegevoegd of die gekoppeld zijn aan een organisatiedeel, dat op het tabblad Organisatie is aangeven. Hierbij wordt tevens rekening gehouden met de datum van het uitvoeren van de definitie en de periode waarin de medewerker aan het betreffende organisatiedeel is gekoppeld. Wanneer er gekozen wordt voor het Team/Organisatie, worden er twee tabbladen toegevoegd. Onder de Tabbladen Team en Organisatie kan worden aangeven wie de notificatie moet ontvangen. Op het tabblad 'Team' kunnen individuele medewerkers worden opgevoerd. Handleiding Notificatie 6/24 Versie 25 april 2018

7 Op het tabblad 'Organisatie' kunnen afdelingen worden toegevoegd. Alle medewerkers die gekoppeld zijn aan deze afdelingen worden meegenomen in de notificatie. Dit werkt ook voor maatwerk definities, die verderop beschreven worden. Handleiding Notificatie 7/24 Versie 25 april 2018

8 notificatie definitie Indien er periodiek een notificatie verstuurd gaat worden, dan kan dit in een batch (1 of meerdere opdrachten) draaien. Zet Taak volgorde op 1 (of hoger) en vul de rest van de opties in. Een notificatie kan handmatig worden uitgevoerd, maar het is ook mogelijk om een notificatie automatisch te draaien, via de TimeTell Scheduler. Hiervoor moet de taak Controleer status notificatie worden aangezet en ingesteld op de juiste interval. Dit kan worden gedaan via menu Beheer, Scheduler. Bij het starten van de taak, wordt dan gekeken naar de taakgegevens bij de notificatie: Taak volgorde Als notificaties afhankelijk van elkaar zijn, dan kan met de Taak volgorde de gewenste volgorde van uitvoeren worden ingesteld. Als deze de waarde 0 heeft dan wordt deze notificatie niet automatisch gestart. NB. Het is dan nog wel mogelijk om de notificatie handmatig uit te voeren. Taak interval per Geef hier de gewenste interval op. Bijvoorbeeld iedere 5 minuten of 1 keer per dag. Taak ingepland Hier staat de datum/tijd waarop de eerstvolgende notificatie wordt uitgevoerd. Als u alle (of een aantal) notificatie met dezelfde regelmaat wilt laten draaien, bijvoorbeeld een keer per dag op hetzelfde tijdstip, dan hoeft u niet per notificatie de tijd en interval in te stellen. Stel dan de taak Controleer status notificatie in op de gewenste tijd en interval, in dit voorbeeld één keer per dag. Zet bij de notificaties de Taak interval op Iedere draai. Iedere keer als de taak Controleer status notificatie wordt uitgevoerd, zullen deze notificatie in de opgegeven taak volgorde worden uitgevoerd. Bij de velden Mail sturen en Mail sturen aan kan worden opgegeven wanneer er een bericht met de resultaten moet worden verzonden, bijvoorbeeld wanneer er foutmeldingen waren, en naar welke adressen deze moet worden verzonden. Handleiding Notificatie 8/24 Versie 25 april 2018

9 NB. Deze werkwijze is alleen mogelijk wanneer een SMTP Host is opgegeven in de TTData.ini. Zie de handleiding Technische opzet voor meer informatie. NB. Dit bericht is niet hetzelfde als de notificatie, maar alleen een resultaat log van de verwerking. Handleiding Notificatie 9/24 Versie 25 april 2018

10 Onder tabblad kan de opmaak, middels de tabbladen Koptekst, Detailtekst en Voettekst van de bekeken worden. Handleiding Notificatie 10/24 Versie 25 april 2018

11 Via de knop Uitvoeren kan een notificatie handmatig gedraaid worden. Hierna verschijnt een preview van de notificatie: Van hieruit kunnen de berichten desgewenst ook worden verzonden met. Hierbij kan gekozen worden voor Lokaal of via Server. Wanneer wordt gekozen voor Lokaal, dan worden de berichten verzonden via het programma op de eigen PC. Wanneer wordt gekozen voor via Server, dan worden de berichten verzonden via de server, net zoals dat gebeurt wanneer berichten automatisch worden verzonden. Handleiding Notificatie 11/24 Versie 25 april 2018

12 Via de knop Onbezorgbaar kan worden nagegaan of bepaalde berichten onbezorgbaar zouden zijn. Er wordt dan gekeken welke medewerkers het bericht zouden ontvangen en voor wie daarvan geen adres bekend is in TimeTell. Handleiding Notificatie 12/24 Versie 25 april 2018

13 Nieuwe notificatie definitie aanmaken Algemeen Voor het samenstellen van de definities (met name de drie SQL tabbladen) is redelijk wat kennis van de SQL taal en van het TimeTell datamodel nodig. Doorgaans zullen deze definities dan ook in overleg met de klant door een van onze consultants worden gemaakt en opgeleverd. Wanneer voldoende kennis van de SQL taal en het TimeTell datamodel aanwezig is, kunnen definities door de klant zelf gemaakt worden. Op definities, die door de klant zelf zijn gemaakt, wordt geen onderhoud of ondersteuning geboden. Naast de standaard notificatie definities, kunnen ook eigen definities worden toegevoegd: De werking van de tabbladen 'Algemeen', 'Team' en 'Organisatie' is identiek aan die van de standaard berichten. De overige tabbladen worden hierna beschreven. In het voorbeeld maken we gebruik van een definitie waarmee een TimeTell rapport wordt meegestuurd als bijlage voor de ontvanger. Handleiding Notificatie 13/24 Versie 25 april 2018

14 De SQL tabbladen De berichten kunnen worden verzonden op basis van zelf in te stellen criteria, bijvoorbeeld wanneer de realisatie het budget dreigt te overschrijden of heeft overschreden (bijv. bij een projectbudget). Onder Tabblad Items SQL worden de items opgehaald voor de notificatie, bijv. de budget regels die overschreven zijn. Onder Tabblad Ontvanger(s) SQL worden de ontvangers opgehaald voor iedere in deze notificatie, bijv. de project manager van het betreffende project. Handleiding Notificatie 14/24 Versie 25 april 2018

15 Onder Tabblad Details SQL worden de gegevens opgehaald voor iedere in deze notificatie. Dit kunnen meer detail gegevens zijn, dan op het Items SQL tabblad, bijv. specifieke project / budget gegevens ter info voor de project manager. De uit de query s opgehaalde gegevens kunnen vervolgens worden gebruikt om de verder op te maken ( Gegevens/Variabelen via rechter muisklik kopiëren/plakken). Voor een werkend voorbeeld, zie de standaard definities. Deze kunnen worden gekopieerd met Ctrl-C of worden geëxporteerd (via menu 'Bewerk opties', 'Wegschrijven') en weer geïmporteerd (via menu 'Bewerk opties', 'Inlezen'), waardoor het maatwerk definities worden. Deze kunnen volledig worden aangepast of als voorbeeld worden gebruikt om de werking te verduidelijken. De verschillende tabbladen kunnen, door gebruik te maken van parameters, aan elkaar gekoppeld worden. Wanneer een veld op het Items SQL tabblad gebruikt wordt, kan dat op het Ontvanger(s) SQL en Details SQL tabbladen als parameter worden gebruikt. Voorbeeld: Op het tabblad Items SQL worden de veld tt_emp_id, tt_fromdate en tt_todate gebruikt. Deze zijn vervolgens op Ontvanger(s) SQL en Details SQL te gebruiken als [TT_EMP_ID;<integer>], [TT_FROMDATE;<date>] en [TT_TODATE;<date>]. Hierbij wordt rekening gehouden met eventuele veld aliassen (bijv. select tt_emp_id as EmpID wordt herkend als [EMPID;<integer>]). NB. Informatie kan alleen van het tabblad Items SQL worden doorgegeven naar de tabbladen Ontvanger(s) SQL en Details SQL. De overige tabbladen geven geen informatie door aan de andere SQL tabbladen. NB. Vergeet niet om het type veld door te geven, dus <integer>, <date>, etc. Bijv.: [EMPID] en [TT_FROMDATE] zijn onvoldoende, gebruik altijd [EMPID;<integer>] resp [TT_FROMDATE;<date>], afhankelijk van de types van de velden. Handleiding Notificatie 15/24 Versie 25 april 2018

16 Rapport tab Vanaf versie 8.6 is het mogelijk om een rapport als bijlage mee te sturen. In deze pagina kan een TimeTell rapport (geen dynamisch rapport) worden gekozen en een verbinding gemaakt worden tussen de rapport parameters en de gegevens uit de Details SQL. Via deze opzet kunnen automatisch mails worden verzonden naar meerdere ontvangers, waarbij de rapportages alleen de relevante gegevens bevatten. Een standaard definitie die wordt meegeleverd stuurt bijvoorbeeld alle projecturen voor een specifiek project naar de klant contactpersoon voor dit project. Handleiding Notificatie 16/24 Versie 25 april 2018

17 De tabbladen Bij maatwerk notificaties is het mogelijk om, naast de selectie criteria, ook de tekst van de berichten aan te passen. Hierbij eventueel gebruik gemaakt kan worden van bepaalde HTML opmaak codes (tags) voor Vet (bold = <b>test</b> => tekst), Schuin (italic <i>tekst</i> => tekst) of Onderstrepen (underline = <u>tekst</u> => tekst). Deze kunnen ook worden gecombineerd (bijv. <b><i>tekst</i></b> => tekst) NB. De HTML tags worden door TimeTell alleen afgehandeld, wanneer het bericht via de applicatie server wordt verzonden. Wanneer het bericht lokaal getest wordt, zullen de HTML tags worden genegeerd. In het veld Onderwerp kan het onderwerp worden gezet, dat ieder bericht zal hebben. Hier kan gebruik gemaakt worden van de parameters die op het Parameters tabblad en de drie SQL tabbladen zijn gebruikt. Het sub-tabblad Koptekst wordt eenmalig aan het bericht toegevoegd aan het begin en kan worden gebruikt om een soort inleiding aan het bericht te geven. Het sub-tabblad Detailtekst bevat, voor iedere regel uit het Details SQL tabblad, een regel. Hier kan gebruik gemaakt worden van alle velden, die in het Details SQL tabblad worden opgehaald. Handleiding Notificatie 17/24 Versie 25 april 2018

18 NB. Alleen de velden uit het Details SQL tabblad zijn bruikbaar in tabblad, de velden uit de overige tabbladen zijn daar niet toegankelijk. Het sub-tabblad Voettekst heeft soortgelijke functie als het sub-tabblad Koptekst. Deze wordt slechts eenmaal per bericht ingevoegd, maar dan aan het einde. Tip: Wanneer een definitie bijna voldoet aan uw wensen, kunt deze eenvoudig kopiëren, zoals in dit voorbeeld ook is gedaan. Dat kan gedaan worden door de definitie te selecteren en dan op de <Ctrl>+C toetsten op het toetsenbord te drukken. Handleiding Notificatie 18/24 Versie 25 april 2018

19 Parameters tab Hierin kunnen de parameters worden gedefinieerd die door alle drie de SQL statement gebruikt kunnen worden. Handleiding Notificatie 19/24 Versie 25 april 2018

20 Rapporten inplannen Medewerkers kunnen rapporten inplannen via de rapport verkenner. Deze kunnen ze vinden via menu Rapporten, 'Rapport verkenner'. Zij krijgen dan alleen de rapporten te zien, waartoe zij het recht hebben deze af te drukken/op te vragen. Rapporten kunnen dus ook alleen worden ingepland door medewerkers, die deze ook mogen afdrukken. Voor ieder rapport hebben zij de optie om het rapport af te drukken (rechtsklik 'Afdrukken') of om het rapport in te plannen (rechtsklik 'Inplannen'). Als zij voor 'Inplannen' kiezen, krijgen zij een overzicht van alle ingeplande rapporten te zien. In dit scherm kan een rapport worden toegevoegd met een planning. Dan verschijnt het onderstaande scherm. Hier kan worden opgegeven wanneer en hoe vaak het rapport moet worden verzonden. Ook kan worden opgegeven aan welk adres het rapport verzonden moet worden. Handleiding Notificatie 20/24 Versie 25 april 2018

21 Het is mogelijk om een zelfde rapport met verschillende parameters in te plannen (eventueel ook voor een andere medewerker). Als u het rapport tijdelijk wil uitzetten, kunt u het vinkje Actief bovenin uitvinken. De rapport parameters kunnen ingesteld worden met behulp van de parameters knop. Bij het kiezen van parameters (selectie criteria) gelden dezelfde rechten als bij het afdrukken. Handleiding Notificatie 21/24 Versie 25 april 2018

22 N.B.: De beschikbare parameters zijn hetzelfde als bij het draaien van het rapport. Tip: Als een datum moet worden opgegeven in het rapport parameterscherm kan hier ook gekozen worden voor speciale datum variabelen in de keuzelijst zoals <lastmonthstart> en <lastmonthend>. Zo wordt het rapport automatisch gedraaid over de afgelopen maand. Handleiding Notificatie 22/24 Versie 25 april 2018

23 Ingeplande rapporten beheren Beheerders hebben toegang tot alle ingeplande rapporten. Via menu Beheer, Ingeplande rapporten kunnen de ingeplande rapporten door de beheerder worden bekeken, bewerkt en/of verwijderd (indien geautoriseerd). Hier worden alle ingeplande rapporten getoond, gegroepeerd op de medewerker die ze heeft ingepland. Handleiding Notificatie 23/24 Versie 25 april 2018

24 Door een regel te openen (via menu 'Bewerk opties', 'Openen'), wordt bovenstaande scherm getoond. Hier kunnen de instellingen van het ingeplande rapport worden aangepast. Hier kan worden gewijzigd of het rapport inderdaad verzonden moet worden (vinkje 'Actief'), vanaf wanneer en hoe vaak het rapport moet draaien. Ook kan worden aangepast aan welk adres het rapport verzonden moet worden. Als laatste optie is er ook de mogelijkheid om een gepland rapport uit de lijst te verwijderen. NB. Het rapport blijft nog gewoon bestaan en onaangepast, enkel de planning voor het versturen ervan wordt aangepast/verwijderd. Tevens kunnen de rapport parameters (die bepalen welke gegevens er worden opgehaald) worden gewijzigd. Er zal dan een scherm getoond worden, zoals dat ook wordt getoond wanneer het rapport "normaal" (handmatig) wordt uitgevoerd. Handleiding Notificatie 24/24 Versie 25 april 2018