Εφαρμογή δείγματος στοιχείου API Web πύλης
Ακολουθεί ένα παράδειγμα υλοποίησης ενός στοιχείου κώδικα που χρησιμοποιεί το API Web πύλης για την εκτέλεση ενεργειών δημιουργίας, ανάκτησης, ενημέρωσης και διαγραφής. Το στοιχείο αποδίδεται με τέσσερα κουμπιά, στα οποία μπορείτε να κάνετε κλικ για να καλέσετε διαφορετικές ενέργειες Web API. Το αποτέλεσμα της κλήσης Web ΑΡΙ εισάγεται σε ένα στοιχείο HTML div στο κάτω μέρος του στοιχείου κώδικα.
Προϋποθέσεις
- Η έκδοση της πύλης σας πρέπει να είναι 9.3.10.x ή νεότερη.
- Το πακέτο πύλης εκκίνησης πρέπει να είναι 9.2.2103.x ή νεότερο.
- Θα χρειαστεί να ενεργοποιήσετε τη ρύθμιση τοποθεσίας για να ενεργοποιήσετε το API Web πυλών για την πύλη σας. Ρυθμίσεις τοποθεσίας για το Web API
- Ρύθμιση παραμέτρων ασφάλειας πίνακα χρησιμοποιώντας δικαίωμα πίνακα. Δικαιώματα πίνακα
Κωδικός
Μπορείτε να κάνετε λήψη του πλήρους στοιχείου δείγματος από εδώ.
Από προεπιλογή, στο δείγμα, το στοιχείο έχει ρυθμιστεί για την εκτέλεση της δημιουργίας, της ανάκτησης, ορισμός των πεδίων ονομάτων και εσόδων στα παραδείγματα Web ΑΡΙ.
Για να αλλάξετε την προεπιλεγμένη ρύθμιση παραμέτρων σε οποιονδήποτε πίνακα ή στήλη, ενημερώστε τις παρακάτω τιμές ρύθμισης παραμέτρων όπως φαίνεται
private static \_entityName = "account";
private static \_requiredAttributeName = "name";
private static \_requiredAttributeValue = "Web API Custom Control (Sample)";
private static \_currencyAttributeName = "revenue";
private static \_currencyAttributeNameFriendlyName = "annual revenue";
Η μέθοδος createRecord αποδίδει τρία κουμπιά, τα οποία σας επιτρέπουν να δημιουργήσετε μια καρτέλα λογαριασμού με το πεδίο εσόδων να έχει οριστεί σε διαφορετικές τιμές (100, 200, 300).
Όταν επιλέγετε ένα από τα κουμπιά δημιουργίας, το πρόγραμμα χειρισμού συμβάντων onClick του κουμπιού ελέγχει την τιμή του επιλεγμένου κουμπιού και χρησιμοποιεί την ενέργεια Web ΑΡΙ για να δημιουργήσει μια καρτέλα λογαριασμού με το πεδίο εσόδων να έχει οριστεί στην τιμή του κουμπιού. Το πεδίο ονόματος της καρτέλας λογαριασμού θα οριστεί σε στοιχείο κώδικα ΑΡΙ Web (Δείγμα) με μια τυχαία int προσαρτημένη στο τέλος της συμβολοσειράς. Η μέθοδος επιστροφής κλήσης από την κλήση API Web εισάγει το αποτέλεσμα της κλήσης (επιτυχία ή αποτυχία) στο αποτέλεσμα div του προσαρμοσμένου στοιχείου ελέγχου.
Η μέθοδος deleteRecord αποδίδει ένα κουμπί που διαγράφει την επιλεγμένη καρτέλα στην αναπτυσσόμενη λίστα. Το στοιχείο ελέγχου αναπτυσσόμενης λίστας σάς επιτρέπει να επιλέξετε την καρτέλα λογαριασμού που θέλετε να διαγράψετε. Αφού επιλέξετε μια καρτέλα λογαριασμού από την αναπτυσσόμενη λίστα και επιλέξετε το κουμπί Διαγραφή καρτέλας, η καρτέλα διαγράφεται. Η μέθοδος επιστροφής κλήσης από την κλήση API Web εισάγει το αποτέλεσμα της κλήσης (επιτυχία ή αποτυχία) στο αποτέλεσμα div του προσαρμοσμένου στοιχείου ελέγχου.
Η FetchXMLretrieveMultiple μέθοδος αποδίδει ένα κουμπί στο στοιχείο κώδικα. Όταν καλείται η onClick μέθοδος αυτού του κουμπιού,δημιουργείται FetchXML και μεταβιβάζεται στη retrieveMultiple συνάρτηση για τον υπολογισμό της μέσης τιμής του πεδίου εσόδων για όλες τις εγγραφές λογαριασμών. Η μέθοδος επιστροφής κλήσης από την κλήση API Web εισάγει το αποτέλεσμα της κλήσης (επιτυχία ή αποτυχία) στο αποτέλεσμα div του προσαρμοσμένου στοιχείου ελέγχου.
Η μέθοδος retrieveMultiple Odata αποδίδει ένα κουμπί στο στοιχείο κώδικα. Όταν καλείται η μέθοδος onClick αυτού του κουμπιού, δημιουργείται μια συμβολοσειρά OData και περνά στη συνάρτηση retrieveMultiple για ανάκτηση όλων των καρτελών λογαριασμών με ένα πεδίο ονόματος που είναι σαν Web ΑΡΙ στοιχείου κώδικα (Δείγμα), το οποίο ισχύει για όλες τις καρτέλες λογαριασμών που δημιουργούνται από αυτό το στοιχείο κώδικα.
Με την επιτυχή ανάκτηση των καρτελών, το στοιχείο κώδικα έχει λογική για τη μέτρηση πόσες καρτέλες λογαριασμών έχουν το πεδίο εσόδων ορισμένο σε 100, 200 ή 300 και εμφανίζει αυτό το πλήθος σε ένα κοντέινερ div κατάστασης OData στο στοιχείο κώδικα. Η μέθοδος επιστροφής κλήσης από την κλήση API Web εισάγει το αποτέλεσμα της κλήσης (επιτυχία ή αποτυχία) στο αποτέλεσμα div του προσαρμοσμένου στοιχείου ελέγχου.