CRM 2011

При настройке Email Router'а под Microsoft Dynamics CRM 2011 столкнулся со следующей ошибкой:

E-mail Router Configuration Manager

The E-mail Router Configuration Manager was unable to retrieve user and queue information from the Microsoft Dynamics CRM server. This may indicate that the Microsoft Dynamics CRM server is busy. Verify that URL 'http://server/orgname' is correct. Additionally, this problem can occur if specified access credentials are insufficient. To try again, click Load Data. (Метаданные содержат неразрешимую ссылку: "http://server/XrmServices/2011/Discovery.svc?wsdl".) (Metadata contains a reference that cannot be resolved: 'http://server/XrmServices/2011/Discovery.svc?wsdl'.)

Для решения этой проблемы советую проверить включена ли анонимная проверка подлинности не только для каталога "Microsoft Dynamics CRM\XrmServices", но и для вложенного каталога "2011":

[node:read-more:link]

Хоть и Microsoft Dynamics CRM 2011 Implementation Guide настоятельно рекомендует "чистую" установку CRM 2011 с последующей миграцией данных из старой четвёрошной базы, грех не попробовать обновиться поверх существующего решения.

Во время такого обновления мастер установки сообщает об очень интересных вещах:

Просмотрев детальную информацию, находим списки индексов и хранимых процедур не входящих в поставку Microsoft Dynamics CRM. [node:read-more:link]

Несколько дней назад вышла-таки 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]

Опубликован Microsoft Dynamics CRM 2011 Release Candidate. Бета-версия была уж очень сырая, посмотрим, что удалось исправить в этой версии.

Выход RTM версии запланирован на первый квартал 2011 года. Напомню, что CRM 4 также вышла в первом квартале, но 2009 года. [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 уже опубликовала пакет документации и несколько обучающих роликов по Microsoft Dynamics CRM 2011.

И тут же подтянулись партнёры - Sonoma Partners анонсировала выпуск одного обучающее видео в день на протяжении двух недель, начиная с сегодняшнего дня.

Видеообзоры будут посвящены:

• Dashboards
• Charts
• Ribbon UI
• Conditional Formatting in Outlook
• Form Enhancements part 1 (Embedded Grids, SharePoint Integration)
• Form Enhancements part 2 (Role-based forms, Form Navigation)
• Filters/Views
• Dialogs
• Auditing
• Connections