Επέκταση του προσκηνίου Microsoft Fabric

Άρθρο
11/24/2024

Μπορείτε να χρησιμοποιήσετε το Κιτ ανάπτυξης φόρτου εργασίας Microsoft Fabric για να δημιουργήσετε φόρτους εργασίας και να δημιουργήσετε προσαρμοσμένες δυνατότητες που επεκτείνουν την εμπειρία Fabric. Η πλατφόρμα Fabric έχει σχεδιαστεί για διαλειτουργικότητα με δυνατότητες ανεξάρτητων προμηθευτών λογισμικού (ISV). Για παράδειγμα, μπορείτε να χρησιμοποιήσετε το πρόγραμμα επεξεργασίας στοιχείων για να δημιουργήσετε μια εγγενή, συνεπή εμπειρία χρήστη, ενσωματώνοντας το προσκήνιο ενός ISV στο περιβάλλον ενός στοιχείου χώρου εργασίας Fabric.

Σε αυτό το άρθρο, θα χρησιμοποιήσετε το δείγμα αποθετηρίου δεδομένων ανάπτυξης φόρτου εργασίας Microsoft Fabric ως οδηγό για την ενσωμάτωση μιας προσαρμοσμένης εφαρμογής web φόρτου εργασίας UX με το Microsoft Fabric. Το έργο και αναλυτικά παραδείγματα σάς βοηθούν να ενοποιήσετε απρόσκοπτα τα δικά σας στοιχεία περιβάλλοντος εργασίας χρήστη και ενέργειες στο περιβάλλον χρόνου εκτέλεσης Fabric για αποτελεσματικό πειραματισμό και προσαρμογή.

Το δείγμα προσκηνίου έργου φόρτου εργασίας UX είναι μια τυπική εφαρμογή Web React που ενσωματώνει το πρόγραμμα-πελάτη φόρτου εργασίας SDK, ως τυπικό πακέτο npm, για την παροχή λειτουργικότητας.

Ο ISV φιλοξενεί και εκτελεί το έργο μέσα σε ένα στοιχείο προστατευμένης <iframe> εκτέλεσης στην πύλη Fabric. Παρουσιάζει εμπειρίες περιβάλλοντος εργασίας χρήστη ειδικά για ανεξάρτητους προμηθευτές λογισμικού, συμπεριλαμβανομένου ενός προγράμματος επεξεργασίας στοιχείων.

Το SDK παρέχει όλες τις απαραίτητες διασυνδέσεις, API και συναρτήσεις bootstrap που απαιτούνται για τη μετατροπή μιας κανονικής εφαρμογής Web σε μια εφαρμογή Web μικροπροθήματος που λειτουργεί απρόσκοπτα στην πύλη Fabric.

Το SDK παρέχει ένα δείγμα έργου φόρτου εργασίας UX. Το δείγμα:

Παρουσιάζει τον τρόπο χρήσης των περισσότερων διαθέσιμων κλήσεων SDK.
Παρουσιάζει ένα παράδειγμα επεκτάσιμης κορδέλας με βάση το περιβάλλον εργασίας χρήστη που ταιριάζει με την εμφάνιση και την αίσθηση του Fabric.
Επιτρέπει εύκολη προσαρμογή.
Σας επιτρέπει να παρακολουθήσετε τις αλλαγές στο Fabric σε πραγματικό χρόνο, όταν η λειτουργία προγραμματιστή Fabric είναι ενεργοποιημένη.

Προαπαιτούμενα στοιχεία

Εφαρμογή Web φόρτου εργασίας UX

Αυτό το πακέτο έχει δημιουργηθεί με βάση το περιβάλλον εργασίας χρήστη Fluent και έχει σχεδιαστεί για React.
Διακήρυξη προσκηνίου φόρτου εργασίας UX

