Κύκλος ζωής στοιχείου
Η συνιστώμενη ροή για τη δημιουργία στοιχείου στο περιβάλλον εργασίας χρήστη Fabric είναι
- Προτροπή του χρήστη για το όνομα του στοιχείου.
- Δημιουργήστε ένα "κενό" στοιχείο.
- Επεξεργαστείτε και αποθηκεύστε το νέο στοιχείο.
Αυτή η διαδικασία μπορεί να χωριστεί στις ακόλουθες φάσεις:
Όταν ο χρήστης επιλέγει ένα κουμπί για να δημιουργήσει ένα στοιχείο οποιουδήποτε τύπου, ο κώδικας Fabric FE (πύλη) πρέπει να φορτώσει το αντίστοιχο πρόγραμμα επεξεργασίας στοιχείων. Η Fabric FE πραγματοποιεί μια κλήση API στο Fabric BE για να λάβει τις απαιτούμενες πληροφορίες, συμπεριλαμβανομένης της διεύθυνσης URL προέλευσης, των λεπτομερειών της εφαρμογής Αναγνωριστικό Microsoft Entra και της διεύθυνσης URL φόρτου εργασίας BE, όλες σύμφωνα με το τρέχον περιβάλλον. Όταν αυτές οι πληροφορίες είναι διαθέσιμες, δημιουργείται ένα στοιχείο. Συνήθως, το στοιχείο φορτώνει τους στατικούς πόρους του, όπως HTML, JavaScript, CSS και εικόνες από το CDN. Συνιστούμε τη χρήση ανάπτυξης CDN πολλών περιοχών και τη ρύθμιση παραμέτρων της επίλυσης ονομάτων, έτσι ώστε η διεύθυνση URL προέλευσης να επιλύεται στον διακομιστή CDN που βρίσκεται πιο κοντά στην τρέχουσα θέση του προγράμματος περιήγησης.
Σημείωμα
Συνήθως, το πρόγραμμα επεξεργασίας στοιχείων πρέπει να πραγματοποιεί κλήσεις στον φόρτο εργασίας BE, πιθανώς κατά τη διάρκεια της φάσης επεξεργασίας. Αυτό απαιτεί επίλυση της διεύθυνσης URL BE φόρτου εργασίας με βάση το τρέχον περιβάλλον. Προς το παρόν, ο κώδικας μπορεί να χρησιμοποιεί μια διεύθυνση URL BE ενσωματωμένου κώδικα.
Δημιουργία κενού στοιχείου
Είναι κοινή πρακτική στο Fabric να επιτρέπεται η δημιουργία ενός στοιχείου χωρίς εισαγωγή από τον χρήστη, εκτός από το όνομα του στοιχείου. Δεν αναμένεται ότι τέτοια στοιχεία θα έχουν νόημα (επομένως, είναι "κενά"), αλλά εμφανίζονται στον χώρο εργασίας και μπορούν να συμμετέχουν σε βασικές ροές και λειτουργίες. Επιπλέον, σε ορισμένες περιπτώσεις μπορεί ακόμη και να είναι λειτουργικές, με βάση εύλογες προεπιλογές που ορίζονται από τον φόρτο εργασίας.
Αυτή η ροή ξεκινά με την προτροπή του χρήστη να δώσει ένα όνομα για το νέο στοιχείο. Έχοντας το όνομα, το iframe πραγματοποιεί μια κλήση στο API κεντρικού υπολογιστή JS για να ξεκινήσει τη ροή δημιουργίας στοιχείου, διαβιβάζοντας προαιρετικό αντικείμενο JSON ως "ωφέλιμο φορτίο δημιουργίας" και ο κεντρικός υπολογιστής θα κάνει στη συνέχεια μια κλήση στο Fabric BE. Ο έλεγχος ταυτότητας εκτελείται από τον κεντρικό υπολογιστή. Η Fabric BE επιλύει τη διεύθυνση URL BE φόρτου εργασίας με βάση το περιβάλλον και καλεί το CreateItem API φόρτου εργασίας, διαβιβάζοντας το "ωφέλιμο φορτίο δημιουργίας" που αποστέλλεται από το iframe. Ο φόρτος εργασίας ΑΙ αναμένεται να αποθηκεύσει τα μετα-δεδομένα νέου στοιχείου, πιθανώς να εκχωρήσει ορισμένους πόρους (αν και αυτό το βήμα μπορεί να αναβληθεί σε μεταγενέστερο σημείο) και να εκτελέσει οποιαδήποτε άλλη σχετική εργασία. Όταν ολοκληρωθεί η δημιουργία στοιχείου από την προοπτική φόρτου εργασίας BE, πρέπει να ειδοποιήσει το Fabric BE για αλλαγή μετα-δεδομένων στοιχείου. Η ίδια διαδικασία πρέπει να γίνει σε οποιαδήποτε ενημέρωση των μετα-δεδομένων του στοιχείου και, επομένως, το διακριτικό θέματος πρέπει να ανταλλαστεί με το κοινό Fabric BE.
Σημείωμα
Το API για την ειδοποίηση της ενημέρωσης μετα-δεδομένων στοιχείου δεν είναι διαθέσιμο προς το παρόν.
Φόρτωση του στοιχείου
Για να επεξεργαστείτε ένα στοιχείο, το iframe πρέπει να φορτώσει τα μετα-δεδομένα του. Αυτή η διαδικασία είναι ίδια για τη φόρτωση "κενών" και "αρχικοποιημένων" στοιχείων. Το iframe πραγματοποιεί μια κλήση στο API κεντρικού υπολογιστή JS, το οποίο καλεί το Fabric BE, το οποίο με τη σειρά του καλεί το API φόρτου εργασίας GetItemPayload. Ο φόρτος εργασίας ΕΝΔΈΧΕΤΑΙ να επιστρέψει ένα αντικείμενο JSON, το οποίο, στη συνέχεια, μεταβιβάζεται πίσω στο iframe. Ο έλεγχος ταυτότητας εκτελείται από τον κεντρικό υπολογιστή.
Επεξεργασία του στοιχείου
Μετά τη φόρτωση των μετα-δεδομένων στοιχείου, μπορεί να ξεκινήσει μια περίοδος λειτουργίας επεξεργασίας. Είτε στην αρχή είτε κατά τη διάρκεια αυτής της περιόδου λειτουργίας, το iframe ίσως χρειαστεί να κάνει κλήσεις στον φόρτο εργασίας BE (για παράδειγμα, για να λάβει μια ρύθμιση παραμέτρων, να συμπληρώσει στοιχεία ελέγχου περιβάλλοντος εργασίας χρήστη, να εκτελέσει επικυρώσεις και πολλά άλλα). Για τον σκοπό αυτό, πρέπει να ζητήσει ένα διακριτικό από το API κεντρικού υπολογιστή JS.