Deli z drugimi prek

executeEvent (sklic na API odjemalca) (predogled)

Pomembno

  • To je funkcija predogleda.
  • Predogledne različice funkcij niso za komercialno uporabo in njihovo delovanje je lahko omejeno. Za te funkcije veljajo dodatni pogoji uporabe in so na voljo pred uradno izdajo, tako da lahko stranke dobijo zgodnji dostop in pošljejo povratne informacije.

Izvede temo Microsoft Copilot Studio, ki temelji na registriranem imenu dogodka. Vrne matriko vrste MCSResponse.

Sintaksa

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

Parametri

Ime parametra Vrsta Zahtevano Opis
eventName niz Da Ime dogodka, registrirano v temi Microsoft Copilot Studio
eventParameters Neznano Da Parametri, potrebni za izvedbo dogodka. Te so odvisne od tega, kaj tema počne.
successCallback Function Da Funkcija, ki jo pokličete, ko je operacija uspešna.
errorCallback Function Da Funkcija, ki jo pokličete, ko operacija ne uspe.

Vrednost vračila

Matrika mcsResponse

Dostop do konteksta programa

Ko pokličete API agenta, se kontekst aplikacije prenese v temo copilot Studio prek nabora spremenljivk. Spodaj so navedene kontekstne spremenljivke, ki so na voljo kot globalne spremenljivke copilot Studio.

Spremenljivka Opis
Global.PA__Copilot_Model_PageContext.pageContext.id.guid ID zapisa tabele v glavnem obrazcu
Global.PA__Copilot_Model_PageContext.pageContext.entityTypeName Logično ime tabele na glavni strani
Global.PA__Copilot_Model_PageContext.pageContext.pageName Ime glavne strani
Global.PA__Copilot_Model_PageContext.pageContext.pageType Vrsta glavne strani
Global.PA__Copilot_Model_AppUniqueNameContext.appUniqueNameContext.appUniqueName Enolično ime aplikacije, ki temelji na modelu

Zapis obrazca lahko Global.PA__Copilot_Model_PageContext.pageContext.id.guidGlobal.PA__Copilot_Model_PageContext.pageContext.entityTypeNamena primer pridobite iz nabora Dataverse.

Dostopanje do »eventParameters«

V temi Copilot Studio lahko do eventParameters klica API-ja dostopate s spremenljivko Activity.Value. Z vozliščem razčlenjenih vrednosti pretvorite JSON v zapis z enim ali več polji. Če izberete Iz vzorčnihpodatkov za podatkovni tip, lahko ustvarite zapis z primerom JSON.

Primer

V programu Microsoft Copilot Studio, kjer je registrirana tema, ki sprejme ID (ID zapisa entitete) kot parameter vnosa. Na podlagi vnosa pridobi povezane dejavnosti tega zapisa entitete in vrne rezultate kot dejavnost dogodka Copilot Studio.

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 (sklic na API odjemalca)

  • Last updated on