Εξαγωγή λίστας δειγμάτων σε CSV

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

Στόχος

Να παράγετε ένα αρχείο CSV που περιέχει ακριβώς τα δείγματα που εμφανίζονται στη λίστα μετά την εφαρμογή των φίλτρων — για περαιτέρω επεξεργασία εκτός του LIMS.

Προϋποθέσεις

Είστε συνδεδεμένος/η χρήστης με δικαίωμα ανάγνωσης δειγμάτων (οποιοσδήποτε ρόλος με πρόσβαση στη σελίδα /samples).
Διαθέτετε εφαρμογή που ανοίγει αρχεία .csv (Excel, LibreOffice Calc, Google Sheets κ.λπ.).

Βήματα

Μεταβείτε στη σελίδα Δείγματα (/samples) από την πλαϊνή πλοήγηση.
Ανοίξτε τον πίνακα φίλτρων με το εικονίδιο φίλτρου στη γραμμή τίτλου και εφαρμόστε τα κριτήρια που θέλετε:

Εύρος ημερομηνιών παραλαβής ή λήξης (receivedDate, dueDate).
Κατάσταση δείγματος (π.χ. Παραλήφθηκε, Σε Ανάλυση, Αναλύθηκε, Σε Υπεργολαβία).
Πελάτης (επαφή — απλό σύννεφο επιλογής με αναζήτηση).
Εργαστηριακή μέθοδος, όργανο, υπεύθυνος αναλυτής, καλλιέργεια, δήμος / πόλη / τοπωνύμιο.

Προαιρετικά, χρησιμοποιήστε το πεδίο αναζήτησης ή ταξινομήστε σε μία στήλη για να περιορίσετε ή να αναδιατάξετε περαιτέρω το αποτέλεσμα. Η ταξινόμηση μεταφέρεται αυτούσια στο αρχείο CSV.
Πατήστε το εικονίδιο κατεβάσματος CSV στη γραμμή τίτλου (δίπλα στο εικονίδιο εκτύπωσης).
Ο φυλλομετρητής κατεβάζει αυτόματα ένα αρχείο με όνομα της μορφής samples-YYYYMMDD-HHmmss.csv. Ανοίξτε το με την εφαρμογή της επιλογής σας.

Οι στήλες που εξάγονται είναι αυτές που έχετε ορίσει ως ορατές μέσω της ρύθμισης στηλών — οι κρυμμένες στήλες και η στήλη ενεργειών παραλείπονται. Αν χρειάζεστε επιπλέον πεδία στην εξαγωγή, εμφανίστε τις αντίστοιχες στήλες πρώτα μέσω του διαλόγου διαμόρφωσης στηλών.

Τι συμβαίνει στο παρασκήνιο

Το κουμπί CSV καλεί τη συνάρτηση fetchAndExportCsv (libs/utils/src/lib/csv-export.ts:82), η οποία στέλνει ξανά το ερώτημα GraphQL findAllSamples με take = 0 και skip = 0 — δηλαδή ζητά όλες τις γραμμές που ταιριάζουν στα τρέχοντα φίλτρα και την τρέχουσα ταξινόμηση, χωρίς σελιδοποίηση. Η συγκεκριμένη σύνδεση γίνεται στο apps/agrometrisis/src/app/samples/sample.ts:2946 (onExportCsv()), όπου περνιούνται ως είσοδοι το gridState() (φίλτρο, στήλη ταξινόμησης, σειρά) και ο πίνακας στηλών allColumns.

Το αποτέλεσμα σειριοποιείται σε CSV απευθείας στον φυλλομετρητή: επιλέγονται οι ορατές στήλες, οι τιμές πεδίων ξεφεύγουν (" διπλασιάζονται), τα ένθετα GraphQL αντικείμενα (π.χ. contact, labMethod) αναλύονται σε αναγνώσιμη μορφή, και οι ISO ημερομηνίες συντομεύονται σε YYYY-MM-DD. Το αρχείο προθέτει (UTF-8 BOM) ώστε το Excel να διαβάζει σωστά τους ελληνικούς χαρακτήρες. Καμία αποθήκευση στον διακομιστή δεν εμπλέκεται — το αρχείο δημιουργείται και κατεβαίνει εξ ολοκλήρου μέσω Blob + URL.createObjectURL.

Συμβουλές & παρατηρήσεις

Το ερώτημα τρέχει στο σύνολο των γραμμών που ταιριάζουν στα φίλτρα — δεν περιορίζεται στην τρέχουσα σελίδα του πίνακα. Μη φοβάστε να κατεβάσετε εκατοντάδες ή χιλιάδες γραμμές με μία κίνηση.
Για πολύ μεγάλα σύνολα (π.χ. >20.000 γραμμές) προτιμήστε ένα στενότερο φίλτρο ημερομηνιών για ταχύτερη απόκριση.
Αν δείτε αλαμπουρνέζικους ελληνικούς χαρακτήρες όταν ανοίξετε το CSV στο Excel, βεβαιωθείτε ότι ανοίγετε το αρχείο μέσω File → Open (όχι διπλό κλικ σε παλαιότερες εκδόσεις) ώστε να διαβαστεί το UTF-8 BOM.
Οι στήλες ημερομηνιών εξάγονται σε ISO μορφή (YYYY-MM-DD). Το Excel τις αναγνωρίζει ως πραγματικές ημερομηνίες και επιτρέπει άμεση ταξινόμηση ή χρήση σε pivot.
Η εξαγωγή κρατά το gridState() τη στιγμή που πατάτε το εικονίδιο. Αν αλλάξετε φίλτρα στο μεταξύ, απλώς ξαναπατήστε για νέο αρχείο.
Τα ονόματα αρχείων φέρουν χρονοσφραγίδα με ακρίβεια δευτερολέπτου, οπότε διαδοχικές εξαγωγές δεν αντικαθιστούν η μία την άλλη στον φάκελο λήψεων.

Σχετικές πτυχές

Το ίδιο μοτίβο εξαγωγής CSV ισχύει σε κάθε λίστα της εφαρμογής — Επαφές, Αναλύσεις, Τιμολόγια, Όργανα, Δείγματα ελέγχου, Αποκλίσεις, CAPA, Εκπαιδεύσεις κ.λπ. Σε όλες τις σελίδες λίστας υπάρχει το ίδιο εικονίδιο CSV στη γραμμή τίτλου, ο ίδιος πίνακας φίλτρων, και η ίδια υλοποίηση μέσω exportToCsv / fetchAndExportCsv. Δείτε π.χ. το apps/agrometrisis/src/app/contacts/contact.ts:765 (onExportCsv()) ως παράλληλο παράδειγμα για επαφές. Όταν μάθετε τη ροή σε μία σελίδα, ξέρετε όλες.