Иногда возникает необходимость отобразить данные из CRM в html-ресурсе, встроенном в форму. Эту задачу достаточно легко реализовать при помощи специализированной JavaScript библиотеки XrmServiceToolkit.
Для начала нам необходимо создать и добавить на форму html-ресурс. Подробнее об этом можно прочитать в статье Добавление HTML Web Resources в Microsoft Dynamic CRM.
Все что нам нужно чтобы получить данные из CRM это изменить внутреннюю структуру html-ресурса.
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 |
<!DOCTYPE html> <html> <head> <meta charset="utf-8"> <title>Cases</title> <a href="http://js/lib/XrmServiceToolkit.min.js">http://js/lib/XrmServiceToolkit.min.js</a> <a href="http://js/lib/jquery.js">http://js/lib/jquery.js</a> <a href="http://js/lib/json2.js">http://js/lib/json2.js</a> function loadCase() { var re; XrmServiceToolkit.Rest.Retrieve( "{F6D27954-F5A4-E711-80D3-00155D0005EA}", "new_caseSet", "new_code,new_caseId", null, function (result) { re = result; document.getElementById("content").innerHTML = "Загружен случай <strong>" + re.new_code + "</strong> с идентификатором <strong>" + re.new_caseId + "</strong>"; }, function (error) { alert("Ошибка загрузки случая"); }, false ); } function loadCases() { var re; var options = "new_code,new_caseId"; XrmServiceToolkit.Rest.RetrieveMultiple( "new_caseSet", "$select=new_code,new_caseId", function (result) { re = result; document.getElementById("content").innerHTML = "Получено <strong>" + re.length + "</strong> случаев"; }, function (error) { alert("Ошибка загрузки случаев"); }, function onComplete() { }, false ); } </head> <body onload="loadCase()"> <button onclick="loadCases()">Загрузить</button> <p id="content"></p> </body> </html> |
Соответственно при загрузке страницы мы вызываем метод loadCase, а при нажатии на кнопку метод loadCases.
Теперь рассмотрим код более подробно.
Обратите внимание, что для корректной работы необходимо подключить три библиотеки XrmServiceToolkit, jquery и json2, при этом проверьте правильность указанного пути.
Далее у нас идет секция скриптов, в которой созданы две функции получения одной записи и получения нескольких записей.
В теле html-страницы у нас есть абзац в котором отображаются результаты выполнения функций и кнопка для вызова функции получения нескольких записей. Получение одной записи выполняется при загрузке страницы.
Retrieve
| Название | Тип | Описание |
| Id | String | Идентификатор GUID записи |
| Type | String | Название сущности |
| Select | String | Список имен атрибутов для получения |
| Expand | String | Список связанных сущностей |
| SuccessCallback | Function | Функция вызываемая в случае успешного выполнения |
| ErrorCallback | Function | Функция вызываемая в случае возникновения ошибки выполнения |
Важные особенности:
- Функции SuccessCallback и ErrorCallback должны принимать параметр возвращаемой записи и объекта ошибки соответственно.
- Называние сущности записывается с постфиксом Set.
- Настоятельно не рекомендуется передавать в select пустую строку, так как это вызовет получения абсолютно всех полей сущности, что может существенно замедлить работу приложения.
RetrieveMultiple
| Название | Тип | Описание |
| Type | String | Название сущности |
| Options | String | Параметры выбираемых атрибутов и фильтрации |
| SuccessCallback | Function | Функция вызываемая в случае успешного выполнения |
| ErrorCallback | Function | Функция вызываемая в случае возникновения ошибки выполнения |
| OnComplete | Function | Функция вызываема после загрузки всех записей |
| Async | Boolean | Выполнение функции асинхронно |
Важные особенности:
- Функции SuccessCallback и ErrorCallback должны принимать параметр возвращаемой записи и объекта ошибки соответственно.
- Называние сущности записывается с постфиксом Set.
- Настоятельно не рекомендуется передавать в select пустую строку, так как это вызовет получения абсолютно всех полей сущности, что может существенно замедлить работу приложения.
- Имена загружаемых атрибутов передаются в формате $select=имена. Параметры фильтрации передаются в формате $filter=атрибут условие значение. Объединение условий выполняется с помощью оператора &. Например $select=new_code,new_caseId&$filter= new_code ne null
