Deli putem

executeEvent (referenca klijentskog API-ja) (pregled)

Važno

  • Ovo je preliminarna funkcija.
  • Funkcije verzije za pregled nisu namenjene za korišćenje u proizvodnji i možda imaju ograničene funkcionalnosti. Ove funkcije podležu dodatnim uslovima korišćenja i dostupne su pre zvaničnog izdanja, tako da korisnici mogu dobiti rani pristup i pružiti povratne informacije.

Izvršava temu Microsoft Copilot Studio na osnovu registrovanog imena događaja. Daje niz tipa MCSResponse.

Sintaksa

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

Parametri

Ime parametra Tip Potrebne Opis
eventName string Da Ime događaja registrovano u temi Microsoft Copilot Studio
eventParameters Nepoznat Da Parametri potrebni za izvršavanje događaja. To zavisi od toga šta tema radi.
successCallback Function Da Funkcija za pozivanje kada operacija uspe.
errorCallback Function Da Funkcija za pozivanje kada operacija ne uspe.

Povratna vrednost

Niz MCSResponse

Pristup kontekstu aplikacije

Kada se zove API agenta, kontekst za aplikaciju se prosleđuje temi Copilot Studio kroz skup promenljivih. Slede kontekstne varijable dostupne kao Copilot Studio globalne varijable.

Promenljiva Opis
Global.PA__Copilot_Model_PageContext.pageContext.id.guid ID zapisa tabele na glavnom obrascu
Global.PA__Copilot_Model_PageContext.pageContext.entityTypeName Logično ime tabele na glavnoj stranici
Global.PA__Copilot_Model_PageContext.pageContext.pageName Naziv glavne stranice
Global.PA__Copilot_Model_PageContext.pageContext.pageType Tip glavne stranice
Global.PA__Copilot_Model_AppUniqueNameContext.appUniqueNameContext.appUniqueName Jedinstveno ime aplikacije zasnovane na modelu

Na primer, korišćenje Global.PA__Copilot_Model_PageContext.pageContext.id.guid i Global.PA__Copilot_Model_PageContext.pageContext.entityTypeName, zapis obrasca se može preuzeti iz usluge Dataverse.

Pristupanjeparametrima događaja

U okviru teme Copilot Studio, eventParameters iz API poziva se može pristupiti pomoću promenljive Activity.Value. Koristite čvor vrednosti raščlanjivanje da biste konvertovali JSON u zapis sa jednim ili više polja. Izbor stavke Od uzorka podataka za tip podataka omogućava obezbeđivanje JSON primera za kreiranje zapisa.

Primer

U programu Microsoft Copilot Studio, gde je registrovana tema koja prihvata ID (ID entitetskog zapisa) kao parametar unosa. Na osnovu unosa, preuzima povezane aktivnosti zapisa tog 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"});

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

  • Last updated on