Συνάρτηση GUID

Ισχύει για: Εφαρμογές καμβά Συναρτήσεις του Copilot Studio Desktop

Μετατρέψτε μια GUID συμβολοσειρά (καθολικά μοναδικό αναγνωριστικό) σε μια GUID τιμή ή δημιουργήστε μια νέα GUID τιμή.

Περιγραφή

Χρησιμοποιήστε τη GUID συνάρτηση για να μετατρέψετε μια συμβολοσειρά με τη δεκαεξαδική αναπαράσταση ενός GUID σε μια GUID τιμή που μπορείτε να μεταβιβάσετε σε μια βάση δεδομένων. Συστήματα βάσης δεδομένων όπως το Microsoft Dataverse και ο SQL Server χρησιμοποιούν GUID τιμές ως κλειδιά.

Η συμβολοσειρά μπορεί να έχει κεφαλαία ή πεζά γράμματα, αλλά πρέπει να είναι 32 δεκαεξαδικά ψηφία σε μία από αυτές τις μορφές:

• "123e4567-e89b-12d3-a456-426655440000"( παύλες σε τυπικές θέσεις)
• "123e4567e89b12d3a456426655440000" (χωρίς παύλες)

Εάν δεν καθορίσετε ένα όρισμα, η συνάρτηση δημιουργεί ένα νέο GUID.

Για να μετατρέψετε μια GUID τιμή σε μια συμβολοσειρά, χρησιμοποιήστε την σε περιβάλλον συμβολοσειράς. Η GUID τιμή μετατρέπεται σε δεκαεξαδική συμβολοσειρά με ενωτικά και πεζά γράμματα.

Κατά τη δημιουργία μιας νέας GUID, η συνάρτηση χρησιμοποιεί ψευδοτυχαίους αριθμούς για τη δημιουργία μιας έκδοσης 4 IETF RFC 4122GUID. Κατά τη μετατροπή μιας συμβολοσειράς σε , GUIDη συνάρτηση υποστηρίζει οποιαδήποτε GUID έκδοση με την αποδοχή οποιασδήποτε συμβολοσειράς 32 δεκαεξαίων ψηφίων.

Αόριστες συναρτήσεις

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

Όταν χρησιμοποιείτε μια αόριστη συνάρτηση σε έναν τύπο ροής δεδομένων, επιστρέφει μια διαφορετική τιμή μόνο εάν υπολογίζεται ξανά ο τύπος. Εάν δεν αλλάξει τίποτα άλλο στον τύπο, διατηρεί την ίδια τιμή όσο η εφαρμογή σας είναι ανοιχτή.

Για παράδειγμα, εάν ορίσετε την ιδιότητα Text ενός στοιχείου ελέγχου ετικέτας σε GUID(), αυτό δεν αλλάζει όσο η εφαρμογή σας είναι ενεργή. Λαμβάνετε μια διαφορετική τιμή μόνο όταν κλείνετε και ανοίγετε ξανά την εφαρμογή.

Η συνάρτηση υπολογίζεται ξανά εάν είναι μέρος ενός τύπου όπου αλλάζει κάτι άλλο. Για παράδειγμα, εάν ορίσετε την ιδιότητα Text ενός στοιχείου ελέγχου Ετικέτα σε αυτόν τον τύπο, ένα GUID δημιουργείται κάθε φορά που ο χρήστης αλλάζει την τιμή του στοιχείου ελέγχου Εισαγωγή κειμένου :

TextInput1.Text & " " & GUID()

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

Σύνταξη

GUID( [ GUIDString ] )

• GUIDString – Προαιρετικό. Μια συμβολοσειρά κειμένου που έχει τη δεκαεξαδική αναπαράσταση μιας GUID. Εάν δεν παρέχετε μια συμβολοσειρά, η συνάρτηση δημιουργεί μια νέα GUID.

GUID( Δυναμικό )

• Dynamic – Υποχρεωτικό. Δυναμική τιμή που αντιπροσωπεύει μια GUID. Οι αποδεκτές τιμές εξαρτώνται από την υπηρεσία παροχής χωρίς τύπο. Για το JSON, η δυναμική τιμή αναμένεται να GUID αντιπροσωπεύεται ως συμβολοσειρά JSON.

Παραδείγματα

Βασική χρήση

Για να επιστρέψετε μια GUID τιμή με βάση τη δεκαεξαδική αναπαράσταση συμβολοσειράς:

GUID( "0f8fad5b-d9cb-469f-a165-70867728950e" )

Μπορείτε επίσης να παρέχετε τη GUID συμβολοσειρά χωρίς ενωτικά. Αυτός ο τύπος επιστρέφει την ίδια GUID τιμή:

GUID( "0f8fad5bd9cb469fa16570867728950e" )

Χρησιμοποιείται σύμφωνα με το περιβάλλον, για να οριστεί το πεδίο Κατάσταση μιας νέας καρτέλας βάσης δεδομένων σε μια εδραιωμένη τιμή:

Patch( Products, Default( Products ), { Status: GUID( "F9168C5E-CEB2-4faa-B6BF-329BF39FA1E4" ) } )

Πιθανότατα δεν θέλετε να εμφανίσετε GUID στους χρήστες, αλλά τα GUID μπορούν να σας βοηθήσουν να εντοπίσετε σφάλματα στην εφαρμογή σας. Για να εμφανίσετε την τιμή του πεδίου Κατάσταση στην εγγραφή που δημιουργήσατε στο προηγούμενο παράδειγμα, ορίστε την ιδιότητα Text ενός στοιχείου ελέγχου Ετικέτα σε αυτόν τον τύπο:

First( Products ).Status

Το στοιχείο ελέγχου Ετικέτα εμφανίζει f9168c5e-ceb2-4faa-b6bf-329bf39fa1e4.

Δημιουργία πίνακα GUID

1. Ορίστε την ιδιότητα OnSelect ενός στοιχείου ελέγχου Button σε αυτόν τον τύπο:

   ClearCollect( NewGUIDs, ForAll( Sequence(5), GUID() ) )
   

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

2. Προσθέστε ένα στοιχείο ελέγχου Data table, ορίστε την ιδιότητά του Items σε NewGUIDs και εμφανίστε το πεδίο Τιμή.

3. Κρατήστε πατημένο το πλήκτρο Alt και επιλέξτε το κουμπί.

   Ο πίνακας δεδομένων εμφανίζει μια λίστα GUID:

   

4. Επιλέξτε ξανά το κουμπί για να εμφανίσετε μια νέα λίστα GUID:

   

Για να δημιουργήσετε ένα μοναδικό GUID αντί για έναν πίνακα, χρησιμοποιήστε αυτόν τον τύπο:

Set( NewGUID, GUID() )