Документация iSZN

Местоположение: guide => design => api => server => packages

pkUpd.sql

Error_NoSnapshotTemplate

PROCEDURE Error_NoSnapshotTemplate(iTemplateID PLS_INTEGER);

Описание

Вызывает ошибку «Шаблон обновления не найден».

Error_InvalidSnapshotScript

PROCEDURE Error_InvalidSnapshotScript(iSnapshotScriptID PLS_INTEGER);

Описание

Вызывает ошибку «Дополнительный сценарий обновления не найден».

Error_InvalidSSCommand

PROCEDURE Error_InvalidSSCommand(iCommandID PLS_INTEGER);

Описание

Вызывает ошибку «Команда дополнительного сценария обновления не найдена».

Error_InvalidSSList

PROCEDURE Error_InvalidSSList(iSnapshotScriptListID PLS_INTEGER);

Описание

Вызывает ошибку «Список дополнительных сценариев обновления не найден».

Error_InvalidSSKind

PROCEDURE Error_InvalidSSKind(iSnapshotScript_KindID PLS_INTEGER);

Описание

Вызывает ошибку «Вид дополнительного сценария обновления не найден».

Error_InvalidSSLink

PROCEDURE Error_InvalidSSLink(iLinkID PLS_INTEGER);

Описание

Вызывает ошибку «Связь сценария со списком дополнительных сценариев обновления не найдена».

ConfirmSnapshotInstallation

PROCEDURE ConfirmSnapshotInstallation(sMessage VARCHAR2);

Описание

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

TerminateSnapshotInstallation

PROCEDURE TerminateSnapshotInstallation(sMessage VARCHAR2);

Описание

Вызывает специальный exception, заставляющий мастер обновления прервать установку обновления.

GetCurrentSnapshotDate

FUNCTION GetCurrentSnapshotDate RETURN DATE;

Описание

Возвращает дату создания текущей версии среды.

GetCurrentSnapshotRevision

FUNCTION GetCurrentSnapshotRevision RETURN PLS_INTEGER;

Описание

Возвращает номер текущей версии среды.

UpdateStart

FUNCTION UpdateStart(
    iCurrentRevision PLS_INTEGER, iRequiredRevision PLS_INTEGER,
    sUser VARCHAR2, iUserRegionID PLS_INTEGER, sUpdatedRegions VARCHAR2, sUpdatedRegionsActual VARCHAR2,
    sVersion VARCHAR2, sOptions VARCHAR2, iIgnoreRevMismatch PLS_INTEGER) RETURN PLS_INTEGER;

Описание

Регистрирует начало процесса обновления и возвращает ID новой записи (в r_env_update_log).
Параметры:

  • iCurrentRevision - версия среды, содержащаяся в снимке;
  • iRequiredRevision - минимальная версия среды, требуемая снимком;
  • sUser - имя пользователя, запустившего обновление;
  • iUserRegionID - ID района пользователя, запустившего обновление;
  • sUpdatedRegions - список ID районов, выбранных для обновления; если районные данные не обновляются, то null;
  • sUpdatedRegionsActual - список ID районов, которые фактически будут обновляться; если районные данные не обновляются, то null;
  • sVersion - текущая версия продукта;
  • sOptions - опции установки.

Если текущая версия среды выше, чем iCurrentRevision, или ниже, чем iRequiredRevision, то:

  • при iIgnoreRevMismatch!=0 позволяет произвести обновление
  • при iIgnoreRevMismatch=0 вызывает Exception.

UpdateFinish

PROCEDURE UpdateFinish(iRecID PLS_INTEGER, sSummary VARCHAR2, iCntFails PLS_INTEGER, iCntObjects PLS_INTEGER, iCntRecords PLS_INTEGER, iCntTables PLS_INTEGER, iCntPrivs PLS_INTEGER);

Описание

Регистрирует окончание процесса обновления. iRecID - ID записи, который вернула UpdateStart().

GetDefaultSnapshotScript

FUNCTION GetDefaultSnapshotScript(iTemplateID PLS_INTEGER) RETURN CLOB;

Описание

Возвращает текст SQL-сценария обновления по умолчанию для указанного шаблона обновления.