Δημιουργία προσαρμοσμένου API στο Power Apps

Αυτό το άρθρο εξηγεί πώς μπορείτε να δημιουργήσετε ένα προσαρμοσμένο API σε Power Apps για Microsoft Dataverse χρησιμοποιώντας μια λύση. Ακολουθήστε αυτά τα βήματα για να ορίσετε ιδιότητες αίτησης και απόκρισης, να δοκιμάσετε το προσαρμοσμένο API και να συσχετίσετε τον τύπο προσθήκης. Εάν δεν είστε εξοικειωμένοι με τις λύσεις, διαβάστε πρώτα το θέμα Δημιουργία λύσης.

Η λύση σας πρέπει να συσχετίζεται με έναν εκδότη. Ο εκδότης έχει ένα συγκεκριμένο πρόθεμα προσαρμογής που σχετίζεται με αυτό. Πρέπει να χρησιμοποιήσετε ένα πρόθημα προσαρμογής κατά τη δημιουργία ενός προσαρμοσμένου API και αυτό το πρόθεμα θα πρέπει να είναι το ίδιο πρόθεμα που χρησιμοποιείται από τον εκδότη της λύσης σας. Οι ακόλουθες οδηγίες χρησιμοποιούν την τιμή sample ως πρόθημα προσαρμογής, επειδή είναι αυτό που έχει οριστεί για τον εκδότη.

Σημαντικό

• Υπάρχει τώρα μια καλύτερη εμπειρία για τη δημιουργία προσαρμοσμένου API. Μπορείτε να χρησιμοποιήσετε ένα εργαλείο σχεδίασης στο εργαλείο καταχώρησης προσθηκών. Για περισσότερες πληροφορίες, ανατρέξτε στο θέμα Δημιουργία προσαρμοσμένου API με το εργαλείο καταχώρησης προσθηκών.
• Δεν μπορείτε να αλλάξετε πολλά πεδία που σχετίζονται με τη δημιουργία προσαρμοσμένου API αφού τα δημιουργήσετε. Σχεδιάστε προσεκτικά τη σχεδίαση του προσαρμοσμένου API προτού ξεκινήσετε. Εάν αποφασίσετε αργότερα ότι χρειάζεται να αλλάξετε αυτά τα πεδία, ίσως χρειαστεί να διαγράψετε την υπάρχουσα εγγραφή και να δημιουργήσετε εκ νέου το προσαρμοσμένο API. Για περισσότερες πληροφορίες, ανατρέξτε στο θέμα Πίνακες CustomAPI.

Δημιουργία προσαρμοσμένης εγγραφής API

1. Στη λύση σας, επιλέξτε Νέο>περισσότερα>άλλα>προσαρμοσμένα API από την αναπτυσσόμενη λίστα.

2. Επεξεργαστείτε τα πεδία για να ορίσετε τις ιδιότητες του προσαρμοσμένου API σας. Ορίστε τιμές για τα παρακάτω πεδία. Για περισσότερες πληροφορίες, ανατρέξτε στο θέμα Προσαρμοσμένες στήλες πίνακα API.

   Δεν μπορείτε να ορίσετε τιμές για Τύπο προσθήκης πριν από τη δημιουργία της προσθήκης. Μπορείτε να αλλάξετε αυτή την τιμή αργότερα.

3. Επιλέξτε Αποθήκευση. Η φόρμα σας θα πρέπει να μοιάζει με την παρακάτω εικόνα:

Δημιουργία παραμέτρων αίτησης

Ένα προσαρμοσμένο API δεν απαιτεί παραμέτρους. Δημιουργήστε όσες παραμέτρους χρειάζεστε για να διαβιβάσετε τα δεδομένα που απαιτούνται για τη λογική σας.

1. Στη λύση σας, επιλέξτε Νέα>περισσότερες>άλλες>προσαρμοσμένες παραμέτρους αίτησης API από την αναπτυσσόμενη λίστα.

2. Επεξεργαστείτε τα πεδία για να ορίσετε τις ιδιότητες της προσαρμοσμένης παραμέτρου αίτησης API. Για περισσότερες πληροφορίες, ανατρέξτε στο θέμα CustomAPIRequestParameter Table Columns.

3. Επιλέξτε Αποθήκευση. Η φόρμα σας θα πρέπει να μοιάζει με την παρακάτω εικόνα:

   

Δημιουργία ιδιοτήτων απόκρισης

Ένα προσαρμοσμένο API που αντιπροσωπεύει μια ενέργεια δεν απαιτεί ιδιότητες απόκρισης. Μια συνάρτηση πρέπει να έχει τουλάχιστον μία. Εάν η λειτουργία είναι επιτυχής, επιστρέφει μια απόκριση επιτυχίας. Εάν αποτύχει, επιστρέφει ένα σφάλμα. Καθορίστε ιδιότητες απόκρισης για οποιαδήποτε δεδομένα επιστρέφει το API σας.

Εάν ορίσετε μόνο μία ιδιότητα απόκρισης Οντότητα ή EntityCollection , η απόκριση είναι αυτού του τύπου. Εάν ορίσετε πολλές ιδιότητες ή μία ή περισσότερες ιδιότητες ενός απλού τύπου, το API επιστρέφει έναν σύνθετο τύπο όπου κάθε ιδιότητα απόκρισης είναι μια ιδιότητα αυτού του σύνθετου τύπου.

Για παράδειγμα, εάν το προσαρμοσμένο μοναδικό όνομα API σας είναι sample_CustomAPIExample, επιστρέφει έναν σύνθετο τύπο με όνομα sample_CustomAPIExampleResponse με ιδιότητες για κάθε ιδιότητα απόκρισης που ορίζετε.

1. Στη λύση σας, επιλέξτε Νέα>περισσότερες>άλλες>προσαρμοσμένες ιδιότητα απόκρισης API από την αναπτυσσόμενη λίστα.

2. Επεξεργαστείτε τα πεδία για να ορίσετε τις ιδιότητες της προσαρμοσμένης σας ιδιότητας απόκρισης API. Για περισσότερες πληροφορίες, ανατρέξτε στο θέμα CustomAPIResponseProperty Table Columns.

3. Επιλέξτε Αποθήκευση. Η φόρμα σας θα πρέπει να μοιάζει με την παρακάτω εικόνα:

   

Παρατηρήστε το αποτέλεσμα στο έγγραφο υπηρεσίας

Εάν δεν ορίσετε την ιδιότητα για το IsPrivate προσαρμοσμένο API σας, μπορείτε να ανακτήσετε τον ορισμό υπηρεσίας από το CSDL $metadata έγγραφο , χρησιμοποιώντας μια GET αίτηση, ακόμα και από το πρόγραμμα περιήγησής σας. Εάν η διεύθυνση URL για το περιβάλλον σας είναι https://yourorg.crm.dynamics.com, μπορείτε να πληκτρολογήσετε αυτήν τη διεύθυνση URL στο πεδίο διεύθυνσης του προγράμματος περιήγησης για να ανακτήσετε το $metadata: https://yourorg.crm.dynamics.com/api/data/v9.1/$metadata.

Κάντε αναζήτηση στο αποτέλεσμα για να βρείτε το όνομα του προσαρμοσμένου API. Για παράδειγμα, το API που ορίζεται χρησιμοποιώντας τα προηγούμενα βήματα μοιάζει κάπως έτσι:

<ComplexType Name="sample_CustomAPIExampleResponse">
    <Property Name="StringProperty" Type="Edm.String" Unicode="false" />
</ComplexType>
<Action Name="sample_CustomAPIExample">
    <Parameter Name="StringParameter" Type="Edm.String" Nullable="false" Unicode="false" />
    <ReturnType Type="mscrm.sample_CustomAPIExampleResponse" Nullable="false" />
</Action>

Δοκιμή του προσαρμοσμένου API σας

Αφού δημιουργήσετε το προσαρμοσμένο API, μπορείτε να το δοκιμάσετε. Ακόμα και αν δεν ορίσετε έναν τύπο προσθήκης για να ορίσετε την κύρια λειτουργία, μπορείτε να την δοκιμάσετε τώρα για να επαληθεύσετε ότι μπορείτε να την καλέσετε σωστά. Οποιεσδήποτε ιδιότητες απόκρισης επιστρέφουν την προεπιλεγμένη τιμή τους, όπως null. Για περισσότερες πληροφορίες, ανατρέξτε στο θέμα Κλήση προσαρμοσμένων API.

Ενημέρωση του προσαρμοσμένου τύπου προσθήκης API

Για πληροφορίες σχετικά με τον τρόπο εγγραφής μιας προσθήκης για ένα προσαρμοσμένο API, ανατρέξτε στο θέμα Εγγραφή προσθήκης για το προσαρμοσμένο API σας.

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

Αφού ορίσετε τον τύπο προσθήκης, μπορείτε να δοκιμάσετε το προσαρμοσμένο API για να επαληθεύσετε ότι επιστρέφονται τα σωστά αποτελέσματα.

Άλλοι τρόποι για να δημιουργήσετε προσαρμοσμένα API

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

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

Η διαδικασία ALM μπορεί να εξυπηρετηθεί καλύτερα με τη δημιουργία προσαρμοσμένων API με την επεξεργασία αρχείων λύσης. Για περισσότερες πληροφορίες, ανατρέξτε στο θέμα Δημιουργία προσαρμοσμένου API με αρχεία λύσης.

Δείτε επίσης

Δημιουργία και χρήση προσαρμοσμένων API
Δημιουργία προσαρμοσμένου API με χρήση του εργαλείου καταχώρησης προσθηκών
Δημιουργία προσαρμοσμένου API με κώδικα
Δημιουργία προσαρμοσμένου API με αρχεία λύσης
Δημιουργία των δικών σας μηνυμάτων