Настройка происходит в карточке путем изменения конфигурации полей.
Подготовка
Для работы с бизнес правилами нужно добавить в страницу зависимость от модуля бизнес правил:
Настройка
В настройку контрола страницы добавляем блок правил по шаблону: Пример настройки бизнес правила BINDPARAMETER
{
type: Terrasoft.core.enums.ViewModelSchemaItem.ATTRIBUTE, name:'Winner',
columnPath:'Winner',
dataValueType: Terrasoft.DataValueType.LOOKUP,
visible:true,
rules:[{ //Указываем тип правила
ruleType: BusinessRuleModule.enums.RuleType.BINDPARAMETER, //Подписываемся на параметр "Видимый"
property: BusinessRuleModule.enums.Property.VISIBLE, //Указываем правило объединения условий в случае если в массиве conditions более одного условия //по умолчанию Terrasoft.LogicalOperatorType.AND
logical: Terrasoft.LogicalOperatorType.AND,
conditions:[{
leftExpression:{ //Сравниваем значение от атрибута модели "Доход"
type: BusinessRuleModule.enums.ValueType.ATTRIBUTE,
attribute:'Revenue' }, //Устанавливаем правило сравнения "Больше"
comparisonType: Terrasoft.core.enums.ComparisonType.GREATER,
rightExpression:{ //С константой '5000'
type: BusinessRuleModule.enums.ValueType.CONSTANT,
value:5000 } }] }] }
Бизнес правило привязывается к параметру "Видимый" контрола Победитель (Winner).
В пакете условий указывается одно условие: если Доход (Revenue) больше 5000, Победитель становится видимым, иначе Победитель скрывается.
Пример настройки бизнес правила BINDPARAMETER для типа значений CARDSTATE
Бизнес правило позволяет установить значение видимости или доступности для редактирования контрола в зависимости от текущего состояния страницы.
В данном случае указывается, что поле будет доступно для редактирования только в режиме изменения записи, а в режиме добавления/копирования будет неактивно.
Пример настройки бизнес правила FILTRATION
{
type: Terrasoft.core.enums.ViewModelSchemaItem.ATTRIBUTE, name:'Contact',
columnPath:'Contact',
dataValueType: Terrasoft.DataValueType.ENUM,
visible:true,
rules:[{ //Указываем тип правила
ruleType: BusinessRuleModule.enums.RuleType.FILTRATION, //Указываем будет ли обратное автозаполнение
autocomplete:true, //Указываем мета-путь относительно базового обьекта('Contact') //по которому будем фильтровать
baseAttributePatch:'Account', //Указываем тип фильтрации
comparisonType: Terrasoft.ComparisonType.EQUAL, //Указываем тип значения для фильтрации
type: BusinessRuleModule.enums.ValueType.ATTRIBUTE, //Указываем атрибут модели для сравнения (если тип значения - атрибут)
attribute:'Account', //Указываем мета-путь значения в выбранном атрибуте (если нужно)
attributePath:'', //Если тип значения не атрибут, указываем значение //(константа | имя системной настройки | имя системного значения)
value:'' }] }
Бизнес правило устанавливает фильтрацию контрола Контакт (Contact) по полю Контрагент (Account) в зависимость от значения атрибута модели Контрагент (Account)
Пример настройки бизнес правила AUTOCOMPLETE (Правило доступно с версии 7.0.1.106)
{
type: Terrasoft.ViewModelSchemaItem.ATTRIBUTE, name:'JobTitle',
columnPath:'JobTitle',
... rules:[{ //Указываем тип правила
ruleType: BusinessRuleModule.enums.RuleType.AUTOCOMPLETE, //Указываем атрибут-источник модели для автозаполнения
attribute:'Job', //Указываем тип автозаполнения
autocompleteType: BusinessRuleModule.enums.AutocompleteType.DISPLAYVALUE }] }
Бизнес правило производит автозаполнение контрола Полное название должности (JobTitle) из параметра displayValue значения контрола Должность (Job)
Перечисления
Данные перечисления не являются ядровыми и становятся доступны после подключения модуля бизнес правил. Тип действия бизнес правила
Тип
Описание
BusinessRuleModule.enums.RuleType.AUTOCOMPLETE
Установка правил автозаполнения контрола Пример: автозаполнение полного названия должности исходя из выбранной должности..
BusinessRuleModule.enums.RuleType.BINDPARAMETER
Установка правил на параметр контрола Пример: Включить поле результат при изменении состояния в карточке активности.
BusinessRuleModule.enums.RuleType.FILTRATION
Установка правил фильтрации контрола Пример: Фильтрация контактов по выбранному контрагенту.
Тип автозаполнения
Тип
Описание
BusinessRuleModule.enums.AutocompleteType.ASIS
Автозаполнение значением "как есть"
BusinessRuleModule.enums.AutocompleteType.VALUE
Автозаполнение параметром value. Актуально для lookup-значений.
Значение текущего состояния страницы (добавление/редактирование/копирование и т.п.).
Элемент из списка ConfigurationEnums.CardState Пример использования: ConfigurationEnums.CardState.Edit (Страница в режиме редактирования)
При начале работы с системой временами возникает необходимость найти, как конкретная функция или метод используются в конфигурации, особенно когда это касается ядрового метода.
Для того, чтобы произвести поиск по исходному коду всех схем конфигурации, можно сделать следующим образом:
1. Установить в Web.config параметр IncludeDebugInformation в true и установить ему папку для сохранения схем:
2. Скомпилировать любую схему;
3. Войти в папку %TEMP%\BPMonline\TSBpm\Src
В папке будут файлы исходных кодов схем конфигурации, по которым можно произвести поиск любым файловым менеджером: TotalCommander, FAR Manager, Проводник Windows и т.д.
При компиляции конфигурации на сервере каждый раз собирается dll-библиотека, с которой затем работает ядро системы на сервере IIS.
На данный момент описан пока только скрипт scr_DB (в планах описать, хотя бы частично, scr_WindowUtils). По остальным, наиболее используемым скриптам, надеюсь, мне помогут все желающие. :)
Правила формирования описаний функций:
1. Описываемые скрипты прописываются в параметре ScriptsArray (в самом верху скрипта scr_ConfigurationFunctionsDocument). На данный момент, как я писал выше, там прописан только scr_DB.
2. Для формирования комментариев к функциям следует придерживаться следующего формата:
/* Описание назначения функции
Входящие параметры:
Param1 - описание параметра;
Param2 - описание параметра
*/ function MyFunction(Param1, Param2){
... }
Сам скрипт scr_ConfigurationFunctionsDocument пробегается по всему содержимому и "выдергивает" комментарии перед функциями, обрамленные "/*" и "*/".
Примечание: Прикрепляю scr_DB с комментариями, предназначенный для того, кто хочет сформировать такой документ на своей конфигурации. С этим связано и предупреждение. Если в scr_DB Вами добавлялись какие-то функции, то тогда Вам нужно будет слить Ваш текущий вариант этого сервиса и тот, что я прикрепил. Будьте, пожалуйста, внимательны, поскольку скрипт scr_DB используется везде, во всей системе, и потеря в сервисе одной функции может привести к некорректной работе всей системы. Просьба делать бекап перед такими экспериментами.
Интересно, как повлияет на быстродействие системы добавление строчек с описанием функций в общеиспользованные скрипты? Насколько это способно затормозить систему? Не раз сталкивался с тем фактом, что большие скрипты или большое количество подключаемых скриптов замедляют работу системы.
Еще одна интересная мысль для проверки: при загрузке текста скриптов в оперативную память загружаются ли комментарии или они игнорируются? То есть, влияет ли количество комментариев в скрипте на объем используемой памяти при его загрузке?
В случае, если Вы планируете дорабатывать систему, рекомендуется создавать тестовую конфигурацию. Тестовая конфигурация позволяет дорабатывать и тестировать продукт, а также легко переносить изменения в основную конфигурацию, при этом не рискуя работоспособностью системы.
Для того, чтобы создать дополнительную конфигурацию, перейдите в Инструменты – Конфигурация – Действия и выберите Открыть список конфигураций:
Создайте новую конфигурацию:
После этого в окне входа добавится дополнительная строка выбора конфигурации:
Таким образом, сотрудники смогут работать в основной конфигурации, а разработчик – в дополнительной. Обратите внимание, информация (все контакты, контрагенты, активности) в данных конфигурациях является общей.
Принципы работы с веткой конфигурации таковы:
1. Для каждого из разработчиков рекомендуется создавать отдельную ветку конфигурации;
2. Когда разработчик работает со схемой, ее следует блокировать - это будет видно на всех ветках;
3. После того, как изменения проверены и оттестированы, можно переносить изменения на родительскую для данной конфигурацию;
4. В случае, если Вам необходимо вернуться к той версии схемы, которая у Вас в родительской конфигурации, необходимо опубликовать схему из родительской конфигурации.
Добрый день. У меня проблема с созданием конфигурации. При создании своей конфигурации выдет такую ошибку:
Exception Message: Недостаточно прав для добавления записи в объект "SysWorkspace"
Exception Type: System.Security.SecurityException
Exception Source: Terrasoft.Core
но запись создает в списке конфигураций. При логине не появляется выбор конфигурации. Дал полный доступ своему юзеру и групе "Системные администраторы" к объектам "Робочее место, Раздел в рабочем месте, Рабочие пространство пользователя", к действиям анологично. Что делать ? не там доступы даю ?
Если у Вас версия системы старше чем 5.3.*, для того, чтобы созданная конфигурация появилась в списке выбора, необходимо очистить redis командой flushall.
Также не совсем понятно из Вашего поста, пользователь под которым Вы создаете доп. конфигурацию входит в роль "Системные администраторы?
Добрый день !
Возникла проблема при создании ветки конфигурации. BPMonline 5.4.0.1351.
При попытке войти выбрав созданную конфигурацию, выдается ошибка :
Exception Message: Файл '/1/ViewPage.aspx' не существует.
Exception Type: System.Web.HttpException
Exception Source: System.Web
Что это может быть ?
Николай, уточните, пожалуйста, Вы вносили какие-либо измененния в web.config перед созданием приложения?
Изначально, если Вы хотите добавить новую конфигурацию, простов сайт нужно добавить приложение "1" по аналогии с приложением "0", которое было создано при разворачивании сайта. Физический путь должен быть таким же.
Здравствуйте.
После добавлении конфигурации открывается только страница "управления конфигурацией" причем совершенно пустая и невозможно ничего добавлять и удалять.
Что можно предпринять?
Нужна уточняющая информация.
Что на этом сервере будет кроме СУБД?
Например
сервер терминалов
Web сервер
может сопутствующие службы такие как
ActiveDirectory
Mail server
Кстати, по поводу СУБД. На текущий момент лучше использовать MS SQL 2008 R2. Тут есть новый тип данных (FileStream) который может хорошо повысить работу СУБД в целом.
А вообще сейчас идет такая тенденция, что мощностей железа становится слишком много для одного сервер с определенной ролью, поэтому очень часто используют виртуализацию (детально на верно нет смысла описывать). И у Микрософт и у VmWare есть бесплатные инструменты для использования.
Нам необходим только сервер с которым будет работать Террасофт, без ActiveDirectory
Mail server Web сервер. Так как у нас будут работать удаленно люди то необходим будет и сервер терминалов.
Нужен сервер для комфортной работы пользователей.
Добрый день!
При выборе сервера Вы можете опираться на прикрепленный документ. В нем присутствуют требования как к серверу СУБД для работы Terrasoft, так и для терминального сервера.
в разделе в блоке фильтрации (FilterBuilder) кнопка «Применить»
Но не так давно появился еще один удобный способ, о котором мало кто знает:
нужно еще раз нажать на иконку раздела в менеджере разделов (WorkspaceNavigator). Также использовать этот эффект удобно еще в одном случае: при переходе в раздел, чтобы увидеть раздел с обновленными данными (актуально просмотра расписания в разделе Задачи), нужно переходить через двойное нажатие на иконке раздела.
Появилась эта функцию начиная с версии 3.3.1. Реализована она целиком в конфигурации, поэтому, если кому-то будет интересно, могу описать как реализовать на более ранних версиях.
Если Вы используете несколько конфигураций, то старайтесь, чтобы начало названия каждой конфигурации начиналось на уникальную букву, тогда в окне логина можно быстро выбрать любую конфигурацию нажатием клавиш: "буква", Enter. Особенно это удобно, когда для входа используется Window Authentication, т.к. в этом случае при появлении окна логина «фокус» уже будет стоять на списке конфигураций (последнее появилось в 3.3.2.138). Также с версии 3.3.2.167 редактирование конфигураций открывается по F2, как и во всех LookupControl’ах открывается справочник.
P.S. Сегодня начинаю серию статей по маленьким удобствам в Terrasoft, так называемым Hints&Tips (cоветы и рекомендации). Буду делится своими методами повышения юзазабилити :)
Т.к. я занимаюсь разработкой разных модулей (плагинов) для системы Террасофт, то мне приходится держать базы разных конфигураций и разных версий. И одни раз я столкнулся с такой проблемой (это было давно, но может кому будет полезно). Начал я именовать конфигурации след образом - 3.0.4 X25, 3.3.0 CRM, 3.3.0 XRM и т.д. Вроде всё последовательно и красиво, но при подключении к MS SQL через TS мне выдавалась ошибка о проблеме с репликацией. Долго искал в чем же дело. В результате стало понятно что эта проблема появляется из-за неправильного именования экземпляров баз, и оно не должно начинаться с цифры.
Примерно так.
Так что читайте внимательно первый пост
"Александр Кравчук" написал:старайтесь, чтобы начало названия каждой конфигурации начиналось на уникальную букву
"Алёна Марусина" написал:Александр, а есть где-нибудь задокументированный список горячих клавиш? А то я, в основном, методом проб и ошибок действую...
Описание горячих клавиш есть в документации. Например Базовый регламент использования Terrasoft CRM: на странице 35 описание горячих клавиш реестра, на стр. 47 открытие справочника по F2 и т.д
Прежде всего, хочу заметить, что обновление может выполняться как самостоятельно Вами, так и службой технической поддержки.
О нумерации версий и условиях обновления программного продукта Terrasoft.
Формат номера версии Terrasoft представлен в виде:
Например, в версии 3.2.0.14: номер продукта – 3, релиз – 2, конфигурация – 0, сборка – 14.
Бесплатное обновление Terrasoft возможно только в пределах сборки и/или конфигурации. То есть, если Вы используете версию 3.3.0.61 то обновление до 3.3.1.57 для Вас будет бесплатным, если же Вы используете версию 3.2.1.33, то обновление до 3.3.0.61 должно происходить в рамках Вашего пакета поддержки и быть оплачено / согласовано с Вашим менеджером.
Для выполнения обновления конфигурации необходимы:
Базовые навыки по работе с СУБД:
Понимание архитектуры системы управления базами данных, умение создать резервную копию, восстановить её, создание и выполнение простых запросов и выражений и т.д.
Большим плюсом будет опыт работы с выбранной Вами СУБД.
Уверенные навыки по работе с Террасофт:
Понимание архитектуры Террасофт, уверенная работа с Террасофт Администратор, хорошие навыки работы с сервисами системы, умение "читать" код JavaScipt и т.д.
Большим плюсом будет опыт программирование на языке JavaScipt.
Данные навыки можно приобрести, посетив курс наш трехдневный курс: «Создание конфигурации Terrasoft CRM».
Или же путем опытной эксплуатацией нашего продукта.
Для понимания общей схемы выполнения обновления рекомендуется изучить Руководство по выполнению обновления.
На данный момент это руководство можно загрузить, перейдя по ссылке: http://www.terrasoft.com.ua/downloads/Update/TSCRM_UpG.rar
Пароль на архив: T$CrM_Up!G.
Что же до инструментария:
При выполнении обновления используются утилиты применения пакетов разницы (о них подробно описано в руководстве), а так же утилиты для выгрузки\загрузки сервисов: Extract Services, Merge Services. Этот инструментарий мы предоставляем и поддерживаем!
Так же мы используем утилиту Araxis Merge, навыки и понимание работы этой утилиты значительно облегчает выполнение обновления, но не являются обязательными.
Например:
Если изменялись отчеты, карточки, представления и т.д. такие изменения необходимо переносить вручную.
Соответственно, после внесения большого количества изменений обновление проще выполнять самостоятельно (имея вышеописанные навыки и инструментарий) или с помощью отдела разработки бизнес-решений.
В любом случае специалисты службы технической поддержки предоставляют качественные консультации по вопросу обновления конфигурации. А так же ведут базу знаний, в которой описаны основные проблемы и способы их решения.
Решения с этой базы знаний предоставляются клиенту максимально оперативно.
Обновление приемлемо к базовой конфигурации, что (к большому сожалению) очень редко встречается. Всегда хотят что-то изменить, где-то в админке поковыряться... :biggrin:
Еще при написании конфигурации желательно учитывать возможность обновления. Стараться делать как можно меньше изменений. Например лучше добавить поле, чем переименовывать существующее. В идеале изменения в сервисах должны где-то отмечаться. Новые функции в скриптах как-то отделять. Изменения в скриптах комментировать.
"Underscore a.k.a. _" написал:Еще при написании конфигурации желательно учитывать возможность обновления. Стараться делать как можно меньше изменений. Например лучше добавить поле, чем переименовывать существующее. В идеале изменения в сервисах должны где-то отмечаться. Новые функции в скриптах как-то отделять. Изменения в скриптах комментировать.
Это было бы очень хорошим тоном написания своей конфигурации.
Подобные решения весьма приятно поддерживать и комфортно обновлять.
Собственно, долго думал прежде, чем решиться начать этот блог. Но потом решил, что вполне вероятно, что те шаги, который мы делаем сейчас в направлении внедрения Террасофт в своей компании, могут быть интересны другим пользователям. В блоге буду стараться выкладывать результаты проделанной работы с максимально возможным описанием.
Скорее всего этот блог будет полезен тем, кто давно купил Террасофт, но по каким-то причина сейчас не может перейти на новую версию. Многие вещи, которые будут здесь описаны, скорее всего в последней версии уже доделаны и исправлены.
Наша компания приобрела Террасофт 3.1.1.6 около года назад (вроде так). На тот момент планы на счет Террасофт были грандиозные, но когда стали копать глубже, то оказалось, что в системе есть вещи, которые нам явно не подходят, и пыл поубавился. Однако, поскольку деньги уже были потрачены, то придется доводить все до ума. Благо, купили мы платформу X25, а у нее потенциал хороший.
Каждая тема в блоге будет посвящена какой-то конкретной недоработке в системе. Чаще всего они видимо будут относится конкретно к нашей версии (3.1.1.6) или вообще к серии (3.1.1.х), но думаю мы не одни кто пока пользуется этой версией.
