Δοκιμαστική τεκμηρίωση στη δοκιμή λογισμικού (Παράδειγμα)

Τι είναι η τεκμηρίωση δοκιμής;

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

👉 Εγγραφείτε για Δωρεάν Ζωντανό Έργο Δοκιμών Λογισμικού

Γιατί υπάρχει η ανάγκη για τυπικότητα στις εξετάσεις;

Για έναν αρχάριο, είναι εύκολο να υποθέσει ότι οι δοκιμές είναι η εκτέλεση των διαφόρων τμημάτων του κώδικα σε ad-hoc βάση και η επαλήθευση των αποτελεσμάτων. Αλλά στον πραγματικό κόσμο, οι δοκιμές είναι μια πολύ επίσημη δραστηριότητα και τεκμηριώνονται λεπτομερώς. Η τεκμηρίωση των δοκιμών καθιστά τον σχεδιασμό, την αναθεώρηση και την εκτέλεση των δοκιμών εύκολη, καθώς και επαληθεύσιμη.

Ο βαθμός τυπικότητας της εξέτασης εξαρτάται από:

• Ο τύπος της εφαρμογής υπό δοκιμή (AUT).
• Πρότυπα που ακολουθεί ο οργανισμός σας.
• Η ωριμότητα της αναπτυξιακής διαδικασίας.

Οι δοκιμαστικές δραστηριότητες συνήθως καταναλώνουν μεταξύ 30% και 50% της συνολικής προσπάθειας ανάπτυξης λογισμικού. Η τεκμηρίωση βοηθά στον εντοπισμό βελτίωσης της διαδικασίας δοκιμών που μπορεί να εφαρμοστεί σε μελλοντικά έργα.

Ποιοι είναι οι τύποι τεκμηρίωσης δοκιμών;

Ακολουθούν οι σημαντικοί τύποι τεκμηρίωσης δοκιμών:

«Στην πράξη, αυτά τα έγγραφα δημιουργούνται σε διαφορετικά στάδια — από τον πρώιμο σχεδιασμό (πολιτική δοκιμών, στρατηγική) έως την εκτέλεση και το κλείσιμο (αναφορές ελαττωμάτων και συνοπτικές αναφορές).»

Τύποι Εγγράφων Δοκιμών	Περιγραφή
Πολιτική δοκιμής	Είναι ένα έγγραφο υψηλού επιπέδου που περιγράφει αρχές, μεθόδους και όλους τους σημαντικούς στόχους δοκιμών του οργανισμού.
Στρατηγική δοκιμής	Ένα έγγραφο υψηλού επιπέδου που προσδιορίζει τα επίπεδα δοκιμών (τύπους) που θα εκτελεστούν για το έργο.
Σχέδιο δοκιμής	Ένα σχέδιο δοκιμών είναι ένα πλήρες έγγραφο σχεδιασμού που περιέχει το πεδίο εφαρμογής, την προσέγγιση, τους πόρους, το χρονοδιάγραμμα κ.λπ. των δραστηριοτήτων δοκιμών.
Απαιτήσεις ιχνηλασιμότητας μήτρα	Αυτό είναι ένα έγγραφο που συνδέει τις απαιτήσεις με τις δοκιμαστικές περιπτώσεις.
Σενάριο δοκιμής	Σενάριο δοκιμής είναι ένα στοιχείο ή συμβάν ενός συστήματος λογισμικού που θα μπορούσε να επαληθευτεί από μία ή περισσότερες περιπτώσεις δοκιμών.
Δοκιμαστική θήκη	Είναι μια ομάδα τιμών εισόδου, προϋποθέσεων εκτέλεσης, αναμενόμενων μετασυνθηκών εκτέλεσης και αποτελεσμάτων. Αναπτύχθηκε για ένα Σενάριο Δοκιμής.
Δεδομένα δοκιμής	Τα δεδομένα δοκιμής είναι δεδομένα που υπάρχουν πριν από την εκτέλεση μιας δοκιμής. Χρησιμοποιούνται για την εκτέλεση της δοκιμαστικής περίπτωσης.
Αναφορά ελαττώματος	Μια αναφορά ελαττώματος είναι μια τεκμηριωμένη αναφορά οποιουδήποτε ελαττώματος σε ένα σύστημα λογισμικού που δεν εκτελεί την αναμενόμενη λειτουργία του.
Συνοπτική έκθεση δοκιμής	Η συνοπτική αναφορά δοκιμής είναι ένα έγγραφο υψηλού επιπέδου που συνοψίζει τις δραστηριότητες δοκιμών που διεξήχθησαν καθώς και τα αποτελέσματα των δοκιμών.

Ποιες είναι οι καλύτερες πρακτικές για την επίτευξη τεκμηρίωσης δοκιμών;

Σε αυτήν την ενότητα, θα μάθουμε για τις βέλτιστες πρακτικές που βοηθούν στην επίτευξη τεκμηρίωσης δοκιμών με παραδείγματα που θα σας βοηθήσουν να την κατανοήσετε καλύτερα:

