суббота, 24 марта 2012 г.

Немного о Java script часть 1

Немного о Java script часть 1  

В этой статье мне хотелось описать начало разработки скриптов на формах в CRM2011.

Основным отличием в аритектуре JS - скриптов CRM2011 от CRM4 является появление Web Resource. Если раньше приходилось хранить скрипты непосредственно на форме или же   подключать файлы, хранящиеся на жёстком диске, то сейчас коды скриптов хранятся в отдельных ресурсах, и уже эти ресурсы подключаются на форму. Теперь можно написать один общий код и подключить его на несколько форм одновременно. И править тоже только в одном месте). Рекомендую называть веб-ресурсы таким образом, чтобы исходя из их названия можно было понять к какой сущности они относятся и какого типа функционал в них размещен.
Создать новый веб-ресурс можно следующим способом:
Перейдем на форму веб-ресурсов через навигационную панель  
Settings->Customization->Customize the System->Web Resources->New



Заполните поля аналогично с рисунком. Укажите в поле Type Script. Чтобы задать содержимое веб-ресурса нажмите кнопку Text Editor. У Вас откроется окно редактора, в котором Вы сможете добавлять свои функции. Давайте добавим функцию, которая будет срабатывать при загрузке формы сущности Account.
function onload()
{
    alert("Hello world!!!");
}
Скопируйте этот код в редактор веб-ресурса. 
После этого нажмите кнопку Save. После сохранения нажмите кнопку Publish.
Поздравляю Вы создали веб-ресурс.

Теперь давайте добавим его на форму. 
Для этого перейдем в кастомизацию сущности Account
Settings->Customization->Customize the System->Entities->Account->Forms.
У Вам откроется список форм. Выберите двойным кликом форму Main, и у Вас откроется следующая форма. 


Нажмите на кнопку Form Properties. У Вас откроется следующая форма.

Нажмите на выделеную кнопку Add и добавте на форму созданный Вами веб-ресурс.
Попробуем разобраться, что произошло сейчас и к чему это приведет. Мы добавили веб-ресурс. Его код добавится при загрузке на форму. Таким образом у нас при загрузке добавляется функция. Но эта функция нигде не вызывается. Возникает логичный вопрос: зачем создавать функцию, а не писать сразу исполняемый код? Это сделано потому, что в момент загрузки ресурса на форме еще нет элементов и при обращении к ним произойдет ошибка. Значит необходимо вызвать нашу функцию и сделать это при загрузке формы. Для этого обратите внимание на выделенную синим прямоугольником часть на предыдущем скрине. Здесь тоже есть кнопка Add и два выпадающих списка. Изучите содержимое этих списков. В списке Control содержатся контролы и разделы формы. В списке Event возможные события для выбранного контрола. Оставим содержимое списков без изменений и нажмем кнопку Add. Откроется следующая форма. 


Здесь мы видим в верхней части два выпадающих поля:
Library - содержит список добавленных на форму веб-ресурсов
Function - название функции, которую мы хотим "повесить на выбранное нами событие из выбранного веб-ресурса"

Два CheckBox:
Enabled - Включает и отключает событие
Pass execution context as first parameter - добавляет в качестве первого параметра функции контекст.

Текстовое поле параметров
Записанные здесь через запятую значения параметров передаются в функцию.
Заполните поля, как показано на рисунке, нажмите  ОК, сохраните изменения в свойствах формы, после чего сохраните и опубликуйте саму форму. Терерь перейдем на форму account и увидим что получилось.







1 комментарий: