Πριν ξεκινήσετε
Τι χρειάζεστε
- Τη λειτουργία Connections στον χώρο εργασίας σας: περιλαμβάνεται στα πακέτα Team, Business, Partner και Enterprise, και ως πρόσθετη λειτουργία Integrations for one UAT με το πακέτο Project.
- Δικαιώματα διαχειριστή στο έργο του UAT Studio.
- Έναν λογαριασμό Make. Το δωρεάν πακέτο αρκεί.
Ρύθμιση · μία φορά ανά έργο
Συνδέστε το UAT Studio με το Make
1
Δημιουργήστε ένα API key στο UAT Studio
- Συνδεθείτε στο app.uat.studio, ανοίξτε το έργο και μεταβείτε στο Setup.
- Στην κάρτα API keys, πληκτρολογήστε ένα όνομα, π.χ. Make, και κάντε κλικ στο Create API key.
- Κάντε κλικ στο Copy. Το UAT Studio εμφανίζει το κλειδί μόνο μία φορά· κρατήστε το παράθυρο ανοιχτό μέχρι να το επικολλήσετε.
2
Προσθέστε ένα HTTP module σε ένα σενάριο
- Στο Make, κάντε κλικ στο Create a new scenario και στο μεγάλο +.
- Αναζητήστε το HTTP και επιλέξτε Make a request.
Έρχεται εφαρμογή UAT Studio για το MakeΜέχρι τότε το HTTP module κάνει το ίδιο. Όταν η εφαρμογή είναι διαθέσιμη, επιλέγετε το UAT Studio και επικολλάτε το ίδιο API key.
3
Συμπληρώστε το αίτημα
Συμπληρώστε τα πεδία του Make a request από πάνω προς τα κάτω. Αφήστε όπως είναι τα πεδία που δεν υπάρχουν στον πίνακα.
| Πεδίο | Τι συμπληρώνετε |
|---|---|
| Authentication type | No authentication. Το κλειδί μπαίνει στην κεφαλίδα παρακάτω. |
| URL | https://app.uat.studio/api/v1/issues?order=created ή άλλη διεύθυνση από τον παρακάτω πίνακα. |
| Method | GET για ανάγνωση, POST για δημιουργία, PATCH για αλλαγή. |
| Headers | Κάντε κλικ στο Add a header. Name: Authorization. Value: Bearer, ένα κενό και το API key σας. |
| Query parameters | Αφήστε το κενό. |
| Body content type | Για ανάγνωση (GET): αφήστε το κενό. Για δημιουργία ή αλλαγή: application/json. |
| Body input method | Μόνο για δημιουργία ή αλλαγή: JSON string. |
| Body content | Μόνο για δημιουργία ή αλλαγή: τα πεδία ως JSON, για παράδειγμα {"title": "Save fails", "severity": "High"}. |
| Parse response | Yes, ώστε τα επόμενα modules να μπορούν να χρησιμοποιούν τα πεδία των ζητημάτων. |
| Pagination type | Αφήστε το κενό. |
Κάντε κλικ στο Save.
4
Εκτελέστε το και ορίστε το χρονοδιάγραμμα
- Κάντε κλικ στο Run once. Η έξοδος δείχνει τα ζητήματα του έργου σας.
- Προσθέστε τα επόμενα modules: έναν Iterator στη λίστα ζητημάτων, ένα Filter (για παράδειγμα σοβαρότητα Critical) και την εφαρμογή που πρέπει να ενεργήσει, π.χ. Slack ή Google Sheets.
- Για να ενεργείτε μόνο σε νέα ζητήματα, προσθέστε
&since=με την ώρα της προηγούμενης εκτέλεσης ή χρησιμοποιήστε το Data store του Make για να θυμάστε τα κλειδιά που έχετε ήδη χειριστεί. - Ορίστε το χρονοδιάγραμμα (για παράδειγμα κάθε 15 λεπτά) και ενεργοποιήστε το σενάριο.
Τι μπορείτε να χρησιμοποιήσετε · https://app.uat.studio/api/v1
Οι διευθύνσεις του API
| Είδος | Αίτημα | Τι κάνει |
|---|---|---|
| Ανάγνωση | GET /issues?order=created | Τα πιο πρόσφατα ζητήματα. order=updated: αυτά που άλλαξαν τελευταία. Επίσης since, status και limit (έως 100). |
| Ανάγνωση | GET /issues/ISS-012 | Ένα ζήτημα. |
| Ανάγνωση | GET /signoffs | Οι εγκρίσεις, οι πιο πρόσφατες πρώτα. |
| Δημιουργία | POST /issues | Ένα νέο ζήτημα: title και προαιρετικά description, severity, priority, test_number, step_number, assignee. |
| Αλλαγή | PATCH /issues/ISS-012 | status, severity ή assignee, με προαιρετικό comment. |
| Αλλαγή | POST /issues/ISS-012/comments | Ένα comment στο ιστορικό. |
| Δημιουργία | POST /testers | Ένας δοκιμαστής: name και προαιρετικά email και group. |
Κάθε ζήτημα συνοδεύεται από το κλειδί του (ISS-012), τον τίτλο, την περιγραφή, τη σοβαρότητα, την προτεραιότητα, την κατάσταση, τον υπεύθυνο, τη δοκιμή και τον δοκιμαστή που το βρήκε, το ticket σε Jira ή Azure DevOps και έναν σύνδεσμο προς το UAT Studio.
Ιδέες
Τι φτιάχνουν οι ομάδες με αυτό
- Ένα μήνυμα για κάθε ζήτημα Critical σε ένα κανάλι συνομιλίας, με φίλτρο σοβαρότητας.
- Κάθε έγκριση σε ένα υπολογιστικό φύλλο ή στο εργαλείο χαρτοφυλακίου έργων σας, ώστε η διευθύνουσα επιτροπή να βλέπει ποια UAT έχουν γίνει αποδεκτά.
- Δοκιμαστές από μια φόρμα ή το σύστημα HR σας: μια νέα γραμμή γίνεται δοκιμαστής στη σωστή ομάδα.
- Ζητήματα από ένα εργαλείο υποστήριξης: ένα ticket με μια ετικέτα γίνεται ζήτημα στο UAT, συνδεδεμένο με τη δοκιμή του.
Αν κάτι πάει στραβά
Συνήθη μηνύματα
| Μήνυμα | Τι να κάνετε |
|---|---|
| Το API key δεν είναι έγκυρο | Το κλειδί ανακλήθηκε ή πληκτρολογήθηκε λάθος. Δημιουργήστε νέο κλειδί στο Setup › API keys και συνδεθείτε ξανά. |
| Οι συνδέσεις … δεν περιλαμβάνονται στο πακέτο | Ο χώρος εργασίας δεν έχει τη λειτουργία Connections. Προσθέστε τη στο Plan & billing. |
| Αυτός ο χώρος εργασίας είναι μόνο για ανάγνωση | Το πακέτο έχει λήξει. Η ανάγνωση εξακολουθεί να λειτουργεί· η δημιουργία και η αλλαγή όχι. |
| Δεν υπάρχει ζήτημα ISS-… | Το κλειδί ανήκει σε άλλο έργο ή το ζήτημα συγχωνεύθηκε. Ελέγξτε το API key και το κλειδί του ζητήματος. |
| Δεν συμβαίνει τίποτα μετά από ένα νέο ζήτημα | Το σενάριο εκτελείται σύμφωνα με το χρονοδιάγραμμά του. Ελέγξτε ότι είναι ενεργοποιημένο και ότι το κλειδί ανήκει στο σωστό έργο. |
Ασφάλεια
Πώς προστατεύεται το κλειδί
- Ένα κλειδί δίνει πρόσβαση σε ένα έργο, σε τίποτε άλλο στον χώρο εργασίας σας.
- Το UAT Studio αποθηκεύει μόνο ένα αποτύπωμα του κλειδιού, ποτέ το ίδιο το κλειδί. Το Setup δείχνει τους τέσσερις τελευταίους χαρακτήρες και πότε χρησιμοποιήθηκε τελευταία φορά.
- Το Revoke στο Setup απενεργοποιεί ένα κλειδί αμέσως.
- Κάθε ζήτημα ή δοκιμαστής που δημιουργείται ή αλλάζει μέσω ενός κλειδιού εμφανίζεται στο ιστορικό του ζητήματος και στο αρχείο ελέγχου, με το όνομα του κλειδιού.
- Μη βάζετε ποτέ ένα κλειδί σε email, συνομιλία ή κώδικα· επικολλήστε το μόνο στο Make.