PROCEDURE Error_NoXferKind(iID PLS_INTEGER);

Вызывает exception «Вид соответствия с ID не существует».

PROCEDURE Error_NoXferKind(sName VARCHAR2);

Вызывает exception «Вид соответствия с наименованием ... не существует».

PROCEDURE Error_NoMapping(iKindID PLS_INTEGER, iIntRgnID PLS_INTEGER := NULL, iIntID PLS_INTEGER := NULL, iExtRgnID PLS_INTEGER := NULL, iExtID PLS_INTEGER := NULL, sExtCode VARCHAR2 := NULL);

Вызывает exception «Запись соответствия не найдена».

PROCEDURE Error_TooManyMappings(iKindID PLS_INTEGER, iIntRgnID PLS_INTEGER := NULL, iIntID PLS_INTEGER := NULL, iExtRgnID PLS_INTEGER := NULL, iExtID PLS_INTEGER := NULL, sExtCode VARCHAR2 := NULL);

Вызывает exception «Найдено более одной записи соответствия».

PROCEDURE CheckXferKindExists(iID PLS_INTEGER);

Проверяет, что вид соответствия с указанным ID существует.

PROCEDURE CheckXferKindExists(sName VARCHAR2);

Проверяет, что вид соответствия с указанным внутренним наименованием (case-insensitive) существует.

FUNCTION GetXferKindName(iID PLS_INTEGER, iNameKind PLS_INTEGER, iStrict PLS_INTEGER) RETURN VARCHAR2;

Возвращает наименование указанного вида обмена данными.
Параметры:

• iID - ID вида соответствия;
  
• iNameKind - вид наименования (0-системное, 1-отображаемое);
  
• iStrict - определяет поведение при отсутствии записи.

FUNCTION GetXferKindID(sName VARCHAR2, iStrict PLS_INTEGER := 0) RETURN PLS_INTEGER;

Возвращает ID вида соответствия по системному наименованию (case-insensitive). iStrict определяет поведение при отсутствии записи.

FUNCTION SetXferKindID(sName VARCHAR2, sDescription VARCHAR2) RETURN PLS_INTEGER;

Создаёт запись вида соответствия или обновляет описание существующей записи с таким же наименованием. Возвращает ID новой или существующей записи.

FUNCTION GetMappingDescription(iKindID PLS_INTEGER, iIntRgnID PLS_INTEGER := NULL, iIntID PLS_INTEGER := NULL, iExtRgnID PLS_INTEGER := NULL, iExtID PLS_INTEGER := NULL, sExtCode VARCHAR2 := NULL) RETURN VARCHAR2;

Возвращает описание записи соответствия. Выводится описание только тех элементов, значение которых отлично от null.

FUNCTION GetExternalID(iKindID PLS_INTEGER, iIntID PLS_INTEGER, iIntRgnID PLS_INTEGER := NULL, iExtRgnID PLS_INTEGER := NULL, iStrict PLS_INTEGER := 0) RETURN PLS_INTEGER;

Возвращает ID внешнего ключа по внутреннему ключу.
Параметры:

• iKindID - ID вида соответствия данных;
  
• iIntID - ID внутреннего ключа;
  
• iIntRgnID - ID района внутреннего ключа (если null, то район внутреннего ключа игнорируется);
  
• iExtRgnID - ID района внешнего ключа (если null, то район внешнего ключа игнорируется);
  
• iStrict - определяет поведение при отсутствии данных и при неоднозначном соответствии.

FUNCTION GetExternalCode(iKindID PLS_INTEGER, iIntID PLS_INTEGER, iIntRgnID PLS_INTEGER := NULL, iExtRgnID PLS_INTEGER := NULL, iStrict PLS_INTEGER := 0) RETURN VARCHAR2;

Возвращает код внешней записи по внутреннему ключу.
Параметры:

• iKindID - ID вида соответствия данных;
  
