# Модуль ОбщегоНазначения

### Оповещения пользователя

#### Процедура *СообщитьПользователю()*

Формирует и выводит сообщение, которое может быть связано с элементом управления формы.

```oscript
Процедура СообщитьПользователю( 
    Знач ТекстСообщенияПользователю,
    Знач КлючДанных = Неопределено,
    Знач Поле = "",
    Знач ПутьКДанным = "",
    Отказ = Ложь) Экспорт
```

### Общие процедуры и функции для работы с данными в базе

#### Функция *ЗначенияРеквизитовОбъекта()*

Возвращает структуру, содержащую значения реквизитов, прочитанные из информационной базы по ссылке на объект.  Рекомендуется использовать вместо обращения к реквизитам объекта через точку от ссылки на объект для быстрого чтения отдельных реквизитов объекта из базы данных.  

```oscript
Функция ЗначенияРеквизитовОбъекта(
    Ссылка, 
    Знач Реквизиты, 
    ВыбратьРазрешенные = Ложь, 
    КодЯзыка = Неопределено) Экспорт
```

#### Функция *ЗначениеРеквизитаОбъекта()*

Возвращает значения реквизита, прочитанного из информационной базы по ссылке на объект. Рекомендуется использовать вместо обращения к реквизитам объекта через точку от ссылки на объект для быстрого чтения отдельных реквизитов объекта из базы данных.  

```oscript
Функция ЗначениеРеквизитаОбъекта(
    Ссылка, 
    ИмяРеквизита, 
    ВыбратьРазрешенные = Ложь, 
    КодЯзыка = Неопределено) Экспорт
```

#### Пример:

```oscript
&НаСервереБезКонтекста
Функция ЗначениеРеквизитаОбъекта(Ссылка, ИмяРеквизита)
    Возврат ОбщегоНазначения.ЗначениеРеквизитаОбъекта(Ссылка, ИмяРеквизита);	
КонецФункции 
```

#### Функция *ЗначениеРеквизитовОбъектов()*

Возвращает значения реквизитов, прочитанные из информационной базы для нескольких объектов. Рекомендуется использовать вместо обращения к реквизитам объекта через точку от ссылки на объект для быстрого чтения отдельных реквизитов объекта из базы данных. 

```oscript
Функция ЗначенияРеквизитовОбъектов(
    Ссылки, 
    Знач Реквизиты, 
    ВыбратьРазрешенные = Ложь, 
    КодЯзыка = Неопределено) Экспорт
```

#### Функция *ЗначениеРеквизитаОбъектов()*

Возвращает значения реквизита, прочитанного из информационной базы для нескольких объектов. Рекомендуется использовать вместо обращения к реквизитам объекта через точку от ссылки на объект для быстрого чтения отдельных реквизитов объекта из базы данных. 

```oscript
Функция ЗначениеРеквизитаОбъектов(
    МассивСсылок, 
    ИмяРеквизита, 
    ВыбратьРазрешенные = Ложь, 
    КодЯзыка = Неопределено) Экспорт
```

#### Процедура *УстановитьЗначениеРеквизита()*

Добавляет или изменяет значение реквизита в объекте.

```oscript
Процедура УстановитьЗначениеРеквизита(
    Объект, 
    ИмяРеквизита, 
    Значение, 
    КодЯзыка = Неопределено) Экспорт
```

#### Процедура *УстановитьЗначенияРеквизитов()*

Добавляет или изменяет значения реквизитов в объекте.

```oscript
Процедура УстановитьЗначенияРеквизитов(
    Объект, 
    Значения, 
    КодЯзыка = Неопределено) Экспорт
```

#### Функция *КодОсновногоЯзыка()*

Возвращает код основного языка информационной базы, например "ru".

```oscript
Функция КодОсновногоЯзыка() Экспорт
```

#### Функция *ПредопределенныйЭлемент()*

Возвращает ссылку предопределенного элемента по его полному имени.

```oscript
Функция ПредопределенныйЭлемент(ПолноеИмяПредопределенного) Экспорт
```

#### Функция *ПроверитьПроведенностьДокументов()*

Проверяет статус проведения переданных документов и возвращает те из них, которые не проведены.

```oscript
Функция ПроверитьПроведенностьДокументов(Знач Документы) Экспорт
```

#### Функция *ПровестиДокументы()*

Выполняет попытку проведения документов.

```oscript
Функция ПровестиДокументы(Документы) Экспорт
```

#### Функция *ЕстьСсылкиНаОбъект()*

Проверяет наличие ссылок на объект в базе данных.

```oscript
Функция ЕстьСсылкиНаОбъект(
    Знач СсылкаИлиМассивСсылок, 
    Знач ИскатьСредиСлужебныхОбъектов = Ложь) Экспорт
```

#### Функция *ЗаменитьСсылки()*

Производит замену ссылок во всех данных. После замены неиспользуемые ссылки опционально удаляются. Замена ссылок происходит с транзакциями по изменяемому объекту и его связям, не по анализируемой ссылке. При вызове в неразделенном сеансе не выявляет ссылок в разделенных областях.

