addActionHandler (İstemci API başvurusu)

Microsoft 365 Copilot eylemi için özel işleyici işlevini kaydeder.

Syntax

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

Parameters

Parametre Adı Türü Zorunlu Description
actionId string Evet İşlenmek üzere eylemin benzersiz tanımlayıcısı.
actionHandler Function Evet Eylem tetiklendiğinde çağrılacak işlev. Eylemin veri yükünü bağımsız değişken olarak alır.
successCallback Function Evet İşlem başarılı olduğunda çağrılacak bir işlev.
errorCallback Function Evet İşlem başarısız olduğunda çağrılacak bir işlev.

Dönüş Değeri

Tür: Promise<void>

Remarks

Aynı actionIdiçin birden çok işleyici kaydedebilirsiniz. Sırayla çalışırlar. API, aynı işlev başvurusunun aynı için iki kez kaydedilmesini actionIdsessizce yoksayar. Microsoft 365 Copilot etkinleştirilmediyse API hiçbir şey yapmaz.

Yerleşik eylem kimlikleri

Aşağıdaki eylem kimliklerinde platform varsayılan işleyicileri otomatik olarak kaydedilir. Bunların yanına özel işleyiciler ekleyebilir veya removeDefaultActionHandlers kullanarak önce varsayılan işleyicileri kaldırabilirsiniz.

Eylem kodu Description Veri özellikleri
MS.PA.CopilotChat.OpenRecord Bir kayıt açar. entity (dize) — tablo mantıksal adı; recordId (dize) — kayıt kimliği
MS.PA.CopilotChat.NavigateToView Bir görünüme gider. entity (dize) — tablo mantıksal adı; fetchXml (dize) — FetchXML sorgusu

Example

const handler = async ({ entity, recordId }) => {
    // Open the record in a side pane instead of navigating away
    const pane = Xrm.App.sidePanes.createPane({ canClose: true });
    await pane.navigate({ pageType: "entityrecord", entityName: entity, entityId: recordId });
};

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

removeActionHandler yöntemi
Xrm.Copilot (İstemci API başvurusu)

  • Last updated on