Μετάβαση στο περιεχόμενο

OData

Το OData αντιμετωπίζεται ως πλήρες πρωτόκολλο, και όχι ως HTTP που πρέπει να διακοσμήσετε μόνοι σας: το Restorm γνωρίζει τις επιλογές συστήματός του, τις λειτουργίες του και τη μορφή παρτίδας του.

Δεξί κλικ στο δέντρο ▸ Προσθήκη ▸ Αίτημα OData.

Μια καρτέλα OData με τον επεξεργαστή επιλογών ερωτήματος — $filter, $select, $top, $count, $orderby — και την προεπισκόπηση της συναρμολογημένης διεύθυνσης URL στο κάτω μέρος

ΠεδίοΡόλος
URLΤο σημείο εισόδου της υπηρεσίας, μαζί με το σύνολο οντοτήτων
Έκδοση ODatav2, v3, v4 ή v4.01
Τύπος λειτουργίαςentity-set, function, action ή batch
Κεφαλίδες / ΠαράμετροιΌπως και για ένα αίτημα HTTP

Οι επιλογές συστήματος έχουν η καθεμία το πεδίο της:

$filter · $select · $top · $skip · $count · $expand · $orderby · $search · $format (json, xml, atom) · $apply (συνάθροιση, v4.01).

Το πεδίο $filter απολαμβάνει αυτόματη συμπλήρωση τροφοδοτούμενη από τα εισαγόμενα μεταδεδομένα: προτείνονται τα ονόματα ιδιοτήτων και οι τελεστές.

Συναρτήσεις και ενέργειες

Section titled “Συναρτήσεις και ενέργειες”

Για τα function και action, είναι διαθέσιμη μια λίστα παραμέτρων λειτουργίας με τύπο — όνομα, πλήρως προσδιορισμένος τύπος CSDL, δυνατότητα κενής τιμής, ένδειξη σύνδεσης — και, για μια ενέργεια, ένα ειδικό σώμα JSON.

Η λειτουργία batch φέρει μια λίστα υποαιτημάτων, καθένα με τη μέθοδό του, τη διεύθυνση URL του, τις κεφαλίδες του, το σώμα του και ενδεχομένως την ομάδα ατομικότητάς του (change set). Δύο επιλογές:

  • Μορφή: multipart (εξ ορισμού) ή json·
  • Να επιτρέπονται τα GET μέσα σε ένα change set: απενεργοποιημένο εξ ορισμού· η ενεργοποίησή του προκαλεί μια προειδοποίηση, καθώς το OData δεν το προβλέπει.

Εισαγωγή των μεταδεδομένων

Section titled “Εισαγωγή των μεταδεδομένων”

Εισαγάγετε ένα $metadata ή ένα .edmx: το Restorm δημιουργεί έναν φάκελο ανά σύνολο οντοτήτων με τα αιτήματα CRUD του, συν φακέλους Actions και Functions. Τα αιτήματα φτάνουν προσυμπληρωμένα με τον τύπο οντότητας, τις ιδιότητες, τις ιδιότητες πλοήγησης και τις επιλογές ερωτήματος. Δείτε Εισαγωγή OData.

Το Restorm ξέρει να φιλοξενεί μια υπηρεσία OData v4 προσομοίωσης: παρέχετε το έγγραφο CSDL των μεταδεδομένων (που σερβίρεται ως έχει) και τα δεδομένα ανά σύνολο οντοτήτων. Οι επιλογές συστήματος εφαρμόζονται στα δεδομένα που σερβίρονται. Δείτε Προσομοίωση μιας υπηρεσίας OData.