Dijeli putem

executeEvent (referenca klijentskog API-ja) (pretpregled)

Važno

  • To je značajka pretpregleda.
  • Značajke pretpregleda nisu namijenjene u proizvodne svrhe i mogu imati ograničene funkcije. Te značajke podliježu dodatnim uvjetima korištenja i dostupne su prije službenog izdanja kako bi korisnici mogli dobiti rani pristup i dati povratne informacije.

Izvršava temu rješenja Microsoft Copilot Studio na temelju registriranog naziva događaja. Vraća polje vrste MCSResponse.

Sintaksa

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

Parametri

Naziv parametra Tip Obvezno Opis
eventName niz Da Naziv događaja registriran u temi Microsoft Copilot Studio
eventParameters Nepoznato Da Parametri potrebni za izvršavanje događaja. One ovise o tome što tema radi.
successCallback Function Da Funkcija koja se poziva kada operacija uspije.
errorCallback Function Da Funkcija za pozivanje kada operacija ne uspije.

Povratna vrijednost

Niz MCSResponse

Pristup kontekstu aplikacije

Kada se API agenta poziva, kontekst za aplikaciju prosljeđuje se temi rješenja Copilot Studio putem skupa varijabli. Slijede varijable konteksta dostupne kao Copilot Studio globalne varijable.

Varijabla Opis
Global.PA__Copilot_Model_PageContext.pageContext.id.guid ID zapisa tablice na glavnom obrascu
Global.PA__Copilot_Model_PageContext.pageContext.entityTypeName Logičan naziv tablice na glavnoj stranici
Global.PA__Copilot_Model_PageContext.pageContext.pageName Naziv glavne stranice
Global.PA__Copilot_Model_PageContext.pageContext.pageType Vrsta glavne stranice
Global.PA__Copilot_Model_AppUniqueNameContext.appUniqueNameContext.appUniqueName Jedinstveni naziv aplikacije stvorene prema modelu

Na primjer, korištenje Global.PA__Copilot_Model_PageContext.pageContext.id.guid i Global.PA__Copilot_Model_PageContext.pageContext.entityTypeName, zapis obrasca može se dohvatiti iz dataverse.

Pristup događajimaParametri

U sklopu teme Copilot Studio, eventParameters iz API poziva može se pristupiti pomoću varijable Activity.Value. Pomoću čvora vrijednosti raščlanjivanja pretvorite JSON u zapis s jednim ili više polja. Odabirom oglednih podatakaza vrstu podataka omogućuje se stvaranje zapisa pomoću primjera JSON-a.

Primjer

U programu Microsoft Copilot Studio, gdje je registrirana tema koja prihvaća ID (ID zapisa entiteta) kao ulazni parametar. Na temelju ulaza dohvaća povezane aktivnosti tog zapisa entiteta i vraća rezultate kao aktivnost događaja Copilot Studio.

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

Odgovor

[
    {
        "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 (referenca klijentskog API-ja)

  • Last updated on