Jagamisviis:

executeEvent (kliendi API viide) (eelvaade)

Oluline

  • See on eelvaate funktsioon.
  • Eelversioonifunktsioonid ei ole mõeldud kasutamiseks tootmises ja nende funktsioonid võivad olla piiratud. Nendele funktsioonidele kehtivad täiendavad kasutustingimused ja need on saadaval enne ametlikku väljaandmist, et kliendid saaksid varajase juurdepääsu ja tagasisidet anda.

Käivitab registreeritud sündmuse nime põhjal Microsoft Copilot Studio teema. Tagastab massiivi, mille tüüp on MCSResponse.

Süntaks

Xrm.Copilot.executeEvent(eventName, eventParameters).then(successCallback, errorCallback);

Parameetrid

Parameetri nimi Liik Nõutav Kirjeldus
eventName string Jah Teemas Microsoft Copilot Studio registreeritud sündmuse nimi
eventParameters Tundmatu Jah Sündmuse käivitamiseks vajalikud parameetrid. Need sõltuvad sellest, mida teema teeb.
successCallback Function Jah Funktsioon, mida kutsuda, kui toiming õnnestub.
errorCallback Function Jah Funktsioon, mida kutsuda, kui toiming nurjub.

Tagastatav väärtus

MCSResponse'i massiiv

Juurdepääs rakenduse kontekstile

Agendi API kutsumisel edastatakse rakenduse kontekst Copilot Studio teemale muutujate komplekti kaudu. Järgmised on kontekstimuutujad, mis on saadaval Copilot Studio globaalmuutujatena.

Muutuja Kirjeldus
Global.PA__Copilot_Model_PageContext.pageContext.id.guid Põhivormi tabelikirje ID
Global.PA__Copilot_Model_PageContext.pageContext.entityTypeName Tabeli loogiline nimi avalehel
Global.PA__Copilot_Model_PageContext.pageContext.pageName Avalehe nimi
Global.PA__Copilot_Model_PageContext.pageContext.pageType Avalehe tüüp
Global.PA__Copilot_Model_AppUniqueNameContext.appUniqueNameContext.appUniqueName Mudelipõhise rakenduse kordumatu nimi

Näiteks kasutades Global.PA__Copilot_Model_PageContext.pageContext.id.guid ja Global.PA__Copilot_Model_PageContext.pageContext.entityTypeName, saab vormi kirje tuua dataverse'ist.

Juurdepääs sündmuseparameetritele

Teemas Copilot Studio pääseb eventParameters API kutsele juurde muutujaga Activity.Value. JSON-i teisendamiseks ühe või mitme väljaga kirjeks kasutage sõelumisväärtuse sõlme . Andmetüübi andmetüübinäidisandmetest valimisel saab JSON-i näite abil kirje luua.

Näide

Microsoft Copilot Studios, kus on registreeritud teema, mis aktsepteerib sisendparameetrina ID-d (olemikirje ID). Sisendi põhjal toob see selle olemikirje seotud tegevused ja tagastab tulemid Copilot Studio sündmusetegevusena.

const response = await Xrm.Copilot.executeEvent( 
    "Microsoft.PowerApps.Copilot.RelatedActivities", 
    { id:"aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb"});

Response

[
    {
        "type": "event",
        "timestamp": "2025-02-05T16:05:53.4074714+00:00",
        "replyToId": "bbbbbbbb-1111-2222-3333-cccccccccccc",
        "attachments": [],
        "value": {
            "@odata.context": "https://*.dynamics.com/api/data/v9.2/$metadata#activitypointers(subject,prioritycode)",
            "value": [
                {
                    "@odata.etag": "W/\"6825587\"",
                    "@odata.type": "#Microsoft.Dynamics.CRM.phonecall",
                    "activityid": "cccccccc-2222-3333-4444-dddddddddddd",
                    "activitytypecode": "phonecall",
                    "prioritycode": 2,
                    "subject": "Discuss new opportunity (sample)"
                },
                {
                    "@odata.etag": "W/\"6826236\"",
                    "@odata.type": "#Microsoft.Dynamics.CRM.phonecall",
                    "activityid": "dddddddd-3333-4444-5555-eeeeeeeeeeee",
                    "activitytypecode": "phonecall",
                    "prioritycode": 2,
                    "subject": "Likes our new products (sample)"
                }
            ]
        },
        "name": "MS.CopilotApiDemo.RelatedActivities"
    }
]

Xrm.Copilot (kliendi API viide)

  • Last updated on