• Συμμετοχή της Διασφάλισης Ποιότητας (QA) στα αρχικά στάδια του έργου: Συμπεριλάβετε την ομάδα διασφάλισης ποιότητας από την αρχή του έργου, ώστε η τεκμηρίωση των δοκιμών να αναπτύσσεται παράλληλα με τον σχεδιασμό και τις απαιτήσεις του προϊόντος.
  Παράδειγμα: Ο υπεύθυνος διασφάλισης ποιότητας (QA) συνεργάζεται κατά τον σχεδιασμό του sprint για να συντάξει τις αρχικές περιπτώσεις δοκιμών με βάση τις ιστορίες των χρηστών.
• Διατηρήστε τα έγγραφα ενημερωμένα: Μην δημιουργείτε απλώς δοκιμαστικά έγγραφα και τα ξεχνάτε — ενημερώνετέ τα κάθε φορά που αλλάζουν οι απαιτήσεις ή οι λειτουργίες.
  Παράδειγμα: Όταν αλλάξει ένα API σύνδεσης, ενημερώστε αμέσως τις σχετικές περιπτώσεις δοκιμών και τα αποτελέσματα.
• Χρήση ελέγχου έκδοσης: Διαχειριστείτε και παρακολουθήστε όλες τις αλλαγές στα έγγραφα δοκιμής μέσω συστημάτων ελέγχου εκδόσεων για να αποφύγετε τη σύγχυση και την απώλεια δεδομένων.
  Παράδειγμα: Αποθηκεύστε τα σχέδια δοκιμών στο GitHub για να διατηρήσετε ένα σαφές ιστορικό εκδόσεων και επιλογές επαναφοράς.
• Έγγραφο για λόγους σαφήνειας και σκοπού: Καταγράψτε μόνο ό,τι βοηθά εσάς και τα ενδιαφερόμενα μέρη να κατανοήσετε την πρόοδο των δοκιμών και τα παραδοτέα.
  Παράδειγμα: Συμπεριλάβετε συνοπτικές αναφορές δοκιμών που επισημαίνουν τις περιπτώσεις δοκιμών που πέρασαν με επιτυχία, που απέτυχαν και που αποκλείστηκαν για έλεγχο από τη διοίκηση.
• Χρησιμοποιήστε τυπικά πρότυπα: Ακολουθήστε μια συνεπή μορφή — όπως πρότυπα Excel ή Word — για να διευκολύνετε τη δημιουργία και την αναθεώρηση της τεκμηρίωσης.
  Παράδειγμα: Χρησιμοποιήστε ένα τυπικό "Πρότυπο Δοκιμαστικής Περίπτωσης" με πεδία για αναγνωριστικό, περιγραφή, προϋποθέσεις και αναμενόμενα αποτελέσματα.
• Κεντρική αποθήκευση εγγράφων: Φυλάξτε όλα τα έγγραφα που σχετίζονται με το έργο σε ένα προσβάσιμο σημείο, ώστε τα μέλη της ομάδας να μπορούν να τα ανατρέχουν ή να τα ενημερώνουν εύκολα.
  Παράδειγμα: Αποθηκεύστε τα αντικείμενα δοκιμής σε κοινόχρηστο Google Drive φάκελος προσβάσιμος σε ολόκληρη την ομάδα διασφάλισης ποιότητας και ανάπτυξης.
• Συμπεριλάβετε επαρκείς λεπτομέρειες: Αποφύγετε τις αόριστες ή ελλιπείς πληροφορίες. Η λεπτομερής τεκμηρίωση βελτιώνει την κατανόηση και μειώνει τα σφάλματα κατά την εκτέλεση των δοκιμών.
  Παράδειγμα: Αντί για "Έλεγχος σύνδεσης", γράψτε "Η επαλήθευση σύνδεσης χρήστη με έγκυρα διαπιστευτήρια ανακατευθύνει με επιτυχία στον πίνακα ελέγχου".

Πότε πρέπει να δημιουργείτε τεκμηρίωση δοκιμών για δοκιμές λογισμικού;

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

• Φάση προγραμματισμού: Πριν από την έναρξη της εκτέλεσης των δοκιμών, να καθοριστεί με σαφήνεια το πεδίο εφαρμογής, οι στόχοι και η στρατηγική δοκιμών.
• Προετοιμασία δοκιμής: Κατά τον σχεδιασμό των δοκιμών, να καθοριστούν αποτελεσματικά χρονοδιαγράμματα, πόροι και απαιτήσεις περιβάλλοντος.
• Ανάλυση απαιτήσεων: Μετά την ανάλυση των απαιτήσεων, για να διασφαλιστεί η πλήρης κάλυψη των λειτουργικών και μη λειτουργικών προδιαγραφών.
• Τυποποίηση Σχεδιασμού: Πριν από τον σχεδιασμό δοκιμαστικών περιπτώσεων, να τυποποιηθούν οι μορφές και να διατηρηθεί η ιχνηλασιμότητα σε όλα τα έγγραφα.
• Τεκμηρίωση Σεναρίου: Κατά τον σχεδιασμό των δοκιμών, για την καταγραφή σεναρίων, εισροών, αναμενόμενων εξόδων και λεπτομερειών δεδομένων δοκιμών.
• Ετοιμότητα εκτέλεσης: Πριν από την εκτέλεση της δοκιμής, για να επαληθευτεί η ετοιμότητα του περιβάλλοντος δοκιμής, των εργαλείων και της ακρίβειας της τεκμηρίωσης.
• Αξιολόγηση μετά την ολοκλήρωση: Μετά τις δοκιμές, για την καταγραφή των αποτελεσμάτων, των ελαττωμάτων και των διδαγμάτων που αντλήθηκαν για τη βελτίωση της διαδικασίας.

