Pocketbiz Android Agenda

ESPocketBiz – Agenda

Entersoft Business Suite^® | Entersoft CRM^® | Entersoft Mobile Suite^®

Τεχνικό εγχειρίδιο

Ταυτότητα

Έκδοση κειμένου 2.0

Τελ. ενημέρωση Ιούνιος 2021

Copyright

© Copyright 2011 Entersoft A.E. Με την επιφύλαξη όλων των νόμιμων δικαιωμάτων.

Δεν επιτρέπεται η αναδημοσίευση ή μετάδοση με οποιαδήποτε μορφή και για οποιοδήποτε λόγο μέρους ή όλου του παρόντος εγχειριδίου, χωρίς τη ρητή άδεια της Entersoft Α.Ε.

Όσον αφορά το περιεχόμενο του παρόντος…

• Μπορεί να μεταβληθεί οποιαδήποτε στιγμή.
• Εξυπηρετεί αποκλειστικά πληροφοριακούς σκοπούς.
• Δεν παρέχεται εγγύηση για την ύπαρξη τυχόν λαθών ή για τη λανθασμένη χρήση ή για μη επιθυμητά αποτελέσματα από τη χρήση των προτεινόμενων στο παρόν διαδικασιών.

= Agenda

Σχετικοί Πίνακες

Πίνακας	Περιγραφή	Article Type	Sync Type
tblactivities	Πίνακας για appointments	UPLOAD	PUBLIC

Γενικά

H Agenda δίνει τη δυνατότητα να προστεθούν ραντεβού με πελάτες. Για να λειτουργήσει η agenda χρειάζεται να εγκαταστήσουμε το agenda.apk και να περάσουμε τις παραμέτρους:

• Agenda
• AGENDACUSTOMERLISTXML

στον Configuration.

Υποστηρίζονται 2 τύποι ραντεβού:

• ROUTE ( δημιουργούνται από λίστα πελατών)
  • description από agendaXml
  • έχουν background color blue.
  • δεν είναι editable όταν το endtime τους είναι πριν από την current time.(με τη χρήση της παραμέτρου CheckPastRoutingAppointments)
  • Δεν μπορεί ο χρήστης να προσθέσει σε προηγουμένη ώρα.

 

• APP ( δημιουργούνται με διπλό tap στο πρόγραμμα ή πατώντας το +)
  • έχουν background color purple
  • είναι πάντα editable
  • description από subject

Αρχική οθόνη (Μηνιαία όψη)

H αρχική οθόνη που ανοίγει για την agenda έχει την παρακάτω μορφή:

Στην παραπάνω εικόνα, έχουμε τις εξής επιλογές:

1. Μηνιαίο ημερολόγιο

2. Ατζέντα με βάση τη μέρα του ημερολογίου, χωρισμένη σε ώρες

3. Λίστα πελατών για appointment

4. Η επιλεγμένη μέρα

5. Ο τρόπος με τον οποίο βλέπουμε την agenda. Στη συγκεκριμένη εικόνα βλέπουμε τη δεξιά επιλογή

6. Αντιγραφή κάποιου appointment

7. Προσθήκη ΑΡΡ ραντεβού

8. Κουμπί για διαγραφή όλων των appointments μιας μέρας, από τη συγκεκριμένη μέρα και μετά

9. Αναζήτηση πελάτη για προσθήκη ραντεβού

Appointment Αρχικής οθόνης (Μηνιαία όψη)

Πατώντας πάνω σε κάποιο ραντεβού, η οθόνη μας τροποποιείται στην παρακάτω μορφή:

Παρατηρούμε ότι η αριστερή στήλη όπου πριν βρισκόταν το ημερολόγιο, πλέον φέρει τις πληροφορίες του ραντεβού. Έτσι πλέον έχουμε τις εξής νέες επιλογές:

1. Όνομα πελάτη
2. Ημερομηνία ραντεβού
3. Ώρα έναρξης και λήξης ραντεβού
4. Θέμα ραντεβού
5. Σχόλια/περιγραφή
6. Διαγραφή συγκεκριμένου ραντεβού
7. Ακύρωση καρτέλας και επιστροφή στην προηγούμενη οθόνη
8. Ολοκλήρωση αλλαγών

