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 προγράμματος-πελάτη)