• iIntID - ID внутреннего ключа;
  
• iIntRgnID - ID района внутреннего ключа (если null, то район внутреннего ключа игнорируется);
  
• iExtRgnID - ID района внешнего ключа (если null, то район внешнего ключа игнорируется);
  
• iStrict - определяет поведение при отсутствии данных и при неоднозначном соответствии.

FUNCTION GetExternalName(iKindID PLS_INTEGER, iIntID PLS_INTEGER, iIntRgnID PLS_INTEGER, iExtID PLS_INTEGER, iExtRgnID PLS_INTEGER, iStrict PLS_INTEGER := 0) RETURN VARCHAR2;

Возвращает наименование внешнего ключа по внутреннему и внешнему ключам.
Параметры:

• iKindID - ID вида соответствия данных;
  
• iIntID, iIntRgnID - внутренний ключ;
  
• iExtID, iExtRgnID - внешний ключ;
  
• iStrict - определяет поведение при отсутствии данных.

FUNCTION GetExternalKey(iKindID PLS_INTEGER, iIntID PLS_INTEGER, iIntRgnID PLS_INTEGER, iID OUT PLS_INTEGER, iRgnID OUT PLS_INTEGER, iStrict PLS_INTEGER := 0) RETURN PLS_INTEGER;

Получает внешний ключ по внутреннему ключу.
Параметры:

• iKindID - ID вида соответствия данных;
  
• iIntID, iIntRgnID - внутренний ключ;
  
• iID, iRgnID - внешний ключ (выходные параметры);
  
• iStrict - определяет поведение при отсутствии записи соответствия и при неоднозначном соответствии.
  

Возвращает:

• при iStrict=0: 0 - при отсутствии соответствия; 1 - в случае успешного получения; 2 - в случае неоднозначного соответствия;
  
• при iStrict=1: 1 - в случае успешного получения; иначе возникает exception.
  

Если функция вернула значение, отличное от 1, значение out-параметров не определено.

FUNCTION GetExternalValue(iKindID PLS_INTEGER, iIntID PLS_INTEGER, iIntRgnID PLS_INTEGER, iValue OUT PLS_INTEGER, iRgnFactor PLS_INTEGER := 1000000, iStrict PLS_INTEGER := 0) RETURN PLS_INTEGER;

Аналогична предыдущей, но получает value ключа: Value ← region_id*iRegionFactor+id.

FUNCTION GetInternalID(iKindID PLS_INTEGER, iExtID PLS_INTEGER, iExtRgnID PLS_INTEGER := NULL, iIntRgnID PLS_INTEGER := NULL, iStrict PLS_INTEGER := 0) RETURN PLS_INTEGER;

Возвращает ID внутреннего ключа по внешнему ключу.
Параметры:

• iKindID - ID вида соответствия данных;
  
• iExtID - ID внешнего ключа;
  
• iExtRgnID - ID района внешнего ключа (если null, то район внешнего ключа игнорируется);
  
• iIntRgnID - ID района внутреннего ключа (если null, то район внутреннего ключа игнорируется);
  
• iStrict - определяет поведение при отсутствии данных и при неоднозначном соответствии.

FUNCTION GetInternalName(iKindID PLS_INTEGER, iIntID PLS_INTEGER, iIntRgnID PLS_INTEGER, iExtID PLS_INTEGER, iExtRgnID PLS_INTEGER, iStrict PLS_INTEGER := 0) RETURN VARCHAR2;

Возвращает наименование внутреннего ключа по внутреннему и внешнему ключам.
Параметры:

• iKindID - ID вида соответствия данных;
  
• iIntID, iIntRgnID - внутренний ключ;
  
• iExtID, iExtRgnID - внешний ключ;
  
• iStrict - определяет поведение при отсутствии данных.