Η διακήρυξη προσκηνίου φόρτου εργασίας UX είναι ένας πόρος JSON που παρέχει ο ISV. Το αρχείο περιέχει βασικές πληροφορίες σχετικά με τον φόρτο εργασίας, όπως τη διεύθυνση URL της εφαρμογής Web φόρτου εργασίας και διάφορες λεπτομέρειες περιβάλλοντος εργασίας χρήστη, όπως το εμφανιζόμενο όνομα του στοιχείου ISV και των συσχετισμένων εικονιδίων. Ο ISV μπορεί να χρησιμοποιήσει το αρχείο διακήρυξης για να προσαρμόσει τι συμβαίνει όταν οι χρήστες αλληλεπιδρούν με στοιχεία στην πύλη Fabric.

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

Ενεργοποίηση της δυνατότητας ανάπτυξης φόρτου εργασίας στο Fabric

Ο διαχειριστής μισθωτή πρέπει πρώτα να ενεργοποιήσει τη δυνατότητα ανάπτυξης φόρτου εργασίας στην πύλη διαχείρισης του Microsoft Fabric. Η δυνατότητα μπορεί να ενεργοποιηθεί για ολόκληρο τον οργανισμό ή για συγκεκριμένες ομάδες εντός του οργανισμού. Για έναν διαχειριστή μισθωτή, για να ενεργοποιήσετε τη δυνατότητα ανάπτυξης φόρτου εργασίας για συγκεκριμένες ομάδες, ολοκληρώστε τα βήματα που περιγράφονται στην ενότητα Ενεργοποίηση της ρύθμισης μισθωτή ανάπτυξης.

Στιγμιότυπο οθόνης του διακόπτη μισθωτή ανάπτυξης φόρτων εργασίας.

Ρύθμιση προσκηνίου

Για να ρυθμίσετε το δείγμα έργου προσκηνίου:

Επαληθεύστε ότι έχουν εγκατασταθεί οι Node.js και npm. Η εγκατάσταση npm πρέπει να είναι έκδοση 9 ή νεότερη. Διαφορετικά, εγκαταστήστε τις τελευταίες εκδόσεις των Node.js και npm.
Κλωνοποιήστε το αποθετήριο δεδομένων δείγματος ανάπτυξης φόρτου εργασίας Microsoft Fabric.

Η παρακάτω λίστα περιγράφει τη διάταξη, τα στοιχεία και τους πόρους του καταλόγου πακέτου:
- Πακέτο: Η θέση του πακέτου φόρτου εργασίας. Το πακέτο περιέχει πόρους προσκηνίου, συμπεριλαμβανομένων των διακήρυξης και των πόρων.
- src: Ο κώδικας φόρτου εργασίας, ο οποίος περιλαμβάνει τους εξής πόρους:
  - index.ts: Το κύριο αρχείο προετοιμασίας, συμπεριλαμβανομένων των bootstrap index.worker iFrames και και index.ui (δείτε λεπτομέρειες παρακάτω σε αυτό το άρθρο).
  - App.tsx: Αυτό το αρχείο δρομολογεί διαδρομές σε σελίδες. Για παράδειγμα, /sample-workload-editor το δρομολογείται στη συνάρτηση στην SampleWorkloadEditor περιοχή components.
  - assets: Η θέση για εικόνες (.jpg, .jpeg και png) που μπορεί να αναφέρεται στη διακήρυξη και να εμφανίζεται στο περιβάλλον εργασίας χρήστη. Για παράδειγμα, assets/github.jpg το ορίζεται στη διακήρυξη ως το εικονίδιο προϊόντος.
  - components: Η θέση του κώδικα περιβάλλοντος εργασίας χρήστη, συμπεριλαμβανομένης της προβολής προγράμματος επεξεργασίας και άλλων προβολών που χρησιμοποιεί το δείγμα (η κορδέλα, η σελίδα ελέγχου ταυτότητας και οι πίνακες).
  - ελεγκτής: Ο ελεγκτής καλεί τα SDK API.
  - models: Οι συμβάσεις και τα μοντέλα που χρησιμοποιούνται από το περιβάλλον εργασίας χρήστη και για την επικοινωνία με το παρασκήνιο της πινακίδας.
