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

Αυτό το θέμα ισχύει για το Dynamics 365 Customer Engagement (on-premises). Για την έκδοση Power Apps αυτού του θέματος, δείτε: Υπηρεσία παροχής δεδομένων OData v4 εικονικού πίνακα

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

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

• Η παρουσία σας απαιτεί ότι όλες οι οντότητες να έχουν χαρακτηριστικό "Αναγνωριστικό". Αυτό το Αναγνωριστικό είναι γνωστό ως ένα μοναδικό αναγνωριστικό και η τιμή πρέπει να είναι guid. Μπορείτε να αντιστοιχίζετε μόνο πεδία αναγνωριστικού με εξωτερικά πεδία με τον τύπο δεδομένων EDM.Guid. Δεν μπορείτε να αντιστοιχίσετε έναν τύπο δεδομένων EDM.Int32 σε ένα πεδίο τύπου δεδομένων uniqueidentifer.

• Οι OData οντότητες με ιδιότητες που επιδέχονται τιμές null πρέπει να οριστούν ώστε να ταιριάζουν με το πεδίο που είναι αντιστοιχισμένο στην εικονική οντότητα. Για παράδειγμα, μια ιδιότητα οντότητας OData με Nullable=False πρέπει να έχει το αντιστοιχισμένο πεδίο με το απαιτούμενο πεδίο χαρακτηριστικών ορισμένο στο Απαιτείται από επιχείρηση.

• Για να ανακτήσετε πολλά ερωτήματα, όπως όταν γίνεται φόρτωση των δεδομένων σε ένα πλέγμα, για έλεγχο του μεγέθους του συνόλου δεδομένων που επιστρέφονται από την εξωτερική προέλευση δεδομένων, χρησιμοποιώντας την επιλογή και φιλτράρετε τις παραμέτρους ερωτήματος.

• Εάν δεν είναι ήδη ενεργοποιημένη, οι διαχειριστές συστήματος πρέπει να ενεργοποιήσουν την ανίχνευση προσθήκης. Μετά από την ενεργοποίηση, από το τελικό σημείο OData όλα τα σφάλματα καταγράφονται στο αρχείο καταγραφής ανίχνευσης προσθηκών. Περισσότερες πληροφορίες: Παράθυρο διαλόγου Ρυθμίσεις συστήματος-Καρτέλα προσαρμογής

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

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

Τύπος δεδομένων OData	Τύπος δεδομένων
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. Το περιβάλλον σας περιλαμβάνει μια υπηρεσία παροχής δεδομένων 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 $inclinecount. Η προεπιλεγμένη τιμή είναι false.

   • Παράμετροι αίτησης. Προαιρετικά, μπορείτε να προσθέσετε την προσαρμοσμένη κεφαλίδα ή παραμέτρους συμβολοσειράς ερωτήματος που χρησιμοποιούνται για τη σύνδεση στην υπηρεσία web OData, όπως τις παραμέτρους ελέγχου ταυτότητας για την εξωτερική υπηρεσία. Κάντε κλικ στο κουμπί Συμβολοσειρά ερωτήματος για την εναλλαγή μεταξύ κεφαλίδας και παραμέτρου συμβολοσειράς ερωτήματος και τιμής. Έως 10 κεφαλίδες ή συμβολοσειρές ερωτήματος μπορούν να προστεθούν.

   

Δείτε επίσης

Δημιουργία και επεξεργασία εικονικών οντοτήτων που περιέχουν εξωτερικα δεδομένα
Ιστολόγιο TechNet: Αλληλεπίδραση με δεδομένα από εξωτερικά συστήματα με χρήση νέων "εικονικών" οντοτήτων