PROCEDURE Error_NoDataSource(iRegionID PLS_INTEGER, iID PLS_INTEGER);

Вызывает ошибку «Источник данных для загрузки не существует».

PROCEDURE Error_InvalidEntityID(iID PLS_INTEGER);

Вызывает ошибку «Сущность не существует».

PROCEDURE Error_NoEntityLookupSQL(iEntityID PLS_INTEGER);

Вызывает ошибку «Сущность не имеет lookup-выражения».

PROCEDURE Error_DecodingEntityKeyID(iEntityID PLS_INTEGER, iKeyID PLS_INTEGER, sMessage VARCHAR2);

Вызывает ошибку «Ошибка при декодировании ключа сущности».

PROCEDURE Error_NoEntityKeyMap(iRegionID PLS_INTEGER, iID PLS_INTEGER);

Вызывает ошибку «Запись соответствия ключей сущности не найдена».

PROCEDURE Error_NoPCKeyMap(iRegionID PLS_INTEGER, iID PLS_INTEGER);

Вызывает ошибку «Запись соответствия ключей человека/коллектива не найдена».

PROCEDURE Error_NoPDocKeyMap(iRegionID PLS_INTEGER, iID PLS_INTEGER);

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

PROCEDURE Error_NoFileKeyMap(iRegionID PLS_INTEGER, iID PLS_INTEGER);

Вызывает ошибку «Запись соответствия ключей файла не найдена».

PROCEDURE Error_NoEntityKeyMapExtID(iRegionID PLS_INTEGER, iSourceID PLS_INTEGER, iEntityID PLS_INTEGER, iExternalID PLS_INTEGER);

Вызывает ошибку «Запись соответствия ключей сущности не найдена, ID внешней записи=...».

PROCEDURE Error_NoPCKeyMapExtID(iRegionID PLS_INTEGER, iSourceID PLS_INTEGER, iExternalID PLS_INTEGER);

Вызывает ошибку «Запись соответствия ключей человека/коллектива не найдена, ID внешней записи=...».

PROCEDURE Error_NoPDocKeyMapExtID(iRegionID PLS_INTEGER, iSourceID PLS_INTEGER, iExternalID PLS_INTEGER);

Вызывает ошибку «Запись соответствия ключей экземпляра персонального документа не найдена, ID внешней записи=...».

PROCEDURE Error_NoFileKeyMapExtID(iRegionID PLS_INTEGER, iSourceID PLS_INTEGER, iExternalID PLS_INTEGER);

Вызывает ошибку «Запись соответствия ключей файла не найдена, ID внешней записи=...».

PROCEDURE Error_EntityIntIDIsNull(iRegionID PLS_INTEGER, iSourceID PLS_INTEGER, iEntityID PLS_INTEGER, iExternalID PLS_INTEGER);

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

PROCEDURE Error_PCIntIDIsNull(iRegionID PLS_INTEGER, iSourceID PLS_INTEGER, iExternalID PLS_INTEGER);

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

PROCEDURE Error_PDocIntIDIsNull(iRegionID PLS_INTEGER, iSourceID PLS_INTEGER, iExternalID PLS_INTEGER);

Вызывает ошибку «Для записи соответствия ключей экземпляра персонального документа не задан ID внутренней записи».

PROCEDURE Error_FileIntIDIsNull(iRegionID PLS_INTEGER, iSourceID PLS_INTEGER, iExternalID PLS_INTEGER);

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

PROCEDURE Error_EntityIntIDIsInvalid(iRegionID PLS_INTEGER, iSourceID PLS_INTEGER, iExternalID PLS_INTEGER, iEntityID PLS_INTEGER, sErrorMsg VARCHAR2);

Вызывает ошибку «Запись соответствия ключей сущности имеет невалидный ID внутренней записи».

PROCEDURE Error_PCIntIDIsInvalid(iRegionID PLS_INTEGER, iSourceID PLS_INTEGER, iExternalID PLS_INTEGER, sErrorMsg VARCHAR2);

