УникальныйИдентификатор

Типы · UUID · уникальный идентификатор

Предназначен для создания и хранения глобального уникального идентификатора GUID.

Примеры платформы

КлючУникальности = Новый УникальныйИдентификатор;
Полное описание, параметры и ограничения

УникальныйИдентификатор (UUID)

УникальныйИдентификатор (UUID)

Доступен, начиная с версии 8.0.

Конструкторы:
Из строки
По умолчанию
С указанием версии

Описание:

Предназначен для создания и хранения глобального уникального идентификатора GUID.

Доступность:

Тонкий клиент, веб-клиент, мобильный клиент, сервер, толстый клиент, внешнее соединение, мобильное приложение (клиент), мобильное приложение (сервер), мобильный автономный сервер.
Возможен обмен с сервером. Сериализуется. Данный объект может быть сериализован в/из XML. Может использоваться в реквизитах управляемой формы. Данный объект может быть сериализован в/из XDTO. Тип XDTO, соответствующий данному объекту, определяется в пространстве имен {http://v8.1c.ru/8.1/data/core}. Имя типа XDTO: UUID.

Пример:

КлючУникальности = Новый УникальныйИдентификатор;

См. также:
ПользовательИнформационнойБазы, свойство УникальныйИдентификатор
МенеджерПользователейИнформационнойБазы, метод НайтиПоУникальномуИдентификатору
ПланОбменаСсылка.<Имя плана обмена>, метод УникальныйИдентификатор
СправочникСсылка.<Имя справочника>, метод УникальныйИдентификатор
ДокументСсылка.<Имя документа>, метод УникальныйИдентификатор
ПланВидовХарактеристикСсылка.<Имя плана видов характеристик>, метод УникальныйИдентификатор
ПланСчетовСсылка.<Имя плана счетов>, метод УникальныйИдентификатор
ПланВидовРасчетаСсылка.<Имя плана видов расчета>, метод УникальныйИдентификатор
БизнесПроцессСсылка.<Имя бизнес-процесса>, метод УникальныйИдентификатор
ЗадачаСсылка.<Имя задачи>, метод УникальныйИдентификатор

Использование в версии:

Доступен, начиная с версии 8.0.

Описание изменено в версии 8.3.21.

Методическая информация

Практические примеры

ПоказатьВводДаты: выбрать собственный день доставки и посчитать итог

Выбираем только дату с 6 по 12 октября 2026. Для собственного расчёта после 7 октября доставка 100, иначе 0; реальные заказы не затрагиваются.

Где и как запускать

Модуль новой управляемой формы учебной внешней обработки. Код содержит готовые процедуры с директивами; вставляйте на уровне модуля, не внутрь другого обработчика. Каждую задачу запускайте в отдельной копии формы.

Подготовка

  1. В отдельной учебной базе платформы 8.5.1.1343 создайте внешнюю обработку УчебнаяФорма85 с пустой управляемой основной формой. Используйте тонкий клиент Windows.

  2. В свойствах формы → События назначьте ПриСозданииНаСервере. Вставьте полный модуль урока, включая клиентские и серверные помощники, на уровне модуля.

  3. Не создавайте вручную ЗначениеПримера, ПолеПримера и кнопку: код создаёт их полностью. Каждый урок запускайте в отдельной копии своей формы.

  4. Сохраните свою EPF и откройте её в учебной базе. Собственное количество начинается с 3, цена книги задана в коде как 250; исходный расчёт равен 750.

  5. Связанный реквизит помечен как СохраняемыеДанные для изучения поведения формы. Это признак реквизита формы, а не автоматическая запись книги, файла или документа в базу.

  6. Команда расчёта имеет ИзменяетСохраняемыеДанные = Ложь. Уроки изменяют только свой интерфейс и значения собственной формы, не конфигурацию и не рабочие данные.

  7. Запуск и вид в 1С не проверены. Компоновку, сочетания клавиш и расположение команд осмотрите вручную в указанном клиенте; не переносите настройки на рабочие формы без отдельной проверки.

  8. В этой партии каждое окно ввода запускает собственная кнопка УчебноеДействие. Изучайте один полный модуль за раз; никакие значения ввода не исполняются как код.

Перем АктивныйЗапрос;

&НаСервере
Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
    Новые = Новый Массив;
    ТипРеквизита = Новый ОписаниеТипов("Число", Новый КвалификаторыЧисла(2, 0, ДопустимыйЗнак.Неотрицательный));
    Новые.Добавить(Новый РеквизитФормы("ЗначениеПримера", ТипРеквизита, "", "Количество книг", Истина));
    ЭтаФорма.ИзменитьРеквизиты(Новые);
    ЭтаФорма.ЗначениеПримера = 3;
    Поле = Элементы.Добавить("ПолеПримера", Тип("ПолеФормы"));
    Поле.Вид = ВидПоляФормы.ПолеВвода;
    Поле.ПутьКДанным = "ЗначениеПримера";
    Поле.Заголовок = "Количество собственных книг";


    КомандаДействия = ЭтаФорма.Команды.Добавить("УчебноеДействие");
    КомандаДействия.Действие = "УчебноеДействие";
    КомандаДействия.Заголовок = "Выполнить собственный учебный шаг";
    КомандаДействия.Подсказка = "Действие только над данными учебной формы";
    КомандаДействия.ИзменяетСохраняемыеДанные = Ложь;
    Кнопка = Элементы.Добавить("КнопкаУчебноеДействие", Тип("КнопкаФормы"));
    Кнопка.ИмяКоманды = КомандаДействия.Имя;
    Кнопка.Заголовок = КомандаДействия.Заголовок;
КонецПроцедуры

&НаКлиенте
Процедура УчебноеДействие(Команда)
    ДоВвода = ЗначениеПримера;
    Маркер = Новый УникальныйИдентификатор;
    КонтекстВвода = Новый Структура("Маркер,ДоВвода", Маркер, ДоВвода);
    АктивныйЗапрос = Маркер;
    Оповещение = Новый ОписаниеОповещения("ПослеСобственногоВвода", ЭтаФорма, КонтекстВвода);
    Попытка
        ПоказатьВводДаты(Оповещение, Дата(2026, 10, 6), "День собственной доставки: с 6 по 12 октября 2026", ЧастиДаты.Дата);
    Исключение
        АктивныйЗапрос = Неопределено;
        ВызватьИсключение;
    КонецПопытки;
    Сообщить("Запрос ввода сделан; результат обрабатывается только в процедуре завершения");

КонецПроцедуры

&НаКлиенте
Процедура ПроверитьСобственноеКоличество()
    Если ТипЗнч(ЗначениеПримера) <> Тип("Число") Тогда
        ВызватьИсключение "Собственное количество должно быть числом";
    КонецЕсли;
    Если ЗначениеПримера < 1 ИЛИ ЗначениеПримера > 10 ИЛИ ЗначениеПримера <> Цел(ЗначениеПримера) Тогда
        ВызватьИсключение "Нужно собственное целое количество от 1 до 10";
    КонецЕсли;
КонецПроцедуры

&НаКлиенте
Процедура ПослеСобственногоВвода(Введено, ДополнительныеПараметры) Экспорт
    Если Не ЭтаФорма.Открыта() Тогда
        Возврат;
    КонецЕсли;
    Если ДополнительныеПараметры.Маркер <> АктивныйЗапрос Тогда
        Сообщить("Устаревший ответ собственного диалога не применяется");
        Возврат;
    КонецЕсли;
    АктивныйЗапрос = Неопределено;
    ДоВвода = ДополнительныеПараметры.ДоВвода;
    Если Введено = Неопределено Тогда
        Сообщить("Отмена: собственные данные не менялись");
        Возврат;
    КонецЕсли;
    Если ЗначениеПримера <> ДоВвода Тогда
        Сообщить("Количество изменилось за время диалога. Повторите ввод для актуальной заявки");
        Возврат;
    КонецЕсли;
    Если ТипЗнч(Введено) <> Тип("Дата") Тогда
        ВызватьИсключение "Для собственной доставки нужна дата";
    КонецЕсли;
    День = НачалоДня(Введено);
    Если День < Дата(2026, 10, 6) Или День > Дата(2026, 10, 12) Тогда
        ВызватьИсключение "Для урока выберите день с 6 по 12 октября 2026 включительно";
    КонецЕсли;
    ПроверитьСобственноеКоличество();
    Доставка = 0;
    Если День > Дата(2026, 10, 7) Тогда
        Доставка = 100;
    КонецЕсли;
    СуммаКниг = ЗначениеПримера * 250;
    Итого = СуммаКниг + Доставка;
    Сообщить(Итого - Доставка = СуммаКниг);
    Сообщить(ЗначениеПримера = ДоВвода);
    Сообщить(СтрШаблон("Собственный день %1; книги %2; доставка %3; итого %4", Формат(День, "ДФ=yyyy-MM-dd"), СуммаКниг, Доставка, Итого));

КонецПроцедуры

Разбор по шагам

  1. Передать фиксированную собственную дату 6 октября 2026 и ЧастиДаты.Дата. Это не текущий момент компьютера и не дата рабочего документа.

  2. Ввод возвращается в экспортную клиентскую процедуру вместе с маркером и снимком своего количества.

  3. Отмену обрабатывать до НачалоДня. Подтверждённое значение проверить как Дата и явно нормализовать до дня.

  4. Допустить лишь 6–12 октября включительно. Своё правило доставки проверяется после нормализации, поэтому скрытая часть времени не меняет его.

  5. Сложить сумму собственных книг и стоимость доставки; сохранить прежнее количество и вывести полный разбор чисел.

Как проверить результат

  1. При количестве 3 для 6/7 октября итог 750; для 8–12 октября 850. Две Истина в обоих случаях.

  2. Отмена не запускает расчёт. 5/13 октября отвергаются до получения успешного итога; маркер очищен до обработки и новый запрос допустим.

Ожидаемый результат

Датовый callback применён к завершённой задаче с границами диапазона и отдельной нормализацией времени.

На что обратить внимание

  1. ПоказатьВводДаты получает результат через параметр обработчика. Строка returnDescription в справке не используется для выдумывания обычного Булево-ответа у процедуры.

  2. ЧастиДаты.Дата — ограничение ввода; НачалоДня явно задаёт используемый в своём правиле день.

  3. Цена доставки 100 — собственное учебное условие, не проверенный тариф перевозчика. Никаких заказов и оплат код не создаёт.

Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.

ПоказатьВводЧисла: получить количество в своём обработчике завершения

ПоказатьВводЧисла не возвращает новое количество обычным ответом. Собственный UUID отличает актуальный запрос от запоздавшего ответа.

Где и как запускать

Модуль новой управляемой формы учебной внешней обработки. Код содержит готовые процедуры с директивами; вставляйте на уровне модуля, не внутрь другого обработчика. Каждую задачу запускайте в отдельной копии формы.

Подготовка

  1. В отдельной учебной базе платформы 8.5.1.1343 создайте внешнюю обработку УчебнаяФорма85 с пустой управляемой основной формой. Используйте тонкий клиент Windows.

  2. В свойствах формы → События назначьте ПриСозданииНаСервере. Вставьте полный модуль урока, включая клиентские и серверные помощники, на уровне модуля.

  3. Не создавайте вручную ЗначениеПримера, ПолеПримера и кнопку: код создаёт их полностью. Каждый урок запускайте в отдельной копии своей формы.

  4. Сохраните свою EPF и откройте её в учебной базе. Собственное количество начинается с 3, цена книги задана в коде как 250; исходный расчёт равен 750.

  5. Связанный реквизит помечен как СохраняемыеДанные для изучения поведения формы. Это признак реквизита формы, а не автоматическая запись книги, файла или документа в базу.

  6. Команда расчёта имеет ИзменяетСохраняемыеДанные = Ложь. Уроки изменяют только свой интерфейс и значения собственной формы, не конфигурацию и не рабочие данные.

  7. Запуск и вид в 1С не проверены. Компоновку, сочетания клавиш и расположение команд осмотрите вручную в указанном клиенте; не переносите настройки на рабочие формы без отдельной проверки.

  8. В этой партии каждое окно ввода запускает собственная кнопка УчебноеДействие. Изучайте один полный модуль за раз; никакие значения ввода не исполняются как код.

Перем АктивныйЗапрос;

&НаСервере
Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
    Новые = Новый Массив;
    ТипРеквизита = Новый ОписаниеТипов("Число", Новый КвалификаторыЧисла(2, 0, ДопустимыйЗнак.Неотрицательный));
    Новые.Добавить(Новый РеквизитФормы("ЗначениеПримера", ТипРеквизита, "", "Количество книг", Истина));
    ЭтаФорма.ИзменитьРеквизиты(Новые);
    ЭтаФорма.ЗначениеПримера = 3;
    Поле = Элементы.Добавить("ПолеПримера", Тип("ПолеФормы"));
    Поле.Вид = ВидПоляФормы.ПолеВвода;
    Поле.ПутьКДанным = "ЗначениеПримера";
    Поле.Заголовок = "Количество собственных книг";


    КомандаДействия = ЭтаФорма.Команды.Добавить("УчебноеДействие");
    КомандаДействия.Действие = "УчебноеДействие";
    КомандаДействия.Заголовок = "Выполнить собственный учебный шаг";
    КомандаДействия.Подсказка = "Действие только над данными учебной формы";
    КомандаДействия.ИзменяетСохраняемыеДанные = Ложь;
    Кнопка = Элементы.Добавить("КнопкаУчебноеДействие", Тип("КнопкаФормы"));
    Кнопка.ИмяКоманды = КомандаДействия.Имя;
    Кнопка.Заголовок = КомандаДействия.Заголовок;
КонецПроцедуры

&НаКлиенте
Процедура УчебноеДействие(Команда)
    ДоВвода = ЗначениеПримера;
    Маркер = Новый УникальныйИдентификатор;
    КонтекстВвода = Новый Структура("Маркер,ДоВвода", Маркер, ДоВвода);
    АктивныйЗапрос = Маркер;
    Оповещение = Новый ОписаниеОповещения("ПослеСобственногоВвода", ЭтаФорма, КонтекстВвода);
    Попытка
        ПоказатьВводЧисла(Оповещение, ЗначениеПримера, "Сколько собственных книг: целое число от 1 до 10", 2, 0);
    Исключение
        АктивныйЗапрос = Неопределено;
        ВызватьИсключение;
    КонецПопытки;
    Сообщить("Запрос ввода сделан; результат обрабатывается только в процедуре завершения");

КонецПроцедуры

&НаКлиенте
Процедура ПослеСобственногоВвода(Введено, ДополнительныеПараметры) Экспорт
    Если Не ЭтаФорма.Открыта() Тогда
        Возврат;
    КонецЕсли;
    Если ДополнительныеПараметры.Маркер <> АктивныйЗапрос Тогда
        Сообщить("Устаревший ответ собственного диалога не применяется");
        Возврат;
    КонецЕсли;
    АктивныйЗапрос = Неопределено;
    ДоВвода = ДополнительныеПараметры.ДоВвода;
    Если Введено = Неопределено Тогда
        Сообщить("Отмена: собственные данные не менялись");
        Возврат;
    КонецЕсли;
    Если ЗначениеПримера <> ДоВвода Тогда
        Сообщить("Количество изменилось за время диалога. Повторите ввод для актуальной заявки");
        Возврат;
    КонецЕсли;
    Если ТипЗнч(Введено) <> Тип("Число") Тогда
        ВызватьИсключение "Введённое количество должно быть числом";
    КонецЕсли;
    Если Введено < 1 ИЛИ Введено > 10 ИЛИ Введено <> Цел(Введено) Тогда
        ВызватьИсключение "Для собственной заявки нужно целое количество от 1 до 10";
    КонецЕсли;
    Цена = 250;
    Сумма = Введено * Цена;
    ЗначениеПримера = Введено;
    Сообщить(Сумма >= 250 И Сумма <= 2500);
    Сообщить(Сумма / Цена = ЗначениеПримера);
    Сообщить(СтрШаблон("Собственные книги: %1 × %2 = %3", ЗначениеПримера, Цена, Сумма));

КонецПроцедуры

Разбор по шагам

  1. Сохранить число 3 в дополнительной структуре вместе с новым собственным маркером. Назначить эту структуру третьим аргументом ОписаниеОповещения.

  2. Вызвать ПоказатьВводЧисла с пятью аргументами. Следующий Сообщить означает только, что запрос выполнен, не что пользователь уже подтвердил число.

  3. ПослеСобственногоВвода объявлен на клиенте с Экспорт и двумя параметрами: число/Неопределено и дополнительная структура.

  4. В обработчике проверить открытость своей формы, актуальность маркера, отмену и неизменность количества. Только актуальный допустимый ответ может изменить реквизит.

  5. Выбранное число проверяется по правилу 1–10, затем участвует в реальном расчёте. Здесь нет ожидания точного времени и нет блокировки кнопки до вечного callback.

Как проверить результат

  1. Введите 5: обработчик выводит 1250 и две Истина. Отмена не изменяет прежнее количество.

  2. Проверьте точкой останова два аргумента обработчика и Маркер структуры. При повторном запросе старый маркер не может примениться к новому состоянию.

Ожидаемый результат

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

На что обратить внимание

  1. Не присваивайте результат ПоказатьВводЧисла переменной: введённое число приходит в обработчик, не в обычный Возврат.

  2. Обработчик должен быть экспортным и находиться в переданной ЭтаФорма. Не передавайте неизвестный объект-владелец.

  3. Если окно по внешним причинам не открылось, пример не оставляет отключённую кнопку. Не рассчитывайте на callback после закрытия формы как на запись данных.

Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.

Не хотите разбираться сами?

Адаптируем это решение под вашу базу. Оценка бесплатно.

Оставить задачу

1С, 1С:Предприятие — товарные знаки ООО «1С». Сайт не является официальным представительством фирмы «1С» и не аффилирован с ней.