Αρχική οθόνη (Εβδομαδιαία όψη)

H αρχική οθόνη για την agenda σε εβδομαδιαία όψη, έχει την παρακάτω μορφή:

Στην παραπάνω εικόνα, έχουμε τις εξής επιλογές:

1. Εύρος ημερών που εμφανίζονται

2. Ο τρόπος με τον οποίο βλέπουμε την agenda. Στη συγκεκριμένη εικόνα βλέπουμε την αριστερή επιλογή

3. Αντιγραφή κάποιου appointment

4. Προσθήκη ΑΡΡ ραντεβού

5. Κουμπί για διαγραφή όλων των appointments μιας μέρας, από τη συγκεκριμένη μέρα και μετά

6. Αναζήτηση πελάτη για προσθήκη ραντεβού

7. Λίστα πελατών

8. Ημέρες της συγκεκριμένης εβδομάδας

9. Τα ραντεβού για την συγκεκριμένη ημέρα της εβδομάδας

Appointment Αρχικής οθόνης (Εβδομαδιαία όψη)

Πατώντας πάνω σε κάποιο ραντεβού, η οθόνη μας τροποποιείται στην παρακάτω μορφή:

Παρατηρούμε ότι πλέον εμφανίζεται η οθόνη με τις πληροφορίες του συγκεκριμένου ραντεβού. Έτσι πλέον έχουμε τις εξής νέες επιλογές:

1. Όνομα πελάτη
2. Ημερομηνία ραντεβού
3. Ώρα έναρξης και λήξης ραντεβού
4. Θέμα ραντεβού
5. Σχόλια/περιγραφή
6. Διαγραφή συγκεκριμένου ραντεβού
7. Ακύρωση καρτέλας και επιστροφή στην προηγούμενη οθόνη
8. Ολοκλήρωση αλλαγών

Παράμετροι Configuration

Αυτές είναι οι παράμετροι μέσα στον configuration πίνακα που σχετίζονται με την agenda.

• Agenda

• AgendaCustomerListXML

• AgendaXML

• AlphabetReplace

• RoutingAppointments

• CheckPastRoutingAppointments

• DisableInfoDialog

Agenda(1,0)

• 1: Προσθέτει την επιλογή της agenda στο μενού.
• 0: Απενεργοποιείται η Ατζέντα.

AGENDACUSTOMERLISTXML

H AGENDACUSTOMERLISTXML είναι η παράμετρος αυτή, η οποία καθορίζει το πώς θα φαίνεται η agenda. Ένα παράδειγμα είναι το παρακάτω:

<AndroidLayout>

<sql>

<online query="exec mobGetCustomers $SLMID$,null, $LAT$, $LONG$" routequery="exec mobGetCustomers $SLMID$, $DATE$, $LAT$, $LONG$" near="(CentroidX between abs( ($LAT$) - (0.25 * 0.009)) and abs( ($LAT$) + (0.25 * 0.009))) and (CentroidY between abs( ($LONG$) - (0.25 * 0.011)) and abs( ($LONG$) + (0.25 * 0.011))) and (CUS.cusid=$CUSID$ or $CUSID$=0)" />

