crrm.ru - javascript

Microsoft Dynamics CRM Q4 2012 Service Update

Vladislav Osmanov — Thu, 10 Jan 2013 14:06:42 +0000

Вчера был опубликован Update Rollup 12 более известный как "Microsoft Dynamics CRM Q4 2012 Service Update", который помимо оптимизации производительности и дополненного SDK также принесёт нам поддержку новых браузеров: Browser compatibility introduced with Microsoft Dynamics CRM 2011 Update Rollup 12 or the December 2012 Service Update.

В самое время задуматься, т.к. новое обновление, возможно, поломает некоторые клиентские скрипты. Проверить готовность можно с помощью специальной утилиты: Microsoft Dynamics CRM 2011 Custom Code Validation Tool. Перед её использованием нелишним будет ознакомиться и с этой статьёй: Resolve Breaking Script Issues When Upgrading Microsoft Dynamics CRM.

Голосование: А готовы ли вы к этому? Скрипты переписали?

Язык Русский

Метки:

field_vote:

Average: 2.9 (29 votes)

Обзор MSCRM 2011 beta SDK - Введение в REST

Vladislav Osmanov — Fri, 05 Nov 2010 15:51:49 +0000

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

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

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

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

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

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

В Microsoft Dynamics CRM 2011 конечная точка REST реализована службой WCF с использованием Open Data Protocol (OData).

OData принимает и возвращает данные в одном из двух форматов: ATOM или JSON (наиболее интересный для нас формат, т.к. позволяет десериализовать ответ службы в объекты JavaScript).

Все запросы производятся к базовому URI:

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

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

Объектная модель данных OData

OData Entity Data Model (EDM) - упорядоченный набор URI со структурой взаимосвязей сущностей CRM доступен через метаданные службы:

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

Этот XML-документ использует CDSL - язык описания концептульаной схемы данных (аналог WSDL для XML Web-служб). Вы можете использовать этот документ для генерации классов в приложениях Silverlight или описания объектов в JScript.

Ограничения

Служба REST предоставляет альтернативу использования SOAP-запросов, но необходимо учитывать следующие ограничения:

Доступны только следующие типы запросов: Create, Retrieve, Update и Delete.
- Не могут быть выполнены запросы, которые требуют использования метода Execute.
- Создание и удаление связей между записями осуществляется как обновление (update-запрос).
Аутентификация возможна только в рамках приложения CRM.
- Использование конечной точки REST наиболее эффективно в приложениях Silverlight и библиотеках JavaScript выполняемых как Web-ресурс CRM (CRM Web Resources - новый тип компонента, являющийся составной частью стороннего (ISV) решения).
Протокол OData реализован не полностью. Некоторые системные запросы не будут доступны.
- Подробнее об ограничениях и возможностях OData запросов.

Продолжение в статье Использование REST: запросы и фильтры.

Язык Русский

Метки:

field_vote:

Голосов пока нет

Xrm.Page.context и функция GetGlobalContext

Vladislav Osmanov — Fri, 05 Nov 2010 14:53:39 +0000

Продолжаю обзор 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 как описано ниже:

<head>
    <title>HTML Web Resource</title>
    <script src="../ClientGlobalContext.js.aspx"></script>
    <script src="Scripts/jquery1.4.1.min.js" type="text/javascript"></script>
    <script src="Scripts/ContosoScript.js" type="text/javascript"></script>
    <link href="Styles/ContosoStyles.css" rel="stylesheet" type="text/css" />
</head>

Затем вы можете использовать функции контекста в скрипте, например, чтобы получить путь к адресу REST-службы:

var serverUrl;
var ODataPath;

$(function ()
{
	var context = GetGlobalContext();
	serverUrl = context.getServerUrl();
	ODataPath = serverUrl + "/XRMServices/2011/OrganizationData.svc";
});

Язык Русский

Метки:

field_vote:

Average: 3 (27 votes)

Javascript Grid Editor - редактирование записей CRM в таблице

Vladislav Osmanov — Tue, 16 Mar 2010 10:52:28 +0000

Интересную разработку выложил Dave Berry - Javascript Grid Editor (JGE) - скрипт, позволяющий редактировать таблицы с записями CRM. Т.е. записи редактируются без открытия отдельной формы сущности.

Скрипт расширяет возможности системного компонента CRM Grid, заменяя ячейки на редактируемые поля. Изменения, конечно же, сохраняются в CRM.

Процесс установки описан в блоге автора.

Использование

В процессе настройки компонента на панели инструментов таблицы со списком записей появляются две новые кнопки: "Insert Mode" и "Edit Mode". Нажатие любой из них сначала приводит к инициализации скрипта, затем таблица переводится или в режим вставки новых записей или в режим редактирования существующих. В режиме вставки или редактирования имена кнопок меняются на “Save [New/All]” и “Cancel [New/All]”, действия которых описывать нет необходимости.

В режиме вставки появляется строка со значком в виде стрелки, нажатие на который вставляет новую строку в таблицу. Вставленная строка будет иметь "крестик", щёлкнув на который можно удалить строку.