```oscript
Функция ЗаменитьСсылки(
    Знач ПарыЗамен, 
    Знач ПараметрыЗамены = Неопределено) Экспорт
```

#### Функция *ПараметрыЗаменыСсылок()*

Конструктор структуры для параметра *ПараметрыЗамены* функции *ОбщегоНазначения*.*ЗаменитьСсылки*

```oscript
Функция ПараметрыЗаменыСсылок() Экспорт
```

#### Функция *МестаИспользования()*

Получает все места использования ссылок.

```oscript
Функция МестаИспользования(
    Знач НаборСсылок, 
    Знач АдресРезультата = "", 
    ДополнительныеПараметры = Неопределено) Экспорт
```

#### Функция *ПараметрыПоискаМестИспользования()*

```oscript
Функция ПараметрыПоискаМестИспользования() Экспорт
```

#### Функция *ИсключенияПоискаСсылок()*

Возвращает исключения при поиске мест использования объектов

```oscript
Функция ИсключенияПоискаСсылок() Экспорт
```

#### Функция *ПодчиненныеОбъекты()*

Возвращает связи подчиненных объектов и перечень реквизитов, по которым осуществляется связь.

```oscript
Функция ПодчиненныеОбъекты() Экспорт
```

### Общие процедуры и функции для работы с прикладными типами и коллекциями значений

#### Функция *СтрокаТаблицыЗначенийВСтруктуру()*

Преобразует строку таблицы значений в структуру. Свойства структуры и их значения совпадают с колонками переданной строки

```oscript
Функция СтрокаТаблицыЗначенийВСтруктуру(СтрокаТаблицыЗначений) Экспорт
```

#### Функция *ВыгрузитьКолонку()*

Создает массив и копирует в него значения, содержащиеся в колонке объекта, для которого доступен обход посредством оператора Для каждого … Из

```oscript
Функция ВыгрузитьКолонку(
    КоллекцияСтрок, 
    ИмяКолонки, 
    ТолькоУникальныеЗначения = Ложь) Экспорт
```

#### Функция *ПрочитатьXMLВТаблицу()*

Преобразует текст указанного формата XML в таблицу значений, // при этом колонки таблицы формируются на основе описания в XML.

```oscript
Функция ПрочитатьXMLВТаблицу(Знач XML) Экспорт
```

### Процедуры и функции для работы с типами, объектами метаданных и их строковыми представлениями.

#### Функция *ЭтоСсылка()*

Проверка того, что переданный тип является ссылочным типом данных. Для типа "Неопределено" возвращается Ложь.

```oscript
Функция ЭтоСсылка(ПроверяемыйТип) Экспорт
```

#### Функция *СсылкаСуществует()*

Проверяет физическое наличие записи в информационной базе данных о переданном значении ссылки.

```oscript
Функция СсылкаСуществует(ПроверяемаяСсылка) Экспорт
```

#### Функция *ЗначениеСсылочногоТипа()*

Проверяет, что переданное значение имеет ссылочный тип данных.

```oscript
Функция ЗначениеСсылочногоТипа(Значение) Экспорт
```

#### Функция *СтроковоеПредставлениеТипа()*

Возвращает строковое представление типа. Для ссылочных типов возвращает в формате "СправочникСсылка.ИмяОбъекта" или "ДокументСсылка.ИмяОбъекта". Для остальных типов приводит тип к строке, например "Число".

```oscript
Функция СтроковоеПредставлениеТипа(Тип) Экспорт
```

#### Функция *ОписаниеТипаСтрока()*

Создает объект ОписаниеТипов, содержащий тип Строка.

```oscript
Функция ОписаниеТипаСтрока(ДлинаСтроки) Экспорт
```

#### Функция *ОписаниеТипаЧисло()*

Создает объект ОписаниеТипов, содержащий тип Число.

```oscript
Функция ОписаниеТипаЧисло(
    Разрядность, 
    РазрядностьДробнойЧасти = 0, 
    Знач ЗнакЧисла = Неопределено) Экспорт
```

#### Функция *ОписаниеТипаДата()*

Создает объект ОписаниеТипов, содержащий тип Дата.

```oscript
Функция ОписаниеТипаДата(ЧастиДаты) Экспорт
```

#### Функция *ОписаниеТипаВсеСсылки()*

Возвращает описание типа, включающего в себя все возможные ссылочные типы конфигурации.

```oscript
Функция ОписаниеТипаВсеСсылки() Экспорт
```

#### Функция *ЕстьРеквизитОбъекта()*

Позволяет определить, есть ли среди реквизитов объекта реквизит с переданным именем.

```oscript
Функция ЕстьРеквизитОбъекта(ИмяРеквизита, МетаданныеОбъекта) Экспорт
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://andrey-ivantsov.gitbook.io/1s-predpriyatie/bsp/modul-obshegonaznacheniya.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.