<offline query="SELECT cusid,cus.cusid,leename,adrstreet,adrcity,ifnull(cus.cusname, lee.leename) AS customer,cuscode || ' ' || leename || ' ' || adrstreet || '-' || adrcity AS details,IFNULL(adrcity, ) AS destadrcity,IFNULL(adrstreet, ) AS destaddress,'Κωδ:' || ifnull(cus.cuscode, ) || ' ' || 'ΑΦΜ: ' || ifnull(lee.leeafm, ) AS extrainfo,ifnull(adr.adrstreet, ) || ' ' || ifnull(adrnumber, ) || ' - ' || ifnull(adr.adrdistrict,ifnull(adr.adrcity, )) AS address,'ΤΗΛ.: ' ||ifnull(adrphone1, ) AS phone FROM CUS INNER JOIN LEE ON CUS.leeid = LEE.leeid INNER JOIN ADR ON ADR.adrid = CUS.adriddest WHERE cus.cusid NOT IN (- 1,- 2) ORDER BY leename" routequery="SELECT cus.cusid,leename,'Κωδ:'|| ifnull(cuscode, ) || ' ' || 'ΑΦΜ: ' ||ifnull(lee.leeafm, ) AS extrainfo,adriddest,IFNULL(adrstreet, ) AS destaddress,IFNULL(adrcity, ) AS destadrcity,ifnull(adr.adrstreet, ) ||' ' || ifnull(adrnumber, ) || ' - ' || ifnull(adr.adrdistrict,ifnull(adr.adrcity, )) AS address,'ΤΗΛ.: ' ||ifnull(adrphone1, ) AS phone,adrzipcode AS destadrzipcode,adr.centroidx AS coordsx,adr.centroidy AS coordsy,CASE WHEN EXISTS (SELECT visited FROM tblVisits WHERE cusid = CUS.cusid AND DATE (starttime) = $TODAY$)THEN 1 ELSE 0 END AS visited FROM CUS INNER JOIN LEE ON CUS.leeid = LEE.leeid INNER JOIN ADR ON ADR.adrid = CUS.adriddest INNER JOIN tblroutescheduledlines ON tblroutescheduledlines.cusid = cus.cusid WHERE tblroutescheduledlines.slmid = $SLMID$ AND strftime('%Y-%m-%d 00:00:00',scheduleddate) = $DATE$ AND $LEENAME$ AND $CUSCODE$ ORDER BY leename" near="" />

</sql>

<columns>

<column minWidth="300" position="1">

<row datamember='customer' textsize='16' color='#0a4879' useInSearch='true'/>

<row datamember='extrainfo' textsize='12' color='#000000' useInSearch='true'/>

<row datamember='address' textsize='12' color='#000000' useInSearch='true'/>

<row datamember='phone' textsize='12' color='#000000' useInSearch='true'/>

</column >

</columns>

</AndroidLayout>

Απαραίτητα πεδία στο SQL ερώτημα για να καταφέρει να παίξει η agenda είναι το leename, το οποίο εμφανίζεται στο παράθυρο με τις πληροφορίες του ραντεβού

(Εικ: 1.2.2 & 1.2.4 πεδίο:1)

Επίσης απαραίτητο πεδίο είναι και το details στο οποίο ορίζεται ένα σύνολο πεδίων, του οποίου οι πληροφορίες, εμφανίζονται στην τοποθέτηση κάποιου ραντεβού ή γενικά στα ραντεβού στη μεσαία στήλη.

(Εικ: 1.2.1 & 1.2.3 πεδίο:2 & 9 αντίστοιχα)

Φυσικά απαραίτητο πεδίο είναι και το cusid για τη σύνδεση με τον πελάτη.

1.3.3 FILTERS

Για να εισαχθεί το φίλτρο τύπου BOOLEAN πρέπει στο table Configuration στην row AgentaCustomerListXML (Υπενθυμίζουμε ο τρόπος εισαγωγής είναι παρόμοιος με τον τρόπο εισαγωγής φίλτρου στο CustomerListXML) να βάλουμε το εξής:

TAG <filters>:

INNER TAGS: Every filter shows an additional filter for searching replaced in the select. OPTIONAL

<filter>:

• caption: the name that will appear as a description of the filter. REQUIRED

• replacetoken: The token that will be replaced in sql $ ... $ from what you will write the user. REQUIRED

• includefieldname: values - "0" or "1". REQUIRED

  • If "1" then the criterion is manufactured using this fieldname as follows: {fieldname} = {user value}. If "1" and the user leave the criterion blank then the token is replaced with 1 = 1, otherwise with {fieldname} = {user value}.

  • If "0" then the criterion be replaced directly with the value put the user, without having to add field name. If the user leaves it blank then the token is replaced with blank.

• fieldname: the name of the field which will replace in sql. REQUIRED (if

• includefieldname=1)

• fieldtype: BOOLEAN (In case True the replaced values is(1=1), in case False(1=0) )

Παράδειγμα χρήσης BOOLEAN filter

<filters>

<filter caption="Δ.Ο.Υ" replacetoken="$TXOID$" fieldname="lee.txoid" includefieldname="1" fieldtype="BOOLEAN" SQL="select txoname as displayvalue,txoid as storevalue from txo order by txoname"/>

</filters>

agendaXML

