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

pkEI.sql

Ошибки

Error_NoDataKind

PROCEDURE Error_NoDataKind(iRegionID PLS_INTEGER, iID PLS_INTEGER);

Описание

Вызывает exception “Вид информации не существует”.

Error_NoIndicator

PROCEDURE Error_NoIndicator(iRegionID PLS_INTEGER, iID PLS_INTEGER);

Описание

Вызывает exception “Показатель не существует”.

Error_NoAccLevel

PROCEDURE Error_NoAccLevel(iRegionID PLS_INTEGER, iID PLS_INTEGER);

Описание

Вызывает exception “Уровень учёта не существует”.

Error_NoDataSet

PROCEDURE Error_NoDataSet(iRegionID PLS_INTEGER, iID PLS_INTEGER);

Описание

Вызывает exception “Набор данных не существует”.

Error_DataSetIsClosed

PROCEDURE Error_DataSetIsClosed(iRegionID PLS_INTEGER, iID PLS_INTEGER);

Описание

Вызывает exception “Набор данных закрыт для редактирования”.

Error_NoDKYearSettings

PROCEDURE Error_NoDKYearSettings(iRegionID PLS_INTEGER, iDataKindRgnID PLS_INTEGER, iDataKindID PLS_INTEGER, iYear PLS_INTEGER);

Описание

Вызывает exception “Для вида информации не заданы параметры учёта...”.

Error_NoDataView

PROCEDURE Error_NoDataView(iRegionID PLS_INTEGER, iID PLS_INTEGER);

Описание

Вызывает exception “Шаблон просмотра данных не существует”.

Справочники

GetDataKindName

FUNCTION GetDataKindName(iRegionID PLS_INTEGER, iID PLS_INTEGER, iStrict PLS_INTEGER, iDisplayMode PLS_INTEGER := 0) RETURN VARCHAR2;

Описание

Возвращает наименование вида информации.
Параметры:

  • iRegionID, iID - ключ вида информации;
  • iStrict - определяет поведение при отсутствии вида информации;
  • iDisplayMode - способ вывода результата (см. uszn.pkGen.FormatNameWithRKey).

GetAccLevelName

FUNCTION GetAccLevelName(iRegionID PLS_INTEGER, iID PLS_INTEGER, iStrict PLS_INTEGER) RETURN VARCHAR2;

Описание

Возвращает наименование уровня учёта.
Параметры:

  • iRegionID, iID - ключ уровня учёта;
  • iStrict - определяет поведение при отсутствии уровня учёта.

Привилегии

GetUserGroupDataKindPrivs

FUNCTION GetUserGroupDataKindPrivs(iUserGroupID PLS_INTEGER, iDataKindRgnID PLS_INTEGER, iDataKindID PLS_INTEGER, iIsPermission PLS_INTEGER) RETURN PLS_INTEGER;

Описание

Возвращает привилегии группы пользователей на вид информации.
Параметры:

  • iUserGroupID - ID группы пользователей;
  • iDataKindRgnID, iDataKindID - ключ вида информации;
  • iIsPermission - какой вид привилегий требуется получить: 0 - запрещение, 1 - разрешение.

Возвращает набор указанных привилегий в виде битовой маски. Если привилегии отсутствуют, возвращает 0.

SetUserGroupDataKindPrivs

PROCEDURE SetUserGroupDataKindPrivs(iUserGroupID PLS_INTEGER, iDataKindRgnID PLS_INTEGER, iDataKindID PLS_INTEGER, iPermittedPrivs PLS_INTEGER, iRestrictedPrivs PLS_INTEGER);

Описание

Устанавливает привилегии группы пользователей на вид информации.
Параметры:

  • iUserGroupID - ID группы пользователей;
  • iDataKindRgnID, iDataKindID - ключ вида информации;
  • iPermittedPrivs - набор разрешений в виде битовой маски;
  • iRestrictedPrivs - набор запрещений в виде битовой маски.

GetUserGroupAccLevelPrivs

FUNCTION GetUserGroupAccLevelPrivs(iUserGroupID PLS_INTEGER, iAccLevelRgnID PLS_INTEGER, iAccLevelID PLS_INTEGER, iIsPermission PLS_INTEGER) RETURN PLS_INTEGER;

Описание

