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

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

pkXMLImp_General.sql

Работа с метаинформацией

GetMetaInfo

FUNCTION GetMetaInfo(iRootTagID PLS_INTEGER, iStrict PLS_INTEGER) RETURN uszn.pkXML_General.TMetaInfo;

Описание

Загружает из разобранного XML-файла и возвращает метаинформацию.
Параметры:

  • iRootTagID - ID тега, содержащего тег с метаинформацией;
  • iStrict - определяет поведение при отсутствии тега метаинформации.

FormatVersion

FUNCTION FormatVersion(iVersionMajor PLS_INTEGER, iVersionMinor PLS_INTEGER, iVersionRev PLS_INTEGER) RETURN VARCHAR2;

Описание

Форматирует полный номер версии.
Параметры:

  • iVersionMajor - старший номер версии;
  • iVersionMinor - младший номер версии;
  • iVersionRev - номер ревизии.

Возвращает номер в виде ”<major>.<minor>.<rev>”.
Если номер ревизии не задан, он не выводится. Если при этом не задан младший номер версии, он также не выводится.
Недостающие “вышестоящие” номера версий заменяются нулями.

GetExportVersion

FUNCTION GetExportVersion(MetaInfo uszn.pkXML_General.TMetaInfo) RETURN VARCHAR2;

Описание

Возвращает полный номер версии формата файла из метаданных.

LogMetaInfo

PROCEDURE LogMetaInfo(hFile UTL_FILE.File_Type, MetaInfo uszn.pkXML_General.TMetaInfo, bTimeStamp BOOLEAN, iLogLevel PLS_INTEGER);

Описание

Выводит метаинформацию в протокол.
Параметры:

  • hFile - дескриптор файла протокола;
  • MetaInfo - метаинформация;
  • bTimeStamp - если True, нужно писать дату/время;
  • iLogLevel - уровень вложенности (количество добавляемых табуляций).

CheckExportVersion

PROCEDURE CheckExportVersion(
    MetaInfo uszn.pkXML_General.TMetaInfo, sExportTypeName VARCHAR2,
    iMinVersionMajor PLS_INTEGER, iMinVersionMinor PLS_INTEGER, iMinVersionRev PLS_INTEGER,
    iMaxVersionMajor PLS_INTEGER, iMaxVersionMinor PLS_INTEGER, iMaxVersionRev PLS_INTEGER);
 
END;
 
/
CREATE OR REPLACE PACKAGE BODY uszn.pkXMLImp_General IS
 
/********************************************************************************************************************/
FUNCTION GetMetaInfo(iRootTagID PLS_INTEGER, iStrict PLS_INTEGER) RETURN uszn.pkXML_General.TMetaInfo IS
  Result          uszn.pkXML_General.TMetaInfo;

Описание

Проверяет соответствие формата файла экспорта заданным критериям. При несоответствии возникает exception.
Параметры:

  • MetaInfo - метаинформация, из которой берутся текущие номера версии;
  • sExportTypeName - наименование вида экспорта; если не задано, то не анализируется;
  • iMinVersionMajor - старший номер версии минимально допустимого формата;
  • iMinVersionMinor - младший номер версии минимальный допустимого формата;
  • iMinVersionRev - номер ревизии минимальный допустимого формата;
  • iMaxVersionMajor - старший номер версии максимально допустимого формата;
  • iMaxVersionMinor - младший номер версии максимально допустимого формата;
  • iMaxVersionRev - номер ревизии максимально допустимого формата.

Если какие-то из номеров версий не заданы, они не анализируются.
Однако если задан номер ревизии минимально допустимого формата, то отсутствующие младший и старший номера версий
минимально допустимого формата считаются равными 0. Аналогично если задан младший номер версии минимально
допустимого формата, то старший номер считается равным 0, если он не задан.
Те же правила применяются к номерам максимально допустимого формата.
Примеры:
1. iMinVersionMajor=1, iMinVersionMinor=2, iMinVersionRev=3, iMaxVersionMajor=2, iMaxVersionMinor=1, iMaxVersionRev=null:

  • допускаются версии с 1.2.3 до 2.1; если номер версии старше 1.2.3, то независимо от номера ревизии;

2. iMinVersionMajor=null, iMinVersionMinor=2, iMinVersionRev=null, iMaxVersionMajor=1, iMaxVersionMinor=null, iMaxVersionRev=3:

  • допускаются версии с 0.2 до 1.0.3; если номер версии младше 1.0.3, то независимо от номера ревизии.