From c7acf8d85215b5f4640a173a9d2da898b7acc7fe Mon Sep 17 00:00:00 2001 From: Laurent Mazuel Date: Thu, 12 Aug 2021 10:19:03 -0700 Subject: [PATCH 1/2] Update readme.md --- specification/eventgrid/data-plane/readme.md | 45 ++++++++++++++++++++ 1 file changed, 45 insertions(+) diff --git a/specification/eventgrid/data-plane/readme.md b/specification/eventgrid/data-plane/readme.md index 6fcfc2401860..d9d1c8103d82 100644 --- a/specification/eventgrid/data-plane/readme.md +++ b/specification/eventgrid/data-plane/readme.md @@ -38,6 +38,51 @@ A sample valid event definition is shown below: ``` ~~~ +In addition to the event schema definition, you must provide a JSON example of a real event the service can trigger. This example must be in a "examples" folder close to your JSON, and called using snakeCase based on the event final name. The example should contain the envelope, but could be CloudEvent or EventGrid schema, whatever is easier. No PR will be accepted without the example. + +For the previous schema, the example file should be called "chat_message_received.json" and contains: +~~~ markdown +```json +{ + "id": "02272459-badb-4e2e-b538-4cb8a2f71da6", + "topic": "/subscriptions/{subscription-id}/resourceGroups/{group-name}/providers/Microsoft.Communication/communicationServices/{communication-services-resource-name}", + "subject": "thread/{thread-id}/sender/{rawId}/recipient/{rawId}", + "data": { + "messageBody": "Welcome to Azure Communication Services", + "messageId": "1613694358927", + "metadata": { + "key": "value", + "description": "A map of data associated with the message" + }, + "senderId": "8:acs:109f0644-b956-4cd9-87b1-71024f6e2f44_00000008-578d-7caf-07fd-084822001724", + "senderCommunicationIdentifier": { + "rawId": "8:acs:109f0644-b956-4cd9-87b1-71024f6e2f44_00000008-578d-7caf-07fd-084822001724", + "communicationUser": { + "id": "8:acs:109f0644-b956-4cd9-87b1-71024f6e2f44_00000008-578d-7caf-07fd-084822001724" + } + }, + "senderDisplayName": "Jhon", + "composeTime": "2021-02-19T00:25:58.927Z", + "type": "Text", + "version": 1613694358927, + "recipientId": "8:acs:109f0644-b956-4cd9-87b1-71024f6e2f44_00000008-578d-7d05-83fe-084822000f6d", + "recipientCommunicationIdentifier": { + "rawId": "8:acs:109f0644-b956-4cd9-87b1-71024f6e2f44_00000008-578d-7d05-83fe-084822000f6d", + "communicationUser": { + "id": "8:acs:109f0644-b956-4cd9-87b1-71024f6e2f44_00000008-578d-7d05-83fe-084822000f6d" + } + }, + "transactionId": "oh+LGB2dUUadMcTAdRWQxQ.1.1.1.1.1827536918.1.7", + "threadId": "19:6e5d6ca1d75044a49a36a7965ec4a906@thread.v2" + }, + "eventType": "Microsoft.Communication.ChatMessageReceived", + "dataVersion": "1.0", + "metadataVersion": "1", + "eventTime": "2021-02-19T00:25:59.9436666Z" + } + ``` + ~~~ + --- ## Getting Started To build the SDK for EventGrid, simply [Install AutoRest](https://aka.ms/autorest/install) and in this folder, run: From 33206c0aa8a82a97f3e681f64776aad4eb7110f1 Mon Sep 17 00:00:00 2001 From: Laurent Mazuel Date: Thu, 12 Aug 2021 15:42:54 -0700 Subject: [PATCH 2/2] Update readme.md --- specification/eventgrid/data-plane/readme.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/specification/eventgrid/data-plane/readme.md b/specification/eventgrid/data-plane/readme.md index d9d1c8103d82..e0f50f2d6989 100644 --- a/specification/eventgrid/data-plane/readme.md +++ b/specification/eventgrid/data-plane/readme.md @@ -38,7 +38,7 @@ A sample valid event definition is shown below: ``` ~~~ -In addition to the event schema definition, you must provide a JSON example of a real event the service can trigger. This example must be in a "examples" folder close to your JSON, and called using snakeCase based on the event final name. The example should contain the envelope, but could be CloudEvent or EventGrid schema, whatever is easier. No PR will be accepted without the example. +In addition to the event schema definition, you must provide a JSON example of a real event the service can trigger. This example must be in a "examples" folder close to your JSON, and called using snakeCase based on the event final name. The example should contain the envelope, but could be CloudEvent or EventGrid schema, whatever is easier. Example should NOT be handcrafted, but an actual result from a server test environment like canary (it's not required that the event is deployed in production yet). No PR will be accepted without the example. For the previous schema, the example file should be called "chat_message_received.json" and contains: ~~~ markdown