Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Этот класс необходим содержит методы для использования системы контроля версий (VCS) SimpleOne.

SimpleVcs()


Используйте этот конструктор для создания нового пустого объекта класса SimpleVcs.

Пример:

Code Block
languagejs
themeEclipse
titleSimpleVcs()
linenumberstrue
const vcs = new SimpleVcs();

createTableSnapshot(tableName)


Используйте этот метод, чтобы создать первую актуальную версию записей VCS всех записей в указанной таблице. 

Параметры:

НазваниеТипОбязательныйЗначение по умолчанию
tableNameStringДаНет

Возвращаемое значение:

ТипОписание
IntegerМетод возвращает количество созданных версий, созданных после выполнения скрипта.

Пример:

Code Block
languagejs
themeEclipse
titlecreateTableSnapshot()
linenumberstrue
const tableName = 'sys_script';
const vcs = new SimpleVcs();
const versionCount = vcs.createTableSnapshot(tableName);
ss.info(versionCount); // 1

exportLocalPackVcsRecords(sysVcsLocalPackId)


Используйте этот метод для экспорта записей системы контроля версийVCS, привязанных к пакету конфигурации с уникальным ID, в . SOP-файле. Этот пакет должен находиться в состоянии «Завершено»статусе Завершено.

Параметры:

НазваниеТипОбязательныйЗначение по умолчанию
sysVcsLocalPackId
Integer
StringДаНет

Возвращаемое значение:

ТипОписание
Object
.
Метод возвращает SOP-файл для
загрузки
скачивания.

Пример:

Code Block
languagejs
themeEclipse
titleexportLocalPackVcsRecords()
linenumberstrue
const vcsLocalPackId = '156144163704236641';
const vcs = new SimpleVcs();
vcs.exportLocalPackVcsRecords(vcsRetrievedPackIdvcsLocalPackId);

importRetrievedPack(retrievedPackId)


Используйте этот метод для импорта последнего предпросмотренного извлеченного пакета из Журнала загруженных в Журнал просмотра VCS (sys_vcs_preview_log) записей, привязанных к импортированному пакету, в таблицу Запись VCS  (sys_vcs_record).

Параметры:

НазваниеТипОбязательныйЗначение по умолчанию
retrievedPackId
Integer
StringДаНет

Возвращаемое значение:

ТипОписание
StringСтрока, содержащая результаты импорта
BooleanМетод возвращает значение true, если записи импортировались. В случае неудачи метод возвращает false.

Пример:

Code Block
languagejs
themeEclipse
titleimportRetrievedPack()
linenumberstrue
const vcsRetrievedPackId = '156144163704236641';
const vcs = new SimpleVcs();
const result = vcs.importRetrievedPack(vcsRetrievedPackId);
ss.addInfoMessage(result);

isLocalPackHasReferences(localPackId)


Этот метод предназначен для проверки записи из таблицы Используйте метод, чтобы проверить записи из таблицы Локальные пакеты (sys_vcs_local_pack) на наличие ссылок на текущие* записи из таблицы Запись VCS (sys_vcs_record).

текущих записей атрибут is_current равен trueустановлен флажок Актуальная.

Параметры:

НазваниеТипОбязательныйЗначение по умолчанию
localPackId
Integer
StringДаНет

Возвращаемое значение:

ТипОписание
BooleanМетод возвращает true, если записи найдены. В случае неудачи метод возвращает false.

Пример:

Code Block
languagejs
themeEclipse
titleisLocalPackHasReferences()
linenumberstrue
const vcsLocalPackId = '156144163704236641';
const vcs = new SimpleVcs();
if (vcs.isLocalPackHasReferences(vcsLocalPackId)) {
  ss.addInfoMessage('Local Pack has current VCS recordsЛокальный пакет содержит ссылку на актуальную запись VCS');
}

isRetrievedPackHasReferences(retrievedPackId)


Этот метод предназначен для проверки Используйте метод, чтобы проверить записи из таблицы Импортированные пакеты (sys_vcs_retrieved_pack) на наличие ссылок на записи из таблицы Запись VCS (sys_vcs_record).

Параметры:

НазваниеТипОбязательныйЗначение по умолчанию
retrievedPackId
Integer
StringДаНет

Возвращаемое значение:

ТипОписание
BooleanМетод возвращает значение true при наличии ссылок на записи, в случае их отсутствия метод возвращает false.

Пример:

Code Block
languagejs
themeEclipse
titleisRetrievedPackHasReferences()
linenumberstrue
const vcsRetrievedPackId = '156144163704236641';
const vcs = new SimpleVcs();
if (vcs.isRetrievedPackHasReferences(vcsRetrievedPackId)) {
  ss.addInfoMessage('Retrieved Pack has current VCS recordsИмпортированный пакет содержит ссылку на актуальную запись VCS');
}

isRetrievedPackHasAttache(vcsRetrievedPackId)



Warning

Этот метод является устаревшим для версии системы 1.2 и старше и больше не поддерживается. Вместо него используйте метод hasAttachment().

loadDataFromAttachment(sysVcsRetrievedPackId)


