1cskills

Category: Tools & Productivity | Uploader: Starik2005 | Downloads: 0 | Version: v1.0（Latest）
Используй при работе с кодом на языке 1С (файлы .bsl, .os) или при написании запросов 1С
Changelog: Source: GitHub https://github.com/Starik2005/1c-syntax-mcp
Directory Structure

Current level: tree/master/skills/1cskills/
📄 SKILL.md 56.7 KB
SKILL.md

---
name: 1cskills
description: Используй при работе с кодом на языке 1С (файлы .bsl, .os) или при написании запросов 1С
---

# Навык разработки на 1С:Предприятие

Используй этот навык при работе с кодом на языке 1С (файлы .bsl, .os) в любом проекте 1С.

## Правила использования MCP для синтаксиса 1С

### Жёсткое требование: всегда проверяй через MCP

При любом вопросе о встроенных функциях, методах, типах данных 1С — **ОБЯЗАН** использовать инструменты 1C Syntax MCP. **ЗАПРЕЩЕНО** полагаться на память или общие знания о платформе 1С.

**Доступные инструменты:**
| Инструмент | Назначение |
|---|---|
| `1c-syntax_search_syntax` | Поиск функций/методов/объектов по имени (русский или английский) |
| `1c-syntax_get_function_info` | Детальная информация о функции/методе (параметры, возвращаемое значение, описание) |
| `1c-syntax_suggest_completion` | Автодополнение по частичному имени функции |
| `1c-syntax_validate_syntax` | Проверка корректности синтаксиса вызова функции |

### Обязательный алгоритм

1. **Пользователь спросил про функцию/метод/тип** → сразу вызови `1c-syntax_search_syntax` или `1c-syntax_get_function_info`
2. **Функция возвращает массив или объект** → вызови `1c-syntax_get_function_info` для каждого связанного типа
3. **Нужны детали вложенных структур** → ищи типы элементов через `1c-syntax_search_syntax` и получай информацию через `1c-syntax_get_function_info`
4. **Только после получения всех данных из MCP** → формируй ответ

### Цепочка поиска для вложенных типов

Пример: пользователь спросил про `СтрНайтиВсеПоРегулярномуВыражению`:
```
1c-syntax_get_function_info("СтрНайтиВсеПоРегулярномуВыражению")
  → Возвращает: Массив<РезультатПоискаПоРегулярномуВыражению>
1c-syntax_get_function_info("РезультатПоискаПоРегулярномуВыражению")
  → Есть метод ПолучитьГруппы()
1c-syntax_get_function_info("ПолучитьГруппы")
  → Возвращает: Массив<ГруппаРезультатаПоискаПоРегулярномуВыражению>
1c-syntax_get_function_info("ГруппаРезультатаПоискаПоРегулярномуВыражению")
  → Свойства: Значение, НачальнаяПозиция, Длина
```

### Запрещено

- **Придумывать** свойства, методы, параметры, которые не подтверждены MCP
- **Предполагать** структуру типов на основе аналогий с другими языками
- **Отвечать без проверки** через MCP, даже если «точно знаешь» ответ
- **Останавливать поиск** на промежуточном уровне, если пользователь спрашивает детали вложенных структур

### Если MCP не нашёл

Если `1c-syntax_search_syntax` и `1c-syntax_get_function_info` не нашли информацию — честно скажи об этом пользователю. Не пытайся восполнить пробел догадками.

## 1C MCP Toolkit (Native)

Для интерактивной работы с базой 1C доступен MCP-сервер **1C MCP Toolkit (Native)** v1.0.0.

**Endpoint:** `http://127.0.0.1:6003/mcp`

### Доступные инструменты

| Инструмент | Назначение |
|---|---|
| `execute_query` | Выполнение запросов на языке 1C (ВЫБРАТЬ, ПОМЕСТИТЬ и т.д.) |
| `execute_code` | Выполнение произвольного кода 1C (сервер/клиент) |
| `get_metadata` | Получение метаданных конфигурации (справочники, документы, регистры) |
| `get_event_log` | Чтение журнала регистрации с фильтрацией |
| `get_object_by_link` | Получение объекта по навигационной ссылке |
| `get_link_of_object` | Генерация навигационной ссылки из описания объекта |
| `find_references_to_object` | Поиск ссылок на объект в документах, справочниках, регистрах |
| `get_access_rights` | Получение прав доступа по ролям и пользователям |

### Важные особенности

- **Анонимизация включена**: персональные данные возвращаются в виде токенов `[CATEGORY-NNNNN]` (например, `[ORG-00001]`, `[PER-00042]`)
- Для деанонимизации используй инструмент `submit_for_deanonymization` перед финальным ответом
- Объектные ссылки передаются в формате: `{"_objectRef": true, "УникальныйИдентификатор": "uuid", "ТипОбъекта": "СправочникСсылка.X"}`
- Навигационные ссылки имеют формат: `e1cib/data/Type.Name?ref=HexGUID`

## Полный пайплайн разработки

### Шаг 1. Синк базы в XML
Выгрузка текущей конфигурации из базы в XML-файлы проекта (только изменённые файлы):

```bash
ibcmd.exe config export --sync --database-path="путь к локальной базе" "путь к катадлгу выгрузки"
```

### Шаг 2. Разработка
Внесение изменений в XML-файлы и bsl-файлы проекта (модули, формы, метаданные).

### Шаг 3. Загрузка из XML в базу
Применение изменений из XML-файлов в базу:

```bash
ibcmd.exe config import --database-path="путь к локальной базе" "путь к катадлгу выгрузки"
```

### Шаг 4. Выгрузка в cf
Сохранение конфигурации из базы в файл `.cf` (для передачи или развёртывания):

```bash
ibcmd.exe config save --database-path="путь к локальной базе" "Путь к файлу .cf"
```