Η παράμετρος του Configuration agendaXML καθορίζει την μορφοποίηση των ραντεβού μέσα στο calendar. Τo πεδίo DefaultDuration μέσα στο xml καθορίζει το χρόνο σε λεπτά για το ραντεβού που θα προστεθεί. Επίσης το deleteButton πεδίο, καθορίζει αν θα φαίνεται το κουμπί της διαγραφής όλων των ραντεβού μίας μέρας. Η διαγραφή των ραντεβού γίνεται αλλάζοντας το πεδίο IsDeleted του tblactivities σε 1. Αυτό σημαίνει ότι στο publication πρέπει να υπάρχει πρόβλεψη ώστε να σβήνονται τα ραντεβού με isdeleted =1 και στο server να υπάρχει μια περιοδική με εκτέλεση του sql script, ώστε να μη διατηρούνται «σκουπίδια» στον tblactivities:

DELETE FROM tblactivities WHERE isdeleted=1

Το default XML έχει αυτή τη μορφή:

<AndroidLayout>

                <sql>

<online appointmentdescr="cuscode+' '+leename||' '||adrstreet||'-'||adrcity" />

<offline appointmentdescr="cuscode||' '||leename||' '||adrstreet||'-'||adrcity" />                </sql>

                <defaultDuration durationTime="30"/>

                <deleteButton enabled="true"/>

</AndroidLayout>

Επίσης, το πλήκτρο για την διαγραφή δεν είναι άμεσα εμφανές, αλλά βρίσκεται στο 3 dots menu του ActionBar, όπως φαίνεται στην παρακάτω εικόνα.

ALPHABETREPLACE(1,0)

• 1: Ψάχνει στην παράμετρο και αντικαθιστά, π.χ. το α με [Αα], ώστε να μη γίνεται διάκριση πεζών και κεφαλαίων ή αν η λέξη είναι τονισμένη ή όχι.
• 0: Γίνεται διάκριση μεταξύ πεζών και κεφαλαίων. Επίσης, έχει σημασία εάν η λέξη περιέχει τόνο.

NEW WAY ALPHABETREPLACE

Με την βοήθεια της παραμέτρου στο configtable EnableUserAlphabetReplacement όταν το configValue = 1

Τότε όπου βάλουμε και σε όποιο σημείο επιθυμούμε το ΤΟΚΕΝ $ALPHABET_REPLACEMENT$(προσοχή στην σύνταξη) μέσα στο xml τότε θα γίνει η αντικατάσταση του με το ALPHABETREPLACE .

Με configValue = 0 ή αν δεν υπάρχει η τιμή στο configtable τότε ισχύει ο παλιός τρόπος αντικατάστασης.

RoutingAppointments (1,0)

• 1: Μέσα από ένα ραντεβού, πατώντας πάνω στο όνομα του πελάτη, στην αριστερή στήλη, θα μεταφερθούμε σε αυτόν, ώστε να μπορέσουμε να ξεκινήσουμε την επίσκεψη.
• 0: Απενεργοποιείται η παραπάνω λειτουργία.

Για την έναρξη επίσκεψης, στο onclick στο appointment info στο colored label το πρόγραμμα πηγαίνει στα details του regardingCusId απο tblActivities.

Κατά την έναρξη επίσκεψης στο insert στον tblVisits ενημερώνεται και το inRoute με τιμη = 2 (για δρομολόγιο). Κατά τη λήξη της επίσκεψης εκτελείται update στον tblActivities, set completed = 1 .

CheckPastRoutingAppointments (1,0)

• 1: Κάνει έλεγχο ώστε τα appointments να μην είναι editable εάν η ώρα λήξης τους είναι μικρότερη από την τωρινή ώρα. Έτσι αποτρέπει κάποιον από το να επεξεργαστεί ένα appointment που έχει παρέλθει.
• 0: Ο χρήστης μπορεί να επεξεργαστεί τα ραντεβού, οποιαδήποτε στιγμή.

DisableinfoDialog (1,0)

Έχει ισχύ, όταν η agenda είναι σε week mode, δηλαδή όταν στην αριστερή στήλη, δεν φαίνεται το ημερολόγιο, αλλά οι ημέρες της εβδομάδας.

• 1: Το appointment από το customer list εισάγεται στην πρώτη ελεύθερη ώρα μετρά τις 8.00 χωρίς να ανοίγει το appointment info dialog.

