Συνάρτηση GUID

Ισχύει για: Εφαρμογές καμβά Ροές επιφάνειας εργασίας Εφαρμογές Power Platform βάσει μοντέλου CLI

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

Περιγραφή

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

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

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

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

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

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

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

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

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

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

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

TextInput1.Text & " " & GUID()

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

Σύνταξη

GUID( [ GUIDString ] )

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

GUID( Χωρίς πληκτρολόγηση )

• Χωρίς πληκτρολόγηση - Απαιτείται. μη τυπολογημένο αντικείμενο που αντιπροσωπεύει ένα 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 ενός στοιχείου ελέγχου Label σε αυτόν τον τύπο:

First( Products ).Status

Θα εμφανιστεί το στοιχείο ελέγχου Label 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() )