Идентификаторы и системные имена
Введение
В целях идентификации объектов в Comindware 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 или Номер_заявки.
Эта статья была полезна 1 чел.