FUNCTION GetInternalIDByExtCode(iKindID PLS_INTEGER, sExtCode VARCHAR2, iExtRgnID PLS_INTEGER := NULL, iIntRgnID PLS_INTEGER := NULL, iStrict PLS_INTEGER := 0) RETURN PLS_INTEGER;

Возвращает ID внутреннего ключа по коду внешней записи (case-sensitive).
Параметры:

• iKindID - ID вида соответствия данных;
  
• sExtCode - код внешней записи;
  
• iExtRgnID - ID района внешнего ключа (если null, то район внешнего ключа игнорируется);
  
• iIntRgnID - ID района внутреннего ключа (если null, то район внутреннего ключа игнорируется);
  
• iStrict - определяет поведение при отсутствии данных и при неоднозначном соответствии.

FUNCTION GetInternalKey(iKindID PLS_INTEGER, iExtID PLS_INTEGER, iExtRgnID PLS_INTEGER := NULL, iID OUT PLS_INTEGER, iRgnID OUT PLS_INTEGER, iStrict PLS_INTEGER := 0) RETURN PLS_INTEGER;

Получает внутренний ключ по внешнему ключу или ID.
Параметры:

• iKindID - ID вида соответствия данных;
  
• iExtID - ID внешнего ключа;
  
• iExtRgnID - ID района внешнего ключа (если null, то район внешнего ключа игнорируется);
  
• iID, iRgnID - внутренний ключ (выходные параметры);
  
• iStrict - определяет поведение при отсутствии записи соответствия и при неоднозначном соответствии.
  

Возвращает:

• при iStrict=0: 0 - при отсутствии соответствия; 1 - в случае успешного получения; 2 - в случае неоднозначного соответствия;
  
• при iStrict=1: 1 - в случае успешного получения; иначе возникает exception.
  

Если функция вернула значение, отличное от 1, значение out-параметров не определено.

FUNCTION GetInternalKeyByExtCode(iKindID PLS_INTEGER, sExtCode VARCHAR2, iExtRgnID PLS_INTEGER := NULL, iID OUT PLS_INTEGER, iRgnID OUT PLS_INTEGER, iStrict PLS_INTEGER := 0) RETURN PLS_INTEGER;

Получает внутренний ключ по коду внешней записи.
Параметры:

• iKindID - ID вида соответствия данных;
  
• sExtCode - код внешней записи;
  
• iExtRgnID - ID района внешнего ключа (если null, то район внешнего ключа игнорируется);
  
• iID, iRgnID - внутренний ключ (выходные параметры);
  
• iStrict - определяет поведение при отсутствии записи соответствия и при неоднозначном соответствии.
  

Возвращает:

• при iStrict=0: 0 - при отсутствии соответствия; 1 - в случае успешного получения; 2 - в случае неоднозначного соответствия;
  
• при iStrict=1: 1 - в случае успешного получения; иначе возникает exception.
  

Если функция вернула значение, отличное от 1, значение out-параметров не определено.

FUNCTION GetInternalValue(iKindID PLS_INTEGER, iExtID PLS_INTEGER, iExtRgnID PLS_INTEGER := NULL, iValue OUT PLS_INTEGER, iRgnFactor PLS_INTEGER := 1000000, iStrict PLS_INTEGER := 0) RETURN PLS_INTEGER;

Аналогична GetInternalKey, но в выходной параметр помещается slurp-ключ.

FUNCTION GetInternalValueByExtCode(iKindID PLS_INTEGER, sExtCode VARCHAR2, iExtRgnID PLS_INTEGER := NULL, iValue OUT PLS_INTEGER, iRgnFactor PLS_INTEGER := 1000000, iStrict PLS_INTEGER := 0) RETURN PLS_INTEGER;

Аналогична GetInternalKeyByExtCode, но в выходной параметр помещается slurp-ключ.

PROCEDURE SetExtToIntData(iKindID PLS_INTEGER, iExtID PLS_INTEGER, iExtRgnID PLS_INTEGER, iIntID PLS_INTEGER, iIntRgnID PLS_INTEGER, sExtCode VARCHAR2 := NULL, sExtName VARCHAR2 := NULL, sIntName VARCHAR2 := NULL);

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

