Κοινοποίηση μέσω


Κλήση συνάρτησης από εφαρμογή, ροή, κώδικα ή άλλη συνάρτηση (προεπισκόπηση)

[Αυτό το θέμα αποτελεί τεκμηρίωση προέκδοσης και υπόκειται σε αλλαγές.]

Μπορείτε να καλέσετε συναρτήσεις στο Dataverse από μια εφαρμογή καμβά, μια προσαρμοσμένη σελίδα σε μια εφαρμογή βάσει μοντέλου, μια ροή, κώδικα ή από άλλη συνάρτηση.

Σημαντικό

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

Κλήση μιας συνάρτησης από μια εφαρμογή καμβά ή μια προσαρμοσμένη σελίδα

  1. Από την περιοχή Συναρτήσεις στο Power Apps (make.powerapps.com), επιλέξτε τη συνάρτηση που θέλετε να καλέσετε από μια εφαρμογή καμβά ή μια προσαρμοσμένη σελίδα.
  2. Επιλέξτε Αντιγραφή τμήματος κώδικα στη γραμμή εντολών.
  3. Επικολλήστε και αποθηκεύστε τον τύπο που αντιγράψατε σε ένα πρόγραμμα επεξεργασίας κειμένου, στο Σημειωματάριο ή σε κάποιο σημείο στο οποίο μπορείτε εύκολα να αναφερθείτε.
  4. Στο Power Apps Studio:
    1. Δημιουργήστε ή επεξεργαστείτε μια εφαρμογή καμβά ή μια προσαρμοσμένη σελίδα στο Power Apps Studio.
    2. Στο αριστερό παράθυρο περιήγησης, στην καρτέλα Προελεύσεις δεδομένων , επιλέξτε Προσθήκη δεδομένων και αναζητήστε την επιλογή Περιβάλλον από τη σύνδεση Dataverse και επιλέξτε την.
    3. Εισαγάγετε τα ακόλουθα στοιχεία στον καμβά:
      • Προσθέστε στοιχεία ελέγχου εισόδου που αντιστοιχούν στον τύπο δεδομένων κάθε παραμέτρου, όπως εισαγωγή αριθμού.
      • Προσθέστε ένα κουμπί για να καλέσετε τη συνάρτηση.
      • Προσθέστε ένα στοιχείο ελέγχου εξόδου που αντιστοιχεί με τον τύπο δεδομένων της παραμέτρου, όπως εισαγωγή αριθμού.
  5. Επιλέξτε το κουμπί που δημιουργήσατε και, στην ιδιότητα OnSelect , εισαγάγετε τη συνάκησή σας, όπως Environment.new_calculatesum.
  6. Αντιστοιχίστε κάθε παράμετρο εισόδου Value για να γίνει αναφορά στα αντίστοιχα στοιχεία ελέγχου εισαγωγής:
    • Εάν η συνάφειά σας είναι Environment.new_CalculateSum({ X: Value, Y: Value });, μπορεί να γραφτεί ξανά ως: Environment.new_CalculateSum({ X: NumberInput1.value, Y: NumberInput2.value });.
    • Για να ορίσετε την έξοδο "αποτέλεσμα" της συνάρτησης, ενημερώστε τον τύπο σας σε "Set(result, Environment.new_CalculateSum({ X: NumberInput1.value, Y: NumberInput2.value }))".
  7. Επιλέξτε το στοιχείο ελέγχου εξόδου και ορίστε την ιδιότητα "Value" με έναν τύπο "result.z".

Κάντε προεπισκόπηση της εφαρμογής σας, εισαγάγετε τις τιμές εισόδου 1 και 2 και επιλέξτε το κουμπί. Το αποτέλεσμα θα πρέπει να εμφανίζεται στο πεδίο εξόδου.

Κλήση συναρτήσεων από μια ροή cloud του Power Automate

  1. Σε μια ροή cloud, προσθέστε μια νέα ενέργεια από τη σύνδεση του Microsoft Dataverse.
  2. Επιλέξτε την ενέργεια με την ονομασία Εκτέλεση μη δεσμευμένης ενέργειας
  3. Επιλέξτε τη λειτουργία σας. Η συνάρτηση έχει ένα μοναδικό όνομα με πρόθεμα.
  4. Καταχωρήστε τιμές για όλες τις παραμέτρους εισόδου (εάν υπάρχουν).

Κλήση συναρτήσεων από το Dataverse Web API

Ακολουθήστε τα βήματα για τις ενότητες μη δεσμευμένης ενέργειας στο άρθρο Κλήση προσαρμοσμένων API από το Web API (ανάλογα με την κατάλληλη εμβέλεια της προσθήκης).

Κλήση υπαρχουσών συναρτήσεων από το εσωτερικό νέων συναρτήσεων

Για να καλέσετε μια υπάρχουσα συνάρτηση μέσα σε μια νέα συνάρτηση, χρησιμοποιήστε τη σύνταξη: Environment.ExistingFunction({inputParam1: value1, inputParam2: value2, ... inputParamN: valueN})

