SDK

Несколько дней назад вышла-таки Microsoft Dynamics CRM 2011. Долгожданная "пятёрка".

На фоне этой новости затерялись несколько не менее интересных релизов:

Microsoft Dynamics CRM 2011 Implementation Guide

Данное руководство состоит из следующих документов:

• Planning Guide (руководство по планированию внедрения) - документ Microsoft Office Word предоставляющий подробную информацию и инструменты для планирования внедрения Microsoft Dynamics CRM 2011. Включает в себя описания двух главных аспектов планирования:
  • технические требования - фокусируются на поддерживаемых режимах развёртывания, системных требованиях и технических соображениях необходимых к принятию в расчёт перед началом установки;
  • методологию внедрения - охватывает вопросы управления внедрением, сбором требований и руководством проекта.
• Installing Guide (руководство по установке) - предоставлет всю информацию, необходимую для установки Microsoft Dynamics CRM 2011, в первую очередь, пошаговое руководство.
• Operating and Maintaining Guide (руководство по эксплуатации и техническому обслуживанию) - описывает процедуры резервного копирования и восстановления данных. Кроме того, данное руководство содержит действия по устранению неполадок для известных проблем.

В состав Microsoft Dynamics CRM 2011 Implementation Guide включён файл-справки в формате Compiled HTML Help (CHM), который содержит контент всех трёх руководств и предоставляет полнотекстовый поиск и поиск по ключевым словам (индексу).

Помимо этого в состав Microsoft Dynamics CRM 2011 Implementation Guide включены 43 шаблона документов необходимых для планирования и осуществления внедрения. [node:read-more:link]

Итак, надеюсь, теперь стало понятно, что же такое REST в Microsoft Dynamics CRM. Настало время показать примеры его использования.

Напомню, что все REST-запросы производятся к базовому URI:

[Your Organization Root URL]/XRMServices/2011/OrganizationData.svc

О том как лучше всего сформировать этот путь читайте в статье "Xrm.Page.context и функция GetGlobalContext".

Доступ к записям

Все записи Microsoft Dynamics CRM сгруппированы в так называемые EntitySet-коллекции. Доступ к определённому типу сущностей осуществляется через базовый URI плюс указание типа записей по следующей маске: [Entity Schema Name]+Set.

Например, чтобы получить список организаций, необходимо обратиться по такому адресу:

[ROOT_URL]/XRMServices/2011/OrganizationData.svc/AccountSet

Для обращения к конкретной организации URI дополняется идентификатором организации:

[ROOT_URL]/XRMServices/2011/OrganizationData.svc/AccountSet(guid'xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx')

Просматривать данные REST-службы можно прямо в окне Internet Explorer, но для этого предварительно необходимо отключить опцию "Включить показ ленты чтения канала" в настройках браузера.

Стоит иметь в виду, что за раз служба возвращает 50 записей в списке. Если записей больше 50, в ответе службы будет ссылка на следующую партию записей в теге (или в свойстве __next в случае с JSON). [node:read-more:link]

Пока пропущу один небольшой раздел из серии обзоров SDK и расскажу про REST.

Взаимодействие с Microsoft Dynamics CRM 4.0 на клиентской стороне сводилось к вызову XML Web-сервиса путём формирования в клиентском скрипте SOAP-запроса. Плюсом данной технологии является интероперабельность - возможность использования сервиса независимо от технологий и языков программирования. И это был единственный способ взаимодействия с системой на стороне клиента. Минусов куда как больше:

• сложная структура запроса - формирование объёмного XML-запроса занятие кропотливое,
• трудности парсинга (разбора) ответа, т.к. необходимы знания объектной модели документа (DOM), регулярных выражений и XQuery/XPath для извлечения требуемых данных,
• нетривиальная обработка ошибок.

Для решения возникающих трудностей с вызовом XML Web-сервиса CRM различными командами были предложены обёртки, призванные облегчить эту задачу:

• Ascentium CrmService JavaScript Library,
• David Berry's CRM Javascript Library.

Реализация REST в CRM 2011