Вызывает ошибку «Запись соответствия ключей человека/коллектива имеет невалидный ID внутренней записи».

PROCEDURE Error_PDocIntIDIsInvalid(iRegionID PLS_INTEGER, iSourceID PLS_INTEGER, iExternalID PLS_INTEGER, sErrorMsg VARCHAR2);

Вызывает ошибку «Запись соответствия ключей экземпляра персонального документа имеет невалидный ID внутренней записи».

PROCEDURE Error_NoPCXMLImportRule(iRegionID PLS_INTEGER, iID PLS_INTEGER);

Вызывает ошибку «Правило импорта XML-дампов людей/коллективов не найдено».

PROCEDURE Error_NoPCXMLImportScript(iRegionID PLS_INTEGER, iID PLS_INTEGER);

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

FUNCTION GetDataSourceName(iRegionID PLS_INTEGER, iID PLS_INTEGER, iDisplayMode PLS_INTEGER, iStrict PLS_INTEGER) RETURN VARCHAR2;

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

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

FUNCTION GetDataSourceRegionID(iRegionID PLS_INTEGER, iID PLS_INTEGER, iStrict PLS_INTEGER) RETURN PLS_INTEGER;

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

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

FUNCTION GetDataSourceCustomerID(iRegionID PLS_INTEGER, iID PLS_INTEGER, iStrict PLS_INTEGER) RETURN PLS_INTEGER;

Возвращает ID внешнего клиента источника данных для загрузки.
Параметры:

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

FUNCTION GetSourceKeyMapCount(iRegionID PLS_INTEGER, iSourceID PLS_INTEGER) RETURN PLS_INTEGER;

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

• iRegionID, iSourceID - ключ источника данных.

FUNCTION PDocClassHasEntityKeyMapReqs(iPDocClassID PLS_INTEGER, iEntityID PLS_INTEGER) RETURN PLS_INTEGER;

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

• iPDocClassID - ID класса персонального документа;
  
• iEntityID - ID сущности.

FUNCTION PDocClassHasPCKeyMapReqs(iPDocClassID PLS_INTEGER) RETURN PLS_INTEGER;

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

• iPDocClassID - ID класса персонального документа.

FUNCTION PDocClassHasPDocKeyMapReqs(iPDocClassID PLS_INTEGER) RETURN PLS_INTEGER;

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

• iPDocClassID - ID класса персонального документа.

FUNCTION PDocClassHasFileKeyMapReqs(iPDocClassID PLS_INTEGER) RETURN PLS_INTEGER;

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

• iPDocClassID - ID класса персонального документа.

FUNCTION GetEntityName(iID PLS_INTEGER, iStrict PLS_INTEGER) RETURN VARCHAR2;

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

• iID - ID сущности;
  
• iStrict - определяет поведение при отсутствии сущности.

FUNCTION GetEntityLookupItems(iRegionID PLS_INTEGER, iEntityID INTEGER) RETURN uszn.TValueIDObjList;

Возвращает список записей сущности для заданного листьевого района, используя выражение lookup-sql.
Параметры:

• iRegionID - ID листьевого района, для которого выбираются записи;
  
• iEntityID - ID сущности.

FUNCTION EntityValueDecode(iRegionID PLS_INTEGER, iEntityID PLS_INTEGER, iID PLS_INTEGER, iStrictMode PLS_INTEGER) RETURN VARCHAR2;

Возвращает значение сущности на основе её списка выбора.
Если сущность не существует, возникает exception.
Параметры:

• iRegionID - ID листьевого района, для которого выбираются записи;
  
• iEntityID - ID сущности;
  
• iID - ID декодируемого ключа;
  
• iStrictMode - режим строгости декодирования: 0 - возвращать null при возникновении любой ошибки; 1 - возвращать null при отсутствии lookup-выражения, но вызывать exception при других ошибках; 2 - вызывать exception в случае любой ошибки.

