updateContext (αναφορά API προγράμματος-πελάτη)

Αποστέλλει ενημερωμένο περιβάλλον εφαρμογής στον πλαϊνό πίνακα Microsoft 365 Copilot.

Σύνταξη

Xrm.Copilot.updateContext(context).then(successCallback, errorCallback);

Παράμετροι

Όνομα παραμέτρου Type Υποχρεωτικό Περιγραφή
context Περιεχόμενο PowerApps Yes Ένα αντικείμενο που περιγράφει το τρέχον περιβάλλον εφαρμογής για αποστολή στον πλαϊνό πίνακα Microsoft 365 Copilot.
successCallback Function Yes Μια συνάρτηση για κλήση όταν η λειτουργία είναι επιτυχής.
errorCallback Function Yes Μια λειτουργία για κλήση όταν αποτύχει η λειτουργία.

Τιμή επιστροφής

Τύπος: Promise<void>

Remarks

Το API συγχωνεύει αυτόματα πεδία βασικού περιβάλλοντος (appId, appType, orgId, geo). schemaVersion Δεν χρειάζεται να καταχωρήσετε αυτά τα πεδία. Το API δεν κάνει τίποτα εάν το Microsoft 365 Copilot δεν είναι ενεργοποιημένο. Οι παράγοντες που συντάσσετε δεν μπορούν ακόμα να χρησιμοποιήσουν το περιβάλλον για να βελτιστοποιήσουν τις απαντήσεις τους.

Παράδειγμα

await Xrm.Copilot.updateContext({
    entity: "account",
    filterXML: "<fetch><entity name='account'><filter><condition attribute='statecode' operator='eq' value='0'/></filter></entity></fetch>"
});

Περιεχόμενο PowerApps
Xrm.Copilot (αναφορά API προγράμματος-πελάτη)