Ποιοι τύποι προτύπων απαιτούνται για την τεκμηρίωση δοκιμών;

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

Όνομα προτύπου	Εργαλεία
Πρότυπο σχεδίου δοκιμής	Microsoft Word, Google Docs ή Confluence για συνεργατική επεξεργασία και έλεγχο έκδοσης
Πρότυπο δοκιμαστικής υπόθεσης	TestRail, Zephyr (σε JIRA), Xray ή Excel/Google Sheets για δομημένη διαχείριση δοκιμών
Πρότυπο σεναρίου δοκιμής	JIRA, TestLink ή Google Sheets για την τεκμηρίωση συνθηκών δοκιμών υψηλού επιπέδου
Πρότυπο Πίνακα Ιχνηλασιμότητας Απαιτήσεων (RTM)	Excel, Google Sheets ή TestRail για αντιστοίχιση απαιτήσεων σε δοκιμαστικές περιπτώσεις
Πρότυπο αναφοράς ελαττώματος	JIRA, Bugzilla ή Azure DevOps για καταγραφή και παρακολούθηση ελαττωμάτων
Πρότυπο αναφοράς περίληψης δοκιμής	Συμβολή, Google Docs ή TestRail για τη σύνταξη αποτελεσμάτων δοκιμών και ανάλυσης

Πλεονεκτήματα και μειονεκτήματα της τεκμηρίωσης δοκιμών

Πλεονεκτήματα

• Ο κύριος λόγος δημιουργίας τεκμηρίωσης δοκιμών είναι είτε η μείωση είτε η εξάλειψη τυχόν αβεβαιοτήτων σχετικά με τις δραστηριότητες δοκιμών. Βοηθά στην εξάλειψη της ασάφειας, η οποία συχνά προκύπτει όταν πρόκειται για την κατανομή των εργασιών.
• Η τεκμηρίωση δεν προσφέρει μόνο μια συστηματική προσέγγιση δοκιμές λογισμικού, αλλά λειτουργεί επίσης ως εκπαιδευτικό υλικό για φρέσκια στη διαδικασία δοκιμής λογισμικού.
• Χρησιμεύει ως μια καλή στρατηγική μάρκετινγκ και πωλήσεων για την παρουσίαση της τεκμηρίωσης των δοκιμών, ώστε να παρουσιάζεται μια ώριμη διαδικασία δοκιμών.
• Η τεκμηρίωση δοκιμών σάς βοηθά να προσφέρετε ένα ποιοτικό προϊόν στον πελάτη εντός συγκεκριμένων χρονικών ορίων.
• In Τεχνολογία Λογισμικού, η τεκμηρίωση δοκιμών βοηθά επίσης στη διαμόρφωση ή την εγκατάσταση του προγράμματος μέσω του εγγράφου διαμόρφωσης και των εγχειριδίων χειριστή.
• Η τεκμηρίωση δοκιμών σάς βοηθά να βελτιώσετε τη διαφάνεια με τον πελάτη.

Μειονεκτήματα

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

Συνηθισμένα λάθη που πρέπει να αποφεύγονται στην τεκμηρίωση των δοκιμών

Ακολουθούν τα πιο συνηθισμένα λάθη που πρέπει να αποφύγετε σε μια τεκμηρίωση δοκιμών:

1. Αποφύγετε τη σύνταξη ασαφών ή διφορούμενων περιγραφών δοκιμαστικών περιπτώσεων.
2. Μην παραλείπετε την τεκμηρίωση των προϋποθέσεων και των εξαρτήσεων των δοκιμών.
3. Μην ξεχνάτε ποτέ να συμπεριλάβετε τα αναμενόμενα αποτελέσματα για κάθε δοκιμή.
4. Αποφύγετε την ασυνεπή μορφοποίηση σε διαφορετικά έγγραφα δοκιμών.
5. Μην χρησιμοποιείτε αόριστους ή μη μετρήσιμους στόχους δοκιμών.
6. Μην παραλείπετε ποτέ τον έλεγχο έκδοσης για ενημερώσεις τεκμηρίωσης δοκιμών.
7. Αποφύγετε την αντιγραφή πληροφοριών σε πολλαπλά αντικείμενα δοκιμών.
8. Μην παραμελείτε την εξέταση της τεκμηρίωσης για την ακρίβεια και την πληρότητά της.

Συχνές Ερωτήσεις