FUNCTION GetEntityKeyMapID(iRegionID PLS_INTEGER, iSourceID PLS_INTEGER, iEntityID PLS_INTEGER, iExternalID PLS_INTEGER, iStrict PLS_INTEGER) RETURN PLS_INTEGER;

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

• iRegionID, iSourceID - ключ источника данных для загрузки;
  
• iEntityID - ID сущности;
  
• iExternalID - ID внешней записи;
  
• iStrict - определяет поведение при отсутствии подходящей записи соответствия.

FUNCTION AddEntityKeyMap(iRegionID PLS_INTEGER, iSourceID PLS_INTEGER, iEntityID PLS_INTEGER, iExternalID PLS_INTEGER, sExternalName VARCHAR2, iInternalID PLS_INTEGER) RETURN PLS_INTEGER;

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

• iRegionID, iSourceID - ключ источника данных для загрузки;
  
• iEntityID - ID сущности;
  
• iExternalID - ID внешней записи;
  
• sExternalName - наименование внешней записи (опционально);
  
• iInternalID - ID внутренней записи (опционально).
  

Если запись с таким ID внешней записи существует, возникает exception.

PROCEDURE UpdateEntityKeyMap(iRegionID PLS_INTEGER, iMappingID PLS_INTEGER, iEntityID PLS_INTEGER, iExternalID PLS_INTEGER, sExternalName VARCHAR2, iInternalID PLS_INTEGER);

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

• iRegionID, iMappingID - ключ записи соответствия ключей;
  
• iEntityID - ID сущности;
  
• iExternalID - ID внешней записи;
  
• sExternalName - наименование внешней записи (опционально);
  
• iInternalID - ID внутренней записи (опционально).
  

Если запись соответствия ключей не найдена, возникает exception.

FUNCTION SetEntityKeyMap(iRegionID PLS_INTEGER, iSourceID PLS_INTEGER, iEntityID PLS_INTEGER, iExternalID PLS_INTEGER, sExternalName VARCHAR2, iInternalID PLS_INTEGER) RETURN PLS_INTEGER;

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

• iRegionID, iSourceID - ключ источника данных для загрузки;
  
• iEntityID - ID сущности;
  
• iExternalID - ID внешней записи;
  
• sExternalName - наименование внешней записи (опционально);
  
• iInternalID - ID внутренней записи (опционально).

FUNCTION GetPCKeyMapID(iRegionID PLS_INTEGER, iSourceID PLS_INTEGER, iExternalID PLS_INTEGER, iStrict PLS_INTEGER) RETURN PLS_INTEGER;

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

• iRegionID, iSourceID - ключ источника данных для загрузки;
  
• iExternalID - ID внешней записи;
  
• iStrict - определяет поведение при отсутствии подходящей записи соответствия.

FUNCTION AddPCKeyMap(
    iRegionID PLS_INTEGER, iSourceID PLS_INTEGER, iExternalID PLS_INTEGER, iCollClassID PLS_INTEGER,
    sExtLastName VARCHAR2, sExtFirstName VARCHAR2, sExtMiddleName VARCHAR2, dExtBirthDate DATE, iInternalID PLS_INTEGER) RETURN PLS_INTEGER;

Добавляет новую запись соответствия ключей человека/коллектива.
Возвращает ID добавленной записи.
Выполняется в автономной транзакции.
Параметры:

• iRegionID, iSourceID - ключ источника данных для загрузки;
  
• iExternalID - ID внешней записи;
  
• iCollClassID - ID класса коллектива (для человека - null);
  
• sExtLastName - фамилия человека во внешней записи (опционально; для коллектива - null);
  
• sExtFirstName - имя человека во внешней записи (опционально; для коллектива - null);
  
• sExtMiddleName - отчество человека во внешней записи (опционально; для коллектива - null);
  
• dExtBirthDate - дата рождения человека во внешней записи (опционально; для коллектива - null);
  
