Идентификаторы и системные имена
Введение
В целях идентификации объектов в Comindware Business Application Platform используются уникальные имена двух типов:
- идентификаторы;
- системные имена.
Идентификаторы и системные имена служат для обращения к объектам в формулах, выражениях N3, C#-скриптах, вызовах API, HTTP- и SQL-запросах и т. д. для управления данными и процессами.
Идентификаторы
Идентификатор — уникальный признак объекта, по которому его можно отличить от других. Аналогичен ключевому полю в реляционных базах данных.
Идентификатор представляет собой строку с номером объекта и формируется автоматически для всех объектов при их создании, например (<XX>
— номер объекта):
Объект | Идентификатор |
---|---|
Аккаунт | account.<XX> |
Атрибут | op.<XX> |
Группа | group.<XX> |
Запись, процесс, задача | <XX> |
Карточка | card.<XX> |
Кнопка | event.<XX> |
Приложение | sln.<XX> |
Роль | role.<XX> |
Сценарий | trigger.<XX> |
Таблица | lst.<XX> |
Форма | form.<XX> |
Шаблон записи | oa.<XX> |
Шаблон процесса | pa.<XX> |
При экспорте и импорте приложений идентификаторы назначаются заново, поэтому выражения, в которых они использовались, потребуется скорректировать соответствующим образом.
Системные имена
Системное имя — признак объекта, уникальный и отличающий его от других объектов в заданном контексте. Аналогично имени объекта или переменной в программировании.
- Например, системное имя шаблона может повторяться в разных приложениях, а системное имя атрибута может повторяться в различных шаблонах.
- Так, в каждом шаблоне есть атрибуты
_creator
и_creationDate
.
Системное имя в виде строки задаёт создатель объекта. Оно является более наглядным, чем идентификатор.
- Не должно начинаться с цифры. Рекомендуется использовать буквы латинского алфавита, цифры и символ «_». Заполняется автоматически по названию.
- Например, для атрибута «Номер заявки» можно задать системное имя
RequestNumber
илиНомер_заявки
.
При экспорте и импорте приложений системные имена остаются неизменными, и корректировать выражения с ними не требуется.
Связанные статьи
Эта статья была полезна 3 чел.