Документация 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.