• iInternalID - ID внутренней записи (опционально).
  

Если запись с таким ID внешней записи существует, возникает exception.

PROCEDURE UpdatePCKeyMap(
    iRegionID PLS_INTEGER, iMappingID PLS_INTEGER, iExternalID PLS_INTEGER, iCollClassID PLS_INTEGER,
    sExtLastName VARCHAR2, sExtFirstName VARCHAR2, sExtMiddleName VARCHAR2, dExtBirthDate DATE, iInternalID PLS_INTEGER);
-- Обновляет существующую или добавляет новую запись соответствия ключей человека/коллектива.
-- Возвращает ID обновлённой или добавленной записи.
-- Добавление или обновление происходит в автономной транзакции.
-- Параметры:
--   iRegionID, iSourceID - ключ источника данных для загрузки;
--   iExternalID          - ID внешней записи;
--   iCollClassID         - ID класса коллектива (для человека - null);
--   sExtLastName         - фамилия человека во внешней записи (опционально; для коллектива - null);
--   sExtFirstName        - имя человека во внешней записи (опционально; для коллектива - null);
--   sExtMiddleName       - отчество человека во внешней записи (опционально; для коллектива - null);
--   dExtBirthDate        - дата рождения человека во внешней записи (опционально; для коллектива - null);
--   iInternalID          - ID внутренней записи (опционально).
FUNCTION  SetPCKeyMap(
    iRegionID PLS_INTEGER, iSourceID PLS_INTEGER, iExternalID PLS_INTEGER, iCollClassID PLS_INTEGER,
    sExtLastName VARCHAR2, sExtFirstName VARCHAR2, sExtMiddleName VARCHAR2, dExtBirthDate DATE, iInternalID PLS_INTEGER) RETURN PLS_INTEGER;

Обновляет существующую запись соответствия ключей человека/коллектива.
Выполняется в автономной транзакции.
Параметры:

• iRegionID, iMappingID - ключ записи соответствия ключей;
  
• iExternalID - ID внешней записи;
  
• iCollClassID - ID класса коллектива (для человека - null);
  
• sExtLastName - фамилия человека во внешней записи (опционально; для коллектива - null);
  
• sExtFirstName - имя человека во внешней записи (опционально; для коллектива - null);
  
• sExtMiddleName - отчество человека во внешней записи (опционально; для коллектива - null);
  
• dExtBirthDate - дата рождения человека во внешней записи (опционально; для коллектива - null);
  
• iInternalID - ID внутренней записи (опционально).
  

Если запись соответствия ключей не найдена, возникает exception.

FUNCTION SetPCKeyMap(
    iRegionID PLS_INTEGER, iSourceID PLS_INTEGER, iExternalID PLS_INTEGER, iCollClassID PLS_INTEGER,
    sExtLastName VARCHAR2, sExtFirstName VARCHAR2, sExtMiddleName VARCHAR2, dExtBirthDate DATE, iInternalID PLS_INTEGER) RETURN PLS_INTEGER;

Обновляет существующую или добавляет новую запись соответствия ключей человека/коллектива.
Возвращает ID обновлённой или добавленной записи.
Добавление или обновление происходит в автономной транзакции.
Параметры:

• iRegionID, iSourceID - ключ источника данных для загрузки;
  
• iExternalID - ID внешней записи;
  
• iCollClassID - ID класса коллектива (для человека - null);
  
• sExtLastName - фамилия человека во внешней записи (опционально; для коллектива - null);
  
• sExtFirstName - имя человека во внешней записи (опционально; для коллектива - null);
  
• sExtMiddleName - отчество человека во внешней записи (опционально; для коллектива - null);
  
• dExtBirthDate - дата рождения человека во внешней записи (опционально; для коллектива - null);
  
• iInternalID - ID внутренней записи (опционально).

