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

Καταργεί έναν προσαρμοσμένο χειρισμό που έχει ήδη καταχωρηθεί για μια ενέργεια Microsoft 365 Copilot.

Σύνταξη

Xrm.Copilot.removeActionHandler(actionId, actionHandler).then(successCallback, errorCallback);

Παράμετροι

Όνομα παραμέτρου Type Υποχρεωτικό Περιγραφή
actionId string Yes Το μοναδικό αναγνωριστικό της ενέργειας.
actionHandler Function Yes Ο χειρισμός προς κατάργηση. Πρέπει να είναι η ίδια αναφορά συναρτήσεων που μεταβιβάζεται στο addActionHandler.
successCallback Function Yes Μια συνάρτηση για κλήση όταν η λειτουργία είναι επιτυχής.
errorCallback Function Yes Μια λειτουργία για κλήση όταν αποτύχει η λειτουργία.

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

Τύπος: Promise<void>

Remarks

Η μέθοδος καταργεί μόνο τη συγκεκριμένη αναφορά συνάρτησης που μεταβιβάζετε. Δεν επηρεάζει άλλους χειρισμούς για την ίδια actionId. Εάν δεν είναι ενεργοποιημένη Microsoft 365 Copilot, η μέθοδος δεν κάνει τίποτα.

Παράδειγμα

const handler = async (data) => { /* ... */ };

await Xrm.Copilot.addActionHandler("My.Namespace.MyActionMessage", handler);

// Later, when no longer needed:
await Xrm.Copilot.removeActionHandler("My.Namespace.MyActionMessage", handler);

addActionHandler
Xrm.Copilot (αναφορά API προγράμματος-πελάτη)