PROCEDURE SetExtToIntValue(iKindID PLS_INTEGER, iExtID PLS_INTEGER, iExtRgnID PLS_INTEGER, iIntValue PLS_INTEGER, sExtCode VARCHAR2 := NULL, sExtName VARCHAR2 := NULL, sIntName VARCHAR2 := NULL, iRgnFactor PLS_INTEGER := 1000000);

Аналогична предыдущей. Производит автоматическое декодирование: Value → region_id*iRegionFactor+id.

PROCEDURE SetIntToExtData(iKindID PLS_INTEGER, iIntID PLS_INTEGER, iIntRgnID PLS_INTEGER, iExtID PLS_INTEGER, iExtRgnID PLS_INTEGER, sIntName VARCHAR2 := NULL, sExtCode VARCHAR2 := NULL, sExtName VARCHAR2 := NULL);

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

PROCEDURE SetIntToExtValue(iKindID PLS_INTEGER, iIntID PLS_INTEGER, iIntRgnID PLS_INTEGER, iExtValue PLS_INTEGER, sIntName VARCHAR2 := NULL, sExtCode VARCHAR2 := NULL, sExtName VARCHAR2 := NULL, iRgnFactor PLS_INTEGER := 1000000);

Аналогична предыдущей. Производит автоматическое декодирование: Value → region_id*iRegionFactor+id.

PROCEDURE DeleteExternalKeys(iKindID PLS_INTEGER, iExtID PLS_INTEGER, iExtRgnID PLS_INTEGER);

Удаляет из таблицы соответствия записи, соответствующие указанному внешнему ключу.

PROCEDURE DeleteInternalKeys(iKindID PLS_INTEGER, iIntID PLS_INTEGER, iIntRgnID PLS_INTEGER);

Удаляет из таблицы соответствия записи, соответствующие указанному внутреннему ключу.

FUNCTION ExtToSimpleData(iExtID PLS_INTEGER, iExtRgnID PLS_INTEGER, iDictID PLS_INTEGER, iID OUT PLS_INTEGER, iRgnID OUT PLS_INTEGER) RETURN PLS_INTEGER;

Декодируют Value или (id, region_id) из внешнего справочника во внутренний. Возвращает 1 при успешном завершении, 0 при ошибке. Если функция вернула 0, значение out-параметров неопределено. (id, region_id) → (id, region_id).

FUNCTION ExtToSimpleValue(iExtID PLS_INTEGER, iExtRgnID PLS_INTEGER, iDictID PLS_INTEGER, iValue OUT PLS_INTEGER, iRgnFactor PLS_INTEGER := 1000000) RETURN PLS_INTEGER;

(id, region_id) → value.

FUNCTION ExtValueToSimpleData(iExtValue PLS_INTEGER, iDictID PLS_INTEGER, iID OUT PLS_INTEGER, iRgnID OUT PLS_INTEGER, iRgnFactor PLS_INTEGER := 1000000) RETURN PLS_INTEGER;

value → (id, region_id).

FUNCTION ExtValueToSimpleValue(iExtValue PLS_INTEGER, iDictID PLS_INTEGER, iValue OUT PLS_INTEGER, iRgnFactor PLS_INTEGER := 1000000) RETURN PLS_INTEGER;

value → value.

FUNCTION GetExtIDForSimpleData(iSimpleID PLS_INTEGER, iSimpleRgnID PLS_INTEGER, iExtRgnID PLS_INTEGER) RETURN PLS_INTEGER;

FUNCTION GetExtIDForSimpleValue(iSimpleValue PLS_INTEGER, iExtRgnID PLS_INTEGER, iRgnFactor PLS_INTEGER := 1000000) RETURN PLS_INTEGER;