SimpleVcs

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

SimpleVcs()

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

Пример:

const vcs = new SimpleVcs();

createTableSnapshot(tableName)

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

Параметры:

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

Пример:

const tableName = 'sys_script';
const vcs = new SimpleVcs();
const versionCount = vcs.createTableSnapshot(tableName);
ss.info(versionCount); // 1

exportLocalPackVcsRecords(sysVcsLocalPackId)

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

Параметры:

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

Пример:

const vcsLocalPackId = '156144163704236641';
const vcs = new SimpleVcs();
vcs.exportLocalPackVcsRecords(vcsLocalPackId);

importRetrievedPack(retrievedPackId)

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

Параметры:

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

Пример:

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.

Параметры:

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

Пример:

const vcsLocalPackId = '156144163704236641';
const vcs = new SimpleVcs();
if (vcs.isLocalPackHasReferences(vcsLocalPackId)) {
  ss.addInfoMessage('Local Pack has current VCS records');
}

isRetrievedPackHasReferences(retrievedPackId)

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

Параметры:

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

Пример:

const vcsRetrievedPackId = '156144163704236641';
const vcs = new SimpleVcs();
if (vcs.isRetrievedPackHasReferences(vcsRetrievedPackId)) {
  ss.addInfoMessage('Retrieved Pack has current VCS records');
}

isRetrievedPackHasAttache(vcsRetrievedPackId)

loadDataFromAttachment(sysVcsRetrievedPackId)

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

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

Пример:

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)

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

Параметры:

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

Пример:

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)

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

Параметры:

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

Пример:

const vcs = new SimpleVcs();
const result = vcs.moveVcsRecordsToDefault([current.sys_id]);
ss.info(result);

preview(sysVcsRetrievedPackId)

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

Параметры:

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

Пример:

const vcs = new SimpleVcs();
const message = new SimpleMessage();
if (!vcs.preview(current.sys_id)) {
    const localizedMessage = message.getMessage('Error previewing data');
    ss.addErrorMessage(localizedMessage);
    return;
}
ss.setRedirect();

rollback(packId)

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

Параметры:

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

Пример:

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

rollBackPreview(packId)

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

Параметры:

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

Пример:

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