FUNCTION GetPDocKeyMapID(iRegionID PLS_INTEGER, iSourceID PLS_INTEGER, iExternalID PLS_INTEGER, iStrict PLS_INTEGER) RETURN PLS_INTEGER;

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

• iRegionID, iSourceID - ключ источника данных для загрузки;
  
• iExternalID - ID внешней записи;
  
• iStrict - определяет поведение при отсутствии подходящей записи соответствия.

FUNCTION AddPDocKeyMap(iRegionID PLS_INTEGER, iSourceID PLS_INTEGER, iExternalID PLS_INTEGER, iPDocClassID PLS_INTEGER, iInternalID PLS_INTEGER) RETURN PLS_INTEGER;

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

• iRegionID, iSourceID - ключ источника данных для загрузки;
  
• iExternalID - ID внешней записи;
  
• iPDocClassID - ID класса персонального документа;
  
• iInternalID - ID внутренней записи (опционально).
  

Если запись с таким ID внешней записи существует, возникает exception.

PROCEDURE UpdatePDocKeyMap(iRegionID PLS_INTEGER, iMappingID PLS_INTEGER, iExternalID PLS_INTEGER, iPDocClassID PLS_INTEGER, iInternalID PLS_INTEGER);

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

• iRegionID, iMappingID - ключ записи соответствия ключей;
  
• iExternalID - ID внешней записи;
  
• iPDocClassID - ID класса персонального документа;
  
• iInternalID - ID внутренней записи (опционально).
  

Если запись соответствия ключей не найдена, возникает exception.

FUNCTION SetPDocKeyMap(iRegionID PLS_INTEGER, iSourceID PLS_INTEGER, iExternalID PLS_INTEGER, iPDocClassID PLS_INTEGER, iInternalID PLS_INTEGER) RETURN PLS_INTEGER;

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

• iRegionID, iSourceID - ключ источника данных для загрузки;
  
• iExternalID - ID внешней записи;
  
• iPDocClassID - ID класса персонального документа;
  
• iInternalID - ID внутренней записи (опционально).

FUNCTION GetFileKeyMapID(iRegionID PLS_INTEGER, iSourceID PLS_INTEGER, iExternalID PLS_INTEGER, iStrict PLS_INTEGER) RETURN PLS_INTEGER;

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

• iRegionID, iSourceID - ключ источника данных для загрузки;
  
• iExternalID - ID внешней записи;
  
• iStrict - определяет поведение при отсутствии подходящей записи соответствия.

FUNCTION AddFileKeyMap(iRegionID PLS_INTEGER, iSourceID PLS_INTEGER, iExternalID PLS_INTEGER, sExternalFileName VARCHAR2, iInternalID PLS_INTEGER) RETURN PLS_INTEGER;

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

• iRegionID, iSourceID - ключ источника данных для загрузки;
  
• iExternalID - ID внешней записи;
  
• sExternalFileName - внешнее имя файла (опционально);
  
• iInternalID - ID внутренней записи (опционально).
  

Если запись с таким ID внешней записи существует, возникает exception.

PROCEDURE UpdateFileKeyMap(iRegionID PLS_INTEGER, iMappingID PLS_INTEGER, iExternalID PLS_INTEGER, sExternalFileName VARCHAR2, iInternalID PLS_INTEGER);

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

• iRegionID, iMappingID - ключ записи соответствия ключей;
  
• iExternalID - ID внешней записи;
  
• sExternalFileName - внешнее имя файла (опционально);
  
• iInternalID - ID внутренней записи (опционально).
  

Если запись соответствия ключей не найдена, возникает exception.

FUNCTION SetFileKeyMap(iRegionID PLS_INTEGER, iSourceID PLS_INTEGER, iExternalID PLS_INTEGER, sExternalFileName VARCHAR2, iInternalID PLS_INTEGER) RETURN PLS_INTEGER;

Обновляет существующую или добавляет новую запись соответствия ключей файла.
Возвращает ID обновлённой или добавленной записи.
Добавление или обновление происходит в автономной транзакции.
Параметры:

