Извлечение данных анализа с помощью действия msdyn_RetrieveKPIValuesForGDPR

Статья
05/24/2023

Общий регламент по защите данных (GDPR) Европейского союза (ЕС) предоставляет физическим лицам значительные права в отношении их данных. Обзор GDPR см. в статье Microsoft Learn Общий регламент по защите данных, включая терминологию, план действий и контрольные списки готовности, которые помогут вам выполнять свои обязательства в соответствии с GDPR при использовании продуктов и услуг Microsoft.

Вы можете узнать больше о GDPR и о том, как Microsoft помогает поддерживать его и наших клиентов, на которых он распространяется.

Центр управления безопасностью Майкрософт предоставляет общую информацию, рекомендации по соблюдению нормативных требований и документацию, полезную для отчетности GDPR, такую как оценка воздействия на защиту данных, запросы субъектов данных и уведомление об утечке данных.
Портал Service Trust Portal предоставляет информацию о том, как службы Microsoft помогают обеспечить соблюдение требований GDPR.

Используйте действие msdyn_RetrieveKPIValuesForGDPR для программного извлечения профилей, взаимодействий и ключевых показателей эффективности, которые хранятся в службе Azure, которая используется для вычисления и хранения данных для контакта, интереса, возможной сделки или системного пользователя. Это действие полезно для ответа на запросы данных для выполнения обязательств по соответствию требованиям к конфиденциальности данных в Dynamics 365 Sales Insights.

Заметка

Кроме того, можно сформировать классы запроса и отклика для этого действия для включения в код приложения. Дополнительные сведения: Создание типов с ранней привязкой для действия
Этот раздел применим только к функциям Аналитика отношений и Введение в приложение Sales Insights.

Параметры действия

Действие msdyn_RetrieveKPIValuesForGDPR ожидает следующие входные параметры:

Имя Тип Описание

Имя	Тип	Описание
`CRMRecord`	mscrm.crmbaseentity	Тип сущности, для которой требуется извлечь данные. Обязательное. Можно указать одно из следующих значений: `Microsoft.Dynamics.CRM.contact` `Microsoft.Dynamics.CRM.lead` `Microsoft.Dynamics.CRM.opportunity` `Microsoft.Dynamics.CRM.systemuser` В зависимости от указанного типа сущности, необходимо указать `contactid`, `leadid`, `opportunityid` или `systemuserid` как второй ключ для идентификации записи сущности, для которой требуется извлечь данные. См. пример ниже в этом разделе.

CRMRecord

mscrm.crmbaseentity

Тип сущности, для которой требуется извлечь данные. Обязательное.

Можно указать одно из следующих значений:

Microsoft.Dynamics.CRM.contact
Microsoft.Dynamics.CRM.lead
Microsoft.Dynamics.CRM.opportunity
Microsoft.Dynamics.CRM.systemuser

В зависимости от указанного типа сущности, необходимо указать contactid, leadid, opportunityid или systemuserid как второй ключ для идентификации записи сущности, для которой требуется извлечь данные. См. пример ниже в этом разделе.

Возвращаемый тип действия

Действие msdyn_RetrieveKPIValuesForGDPR возвращает следующее значение:

Имя	Тип	Описание
`msdyn_RetrieveKPIValuesForGDPRResponse`	ComplexType	Содержит ответ из действия msdyn_RetrieveKPIValuesForGDPR. Он содержит следующее свойство, которое содержит структурированные данные типа: Имя:`Response` Тип: Edm.String Описание: список данных в виде escape-массива JSON.

Пример

Запросить

POST [Organization URI]/api/data/v9.0/msdyn_RetrieveKPIValuesForGDPR HTTP/1.1
Accept: application/json
Content-Type: application/json; charset=utf-8
OData-MaxVersion: 4.0
OData-Version: 4.0
  
{
  "CRMRecord": {
    "@odata.type": "Microsoft.Dynamics.CRM.contact",
    "contactid": "bf1b1e9a-6e28-e811-a94e-000d3a365e68"
  }
}

Отклик

Ответ содержит объект JSON со свойством Response, содержащим список данных, хранящихся в службе Azure, которая используется для вычисления и хранения данных.

HTTP/1.1 200 OK  
Content-Type: application/json; odata.metadata=minimal  
OData-Version: 4.0

{
  "@odata.context": "[Organization URI]/api/data/v9.0/$metadata#Microsoft.Dynamics.CRM.msdyn_RetrieveKPIValuesForGDPRResponse",
   "Response": {\"EntityId\": \"bf1b1e9a-6e28-e811-a94e-000d3a365e68\",\"Daily UI KPIs\": \"Some Values\",\"Lifetime UI KPIs\": \"Some Values\",\"Most Contacted KPIs\": \"Some Values\",\"Health KPIs\": \"Some Values\"}]"
}

См. также

Использование действий веб-API

Sales Insights и конфиденциальность

Поделиться через