Kopīgot, izmantojot

executeEvent (klienta API atsauce) (priekšskatījums)

Svarīgi

  • Šis ir priekšskatījuma līdzeklis.
  • Priekšskatījuma līdzekļi nav paredzēti komerciālai lietošanai, un to funkcionalitāte var būt ierobežota. Uz šīm funkcijām attiecas papildu lietošanas noteikumi, un tās ir pieejamas pirms oficiālās izlaišanas, lai klienti varētu iegūt agrīnu piekļuvi un sniegt atsauksmes.

Izpilda Microsoft Copilot Studio tēmu, pamatojoties uz reģistrēto notikuma nosaukumu. Atgriež MCSResponse tipa masīvu.

Sintakse

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

Parameters

Parametra nosaukums Tips Nepieciešams Apraksts
eventName virkne Jā Notikuma nosaukums, kas reģistrēts tēmā Microsoft Copilot Studio
eventParameters Nepazīstams Jā Notikuma izpildei nepieciešamie parametri. Tie ir atkarīgi no tā, ko tēma dara.
successCallback Function Jā Funkcija, kas jāizsauc, kad operācija ir veiksmīga.
errorCallback Function Jā Funkcija, kas jāizsauc, ja operācija neizdodas.

Atgrieztā vērtība

MCSResponse masīvs

Piekļuve lietotnes kontekstam

Kad tiek izsaukts aģenta API, programmas konteksts tiek nodots Copilot Studio tēmai, izmantojot mainīgo kopu. Tālāk ir norādīti konteksta mainīgie, kas pieejami kā Copilot Studio globālie mainīgie.

Mainīgais Apraksts
Global.PA__Copilot_Model_PageContext.pageContext.id.guid Tabulas ieraksta ID galvenajā veidlapā
Global.PA__Copilot_Model_PageContext.pageContext.entityTypeName Tabulas loģiskais nosaukums galvenajā lapā
Global.PA__Copilot_Model_PageContext.pageContext.pageName Galvenās lapas nosaukums
Global.PA__Copilot_Model_PageContext.pageContext.pageType Galvenās lapas veids
Global.PA__Copilot_Model_AppUniqueNameContext.appUniqueNameContext.appUniqueName Modeļa vadītas programmas unikālais nosaukums

Piemēram, izmantojot Global.PA__Copilot_Model_PageContext.pageContext.id.guid un Global.PA__Copilot_Model_PageContext.pageContext.entityTypeName, veidlapas ierakstu var izgūt no Dataverse.

Piekļuve eventParameters

Copilot Studio tēmā no API zvana var piekļūt, eventParameters izmantojot mainīgo .Activity.Value Izmantojiet Parse vērtības mezglu , lai pārvērstu JSON par ierakstu ar vienu vai vairākiem laukiem. Atlasot Datuparauga datus vienumam Datu tips , ieraksta izveidei var sniegt JSON piemēru.

Piemērs

Microsoft Copilot Studio, kur ir reģistrēta tēma, kas pieņem ID (entītijas ieraksta ID) kā ievades parametru. Pamatojoties uz ievadi, tas izgūst šī entītijas ieraksta saistītās darbības un atgriež rezultātus kā Copilot Studio notikuma darbību.

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

Atbilde

[
    {
        "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 (klienta API atsauce)

  • Last updated on