- tools: Στοιχεία που μπορείτε να χρησιμοποιήσετε για να δημιουργήσετε ρυθμίσεις και ρυθμίσεις παραμέτρων.
  - webpack.config.js: Χρησιμοποιήστε αυτό το αρχείο για να ρυθμίσετε τις παραμέτρους του τοπικού διακομιστή Node.js.
  - Μια ρύθμιση παραμέτρων web και πρόγραμμα ανάγνωσης/επεξεργαστής διακήρυξης.
- validation: Το δείγμα χρησιμοποιεί το για να επικυρώσει τα σχήματα validateSchema.js αρχείου JSON προϊόντων και στοιχείων. Έχει ρυθμιστεί για εκτέλεση στο npm start.
Μέσα στον φάκελο του αποθετηρίου, μεταβείτε στον φάκελο Frontend για να εγκαταστήσετε τα αρχεία έργου:
```
<repository folder>\Frontend> npm install
```
Ξεκινήστε τον διακομιστή εκτελώντας την ακόλουθη εντολή:
```
<repository folder>\Frontend> npm start
```
Αυτή η εντολή ξεκινά έναν τοπικό διακομιστή Node.js (χρησιμοποιώντας το webpack) στον οποίο συνδέεται το Microsoft Fabric όταν βρίσκεται σε λειτουργία προγραμματιστή.

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

Η τρέχουσα θύρα είναι 60006.

Μετά την εκκίνηση του διακομιστή localhost, μεταβείτε στη διεύθυνση URL 127.0.0.1:60006/manifests για να ανοίξετε τη συγκεντρωτική διακήρυξη που δημιουργήθηκε στον φάκελο Frontend/Package .

Εάν αλλάξετε αρχεία μέσα στον φάκελο Frontend/Package , εκτελέστε npm start ξανά.

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

Παράδειγμα "Hello world"

Για να εκτελέσετε ένα σενάριο δοκιμής "hello world":

Ξεκινήστε τον τοπικό διακομιστή (ακολουθήστε τα βήματα στην ενότητα Γρήγορα αποτελέσματα για την εκτέλεση των δειγμάτων φόρτου εργασίας προσκηνίου και παρασκηνίου) και βεβαιωθείτε ότι είναι ενεργοποιημένη η λειτουργία προγραμματιστή.
Στο μενού χώρου εργασίας, επιλέξτε το εικονίδιο Δημιουργία κέντρου (μερικές φορές το εικονίδιο βρίσκεται στην Εμφάνιση περισσότερων αποσιωπητικών).
Επιλογή Προβολή όλων.
Στην περιοχή Δείγμα φόρτου εργασίας, επιλέξτε την κάρτα Δείγμα στοιχείου για να δημιουργήσετε ένα στοιχείο.

Το νέο στοιχείο μοιάζει με αυτό το παράδειγμα:

Στιγμιότυπο οθόνης της διασύνδεσης εικόνας κύριου δείγματος περιβάλλοντος εργασίας χρήστη.

Εξερευνήστε τα διάφορα στοιχεία ελέγχου για να δείτε τις δυνατότητες του Fabric WorkloadClient API (SDK φόρτου εργασίας):

Άνοιγμα ειδοποιήσεων και παραθύρων διαλόγου
Μετάβαση σε σελίδες
Λήψη ρυθμίσεων θέματος και φόρτου εργασίας
Εκτέλεση ενεργειών

Οι περισσότερες από τις διαθέσιμες λειτουργίες του SDK είτε ρυθμίζονται ως ενέργειες κουμπιού είτε καταχωρούνται ως επιστροφές κλήσης. Τα αποτελέσματα συνήθως είναι μια ειδοποίηση ή ένα πλαίσιο μηνύματος που δείχνει ότι έγινε κλήση ενός API.

Για παράδειγμα:

