Бөлісу құралы:

executeEvent (Клиент API анықтамасы) (алдын ала қарау)

Маңызды

  • Бұл алдын ала қарау мүмкіндігі болып табылады.
  • Алдын ала қарау нұсқасының мүмкіндіктері өндірісті пайдалану үшін арналмаған және функционалдық шектеулі болуы мүмкін. Бұл мүмкіндіктер қосымша пайдалану шарттарына бағынады және тұтынушылар ертерек қол жеткізіп, кері байланыс бере алуы үшін ресми шығарылымға дейін қолжетімді болады.

Тіркелген оқиға атауына негізделген Microsoft Copilot Studio тақырыбын орындайды. MCSResponse типті массивті береді.

Синтаксис

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

Параметрлер

Параметр атауы Түрі Талап етіледі Сипаттама
eventName жол Иә Microsoft Copilot Studio тақырыбында тіркелген оқиға атауы
eventParameters Белгісіз Иә Оқиғаны орындау үшін қажетті параметрлер. Бұл тақырыптың не істейтініне байланысты.
successCallback Function Иә Операция табысқа жеткенде қоңырау шалуға арналған функция.
errorCallback Function Иә Операция істен шыққанда қоңырау шалу функциясы.

Қайтаратын мән

MCSResponse жиынтығы

Қолданба мәтінмәніне қатынасу

Agent API шақырылған кезде, бағдарламаның контексті айнымалылар жиынтығы арқылы Copilot Studio тақырыбына беріледі. Төменде 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.entityTypeName, Global.PA__Copilot_Model_PageContext.pageContext.id.guid пішіннің жазбасын Dataverse-тен алуға болады.

EventParameters қатыналуы

Copilot Studio тақырыбында API қоңырауына eventParameters айнымалы Activity.Valueарқылы қол жеткізуге болады. JSON-ды бір немесе бірнеше өрістері бар жазбаға түрлендіру үшін Талдау мәні түйінін пайдаланыңыз. Деректер түрі үшін Үлгі деректерінен таңдау жазбаны жасау үшін JSON үлгісін ұсынуға мүмкіндік береді.

Мысал

Microsoft Copilot Studio-да, енгізу параметрі ретінде идентификаторды (нысан жазба идентификаторын) қабылдайтын тақырып тіркелген. Кіріс негізінде ол сол нысан жазбасының байланысты әрекеттерін алады және нәтижелерді 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 (Клиент API анықтамасы)

  • Last updated on