Простой инструмент 1С: Универсальное получение UUID / GUID

Универсальный инструмент получения UUID / GUID в 1С

При разработке, администрировании и интеграции информационных баз 1С периодически возникает необходимость быстро получить UUID / GUID объекта в нужном формате.

Для решения этих задач разработана универсальная обработка, позволяющая получать, генерировать и преобразовывать уникальные идентификаторы без написания дополнительного программного кода.

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

Сценарии использования

1. Получение UUID / GUID объекта информационной базы

Задача: узнать уникальный идентификатор конкретного документа, элемента справочника или другого ссылочного объекта 1С.

Порядок действий:

1. Откройте обработку через «Файл → Открыть».

2. Выберите нужный объект информационной базы или укажите его ссылку.

3. Нажмите кнопку получения идентификатора.

4. Скопируйте UUID / GUID в подходящем формате.

Результат: идентификатор объекта в стандартном виде, без дефисов, в верхнем регистре и других представлениях.

2. Получение идентификатора для прямых запросов к СУБД

Задача: найти данные объекта непосредственно в таблицах MS SQL Server или PostgreSQL, например при анализе производительности, диагностике ошибок или исследовании структуры хранения 1С.

Порядок действий:

1. Выберите объект информационной базы.

2. Получите его уникальный идентификатор.

3. В разделе представлений СУБД выберите соответствующий формат.

4. Скопируйте бинарный идентификатор или подготовленное условие SQL.

Результат: идентификатор, пригодный для использования при поиске объекта по полю _IDRRef с учётом особенностей хранения идентификаторов в СУБД.

3. Формирование программного кода 1С

Задача: получить готовый фрагмент кода для создания уникального идентификатора или получения ссылки на объект по UUID.

Порядок действий:

1. Выберите объект или введите существующий UUID.

2. Сформируйте представления идентификатора.

3. Перейдите к разделу «Представления 1С».

4. Скопируйте необходимый фрагмент программного кода.

Результат: выражения Новый УникальныйИдентификатор(...) и, при наличии типа объекта, ПолучитьСсылку(...), готовые для использования в модулях и обработках 1С.

4. Получение навигационной ссылки на объект 1С

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

Порядок действий:

1. Выберите существующий объект информационной базы.

2. Получите его идентификатор.

3. Найдите поле «Навигационная ссылка e1cib/data/...».

4. Скопируйте ссылку и используйте её в поддерживаемом клиенте 1С.

Результат: навигационная ссылка вида e1cib/data/..., позволяющая открывать объект в соответствующей информационной базе.

5. Подготовка UUID / GUID для интеграций

Задача: передать идентификатор объекта во внешнюю систему, API, веб-сервис или JSON-документ.

Порядок действий:

1. Выберите объект, введите существующий UUID или сгенерируйте новый.

2. Получите доступные представления идентификатора.

3. Выберите необходимый формат: стандартный UUID, JSON, urn:uuid или другой.

4. Скопируйте значение для передачи во внешнюю систему.

Результат: идентификатор в формате, удобном для обмена данными между 1С и сторонними приложениями.

6. Генерация нового UUID / GUID

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

Порядок действий:

1. Откройте обработку.

2. Выберите режим генерации нового идентификатора.

3. Сформируйте UUID / GUID.

4. Скопируйте результат в нужном представлении.

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

7. Преобразование существующего UUID / GUID

Задача: преобразовать уже известный идентификатор в другой формат без необходимости самостоятельно выполнять перестановку байтов или изменение строкового представления.

Порядок действий:

1. Вставьте существующий UUID / GUID в поле ввода.

2. Выполните преобразование.

3. Выберите нужное представление среди полученных результатов.

4. Скопируйте преобразованное значение.

Результат: несколько представлений одного идентификатора, включая форматы для 1С, СУБД и внешних систем.

Для кого предназначена обработка

Инструмент будет полезен разработчикам 1С, администраторам информационных баз, специалистам по интеграции и технической поддержке.

Основные преимущества:

• Быстрое получение UUID / GUID без написания кода.

• Различные представления идентификатора в одном окне.

• Поддержка сценариев работы с 1С, MS SQL Server и PostgreSQL.

• Удобная подготовка идентификаторов для интеграций.

• Минимум действий для получения результата.

  Поддерживаемые объекты 1С

  Обработка предназначена для получения UUID / GUID ссылочных объектов информационной базы 1С:Предприятие 8.3 и 8.5.

  Поддерживается работа со следующими типами объектов:

• Справочники — элементы и группы справочников (Номенклатура, Контрагенты, Организации, Договоры и другие).

• Документы — реализации, поступления, платежные поручения, счета и другие документы конфигурации.

• Планы счетов — счета бухгалтерского учета.

• Планы видов характеристик — элементы дополнительных характеристик и видов аналитики.

• Планы видов расчета — элементы планов видов расчета.

• Планы обмена — узлы обмена данными.

• Особенности работы

• Для существующего ссылочного объекта можно получить его UUID / GUID и доступные варианты представления.

• Для получения ссылки по UUID необходимо знать тип объекта и соответствующий менеджер 1С.

• Для формирования навигационной ссылки e1cib/data/... требуется ссылка на конкретный объект информационной базы.

• Генерация и преобразование UUID / GUID могут выполняться без выбора объекта.

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

• Ограничения: записи регистров сведений, накопления, бухгалтерии и расчета, строки табличных частей, константы и другие значения, не являющиеся самостоятельными ссылочными объектами с UUID, напрямую не поддерживаются. Для работы с такими данными можно использовать идентификаторы связанных ссылочных объектов.

  Обработка ориентирована на использование в типовых и доработанных конфигурациях 1С, включая 1С:Бухгалтерию, 1С:Управление торговлей, 1С, 1С:Комплексную автоматизацию и другие решения на платформе 1С:Предприятие.

  Фактическая доступность каждого типа определяется конфигурацией и реализацией поля выбора в обработке.

• Бизнес-процессы — экземпляры бизнес-процессов.

• Задачи — задачи пользователей и исполнителей. Тестирование проводилось на на платформах 8.3.27.2342 и 8.5.1.1302.