Вся работа в Контракте ведётся с элементами добавленных в него источников — приложений ELMA365 из любых разделов и решений. Чтобы добавить источник и настроить отображение его элементов на странице контракта, необходимо связать его поля с полями созданного контракта. После этого в Поля контракта будут передаваться значения полей его источников. В дальнейшем вы сможете использовать их в бизнес-процессах и сценариях как переменные.
В контракте используется два вида полей:
- Системные поля — свойства, добавленные в контракт по умолчанию. Это поля, присутствующие в любом созданном в ELMA365 приложении: Идентификатор, Дата создания, Автор, Дата изменения, Редактор, Дата удаления, Название. А также добавленное только в контракт поле Ссылка на оригинальный элемент. С его помощью элемент в контракте связывается с элементом в приложении-источнике. Это поле удобно использовать, чтобы обращаться к оригинальному элементу в бизнес-процессах и сценариях.
Системные поля нельзя удалить. При добавлении в контракт источника, системные поля будут связываться друг с другом автоматически.
- Пользовательские поля. Чтобы в контракт, помимо системных, передавались другие поля источника, вам необходимо добавить свойства для связи в контекст контракта. Обратите внимание, чтобы поля контракта и источника связывались корректно, их типы должны совпадать. Перед тем как добавлять новый источник, убедитесь, что в этом приложении созданы все поля, которые соответствуют по типу каждому из полей контракта. В противном случае, подключить приложение к контракту будет невозможно.
Добавить поля контракта
Добавить пользовательские поля в контракт можно ещё на этапе его создания при открытии окна Настройки формы. Если вы пропустили этот шаг или вам понадобилось изменить свойства контракта, вы можете сделать это в настройках контрактов.
При добавлении полей учитывайте, что поле такого же типа должно присутствовать во всех приложениях, с которыми планируется работать в контракте. В противном случае, подключить приложение к контракту будет невозможно.
Чтобы открыть настройки:
- Нажмите значок шестерёнки справа от названия контракта.
- В открывшемся меню настроек выберите пункт Поля контракта.
- Откроется окно Настройки контрактов со списком всех добавленных в контракт свойств. Нажмите кнопку +Добавить.
- В открывшемся окне выберите Тип* свойства, укажите Отображаемое имя*. При необходимости укажите настройки, отличающиеся в зависимости от выбранного типа свойства.
- Нажмите кнопку Создать. Если нужно добавить ещё одно поле, нажмите кнопку Создать и новое.
Поле отобразится в общем списке свойств.
Если в контракт добавлен источник и в нём нет поля с таким же названием, созданное свойство добавится в контекст источника. Если в источнике присутствует свойство с аналогичным названием и типом, поля автоматически свяжутся.
Обратите внимание, если в источнике есть свойство с таким же названием, но другим типом, связь с источником будет утеряна.
Чтобы удалить свойство из контракта, выделите его в списке, в правом верхнем углу нажмите кнопку Удалить и подтвердите действие. Обратите внимание, удалить системные поля контракта нельзя.
Пример связывания полей
Рассмотрим работу с полями контракта и источника на примере.
Предположим, вы создали контракт Документы с контрагентами и хотите связать его с приложениями Исходящие договоры и Входящие счета.
Контракт является пустым интерфейсом, в который передаются элементы других приложений. Чтобы настроить связь контракта и его источника, вам необходимо добавить пользовательские свойства в контекст контракта. В них будут передаваться данные из приложений, например, информация о контрагенте или сумме. Обратите внимание, чтобы источник подключился к контракту корректно, для каждого поля источника, которое вы хотите передать, необходимо создать схожее по типу свойство в контракте.
Перейдите в Настройки контракта > Поля контракта, как описано выше. Нажмите кнопку +Добавить и создайте свойство с названием Компания и типом Приложение. В его настройках выберите приложение Компании из раздела CRM. Таким же образом добавьте свойство Сумма с типом Деньги.
Теперь вы можете перейти в Настройки источников и добавить приложения Исходящие договоры и Входящие счета. При добавлении источников свяжите поле контракта Компания с полем Контрагент из обоих приложений. В поле Сумма передайте значения полей Сумма договора и Сумма счёта.
Поля контракта и источника, совпадающие по названию и типу, будут связываться автоматически.
Вы можете создать в контракте дополнительное свойство типа Приложение, чтобы записать в него значение поля Тип договора из приложения Исходящие договоры. Однако, в этом случае связь контракта с приложением Входящие счета может быть утеряна, если в этом источнике есть поле с таким же названием, но другим типом. На странице Настройки контрактов этот источник будет подсвечен красным цветом.
Если совпадений по названию нет, в приложении Входящие счета автоматически создастся новое поле.
Поиск по полям контракта
На этапе добавления и настройки полей вы можете включить опции Поиск и сортировка по полю и Полнотекстовый поиск для свойств типа Строка. В этом случае вы сможете осуществлять поиск элементов приложения по параметрам на странице контракта. Для этого нажмите на значок в строке поиска, укажите нужные параметры и нажмите Поиск.
Параметры поиска, которые вы планируете использовать многократно, можно указать один раз и сохранить как фильтр. Созданные вами фильтры будут отображаться на боковой панели окна поиска по параметрам. Чтобы применить фильтр, нажмите на его название.
Кроме того, вы можете просматривать элементы, которые были удалены из контракта. Для этого в окне Поиск по параметрам нажмите кнопку Удаленные.
Подробнее о том, как искать элементы по параметрам, читайте в статье «Поиск и фильтры».