Возвращает привилегии группы пользователей на уровень учёта.
Параметры:

  • iUserGroupID - ID группы пользователей;
  • iAccLevelRgnID, iAccLevelID - ключ уровня учёта;
  • iIsPermission - какой вид привилегий требуется получить: 0 - запрещение, 1 - разрешение.

Возвращает набор указанных привилегий в виде битовой маски. Если привилегии отсутствуют, возвращает 0.

SetUserGroupAccLevelPrivs

PROCEDURE SetUserGroupAccLevelPrivs(iUserGroupID PLS_INTEGER, iAccLevelRgnID PLS_INTEGER, iAccLevelID PLS_INTEGER, iPermittedPrivs PLS_INTEGER, iRestrictedPrivs PLS_INTEGER);

Описание

Устанавливает привилегии группы пользователей на уровень учёта.
Параметры:

  • iUserGroupID - ID группы пользователей;
  • iAccLevelRgnID, iAccLevelID - ключ уровня учёта;
  • iPermittedPrivs - набор разрешений в виде битовой маски;
  • iRestrictedPrivs - набор запрещений в виде битовой маски.

GetDataKindUserPrivs

FUNCTION GetDataKindUserPrivs(iDataKindRgnID PLS_INTEGER, iDataKindID PLS_INTEGER, sUserName VARCHAR2 := USER) RETURN PLS_INTEGER;

Описание

Возвращает привилегии указанного пользователя на вид информации в виде битовой маски.
Параметры:

  • iDataKindRgnID, iDataKindID - ключ вида информации;
  • sUserName - имя пользователя СУБД.

GetAccLevelUserPrivs

FUNCTION GetAccLevelUserPrivs(iAccLevelRgnID PLS_INTEGER, iAccLevelID PLS_INTEGER, sUserName VARCHAR2 := USER) RETURN PLS_INTEGER;

Описание

Возвращает привилегии указанного пользователя на уровень учёта в виде битовой маски.
Параметры:

  • iAccLevelRgnID, iAccLevelID - ключ уровня учёта;
  • sUserName - имя пользователя СУБД.

CheckDataKindPrivs

PROCEDURE CheckDataKindPrivs(iDataKindRgnID PLS_INTEGER, iDataKindID PLS_INTEGER, iPrivs PLS_INTEGER, sOperation VARCHAR2 := NULL);

Описание

Проверяет, есть ли право у текущего пользователя на выполнение операций по виду информации.
Параметры:

  • iDataKindRgnID, iDataKindID - ключ вида информации;
  • iPrivs - набор привилегий в виде битовой маски; если хоть какой-нибудь привилегии нет, возникает exception;
  • sOperation - наименование выполняемой операции для отображения в сообщении об ошибке.

CheckAccLevelPrivs

PROCEDURE CheckAccLevelPrivs(iAccLevelRgnID PLS_INTEGER, iAccLevelID PLS_INTEGER, iPrivs PLS_INTEGER, sOperation VARCHAR2 := NULL);

Описание

Проверяет, есть ли право у текущего пользователя на выполнение операций по уровню учёта.
Параметры:

  • iAccLevelRgnID, iAccLevelID - ключ уровня учёта;
  • iPrivs - набор привилегий в виде битовой маски; если хоть какой-нибудь привилегии нет, возникает exception;
  • sOperation - наименование выполняемой операции для отображения в сообщении об ошибке.

Наборы данных

AllocateDataSets

PROCEDURE AllocateDataSets(iDataKindRgnID PLS_INTEGER, iDataKindID PLS_INTEGER, iRegionID PLS_INTEGER, iYear PLS_INTEGER);

Описание

Создаёт пустые наборы значений экономических показателей за год.
Параметры:

  • iDataKindRgnID, iDataKindID - ключ вида информации;
  • iRegionID - ID района, для которого создаются наборы;
  • iYear - год, для которого создаются наборы.

Если вид информации не существуют, параметры учёта на указанный год в указанном районе не заданы или пользователь
не имеет привилегии на создание наборов, возникает exception.

SetIndicatorValue

PROCEDURE SetIndicatorValue(iRegionID PLS_INTEGER, iDataSetID PLS_INTEGER, iIndicatorRgnID PLS_INTEGER, iIndicatorID PLS_INTEGER, nValue NUMBER);

Описание

Сохраняет новое значение показателя в наборе.
Параметры:

  • iRegionID, iDataSetID - ключ набора;
  • iIndicatorRgnID, iIndicatorID - ключ показателя;
  • nValue - значение показателя.

