mirror of
https://github.com/Nikolay-Shirokov/cc-1c-skills.git
synced 2026-07-14 23:05:16 +03:00
github-actions[bot]
110 lines
6.6 KiB
Markdown
110 lines
6.6 KiB
Markdown
# Блоки объекта
|
|
|
|
Кросс-типовые блоки уровня объекта (применимы к ссылочным типам — Catalog, Document, ChartOf*, ExchangePlan,
|
|
BusinessProcess, Task и др.).
|
|
|
|
## Представления
|
|
|
|
Тексты представления объекта в интерфейсе (ML — строка или `{ru,en}`, по умолчанию пусто):
|
|
|
|
| Ключ | Смысл |
|
|
|------|-------|
|
|
| `objectPresentation` | представление объекта |
|
|
| `extendedObjectPresentation` | расширенное представление объекта |
|
|
| `listPresentation` | представление списка |
|
|
| `extendedListPresentation` | расширенное представление списка |
|
|
| `explanation` | пояснение |
|
|
|
|
Набор доступных ключей зависит от типа (у списочных без формы объекта нет `objectPresentation` и т.п.).
|
|
|
|
```json
|
|
"listPresentation": "Организации", "objectPresentation": { "ru": "Организация", "en": "Company" }
|
|
```
|
|
|
|
## Команды
|
|
|
|
Команды объекта. Ключ — имя команды, значение — объект свойств (map `имя → объект` или массив `[{name, …}]`).
|
|
Для каждой команды создаётся заготовка модуля с обработчиком `ОбработкаКоманды`.
|
|
|
|
| Ключ | Умолчание | Значения |
|
|
|------|-----------|----------|
|
|
| `synonym` | из имени | ML |
|
|
| `tooltip` | пусто | ML |
|
|
| `comment` | пусто | строка |
|
|
| `group` | **обязательно** | группа размещения (см. ниже) |
|
|
| `commandParameterType` | пусто | тип параметра (напр. `CatalogRef.Номенклатура`) — **только для групп формы** |
|
|
| `parameterUseMode` | `Single` | `Single` / `Multiple` |
|
|
| `modifiesData` | `false` | bool |
|
|
| `representation` | `Auto` | вид отображения |
|
|
| `picture` | пусто | ссылка на картинку (`StdPicture.Print`, `CommonPicture.Загрузка`) |
|
|
| `shortcut` | пусто | сочетание клавиш |
|
|
|
|
```json
|
|
"commands": {
|
|
"ПечатьЭтикеток": { "synonym": "Печать этикеток", "group": "FormCommandBarImportant",
|
|
"commandParameterType": "CatalogRef.Номенклатура", "picture": "StdPicture.Print" }
|
|
}
|
|
```
|
|
|
|
**Группа (`group`) обязательна** — каждая команда размещается в группе командного интерфейса:
|
|
|
|
- **Командный интерфейс раздела** (панель навигации / панель действий; `commandParameterType` **недоступен**):
|
|
`NavigationPanelImportant` / `NavigationPanelOrdinary` / `NavigationPanelSeeAlso`,
|
|
`ActionsPanelCreate` / `ActionsPanelReports` / `ActionsPanelTools`.
|
|
- **Командный интерфейс формы** (`commandParameterType` допустим): `FormCommandBarImportant` /
|
|
`FormCommandBarCreateBasedOn`, `FormNavigationPanelImportant` / `FormNavigationPanelGoTo` / `FormNavigationPanelSeeAlso`.
|
|
- **Кастомная группа:** `CommandGroup.<Имя>` (параметр допустим).
|
|
|
|
Группа раздела вместе с `commandParameterType` → ошибка.
|
|
|
|
## `inputByString` / `dataLockFields` / `basedOn`
|
|
|
|
Списки полей/объектов уровня объекта. Поля — по имени реквизита объекта (обычного или стандартного).
|
|
|
|
- **`inputByString`** — поля быстрого ввода по строке. По умолчанию выводятся из Кода/Наименования — ключ не нужен;
|
|
задать при другом наборе/порядке, либо `[]` для отключения.
|
|
```json
|
|
"inputByString": ["Код", "Наименование", "Контрагент"]
|
|
```
|
|
- **`dataLockFields`** — поля управляемой блокировки данных (по умолчанию пусто).
|
|
```json
|
|
"dataLockFields": ["Организация", "Контрагент"]
|
|
```
|
|
- **`basedOn`** — «ввод на основании»: список ссылок на объекты метаданных (по умолчанию пусто).
|
|
```json
|
|
"basedOn": ["Catalog.Контрагенты", "Document.ЗаказПоставщику"]
|
|
```
|
|
|
|
## `standardAttributes` — кастомизация стандартных реквизитов
|
|
|
|
Стандартные реквизиты объекта (Наименование, Код, Владелец, …) переопределяются блоком
|
|
`standardAttributes` — объект `{ ИмяРеквизита: { переопределения } }`. Имена — как в 1С: `Description`, `Code`,
|
|
`Owner`, `Parent`, `DeletionMark`, `Ref` и т.д. (для Document — `Date`, `Number`, `Posted`).
|
|
|
|
Переопределяемые поля — как у обычного реквизита (`synonym`, `tooltip`, `fillChecking`, `fillValue`,
|
|
`choiceParameters`, `comment`, `mask`, `choiceForm`; полный набор — `attributes.md`).
|
|
|
|
```json
|
|
"standardAttributes": {
|
|
"Description": { "synonym": "Наименование контрагента" },
|
|
"Code": { "fillChecking": "ShowError" }
|
|
}
|
|
```
|
|
|
|
## `characteristics` — «Дополнительные реквизиты и сведения»
|
|
|
|
Привязка плана видов характеристик. Массив; каждый элемент связывает **источник типов** (где определены
|
|
характеристики) и **источник значений** (где хранятся значения).
|
|
|
|
```json
|
|
"characteristics": [{
|
|
"types": { "from": "Catalog.НаборыДопРеквизитов.ДополнительныеРеквизиты",
|
|
"key": "Свойство", "filterField": "Ссылка", "filterValue": "Справочник_Организации" },
|
|
"values": { "from": "Catalog.Организации.TabularSection.ДополнительныеРеквизиты",
|
|
"object": "Ссылка", "type": "Свойство", "value": "Значение" }
|
|
}]
|
|
```
|
|
|
|
- `from` — таблица-источник; `key`/`filterField`/`object`/`type`/`value` — поля источника (по имени реквизита).
|
|
- `filterValue` — значение фильтра типов: имя предопределённого набора (строка) или путь к элементу.
|