Jagamisviis:

executeEvent (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.

Saadaval:

Mudelipõhised rakendused

Süntaks

context.copilot.executeEvent(eventName, eventParameters).then(successCallback, errorCallback);

Parameetrid

Parameetri nimi Tüüp Nõutav Kirjeldus
eventName string Jah Teemas 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

Tüüp: Promise<MCSResponse>

Vt Lubadus ja MCSResponse

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. PCF-i konteksti API võimaldab nende meetodite käivitamist PCF-juhtelementide kontekstis.

const response = await context.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"
    }
]

Kaaspiloot
executePrompt
Power Appsi komponendi raamistiku API viide
Power Appsi komponendi raamistiku ülevaade

  • Last updated on