Текущая версия на 14:10, 7 марта 2023

[править] Введение

В настоящее время все доработки и изменения сохраняются и переносятся с использованием "Пространств имен" (далее ПИ), подробнее о котором можно почитать тут

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

[править] Основные элементы

Форма просмотра ПИ расположена Меню "Сервис" / "Пространства имен"

либо

Исследователь / Администратор / Атрибуты

Основные элементы управления на форме просмотра ПИ

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

Кроме основных элементов для работы с ПИ есть дополнительные.

Иконка	Название	Описание
	Открыть объект	Позволяет открыть объект, на котором установлен курсор, на просмотр.
	Переместить / удалить запись из ПИ	Позволяет произвести дополнительные манипуляции с объектом ПИ: удалить, переместить и т.п.

[править] Порядок работы

Работу с ПИ можно условно разделить на две части: добавление изменений объектов в ПИ и загрузку изменений в базу данных.

Предположим, нам необходимо добавить некий макрос в ПИ и перенести его на другую базу.

[править] Создание ПИ

1.Нажимаем правой кнопкой мыши на объекте, который хотим добавить в ПИ

2.В выпадающем меню выбираем "Пространство имен"

3.В открывшемся окне Добавление/удаление/перемещение объекта пространства имен вводим желаемое имя пространства имен

4.В случае, если ПИ с таким именем уже есть в списке, выбираем его.

5.Если вводимого имени ПИ не найдено, программа предложит его создать

6.Указываем наименование пространства имен

7.Посколько мы создаем новое "простое" ПИ, оставляем флаг "Внутреннее пространство имен" и нажимаем ОК

ПИ создано. Осталось его сохранить на диск.

[править] Добавление объектов в ПИ

8.ПИ создано, теперь добавляем в него объект, нажав кнопку ОК

флаг "Включать вложенные объекты .." установлен.

9.Следует отметить, если повторно нажать на объект правой кнопкой мыши и выбрать "Пространство имен". программа отобразит в какое ПИ входит данный объект. Сейчас уже будет не доступен пункт "Добавить", вместо этого станут доступны другие опции "Удалить", "Переместить", "Изменить признаки", "Дополнить"...

[править] Сохранение ПИ на диск

Дальнейшую работу с ПИ удобно вести через специальную форму, которая вызывается через меню Сервис / Синхронизация ПИ

Выбираем путь к каталогу, где хранятся(будут хранится) ПИ

Нажимаем кнопку "Сравнить с файлами" или F5 і программа проведет анализ имеющихся ПИ

На форме "Синхронизации" расположены элементы управления

Важно: ПИ, которые установлены в текущей БД, будут отображаться в колонке NAMESPACENAME, ПИ на диске - в колонке FILENAMESPACENAME

Находим в колонке NAMESPACENAME необходимое ПИ и помечаем его на сохранение, нажав либо на управляющую кнопку на панели инструментов

либо выбрав из контекстного меню правой кнопки мыши пункт "Пометить для сохранения"

После чего в колонке Op появится один из значков и нажимаем кнопку "Синхронизировать" (F9)

В появившемся диалоговом окне еще раз проверяем то, что сохраняем и нажимаем ОК

Поскольку ПИ отсутствует в каталоге синхронизации, указываем путь в файловой системе

Сохранение ПИ успешно завершено!

Повторная синхронизация с указанным каталогом(попкой) даст следующий результат на форме "Синхронизации"

символ == в колонке Op свидетельствует о том, что ПИ в текущей БД и на диске идентичны

[править] Запись изменений в файл ПИ

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

Для просмотра различий в файла ПИ на диске и в БД нажимаем кнопку "Сравнить"

Откроется окно просмотра различий

Увидеть только изменения/отличия можно нажать на соответствующую кнопку

После того, как мы убедились в том, что эти изменения необходимо сохранить в файл, нажимаем на кнопку "Синхронизировать" (F9)

[править] Загрузка изменений в базу данных

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

Прежде всего следует отметить, что файлы доработок имеют расширение .yml К примеру, вышеописанный файл ПИ имеет название Макрос gd_document info.yml

Важно! Если Вы получили файл в каком-либо архиве: ZIP, RAR, 7z и т.д., то перед установкой его необходимо распаковать.

• Вызываем форму синхронизации ПИ меню Сервис / Синхронизация ПИ

• Выбираем путь к каталогу, где хранятся файлы ПИ

• Нажимаем кнопку "Сравнить с файлами" или F5 и программа проведет анализ имеющихся ПИ

Допустим, у нас есть несколько файлов ПИ, которые отображаются в колонке FILENAMESPACENAME.

Символ << свидетельствует о том. что файл ПИ в каталоге(на диске) имеет более позднюю версию и отличается от ПИ в базе данных.

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

• Проверяем изменения, которые есть в файле ПИ на диске, нажав соответствующую кнопку "Сравнить"

• так же можно посмотреть только отличия, нажав на соответствующую кнопку. Отличия будут показаны розовым цветом.

• Помечаем те ПИ, которые хотим загрузить в базу данных.

1 способ: нажимаем правой кнопкой мыши на необходимом ПИ и открывшемся меню выбираем один из двух пунктов

2 способ: нажимаем на кнопку "Пометить для загрузки" на панели задач и выбираем один из двух пунктов

Важно:

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

• После того, как пометили нужное ПИ для загрузки, в колонке Op появится соответствующий символ, к примеру "<", который говорит о том, что данное ПИ есть на диске, но отсутствует в базе и готово к загрузке

• Нажимаем синхронизировать или клавиша F9

• Еще раз убеждаемся, что устанавливаем нужные ПИ, при этом можно проставить дополнительные флаги-параметры для загрузки:

Всегда перезаписывать устанавливается тогда, когда должны установиться ровно те изменения, которые записаны в фале ПИ, не зависимо от того, какая версия и/или изменения хранятся в базе данных

• Дожидаемся, пока программа установит ПИ в базу.

[править] Часто задаваемые вопросы

[править] Не получается найти файл ПИ через форму Синхронизации ПИ

Возможны следующие:

• файл ПИ имеет отличный от .yml формат(например упакован архиватором)

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

• неверно указан путь к папке для синхронизации

Решение: убедитесь, что файл ПИ расположен в том же месте системы, где происходит "Сравнение с файлами"

• ПИ просто не отразилось в колонке FILENAMESPACENAME, расположившись внизу списка

Решение: можно щелкнуть левой кнопкой мыши по названию колонки FILENAMESPACENAME, тем самым отсортировав файлы ПИ (о чем свидетельствует красный треугольник вверху названия колонки) или воспользоваться средствами поиска (если файлов ПИ в списке много)

[править] ПИ устанавливается успешно, но изменений нет

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

Решение: в окне дополнительных параметров укажите "Всегда перезаписывать"

[править] Нужно сохранить/загрузить только одно ПИ, а в списке помечено несколько

Решение: для того, чтобы исключить сохранение/загрузку ПИ, необходимо снять пометку со всех ПИ, кроме необходимых.

Пример: есть 2 ПИ(Макрос gd_document info.yml и Заказ-наряд А3.yml) Требуется сохранить только ПИ с именем Заказ-наряд А3.yml.

• Устанавливаем курсор на то ПИ, которое необходимо исключить
• Нажимаем на нем правой кнопкой мыши и в выпадающем меню выбираем пункт "Снять отметку с выделенных записей"

• Повторяем данную манипуляцию для других ПИ, которые необходимо исключить.

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

В таких случаях проще выбрать пункт "Снять отметку со всех записей", а потом найти в списке нужное ПИ и пометить только его(на сохранение/загрузку)

[править] Дополнительно