Η υπηρεσία παροχής δεδομένων OData v4, απαιτήσεις και βέλτιστες πρακτικές

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

Βέλτιστες πρακτικές για την υπηρεσία παροχής δεδομένων OData v4

• Το Microsoft Dataverse απαιτεί όλοι οι πίνακες να έχουν ένα χαρακτηριστικό ID (αναγνωριστικό). Αυτό το αναγνωριστικό είναι γνωστό ως ένα μοναδικό αναγνωριστικό και η τιμή πρέπει να είναι guid. Μπορείτε να αντιστοιχίζετε μόνο στήλες αναγνωριστικού με εξωτερικές στήλες με τον τύπο δεδομένων Edm.Guid. Δεν μπορείτε να αντιστοιχίσετε έναν τύπο δεδομένων Edm.Int32 σε μια στήλη τύπου δεδομένων Μοναδικό αναγνωριστικό στο Dataverse.
• Οι OData πίνακες με ιδιότητες που επιδέχονται τιμές null πρέπει να οριστούν ώστε να ταιριάζουν με τη στήλη που είναι αντιστοιχισμένη στον εικονικό πίνακα. Για παράδειγμα, μια ιδιότητα πίνακα OData με δυνατότητα χρήσης τιμών null = False πρέπει να έχει την αντιστοιχισμένη στήλη στο χαρακτηριστικό του Dataverse Απαιτούμενο πεδίο ορισμένο σε Απαιτείται από επιχείρηση.
• Για να ανακτήσετε πολλά ερωτήματα, όπως όταν γίνεται φόρτωση των δεδομένων σε ένα πλέγμα, για έλεγχο του μεγέθους του συνόλου δεδομένων που επιστρέφονται από την εξωτερική προέλευση δεδομένων, χρησιμοποιώντας την επιλογή και φιλτράρετε τις παραμέτρους ερωτήματος.
• Εάν δεν είναι ήδη ενεργοποιημένη, οι διαχειριστές συστήματος πρέπει να ενεργοποιήσουν την ανίχνευση προσθήκης. Μετά από την ενεργοποίηση, από το τελικό σημείο OData όλα τα σφάλματα καταγράφονται στο αρχείο καταγραφής ανίχνευσης προσθηκών. Περισσότερες πληροφορίες: Οδηγός διαχειριστή: Παράθυρο διαλόγου ρυθμίσεων συστήματος - Καρτέλα προσαρμογής
• Δεν μπορείτε να χρησιμοποιήσετε την υπηρεσία παροχής δεδομένων OData v4 για να συνδεθείτε σε άλλο περιβάλλον.

Αντιστοίχιση τύπου δεδομένων

Ο παρακάτω πίνακας εμφανίζει τις αντιστοιχίσεις του τύπου δεδομένων OData table Data Model (EDM) με τύπους δεδομένων Dataverse.

Τύπος δεδομένων OData	Τύπος δεδομένων Dataverse
Edm.Boolean	Δύο επιλογές
Edm.DateTime	Ημερομηνία και ώρα
Edm.DateTimeOffset	Ημερομηνία και ώρα
Edm.Decimal	Δεκαδικός αριθμός ή νόμισμα
Edm.Double	Αριθμός κινητής υποδιαστολής
Edm.Guid	Μοναδικό αναγνωριστικό
Edm.Int32	Ακέραιος αριθμός
Edm.Int64	Ακέραιος αριθμός
Edm.String	Μονή γραμμή κειμένου ή πολλές γραμμές κειμένου

Οι τύποι δεδομένων OData EDM που δεν υποστηρίζονται για αντιστοίχιση με εικονικούς πίνακες

• Edm.Binary
• Edm.Time
• Edm.Float
• Edm.Single
• Edm.Int16
• Edm.Byte
• Edm.SByte

Προσθέστε μια προέλευση δεδομένων που χρησιμοποιεί η υπηρεσία παροχής δεδομένων OData v4

Αυτή η διαδικασία σάς δείχνει τον τρόπο χρήσης της έτοιμης υπηρεσίας παροχής δεδομένων OData που θα χρησιμοποιήσετε ως υπηρεσία παροχής δεδομένων εικονικού πίνακα.

1. Μεταβείτε στις Ρυθμίσεις > Διαχείριση > Εικονικές προελεύσεις δεδομένων οντότητας.

2. Στη γραμμή εργαλείων "Ενέργειες", επιλέξτε το στοιχείο Νέα.