• 0: Βάζοντας ένα appointment, ανοίγει το appointment Info dialog και η ώρα είναι αυτόματα στις 9.00.

Απαραίτητοι πίνακες & πεδία

• tblVisits
  • ActivityID unique id String : the id of the Route appointment which relates with the current visit
  • InRoute Integer : on start visit from agenda we set inRoute = 2
• tblActivities
  • PeriodId : Integer
  • Completed : Integer : on finish visit we set completed = 1
• tblWeeks
  • PeriodId : Integer
  • WeekEndDate String
  • WeekId Integer
  • WeekName String : the display String
  • WeekStartDate

tblWeeks

O tblWeeks πίνακας χρησιμοποιείται σε εγκαταστάσεις όπου παίζουν με περιόδους. Έτσι υπάρχει το λεκτικό P1W1, το οποίο συμβολίζει την πρώτη βδομάδα της πρώτης περιόδου και πάει λέγοντας.

Παρακάτω φαίνεται η επιρροή του πίνακα:

Στην Αρχική οθόνη της agenda, στην ενημέρωση της ημερομηνίας, προστίθεται η περιόδος και η βδομάδα της tblWeeks.WeekName.

• tblWeeks.WeekStartDate: ορίζεται η αρχή της κάθε εβδομάδας
• tblWeeks.WeekEndDate: ορίζεται το τέλος της κάθε εβδομάδας
• tblWeeks.PeriodID: join του tblWeeks με τον tblPeriods

Η χρήση του tblweeks είναι για ενημερωτικούς σκοπούς. Εάν η εφαρμογή τον εντοπίσει, τότε προσθέτει αυτό το την τιμή του tblWeeks.WeekName σαν λεκτικό, διαφορετικά συνεχίζει με την default όψη.

Πράγματα που πρέπει να προσέξουμε

1. Να ορίσουμε στον srArticles τον tblActivities να είναι Upload.

2. O tblActivities να περιλαμβάνει τα columns:

   1. activityTypeCode

   2. Subject

   3. RegardingCUSID

   4. FromSLMID

   5. ActualStart

   6. ActualEnd

   7. ActualDurationMinutes

   8. CreatedOn

3. Στην agenda εμφανίζονται μόνο τα activities που έχουν ActivityTypeCode='APP'

4. Στο select που τρέχουμε πρέπει οπωσδήποτε να θέσουμε αυτό που μας ενδιαφέρει as details γιατί είναι και αυτό που εμφανίζεται μέσα στο ραντεβού πάνω στο ημερολόγιο. Στο συγκεκριμένο script θέσαμε το leename as details.

Weather Forecast

Η πρόβλεψη του καιρού γίνεται με βάση την ημερά και ώρα που γίνεται το appointment. Δεν προβλέπεται ο καιρός όταν το appointment γίνει πέραν των πέντε ημερών με αρχή την τρέχων μέρα.

Για να προστεθεί ο καιρός πρέπει στο Configuration table στη γραμμή AGENDACUSTOMERLISTXML να προστεθούν οι παράμετροι

• ifnull(adr.CentroidX, ) AS coordsx, ifnull(adr.CentroidY, ) AS coordsy (Αυστηρά όπως είναι γραμμένες) στο offlinequery.

Και στον πίνακα configuration στην στήλη configcode την τιμή weatherapikey και στην στήλη configvalue την τιμή το api key του πελάτη.

Δοκιμαστικό κλειδί 8acecfddfebc6aad6a02af4cab9b64b6 (Μετά τις 40 κλήσεις κλειδώνει).

Για αγορά του κλειδιού δείτε τον οδηγό -Pocketbiz Android - Αγορά κλειδιού για το Weather Forecast-

New Agenda

H Agenda από την έκδοση 6.0.170613(1710)-132e3ba υποστηρίζει εναλλακτικό layout, του οποίου η σημαντικότερη διαφορά από την προηγούμενη έκδοση είναι ότι υποστηρίζει κατακόρυφο προσανατολισμό (portrait).

Επίσης σημαντικό είναι το γεγονός ότι οποιοδήποτε feature αναφέρεται από εδώ και πέρα, αφορά αποκλειστικά την Νέα Agenda, καθώς στην παλιά Agenda δε γίνεται development παρά μόνο bug fixing.