Используйте этот метод для загрузки данных из пакета конфигурации, добавленного к таблице записи таблицы Импортированные пакеты (sys_vcs_retrieved_pack), как  как вложение для предварительного просмотра.

Параметры:

НазваниеТипОбязательныйЗначение по умолчанию
sysVcsRetrievedPackIdIntegerStringДаНет

Возвращаемое значение:

ТипОписание
BooleanМетод возвращает true, если загрузка данных прошла успешно. В случае неудачи метод возвращает false.

Пример:

Code Block
languagejs
themeEclipse
titleloadDataFromAttachment()
linenumberstrue
const vcs = new SimpleVcs();
const message = new SimpleMessage();
if (!vcs.loadDataFromAttachment(current.sys_id)) {
  ss.addErrorMessage('ErrorОшибка loading dataзагрузки');
  return;
}
ss.setRedirect();

mergeLocalPacks(rowIds, name, description)


Используйте этот метод для объединения нескольких локальных пакетов в один. Исходные локальные пакеты удаляются безвозвратно.

Параметры:

НазваниеТипОбязательныйЗначение по умолчанию
rowIdsArray of StringsДаНет
nameStringНет
'
merged pack
'
descriptionStringНетНет

Возвращаемое значение:

ТипОписание
StringМетод возвращает ID объединенного локального пакета. В случае неудачи метод возвращает null.

Пример:

Code Block
languagejs
themeEclipse
titlemergeLocalPacks()
linenumberstrue
const vcsLocalPackId = [
  '157666651911972694',
  '157665759017038346',
  '157665742419415102'
];
const mergedName = 'MergedОбъединённый Packпакет 1';
const mergedDesc = 'MergedОписание Packобъединённого descriptionпакета 1';
const vcs = new SimpleVcs();
const mergedId = vcs.mergeLocalPacks(vcsLocalPackId, mergedName, mergedDesc);
if (mergedId != null) {
  ss.info(' ID объединенногообъединённого локального пакета ' + mergedId);
} else {
  ss.info('Возникли проблемы с объединением пакетов');
}

moveVcsRecordsToDefault(versionIds)


Используйте этот метод, чтобы перемещать большое количество записей системы контроля версий VCS в локальный пакет по умолчанию.

Параметры:

Название

Тип

Обязательный

Значение по умолчанию

versionIdsArray of StringsДаНет

Возвращаемое значение:

Тип

Описание

BooleanМетод возвращает true, при успешном перемещении записей. В случае ошибки метод возвращает false.

Пример:

Code Block
languagejs
themeEclipse
titlemoveVcsRecordsToDefault()
linenumberstrue
const vcs = new SimpleVcs();
const result = vcs.moveVcsRecordsToDefault([current.sys_id]);
ss.info(result);

preview(sysVcsRetrievedPackId)


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

Параметры:

НазваниеТипОбязательныйЗначение по умолчанию
retrievedPackId
Integer
StringДаНет

Возвращаемое значение:

ТипОписание
BooleanМетод возвращает true, если предварительный просмотр был успешным. В случае неудачи метод возвращает false.

Пример:

Code Block
languagejs
themeEclipse
titlepreview()
linenumberstrue
const vcs = new SimpleVcs();
const message = new SimpleMessage();
if (!vcs.preview(current.sys_id)) {
    const localizedMessage = message.getMessagess.addErrorMessage('ErrorОшибка previewingпросмотра dataданных');
    ss.addErrorMessage(localizedMessage);
    return;
}
ss.setRedirect();
rollback

rollBack(packId)


Используйте этот метод для отката локального пакета. Откат возможен, только когда локальный пакет находится в статусе "Откат подготовлен".

Параметры:

НазваниеТипОбязательныйЗначение по умолчанию
packId
Integer
StringДаНет

Возвращаемое значение:

ТипОписание
StringВ случае успешного отката метод возвращает true. В случае неудачи метод возвращает исключение.
VoidМетод не возвращает значение.

Пример:

Code Block
languagejs
themeEclipse
titlerollbackrollBack()
linenumberstrue
const vcsLocalPackId = '156144163704236641';
const vcs = new SimpleVcs();
if (vcs.rollBack(vcsLocalPackId)) {
  ss.addInfoMessage('Откат локального пакета произведен успешно');
}

rollBackPreview(packId)


Используйте данный метод для предварительного просмотра результатов отката.

Параметры:

НазваниеТипОбязательныйЗначение по умолчанию
packId
Integer
StringДаНет

Возвращаемое значение:

ТипОписание
Boolean
VoidМетод
возвращает true, если предварительный просмотр прошел успешно. В случае ошибки метод возвращает false
не возвращает значение.

Пример:

Code Block
languagejs
themeEclipse
titlerollBackPreview()
linenumberstrue
const vcsLocalPackId = '156144163704236641';
const vcs = new SimpleVcs();
if (vcs.rollBackPreview(vcsLocalPackId)) {
  ss.addInfoMessage('Предварительный просмотр отката локального пакета успешно пройден');
}


Table of Contents
absoluteUrltrue
classfixedPosition