Если sValue=null, существующее значение удаляется (если оно имеется). Если sValue!=null, то значение добавляется или
изменяется существующее значение.
Если набор или показатель не существуют, набор закрыт для редактирования или пользователь не имеет необходимых
привилегий, возникает exception.

SetDatasetClosure

PROCEDURE SetDatasetClosure(iRegionID PLS_INTEGER, iDataSetID PLS_INTEGER, iClose PLS_INTEGER);

Описание

Включает/выключает признак закрытия набора данных.
Параметры:

  • iRegionID, iDataSetID - ключ набора;
  • iClose - требуемое финальное состояние закрытия набора (0/1).

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

Шаблоны просмотра данных

AddDataView

FUNCTION AddDataView(
  iRegionID PLS_INTEGER, iDataKindRgnID PLS_INTEGER, iDataKindID PLS_INTEGER, sName VARCHAR2, sDescription VARCHAR2,
  iRowObject PLS_INTEGER, iColObject PLS_INTEGER,
  iFltrIndicatorID PLS_INTEGER, iFltrAccLevelID PLS_INTEGER, iFltrYear PLS_INTEGER, iFltrPeriodicity PLS_INTEGER, iFltrPeriodNum PLS_INTEGER) RETURN PLS_INTEGER;

Описание

Создаёт новый шаблон просмотра данных социально-экономических показателей.
Параметры:

  • iRegionID - ID рабочего района;
  • iDataKindRgnID, iDataKindID - ключ вида информации;
  • sName - наименование шаблона;
  • sDescription - описание шаблона;
  • iRowObject - вид объекта для строк таблицу: 1 - показатель; 2 - уровень учёта; 3 - период;
  • iColObject - вид объекта для столбцов таблицу: 1 - показатель; 2 - уровень учёта; 3 - период;
  • iFltrIndicatorID - ID показателя для фильтра; null, если показатели используются в строках или столбцах;
  • iFltrAccLevelID - ID уровня учёта для фильтра; null, если уровни учёта используются в строках или столбцах;
  • iFltrYear, iFltrPeriodicity, iFltrPeriodNum - параметры периода для фильтра; null, если периоды используются в строках или столбцах.

Возвращает ID созданной записи.
Если пользователь не имеет достаточных привилегий для работы с видом информации, возникает exception.

DeleteDataView

PROCEDURE DeleteDataView(iRegionID PLS_INTEGER, iID PLS_INTEGER);

Описание

Удаляет шаблон просмотра данных социально-экономических показателей.
Параметры:

  • iRegionID, iID - ключ шаблона.

Если у пользователя недостаточно прав или шаблон не существует, возникает exception.

AddDataViewIndicator

PROCEDURE AddDataViewIndicator(iRegionID PLS_INTEGER, iDataViewID PLS_INTEGER, iIndicatorRgnID PLS_INTEGER, iIndicatorID PLS_INTEGER);

Описание

Добавляет показатель к шаблону просмотра данных социально-экономических показателей.
Параметры:

  • iRegionID, iDataViewID - ключ шаблона;
  • iIndicatorRgnID, iIndicatorID - ключ показателя.

Если у пользователя недостаточно прав или шаблон не существует, а также если показатель относится к другому виду
информации, возникает exception.

AddDataViewAccLevel

PROCEDURE AddDataViewAccLevel(iRegionID PLS_INTEGER, iDataViewID PLS_INTEGER, iAccLevelID PLS_INTEGER);

Описание

Добавляет уровень учёта к шаблону просмотра данных социально-экономических показателей.
Параметры:

  • iRegionID, iDataViewID - ключ шаблона;
  • iAccLevelID - ID уровня учёта.

Если у пользователя недостаточно прав или шаблон не существует, возникает exception.

AddDataViewPeriod

PROCEDURE AddDataViewPeriod(iRegionID PLS_INTEGER, iDataViewID PLS_INTEGER, iYear PLS_INTEGER, iPeriodicity PLS_INTEGER, iPeriodNum PLS_INTEGER);

Описание

Добавляет период к шаблону просмотра данных социально-экономических показателей.
Параметры:

  • iRegionID, iDataViewID - ключ шаблона;
  • iYear, iPeriodicity, iPeriodNum - параметры периода.

Если у пользователя недостаточно прав или шаблон не существует, возникает exception.