• iRegionID, iSourceID - ключ источника данных для загрузки;
  
• iExternalID - ID внешней записи;
  
• sExternalFileName - внешнее имя файла (опционально);
  
• iInternalID - ID внутренней записи (опционально).

PROCEDURE SetPDocReqUsageByEntityKeyMap(iRegionID PLS_INTEGER, iMappingID PLS_INTEGER, iReqClassID PLS_INTEGER);

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

• iRegionID, iMappingID - ключ записи соответствия ключей;
  
• iReqClassID - ID класса реквизита.

PROCEDURE SetPDocReqUsageByPCKeyMap(iRegionID PLS_INTEGER, iMappingID PLS_INTEGER, iReqClassID PLS_INTEGER);

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

• iRegionID, iMappingID - ключ записи соответствия ключей;
  
• iReqClassID - ID класса реквизита.

PROCEDURE SetPDocReqUsageByPDocKeyMap(iRegionID PLS_INTEGER, iMappingID PLS_INTEGER, iReqClassID PLS_INTEGER);

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

• iRegionID, iMappingID - ключ записи соответствия ключей;
  
• iReqClassID - ID класса реквизита.

PROCEDURE SetPDocReqUsageByFileKeyMap(iRegionID PLS_INTEGER, iMappingID PLS_INTEGER, iReqClassID PLS_INTEGER);

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

• iRegionID, iMappingID - ключ записи соответствия ключей;
  
• iReqClassID - ID класса реквизита.

FUNCTION GetIntIDForEntity(
    iRegionID PLS_INTEGER, iSourceID PLS_INTEGER, iEntityID PLS_INTEGER, iExternalID PLS_INTEGER, sExternalName VARCHAR2,
    iStrictExists PLS_INTEGER, iStrictNotNull PLS_INTEGER, iValidationMode PLS_INTEGER, iCreateIfNotExists PLS_INTEGER,
    iReqClassID PLS_INTEGER, iPeopleCollID PLS_INTEGER, iAddUsageForPDocReq PLS_INTEGER) RETURN PLS_INTEGER;

Возвращает ID внутренней записи сущности по ID внешней записи.
Параметры:

• iRegionID, iSourceID - ключ источника данных;
  
• iEntityID - ID сущности;
  
• iExternalID - ID внешней записи;
  
• sExternalName - наименование внешней записи (опционально);
  
• iStrictExists - поведение при отсутствии записи соответствия ключей: 0 - возвращает null; 1 - вызывает exception;
  
• iStrictNotNull - поведение в случае, когда внутренний ID записи соответствия ключей не задан: 0 - возвращает null; 1 - вызывает exception;
  
• iValidationMode - поведение при невалидности значения ID внутренней записи: 0 - не выполнять проверку; 1 - вызывает exception; 2 - возвращает null;
  
• iCreateIfNotExists - создавать ли запись соответствия ключей с пустым внутренним ID, если запись отсутствует (0/1); при этом дальнейшее поведение после создания записи по-прежнему определяется параметром iStrictExists;
  
• iReqClassID - ID класса реквизита, использующегося при проверке валидности значения (если она выполняется); если класс реквизита не задан, проверка валидности выполняется по lookup-списку сущности;
  
• iPeopleCollID - ID человека/коллектива - владельца экземпляра документа, которому принадлежит реквизит; используется только для проверки валидности значения по lookup-списку реквизита, если задан класс реквизита;
  
• iAddUsageForPDocReq - добавлять ли информацию об использовании записи соответствия ключей для данного класса реквизита (0/1); добавление производится независимо от успешности проверок; если iReqClassID не задан, данный параметр игнорируется.

FUNCTION GetIntIDForPC(iRegionID PLS_INTEGER, iSourceID PLS_INTEGER, iExternalID PLS_INTEGER, iStrictExists PLS_INTEGER, iStrictNotNull PLS_INTEGER, iValidationMode PLS_INTEGER) RETURN PLS_INTEGER;

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