> **Важно:** В пути к выходному файлу `.cf` используйте прямые слеши (`/`), а не обратные (`\`). Утилита `ibcmd.exe` может некорректно обрабатывать обратные слеши в этом параметре, интерпретируя `\C`, `\R` и подобные последовательности как escape-символы.

**Расположение ibcmd.exe:**
```
C:\Program Files\1cv8\8.3.27.1786\bin\ibcmd.exe
```

## Контекст выполнения и директивы

### Модули объекта (ObjectModule)
Модуль выполняется в серверном контексте. Обязательно оборачивать весь код в условие:

```bsl
#Если Сервер Или ТолстыйКлиентОбычноеПриложение Или ВнешнееСоединение Тогда

// Код модуля

#КонецЕсли
```

### Модуль менеджера (ManagerModule)
Модуль выполняется в серверном контексте. Обязательно оборачивать весь код:

```bsl
#Если Сервер Или ТолстыйКлиентОбычноеПриложение Или ВнешнееСоединение Тогда

// Код модуля

#КонецЕсли
```

### Модули форм (Form Module)
Используют директивы выполнения для каждого метода:

| Директива | Контекст | Назначение |
|-----------|----------|------------|
| `&НаКлиенте` | Клиент | Обработчики UI, пользовательские действия |
| `&НаСервере` | Сервер | Работа с данными БД, бизнес-логика |
| `&НаКлиентеНаСервереБезКонтекста` | Оба | Утилитные методы без данных формы |
| `&НаКлиентеНаСервере` | Оба | Методы с доступом к данным формы |

**Правила:**
- Обработчики событий формы: `&НаСервере` (ПриСозданииНаСервере) или `&НаКлиенте` (ПриОткрытии)
- Обработчики элементов: `&НаКлиенте` (ПриИзменении, НачалоВыбора и т.д.)
- Серверные вызовы из клиента: методы с `&НаСервере` без контекста или `&НаКлиентеНаСервереБезКонтекста`

### Общие модули (CommonModules)
Суффиксы имен определяют контекст:

| Суффикс | Клиент | Сервер | Пример |
|---------|--------|--------|--------|
| Без суффикса | Нет | Да | ОбщегоНазначения |
| `Клиент` | Да | Нет | ОбщегоНазначенияКлиент |
| `КлиентСервер` | Да | Да | ОбщегоНазначенияКлиентСервер |
| `ВызовСервера` | Нет | Да | ОбщегоНазначенияВызовСервера |
| `ПовтИсп` | Нет | Да | ОбщегоНазначенияПовтИсп |
| `Переопределяемый` | - | - | ОбщегоНазначенияПереопределяемый |
| `Служебный` | - | - | ОбщегоНазначенияСлужебный |
| `Глобальный` | - | - | ОбщегоНазначенияГлобальный |
| `Формы` | Нет | Да | ОбщегоНазначенияФормы |
| `Базовый` | - | - | ОбщегоНазначенияБазовый |
| `Внутренний` | - | - | ОбщегоНазначенияВнутренний |
| `События` | - | - | ОбщегоНазначенияСобытия |

## Структура областей (Regions)

### Модуль объекта (ObjectModule)

```bsl
#Если Сервер Или ТолстыйКлиентОбычноеПриложение Или ВнешнееСоединение Тогда

#Область ОбработчикиСобытий

Процедура ПриЗаписи(Отказ)
	// ...
КонецПроцедуры

Процедура ПередЗаписью(Отказ)
	// ...
КонецПроцедуры

Процедура ОбработкаЗаполнения(ДанныеЗаполнения, СтандартнаяОбработка)
	// ...
КонецПроцедуры

Процедура ОбработкаПроверкиЗаполнения(Отказ, ПроверяемыеРеквизиты)
	// ...
КонецПроцедуры

#КонецОбласти

#Область СлужебныеПроцедурыИФункции

// Внутренние методы объекта

#КонецОбласти

#КонецЕсли
```

### Модуль менеджера (ManagerModule)

```bsl
#Если Сервер Или ТолстыйКлиентОбычноеПриложение Или ВнешнееСоединение Тогда

#Область ОбработчикиСобытий

Процедура ОбработкаПолученияДанныхВыбора(ДанныеВыбора, Параметры, СтандартнаяОбработка)
	// ...
КонецПроцедуры

#КонецОбласти

#Область ПрограммныйИнтерфейс

Функция ПредопределенныйЭлемент(Имя) Экспорт
	// ...
КонецФункции

#КонецОбласти

#Область СлужебныеПроцедурыИФункции

// Внутренние методы

#КонецОбласти

#КонецЕсли
```

### Модуль формы (Form Module)

```bsl
#Область ОбработчикиСобытийФормы

&НаСервере
Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
	// ...
КонецПроцедуры

&НаКлиенте
Процедура ПриОткрытии(Отказ)
	// ...
КонецПроцедуры

&НаКлиенте
Процедура ОбработкаОповещения(ИмяСобытия, Параметр, Источник)
	// ...
КонецПроцедуры

#КонецОбласти

#Область ОбработчикиСобытийЭлементовШапкиФормы

&НаКлиенте
Процедура ОрганизацияПриИзменении(Элемент)
	// ...
КонецПроцедуры

&НаКлиенте
Процедура КонтрагентНачалоВыбора(Элемент, ДанныеВыбора, СтандартнаяОбработка)
	// ...
КонецПроцедуры

#КонецОбласти

#Область ОбработчикиСобытийЭлементовТаблицыФормы

&НаКлиенте
Процедура ТаблицаПриИзменении(Элемент)
	// ...
КонецПроцедуры

#КонецОбласти

#Область СлужебныеМетодыНаКлиенте

&НаКлиенте
Процедура УправлениеФормой()
	// ...
КонецПроцедуры

#КонецОбласти

#Область СлужебныеМетодыНаСервере

&НаСервере
Процедура ЗаполнитьДанныеНаСервере()
	// ...
КонецПроцедуры

#КонецОбласти
```

### Общий модуль (CommonModule)

```bsl
#Область ПрограммныйИнтерфейс

Функция ЗначенияРеквизитовОбъекта(Ссылка, Реквизиты) Экспорт
	// ...
КонецФункции

#КонецОбласти

#Область СлужебныеПроцедурыИФункции

// Внутренние методы модуля

#КонецОбласти
```

## Структура файлов проекта

Проект представляет собой XML-дамп конфигурации 1С (формат выгрузки из Конфигуратора, не EDT). Каждый объект метаданных имеет свою директорию:

```
Catalogs/Контрагенты/
  Контрагенты.xml              — описание метаданных справочника
  Ext/
    ObjectModule.bsl           — модуль объекта
    ManagerModule.bsl          — модуль менеджера
    Forms/
      ФормаСписка/
        Ext/
          Form.xml             — описание формы (элементы, команды, атрибуты)
          Form/
            Module.bsl         — код модуля формы
      ФормаЭлемента/
        Ext/
          Form.xml
          Form/
            Module.bsl
```

**Расположение BSL-файлов по типам объектов:**

| Тип объекта | Модуль | Путь |
|---|---|---|
| Общий модуль | Модуль | `CommonModules/<Имя>/Ext/Module.bsl` |
| Справочник | Модуль объекта | `Catalogs/<Имя>/Ext/ObjectModule.bsl` |
| Справочник | Модуль менеджера | `Catalogs/<Имя>/Ext/ManagerModule.bsl` |
| Документ | Модуль объекта | `Documents/<Имя>/Ext/ObjectModule.bsl` |
| Документ | Модуль менеджера | `Documents/<Имя>/Ext/ManagerModule.bsl` |
| Регистр сведений | Модуль менеджера | `InformationRegisters/<Имя>/Ext/ManagerModule.bsl` |
| Регистр сведений | Модуль набора записей | `InformationRegisters/<Имя>/Ext/RecordSetModule.bsl` |
| Отчёт | Модуль | `Reports/<Имя>/Ext/Module.bsl` |
| Обработка | Модуль объекта | `DataProcessors/<Имя>/Ext/ObjectModule.bsl` |
| HTTP-сервис | Модуль | `HTTPServices/<Имя>/Ext/Module.bsl` |
| Команда | Модуль команды | `CommonCommands/<Имя>/Ext/CommandModule.bsl` |

## Структура форм

Форма описывается двумя файлами:

**`Ext/Form.xml`** — декларативное описание UI:
- `<Attributes>` — атрибуты формы (типы данных, основной атрибут)
- `<Commands>` — команды формы с привязкой к процедурам через `<Action>`
- `<Events>` — обработчики событий формы (OnCreateAtServer, OnOpen и т.д.)
- `<ChildItems>` — вложенные элементы UI (UsualGroup, InputField, Table, Pages, Button и др.)

**`Ext/Form/Module.bsl`** — код модуля формы:

```bsl
#Область ОбработчикиСобытийФормы

&НаСервере
Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
	// Инициализация на сервере
КонецПроцедуры

&НаКлиенте
Процедура ПриОткрытии(Отказ)
	// Инициализация на клиенте
КонецПроцедуры

&НаКлиенте
Процедура ОбработкаОповещения(ИмяСобытия, Параметр, Источник)
	// Обработка оповещений
КонецПроцедуры

#КонецОбласти

#Область ОбработчикиСобытийЭлементовШапкиФормы

&НаКлиенте
Процедура РеквизитПриИзменении(Элемент)
	// Обработка изменения реквизита
КонецПроцедуры

&НаКлиенте
Процедура РеквизитНачалоВыбора(Элемент, ДанныеВыбора, СтандартнаяОбработка)
	// Обработка начала выбора
КонецПроцедуры

#КонецОбласти

#Область ОбработчикиСобытийЭлементовТаблицыФормы

&НаКлиенте
Процедура ТабличнаяЧастьПриИзменении(Элемент)
	// Обработка изменения строки ТЧ
КонецПроцедуры

&НаКлиенте
Процедура ТабличнаяЧастьНачалоВыбора(Элемент, ДанныеВыбора, СтандартнаяОбработка)
	// Обработка выбора в ТЧ
КонецПроцедуры

#КонецОбласти

#Область ОбработчикиКоманд

&НаКлиенте
Процедура ВыполнитьКоманду(Команда)
	// Обработка команды формы
КонецПроцедуры

#КонецОбласти

#Область СлужебныеМетодыНаКлиенте

&НаКлиенте
Процедура ОбновитьИнтерфейс()
	// Управление элементами формы
КонецПроцедуры

#КонецОбласти

#Область СлужебныеМетодыНаСервере

&НаСервере
Процедура ЗаполнитьДанныеНаСервере()
	// Работа с данными БД
КонецПроцедуры

#КонецОбласти
```

**Добавление команды в форму:**

1. В `Form.xml` добавить элемент `<Command>` в секцию `<Commands>`:
```xml
<Command name="ВыполнитьДействие" id="...">
    <Action>ВыполнитьДействие</Action>
</Command>
```

2. В `Module.bsl` добавить обработчик:
```bsl
&НаКлиенте
Процедура ВыполнитьДействие(Команда)
	ВыполнитьДействиеНаСервере(Объект.Ссылка);
КонецПроцедуры

&НаСервере
Процедура ВыполнитьДействиеНаСервере(Ссылка)
	// Логика
КонецПроцедуры
```

**Добавление реквизита формы:**

1. В `Form.xml` добавить `<Attribute>` в секцию `<Attributes>`:
```xml
<Attribute name="НовыйРеквизит">
    <Type>
        <v8:Type>xs:string</v8:Type>
        <v8:StringQualifiers>
            <v8:Length>100</v8:Length>
        </v8:StringQualifiers>
    </Type>
</Attribute>
```

2. Добавить элемент UI в `<ChildItems>`:
```xml
<InputField name="НовыйРеквизит">
    <DataPath>НовыйРеквизит</DataPath>
</InputField>
```

## Библиотека стандартных подсистем (БСП)

Проект использует БСП — набор типовых общих модулей. Основные модули БСП:

### Ключевые модули БСП

| Модуль | Контекст | Назначение |
|---|---|---|
| `ОбщегоНазначения` | Сервер | Общие утилиты (287 экспортных функций) |
| `ОбщегоНазначенияКлиент` | Клиент | Клиентские утилиты (60 экспортных функций) |
| `ОбщегоНазначенияКлиентСервер` | Оба | Утилиты клиент-сервер |
| `Пользователи` | Сервер | Управление пользователями и ролями |
| `ДлительныеОперации` | Сервер | Фоновые и длительные операции |
| `Взаимодействия` | Сервер | Взаимодействия (встречи, звонки, SMS) |
| `АдресныйКлассификатор` | Сервер | Адресный классификатор (ФИАС) |
| `ДополнительныеОтчетыИОбработки` | Сервер | Внешние отчеты и обработки |

### Основные функции `ОбщегоНазначения`

**Чтение реквизитов без загрузки объекта:**
```bsl
// Один реквизит
ЦенаВключаетНДС = ОбщегоНазначения.ЗначениеРеквизитаОбъекта(Справочники.ТипыЦен.НайтиПоНаименованию("Основной"), "ЦенаВключаетНДС");

// Несколько реквизитов
Параметры = ОбщегоНазначения.ЗначенияРеквизитовОбъекта(Ссылка, "Наименование, Код, Организация");
Наименование = Параметры.Наименование;
```

**Сообщения пользователю:**
```bsl
// На сервере (с привязкой к полю)
ОбщегоНазначения.СообщитьПользователю(
	НСтр("ru = 'Не заполнено обязательное поле'"),
	Объект.Ссылка,
	"Реквизит",
	,
	Отказ);

// На клиенте
ОбщегоНазначенияКлиент.СообщитьПользователю("Операция завершена");
```

**Проверка подсистем и ленивая загрузка модулей:**
```bsl
Если ОбщегоНазначения.ПодсистемаСуществует("СтандартныеПодсистемы.Свойства") Тогда
	МодульУправлениеСвойствами = ОбщегоНазначения.ОбщийМодуль("УправлениеСвойствами");
	МодульУправлениеСвойствами.ПриСозданииНаСервере(ЭтотОбъект, ДополнительныеПараметры);
КонецЕсли;
```

**Предопределённые элементы:**
```bsl
ТипЗаявки = ОбщегоНазначения.ПредопределенныйЭлемент("Перечисление.см_ТипыЗаявокКлиентов.ВвозВывозИмущества");
```

**Проверка типа клиента:**
```bsl
Если ОбщегоНазначения.ЭтоМобильныйКлиент() Тогда
	// Специфичная логика для мобильного клиента
КонецЕсли;
```

### Основные функции `Пользователи`

```bsl
// Текущий пользователь
ТекущийПользователь = Пользователи.ТекущийПользователь();
Авторизованный = Пользователи.АвторизованныйПользователь();

// Проверка ролей
Если Пользователи.РолиДоступны("ПолныеПрава, см_ДиспетчерORM") Тогда
	// Действия для администратора
КонецЕсли;

// Проверка типа сеанса
Если Пользователи.ЭтоСеансВнешнегоПользователя() Тогда
	// Логика для внешнего пользователя
КонецЕсли;
```

### Основные функции `ДлительныеОперации`

```bsl
// Запуск фоновой операции
ПараметрыВыполнения = ДлительныеОперации.ПараметрыВыполненияВФоне(УникальныйИдентификатор);
ДлительнаяОперация = ДлительныеОперации.ВыполнитьВФоне("ИмяПроцедуры", ПараметрыПроцедуры, ПараметрыВыполнения);

// Проверка завершения
Если ДлительныеОперации.ЗаданиеВыполнено(ОписаниеОповещенияОЗавершении) Тогда
	// Операция завершена
КонецЕсли;

// Отмена
ДлительныеОперации.ОтменитьВыполнениеЗадания(ОписаниеОповещенияОЗавершении);
```

### Правило: всегда проверяй БСП перед написанием своего кода

Перед реализацией типовой логики проверь, нет ли готовой функции в БСП:
- Работа с пользователями → `Пользователи`
- Фоновые операции → `ДлительныеОперации`
- Чтение реквизитов → `ОбщегоНазначения.ЗначенияРеквизитовОбъекта()`
- Сообщения → `ОбщегоНазначения.СообщитьПользователю()`
- Копирование структур → `ОбщегоНазначения.СкопироватьРекурсивно()`
- Проведение документов → `ОбщегоНазначения.ПровестиДокументы()`
- Внешние обработки → `ДополнительныеОтчетыИОбработки`

## Основы языка 1С

### Индексация массивов

**Индексы массивов в 1С начинаются с 0.** Это касается всех коллекций, поддерживающих доступ по индексу:
- `Массив` — `Массив[0]` — первый элемент
- `РезультатПоискаПоРегулярномуВыражению.ПолучитьГруппы()` — `Группы[0]` — первая группа захвата (полное совпадение НЕ включается в массив)
- Результаты `Запрос.ВыполнитьПакет()` — `Результаты[0]` — первый запрос
- `Соответствие` — доступ по ключу (не по индексу)

```bsl
Список = Новый Массив;
Список.Добавить("Первый");
Список.Добавить("Второй");
Сообщить(Список[0]); // "Первый"
Сообщить(Список[1]); // "Второй"
```

## Регулярные выражения

### Ограничение: именованные группы НЕ поддерживаются

В 1С **недоступны именованные группы** регулярных выражений. Синтаксис `(?<Name>...)` не работает. Используйте только нумерованные группы через обычные скобки `()`:

```bsl
// НЕПРАВИЛЬНО — именованные группы не работают
Результат = СтрНайтиВсеПоРегулярномуВыражению(Текст, "(?<Day>\d{2})\.(?<Month>\d{2})");

// ПРАВИЛЬНО — только нумерованные группы
Результат = СтрНайтиВсеПоРегулярномуВыражению(Текст, "(\d{2})\.(\d{2})");
День = Результат.Группы[0].Значение;
Месяц = Результат.Группы[1].Значение;
```

Группы доступны только по числовому индексу: `[0]` — первая `()`, `[1]` — вторая `()` и т.д. Полное совпадение регулярного выражения НЕ включается в массив групп.

## Именование переменных

### Локальные переменные
Использовать CamelCase на русском языке:

```bsl
ТекущаяДата = ТекущаяДатаСеанса();
СписокДокументов = Новый Массив;
РеквизитыОбъекта = Новый Структура;
```

### Параметры процедур и функций
Описательные имена на русском:

```bsl
Процедура ОбработатьДокумент(ДокументСсылка, ПараметрыЗаписи, Отказ)
Функция ПолучитьСписокКлиентов(ДатаНачала, ДатаОкончания, Организация)
```

### Переменные циклов
Использовать осмысленные имена:

```bsl
Для Каждого СтрокаТаблицы Из ТаблицаДанных Цикл
	// ...
КонецЦикла;

Для Индекс = 0 По СписокЗначений.ВГраница() Цикл
	// ...
КонецЦикла;
```

### Временные переменные в условиях
Можно сокращать:

```bsl
ЭтоНовыйДокумент = Объект.ЭтоНовый();
ЭтоГрупповаяОперация = МассивСсылок.Количество() > 1;
```

## Документирование кода

### Процедуры и функции
Обязательные комментарии для экспортных методов:

```bsl
// Возвращает значения реквизитов объекта по ссылке.
//
// Параметры:
//  Ссылка - ЛюбаяСсылка - ссылка на объект.
//  Реквизиты - Строка - имена реквизитов через запятую.
//  ВыбратьРазрешенные - Булево - учитывать права доступа.
//
// Возвращаемое значение:
//  Структура - значения реквизитов.
//
Функция ЗначенияРеквизитовОбъекта(Ссылка, Реквизиты, ВыбратьРазрешенные = Ложь) Экспорт
```

### Примеры использования
Добавлять примеры для сложных методов:

```bsl
// Пример:
//  Результат = Модуль.ПолучитьДанные(Ссылка, "Код, Наименование");
//  Код = Результат.Код;
```

## Пометки изменений



## Типовые паттерны

### Проверка на пустую ссылку

```bsl
Если Объект.Организация.Пустая() Тогда
	// Обработка
КонецЕсли;

Если НЕ ЗначениеЗаполнено(Объект.Контрагент) Тогда
	// Обработка
КонецЕсли;
```

### Проверка загрузки из обмена

```bsl
Если ОбменДанными.Загрузка Тогда
	Возврат;
КонецЕсли;
```

### Проверка нового объекта

```bsl
Если ЭтоНовый() Тогда
	// Инициализация нового объекта
КонецЕсли;
```

### Передача данных между клиентом и сервером

```bsl
&НаКлиенте
Процедура ВыполнитьДействие()
	Результат = ВыполнитьДействиеНаСервере(Объект.Ссылка);
КонецПроцедуры

&НаСервере
Функция ВыполнитьДействиеНаСервере(Ссылка)
	// Работа с БД
КонецФункции
```

### Сообщения пользователю

```bsl
// Стандартный способ
ОбщегоНазначения.СообщитьПользователю(
	НСтр("ru = 'Сообщение об ошибке.'"), 
	Ссылка, 
	"Поле", 
	, 
	Отказ);

// На клиенте
ОбщегоНазначенияКлиент.СообщитьПользователю(ТекстСообщения);
```

## Язык запросов 1С

### Базовая структура запроса

```bsl
Запрос = Новый Запрос;
Запрос.Текст = 
	"ВЫБРАТЬ
	|	Таблица.Поле1 КАК Поле1,
	|	Таблица.Поле2 КАК Поле2
	|ИЗ
	|	Справочник.Номенклатура КАК Таблица
	|ГДЕ
	|	Таблица.ПометкаУдаления = ЛОЖЬ
	|УПОРЯДОЧИТЬ ПО
	|	Таблица.Наименование";

Результат = Запрос.Выполнить();
Выборка = Результат.Выбрать();
Пока Выборка.Следующий() Цикл
	// Обработка Выборка.Поле1, Выборка.Поле2
КонецЦикла;
```

### Модификаторы ВЫБРАТЬ

```bsl
// ВЫБРАТЬ РАЗЛИЧНЫЕ - уникальные записи
"ВЫБРАТЬ РАЗЛИЧНЫЕ
|	Документы.Организация КАК Организация
|ИЗ
|	Документ.РеализацияТоваров КАК Документы"

// ВЫБРАТЬ РАЗРЕШЕННЫЕ - с учетом прав доступа
"ВЫБРАТЬ РАЗРЕШЕННЫЕ
|	Номенклатура.Ссылка КАК Ссылка
|ИЗ
|	Справочник.Номенклатура КАК Номенклатура"

// ВЫБРАТЬ ПЕРВЫЕ N - ограничение количества
"ВЫБРАТЬ ПЕРВЫЕ 10
|	Товары.Наименование КАК Наименование
|ИЗ
|	Справочник.Номенклатура КАК Товары"
```

### Параметры запроса

```bsl
Запрос = Новый Запрос;
Запрос.Текст = 
	"ВЫБРАТЬ
	|	Документ.Ссылка КАК Ссылка
	|ИЗ
	|	Документ.РеализацияТоваров КАК Документ
	|ГДЕ
	|	Документ.Дата МЕЖДУ &НачалоПериода И &КонецПериода
	|	И Документ.Организация = &Организация";

Запрос.УстановитьПараметр("НачалоПериода", НачалоМесяца(ТекущаяДата()));
Запрос.УстановитьПараметр("КонецПериода", КонецМесяца(ТекущаяДата()));
Запрос.УстановитьПараметр("Организация", Справочники.Организации.НайтиПоНаименованию("ООО Ромашка"));
```

### Соединения таблиц

```bsl
// ЛЕВОЕ СОЕДИНЕНИЕ - все записи левой таблицы + совпадения справа
"ВЫБРАТЬ
|	Номенклатура.Ссылка КАК Номенклатура,
|	ЕСТЬNULL(Штрихкоды.Штрихкод, """") КАК Штрихкод
|ИЗ
|	Справочник.Номенклатура КАК Номенклатура
|		ЛЕВОЕ СОЕДИНЕНИЕ РегистрСведений.ШтрихкодыНоменклатуры КАК Штрихкоды
|		ПО Номенклатура.Ссылка = Штрихкоды.Номенклатура"

// ВНУТРЕННЕЕ СОЕДИНЕНИЕ - только совпадающие записи
"ВЫБРАТЬ
|	Документы.Ссылка КАК Документ
|ИЗ
|	Документ.РеализацияТоваров КАК Документы
|		ВНУТРЕННЕЕ СОЕДИНЕНИЕ Документ.РеализацияТоваров.Товары КАК Товары
|		ПО Документы.Ссылка = Товары.Ссылка"

// Полное условие соединения
"ЛЕВОЕ СОЕДИНЕНИЕ РегистрСведений.ЦеныНоменклатуры КАК Цены
|ПО Номенклатура.Ссылка = Цены.Номенклатура
|	И Цены.ТипЦен = &ТипЦен"
```

### Агрегатные функции

```bsl
"ВЫБРАТЬ
|	Продажи.Номенклатура КАК Номенклатура,
|	СУММА(Продажи.Количество) КАК Количество,
|	СУММА(Продажи.Сумма) КАК Сумма,
|	СРЕДНЕЕ(Продажи.Цена) КАК СредняяЦена,
|	МАКСИМУМ(Продажи.Дата) КАК ПоследняяПродажа,
|	МИНИМУМ(Продажи.Цена) КАК МинимальнаяЦена,
|	КОЛИЧЕСТВО(РАЗЛИЧНЫЕ Продажи.Документ) КАК КоличествоДокументов
|ИЗ
|	РегистрНакопления.Продажи КАК Продажи
|СГРУППИРОВАТЬ ПО
|	Продажи.Номенклатура
|ИМЕЮЩИЕ
|	СУММА(Продажи.Сумма) > &МинимальнаяСумма"
```

### Условие ВЫБОР

```bsl
"ВЫБРАТЬ
|	Номенклатура.Ссылка КАК Номенклатура,
|	ВЫБОР
|		КОГДА Номенклатура.ВидНоменклатуры = ЗНАЧЕНИЕ(Перечисление.ВидыНоменклатуры.Товар)
|			ТОГДА ""Товар""
|		КОГДА Номенклатура.ВидНоменклатуры = ЗНАЧЕНИЕ(Перечисление.ВидыНоменклатуры.Услуга)
|			ТОГДА ""Услуга""
|		ИНАЧЕ ""Прочее""
|	КОНЕЦ КАК Вид
|ИЗ
|	Справочник.Номенклатура КАК Номенклатура"
```

### Временные таблицы

```bsl
Запрос = Новый Запрос;
Запрос.МенеджерВременныхТаблиц = Новый МенеджерВременныхТаблиц;

// Создание временной таблицы
Запрос.Текст = 
	"ВЫБРАТЬ
	|	Номенклатура.Ссылка КАК Номенклатура,
	|	Номенклатура.Наименование КАК Наименование
	|ПОМЕСТИТЬ ВТ_Номенклатура
	|ИЗ
	|	Справочник.Номенклатура КАК Номенклатура
	|ГДЕ
	|	Номенклатура.Ссылка В(&СписокНоменклатуры)
	|
	|ИНДЕКСИРОВАТЬ ПО
	|	Номенклатура";

Запрос.УстановитьПараметр("СписокНоменклатуры", МассивНоменклатуры);
Запрос.Выполнить();

// Использование временной таблицы в следующем запросе
Запрос.Текст = 
	"ВЫБРАТЬ
	|	ВТ_Номенклатура.Номенклатура КАК Номенклатура,
	|	ЕСТЬNULL(Остатки.КоличествоОстаток, 0) КАК Остаток
	|ИЗ
	|	ВТ_Номенклатура КАК ВТ_Номенклатура
	|		ЛЕВОЕ СОЕДИНЕНИЕ РегистрНакопления.ТоварыНаСкладах.Остатки КАК Остатки
	|		ПО ВТ_Номенклатура.Номенклатура = Остатки.Номенклатура";

Результат = Запрос.Выполнить();

// Уничтожение временной таблицы
Запрос.Текст = "УНИЧТОЖИТЬ ВТ_Номенклатура";
Запрос.Выполнить();

// Или автоматическое уничтожение при закрытии менеджера
Запрос.МенеджерВременныхТаблиц.Закрыть();
```

### Пакетные запросы

```bsl
Запрос = Новый Запрос;
Запрос.Текст = 
	"ВЫБРАТЬ ПЕРВЫЕ 1
	|	Документы.Ссылка КАК Ссылка
	|ИЗ
	|	Документ.РеализацияТоваров КАК Документы
	|ГДЕ
	|	Документы.Проведен = ИСТИНА
	|;
	|
	|////////////////////////////////////////////////////////////////////////////////
	|ВЫБРАТЬ ПЕРВЫЕ 1
	|	Документы.Ссылка КАК Ссылка
	|ИЗ
	|	Документ.ПоступлениеТоваров КАК Документы
	|ГДЕ
	|	Документы.Проведен = ИСТИНА";

// Возвращает массив результатов
Результаты = Запрос.ВыполнитьПакет();

// Обработка результатов
Выборка1 = Результаты[0].Выбрать();
Выборка2 = Результаты[1].Выбрать();
```

### Объединение запросов (ОБЪЕДИНИТЬ)

```bsl
// ОБЪЕДИНИТЬ - уникальные записи (без дубликатов)
"ВЫБРАТЬ
|	Сотрудники.ФизЛицо КАК ФизЛицо
|ИЗ
|	Справочник.Сотрудники КАК Сотрудники
|
|ОБЪЕДИНИТЬ
|
|ВЫБРАТЬ
|	ФизЛица.Ссылка КАК ФизЛицо
|ИЗ
|	Справочник.ФизическиеЛица КАК ФизЛица"

// ОБЪЕДИНИТЬ ВСЕ - все записи (с дубликатами)
"ВЫБРАТЬ
|	Продажи.Номенклатура КАК Номенклатура,
|	Продажи.Количество КАК Количество,
|	""Продажа"" КАК ТипОперации
|ИЗ
|	РегистрНакопления.Продажи КАК Продажи
|
|ОБЪЕДИНИТЬ ВСЕ
|
|ВЫБРАТЬ
|	Поступления.Номенклатура КАК Номенклатура,
|	Поступления.Количество КАК Количество,
|	""Поступление"" КАК ТипОперации
|ИЗ
|	РегистрНакопления.ПоступленияТоваров КАК Поступления"
```

### Виртуальные таблицы регистров

```bsl
// Регистр сведений - СрезПоследних (на дату)
"ВЫБРАТЬ
|	Цены.Номенклатура КАК Номенклатура,
|	Цены.Цена КАК Цена
|ИЗ
|	РегистрСведений.ЦеныНоменклатуры.СрезПоследних(&НаДату, ) КАК Цены"

// С отбором
"ВЫБРАТЬ
|	Цены.Номенклатура КАК Номенклатура,
|	Цены.Цена КАК Цена
|ИЗ
|	РегистрСведений.ЦеныНоменклатуры.СрезПоследних(&НаДату, ТипЦен = &ТипЦен) КАК Цены"

// Регистр накопления - Остатки (на дату)
"ВЫБРАТЬ
|	Остатки.Номенклатура КАК Номенклатура,
|	Остатки.КоличествоОстаток КАК Количество
|ИЗ
|	РегистрНакопления.ТоварыНаСкладах.Остатки(&НаДату, ) КАК Остатки"

// Регистр накопления - Обороты (за период)
"ВЫБРАТЬ
|	Обороты.Номенклатура КАК Номенклатура,
|	Обороты.КоличествоОборот КАК Количество,
|	Обороты.СуммаОборот КАК Сумма
|ИЗ
|	РегистрНакопления.Продажи.Обороты(&Начало, &Конец, , ) КАК Обороты"

// Регистр накопления - Движения (за период)
"ВЫБРАТЬ
|	Движения.Период КАК Период,
|	Движения.Номенклатура КАК Номенклатура,
|	Движения.Количество КАК Количество
|ИЗ
|	РегистрНакопления.ТоварыНаСкладах КАК Движения
|ГДЕ
|	Движения.Период МЕЖДУ &Начало И &Конец
|	И Движения.Регистратор = &Документ"
```

### Функции языка запросов

```bsl
// ЕСТЬNULL - замена NULL значения
"ЕСТЬNULL(Таблица.Поле, 0) КАК Поле"

// ПОДСТРОКА - извлечение части строки
"ПОДСТРОКА(Номенклатура.Наименование, 1, 10) КАК КороткоеНаименование"

// ДЛИНАСТРОКИ - длина строки
"ДЛИНАСТРОКИ(Контрагент.Наименование) КАК ДлинаНаименования"

// ГОД, МЕСЯЦ, ДЕНЬ, ЧАС, МИНУТА, СЕКУНДА - части даты
"ГОД(Документ.Дата) КАК Год,
|	МЕСЯЦ(Документ.Дата) КАК Месяц"

// РАЗНОСТЬДАТ - разница между датами
"РАЗНОСТЬДАТ(Документ.Дата, &ТекущаяДата, ДЕНЬ) КАК ДнейПрошло"

// ДАТАВРЕМЯ - создание даты
"ДАТАВРЕМЯ(2024, 1, 1) КАК НачалоГода"

// ВЫРАЗИТЬ - преобразование типа
"ВЫРАЗИТЬ(Таблица.Ссылка КАК Справочник.Номенклатура) КАК Номенклатура"

// ЗНАЧЕНИЕ - предопределенное значение
"ЗНАЧЕНИЕ(Справочник.ВидыНоменклатуры.Товар) КАК Товар
|ЗНАЧЕНИЕ(Перечисление.СтатусыЗаказов.Новый) КАК Статус
|ЗНАЧЕНИЕ(Документ.РеализацияТоваров.ПустаяСсылка) КАК ПустойДокумент"
```

### Передача таблицы в запрос

```bsl
// Создание таблицы значений для передачи в запрос
ТаблицаДанных = Новый ТаблицаЗначений;
ТаблицаДанных.Колонки.Добавить("Номенклатура", Новый ОписаниеТипов("СправочникСсылка.Номенклатура"));
ТаблицаДанных.Колонки.Добавить("Количество", Новый ОписаниеТипов("Число"));

Строка = ТаблицаДанных.Добавить();
Строка.Номенклатура = СсылкаНаНоменклатуру;
Строка.Количество = 10;

// Использование в запросе
Запрос = Новый Запрос;
Запрос.Текст = 
	"ВЫБРАТЬ
	|	ВТ_Данные.Номенклатура КАК Номенклатура,
	|	ВТ_Данные.Количество КАК Количество
	|ПОМЕСТИТЬ ВТ_Данные
	|ИЗ
	|	&ТаблицаДанных КАК ВТ_Данные";

Запрос.УстановитьПараметр("ТаблицаДанных", ТаблицаДанных);
```

### Типовые паттерны запросов

#### Получение значений реквизитов объекта

```bsl
Запрос = Новый Запрос;
Запрос.Текст = 
	"ВЫБРАТЬ
	|	Контрагент.Наименование КАК Наименование,
	|	Контрагент.ИНН КАК ИНН,
	|	Контрагент.КПП КАК КПП
	|ИЗ
	|	Справочник.Контрагенты КАК Контрагент
	|ГДЕ
	|	Контрагент.Ссылка = &Ссылка";

Запрос.УстановитьПараметр("Ссылка", СсылкаНаКонтрагента);
Результат = Запрос.Выполнить();

Если Не Результат.Пустой() Тогда
	Выборка = Результат.Выбрать();
	Выборка.Следующий();
	Наименование = Выборка.Наименование;
	ИНН = Выборка.ИНН;
КонецЕсли;
```

#### Проверка наличия записей

```bsl
Запрос = Новый Запрос;
Запрос.Текст = 
	"ВЫБРАТЬ ПЕРВЫЕ 1
	|	1 КАК Поле
	|ИЗ
	|	РегистрНакопления.ОстаткиТоваров КАК Остатки
	|ГДЕ
	|	Остатки.Номенклатура = &Номенклатура";

Запрос.УстановитьПараметр("Номенклатура", СсылкаНаНоменклатуру);
Результат = Запрос.Выполнить();
ЕстьЗаписи = Не Результат.Пустой();
```

#### Подсчет количества

```bsl
Запрос = Новый Запрос;
Запрос.Текст = 
	"ВЫБРАТЬ
	|	КОЛИЧЕСТВО(*) КАК Количество
	|ИЗ
	|	Документ.РеализацияТоваров КАК Документы
	|ГДЕ
	|	Документы.Дата МЕЖДУ &Начало И &Конец";

Запрос.УстановитьПараметр("Начало", НачалоПериода);
Запрос.УстановитьПараметр("Конец", КонецПериода);
Результат = Запрос.Выполнить().Выбрать();
Результат.Следующий();
Количество = Результат.Количество;
```

### Форматирование текста запроса

При написании запросов в коде использовать форматирование с вертикальной чертой:

```bsl
Запрос.Текст = 
	"ВЫБРАТЬ
	|	Поле1,
	|	Поле2
	|ИЗ
	|	Таблица
	|ГДЕ
	|	Условие";
```

Для динамического формирования запроса использовать конкатенацию:

```bsl
ТекстЗапроса = 
	"ВЫБРАТЬ
	|	Номенклатура.Ссылка
	|ИЗ
	|	Справочник.Номенклатура КАК Номенклатура
	|ГДЕ
	|	Номенклатура.ВидНоменклатуры = &ВидНоменклатуры";

Если ЗначениеЗаполнено(Организация) Тогда
	ТекстЗапроса = ТекстЗапроса + "
		|	И Номенклатура.Организация = &Организация";
КонецЕсли;
```

## Паттерны HTTP-интеграций

### Утилитарные обёртки `_Типы`, `_Строка`, `_Дата`

Вместо прямых вызовов стандартных функций использовать обёртки:

```bsl
// Проверка типа (_Типы):
Если _Типы.ЭтоСтрока(Значение) Тогда ...
Если _Типы.ЭтоЧисло(Значение) Тогда ...
Если _Типы.ЭтоМассив(Значение) Тогда ...
Если _Типы.ЭтоСтруктура(Значение) Тогда ...
Если _Типы.ЭтоСоответствие(Значение) Тогда ...

// Работа со строками (_Строка):
Если _Строка.Содержит(Строка, Подстрока) Тогда ...

// Работа с датами (_Дата):
Если _Дата.ЭтоПустаяДата(Дата) Тогда ...
СекундВЧасе   = _Дата.СекундВЧасе();   // 3600
МинутВСутках  = _Дата.МинутВСутках();  // 1440
```
## Паттерны обработки ошибок

### «Мягкий» — возврат флага/строки вместо исключения

```bsl
Функция ЗаписатьОбъект(Объект, Параметр = Неопределено, ТекстОшибки = "") Экспорт

	Записан = Ложь;
	Попытка
		Если Параметр = Неопределено Тогда
			Объект.Записать();
		Иначе
			Объект.Записать(Параметр);
		КонецЕсли;
		Записан = Истина;
	Исключение
		ТекстОшибки = "Возникла ошибка записи объекта: " + Объект + Символы.ПС
		            + "Описание ошибки: " + ОписаниеОшибки();
	КонецПопытки;

	Возврат Записан;

КонецФункции
```

### «Жёсткий» — перехват + запись в ЖР + повторный выброс

```bsl
Попытка
	// ... основная логика
Исключение
	ЗаписьЖурналаРегистрации(
		"ИмяСобытия",
		УровеньЖурналаРегистрации.Ошибка,
		ОбъектМетаданных,
		ДополнительныеДанные,
		ПодробноеПредставлениеОшибки(ИнформацияОбОшибке()));
	ВызватьИсключение; // прокидываем дальше
КонецПопытки;
```

## Конструкторы структур данных (`Новый*`)

Вместо создания структур «на месте» — выделенные функции-конструкторы:

```bsl
Функция НовыйПодключение() Экспорт
	Подключение = Новый Структура;
	Подключение.Вставить("АдресСервиса", "");
	Подключение.Вставить("ПространствоИмен", "");
	Подключение.Вставить("Логин", "");
	Подключение.Вставить("Пароль", "");
	Подключение.Вставить("Токен", "");
	Подключение.Вставить("ЗаголовкиАутентификации", Новый Соответствие);
	Подключение.Вставить("ИсточникЗапроса", "");
	Возврат Подключение;
КонецФункции

Функция НовыйОтвет()
	Ответ = Новый Структура;
	Ответ.Вставить("Успех", Ложь);
	Ответ.Вставить("КодСтатуса", Неопределено);
	Ответ.Вставить("Заголовки", Неопределено);
	Ответ.Вставить("Тело", Неопределено);
	Ответ.Вставить("Сообщение", "");
	Возврат Ответ;
КонецФункции
```
## Ключевые принципы

1. **Разделение контекста**: серверный код не должен вызывать клиентский и наоборот
2. **Минимизация серверных вызовов**: группировать операции, использовать кеширование
3. **Проверки в начале методов**: выход при ошибочных условиях
4. **Единообразие**: следовать стилю существующего кода проекта
5. **Локализация**: использовать НСтр() для пользовательских сообщений
6. **Конструкторы структур**: сложные структуры данных — через функции `Новый*()`
7. **Привилегированный режим**: всегда сопровождать комментарием с обоснованием
8. **Логирование**: в режиме отладки — запросы и ответы; пароли — никогда; ошибки — всегда
Comments 0
Latest | Hot
Please login before commenting.
No comments yet. Be the first one!
1cskills

Directory Structure

SKILL.md

Report

Notice