Δεδομένου ότι η έξοδος είναι πάντα μια εγγραφή, χρησιμοποιήστε τη σημειογραφία κουκκίδων για να αποκτήσετε πρόσβαση στις παραμέτρους εξόδου. Για παράδειγμα, εάν η συνάρτηση "ExistingFunction" έχει δύο παραμέτρους εξόδου που ορίζονται ως out1 και out2, μπορείτε να αποκτήσετε πρόσβαση σε αυτές με έναν από τους εξής δύο τρόπους:

  • Environment.ExistingFunction({inputParam1: value1, inputParam2: value2, ... inputParamN: valueN}).out1
  • Environment.ExistingFunction({inputParam1: value1, inputParam2: value2, ... inputParamN: valueN}).out2

Περιορισμοί με συναρτήσεις στο Dataverse

  • Το αντικείμενο γλώσσας περιβάλλοντος πρέπει να διαβαστεί για πρόσβαση σε νέες συναρτήσεις μέσα σε υπάρχουσες εφαρμογές καμβά. Για τυχόν συναρτήσεις που δημιουργήθηκαν μετά την προσθήκη της προέλευσης δεδομένων πίνακα περιβάλλοντος σε μια υπάρχουσα εφαρμογή καμβά, πρέπει να καταργήσετε και διαβάσετε το αντικείμενο γλώσσας περιβάλλοντος Power Fx. Στη συνέχεια, βλέπετε την ενημερωμένη λίστα συναρτήσεων ως ενέργειες.
  • Ένθετη υποστήριξη. Οι συναρτήσεις μπορούν να καλούν μόνο ενέργειες της Microsoft που δημοσιεύονται από τη Microsoft από παραστάσεις Power Fx.
  • Ορισμένα σενάρια Collect απαιτούν Patch. Υπάρχουν ορισμένα σενάρια όπου το Collect() δεν λειτουργεί. Η λύση είναι να τη χρησιμοποιήσετε Patch() όπως φαίνεται στο παράδειγμα συμπλήρωσης σχετικά με τη στήλη εδώ.
Patch(Faxes,
       Collect(Faxes, {  Subject : "Sub1" } ),
       { Regarding : First(Accounts) }
    )

Εντοπισμός σφαλμάτων και λήψη βοήθειας για τις συναρτήσεις σας

Εάν αντιμετωπίσετε προβλήματα κατά τη δημιουργία ή την εκτέλεση της συνάθροισής σας, χρησιμοποιήστε τη trace() συνάρτηση για τον εντοπισμό σφαλμάτων ή μεταβείτε στην ενότητα Περιορισμοί με συναρτήσεις στο Dataverse για συνηθισμένα προβλήματα που μπορεί να προκύψουν.

Εντοπισμός σφαλμάτων με χρήση της συνάρτησης trace()

  1. Για να εντοπίσετε σφάλματα χρησιμοποιώντας τη συνάρτηση ανίχνευσης, βεβαιωθείτε ότι ενεργοποιείτε την παρακολούθηση δραστηριότητας προσθηκών και προσαρμοσμένης ροής εργασιών.
  2. Μεταβείτε στο Power Apps (make.powerapps.com), επιλέξτε το εικονίδιο γραναζιού Ρυθμίσεις στην επάνω δεξιά γωνία και, στη συνέχεια, επιλέξτε Ρυθμίσεις εκ των προτέρων.
  3. Επιλέξτε Ρυθμίσεις > Ελεγκτικός > Καθολικές Ρυθμίσεις Ελέγχου.
  4. Στην καρτέλα Προσαρμογή , βεβαιωθείτε ότι είναι ενεργοποιημένη η Ενεργοποίηση καταγραφής στο αρχείο καταγραφής ανίχνευσης προσθηκών για Όλες.

Αφού ενεργοποιήσετε την παρακολούθηση, μπορείτε να αρχίσετε να χρησιμοποιείτε συναρτήσεις trace() για τον εντοπισμό σφαλμάτων σε τύπους του Power Fx. Μάθετε περισσότερα σχετικά με τον τρόπο χρήσης της συνάρτησης trace() μέσα σε μια παράσταση Power Fx: Συνάρτηση Trace - Power Platform.

Επικοινωνία με τη βοήθεια και την υποστήριξη

Για προβλήματα με συναρτήσεις που δεν καλύπτονται στις συμβουλές προσθηκών χαμηλού κώδικα του Microsoft Dataverse και για γνωστά ζητήματα, όπως σφάλματα που δεν έχουν ληφθεί, χρησιμοποιήστε την εμπειρία Βοήθεια + υποστήριξη και συμπεριλάβετε τις ακόλουθες πληροφορίες:

  • Τύπος προβλήματος- Web API και SDK του Dataverse.
  • Υποτύπος προβλήματος.

Παράδειγμα συναρτήσεων

Δημιουργία και χρήση συναρτήσεων στο Microsoft Dataverse