Η Αναφορά χρήσης API περιγράφει ένα σύνολο παραπομπών από ένα σύνολο δεσμών προς άλλο σύνολο δεσμών. Μπορείτε να χρησιμοποιήσετε την Εργασία Ant χρήσης API για να δημιουργήσετε μια αναφορά. Παρέχεται ένα περιβάλλον χρήστη για τη ρύθμιση και τη δημιουργία μιας αναφοράς στο πλαίσιο διαλόγου Εξωτερικά εργαλεία. Για να δημιουργήσετε ένα νέο σύνολο ρυθμίσεων ανίχνευσης χρήσης απλά πατήστε δύο φορές στο είδος συνόλου ρυθμίσεων Αναφορά χρήσης API.
Η καρτέλα Αναφορά χρήσης API επιτρέπει τη ρύθμιση της ανάλυσης.
Το ακόλουθο παράδειγμα εμφανίζει ένα σύνολο ρυθμίσεων για την εξαγωγή όλων των παραπομπών προς δέσμες Eclipse σε μια εγκατάσταση εκδοχής 3.4.

| Επιλογή |
Περιγραφή |
Προεπιλογή |
|---|---|---|
| Ανάλυση | Μπορείτε να επιλέξετε τα στοιχεία που θα αναλυθούν, τα οποία είναι γραμμή βάσης API, ορισμός προορισμού ή κατάλογος δεσμών. Μπορείτε επίσης να επιλέξετε μόνο τη δημιουργία HTML για μια υπάρχουσα αναφορά. Μπορείτε να κάνετε μόνο μία επιλογή, την οποία μπορείτε να ρυθμίσετε. Αυτό σημαίνει ότι αν επιλέξετε την ανάλυση μιας γραμμής βάσης API μπορείτε να πάτε στη σελίδα προτιμήσεων γραμμής βάσης API για να τροποποιήσετε τις υπάρχουσες γραμμές βάσης. | Γραμμή βάσης API |
| Ανάλυση > Γραμμή βάσης API | Μπορείτε να επιλέξετε οποιαδήποτε γραμμή βάσης API από το σύνθετο πλαίσιο για ανάλυση | Προεπιλεγμένη γραμμή βάσης ή κενό |
| Ανάλυση > Γραμμές βάσης... | Επιτρέπει την πρόσβαση στη σελίδα προτιμήσεων Γραμμές βάσης API για τη ρύθμιση της γραμμής προς ανάλυση. | |
| Ανάλυση > Ορισμός προορισμού | Μπορείτε να επιλέξετε οποιοδήποτε ορισμό προορισμού από το σύνθετο πλαίσιο για ανάλυση | Ο ενεργός ορισμός προορισμού ή κενό |
| Ανάλυση > Προορισμοί | Επιτρέπει την πρόσβαση στη σελίδα προτιμήσεων Πλατφόρμα προορισμού για τη ρύθμιση του ορισμού προορισμού προς ανάλυση. | |
| Ανάλυση > Κατάλογος | Μπορείτε να καταχωρήσετε την απόλυτη διαδρομή ενός καταλόγου που περιέχει τις δέσμες. | κενό |
| Ανάλυση > Αναζήτηση... | Επιτρέπει την αναζήτηση ενός φακέλου δεσμών προς ανάλυση. | |
| Ανάλυση > Δημιουργία αναφοράς HTML για υπάρχουσα ανίχνευση χρήσης | Επιτρέπει τη δημιουργία μιας αναφοράς για μια υπάρχουσα ανίχνευση χωρίς να χρειαστεί να εκτελέσετε την ανάλυση ξανά. | |
| Αναζήτηση για > Παραπομπές για | Επιτρέπει τον καθορισμό του
ονόματος (ή αντίστοιχης κανονικής έκφρασης) τη δέσμης για την οποία επιθυμείτε να
δημιουργηθούν παραπομπές. Παράδειγμα: org\.eclipse.*. Σε αυτό το παράδειγμα,
δηλώνετε ότι επιθυμείτε να εμφανίζονται όλες οι παραπομπές για οποιαδήποτε δέσμη ξεκινά
με το όνομα org.eclipse.. |
κενό |
| Αναζήτηση για > Παραπομπές API | Επιτρέπει την ανίχνευση για παραπομπές API. | μη επιλεγμένο |
| Αναζήτηση για > Εσωτερικές παραπομπές | Επιτρέπει την ανίχνευση για εσωτερικές παραπομπές. | επιλεγμένο |
| Αναζήτηση για > Μη έγκυρη χρήση API | Επιτρέπει την ανίχνευση για μη έγκυρη χρήση API, π.χ. χρήση περιορισμένων μελών API. | μη επιλεγμένο |
| Αναζήτηση σε > Δέσμες που συμφωνούν με τα κριτήρια | Επιτρέπει τον καθορισμό του
ονόματος (ή αντίστοιχης κανονικής έκφρασης) των δεσμών που επιθυμείτε να ανιχνεύσετε για
παραπομπές, για παράδειγμα, από μια εμβέλεια αναζήτησης. Παράδειγμα: .*. Σε αυτό το παράδειγμα, δηλώνετε ότι επιθυμείτε να
κάνετε αναζήτηση σε όλες τις δέσμες με όνομα που συμφωνεί με την ακολουθία χαρακτήρων. Αν αφήσετε το πεδίο κενό θα επιτευχθεί το ίδιο αποτέλεσμα. |
κενό |
| Δημιουργία αναφορών > Είδος αναφοράς | Επιτρέπει την επιλογή μεταξύ δύο μορφών αναφοράς html. Αν
έχετε επιλέξει Αναφορά παραπεμπόμενων δεσμών (λειτουργίες παραγωγής), στην
αναφορά θα εμφανιστούν όλες οι δέσμες που περιέχουν τα είδη στα οποία γίνεται παραπομπή
από τις δέσμες που αναζητήθηκαν. Αν έχετε επιλέξει Αναφορά δεσμών με παραπομπές
(λειτουργίες χρήσης), η αναφορά θα οργανωθεί έτσι ώστε να εμφανίζονται όλες οι
δέσμες στην εμβέλεια αναζήτησης οι οποίες περιέχουν παραπομπές.
Κατά την εναλλαγή ειδών αναφοράς, ελέγξτε ότι οι κανονικές εκφράσεις Παραπομπές για και Δέσμες που συμφωνούν με τα κριτήρια διαθέτουν σωστές τιμές. Κατά τη χρήση μιας έκφρασης χαρακτήρων υποκατάστασης, όπως .*, σε μια ρύθμιση, για την εναλλαγή σε άλλο είδος αναφοράς συνήθως απαιτείται η μεταφορά του χαρακτήρα υποκατάστασης στην άλλη ρύθμιση προκειμένου να δημιουργηθεί η πιο χρήσιμη αναφορά. |
Αναφορά παραπεμπόμενων δεσμών (λειτουργίες παραγωγής) |
| Αναφορά > Θέση εξόδου αναφοράς | Επιτρέπει τον καθορισμό της απόλυτης διαδρομής στην οποία θα τοποθετηθούν οι δημιουργημένες αναφορές. | κενό |
| Δημιουργία αναφορών > Αναζήτηση... | Επιτρέπει την επιλογή της θέσης εξόδου των αναφορών. | |
| Δημιουργία αναφορών > Εκκαθάριση καταλόγου αναφοράς πριν από την αναφορά νέων αποτελεσμάτων | Επιτρέπει την εκκαθάριση της υπάρχουσας θέσης αναφορών XML πριν από την αναφορά αποτελεσμάτων από την ανίχνευση. Πρέπει να έχετε υπόψη ότι αυτή η επιλογή θα αφαιρέσει εντελώς τον καθορισμένο κατάλογο αναφορών (εφόσον υπάρχει), καθώς και όλους τους θυγατρικούς καταλόγους του. | μη επιλεγμένο |
| Δημιουργία αναφορών > Δημιουργία αναφορών HTML | Μετατρέπει όλα τα δεδομένα
εξόδου XML σε μορφοποιημένο κώδικα HTML και τα τοποθετεί στον κατάλογο <θέση
αναφορών>\html |
μη επιλεγμένο |
| Δημιουργία αναφορών > Εκκαθάριση θέσης αναφορών HTML | Επιτρέπει την εκκαθάριση μιας υπάρχουσας θέσης δεδομένων HTML πριν από τη δημιουργία νέων αναφορών. Πρέπει να έχετε υπόψη ότι αυτή η επιλογή θα αφαιρέσει εντελώς τον καθορισμένο κατάλογο δεδομένων HTML (εφόσον υπάρχει), καθώς και όλους τους θυγατρικούς καταλόγους του. Αυτή η επιλογή ενεργοποιείταί μόνο αν νωρίτερα επιλέξατε Δημιουργία αναφορών HTML. | μη επιλεγμένο |
| Δημιουργία αναφορών > Άνοιγμα αναφοράς κατά την ολοκλήρωση της αναζήτησης | Ανοίγει την αναφορά HTML όταν ολοκληρωθεί η ανάλυση. Αυτή η επιλογή ενεργοποιείταί μόνο αν νωρίτερα επιλέξατε Δημιουργία αναφορών HTML. | μη επιλεγμένο |
| Δημιουργία αναφορών > Περιγραφή | Επιτρέπει την καταχώρηση μιας περιγραφής για την αναφορά. | κενό |
Η καρτέλα Μοτίβα επιτρέπει τη δημιουργία μιας ποικιλίας μοτίβων κανονικών εκφράσεων για τον έλεγχο της ανάλυσης χρήσης. Υπάρχουν τρία είδη υποστηριζόμενων μοτίβων:

| Επιλογή |
Περιγραφή |
Προεπιλογή |
|---|---|---|
| Προσθήκη... | Επιτρέπει την προσθήκη ενός νέου μοτίβου. Αυτό το κουμπί θα εκκινήσει τον Οδηγό μοτίβων. | |
| Τροποποίηση | Επιτρέπει την τροποποίηση του επιλεγμένου μοτίβου. Μπορείτε να τροποποιήσετε μόνο ένα μοτίβο κάθε φορά. | |
| Αφαίρεση | Επιτρέπει την αφαίρεση των επιλεγμένων μοτίβων. Μπορείτε να αφαιρέσετε περισσότερα από ένα μοτίβα κάθε φορά. |

Σύγκριση με γραμμή βάσης API
Ρύθμιση γραμμής βάσης