В Microsoft Dynamics CRM 2011 данные теперь доступны через конечную точку REST. REST (Representational State Transfer) - архитектурный подход, который подразумевает использование ресурсов через обращение по уникальному URI-пути. А это значит, что теперь достаточно обратиться GET-, POST-, MERGE-, DELETE- или PUT-запросом на определённый URI, чтобы извлечь данные из CRM, обновить, удалить или сохранить запись. [node:read-more:link]

Продолжаю обзор SDK поставки Microsoft Dynamics CRM 2011 beta.

Объект Xrm.Page.context предоставляет доступ к текущему контексту страницы. С помощью него можно получить информацию об организации и текущем пользователе. Xrm.Page.context предоставляет доступ к следующим функциям:

• getAuthenticationHeader - возвращает закодированное значение SOAP-заголовка необходимого для вызова Web-сервиса (формата CRM 4.0) из скрипта;
• getOrgLcid - возвращает LCID - идентификатор культуры (локаль) текущей организации;
• getOrgUniqueName - возвращает уникальное имя текущей организации;
• getQueryStringParameters - возвращает массив GET-параметров текущего вызова;
• getServerUrl - возвращает базовый URL CRM (при использовании офлайн с клиентом Outlook для CRM возвращает ссылку на локальный сервис);
• getUserId - возвращает GUID текущего пользователя (отличная замена WhoAmI-запросам);
• getUserLcid - возвращает LCID - идентификатор культуры (локаль) текущего пользователя;
• getUserRoles - возвращает массив идентификаторов (GUID) ролей текущего пользователя.

Но что делать, если вы хотите использовать эти чрезвычайно полезные функции в клиентском коде своих приложений а не с форм CRM? Для этого достаточно подключить скрипт с функцией GetGlobalContext как описано ниже: [node:read-more:link]

Две небольших новости, связанных с обновлениями в Microsoft Dynamics CRM 2011 Beta.

Первая касается самого процесса обновления CRM. Теперь обновление будет осуществляться через сервис Microsoft Update.

Кстати, пока остаётся неясным процесс обновления серверной части компонентов Microsoft Dynamics CRM, т.к. в статье идёт речь только об обновлении клиентских компонентов (клиент для Outlook). [node:read-more:link]

На днях Microsoft опубликовала документацию для Microsoft Dynamics CRM 2011. Ознакомление с SDK поможет составить целостное представление об архитектуре системы и разобраться в её возможностях. Не буду переписывать содержимое SDK, а расскажу лишь о самых интересных на мой взгляд изменениях.

Итак, содержимое SDK:

• CHM-файл - непосредственно документация,
• директория bin с основными типами данных, описаны далее,
• samplecode - примеры использования на C#,
• schemas - XSD-схемы конфигурационных файлов,
• tools - как всегда, утилита регистрации плагинов - pluginregistration и файл сопоставления "сущность - допустимая операция" - 'message-entity support for plug-ins.xlsx'
• walkthroughs - примеры кастомизации в новом формате solution (!) с проектами для ribbon и workflow.

Нежданно-негаданно вышла очередная версия Microsoft Dynamics CRM SDK 4.0.12. Судя по большим изменениям и дополнениям, это последний релиз SDK для CRM 4.0. Для тех, кто сомневается, качать или нет:

• Updated binaries to Microsoft Dynamics CRM Update Rollup 10 and Microsoft Dynamic CRM Online May Service Update.
• Updated images provided for use in customizations and applications.
• Added information about the accelerator add-on solutions available for Microsoft Dynamics CRM 4.0.
• Added a new set of tools that simplifies and accelerates the development of Internet-enabled applications. The conceptual documentation is in this Help file. All other resources can be found in the SDK\Microsoft.xRM folder.
• Added a note describing the differences between enumeration values using the WSDL compared to the values using the assemblies.
• Updated the table to include comparison information about Data Import (on-premises), Data Import (online) and Data Migration (on-premises and online). The topic's title in previous releases was "Differences between Data Migration and Data Import".
• Removed a note that said that Scripts in Microsoft Dynamics CRM cannot interact with DHTML elements in the source document of an IFRAME. Added code sample about how to do this.
• Added a note about fixing the namespace when you add the helper code file to your project.
• Added sample code that shows how to compare dates within a workflow, and then send an e-mail.