Η ενέργεια Εκτέλεση καλεί το API action.execute() με μια ενέργεια με την ονομασία sample. Ενέργεια. Η λειτουργικότητα της ενέργειας είναι η εμφάνιση μιας ειδοποίησης.
Επιλέξτε Αποθήκευση στην κορδέλα για να καλέσετε το παράθυρο διαλόγου.open() API. Το API ανοίγει ένα παράθυρο διαλόγου στο οποίο ένας χρήστης πληκτρολογεί ένα όνομα και αποθηκεύει το στοιχείο στο Fabric. Για περισσότερες πληροφορίες σχετικά με το παράθυρο διαλόγου, ανατρέξτε στην ενότητα CRUD.
Το κουμπί Λήψη ρυθμίσεων θέματος εμφανίζει μια λίστα ρυθμίσεων παραμέτρων θέματος Fabric (μέσω του API theme.get().

Το δείγμα περιβάλλοντος εργασίας χρήστη φόρτου εργασίας φιλοξενείται σε ένα στοιχείο περιβάλλον προστατευμένης iframe εκτέλεσης Fabric που εμφανίζεται σε λειτουργία προγραμματιστή για την ιστοσελίδα.

Στιγμιότυπο οθόνης της εικόνας ενσωμάτωσης iFrame.

Σημείωμα

Το στοιχείο προστατευμένης iframe εκτέλεσης allow-same-origin υποστηρίζει τα χαρακτηριστικά και allow-scripts.

Για περισσότερες πληροφορίες σχετικά με το περιβάλλον προστατευμένης εκτέλεσης και χαρακτηριστικά, ανατρέξτε στο θέμα MDN Web Docs.

Κατανόηση του κώδικα

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

bootstrap()

Πριν από την εκκίνηση, ελέγξτε τη διαδρομή για να δείτε αν χρειάζεται να κλείσετε το παράθυρο. Αυτό το βήμα είναι απαραίτητο εάν χρησιμοποιείτε το API ελέγχου ταυτότητας .

const redirectUriPath = '/close';
const url = new URL(window.location.href);
if (url.pathname?.startsWith(redirectUriPath)) {
    window.close();
}

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

Λειτουργία περιβάλλοντος εργασίας χρήστη: Μια εφαρμογή σε λειτουργία περιβάλλοντος εργασίας χρήστη φορτώνεται σε ορατά iFrames. Παρακολουθεί για τις δικές της αλλαγές δρομολόγησης για την απόδοση αντίστοιχων στοιχείων περιβάλλοντος εργασίας χρήστη, όπως σελίδες, πίνακες και παράθυρα διαλόγου.
Κατάσταση λειτουργίας εργασίας: Μια εφαρμογή σε κατάσταση εργασίας εκτελείται σε ένα αόρατο iFrame. Το αόρατο iFrame χρησιμοποιείται κυρίως για τη λήψη εξωτερικών εντολών και, στη συνέχεια, την απόκριση σε αυτές.

Το @ms-fabric/workload-client API παρέχει μια bootstrap() μέθοδο για την απλοποίηση των βημάτων προετοιμασίας. Η bootstrap() μέθοδος εντοπίζει εσωτερικά εάν η τρέχουσα εφαρμογή έχει φορτωθεί σε λειτουργία περιβάλλοντος εργασίας χρήστη ή λειτουργία εργασίας. Στη συνέχεια, καλεί την κατάλληλη μέθοδο προετοιμασίας (initializeUI ή initializeWorker). Όταν ολοκληρωθεί η προετοιμασία, bootstrap() ειδοποιεί το πλαίσιο μικρο-προσκηνίου Fabric για επιτυχία ή αποτυχία προετοιμασίας.

bootstrap({
    initializeWorker: (params) =>
        import('./index.worker').then(({ initialize }) => initialize(params)),
    initializeUI: (params) =>
        import('./index.ui').then(({ initialize }) => initialize(params)),
});

index.worker

index.worker Είναι η κύρια onAction καταχώρηση. Χειρίζεται συμβάντα που στέλνει ο κεντρικός υπολογιστής Fabric, τα οποία ενεργοποιούνται από εκτελεσμένες ενέργειες.

Οι ενέργειες μπορούν να σταλούν από τον φόρτο εργασίας στο Fabric και, στη συνέχεια, να κληθούν ξανά στον onAction χειρισμό ή μπορούν να εκκινούνται από τον κεντρικό υπολογιστή Fabric. Για παράδειγμα, όταν επιλέγετε Δημιουργία δείγματος στοιχείου - Μόνο προσκηνίου, το Fabric ενεργοποιεί την ενέργεια open.createSampleWorkloadFrontendOnlyκαι ο onAction χειρισμός ξεκινά το άνοιγμα της κύριας σελίδας περιβάλλοντος εργασίας του φόρτου εργασίας. Η τρέχουσα τιμή χώρου εργασίας objectId μεταβιβάζεται επίσης στην εμπειρία μόνο προσκηνίου.

Η ακολουθία εμφανίζεται στο παρακάτω παράδειγμα κώδικα:

   workloadClient.action.onAction((message) => {
        switch (message.action) {
            /**
             * This opens the frontend-only experience, so you can experiment with the UI without using CRUD operations.
             * You can still save the item if the backend is connected and registered.
             */
            case 'open.createSampleWorkloadFrontendOnly':
                const { workspaceObjectId: workspaceObjectId1 } = data as ItemCreateContext;
                return workloadClient.page.open({
                    workloadName: 'Org.WorkloadSample',
                    route: {
                        path: `/sample-workload-frontend-only/${workspaceObjectId1}`,
                    },
                });

                // . . . elided for brevity . . .
            default:
                throw new Error('Unknown action received');
        }
    });

index.ui

Η initialize() συνάρτηση αποδίδει το React DOM όπου είναι ενσωματωμένη η App συνάρτηση. Για να καλέσετε τις κλήσεις API, διαβιβάστε τον workloadClient δείκτη χειρισμού SDK, ο οποίος χρησιμοποιείται σε όλο τον κώδικα.

Η FluentProvider κλάση εξασφαλίζει συνέπεια στυλ σε διάφορα στοιχεία ελέγχου FluentUI. Ακολουθεί ένα παράδειγμα:

ReactDOM.render(
      <FluentProvider theme={fabricLightTheme}>
           <App
               history={history}
               workloadClient={workloadClient}
           />
       </FluentProvider>,
       document.querySelector("#root")
   );

Ροή ανάπτυξης

Η App συνάρτηση δρομολογεί τον κωδικό στο SampleWorkloadEditor. Η συνάρτηση επιστρέφει μια τιμή για React.JSX.Element.
Η συνάρτηση περιέχει τη δομή του περιβάλλοντος εργασίας χρήστη. Η δομή του περιβάλλοντος εργασίας χρήστη περιέχει τα στοιχεία ελέγχου κορδέλας και σελίδας, όπως κουμπιά και πεδία εισόδου.
Οι πληροφορίες που συλλέγονται από τον χρήστη αποθηκεύονται μέσω του react useState() hook.
Οι χειρισμοί των στοιχείων ελέγχου περιβάλλοντος εργασίας χρήστη καλούν τις SampleWorkloadController συναρτήσεις και μεταβιβάζουν τις σχετικές μεταβλητές κατάστασης.
Για την υποστήριξη των λειτουργιών CRUD, αποθηκεύεται η κατάσταση του στοιχείου που δημιουργήθηκε/φορτώθηκε στο artifactItem workspaceObjectId και ένα δείγμα υλοποίησης μεταβλητών ωφέλιμου φορτίου.

Τα παρακάτω παραδείγματα χρησιμοποιούν το API notification.open():

Κατάσταση:

   const [apiNotificationTitle, setNotificationTitle] = useState<string>('');
   const [apiNotificationMessage, setNotificationMessage] = useState<string>('');

Περιβάλλον εργασίας χρήστη:

Αυτά τα παραδείγματα ρυθμίζουν συγκεκριμένα στοιχεία περιβάλλοντος εργασίας χρήστη:

Τίτλος:

<Field label="Title" validationMessage={notificationValidationMessage} orientation="horizontal" className="field">
    <Input size="small" placeholder="Notification Title" onChange={e => setNotificationTitle(e.target.value)} />
  </Field>

Κουμπί αποστολής:

<Button icon={<AlertOn24Regular />} appearance="primary" onClick={() => onCallNotification()} > Send Notification </Button>

Πρόγραμμα χειρισμού:

function onCallNotification() {
  ... elided for brevity
   callNotificationOpen(apiNotificationTitle, apiNotificationMessage, undefined, undefined, workloadClient, setNotificationId);
};

Ελεγκτής:

  export async function callNotificationOpen(
    title: string,
    message: string,
    type: NotificationType = NotificationType.Success,
    duration: NotificationToastDuration = NotificationToastDuration.Medium,
    workloadClient: WorkloadClientAPI,
    setNotificationId?: Dispatch<SetStateAction<string>>) {

    const result = await workloadClient.notification.open({
        notificationType: type,
        title,
        duration,
        message
    });
    if (type == NotificationType.Success && setNotificationId) {
        setNotificationId(result?.notificationId);
    }
}

Λειτουργίες CRUD

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

Ο οδηγός υλοποίησης παρασκηνίου περιγράφει λεπτομερώς τον τρόπο ρύθμισης και χρήσης του παρασκηνίου.

Όταν το παρασκήνιο είναι σε λειτουργία και ο Org.WorkloadSample.SampleWorkloadItem τύπος καταχωρείται στο Fabric, μπορείτε να εκτελέσετε λειτουργίες CRUD σε αυτόν τον τύπο.

Οι ακόλουθες λειτουργίες εκτίθενται χρησιμοποιώντας το API ItemCrud.

ΔΗΜΙΟΥΡΓΊΑ

Για να κάνετε ένα δείγμα κλήσης στο create, χρησιμοποιήστε το παρακάτω παράδειγμα που δείχνει την αποθήκευση του στοιχείου φόρτου εργασίας για πρώτη φορά:

 const params: CreateItemParams = {
        workspaceObjectId,
        payload: { itemType, displayName, description, workloadPayload: JSON.stringify(workloadPayload), payloadContentType: "InlineJson", }
    };
 const result: CreateItemResult = await workloadClient.ItemCrud.createItem(params);

Το δείγμα υλοποίησης μας αποθηκεύει το στοιχείο που δημιουργήθηκε στο artifactItem.

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

Αποτυγχάνει μια προσπάθεια δημιουργίας ενός στοιχείου σε έναν μη συμβατό χώρο εργασίας:

Η onCreateFabricItem επιστροφή κλήσης στο παρασκήνιο αποκλείει την CREATE κλήση. Μια αποτυχία σε αυτό το σημείο προκαλεί την αποτυχία της λειτουργίας και δεν δημιουργείται κανένα στοιχείο στο Fabric. Για περισσότερες πληροφορίες, ανατρέξτε στην τεκμηρίωση εντοπισμού σφαλμάτων και αντιμετώπισης προβλημάτων του παρασκηνίου.
Προς το παρόν, ένα αποθηκευμένο στοιχείο δεν εμφανίζεται αυτόματα στον χώρο εργασίας. Για να προβάλετε ένα αποθηκευμένο στοιχείο στον χώρο εργασίας, ανανεώστε τη σελίδα.

GET

Όταν επιλέγετε ένα υπάρχον δείγμα στοιχείου φόρτου εργασίας στην προβολή χώρου εργασίας, το Fabric μεταβαίνει στη διαδρομή που ορίζεται στη διακήρυξη προσκηνίου στο artifactspath>editor>:

"items": [
  {
   "name": "Org.WorkloadSample.SampleWorkloadItem",
   "editor": {
    "workload": "Org.WorkloadSample",
    "path": "/sample-workload-editor"
   },

Όταν καλείτε itemCrud.getItemτο , τα δεδομένα φορτώνονται τόσο από το παρασκήνιο Fabric όσο και από το παρασκήνιο φόρτου εργασίας. Τα δεδομένα και από τις δύο προελεύσεις φορτώνονται στο artifactItem αντικείμενο του ανοιχτού GUI.

Στιγμιότυπο οθόνης ανοίγματος υπαρχόντων στοιχείων στον χώρο εργασίας.

ΕΝΗΜΕΡΩΣΗ

Για να ενημερώσετε ένα υπάρχον στοιχείο, χρησιμοποιήστε itemCrud.updateItemτο . Το ωφέλιμο φορτίο φόρτου εργασίας ενημερώνεται από το παρασκήνιο φόρτου εργασίας. Στο Fabric, μόνο οι αλλαγές του lastModifiedTime στοιχείου μετά από μια ενημέρωση.

DELETE

Μπορείτε να καλέσετε τη delete λειτουργία είτε στην προβολή χώρου εργασίας Fabric ως μια γενική ενέργεια που είναι διαθέσιμη για όλα τα στοιχεία είτε μέσω μιας ρητής κλήσης από τον φόρτο εργασίας στο itemCrud.deleteItem.

Και οι δύο τύποι κλήσεων πραγματοποιούνται μέσω της επιστροφής κλήσης του παρασκηνίου onDeleteItem φόρτου εργασίας.

Προβολή δραστηριότητας ελέγχου ταυτότητας

Στο δείγμα προγράμματος επεξεργασίας φόρτου εργασίας, μπορείτε να προβάλετε τη δραστηριότητα ελέγχου ταυτότητας.

Προτού χρησιμοποιήσετε το API ελέγχου ταυτότητας, ρυθμίστε τις παραμέτρους της εφαρμογής σας για έλεγχο ταυτότητας χρησιμοποιώντας το Αναγνωριστικό Microsoft Entra.

Επίσης, βεβαιωθείτε ότι οι παράμετροι του αρχείου env.dev σας έχουν ρυθμιστεί σωστά. Για περισσότερες πληροφορίες, ανατρέξτε στο θέμα Ρύθμιση παραμέτρων της τοπικής διακήρυξης φόρτου εργασίας και απόκτηση διακριτικού για την εφαρμογή σας.

Εντοπισμός σφαλμάτων

Για να δείτε τα στοιχεία του εργάστη και του iframe του περιβάλλοντος εργασίας χρήστη, στο πρόγραμμα περιήγησης, επιλέξτε F12 για να ανοίξετε τα εργαλεία προγραμματισμού του προγράμματος περιήγησης. Επιλέξτε την καρτέλα Προελεύσεις .

Στιγμιότυπο οθόνης των αρχείων εντοπισμού σφαλμάτων στο Visual Studio Code.

Μπορείτε να τοποθετήσετε ένα σημείο διακοπής στο στοιχείο iframe εργαζομένου και να δείτε την κύρια switch στην εισερχόμενη ενέργεια. Μπορείτε επίσης να εντοπίσετε σφάλματα στο στοιχείο iframe του περιβάλλοντος εργασίας χρήστη. Για παράδειγμα, μπορείτε να εντοπίσετε σφάλματα στον κώδικα εντός SampleWorkloadEditorτης .

Στοιχεία ελέγχου "Ευφράδειο περιβάλλον εργασίας χρήστη"

Οι φόρτοι εργασίας UX χρησιμοποιούν στοιχεία ελέγχου Fluent UI για οπτική συνέπεια με το Fabric και για ευκολία ανάπτυξης. Το δείγμα έργου φόρτου εργασίας παρέχει παραδείγματα σχετικά με τον τρόπο χρήσης των πιο συνηθισμένων στοιχείων ελέγχου.

Για περισσότερες πληροφορίες, ανατρέξτε στο θέμα Fluent UI.

Προσαρμογή διακήρυξης προσκηνίου

Η διακήρυξη προσκηνίου περιγράφει τις πτυχές προσκηνίου του φόρτου εργασίας, όπως την εμφάνιση του προϊόντος, τα ονόματα, τους πόρους απεικόνισης και τις διαθέσιμες ενέργειες. Η διακήρυξη προσκηνίου είναι το κύριο σημείο επαφής μεταξύ του Fabric και του φόρτου εργασίας.

Για το δείγμα φόρτου εργασίας μας, η διακήρυξη φορτώνεται στο Fabric σε λειτουργία προγραμματιστή. Οι ενότητες διακήρυξης, οι ορισμοί και τα παραδείγματα της διακήρυξης εμφανίζονται στα αρχεία διακήρυξης προσκηνίου.

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

API που υποστηρίζονται από το SDK προγράμματος-πελάτη

Υποστηρίζονται τα παρακάτω API:

notification.open
notification.hide
panel.open
panel.close
action.onAction
action.execute
navigation.navigate
navigation.onNavigate
navigation.onBeforeNavigateAway
navigation.onAfterNavigateAway
page.open
dialog.openDialog
dialog.openMessageBox
dialog.close
theme.get
theme.onChange
settings.get
settings.onChange
errorHandling.openErrorDialog
ErrorHandling.handleRequestFailure
itemCrud.createItem
itemCrud.getItem
itemCrud.updateItem
itemCrud.deleteItem
itemSchedule.runItemJob
itemSchedule.cancelItemJob
itemRecentRuns.open

Για περισσότερες πληροφορίες, ανατρέξτε στο θέμα @ms-fabric/workload-client package.

Κοινή χρήση μέσω

Επέκταση του προσκηνίου Microsoft Fabric

Προαπαιτούμενα στοιχεία

Ενεργοποίηση της δυνατότητας ανάπτυξης φόρτου εργασίας στο Fabric

Ρύθμιση προσκηνίου

Παράδειγμα "Hello world"

Κατανόηση του κώδικα

bootstrap()

index.worker

index.ui

Ροή ανάπτυξης

Λειτουργίες CRUD

ΔΗΜΙΟΥΡΓΊΑ

GET

ΕΝΗΜΕΡΩΣΗ

DELETE

Προβολή δραστηριότητας ελέγχου ταυτότητας

Εντοπισμός σφαλμάτων

Στοιχεία ελέγχου "Ευφράδειο περιβάλλον εργασίας χρήστη"

Προσαρμογή διακήρυξης προσκηνίου

API που υποστηρίζονται από το SDK προγράμματος-πελάτη

Σχόλια

Πρόσθετοι πόροι

Κοινή χρήση μέσω

Επέκταση του προσκηνίου Microsoft Fabric

Προαπαιτούμενα στοιχεία

Ενεργοποίηση της δυνατότητας ανάπτυξης φόρτου εργασίας στο Fabric

Ρύθμιση προσκηνίου

Παράδειγμα "Hello world"

Κατανόηση του κώδικα

bootstrap()

index.worker

index.ui

Ροή ανάπτυξης

Λειτουργίες CRUD

ΔΗΜΙΟΥΡΓΊΑ

GET

ΕΝΗΜΕΡΩΣΗ

DELETE

Προβολή δραστηριότητας ελέγχου ταυτότητας

Εντοπισμός σφαλμάτων

Στοιχεία ελέγχου "Ευφράδειο περιβάλλον εργασίας χρήστη"

Προσαρμογή διακήρυξης προσκηνίου

API που υποστηρίζονται από το SDK προγράμματος-πελάτη

Σχετικό περιεχόμενο

Σχόλια

Πρόσθετοι πόροι