Σκοπός: Σκοπός της μελέτης είναι να παρουσιάσει τη διαδικασία εγκατάστασης αλλά και τη βασική παραμετροποίηση μιας μεθόδου της εφαρμογής. Για τα παραδείγματα της μελέτης έχει χρησιμοποιηθεί η μέθοδος _methodSample η οποία εκτελεί ένα query για την ενημέρωση του πίνακα των ειδών.

Εργαλεία:
1. Μπορεί να χρησιμοποιηθεί οποιαδήποτε εφαρμογής βασισμένη στο Pegasus ERP Startup. Δεν μπορεί να υλοποιηθεί σε μElite.
2. Τα αρχεία της Μεθόδου. Μπορείτε να κατεβάσετε το παράδειγμα της μεθόδου εδώ.

Υλοποίηση - Περιγραφή

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

Στη συνέχεια μπορείτε να ορίσετε την εκτέλεση της μεθόδου από τις [Λοιπές Δράσεις] της εφαρμογής, την επιλογή [Εκτέλεση Μεθόδου Pegasus] ή από το χρονοπρογραμματιστή.

Απο τις Λοιπές Δράσεις Της Εφαρμογής:

Μπορείτε να ορίσετε την εκτέλεση της μεθόδου από την οθόνη [Βάσεις Δεδομένων -> Δράσεις Εφαρμογής].

Από τη διαδρομή

[ToolBox-> Εργαλεία Παραμετροποίησης -> Βασικής Παραμετροποίησης -> Λοιπές Δράσεις]

δημιουργείτε μία νέα δράση με στοιχεία:

Είδος Δράσης: Επιλέγετε το είδος της δράσης, θα ορίσετε 1 - Γενικές (Από κύριες επιλογές).
Αρχείο Μεθόδου: Θα επιλέξετε το βασικό αρχείο για την εκκίνηση της μεθόδου, συνήθως είναι το _execute.peg .
Φάκελος Μεθόδου: Θα επιλέξετε το φάκελο με τα αρχεία της μεθόδου, με βαση το παραπάνω παράδειγμα θα πρέπει να ορίσετε ..\..\mymethods\_methodSample\

Πλέον μπορείτε να εκτελέσετε τη μέθοδο που δημιουργήσατε από την επιλογή

[Βάσεις Δεδομένων -> Δράσεις Εφαρμογής]

και από την οθόνη που ανοίγει το button [Γενικές Δράσεις]. Από την λίστα με τις δράσεις της εφαρμογής που ανοίγει, επιλέγετε την δράση που δημιουργήσατε παραπάνω.

Με Ελεύθερη Εκτέλεση:

Με την επιλογή [Εκτέλεση Μεθόδου Pegasus] μπορείτε να εκτελέσετε μια μέθοδο άμεσα (αφορά κυρίως μεθόδους που πρόκειται να εκτελεστούν μια φορά). Από τη διαδρομή

[Υποστήριξη -> Εκτέλεση Μεθόδου Pegasus]

θα πατήσετε συνέχεια και θα επιλέξετε το _execute.peg από τον φάκελο της μεθόδου.

Μέσω του Χρονοπρογραμματιστή των Windows:

Από το χρονοπρογραμματιστή των Windows μπορείτε να ορίσετε την μέθοδο να εκτελείτε αυτόματα σε συγκεκριμένες ώρες (π.χ κατά την έναρξη του υπολογιστή). Για την εκτέλεση της μεθόδου από το χρονοπρογραμματιστή θα δημιουργήσετε μια νέα δράση στην οποία θα ορίσετε

Προγραμμα = c:\tesae_sa\pegasus_erp_startup\pego312.exe
Ορίσματα = tesae exep00 1 _scheduler.peg ..\..\mymethods\_methodSample (όπου tesae είναι κωδικός χρήστη με το προνόμιο uti.0013, _scheduler.peg είναι το αρχείο της μεθόδου για εκτέλεση από το χρονοπρογραμματιστή και ..\..\mymethods\_methodSample είναι ο φάκελος με τα αρχεία της μεθόδου)
Εναρξη στο = c:\tesae_sa\pegasus_erp_startup\basic\_001 (όπου c:\tesae_sa\pegasus_erp_startup είναι ο φάκελος με τα αρχεία της εφαρμογής)

Σημείωση: Μπορείτε να δείτε οδηγίες για τον ορισμό εργασιών στον χρονοπρογραμματιστή των Windows στην μελέτη: https://www.tesae.gr/articles/protipes-meletes-i-efarmoges/technika-themata-efarmogon-pegasus/aftomati-ektelesi-ton-servers-tis-efarmogis-meso-chronoprogrammatisti.html

Παραμετροποίηση Μεθόδου

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

Σημείωση: Η μέθοδος εκτελεί ένα query το οποίο ενημερώνει τον πίνακα των ειδών (i00), ορίζει τον κωδικό του είδους ίσο με τον κωδικό είδους για όλα τα είδη που ισχύουν οι συνθήκες

1. Ο κωδικός του είδους δεν είναι ίσος με τον εαυτό του.
2. Η περιγραφή του είδους δεν είναι ίση με τον εαυτό της.

