Делите путем

екецутеЕвент (референца клијентског АПИ-ја) (преглед)

Важно

  • Ово је функција прегледа.
  • Функције верзије за преглед нису намењене за коришћење у производњи и можда имају ограничене функционалности. Ове функције подлежу додатним условима коришћења и доступне су пре званичног издања, тако да корисници могу добити рани приступ и пружити повратне информације.

Извршава тему Мицрософт Цопилот Студио на основу регистрованог имена догађаја. Враћа низ типа МЦСРеспонсе .

Синтакса

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

Параметре

Име параметра Тип Потребно Опис
eventName string Да Назив догађаја регистрован у теми Мицрософт Цопилот Студио
eventParameters Непознат Да Параметри потребни за извршење догађаја. То зависи од тога шта тема ради.
successCallback Function Да Функција за позивање када операција успе.
errorCallback Function Да Функција за позивање када операција не успе.

Повратна вредност

Низ МЦСРеспонсе

Приступ контексту апликације

Када се позове Агент АПИ, контекст за апликацију се преноси на тему Цопилот Студио кроз скуп варијабли. Следе контекстне варијабле доступне као Copilot Studio глобалне варијабле.

Променљива Опис
Global.PA__Copilot_Model_PageContext.pageContext.id.guid ИД записа табеле на главном обрасцу
Global.PA__Copilot_Model_PageContext.pageContext.entityTypeName Логично име табеле на главној страници
Global.PA__Copilot_Model_PageContext.pageContext.pageName Назив главне странице
Global.PA__Copilot_Model_PageContext.pageContext.pageType Тип главне странице
Global.PA__Copilot_Model_AppUniqueNameContext.appUniqueNameContext.appUniqueName Јединствено име апликације засноване на моделу

На пример, користећи Global.PA__Copilot_Model_PageContext.pageContext.id.guid и Global.PA__Copilot_Model_PageContext.pageContext.entityTypeName, запис обрасца може се преузети из Датаверсе.

Приступање евентПараметерс

У оквиру теме Цопилот Студио, eventParameters из АПИ позива се може приступити помоћу варијабле Activity.Value. Користите Парсе вредност чвор да претворите ЈСОН у запис са једним или више поља. Одабир Из узорка података за тип података омогућава пружање ЈСОН примера за креирање записа.

Пример

У Мицрософт Цопилот Студио-у, где је регистрована тема која прихвата ИД (ИД записа ентитета) као улазни параметар. На основу улаза, он преузима сродне активности тог ентитетског записа и враћа резултате као активност догађаја Цопилот Студио.

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"
    }
]

Кстрм .Цопилот (референца клијентског АПИ-ја)

  • Last updated on