Function GetExtLogEntries
Αναζήτηση Log Συγχρονισμού
Η συνάρτηση αυτή επιστρέφει Log
Συγχρονισμού σύμφωνα με τις παραμέτρους
που έγινε η κλήση.
Η κλήση μπορεί να γίνει μέσω της παρακάτω
διεύθυνσης με τη μέθοδο GET και
route_api_name = ext_log_entries :
https://mm.sch.gr/api/ext_log_entries
Ορισμός Τύπου και Πεδίου Ταξινόμησης Αποτελεσμάτων
- Μέσω των παραμέτρων Πεδίο Ταξινόμησης ($orderby) και Τύπος Ταξινόμησης ($ordertype) μπορεί να καθοριστεί το πεδίο και η σειρά ταξινόμησης.
- Προκαθορισμένη τιμή πεδίου ταξινόμησης είναι η αύξουσα σειρά ASC.
- Προκαθορισμένη τιμή τύπου ταξινόμησης είναι το ID του Log Συγχρονισμού.
Ορισμός Αριθμού Σελίδας και Εγγραφών/Σελίδα της Επιστροφής Αποτελεσμάτων
- Μέσω των παραμέτρων Αριθμός Σελίδας ($page) και Αριθμός Εγγραφών/Σελίδα ($pagesize) μπορεί να καθοριστεί ο αριθμός Σελίδας και Εγγραφών/Σελίδα της επιστροφής αποτελεσμάτων.
- Ο προκαθορισμένος αριθμός Εγγραφών/Σελίδα που επιστρέφονται ανά κλήση είναι 0.
- Ο προκαθορισμένος αριθμός Σελίδας που επιστρέφεται ανά κλήση είναι 1.
Ορισμός Τύπου Αναζήτησης Αποτελεσμάτων
- Μέσω των παραμέτρων Τύπου Αναζήτησης ($searchtype) μπορεί να καθοριστεί μπορεί να καθοριστεί ο τρόπος με τον οποίο θα αναζητηθεί η τιμή της παραμέτρου στο DNS της Μονάδας.
- Ισχύει για όσες παραμέτρους το υποστηρίζουν το συνδυασμό με την παράμετρο searchtype.
- Προκαθορισμένη τιμή τύπου αναζήτησης είναι CONTAINALL.
Πίνακας Παραμέτρων
- Στον Πίνακα Παραμέτρων Parameters summary εμφανίζονται όλοι οι παράμετροι με τους οποίους μπορεί να γίνει η κλήση της συνάρτησης.
- Όλοι οι παράμετροι είναι προαιρετικοί εκτός από αυτές που έχουν χαρακτηριστεί ως υποχρεωτικοί.
- Οι παράμετροι μπορούν να χρησιμοποιηθούν με οποιαδήποτε σειρά.
- Οι παράμετροι οι οποίοι έχουν το χαρακτηριστικό (Συνδυάζεται με την παράμετρο searchtype) σημαίνει ότι η συγκεκριμένη παράμετρος συνδυάζεται με την παράμετρο searchtype.
- Οι παράμετροι μπορούν να πάρουν τιμή "NULL" για να αναζητήσουν τις κενές εγγραφές στα αντίστοιχα πεδία
Πίνακας Αποτελεσμάτων
- Στον Πίνακα Αποτελεσμάτων Return value summary εμφανίζονται οι μεταβλητές που επιστρέφει η συνάρτηση.
- Όλες οι μεταβλητές επιστρέφονται σε JSON objects.
- Η μεταβλητή data είναι ο πίνακας με τα δεδομένα.
- Η μεταβλητή status καθορίζει αν η εκτέλεση της συνάρτησης ήταν επιτυχής (κωδικός 200) ή προέκυψε κάποιο σφάλμα.
Πίνακας Σφαλμάτων
- Στον Πίνακα Σφαλμάτων Thrown exceptions summary εμφανίζονται τα Μηνύματα Σφαλμάτων που μπορεί να προκύψουν κατά την κλήση της συνάρτησης.
- Οι περιγραφές των Σφαλμάτων καθώς και οι
Κωδικοί τους είναι διαθέσιμες μέσω του
πίνακα Μηνύματα Σφαλμάτων (
ExceptionMessages
) και Κωδικοί Σφαλμάτων (ExceptionCodes
) αντίστοιχα.
Παραδείγματα Κλήσης
- Υπάρχουν διαθέσιμα παραδείγματα κλήσης
της συνάρτησης με διάφορους τρόπους (
ApiRequestExamples
).
Μηνύματα Authentication/Authorization
- Υπάρχουν αναλυτικές πληροφορίες για τα
μηνύματα Authentication/Authorization (
AuthMessages
).
Μηνύματα Προκαθορισμένων Παραμέτρων
- Υπάρχουν αναλυτικές πληροφορίες για τα
μηνύματα Προκαθορισμένων Παραμέτρων (
StandarParamsMessages
).
Δεδομένα Επιστροφής
Παρακάτω εμφανίζονται τα
αποτελέσματα σε μορφή JSON :
{ "data": [{}], "controller": "GetExtLogEntries", "function": "ext_log_entries", "method": "GET", "total": ``, "count": ``, "pagination": { "page": 1, "maxPage": 1, "pagesize": 200}, "status": 200, "message": "[GET][ext_log_entries]:success" }
Πίνακας Δεδομένων
Παρακάτω εμφανίζεται ένα δείγμα
από τον πίνακα data με τα αποτελέσματα σε
μορφή JSON :
{"data": [{ "id": ``, "action": ``, "logged_at": ``, "object_id": ``, "object_class": ``, "version": ``, "data": ``, "username": ``, "ip": `` }] }
integer |
$id |
ID Log Συγχρονισμού Ο Κωδικός ID Log Συγχρονισμού Η τιμή της παραμέτρου μπορεί να είναι : integer|array[integer]
|
mixed |
$action |
Ενέργεια Συγχρονισμού Η Ενέργεια του Log Συγχρονισμού Η τιμή της παραμέτρου μπορεί να είναι : mixed{string|array[string]}
|
string |
$logged_at |
Ημερομηνία Log Συγχρονισμου Η Ημερομηνία του Log Συγχρονισμου Συνδυάζεται με την παράμετρο datesearchtype Λίστα Τύπων Αναζήτησης Ημερομηνίας : ($datesearchtype) Η τιμή της παραμέτρου μπορεί να είναι : string|null|array[string|null]
|
integer |
$object_id |
Κωδικός ΜΜ Ο Κωδικός ΜΜ του Log Συγχρονισμου Η τιμή της παραμέτρου μπορεί να είναι : integer|array[integer]
|
mixed |
$object_class |
Όνομα Πίνακα Το Όνομα Πίνακα του Log Συγχρονισμου Η τιμή της παραμέτρου μπορεί να είναι : mixed{string|array[string]}
|
integer |
$version |
Έκδοση Η Έκδοση του Log Συγχρονισμού Η τιμή της παραμέτρου μπορεί να είναι : integer|array[integer]
|
mixed |
$username |
Όνομα Χρήστη Το Όνομα του Χρήστη του Log Συγχρονισμού Η τιμή της παραμέτρου μπορεί να είναι : mixed{string|null|array[string|null]}
|
mixed |
$ip |
IP Xρήστη Η IP του Xρήστη του Log Συγχρονισμού Η τιμή της παραμέτρου μπορεί να είναι : mixed{string|null|array[string|null]}
|
integer |
$pagesize |
Αριθμός Εγγραφών/Σελίδα Ο αριθμός των εγγραφών που θα επιστρέψουν ανα σελίδα Η παράμετρος δεν είναι υποχρεωτική Αν η παράμετρος δεν έχει τιμή τότε θα επιστραφούν όλες οι προκαθορισμένες εγγραφές ( Parameters::DefaultPageSize )Λίστα Παραμέτρων Σελιδοποίησης : Parameters Η τιμή της παραμέτρου μπορεί να είναι : integer
|
integer |
$page |
Αριθμός Σελίδας Ο αριθμός της σελίδας με τις $pagesize εγγραφές που βρέθηκαν σύμφωμα με τις παραμέτρους Η παράμετρος δεν είναι υποχρεωτική Αν η παράμετρος δεν έχει τιμή τότε θα επιστραφεί η πρώτη σελίδα Λίστα Παραμέτρων Σελίδας : Parameters Η τιμή της παραμέτρου μπορεί να είναι : integer
|
string |
$orderby |
Πεδίο Ταξινόμησης Το όνομα του πεδίου με το οποίο γίνεται η ταξινόμηση των εγγραφών Η παράμετρος δεν είναι υποχρεωτική Αν η παράμετρος δεν έχει τιμή τότε η ταξινόμηση γίνεται με το ID του Log Συγχρονισμού Η τιμή της παραμέτρου μπορεί να είναι : string
|
string |
$ordertype |
Τύπος Ταξινόμησης Ο τύπος ταξινόμησης με τον οποίο γίνεται η ταξινόμηση των εγγραφών Η παράμετρος δεν είναι υποχρεωτική Αν η παράμετρος δεν έχει τιμή τότε η ταξινόμηση γίνεται με Αύξουσα Σειρά ( OrderEnumTypes::ASC )Λίστα Τύπων Ταξινόμησης : OrderEnumTypes Η τιμή της παραμέτρου μπορεί να είναι : string
|
string |
$searchtype |
Τύπος Αναζήτησης Ο Τύπος Αναζήτησης με τον οποίο γίνεται η αναζήτηση στα πεδία Η παράμετρος δεν είναι υποχρεωτική Αν η παράμετρος δεν έχει τιμή τότε η αναζήτηση στα πεδία αυτά γίνεται με τον Τύπο SearchEnumTypes::ContainAll Λίστα Τύπων Αναζήτησης : SearchEnumTypes Η τιμή της παραμέτρου μπορεί να είναι : string
|
string |
$datesearchtype |
Τύπος Αναζήτησης Ημερομηνίας Ο Τύπος Αναζήτησης Ημερομηνίας με τον οποίο γίνεται η αναζήτηση στα πεδία
Η παράμετρος δεν είναι υποχρεωτική Αν η παράμετρος δεν έχει τιμή τότε η αναζήτηση στα πεδία αυτά γίνεται με τον Τύπο {exact} Λίστα Τύπων Αναζήτησης : {contain|greater|lower} Η τιμή της παραμέτρου μπορεί να είναι : string
|
Objects<JSON>
|
Επιστρέφει τα παρακάτω JSON objects : array : data : Ο Πίνακας με τα δεδομένα
string : controller : Ο controller που χρησιμοποιείται string : function : Η συνάρτηση που υλοποιείται από το σύστημα string : method : Η μέθοδος κλήσης της συνάρτησης integer : total : Το πλήθος των εγγραφών χωρίς τις παραμέτρους σελιδοποίησης integer : count : Το πλήθος των εγγραφών της κλήσης σύμφωνα με τις παραμέτρους σελιδοποίησης array : pagination : Οι παράμετροι σελιδοποίησης των εγγραφών της κλήσης
integer : status : Ο Κωδικός του αποτελέσματος της κλήσης string : message : Το Μήνυμα του αποτελέσματος της κλήσης |