В режиме редактирования выделение любой строки приведёт к переходу её состояния в редактируемое. Изменения не сохраняются автоматически (для этого есть кнопка “Save [New/All]”), так что, если вы внесёте изменения, а затем повторно выделите эту строку, ваши изменения пропадут.

Ограничения

Пользователи, работающие с данным скриптом должны иметь доступ к метаданным (соответствующая настройка роли).
Изменять можно только записи, находящиеся в активном состоянии.
При изменении записей, не вызываются клиентские скрипты, которые сработали бы, если запись редактировалась обычным способом - через форму.
Режим вставки работает только если в представлении таблицы есть столбцы с обязательными полями (Business Required и System Required).

The Javascript Grid Editor by David Berry is licensed under a Creative Commons Attribution-Share Alike 3.0 United States License.

Язык Русский

Метки:

field_vote:

Average: 5 (23 votes)

MS CRM ScriptXtractor

Vladislav Osmanov — Thu, 25 Feb 2010 18:49:37 +0000

Утилит для извлечения клиентских скриптов из файла кастомизации Microsoft Dynamics CRM существует несколько: одни являются надстройками над MS Word, другие - обычными Windows-приложениями.

На самом деле, задача эта не простая, а очень простая - файл кастомизации представляет собой XML-документ (схема и описание появились в SDK последних версий).

А где XML, там и XSLT : )

Извлекать скрипты будем динамически верстая HTML-таблицу с навигацией. И чтобы применить трансформацию к нашей кастомизации достаточно нескольких строк на javascript.

function LoadXml()
{
	/* получаем путь к выбранному файлу кастомизации */
	var customizationFile = document.getElementById("file");
	
	/* в элемент DIV отобразим результат */
	var result = document.getElementById("result");

	/* загружаем таблицу стилей - наш XSL */
	var xsl = new ActiveXObject("MSXML.DOMDocument");
	xsl.load("ScriptXtractor.xsl");

	/* загружаем XML с кастомизацией из выбранного файла */
	var xmlCustomization = new ActiveXObject("MSXML.DOMDocument");
	xmlCustomization.load(customizationFile.value);
	
	/* тут-то и происходит трансформация */
	var str = xmlCustomization.transformNode(xsl);
	
	/* эскейпим символы для корректного отображения */
	str = str.replace(/</g, "<").replace(/>/g, ">").replace(/&/g, "&");
	
	result.innerHTML = str;
}

Содержимое XSL-файла полностью не привожу, он есть в архиве и никакой сложности для понимания не представляет. Остановлюсь лишь на двух основных вещах: формировании выпадающего списка с перечнем сущностей и вёрсткой таблицы.

	<!-- определяем выпадающий список -->
    <select onchange="NavigateToTheEntity(this)">
      <!-- перебираем в файле кастомизации все элементы сущностей CRM -->
	  <xsl:for-each select="ImportExportXml/Entities/Entity">
        <!-- определяем сортировку по имени сущности -->
		<xsl:sort select="Name" order="ascending"/>
        <!-- определяем переменную для хранения ObjectTypeCode сущности для скрипта навигации -->
		<xsl:variable name="otc" select="ObjectTypeCode"></xsl:variable>
        <!-- создаём элемент списка с именем сущности -->
		<option value="{$otc}" >
          <xsl:value-of select="Name"/> (<xsl:value-of select="ObjectTypeCode"/>) <xsl:value-of select="LocalizedName"/>
        </option>
      </xsl:for-each>
    </select>

Думаю, основная идея XSL-преобразования понятна. Далее проходим по каждой сущности и формируем таблицу со скриптами: сначала получаем скрипты формы (события OnLoad/OnSave), затем для каждого поля.

<!-- перебираем скрипты формы -->
<xsl:for-each select="FormXml/forms/entity/form/events/event">
	<xsl:choose>
		<!-- это скрипт приложения - доступный для редактирования пользователем -->
		<xsl:when test="self::node()[@application = 'true']">
			<tr class="appScript">
				<td class="fieldNameCell">
					<!-- имя события хранится в атрибуте name -->
					<div class="eventLabel">Form event: <xsl:value-of select="@name"/></div>
				</td>
				<td class="scriptCell">
					<!-- текст скрипта - в элементе script -->
					<xsl:value-of select="script"/>
				</td>
			</tr>
		</xsl:when>
		
		<xsl:otherwise>
		<!-- а это уже системные скрипты CRM (они не видны при настройке) -->
		...
		</xsl:otherwise>
	</xsl:choose>
</xsl:for-each>

Cкрипты не извлекаются из файла в прямом смысле слова, просто исходную кастомизацию преобразуем (трансформируем) в таблицу.

Скачать утилиту со всеми приведёнными в статье кодами можно по ссылке снизу.

Прикрепленный файл	Размер
MSCRMScriptXtractor.zip	3.01 KB

Язык Русский

Метки:

field_vote:

Average: 2.9 (27 votes)