Этот серверный класс необходим содержит методы для использования системы контроля версий (VCS) SimpleOne.
SimpleVcs()
Используйте этот метод конструктор для создания нового пустого объекта класса SimpleVcs.
Пример:
Code Block |
---|
language | js |
---|
theme | Eclipse |
---|
title | SimpleVcs() |
---|
linenumbers | true |
---|
|
const vcs = new SimpleVcs(); |
createTableSnapshot(tableName)
Используйте этот метод, чтобы создать первую актуальную версию записей VCS всех записей в указанной таблице.
Параметры:
Название | Тип | Обязательный | Значение по умолчанию |
---|
tableName | String | Да | Нет |
Возвращаемое значение:
Тип | Описание |
---|
Integer | Метод возвращает количество созданных версий, созданных после выполнения скрипта. |
Пример:
Code Block |
---|
language | js |
---|
theme | Eclipse |
---|
title | createTableSnapshot() |
---|
linenumbers | true |
---|
|
const tableName = 'sys_script';
const vcs = new SimpleVcs();
const versionCount = vcs.createTableSnapshot(tableName);
ss.info(versionCount); // 1 |
exportLocalPackVcsRecords(sysVcsLocalPackId)
Используйте этот метод для экспорта записей системы контроля версийVCS, привязанных к пакету конфигурации с уникальным ID, в . SOP-файле. Этот пакет должен находиться в состоянии «Завершено»статусе Завершено.
Параметры:
Название | Тип | Обязательный | Значение по умолчанию |
---|
sysVcsLocalPackId |
IntegerВозвращаемое значение:
.Метод возвращает SOP-файл для |
загрузки Пример:
Code Block |
---|
language | js |
---|
theme | Eclipse |
---|
title | exportLocalPackVcsRecords() |
---|
linenumbers | true |
---|
|
const vcsLocalPackId = '156144163704236641';
const vcs = new SimpleVcs();
vcs.exportLocalPackVcsRecords(vcsRetrievedPackIdvcsLocalPackId); |
importRetrievedPack(retrievedPackId)
Используйте этот метод для импорта последнего предпросмотренного извлеченного пакета из Журнала загруженных в Журнал просмотра VCS (sys_vcs_preview_log) записей, привязанных к импортированному пакету, в таблицу Запись VCS (sys_vcs_record).
Параметры:
Название | Тип | Обязательный | Значение по умолчанию |
---|
retrievedPackId |
IntegerВозвращаемое значение:
String | Строка, содержащая результаты импортаBoolean | Метод возвращает значение true, если записи импортировались. В случае неудачи метод возвращает false. |
Пример:
Code Block |
---|
language | js |
---|
theme | Eclipse |
---|
title | importRetrievedPack() |
---|
linenumbers | true |
---|
|
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Возвращаемое значение:
Тип | Описание |
---|
Boolean | Метод возвращает |
"", если записи найдены. В случае неудачи метод возвращает |
""Пример:
Code Block |
---|
language | js |
---|
theme | Eclipse |
---|
title | isLocalPackHasReferences() |
---|
linenumbers | true |
---|
|
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Возвращаемое значение:
Тип | Описание |
---|
Boolean | Метод возвращает значение |
"" при наличии ссылок на записи, в случае их отсутствия метод возвращает |
""Пример:
Code Block |
---|
language | js |
---|
theme | Eclipse |
---|
title | isRetrievedPackHasReferences() |
---|
linenumbers | true |
---|
|
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), как как вложение для предварительного просмотра.
Параметры:
Название | Тип | Обязательный | Значение по умолчанию |
---|
sysVcsRetrievedPackId | IntegerString | Да | Нет |
Возвращаемое значение:
Тип | Описание |
---|
Boolean | Метод возвращает |
"", если загрузка данных прошла успешно. В случае неудачи метод возвращает |
""Пример:
Code Block |
---|
language | js |
---|
theme | Eclipse |
---|
title | loadDataFromAttachment() |
---|
linenumbers | true |
---|
|
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)
Используйте этот метод для объединения нескольких локальных пакетов в один. Исходные локальные пакеты удаляются безвозвратно.
Параметры:
Название | Тип | Обязательный | Значение по умолчанию |
---|
rowIds | Array of Strings | Да | Нет |
name | String | Нет |
''Возвращаемое значение:
Тип | Описание |
---|
String | Метод возвращает ID объединенного локального пакета. В случае неудачи метод возвращает |
""Пример:
Code Block |
---|
language | js |
---|
theme | Eclipse |
---|
title | mergeLocalPacks() |
---|
linenumbers | true |
---|
|
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 в локальный пакет по умолчанию.
Параметры:
Название | Тип | Обязательный | Значение по умолчанию |
---|
versionIds | Array of Strings | Да | Нет |
Возвращаемое значение:
Тип | Описание |
---|
Boolean | Метод возвращает |
"", при успешном перемещении записей. В случае ошибки метод возвращает |
""Пример:
Code Block |
---|
language | js |
---|
theme | Eclipse |
---|
title | moveVcsRecordsToDefault() |
---|
linenumbers | true |
---|
|
const vcs = new SimpleVcs();
const result = vcs.moveVcsRecordsToDefault([current.sys_id]);
ss.info(result); |
preview(sysVcsRetrievedPackId)
Данный метод извлекает записи, связанные Используйте метод для извлечения записей, связанных с конфигурацией, из таблицы Извлеченные записи (sys_vcs_retrieved_record)и выполняет предварительный выполнения предварительного просмотр пакета.
Параметры:
Название | Тип | Обязательный | Значение по умолчанию |
---|
retrievedPackId |
IntegerВозвращаемое значение:
Тип | Описание |
---|
Boolean | Метод возвращает |
"", если предварительный просмотр был успешным. В случае неудачи метод возвращает |
""Пример:
Code Block |
---|
language | js |
---|
theme | Eclipse |
---|
title | preview() |
---|
linenumbers | true |
---|
|
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(); |
rollbackrollBack(packId)
Используйте этот метод для отката локального пакета. Откат возможен, только когда локальный пакет находится в статусе "Откат подготовлен".
Параметры:
Название | Тип | Обязательный | Значение по умолчанию |
---|
packId |
IntegerВозвращаемое значение:
String | В случае успешного отката метод возвращает"true". В случае неудачи метод возвращает исключение.Void | Метод не возвращает значение. |
Пример:
Code Block |
---|
language | js |
---|
theme | Eclipse |
---|
title | rollbackrollBack() |
---|
linenumbers | true |
---|
|
const vcsLocalPackId = '156144163704236641';
const vcs = new SimpleVcs();
if (vcs.rollBack(vcsLocalPackId)) {
ss.addInfoMessage('Откат локального пакета произведен успешно');
} |
rollBackPreview(packId)
Используйте данный метод для предварительного просмотра результатов отката.
Параметры:
Название | Тип | Обязательный | Значение по умолчанию |
---|
packId |
IntegerВозвращаемое значение:
Boolean возвращает "true", если предварительный просмотр прошел успешно. В случае ошибки метод возвращает "false". Пример:
Code Block |
---|
language | js |
---|
theme | Eclipse |
---|
title | rollBackPreview() |
---|
linenumbers | true |
---|
|
const vcsLocalPackId = '156144163704236641';
const vcs = new SimpleVcs();
if (vcs.rollBackPreview(vcsLocalPackId)) {
ss.addInfoMessage('Предварительный просмотр отката локального пакета успешно пройден');
} |