Διαφορές από την παλιά Agenda

Αρχικά, η νέα Agenda έχει σχεδιαστεί για να υποστηρίζει και τους δύο προσανατολισμούς (κατακόρυφος – portrait και οριζόντιος – landscape). Στα πλαίσια του επανασχεδιασμού, το ημερολόγιο που φαίνεται στο αριστερό μέρος της παλιάς Agenda δεν φαίνεται συνέχεια στη νέα Agenda, αλλά εμφανίζεται πατώντας στο πεδίο που αναφέρει την ημερομηνία της επιλεγμένης ημέρας ή τις ημερομηνίες της επιλεγμένης εβδομάδας.

Πρόσθετη λειτουργικότητα

Στη νέα Agenda υποστηρίζονται οι παρακάτω λειτουργίες

Επιλογή ραντεβού από το χρήστη (έκδοση > 8.14)

Ο χρήστης επιλέγει μεταξύ 2 τρόπων λειτουργίας. Στον πρώτο (παλιά λειτουργικότητα που εξακολουθεί να ισχύει) δεν επιλέγει συγκεκριμένα ραντεβού. Σε αυτό το mode, η ενέργεια που επιλέγει ο χρήστης ενεργεί σε όλα τα ορατά ραντεβού, δηλαδή αυτά της ημέρας στην ημερήσια όψη (day view) και αυτά της εβδομάδας στην εβδομαδιαία όψη (week view).

Με το mode επιλογής ραντεβού, ο χρήστης επιλέγει ραντεβού από τα ορατά με αποτέλεσμα η ενέργεια που θα επιλέξει να επηρεάσει τα επιλεγμένα ραντεβού.

Η επιλογή του mode γίνεται από το μενού με τις ακόλουθες επιλογές:

• Select Mode ON ( ), η οποία δηλώνει ότι η λειτουργία επιλογής από το χρήστη είναι ενεργοποιημένη.
• Select Mode OFF ( ), η οποία δηλώνει ότι η λειτουργία επιλογής από το χρήστη είναι απενεργοποιημένη (ο παλιός τρόπος λειτουργίας).

Αντιγραφή ραντεβού (έκδοση > 6.0.170613(1710)-132e3ba)

Ο χρήστης μπορεί να αντιγράψει ραντεβού από μια ημερομηνία (ή εβδομάδα) σε μια άλλη. Η διαδικασία ξεκινάει με την επιλογή των ραντεβού προς αντιγραφή. Κατόπιν επιλέγεται η Αντιγραφή από το μενού. Ανοίγει ένα popup στο οποίο ο χρήστης επιλέγει την ημερομηνία στην οποία θα αντιγραφούν τα ραντεβού. Πατώντας ΟΚ στο παράθυρο αυτό εκτελείται η αντιγραφή.

Στην περίπτωση εβδομαδιαίας όψης, το παράθυρο με το ημερολόγια εξακολουθεί να δείχνει ημερομηνίες ανά ημέρα. Η αντιγραφή θα γίνει στη εβδομάδα στην οποία ανήκει η επιλεγμένη ημερομηνία.

Από την έκδοση 8.14 και πάνω, η παρουσία της επιλογής αντιγραφής ελέγχεται από το AgendaXML, όπως ακριβώς ελέγχεται η επιλογή της διαγραφής, προσθέτοντας το node <copyButton enabled="true/false"/>. Σε περίπτωση απουσίας του node, η επιλογή της αντιγραφής είναι ενεργή, για λόγους backwards compatibility.

Μετακίνηση ραντεβού (έκδοση > 8.14)

Ο χρήστης μπορεί πλέον να μετακινήσει ραντεβού από μια ημερομηνία σε μια άλλη. Η διαδικασία είναι όμοια με την αντιγραφή των ραντεβού.

Από την έκδοση 8.14 και πάνω, η παρουσία της επιλογής μετακίνησης ελέγχεται από το AgendaXML, όπως ακριβώς ελέγχεται η επιλογή της διαγραφής, προσθέτοντας το node <moveButton enabled="true/false"/>. Σε περίπτωση απουσίας του node, η επιλογή της μετακίνησης είναι ενεργή, για λόγους backwards compatibility.

PDF Version