Partekatu bidez

executeEvent (Bezeroaren APIaren erreferentzia) (aurrebista)

Garrantzitsua da

  • Hau aurreikuspen-eginbidea da.
  • Aurreargitalpen-eginbideak ez daude ekoizpenerako diseinatuta, eta baliteke funtzionalitate murriztua izatea. Eginbide hauek erabilera-baldintza osagarrien mende daude, eta kaleratze ofizial bat baino lehen eskuragarri daude, bezeroek lehenbailehen sarbidea izan dezaten eta iritziak eman ditzaten.

Microsoft Copilot Studio-ko gai bat exekutatzen du, erregistratutako gertaeraren izenean oinarrituta. MCSResponse motako matrizea itzultzen du.

Sintaxia

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

Parametroak

Parametroaren izena Mota Beharrezkoa Deskribapena
eventName kate Yes Microsoft Copilot Studio gaian erregistratutako gertaeraren izena
eventParameters Ezezaguna Yes Gertaeraren exekuziorako beharrezkoak diren parametroak. Gaiak egiten duenaren araberakoa da.
successCallback Function Yes Eragiketa behar bezala egiten denean deitzen zaion funtzioa.
errorCallback Function Yes Eragiketan akats bat gertatzen denean deitzen zaion funtzioa.

Itzuli balioa

MCSResponse-ren matrizea

Aplikazioaren testuingurura atzitzea

Agente API bat deitzen denean, aplikazioaren testuingurua Copilot Studio gaiari pasatzen zaio aldagai multzo baten bidez. Hona hemen Copilot Studio aldagai global gisa eskuragarri dauden testuinguru-aldagaiak.

Aldagaia Deskribapena
Global.PA__Copilot_Model_PageContext.pageContext.id.guid Inprimaki nagusiko taulako erregistroaren IDa
Global.PA__Copilot_Model_PageContext.pageContext.entityTypeName Orrialde nagusiko taularen izen logikoa
Global.PA__Copilot_Model_PageContext.pageContext.pageName Orrialde nagusiaren izena
Global.PA__Copilot_Model_PageContext.pageContext.pageType Orrialde nagusiaren mota
Global.PA__Copilot_Model_AppUniqueNameContext.appUniqueNameContext.appUniqueName Ereduan oinarritutako aplikazioaren izen esklusiboa

Adibidez, Global.PA__Copilot_Model_PageContext.pageContext.id.guid eta Global.PA__Copilot_Model_PageContext.pageContext.entityTypeName, inprimakiaren erregistroa Dataverse-tik berreskuratu daiteke.

GertaeraParametroetara atzitzea

Copilot Studio gaiaren barruan, eventParameters API deiaren aldagaia Activity.Valueerabiliz sar daiteke. Erabili Parse balioaren nodoa JSON eremu bat edo gehiago dituen erregistro bihurtzeko. Datu motarenlagin-datuetatik hautatzeak JSON adibide bat ematen du erregistroa sortzeko.

Adibidez

Microsoft Copilot Studio-n, non ID bat (entitate-erregistroaren ID) sarrerako parametro gisa onartzen duen gai bat erregistratzen den. Sarreran oinarrituta, entitate-erregistro horren erlazionatutako jarduerak berreskuratzen ditu eta emaitzak Copilot Studio gertaera-jarduera gisa itzultzen ditu.

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 (Bezeroaren APIaren erreferentzia)

  • Last updated on