• iRegionID, iSourceID - ключ источника данных;
  
• iExternalID - ID внешней записи;
  
• iStrictExists - поведение при отсутствии записи соответствия ключей: 0 - возвращает null; 1 - вызывает exception;
  
• iStrictNotNull - поведение в случае, когда внутренний ID записи соответствия ключей не задан: 0 - возвращает null; 1 - вызывает exception;
  
• iValidationMode - поведение при несоответствии класса коллектива: 0 - не выполнять проверку; 1 - вызывает exception; 2 - возвращает null.

FUNCTION GetExtIDForPC(iRegionID PLS_INTEGER, iSourceID PLS_INTEGER, iInternalID PLS_INTEGER, iStrictExists PLS_INTEGER, iStrictUnique PLS_INTEGER) RETURN PLS_INTEGER;

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

• iRegionID, iSourceID - ключ источника данных;
  
• iInternalID - ID внутренней записи;
  
• iStrictExists - поведение при отсутствии записи соответствия ключей: 0 - возвращает null; 1 - вызывает exception;
  
• iStrictUnique - поведение при неоднозначном соответствии: 0 - возвращает null; 1 - вызывает exception.

FUNCTION GetIntIDForPDoc(iRegionID PLS_INTEGER, iSourceID PLS_INTEGER, iExternalID PLS_INTEGER, iStrictExists PLS_INTEGER, iStrictNotNull PLS_INTEGER, iValidationMode PLS_INTEGER) RETURN PLS_INTEGER;

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

• iRegionID, iSourceID - ключ источника данных;
  
• iExternalID - ID внешней записи;
  
• iStrictExists - поведение при отсутствии записи соответствия ключей: 0 - возвращает null; 1 - вызывает exception;
  
• iStrictNotNull - поведение в случае, когда внутренний ID записи соответствия ключей не задан: 0 - возвращает null; 1 - вызывает exception;
  
• iValidationMode - поведение при несоответствии класса документа: 0 - не выполнять проверку; 1 - вызывает exception; 2 - возвращает null.

FUNCTION GetExtIDForPDoc(iRegionID PLS_INTEGER, iSourceID PLS_INTEGER, iInternalID PLS_INTEGER, iStrictExists PLS_INTEGER, iStrictUnique PLS_INTEGER) RETURN PLS_INTEGER;

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

• iRegionID, iSourceID - ключ источника данных;
  
• iInternalID - ID внутренней записи;
  
• iStrictExists - поведение при отсутствии записи соответствия ключей: 0 - возвращает null; 1 - вызывает exception;
  
• iStrictUnique - поведение при неоднозначном соответствии: 0 - возвращает null; 1 - вызывает exception.

FUNCTION GetIntIDForFile(iRegionID PLS_INTEGER, iSourceID PLS_INTEGER, iExternalID PLS_INTEGER, iStrictExists PLS_INTEGER, iStrictNotNull PLS_INTEGER) RETURN PLS_INTEGER;

Возвращает ID внутренней записи файла по ID внешней записи.
Параметры:

• iRegionID, iSourceID - ключ источника данных;
  
• iExternalID - ID внешней записи;
  
• iStrictExists - поведение при отсутствии записи соответствия ключей: 0 - возвращает null; 1 - вызывает exception;
  
• iStrictNotNull - поведение в случае, когда внутренний ID записи соответствия ключей не задан: 0 - возвращает null; 1 - вызывает exception.

FUNCTION GetExtIDForFile(iRegionID PLS_INTEGER, iSourceID PLS_INTEGER, iInternalID PLS_INTEGER, iStrictExists PLS_INTEGER, iStrictUnique PLS_INTEGER) RETURN PLS_INTEGER;

Возвращает ID внешней записи файла по ID внутренней записи.
Параметры:

• iRegionID, iSourceID - ключ источника данных;
  