3. Στο παράθυρο διαλόγου Επιλέξτε την υπηρεσία παροχής δεδομένων, επιλέξτε από τα ακόλουθα αρχεία προέλευσης δεδομένων και, στη συνέχεια, κάντε κλικ στο κουμπί OK.

   • Υπηρεσία παροχής δεδομένων OData v4. Το Dataverse περιλαμβάνει μια υπηρεσία παροχής δεδομένων Odata v4 που μπορεί να χρησιμοποιηθεί για τη σύνδεση σε προελεύσεις δεδομένων που υποστηρίζουν το ανοικτό πρότυπο OData v4.
   • Προσαρμοσμένη υπηρεσία παροχής δεδομένων. Εάν έχετε εισαγάγει ένα πρόσθετο υπηρεσίας παροχής δεδομένων, η υπηρεσία παροχής δεδομένων θα εμφανιστεί εδώ. Περισσότερες πληροφορίες: Τεκμηρίωση προγραμματιστή: Γρήγορα αποτελέσματα με τους εικονικούς πίνακες

4. Στη σελίδα ιδιοτήτων νέας προέλευσης δεδομένων, συμπληρώστε τις ακόλουθες στήλες και, στη συνέχεια, αποθηκεύστε τη γραμμή.

   • Όνομα. Πληκτρολογήστε ένα όνομα που περιγράφει την προέλευση δεδομένων.
   • Uri. Εάν χρησιμοποιείτε την υπηρεσία παροχής OData, εισαγάγετε το uri για την υπηρεσία web OData. Για παράδειγμα, εάν χρησιμοποιείτε την υπηρεσία παροχής OData για να συνδεθείτε σε μια υπηρεσία web που φιλοξενείται στο Azure, το URI μπορεί να μοιάζει με https://contosodataservice.azurewebsites.net/odata/.
   • Χρονικό όριο σε δευτερόλεπτα. Πληκτρολογήστε τον αριθμό των δευτερολέπτων αναμονής για μια απόκριση από την υπηρεσία web πριν από τη λήξη μιας αίτησης δεδομένων. Για παράδειγμα, πληκτρολογήστε 30 για αναμονή μέχρι 30 δευτερόλεπτα πριν λήξει το χρονικό όριο.
   • Λειτουργία σελιδοποίησης. Επιλέξτε αν θα χρησιμοποιήσετε σελιδοποίηση από την πλευρά του προγράμματος-πελάτη ή του διακομιστή για να ελέγξετε το πώς είναι σελιδοποιημένα τα αποτελέσματα του ερωτήματος. Η προεπιλεγμένη τιμή είναι σελιδοποίηση από την πλευρά του υπολογιστή-πελάτη. Με σελιδοποίηση από την πλευρά του διακομιστή, ο διακομιστής ελέγχει τον τρόπο σελιδοποίησης των αποτελεσμάτων χρησιμοποιώντας την παράμετρο $skiptoken που προστίθεται στη συμβολοσειρά ερωτήματος. Περισσότερες πληροφορίες: Παράβλεψη επιλογής ερωτήματος διακριτικού συστήματος ($skiptoken)
     • Επιστροφή πλήθους ενσωματωμένων. Επιστρέφει τις συνολικές γραμμές στο σύνολο αποτελεσμάτων. Αυτή η ρύθμιση χρησιμοποιείται για την ενεργοποίηση της δυνατότητας επόμενης σελίδας, όταν επιστρέφετε δεδομένα σε ένα πλέγμα. Χρησιμοποιήστε την τιμή false αν το τελικό σημείο OData δεν υποστηρίζει την παράμετρο OData $inlinecount. Η προεπιλεγμένη τιμή είναι false.
   • Παράμετροι αίτησης. Προαιρετικά, μπορείτε να προσθέσετε την προσαρμοσμένη κεφαλίδα ή παραμέτρους συμβολοσειράς ερωτήματος που χρησιμοποιούνται για τη σύνδεση στην υπηρεσία web OData, όπως τις παραμέτρους ελέγχου ταυτότητας για την εξωτερική υπηρεσία. Κάντε κλικ στο κουμπί Συμβολοσειρά ερωτήματος για την εναλλαγή μεταξύ κεφαλίδας και παραμέτρου συμβολοσειράς ερωτήματος και τιμής. Έως 10 κεφαλίδες ή συμβολοσειρές ερωτήματος μπορούν να προστεθούν.

     

Δείτε επίσης

Δημιουργία και επεξεργασία εικονικών πινάκων που περιέχουν εξωτερικά δεδομένα

Σημείωση

Μπορείτε να μας πείτε ποια γλώσσα προτιμάτε για την τεκμηρίωση; Πάρτε μέρος σε μια σύντομη έρευνα. (σημειώνεται ότι αυτή η έρευνα είναι στα Αγγλικά)

Η έρευνα θα διαρκέσει περίπου επτά λεπτά. Δεν συλλέγονται προσωπικά δεδομένα (δήλωση προστασίας προσωπικών δεδομένων).