Ορισμός βασικών μεταβλητών μεθόδου

Αρχείο _init.peg

Στο αρχείο _init.peg μπορείτε να ορίσετε-παραμετροποιήσετε τις βασικές μεταβλητές της μεθόδου. Επίσης εδώ μπορείτε να ορίσετε και τις επιπλέον μεταβλητές που θα χρειαστείτε για την λειτουργία της.

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

Αν ο φάκελος της μεθόδου βρίσκεται στο φάκελο mymethods μέσα στα αρχεία της εφαρμογής θα ορίσετε

my_path:='..\..\mymethods\_methodSample\

Οι μεταβλητές my_date1 και my_date2 χρησιμοποιούνται ως αρχικές τιμές στα κριτήρια που εμφανίζει η μέθοδος. Μπορείτε να χρησιμοποιήσετε τη συνάρτηση date() ώστε να συμπληρωθεί αυτόματα ή ημερομηνία του συστήματος. Αν θέλετε να ορίσετε διαφορετικές ημερομηνίες ως προεπιλογές μπορεί να συμπληρώσετε τις μεταβλητές ως

my_date1:= “2023-05-15”

Εδώ θα βρείτε επίσης και μεταβλητές για την εκτέλεση της μεθόδου από το χρονοπρογραμματιστή. Στη μεταβλητή my_nowin μπορείτε να ορίσετε αν θα εμφανιστεί παράθυρο κατά την εκτέλεση της μεθόδου. Αν ορίσετε την μεταβλητή ως αληθής (my_nowin:=.t.) δεν εμφανίζεται παράθυρο ενώ αν την ορίσετε ως ψευδής (my_nowin:=.f.) θα εμφανιστεί.

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

Αρχείο my_input.peg

Στο αρχείο my_input.peg ορίζεται η οθόνη με τις μεταβλητές που θα δώσει ο χρήστης πριν την εκτέλεση της μεθόδου. Για παράδειγμα ο χρήστης μπορεί να δίνει ελάχιστη και μέγιστη ημερομηνία καταχώρησης μιας εγγραφής ώστε οι αλλαγές της μεθόδου να εκτελεστούν για συγκερκιμένες εγγραφές. 

Η μεταβλητή my_var1 δημιουργεί ένα πίνακα με τα κριτήρια που ορίζει ο χρήστης.

my_var1:={}

Για κάθε κριτήριο που θέλετε να δημιουργήσετε θα προσθέσετε και ένα επιπλέον στοιχείο στον παραπάνω πίνακα. Με τη συνάρτηση aadd μπορείτε να προσθέσετε τα κριτήρια στον πίνακα.

aadd(my_var1, {'p01', 'Ημερομηνία Από', my_date1, 'd', 10, 0} )

Για κάθε προσθήκη θα ορίσετε

1. Το όνομα για τη μεταβλητή που θα αποθηκεύση την τιμή που θα δώσει ο χρήστης (p01) μέσα σε ' .
2. Τον τίτλο που θα έχει το κριτήριο (Ημερομηνία Από) μέσα σε ' .
3. Τη μεταβλητή με την προεπιλεγμένη τιμή του κριτηρίου (my_date1).
4. Τον τύπο της μεταβλητής (d για date) μέσα σε ' .

Αρχείο help.txt

Στο αρχείο help.txt γράφετε οδηγίες που εμφανίζονται στον χρήστη.

Αρχείο my000.peg

Στο αρχείο my000.peg γίνεται η κλήση των βασικών διαδικασιών-λειτουργιών της μεθόδου. Σε περίπτωση που θέλετε η μέθοδος να εκτελεί 2 διαδικασίες μπορεί στο αρχείο να αντιγράψετε τον κώδικα

if(!nrun_stop, dopeg('...'), )

και να συμπληρώσετε στις ... το όνομα του αρχείου που θέλετε να εκτελέσετε. Στο παράδειγμά μας ο κώδικας έχει οριστεί ως 

if(!nrun_stop, dopeg('my000_01.peg'), )

και εκτελεί το αρχείο my000_01.peg.

Αρχείο my000_01.peg

Στο αρχείο my000_01.peg γίνειται η κλήση του sql query που εκτελεί η μέθοδος. Για να ορίσετε την εκτέλεση ενός νέου query που δημιουργήσατε θα πρέπει να παραμετροποιήσετε το αρχείο my000_01.peg και να ορίσετε στον κώδικά

my_str:=odbcReadCommand('sql\my000_01.sql', .t., .t.)

το όνομα του αρχείου που περιέχει το query σας.

Αρχείο my000_01.sql

Μέσα στο φάκελο sql θα βρείτε το αρχείο my000_01.sql . Το αρχείο my000_01.sql περιέχει το query που αναζητά ή τροποποιεί εγγραφές στη βάση της εφαρμογής. Αν θέλετε να αλλάξετε τις λειτουργίες της μεθόδου θα πρέπει να δημιουργήσετε και το αντίστοιχο sql query (το οποίο και θα αποθηκεύσετε σε ένα αρχείο με κατάληξη .sql ίδιο φάκελο).