• iInternalID - ID внутренней записи;
  
• iStrictExists - поведение при отсутствии записи соответствия ключей: 0 - возвращает null; 1 - вызывает exception;
  
• iStrictUnique - поведение при неоднозначном соответствии: 0 - возвращает null; 1 - вызывает exception.

FUNCTION GetPCXMLDumpImportRuleName(iRegionID PLS_INTEGER, iID PLS_INTEGER, iDisplayMode PLS_INTEGER, iStrict PLS_INTEGER) RETURN VARCHAR2;

Возвращает наименование правил импорта XML-дампа.
Параметры:

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

FUNCTION GetPCXMLDumpImportScriptName(iRegionID PLS_INTEGER, iID PLS_INTEGER, iDisplayMode PLS_INTEGER, iStrict PLS_INTEGER) RETURN VARCHAR2;

Возвращает наименование дополнительного сценария импорта XML-дампа.
Параметры:

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

FUNCTION GetPCXMLDumpImportRules(iRegionID PLS_INTEGER, iRuleID PLS_INTEGER, iStrict PLS_INTEGER) RETURN TPCXMLDumpImportRules;

Загружает из справочника и возвращает правила импорта XML-дампа.
Параметры:

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

FUNCTION ClonePCXMLDumpImportRules(iRegionID PLS_INTEGER, iRuleID PLS_INTEGER, iDestRgnID PLS_INTEGER, iDestFolderRgnID PLS_INTEGER, iDestFolderID PLS_INTEGER, sDestName VARCHAR2) RETURN PLS_INTEGER;

Клонирует правила импорта XML-дампа в заданный район. Возвращает ID добавленных правил.
Параметры:

• iRegionID, iRuleID - ключ клонируемого правила;
  
• iDestRgnID - ID района, в который выполняется клонирование;
  
• iDestFolderRgnID, iDestFolderID - ключ папки, в которую будет помещён клон;
  
• sDestName - наименование клона.

PROCEDURE ImportPCXMLDumpData(
    iRegionID PLS_INTEGER, iSourceID PLS_INTEGER, iRootTagID PLS_INTEGER, Rules IN TPCXMLDumpImportRules,
    iAuditOriginID PLS_INTEGER, sAuditNotes VARCHAR2,
    iServerOpID PLS_INTEGER, hLogFile IN UTL_FILE.file_type, iLogLevel PLS_INTEGER, iLogWarnings PLS_INTEGER);
 
END;
 
/
CREATE OR REPLACE PACKAGE BODY uszn.pkXMLImpPCDump IS
 
-- информация о реквизите, необходимая для определения параметров отображения ключей для него
TYPE TPDocReqMappingInfo IS RECORD(
  -- тип данных реквизита
  iDatatype       PLS_INTEGER,
  -- ID сущности
  iEntityID       PLS_INTEGER,
  -- является ли реквизит slurp-ключом
  iIsSlurpKey     PLS_INTEGER,
  -- является ли реквизит ID районного ключа в листьевом районе
  iIsLeafRgnKeyID PLS_INTEGER,
  -- является ли реквизит ID файла

Импортирует данные из разобранного XML-дампа.
Параметры:

• iRegionID, iSourceID - ключ источника данных для загрузки;
  
• iRootTagID - ID корневого тега, с которого начинается загрузка; поддерживаются следующие корневые теги: collectives - список коллективов; collective - один коллектив persons - список людей (вне коллективов); person - один человек;
  
• Rules - правила загрузки дампа;
  
• iAuditOriginID - ID источника события для аудита;
  
• sAuditNotes - примечания для аудита;
  
• iServerOpID - ID записи задачи (серверной операции);
  
• hLogFile - дескриптор файла протокола;
  
• iLogLevel - уровень вложенности сообщений в файле протокола, на котором будут выводиться информационные сообщения первого уровня;
  
• iLogWarnings - выводить ли в протокол предупреждения (0/1).