Προδιαγραφζσ διαςφνδεςθσ ΠΣ ΑΤΛΑΣ με ΠΣ ΔΑΣΤΑ Έκδοςθ εγγράφου: 2.3, 03/07/2013 Διαφορζσ ςε ςχζςθ με τθν ζκδοςθ 2.2: Προςτζκθκε το service FindAcademicIdNumber για τθν αναηιτθςθ του 12ψιφιου αρικμοφ ακαδθμαϊκισ ταυτότθτασ, για όςα Ιδρφματα το χρειάηονται. Η αναηιτθςθ κα γίνεται με τον αρικμό μθτρϊου και το Τμιμα του φοιτθτι.
Πίνακασ Περιεχομζνων 1 Ειςαγωγι... 4 2 Ομάδεσ Χρθςτϊν και Λειτουργίεσ του Π.Σ. ΑΤΛΑΣ... 4 3 Επικοινωνία του Π.Σ. ΑΤΛΑΣ με Π.Σ. Γραφείων Πρακτικισ... 5 4 Δικαιϊματα του Γραφείου Πρακτικισ που διαχειρίηεται Θζςεισ Πρακτικισ του ΑΤΛΑΣ... 6 5 Τα μεταδεδομζνα των αντικειμζνων που ανταλλάςςονται με τα Web Services... 7 5.1 ΦΥΠΑ (Φορζασ Υποδοχισ Πρακτικισ Άςκθςθσ)... 7 5.2 Γκρουπ Θζςεων Πρακτικισ ΘΕΠΑ (Θζςθ Πρακτικισ Άςκθςθσ)... 8 5.3 Θζςθ Πρακτικισ Άςκθςθσ... 8 5.4 Φοιτθτισ... 9 6 Αναλυτικι περιγραφι των Web Services... 9 7 Ενθμζρωςθ του Π.Σ. «ΑΤΛΑΣ» για κζςεισ Πρακτικισ που ζχουν ιδθ ολοκλθρωκεί... 12 7.1 Περιγραφι του ηθτιματοσ... 12 7.2 Τρόποσ διλωςθσ μίασ Ολοκλθρωμζνθσ Θζςθσ ςτο ΑΤΛΑΣ... 12 7.3 Τρόποσ διλωςθσ του ΦΥΠΑ... 12 7.4 Τρόποσ διλωςθσ του Φοιτθτι... 12 7.5 Τρόποσ διλωςθσ των ςτοιχείων εκτζλεςθσ μίασ Θζςθσ Πρακτικισ Άςκθςθσ... 12 7.6 Περιγραφι των Web Services για τθν διλωςθ ολοκλθρωμζνθσ Θζςθσ Πρακτικισ Άςκθςθσ... 13 Παράρτθμα 1: Τα μεταδεδομζνα των αντικειμζνων που ανταλλάςςονται με τα Web Services... 15 ΦΥΠΑ (Φορζασ Υποδοχισ Πρακτικισ Άςκθςθσ)... 15 Γκρουπ Θζςεων Πρακτικισ ΘΕΠΑ (Θζςθ Πρακτικισ Άςκθςθσ)... 15 Θζςθ Πρακτικισ Άςκθςθσ... 16 Φοιτθτισ... 18 Χριςτθσ ΓΠΑ... 18 Παράρτθμα 2: Αναλυτικι περιγραφι των Web Services... 19 Web Services για τθ διαχείριςθ Θζςεων που ζχουν καταχωρθκεί ςτο ΑΤΛΑΣ από τουσ ΦΥΠΑ... 19 Web Services για τθν άντλθςθ Lkup Tables του ΑΤΛΑΣ... 22 Web Services για τθν διλωςθ ολοκλθρωμζνθσ Θζςθσ Πρακτικισ Άςκθςθσ... 23 Παράρτθμα 3: Δοκιμαςτικό περιβάλλον των Web Services... 25 2
3
1 Ειςαγωγι Το Πλθροφοριακό Σφςτθμα ΑΤΛΑΣ ζχει υλοποιιςει μία ςειρά από Web Services προκειμζνου να μπορεί να διαλειτουργιςει με τα Πλθροφοριακά Συςτιματα των Γραφείων Πρακτικισ Άςκθςθσ, προκειμζνου: Ζνα ΓΠΑ να μπορεί να ζχει πρόςβαςθ ςτισ λειτουργίεσ του ΑΤΛΑΣ μζςα από το δικό του Πλθροφοριακό Σφςτθμα, προκειμζνου να εκτελζςει όλεσ τισ λειτουργίεσ που είναι διακζςιμεσ και μζςω τθσ διαδικτυακισ εφαρμογισ του ΑΤΛΑΣ (δθλαδι, να προδεςμεφει Θζςεισ που ζχουν δθμοςιεφςει ΦΥΠΑ ςτο ΑΤΛΑΣ, να αντιςτοιχίηει Θζςεισ του ΑΤΛΑΣ ςε Φοιτθτζσ, κοκ) Ζνα ΓΠΑ να μπορεί να ειςάγει ςτο ΑΤΛΑΣ ολοκλθρωμζνεσ Θζςεισ Πρακτικισ που ζχει διαχειριςτεί το ίδιο, δθλαδι Θζςεισ που δεν δθλϊκθκαν από τουσ ΦΥΠΑ ςτο ΑΤΛΑΣ. 2 Ομάδεσ Χρθςτϊν και Λειτουργίεσ του Π.Σ. ΑΤΛΑΣ Ομάδεσ Χρθςτϊν: Φορείσ Υποδοχισ Πρακτικισ Άςκθςθσ (ΦΥΠΑ) Γραφεία Πρακτικισ Άςκθςθσ (ΓΠΑ) Προπτυχιακοί Φοιτθτζσ (Φοιτθτζσ) Γραφείο Αρωγισ Δράςθσ (ΓΑΔ) Βαςικι Οντότθτα: Γκρουπ κζςεων Πρακτικισ Άςκθςθσ (Γκρουπ): είναι θ αναγγελία από ζνα ΦΥΠΑ μίασ διακζςιμθσ Θζςθσ ι ςυνόλου Θζςεων με τα ίδια ακριβϊσ χαρακτθριςτικά. Θζςθ Πρακτικισ Άςκθςθσ (Θζςθ): είναι μία ςυγκεκριμζνθ κζςθ ενόσ Γκρουπ, θ οποία μπορεί να προδεςμευκεί από ζνα ΓΠΑ ι να αντιςτοιχιςτεί ςε ζνα Φοιτθτι. Βαςικζσ Λειτουργίεσ για κάκε Ομάδα Χρθςτϊν: Φορείσ Υποδοχισ Πρακτικισ Άςκθςθσ (ΦΥΠΑ) Εγγραφι ΦΥΠΑ Ενζργειεσ πιςτοποίθςθσ ΦΥΠΑ Δθμιουργία λογαριαςμϊν χρθςτϊν για τα ςτελζχθ του ΦΥΠΑ Διαχείριςθ των Γκρουπ Θζςεων του ΦΥΠΑ: Συγκεντρωτικι εμφάνιςθ και αναηιτθςθ των Γκρουπ Θζςεων του ΦΥΠΑ Δθμιουργία νζου Γκρουπ Θζςεων Διαγραφι ενόσ Γκρουπ Θζςεων Δθμοςίευςθ ενόσ Γκρουπ Θζςεων Από-δθμοςίευςθ ενόσ Γκρουπ Θζςεων (Είναι δυνατι μόνο όταν καμία Θζςθ του Γκρουπ δεν ζχει προδεςμευκεί από ΓΠΑ ι αντιςτοιχιςτεί ςε Φοιτθτι) Απόςυρςθ ενόσ Γκρουπ Θζςεων (Είναι πάντοτε δυνατι. Δεν επθρεάηει τισ Θζςεισ του Γκρουπ που ζχουν ιδθ προδεςμευκεί ι αντιςτοιχιςτεί. Αλλά, πλζον το Γκρουπ δεν εμφανίηεται ςτισ αναηθτιςεισ ελεφκερων Θζςεων από Φοιτθτζσ ι ΓΠΑ) 4
Επικοινωνία με το Γραφείο Αρωγισ Γραφεία Πρακτικισ Άςκθςθσ (ΓΠΑ) Εγγραφι ΓΠΑ Ενζργειεσ πιςτοποίθςθσ ΓΠΑ Δθμιουργία λογαριαςμϊν χρθςτϊν για τα ςτελζχθ ΓΠΑ Αναηιτθςθ των Γκρουπ Θζςεων ςτα οποία ζχει δικαίωμα πρόςβαςθσ το ΓΠΑ Διαχείριςθ μίασ Θζςθσ: Προδζςμευςθ Θζςθσ Αποδζςμευςθ Θζςθσ Αντιςτοίχιςθ Θζςθσ ςε εγγεγραμμζνο Φοιτθτι Ακφρωςθ τθσ αντιςτοίχιςθσ Θζςθσ ςε Φοιτθτι Διλωςθ ολοκλιρωςθσ τθσ Πρακτικισ Άςκθςθσ για μία Θζςθ Αναφορζσ για τισ Θζςεισ που διαχειρίηεται το ΓΠΑ (αφορά τισ Θζςεισ που ζχει προδεςμεφςει, που ζχει αντιςτοιχίςει ι που ζχει δθλϊςει τθν ολοκλιρωςι τουσ) Επικοινωνία με το Γραφείο Αρωγισ Προπτυχιακοί Φοιτθτζσ (Φοιτθτζσ) Αναηιτθςθ διακζςιμων Γκρουπ κζςεων Πρακτικισ Άςκθςθσ Παρακολοφκθςθ τθσ Θζςθσ που τουσ ζχει αντιςτοιχιςτεί από το ΓΠΑ. 3 Επικοινωνία του Π.Σ. ΑΤΛΑΣ με Π.Σ. Γραφείων Πρακτικισ Οι χριςτεσ κάκε ομάδασ (ΦΥΠΑ, ΓΠΑ, Φοιτθτζσ) εκτελοφν τισ λειτουργίεσ που τουσ αφοροφν μζςα από τισ διαδικτυακζσ εφαρμογζσ του Πλθροφοριακοφ Συςτιματοσ ΑΤΛΑΣ του Ε.Δ.Ε.Τ. Ειδικά, για τα ΓΠΑ ζχει προβλεφκεί οι λειτουργίεσ του ΑΤΛΑΣ να καλοφνται με κατάλλθλα Web Services. Με τον τρόπο αυτό, ζνα ΓΠΑ μπορεί να ζχει πρόςβαςθ ςτισ λειτουργίεσ του ΑΤΛΑΣ μζςα από το δικό του Πλθροφοριακό Σφςτθμα (εφόςον ιδθ διακζτει ι ςκοπεφει να φτιάξει Πλθροφοριακό Σφςτθμα). Ακολουκεί θ λίςτα των Web Services για τα ΓΠΑ για διαχείριςθ Θζςεων Πρακτικισ του ΑΤΛΑΣ: 1. Λίςτα των δθμοςιευμζνων Γκρουπ Θζςεων που αφοροφν το ςυγκεκριμζνο ΓΠΑ 2. Αναλυτικά ςτοιχεία ενόσ ςυγκεκριμζνου Γκρουπ Θζςεων 3. Αναλυτικά ςτοιχεία ενόσ ςυγκεκριμζνου ΦΥΠΑ 4. Προδζςμευςθ Θζςθσ ι Θζςεων από ζνα Γκρουπ 5. Αποδζςμευςθ Θζςθσ 6. Λίςτα των προδεςμευμζνων Θζςεων του ΓΠΑ (με τα βαςικά ςτοιχεία κάκε Θζςθσ και τθν θμερομθνία λιξθσ κάκε προδζςμευςθσ) 7. Αντιςτοίχιςθ Θζςθσ ςε Φοιτθτι (μπορεί να εφαρμοςτεί ςε Θζςεισ που ζχει προδεςμεφςει το ΓΠΑ) 5
8. Αλλαγι «Στοιχείων Εκτζλεςθσ Πρακτικισ Άςκθςθσ» 9. Αλλαγι Επιλεγμζνου Φοιτθτι 10. Ακφρωςθ αντιςτοίχιςθσ Θζςθσ ςε Φοιτθτι 11. Λίςτα των αντιςτοιχιςμζνων Θζςεων από το ΓΠΑ 12. Διλωςθ ολοκλιρωςθσ τθσ πρακτικισ άςκθςθσ ςε μία Θζςθ (μπορεί να εφαρμοςτεί ςε Θζςεισ που ζχει αντιςτοιχίςει το ΓΠΑ ςε φοιτθτζσ του) 13. Διλωςθ ανεπιτυχοφσ ολοκλιρωςθσ τθσ πρακτικισ άςκθςθσ ςε μία Θζςθ 14. Λίςτα των Θζςεων που ζχουν δθλωκεί ωσ ολοκλθρωμζνεσ 15. Λίςτα των εγγεγραμμζνων φοιτθτϊν του Ιδρφματοσ που εκπροςωπεί το ΓΠΑ 16. Εμφάνιςθ των ςτοιχείων ενόσ εγγεγραμμζνου φοιτθτι (μπορεί να εφαρμοςτεί μόνο για φοιτθτζσ Τμθμάτων που εκπροςωπεί το ΓΠΑ) 17. Αναηιτθςθ Φοιτθτι με 12ψιφιο ακαδθμαϊκισ Ταυτότθτασ (μπορεί να εφαρμοςτεί μόνο για φοιτθτζσ Τμθμάτων που εκπροςωπεί το ΓΠΑ) 18. Εγγραφι Φοιτθτι ςτο ΑΤΛΑΣ 19. Αλλαγι ςτοιχείων φοιτθτι ςτο ΑΤΛΑΣ 4 Δικαιϊματα του Γραφείου Πρακτικισ που διαχειρίηεται Θζςεισ Πρακτικισ του ΑΤΛΑΣ Ζνα Γραφείο Πρακτικισ Άςκθςθσ (ΓΠΑ) που διαχειρίηεται Θζςεισ Πρακτικισ Άςκθςθσ του ΑΤΛΑΣ μζςα από το δικό του Πλθροφοριακό Σφςτθμα ζχει τα ίδια ακριβϊσ δικαιϊματα με ζνα ΓΠΑ που διαχειρίηεται Θζςεισ μζςα από τισ ςελίδεσ του ΑΤΛΑΣ, δθλαδι: Βλζπει μόνο τα διακζςιμα Γκρουπ Θζςεων που αφοροφν τα Τμιματα που εκπροςωπεί. Δεν μπορεί να προδεςμεφει περιςςότερεσ Θζςεισ από όςεσ του αναλογοφν. Εάν δεν αντιςτοιχίςει μία προδεςμευμζνθ ΘΕΠΑ ςε ζναν φοιτθτι εντόσ του χρονικοφ ορίου που κζτει ο ΑΤΛΑΣ, θ κζςθ κα αποδεςμευτεί και μπορεί ζνα άλλο Γραφείο να τθν προδεςμεφςει. Για μία Θζςθ που τθν ζχει αντιςτοιχίςει ςε φοιτθτι, κα πρζπει ςε εφλογο χρονικό διάςτθμα είτε να δθλϊςει τθν ολοκλιρωςθ τθσ πρακτικισ άςκθςθσ είτε να ακυρϊςει τθν αντιςτοίχιςθ. Σκοπόσ των web services είναι να δϊςουν τθ δυνατότθτα ςε κάκε ΓΠΑ να επωφελείται από τισ Θζςεισ Πρακτικισ που περιλαμβάνει το ΑΤΛΑΣ, τθρϊντασ παράλλθλα τουσ κανόνεσ του ΑΤΛΑΣ. 6
5 Τα μεταδεδομζνα των αντικειμζνων που ανταλλάςςονται με τα Web Services Κάκε αντικείμενο που διαχειρίηεται ο ΑΤΛΑΣ, ζχει ζνα μοναδικό του αναγνωριςτικό (ID) εντόσ του Πλθροφοριακοφ Συςτιματοσ. Σε κάκε ανταλλαγι δεδομζνων μζςω των Web Services, παρζχεται το μοναδικό αναγνωριςτικό κάκε αντικειμζνου, ζτςι ϊςτε τα ςυνεργαηόμενα Πλθροφοριακά Συςτιματα των ΓΠΑ να μποροφν να αναφζρονται με ςαφινεια ςε αυτό (είτε είναι Θζςθ Πρακτικισ, είτε ΦΥΠΑ, είτε Φοιτθτισ). Σε όςεσ περιπτϊςεισ υπάρχει ζνα αντικειμενικό αναγνωριςτικό, ο ΑΤΛΑΣ το περιλαμβάνει και αυτό ςτθν πλθροφορία που αποςτζλλει, ζτςι ϊςτε το Πλθροφοριακό Σφςτθμα του ΓΠΑ να ζχει τθ δυνατότθτα να το αντιςτοιχίςει ςε αντικείμενα που ζχουν ιδθ καταχωρθκεί ςε αυτό. Για παράδειγμα: ΦΥΠΑ: παρζχεται ο ΑΦΜ (Αρικμόσ Φορολογικοφ Μθτρϊου) και θ Επωνυμία τθσ επιχείρθςθσ, ζτςι ϊςτε να μπορεί ζνα ΓΠΑ να μπορεί να αντιςτοιχίςει ζνα ΦΥΠΑ που αποςτζλλει ο ΑΤΛΑΣ ςε ζνα Φορζα που είναι ιδθ καταχωρθμζνοσ ςτο Πλθροφοριακό του Σφςτθμα. Φοιτθτισ: παρζχεται ο αρικμόσ τθσ Ακαδθμαϊκισ Ταυτότθτασ του Φοιτθτι. Με βάςθ αυτόν, το ΓΠΑ μπορεί να αντιςτοιχίςει τον Φοιτθτι που του αποςτζλλει ο ΑΤΛΑΣ ςε φοιτθτι που ζχει ιδθ καταχωρίςει ςτο Πλθροφοριακό του Σφςτθμα. Γκρουπ Θζςεων και Θζςεισ Πρακτικισ: Δεν υπάρχει αντικειμενικό αναγνωριςτικό, διότι γενικά οι Φορείσ δεν κζτουν κάποιο αναγνωριςτικό ςτισ κζςεισ πρακτικισ άςκθςθσ που δθμοςιοποιοφν. Κάκε ΓΠΑ που κζλει να διαχειριςτεί Θζςεισ Πρακτικισ που περιλαμβάνει ο ΑΤΛΑΣ, πρζπει να χρθςιμοποιεί τουσ Κωδικοφσ που ζχει αποδϊςει ο ΑΤΛΑΣ ςτισ Θζςεισ αυτζσ. Ακολοφκωσ περιγράφονται τα μετα-δεδομζνα που χρθςιμοποιεί ο ΑΤΛΑΣ για τα αντικείμενα που ανταλλάςςονται με τα Web Services. 5.1 ΦΥΠΑ (Φορζασ Υποδοχισ Πρακτικισ Άςκθςθσ) Κωδικόσ ΦΥΠΑ (Μοναδικό αναγνωριςτικό του ΦΥΠΑ ςτο ΑΤΛΑΣ. Δεν αλλάηει ποτζ) ΑΦΜ Επωνυμία Στοιχεία Υπευκφνου Ονοματεπϊνυμο Τθλζφωνο (ςτακερό) E-mail 7
5.2 Γκρουπ Θζςεων Πρακτικισ ΘΕΠΑ (Θζςθ Πρακτικισ Άςκθςθσ) Διαςφνδεςθ του Π.Σ. «ΑΤΛΑΣ» με πλθροφοριακά ςυςτιματα ΔΑΣΤΑ Κωδικόσ του Γκρουπ Θζςεων (Μοναδικό αναγνωριςτικό του Γκρουπ ςτο ΑΤΛΑΣ. Δεν αλλάηει ποτζ) ΦΥΠΑ που ζχει δθμοςιεφςει τθ ΘΕΠΑ Κωδικόσ ΦΥΠΑ (το μοναδικό αναγνωριςτικό του ΦΥΠΑ ςτο ΑΤΛΑΣ. Δεν αλλάηει ποτζ) ΑΦΜ ΦΥΠΑ, Επωνυμία ΦΥΠΑ Αρικμόσ διακζςιμων Θζςεων του Γκρουπ Τίτλοσ Περιγραφι Διάρκεια Πόλθ Νομόσ Χϊρα Διακζςιμθ χρονικι περίοδοσ για τθν εκτζλεςθ τθσ Πρακτικισ Άςκθςθσ (επιλογι μεταξφ των τιμϊν: «Με χρονικό περιοριςμό», «Χωρίσ χρονικό περιοριςμό») Εφόςον είναι «Με χρονικό περιοριςμό» Επικυμθτι θμερομθνία ζναρξθσ τθσ Πρακτικισ Άςκθςθσ (από) Επικυμθτι θμερομθνία λιξθσ τθσ Πρακτικισ Άςκθςθσ (ζωσ) Είδοσ απαςχόλθςθσ (επιλογι μεταξφ των τιμϊν: "Πλιρεσ ωράριο", "Μερικό ωράριο") Τθλζφωνο επικοινωνίασ Ονοματεπϊνυμο Επόπτθ E-mail Επόπτθ Αντικείμενο τθσ Θζςθσ (πολλαπλζσ τιμζσ από λίςτα προκακοριςμζνων λεκτικϊν) Τμιματα ςτα οποία είναι διακζςιμθ θ κζςθ και τα οποία μπορεί να χειρίηεται το ΓΠΑ (πολλαπλζσ τιμζσ από τθ Λίςτα όλων των Τμθμάτων/Σχολϊν των Πανεπιςτθμίων/ΤΕΙ) 5.3 Θζςθ Πρακτικισ Άςκθςθσ Κωδικόσ τθσ Θζςθσ (Μοναδικό αναγνωριςτικό τθσ Θζςθσ ςτο ΑΤΛΑΣ. Δεν αλλάηει ποτζ) Κωδικόσ του Γκρουπ Θζςεων (ο κωδικόσ του Γκρουπ Θζςεων ςτο οποίο ανικει θ Θζςθ) Κατάςταςθ τθσ Θζςθσ («Διακζςιμθ», «Προδεςμευμζνθ», «Αντιςτοιχιςμζνθ», «Υπό διενζργεια», «Ολοκλθρωμζνθ», «Ακυρωμζνθ») Εφόςον θ κζςθ είναι ςε κατάςταςθ «Προδεςμευμζνθ» Ημερομθνία/Ώρα αυτόματθσ λιξθσ τθσ προδζςμευςθσ. Εφόςον θ κζςθ είναι ςε κατάςταςθ «Αντιςτοιχιςμζνθ», «Υπό διενζργεια», ι «Ολοκλθρωμζνθ» Φοιτθτισ ςτον οποίο ζχει αντιςτοιχιςτεί θ Θζςθ Κωδικόσ τθσ Ακαδθμαϊκισ Ταυτότθτασ του Φοιτθτι Σχολι/Τμιμα και Ονοματεπϊνυμο, Α.Μ. του Φοιτθτι Ημερομθνία Αντιςτοίχιςθσ 8
Ημερομθνία Ολοκλιρωςθσ Σχόλια Ολοκλιρωςθσ 5.4 Φοιτθτισ Κωδικόσ τθσ Ακαδθμαϊκισ Ταυτότθτασ του Φοιτθτι Κδρυμα/ Σχολι/Τμιμα του Φοιτθτι Ονοματεπϊνυμο και Α.Μ. Φοιτθτι 6 Αναλυτικι περιγραφι των Web Services Στθν ενότθτα αυτι περιγράφεται ο τρόποσ με τον οποίο καλείται κάκε Web Service και τα αντικείμενα που επιςτρζφει ο ΑΤΛΑΣ ςε κάκε κλιςθ. Περιγράφονται μόνο τα Web Services που ςτοχεφουν ςτθ διαχείριςθ από τα ΓΠΑ των Θζςεων Πρακτικισ που περιζχει ο ΑΤΛΑΣ. Τα Web Services που ςτοχεφουν ςτθν ειςαγωγι ςτο ΑΤΛΑΣ ολοκλθρωμζνων Θζςεων Πρακτικισ που ζχει διαχειριςτεί το ΓΠΑ, περιγράφονται ςε επόμενθ ενότθτα. Παράμετροι κλιςθσ Αντικείμενα που επιςτρζφονται 1. Λίςτα των δθμοςιευμζνων Γκρουπ Θζςεων που αφοροφν το ςυγκεκριμζνο ΓΠΑ - Λίςτα με ηεφγθ: τουσ κωδικοφσ των {κωδικόσ Γκρουπ - κωδικόσ ΦΥΠΑ} με όλα τα Γκρουπ Θζςεων που αφοροφν το ΓΠΑ 2. Αναλυτικά ςτοιχεία ενόσ ςυγκεκριμζνου Γκρουπ 3. Αναλυτικά ςτοιχεία ενόσ ςυγκεκριμζνου ΦΥΠΑ 4. Προδζςμευςθ Θζςθσ ι Θζςεων από ζνα Γκρουπ Ο κωδικόσ ενόσ Γκρουπ Θζςεων Ο κωδικόσ ενόσ ΦΥΠΑ Ο κωδικόσ ενόσ Γκρουπ και ο αρικμόσ των Θζςεων που το ΓΠΑ κζλει να προδεςμεφςει Τα πλιρθ ςτοιχεία του Γκρουπ Τα πλιρθ ςτοιχεία του ΦΥΠΑ O κωδικόσ τθσ Θζςθσ (ι οι Κωδικοί των Θζςεων) που προδεςμεφτθκαν από το Γκρουπ 5. Αποδζςμευςθ Θζςθσ Ο κωδικόσ ενόσ Γκρουπ και ο αρικμόσ των Θζςεων που το ΓΠΑ κζλει να αποδεςμεφςει - 6. Λίςτα των προδεςμευμζνων Θζςεων του ΓΠΑ - Λίςτα των Θζςεων που ζχει προδεςμεφςει το ΓΠΑ. Για κάκε Θζςθ, τα πλιρθ ςτοιχεία τθσ (ςτοιχεία Θζςθσ, Γκρουπ, ΦΥΠΑ) 7. Αντιςτοίχιςθ Θζςθσ ςε Φοιτθτι Ο κωδικόσ μίασ προδεςμευμζνθσ Θζςθσ, ο κωδικόσ τθσ Ακαδθμαϊκισ Ταυτότθτασ ενόσ φοιτθτι και τα αρχικά ςτοιχεία τθσ εκτζλεςθσ τθσ πρακτικισ (από, ζωσ, κλπ) Τα πλιρθ ςτοιχεία τθσ Θζςθσ (ςτοιχεία Θζςθσ, Γκρουπ, ΦΥΠΑ, Φοιτθτι, εκτζλεςθσ) 8. Αλλαγι «Στοιχείων Εκτζλεςθσ Πρακτικισ Άςκθςθσ» Ο κωδικόσ μίασ αντιςτοιχιςμζνθσ Θζςθσ και τα νζα ςτοιχεία τθσ εκτζλεςθσ τθσ πρακτικισ (από, ζωσ, κλπ) Τα πλιρθ ςτοιχεία τθσ Θζςθσ, με βάςθ τθν τροποποίθςθ 9
Παράμετροι κλιςθσ 9. Αλλαγι Επιλεγμζνου Φοιτθτι Ο κωδικόσ μίασ αντιςτοιχιςμζνθσ Θζςθσ, ο κωδικόσ τθσ Ακαδθμαϊκισ Ταυτότθτασ ενόσ φοιτθτι και τα αρχικά ςτοιχεία τθσ εκτζλεςθσ τθσ πρακτικισ (από, ζωσ, κλπ) Αντικείμενα που επιςτρζφονται Τα πλιρθ ςτοιχεία τθσ Θζςθσ, με βάςθ τθν τροποποίθςθ 10. Ακφρωςθ αντιςτοίχιςθσ Θζςθσ ςε Φοιτθτι 11. Λίςτα των αντιςτοιχιςμζνων Θζςεων από το ΓΠΑ Ο κωδικόσ μίασ αντιςτοιχιςμζνθσ Θζςθσ και ο λόγοσ τθσ ακφρωςθσ - Λίςτα των Θζςεων που ζχει αντιςτοιχίςει το ΓΠΑ. Για κάκε Θζςθ, τα πλιρθ ςτοιχεία τθσ (ςτοιχεία Θζςθσ, Γκρουπ, ΦΥΠΑ, Φοιτθτι, εκτζλεςθσ) 12. Διλωςθ ολοκλιρωςθσ τθσ πρακτικισ άςκθςθσ ςε μία Θζςθ 13. Διλωςθ ανεπιτυχοφσ ολοκλιρωςθσ τθσ πρακτικισ άςκθςθσ ςε μία Θζςθ Ο κωδικόσ μίασ αντιςτοιχιςμζνθσ Θζςθσ, τα οριςτικά ςτοιχεία εκτζλεςθσ τθσ πρακτικισ και θ ςχετικι διλωςθ Ο κωδικόσ μίασ αντιςτοιχιςμζνθσ Θζςθσ και ο λόγοσ τθσ ακφρωςθσ Τα πλιρθ ςτοιχεία τθσ Θζςθσ, με βάςθ τθν ολοκλιρωςθ 14. Λίςτα των Θζςεων που ζχουν δθλωκεί ωσ ολοκλθρωμζνεσ 15. Λίςτα των εγγεγραμμζνων φοιτθτϊν του Ιδρφματοσ που εκπροςωπεί το ΓΠΑ - Λίςτα των Θζςεων που ζχει ολοκλθρϊςει το ΓΠΑ. Για κάκε Θζςθ, τα πλιρθ ςτοιχεία τθσ (ςτοιχεία Θζςθσ, Γκρουπ, ΦΥΠΑ, Φοιτθτι, εκτζλεςθσ) - Λίςτα με τουσ εγγεγραμμζνουσ ςτο ΑΤΛΑΣ Φοιτθτζσ που φοιτοφν ςε Τμιματα που εκπροςωπεί το ΓΠΑ 16. Εμφάνιςθ των ςτοιχείων ενόσ εγγεγραμμζνου φοιτθτι 17. Αναηιτθςθ Φοιτθτι με 12ψιφιο ακαδθμαϊκισ ταυτότθτασ 18. Εγγραφι φοιτθτι ςτο ΑΤΛΑΣ 19. Αλλαγι ςτοιχείων φοιτθτι ςτο ΑΤΛΑΣ Ο κωδικόσ τθσ Ακαδθμαϊκισ Ταυτότθτασ του φοιτθτι Ο κωδικόσ τθσ Ακαδθμαϊκισ Ταυτότθτασ του φοιτθτι Ο κωδικόσ τθσ Ακαδθμαϊκισ Ταυτότθτασ του φοιτθτι Ο Κωδικόσ του Φοιτθτι ςτο ΑΤΛΑΣ και ο κωδικόσ τθσ Ακαδθμαϊκισ Ταυτότθτασ του φοιτθτι (βάςει του οποίου κα ανανεωκοφν τα ςτοιχεία του Φοιτθτι) Τα πλιρθ ςτοιχεία του φοιτθτι, θ τρζχουςα κατάςταςι του (π.χ. εκτελεί Πρακτικι, ζχει ολοκλθρϊςει Πρακτικι) και το ιςτορικό των κινιςεϊν του ςε ςχζςθ με το ςυγκεκριμζνο ΓΠΑ (πχ Πρακτικζσ που ζχουν ακυρωκεί) Τα πλιρθ ςτοιχεία φοιτθτι (Ονοματεπϊνυμο, Σχολι/Τμιμα) ανεξάρτθτα από το εάν ζχει εγγραφεί ςτο ΑΤΛΑΣ Τα πλιρθ ςτοιχεία του Φοιτθτι (μαηί με τον Κωδικό που πιρε θ εγγραφι του Φοιτθτι ςτο ΑΤΛΑΣ) Τα πλιρθ ανανεωμζνα ςτοιχεία του Φοιτθτι 10
20. Αναηιτθςθ 12ψιφιου ακαδθμαϊκισ ταυτότθτασ με τον αρικμό μθτρϊου του φοιτθτι Παράμετροι κλιςθσ Ο Αρικμόσ Μθτρϊου και το Τμιμα που ανικει ο φοιτθτισ Αντικείμενα που επιςτρζφονται Ο 12ψιφιοσ τθσ κάρτασ και τα πλιρθ ςτοιχεία του φοιτθτι 11
7 Ενθμζρωςθ του Π.Σ. «ΑΤΛΑΣ» για κζςεισ Πρακτικισ που ζχουν ιδθ ολοκλθρωκεί 7.1 Περιγραφι του ηθτιματοσ Τα ΓΠΑ να ζχουν τθ δυνατότθτα να καταχωροφν ςτο ΑΤΛΑΣ Θζςεισ Πρακτικισ Άςκθςθσ που ζχουν ολοκλθρϊςει οι Φοιτθτζσ τουσ, οι οποίεσ όμωσ δεν ζχουν προζλκει από το ΑΤΛΑΣ. Δθλαδι, πρόκειται για Θζςεισ Πρακτικισ Άςκθςθσ που δεν δθμοςίευςε κάποιοσ ΦΥΠΑ ςτο ΑΤΛΑΣ, αλλά τισ διαχειρίςτθκαν τα ΓΠΑ αποκλειςτικά ςτο πλαίςιο του δικοφ τουσ περιβάλλοντοσ εργαςίασ (είτε με το δικό τουσ Πλθροφοριακό Σφςτθμα, είτε χωρίσ χριςθ Πλθροφοριακοφ Συςτιματοσ). 7.2 Τρόποσ διλωςθσ μίασ Ολοκλθρωμζνθσ Θζςθσ ςτο ΑΤΛΑΣ Το ΓΠΑ κα πρζπει να παρζχει ςτο ΑΤΛΑΣ τα εξισ ςτοιχεία για μία ολοκλθρωμζνθ Θζςθ Πρακτικισ που κζλει να καταχωρίςει: Τον ΦΥΠΑ όπου διενεργικθκε θ Πρακτικι Άςκθςθ Τον Φοιτθτι Τα ςτοιχεία εκτζλεςθσ τθσ Πρακτικισ Άςκθςθσ Στθ ςυνζχεια, περιγράφεται ο ακριβισ τρόποσ με τον οποίο το ΓΠΑ πρζπει να δθλϊςει κακζνα από τα παραπάνω ςτοιχεία. 7.3 Τρόποσ διλωςθσ του ΦΥΠΑ Απαιτείται ο κωδικόσ του ΦΥΠΑ ςτο ΑΤΛΑΣ. Το ΓΠΑ αναηθτά, μεταξφ των ΦΥΠΑ που ζχουν πιςτοποιθκεί ςτο ΑΤΛΑΣ, τον ΦΥΠΑ όπου εκτελζςτθκε θ πρακτικι άςκθςθ. Εάν τον εντοπίςει, χρθςιμοποιεί τον Κωδικό που αναγράφει ο ΑΤΛΑΣ για τον ΦΥΠΑ. Εάν δεν τον εντοπίςει, κα πρζπει ο ςυγκεκριμζνοσ ΦΥΠΑ να εγγραφεί ςτο ΑΤΛΑΣ και να πιςτοποιθκεί (με τισ τυπικζσ διαδικαςίεσ) προκειμζνου να αποκτιςει Κωδικό ΑΤΛΑΣ. Η αναηιτθςθ των πιςτοποιθμζνων ΦΥΠΑ ςτο ΑΤΛΑΣ γίνεται με βάςθ το Α.Φ.Μ. του ΦΥΠΑ, είτε ςε ειδικι ςελίδα τθσ εφαρμογισ των ΓΠΑ, είτε με Web Service που μποροφν να καλζςουν τα ΓΠΑ. 7.4 Τρόποσ διλωςθσ του Φοιτθτι Απαιτείται ο Κωδικόσ τθσ Ακαδθμαϊκισ Ταυτότθτασ του Φοιτθτι. Το ΓΠΑ μπορεί να ηθτιςει από τον Φοιτθτι να του ανακοινϊςει τον Κωδικό τθσ Ακαδθμαϊκισ του Ταυτότθτασ ι να τον βρει από ειδικι ςελίδα αναηιτθςθσ τθσ διαδικτυακισ εφαρμογισ των ΓΠΑ. 7.5 Τρόποσ διλωςθσ των ςτοιχείων εκτζλεςθσ μίασ Θζςθσ Πρακτικισ Άςκθςθσ Το ΓΠΑ κα πρζπει να καταχωρίςει τα εξισ ςτοιχεία, αναφορικά με κάκε ολοκλθρωμζνθ Θζςθ Πρακτικισ Άςκθςθσ που κζλει να δθλϊςει εκ των υςτζρων ςτο ΑΤΛΑΣ: 12
Τίτλοσ Θζςθσ Πρακτικισ Άςκθςθσ Περιγραφι Διάρκεια τθσ Πρακτικισ Άςκθςθσ (ςε μινεσ) Πόλθ Νομόσ Χϊρα Είδοσ απαςχόλθςθσ (επιλογι μεταξφ των τιμϊν: "Πλιρεσ ωράριο", "Μερικό ωράριο") Τθλζφωνο επικοινωνίασ (του ΦΥΠΑ για τθ ςυγκεκριμζνθ Θζςθ Πρακτικισ) - προαιρετικό Ονοματεπϊνυμο Επόπτθ (του ΦΥΠΑ για τθ ςυγκεκριμζνθ Θζςθ Πρακτικισ) - προαιρετικό Ημερομθνία ζναρξθσ τθσ Πρακτικισ Άςκθςθσ Ημερομθνία ολοκλιρωςθσ τθσ Πρακτικισ Άςκθςθσ Σχόλια Ολοκλιρωςθσ 7.6 Περιγραφι των Web Services για τθν διλωςθ ολοκλθρωμζνθσ Θζςθσ Πρακτικισ Άςκθςθσ Στθν ενότθτα αυτι περιγράφονται τα Web Services που παρζχει ο ΑΤΛΑΣ, προκειμζνου ζνα ΓΠΑ να μπορεί να καταχωρίςει ςτο ΑΤΛΑΣ ολοκλθρωμζνεσ Θζςεισ Πρακτικισ Άςκθςθσ τισ οποίεσ διαχειρίςτθκε εκτόσ του ΑΤΛΑΣ. Ε1. Αναηιτθςθ ΦΥΠΑ ςτο ΑΤΛΑΣ με βάςθ το ΑΦΜ Ε2. Διλωςθ Ολοκλθρωμζνθσ Θζςθσ Πρακτικισ Παράμετροι κλιςθσ Α.Φ.Μ. Ο κωδικόσ του ΦΥΠΑ Ο κωδικόσ τθσ Ακαδθμαϊκισ Ταυτότθτασ του Φοιτθτι. Τα ςτοιχεία εκτζλεςθσ τθσ Πρακτικισ Άςκθςθσ Αντικείμενα που επιςτρζφονται Λίςτα με τα ςτοιχεία των εγγεγραμμζνων ςτο ΑΤΛΑΣ ΦΥΠΑ που ζχουν το δοκζν Α.Φ.Μ. ι θ ζνδειξθ «Δε βρζκθκε ΦΥΠΑ με το ΑΦΜ που δϊςατε» Ο Κωδικόσ που απζκτθςε θ Θζςθ ςτον ΑΤΛΑΣ Ε3. Ακφρωςθ Διλωςθσ Θζςθσ Ο κωδικόσ τθσ Θζςθσ - 13
Ε4. Λίςτα των ολοκλθρωμζνων Θζςεων Πρακτικισ που διλωςε το ΓΠΑ εκ των υςτζρων ςτο ΑΤΛΑΣ - Λίςτα των ολοκλθρωμζνων Θζςεων που ζχει ολοκλθρϊςει το ΓΠΑ. Για κάκε Θζςθ, τα πλιρθ ςτοιχεία τθσ (ςτοιχεία Θζςθσ, ΦΥΠΑ, Φοιτθτι, ςτοιχεία εκτζλεςθσ) Τα ςτοιχεία ενόσ ΦΥΠΑ που εμφανίηει το Web Service «Αναηιτθςθ ΦΥΠΑ ςτο ΑΤΛΑΣ με βάςθ το ΑΦΜ» είναι τα ακόλουκα: Κωδικόσ ΦΥΠΑ (Μοναδικό αναγνωριςτικό του ΦΥΠΑ ςτο ΑΤΛΑΣ. Δεν αλλάηει ποτζ) ΑΦΜ Επωνυμία Ονοματεπϊνυμο Υπευκφνου Τθλζφωνο Υπευκφνου E-mail Υπευκφνου 14
Παράρτθμα 1: Τα μεταδεδομζνα των αντικειμζνων που ανταλλάςςονται με τα Web Services ΦΥΠΑ (Φορζασ Υποδοχισ Πρακτικισ Άςκθςθσ) int ID : Κωδι κόσ ΦΥΠ Α (Μοναδικό αναγνωριςτικό του ΦΥΠΑ ςτο ΑΤΛΑΣ. Δεν αλλάηει ποτζ) string AFM : Α ΦΜ string Name : Επωνυμία string CntactName : Στοιχεία Υπευκφνου Ονοματεπϊνυμο string CntactPhne : Στοιχεία Υπευκφνου Τθλζφωνο (ςτακερό) string CntactEmail : Στοιχεία Υπευκφνου E-mail Γκρουπ Θζςεων Πρακτικισ ΘΕΠΑ (Θζςθ Πρακτικισ Άςκθςθσ) int ID : Κωδι κόσ τ ου Γκρουπ Θζ ςεων (Μοναδικό αναγνωριςτικό του Γκρουπ. Δεν αλλάηει ποτζ) int PrviderID : ΦΥΠΑ που ζχει δθμοςιεφςει τθ Θζςθ (Κωδικόσ ΦΥΠΑ ςτο ΑΤΛΑΣ) int AvailablePsitins : Αρικμόσ διακζςιμων Θζςεων του Γκρουπ string Title : Τίτλοσ string Descriptin : Περιγραφι int Duratin : Διάρκεια string Cuntry : Χϊρα (λεκτικό) int CuntryID : Χϊρα (ID ΑΤΛΑΣ) string Prefecture : Νομόσ (λεκτικό) int Prefecture ID : Νομόσ (ID ΑΤΛΑΣ) string City : Πόλθ (λεκτικό) int CityID : Πόλθ (ID ΑΤΛΑΣ) string TimeLimit : Διακζςιμθ χρονικι περίοδοσ για τθν εκτζλεςθ τθσ Πρακτικισ Άςκθςθσ (δυνατζσ τιμζσ: «Με χρονικό περιοριςμό», «Χωρίσ χρονικό περιοριςμό») bl HasTimeLimit : Διακζςιμθ χρονικι περίοδοσ για τθν εκτζλεςθ τθσ Πρακτικισ Άςκθςθσ (δυνατζσ τιμζσ: true, false) Εφόςον είναι «Με χρονικό περιοριςμό» DateTime StartDate : Επικυμθτι θμερομθνία ζναρξθσ τθσ Πρακτικισ Άςκθςθσ (από) DateTime EndDate : Επικυμθτι θμερομθνία λιξθσ τθσ Πρακτικισ Άςκθςθσ (ζωσ) string PsitinType : Είδοσ απαςχόλθςθσ (δυνατζσ τιμζσ: "Πλιρεσ ωράριο", "Μερικό ωράριο") List<string> PhysicalObjects : Αντικείμενο τθσ Θζςθσ (πολλαπλζσ τιμζσ από λίςτα προκακοριςμζνων λεκτικϊν) List<string> Academics : Τμιματα ςτα οποία είναι διακζςιμθ θ κζςθ και τα οποία μπορεί να χειρίηεται το ΓΠΑ (πολλαπλζσ τιμζσ από τθ Λίςτα όλων των Τμθμάτων/Σχολϊν των ΑΕΙ, λίςτα από 15
λεκτικά Τμθμάτων/Ιδρυμάτων) Διαςφνδεςθ του Π.Σ. «ΑΤΛΑΣ» με πλθροφοριακά ςυςτιματα ΔΑΣΤΑ List<int> AcademicIDs : Τμιματα ςτα οποία είναι διακζςιμθ θ κζςθ και τα οποία μπορεί να χειρίηεται το ΓΠΑ (πολλαπλζσ τιμζσ λίςτα από ID ΑΤΛΑΣ για Τμιματα/Ιδρφματα) string Supervisr : Ονοματεπϊνυμο Επόπτθ string SupervisrEmail : Email Επόπτθ string CntactPhne : Τθλζφωνο επικοινωνίασ Θζςθ Πρακτικισ Άςκθςθσ int ID : Κωδι κόσ τ θ σ Θζςθ σ (Μοναδικό αναγνωριςτικό τθσ Θζςθσ ςτο ΑΤΛΑΣ. Δεν αλλάηει ποτζ) int GrupID : Κωδι κόσ του Γκρουπ Θζςεων (ο κωδικόσ του Γκρουπ ςτο οποίο ανικει θ Θζςθ) <Γκρουπ> Grup: Τα πλιρθ ςτοιχεία του Γκρουπ όπου ανικει θ Θζςθ string PsitinStatus : Κατάςταςθ τθσ Θζςθσ (δυνατζσ τιμζσ: «Διακζςιμθ», «Προδεςμευμζνθ», «Αντιςτοιχιςμζνθ», «Υπό διενζργεια», «Ολοκλθρωμζνθ», «Ακυρωμζνθ») Εφόςον θ κζςθ είναι ςε κατάςταςθ «Προδεςμευμζνθ»: int DaysLeftFrAssignment : Ημερομθνία/Ώρα αυτόματθσ λιξθσ τθσ προδζςμευςθσ. Εφόςον θ κζςθ είναι ςε κατάςταςθ «Αντιςτοιχιςμζνθ», «Υπό διενζργεια», ι «Ολοκλθρωμζνθ»: <Φοιτθτισ> AssignedStudent : Όλα τα ςτοιχεία του Φοιτθτι DateTime AssignedAt : Ημερομθνία Αντιςτοίχιςθσ DateTime CmpletedAt : Ημερομθνία Ολοκλιρωςθσ string CmpletinCmments : Σχόλια Ολοκλιρωςθσ string CancellatinReasn : Λόγοσ Ακφρωςθσ DateTime ImplementatinStartDate : Ημερομθνία Εκκίνθςθσ Πρακτικισ DateTime ImplementatinEndDate: Ημερομθνία Τερματιςμοφ Πρακτικισ 16
Ολοκλθρωμζνθ Θζςθ Πρακτικισ Άςκθςθσ ΓΠΑ Διαςφνδεςθ του Π.Σ. «ΑΤΛΑΣ» με πλθροφοριακά ςυςτιματα ΔΑΣΤΑ int ID: Κωδι κόσ ΓΠΑΘζςθσ (Μοναδικό αναγνωριςτικό τθσ ΓΠΑΘζςθσ ςτο ΑΤΛΑΣ. Δεν αλλάηει ποτζ) Μόνο ΓΠΑΘζςθσ-Απάντθςθ int PrviderID: Κωδι κόσ ΦΥΠ Α (Μοναδικό αναγνωριςτικό του ΦΥΠΑ ςτο ΑΤΛΑΣ. Δεν αλλάηει ποτζ) int StudentID : Κωδικόσ Φοιτθτι (Μοναδικό αναγνωριςτικό του Φοιτθτι ςτο ΑΤΛΑΣ. Δεν αλλάηει ποτζ) string Title : Τίτλοσ string Descriptin : Περιγραφι int Duratin : Διάρκεια string PsitinType : Είδοσ απαςχόλθςθσ (δυνατζσ τιμζσ: "Πλιρεσ ωράριο", "Μερικό ωράριο") int PsitinTypeInt : Είδοσ απαςχόλθςθσ (δυνατζσ τιμζσ: "1", "2" αντίςτοιχα) string Supervisr : Ονοματεπϊνυμο Επόπτθ string SupervisrEmail : Email Επόπτθ string CntactPhne : Τθλζφωνο επικοινωνίασ string Cuntry : Χϊρα (λεκτικό) Μόνο ΓΠΑΘζςθσ-Απάντθςθ int CuntryID : Χϊρα (ID ΑΤΛΑΣ) string Prefecture : Νομόσ (λεκτικό) Μόνο ΓΠΑΘζςθσ-Απάντθςθ int Prefecture ID : Νομόσ (ID ΑΤΛΑΣ) string City : Πόλθ (λεκτικό) Μόνο ΓΠΑΘζςθσ-Απάντθςθ int CityID : Πόλθ (ID ΑΤΛΑΣ) List<string> PhysicalObjects : Αντικείμενο τθσ Θζςθσ (πολλαπλζσ τιμζσ από λίςτα προκακοριςμζνων λεκτικϊν) Μόνο ΓΠΑΘζςθσ-Απάντθςθ List<string> PhysicalObjectsID : Αντικείμενο τθσ Θζςθσ (πολλαπλζσ τιμζσ από λίςτα προκακοριςμζνων ID) DateTime ImplementatinStartDate: Hμερομθνία ζναρξθσ τθσ Πρακτικισ Άςκθςθσ (από) DateTime ImplementatinEndDate : Hμερομθνία λιξθσ τθσ Πρακτικισ Άςκθςθσ (ζωσ) string ImplementatinStartDateString : Hμερομθνία ζναρξθσ τθσ Πρακτικισ Άςκθςθσ (από)-κείμενο string ImplementatinEndDateString : Hμερομθνία λιξθσ τθσ Πρακτικισ Άςκθςθσ (ζωσ) )-κείμενο string ImplementatinStartDateStringFrmat : Hμερομθνία ζναρξθσ τθσ Πρακτικισ Άςκθςθσ (από)- μορφι string ImplementatinEndDateStringFrmat : Hμερομθνία λιξθσ τθσ Πρακτικισ Άςκθςθσ (ζωσ)- μορφι string CmpletinCmments : Σχόλια Ολοκλιρωςθσ 17
Φοιτθτισ int ID : Κωδικόσ Φοιτθτι (Μοναδικό αναγνωριςτικό του Φοιτθτι ςτο ΑΤΛΑΣ. Δεν αλλάηει ποτζ) string PrincipalUserName : Principal Name (HTTP_SHIBEPPN) του Φοιτθτι ςτον Ιδρυματικό Κατάλογο (πχ nger@ntua.gr) string StudentNumber : Αρικμόσ Μθτρϊου του Φοιτθτι string AcademicIDNumber : Κωδικόσ τθσ Ακαδθμαϊκισ Ταυτότθτας του Φοιτθτι (εάν ζχει καταχωρθκεί) Στοιχεία φοίτθςθσ του Φοιτθτι int AcademicID : Σχολι/Τμιμα και Κδρυμα του Φοιτθτι (ID ΑΤΛΑΣ για Τμιματα/Ιδρφματα) string Schl: Σχολι του Φοιτθτι (λεκτικό Τμιματοσ/Ιδρφματοσ) string Institutin: Κδρυμα του Φοιτθτι (ID ΑΤΛΑΣ για Τμιματα/Ιδρφματα) string Department: Τμιμα του Φοιτθτι (ID ΑΤΛΑΣ για Τμιματα/Ιδρφματα) Ονοματεπϊνυμο του Φοιτθτι (με Ελλθνικοφσ και με Λατινικοφσ Χαρακτιρεσ) Χριςτθσ ΓΠΑ bl IsNameLatin : Ονοματεπϊνυμο μόνο ςτα Λατινικά string SystemFirstName : Όνομα από shibbleth string SystemLastName : Επϊνυμο από shibbleth string GreekFirstName string GreekLastName string LatinFirstName string LatinLastName string Username : Όνομα χριςτθ Γραφείου Πρακτικισ Άςκθςθσ string Passwrd : Κωδικόσ πρόςβαςθσ Γραφείου Πρακτικισ Άςκθςθσ string AuthTken : Αναγνωριςτικό πρόςβαςθσ που κα χρθςιμοποιείται ςτο header κάκε service call 18
Παράρτθμα 2: Αναλυτικι περιγραφι των Web Services Web Services για τθ διαχείριςθ Θζςεων που ζχουν καταχωρθκεί ςτο ΑΤΛΑΣ από τουσ ΦΥΠΑ Τίτλοσ του Web Service Παράμετροι κλιςθσ Αντικείμενα που επιςτρζφει το Web Service Διαδικαςία απόκτθςθσ απαραίτθτου αναγνωριςτικοφ χριςτθ για τα services POST:: Lgin Services για τθν Προδζςμευςθ Θζςεων 1. Λίςτα των δθμοςιευμζνων Γκρουπ Θζςεων που αφοροφν το ςυγκεκριμζνο ΓΠΑ POST:: GetAvailablePsitinGrups string Username: Όνομα χριςτθ Γραφείου Πρακτικισ string Passwrd: Κωδικόσ πρόςβαςθσ Γραφείου Πρακτικισ int Skip {προαιρετικό}: πόςα αντικείμενα κα αγνοιςει int Take {προαιρετικό}: πόςα αντικείμενα κα πάρει Με το Skip και Take, θ εφαρμογι που καλεί το service κάνει τθ «ςελιδοποίθςθ» που κζλει ςτα αντικείμενα που επιςτρζφει το service. Παραδείγματα (Skip=0, Take=10 παίρνει αντικείμενα με ςειρά 1 ζωσ 10, Skip=10, Take=10 παίρνει τα αντικείμενα με ςειρά 11 ζωσ 20, κοκ) string AuthTken : Αναγνωριςτικό πρόςβαςθσ που κα χρθςιμοποιείται ςτο header κάκε service call Για όλα τα Γκρουπ Θζςεων που αφοροφν το ΓΠΑ, λίςτα με ηεφγθ: Λίςτα: { int GrupID: κωδικόσ Γκρουπ, int PrviderID: κωδικόσ ΦΥΠΑ} 2. Αναλυτικά ςτοιχεία ενόσ ςυγκεκριμζνου Γκρουπ GET:: GetPsitinGrupDetails int ID (οντότθτα Γκρουπ) Αντικείμενο Γκρουπ 3. Αναλυτικά ςτοιχεία ενόσ ςυγκεκριμζνου ΦΥΠΑ GET:: GetPrviderDetails int ID (οντότθτα ΦΥΠΑ) Αντικείμενο ΦΥΠΑ 4. Προδζςμευςθ Θζςθσ ι Θζςεων από ζνα Γκρουπ POST:: PreAssignPsitins int GrupID : Κ ωδ ικόσ τ ου Γ κρουπ Θζςεων (ο κωδικόσ του Γκρουπ Θζςεων ςτο οποίο ανικει θ Θζςθ) Λίςτα με τα ID των Θζςεων που προδεςμεφτθκαν από το Γκρουπ Λίςτα: { int PstitinID : κωδικόσ Θζςθσ} int NumberOfPsitins : Αρικμόσ των κζςεων που κζλουμε να προδεςμεφςουμε int AcademicID : θ Σχολι/Τμιμα για τθν οποία γίνεται θ προδζςμευςθ 5. Αποδζςμευςθ Θζςθσ POST:: RllbackPreAssignment POST:: RllbackPreAssignment/inf (μόνο ενθμζρωςθ για τισ πικανζσ ποινζσ) int PsitinID (οντότθτα Θζςθσ) String ενθμζρωςθσ ςχετικά με το αποτζλεςμα τθσ κλιςθσ. (inf)string με πλθροφορίεσ ςχετικά με τισ ποινζσ. Διαςφνδεςθ του Π.Σ. «ΑΤΛΑΣ» με πλθροφοριακά ςυςτιματα ΔΑΣΤΑ 19
6. Λίςτα των προδεςμευμζνων Θζςεων του ΓΠΑ int Skip {προαιρετικό} Λίςτα των Θζςεων που ζχει προδεςμεφςει το ΓΠΑ. POST:: GetPreAssignedPsitins int Take {προαιρετικό} Λίςτα από αντικείμενα Θζςθ Services για τθν Αντιςτοίχιςθ Θζςεων ςε Φοιτθτζσ 7. Αντιςτοίχιςθ Θζςθσ ςε Φοιτθτι int PsitinID : κωδικόσ Θζςθσ του ΑΤΛΑΣ Αντικείμενο Θζςθ (όπου πλζον περιλαμβάνει και τα ςτοιχεία του Φοιτθτι, POST:: AssignStudent int StudentID : κωδικόσ Φοιτθτι του ΑΤΛΑΣ αφοφ ζχει γίνει θ αντιςτοίχιςθ) DateTime ImplementatinStartDate : Ημερομθνία Εκκίνθςθσ Πρακτικισ DateTime ImplementatinEndDate: Ημερομθνία Τερματιςμοφ Πρακτικισ 8. Αλλαγι Στοιχείων Εκτζλεςθσ Πρακτικισ Άςκθςθσ int PsitinID : κωδικόσ Θζςθσ του ΑΤΛΑΣ Αντικείμενο Θζςθ με τα ανανεωμζνα ςτοιχεία τθσ εκτζλεςθσ POST:: ChangeImplementatinData DateTime ImplementatinStartDate : Ημερομθνία Εκκίνθςθσ Πρακτικισ DateTime ImplementatinEndDate: Ημερομθνία Τερματιςμοφ Πρακτικισ 9. Αλλαγι Επιλεγμζνου Φοιτθτι POST:: ChangeAssignedStudent int PsitinID : κωδικόσ Θζςθσ του ΑΤΛΑΣ int StudentID : κωδικόσ Φοιτθτι του ΑΤΛΑΣ Αντικείμενο Θζςθ με τα ανανεωμζνα ςτοιχεία τθσ αντιςτοίχιςθσ 10. Ακφρωςθ αντιςτοίχιςθσ Θζςθσ ςε Φοιτθτι POST:: DeleteAssignment POST:: DeleteAssignment/inf (μόνο ενθμζρωςθ για τισ πικανζσ ποινζσ) int PsitinID: κωδικόσ Θζςθσ του ΑΤΛΑΣ String ενθμζρωςθσ ςχετικά με το αποτζλεςμα τθν κλιςθσ. (inf)string με πλθροφορίεσ ςχετικά με τισ ποινζσ. 11. Λίςτα των αντιςτοιχιςμζνων Θζςεων από το ΓΠΑ POST:: GetAssignedPsitins int Skip {προαιρετικό} int Take {προαιρετικό} Λίςτα των Θζςεων που ζχει αντιςτοιχίςει το ΓΠΑ. Λίςτα από αντικείμενα Θζςθ 12. Διλωςθ ολοκλιρωςθσ τθσ πρακτικισ άςκθςθσ ςε μία Θζςθ POST:: CmpletePsitin int PsitinID: κωδικόσ Θζςθσ του ΑΤΛΑΣ string CmpletinCmments : Σχόλια ολοκλιρωςθσ DateTime ImplementatinStartDate : Ημερομθνία Πραγματικισ Εκκίνθςθσ Πρακτικισ Αντικείμενο Θζςθ με τα ανανεωμζνα ςτοιχεία τθσ DateTime ImplementatinEndDate: Ημερομθνία Πραγματικοφ Τερματιςμοφ Πρακτικισ Διαςφνδεςθ του Π.Σ. «ΑΤΛΑΣ» με πλθροφοριακά ςυςτιματα ΔΑΣΤΑ 20
13. Διλωςθ ανεπιτυχοφσ ολοκλιρωςθσ τθσ πρακτικισ άςκθςθσ ςε μία Θζςθ POST:: CancelPsitin int PsitinID: κωδικόσ Θζςθσ του ΑΤΛΑΣ string CancellatinReasn : Λόγοσ ακφρωςθσ ο λόγοσ τθσ ακφρωςθσ π.χ. «Ζγινε ακφρωςθ τθσ κζςθσ από το ΓΠΑ (ο φοιτθτισ δεν ολοκλιρωςε τθν πρακτικι του)» - 14. Λίςτα των Θζςεων που ζχουν δθλωκεί ωσ ολοκλθρωμζνεσ POST:: GetCmpletedPsitins int Skip {προαιρετικό} int Take {προαιρετικό} Λίςτα των Θζςεων που ζχει ολοκλθρϊςει το ΓΠΑ. Λίςτα από αντικείμενα Θζςθ Services για τον εντοπιςμό ι τθν εγγραφι Φοιτθτι 15. Λίςτα των εγγεγραμμζνων φοιτθτϊν του Ιδρφματοσ που εκπροςωπεί το ΓΠΑ POST:: GetRegisteredStudents int Skip {προαιρετικό} int Take {προαιρετικό} Λίςτα με τουσ εγγεγραμμζνουσ ςτο ΑΤΛΑΣ Φοιτθτζσ που φοιτοφν ςε Τμιματα που εκπροςωπεί το ΓΠΑ (πλιρθ ςτοιχεία κάκε φοιτθτι) Λίςτα από αντικείμενα Φοιτθτισ 16. Εμφάνιςθ των ςτοιχείων ενόσ εγγεγραμμζνου ςτο ΑΤΛΑΣ φοιτθτι GET:: GetStudentDetails int studentid : κωδικόσ Φοιτθτι του ΑΤΛΑΣ, ι string AcademicIDNumber: Ο κωδικόσ τθσ Ακ. Ταυτότθτασ του φοιτθτι, ι string PrincipalName: Το PrincipalName του φοιτθτι ςτον Κατάλογο Χρθςτϊν του Ιδρφματόσ του ι Τα πλιρθ ςτοιχεία του φοιτθτι και τθν τρζχουςα κατάςταςι του (π.χ. εκτελεί Πρακτικι, ζχει ολοκλθρϊςει Πρακτικι) Αντικείμενο Φοιτθτισ string StudentNumber: A.M. Φοιτθτι και int AcademicID: Κωδικόσ Τμιματοσ Φοιτθτι 17a. Αναηιτθςθ Φοιτθτι με 12ψιφιο ακαδθμαϊκισ ταυτότθτασ string AcademicIDNumber : Ο κωδικόσ τθσ Ακ. Ταυτότθτασ του φοιτθτι Τα πλιρθ ςτοιχεία φοιτθτι (Ονοματεπϊνυμο, Σχολι/Τμιμα) ανεξάρτθτα από το εάν ζχει εγγραφεί ςτο ΑΤΛΑΣ POST:: FindStudentWithAcademicIDNumber Αντικείμενο Φοιτθτισ 17b. Αναηιτθςθ 12ψιφιου ακαδθμαϊκισ ταυτότθτασ φοιτθτι POST:: FindAcademicIdNumber string StudentNumber: Αρικμόσ Μθτρϊου Φοιτθτι int AcademicID: Κωδικόσ Τμιματοσ Φοιτθτι (θ αναηιτθςθ γίνεται μόνο για τα Τμιματα που εξυπθρετεί το ΓΠΑ) Τα πλιρθ ςτοιχεία του Φοιτθτι, μαηί με τον 12ψιφιο τθσ ακαδθμαϊκισ ταυτότθτασ Αντικείμενο Φοιτθτισ 18. Εγγραφι φοιτθτι ςτο ΑΤΛΑΣ POST:: RegisterNewStudent string AcademicIDNumber : Κωδικόσ τθσ Ακαδθμαϊκισ Ταυτότθτασ του Φοιτθτι Τα πλιρθ ςτοιχεία του Φοιτθτι (μαηί με τον Κωδικό που πιρε θ εγγραφι του Φοιτθτι ςτο ΑΤΛΑΣ) Αντικείμενο Φοιτθτισ 19. Αλλαγι ςτοιχείων φοιτθτι ςτο ΑΤΛΑΣ POST:: UpdateStudent int ID : κωδικόσ Φοιτθτι του ΑΤΛΑΣ string AcademicIDNumber : Κωδικόσ τθσ Ακαδ. Ταυτότθτασ Τα πλιρθ ανανεωμζνα ςτοιχεία του Φοιτθτι Αντικείμενο Φοιτθτισ Διαςφνδεςθ του Π.Σ. «ΑΤΛΑΣ» με πλθροφοριακά ςυςτιματα ΔΑΣΤΑ 21
Web Services για τθν άντλθςθ Lkup Tables του ΑΤΛΑΣ Τίτλοσ του Web Service 20. Λίςτα Ακαδθμαϊκϊν Ιδρυμάτων GET:: GetAcademics 21. Λίςτα Σχολϊν/Τμθμάτων GET:: GetInstitutins 22. Λίςτα Καλλικρατικϊν Νομϊν GET:: GetPrefectures 23. Λίςτα Καλλικρατικϊν Διμων GET:: GetCities 24. Λίςτα Χωρϊν GET:: GetCuntries 25. Λίςτα Φυςικϊν Αντικειμζνων GET:: GetPhysicalObjects Αντικείμενα που επιςτρζφει το Web Service Η λίςτα με τα Ακαδθμαϊκά Ιδρφματα, με τα IDs που ζχουν αποδοκεί από τον ΑΤΛΑΣ ςε κάκε Κδρυμα int ID, int InstitutinID, string Institutin, string Schl, string Department Η λίςτα με τισ Σχολζσ/Τμιματα όλων των Ακαδθμαϊκϊν Ιδρυμάτων, με τα IDs που ζχουν αποδοκεί από το Υπουργείο Παιδείασ ςε κακζνα από αυτά (και που χρθςιμοποιοφνται από τον ΑΤΛΑΣ) int ID, string Name, string NameInLatin Η λίςτα με τουσ Νομοφσ και τουσ Καλλικρατικοφσ Διμουσ κάκε Νομοφ, με τα IDs που ζχουν αποδοκεί από τον ΑΤΛΑΣ ςε κάκε Νομό int ID, string Name Η λίςτα με τουσ Καλλικρατικοφσ Διμουσ κάκε Νομοφ, με τα IDs που ζχουν αποδοκεί από τον ΑΤΛΑΣ ςε κάκε Διμο int ID, string Name, int PrefectureID Η λίςτα με τισ Χϊρεσ, με το λεκτικό και τον κωδικό κάκε χϊρασ int ID, string Name Η λίςτα με τα Φυςικά Αντικείμενα των Γκρουπ Θζςεων Πρακτικισ int ID, string Name Διαςφνδεςθ του Π.Σ. «ΑΤΛΑΣ» με πλθροφοριακά ςυςτιματα ΔΑΣΤΑ 22
Web Services για τθν διλωςθ ολοκλθρωμζνθσ Θζςθσ Πρακτικισ Άςκθςθσ Περιγράφονται τα Web Services που παρζχει ο ΑΤΛΑΣ, προκειμζνου ζνα ΓΠΑ να μπορεί να καταχωρίςει ςτο ΑΤΛΑΣ ολοκλθρωμζνεσ Θζςεισ Πρακτικισ Άςκθςθσ τισ οποίεσ διαχειρίςτθκε εκτόσ του ΑΤΛΑΣ. Τίτλοσ του Web Service Παράμετροι κλιςθσ Αντικείμενα που επιςτρζφει το Web Service Ε1. Αναηιτθςθ ΦΥΠΑ ςτο ΑΤΛΑΣ με βάςθ το ΑΦΜ GET:: GetPrvidersByAFM Ε2. Διλωςθ Ολοκλθρωμζνθσ Θζςθσ Πρακτικισ POST:: RegisterFinishedPsitin string AFM : Αρικμόσ Φορολογικοφ Μθτρϊου του ΦΥΠΑ int PrviderID: Κωδι κόσ ΦΥΠ Α (Μοναδικό αναγνωριςτικό του ΦΥΠΑ ςτο ΑΤΛΑΣ. Δεν αλλάηει ποτζ) int StudentID : Κωδικόσ Φοιτθτι (Μοναδικό αναγνωριςτικό του Φοιτθτι ςτο ΑΤΛΑΣ. Δεν αλλάηει ποτζ) string Title : Τίτλοσ string Descriptin : Περιγραφι int Duratin : Διάρκεια int PsitinTypeInt : Είδοσ απαςχόλθςθσ (δυνατζσ τιμζσ: "1", "2" αντίςτοιχα) string Supervisr : Ονοματεπϊνυμο Επόπτθ string SupervisrEmail : Email Επόπτθ string CntactPhne : Τθλζφωνο επικοινωνίασ int CuntryID : Χϊρα (ID ΑΤΛΑΣ) int Prefecture ID : Νομόσ (ID ΑΤΛΑΣ) int CityID : Πόλθ (ID ΑΤΛΑΣ) List<string> PhysicalObjectsID : Αντικείμενο τθσ Θζςθσ (πολλαπλζσ τιμζσ από λίςτα προκακοριςμζνων ID) DateTime ImplementatinStartDate: Hμερομθνία ζναρξθσ τθσ Πρακτικισ Άςκθςθσ (από) DateTime ImplementatinEndDate : Hμερομθνία λιξθσ τθσ Πρακτικισ Άςκθςθσ (ζωσ) string ImplementatinStartDateString : Hμερομθνία ζναρξθσ τθσ Πρακτικισ Άςκθςθσ (από)- κείμενο string ImplementatinEndDateString : Hμερομθνία λιξθσ τθσ Πρακτικισ Άςκθςθσ (ζωσ) )-κείμενο string ImplementatinStartDateStringFrmat : Hμερομθνία ζναρξθσ τθσ Πρακτικισ Άςκθςθσ (από)-μορφι string ImplementatinEndDateStringFrmat : Hμερομθνία λιξθσ τθσ Πρακτικισ Άςκθςθσ (ζωσ)- μορφι string CmpletinCmments : Σχόλια Ολοκλιρωςθσ Λίςτα από αντικείμενα ΦΥΠΑ Ολοκλθρωμζνθ Θζςθ Πρακτικισ Άςκθςθσ ΓΠΑ Διαςφνδεςθ του Π.Σ. «ΑΤΛΑΣ» με πλθροφοριακά ςυςτιματα ΔΑΣΤΑ 23
Ε3. Ακφρωςθ Διλωςθσ Θζςθσ POST:: DeleteFinishedPsitin int PsitinID : κωδικόσ Θζςθσ Πρακτικισ που διλωςε το ΓΠΑ με το RegisterFinishedPsitin Διαςφνδεςθ του Π.Σ. «ΑΤΛΑΣ» με πλθροφοριακά ςυςτιματα ΔΑΣΤΑ - Ε4. Λίςτα των ολοκλθρωμζνων Θζςεων Πρακτικισ που διλωςε το ΓΠΑ εκ των υςτζρων ςτο ΑΤΛΑΣ int Skip {προαιρετικό} int Take {προαιρετικό} Λίςτα από αντικείμενα Θζςθ Για κάκε Θζςθ, τα πλιρθ ςτοιχεία τθσ (ςτοιχεία Θζςθσ, ΦΥΠΑ, Φοιτθτι, ςτοιχεία εκτζλεςθσ) GET:: GetFinishedPsitins Οδθγίεσ για τθ χριςθ των πεδίων ImplementatinEndDateStringFrmat, ImplementatinEndDateString και ImplementatinEndDate του web service RegisterFinishedPsitin Το ImplementatinEndDateStringFrmat δθλϊνει το frmat με το οποίο κα δθλωκεί θ θμερομθνία ςτο πεδίο ImplementatinEndDateString. Για παράδειγμα: ImplementatinEndDateStringFrmat = M/d/yy κάνει τθν τιμι ImplementatinEndDateString= 3/6/13 να ςθμαίνει 6 Μαρτίου 2013 ImplementatinEndDateStringFrmat = d/m/yy κάνει τθν τιμι ImplementatinEndDateString= 3/6/13 να ςθμαίνει 3 Ιουνίου 2013 Default τιμι για το ImplementatinEndDateStringFrmat είναι dd/mm/yyyy, οπότε θ 6 Μαρτίου 2013, κα πρζπει να δθλωκεί ImplementatinEndDateString= 06/03/2013 Το πεδίο ImplementatinEndDate χρθςιμεφει για τισ εφαρμογζσ που καλοφν τα Web Services και κάνουν χριςθ του MS.NET framewrk. Αυτζσ μποροφν να ανακζςουν μία θμερομθνία μζςω των ςχετικϊν προγραμματιςτικϊν αντικειμζνων του.net, για παράδειγμα: ImplementatinEndDate = DateTime.Nw; Εφόςον ζνα ΓΠΑ υλοποιεί τισ εφαρμογζσ που καλοφν τα Web Services του ΑΤΛΑΣ με άλλα προγραμματιςτικά περιβάλλοντα (εκτόσ του MS.NET) κα πρζπει να κάνει χριςθ των πεδίων ImplementatinEndDateStringFrmat και ImplementatinEndDateString (και όχι του ImplementatinEndDate). Όλα τα παραπάνω ιςχφουν για κάκε άλλο πεδίο θμερομθνίασ του web service RegisterFinishedPsitin αλλά και κάκε άλλου web service του ΑΤΛΑΣ. Διαςφνδεςθ του Π.Σ. «ΑΤΛΑΣ» με πλθροφοριακά ςυςτιματα ΔΑΣΤΑ 24
Παράρτθμα 3: Δοκιμαςτικό περιβάλλον των Web Services Η ςελίδα http://studentpractice.piltik.gr/api/ffices/v1/help εμφανίηει τθ λίςτα όλων των services Επιλζγοντασ ζνα από αυτά, παρζχονται αναλυτικζσ πλθροφορίεσ για τον τρόπο κλιςθσ του. Επιπλζον, ζχει υλοποιθκεί ζνα περιβάλλον ελζγχου των web services, ςτθ ςελίδα http://studentpractice.piltik.gr/brwse/servicetest.aspx Α. Στθ ςελίδα http://studentpractice.piltik.gr/brwse/servicetest.aspx (θ οποία καλεί το service Lgin) δίνουμε: Β. Μετά το Lgin μποροφμε να επιλζξουμε τθν λίςτα από τα Services, αν είναι τφπου POST ι GET Username: iknmik Passwrd: 123abc! Διαςφνδεςθ του Π.Σ. «ΑΤΛΑΣ» με πλθροφοριακά ςυςτιματα ΔΑΣΤΑ 25
Σε όςα services είναι τφπου GET (επιςτρζφουν λίςτα), μποροφμε να δϊςουμε τα ορίςματα με τθν εικονιηόμενθ μορφι. Εάν χρειάηεται να δϊςουμε ορίςματα ειςόδου, ακολουκοφμε τα JSON που περιγράφονται ςτθ ςελίδα http://studentpractice.piltik.gr/api/ffices/v1/help για κάκε Web Service. Διαςφνδεςθ του Π.Σ. «ΑΤΛΑΣ» με πλθροφοριακά ςυςτιματα ΔΑΣΤΑ 26