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

pkXMLUtils.sql

Преобразования значений

StrToGUID

FUNCTION StrToGUID(sGUID VARCHAR2, iStrict PLS_INTEGER := 1) RETURN RAW deterministic;

Описание

Преобразует GUID из текстового формата в виде 'e041a7d1-b7fc-46c0-a36d-bb6eef8aeb61' к Raw. Если преобразование невозможно, поведение определяется параметром iStrict.

GUIDToStr

FUNCTION GUIDToStr(rGUID RAW, iLower PLS_INTEGER := 1) RETURN VARCHAR2 deterministic;

Описание

Преобразует GUID из RAW-формата в текстовое представление.
Параметры:

  • rGUID - преобразуемое значение;
  • iLower - переводить символы в нижний регистр (1) или в верхний (0).

При обнаружении ошибки в значении rGUID вызывает exception.

Получение специальных значений тегов и атрибутов

GetTagValueGUIDByName

FUNCTION GetTagValueGUIDByName(iOwnerTagID PLS_INTEGER, sTagName VARCHAR2, iStrict PLS_INTEGER := 0) RETURN RAW;

Описание

Возвращает значение тега с указанным именем, приведённое к GUID,из разобранных XML-данных.
Параметры:

  • iOwnerTagID - id родительского тега; null - поиск среди дочерних элементов корневого тега; если значение отрицательно, поиск производится по всей таблице без учёта родительского тега;
  • sTagName - наименование искомого тега (без учёта регистра символов);
  • iStrict - определяет поведение при отсутствии тега с таким наименованием или наличии более одного тега с разными значениями.

Если значение тега имеется, но некорректно, возникает exception.

GetNSTagValueGUIDByName

FUNCTION GetNSTagValueGUIDByName(iOwnerTagID PLS_INTEGER, sNSURI VARCHAR2, sTagName VARCHAR2, iStrict PLS_INTEGER := 0) RETURN RAW;

Описание

Возвращает значение тега с указанным именем с учётом пространства имён, приведённое к GUID,из разобранных
XML-данных.
Параметры:

  • iOwnerTagID - id родительского тега; null - поиск среди дочерних элементов корневого тега; если значение отрицательно, поиск производится по всей таблице без учёта родительского тега;
  • sNSURI - значение URI пространства имён;
  • sTagName - наименование искомого тега (без учёта регистра символов);
  • iStrict - определяет поведение при отсутствии тега с таким наименованием или наличии более одного тега с разными значениями.

Если значение тега имеется, но некорректно, возникает exception.

GetAttribValueGUIDByName

FUNCTION GetAttribValueGUIDByName(iOwnerTagID PLS_INTEGER, sAttribName VARCHAR2, iStrict PLS_INTEGER := 0, iStrictValue PLS_INTEGER := 0, iCaseAware PLS_INTEGER := 0) RETURN RAW;

Описание

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

  • iOwnerTagID - id родительского тега; если значение отрицательно, поиск производится по всей таблице без учёта тега-владельца;
  • sAttribName - наименование искомого атрибута (без учёта регистра символов);
  • iStrict - определяет поведение при отсутствии атрибута с таким наименованием или наличии более одного атрибута с разными значениями;
  • iStrictValue - определяет поведение в том случае, если значение атрибута не удаётся привести к GUID;
  • iCaseAware - учитывать ли регистр символов в имени атрибута (0/1).

GetNSAttribValueGUIDByName

FUNCTION GetNSAttribValueGUIDByName(iOwnerTagID PLS_INTEGER, sNSURI VARCHAR2, sAttribName VARCHAR2, iStrict PLS_INTEGER := 0, iStrictValue PLS_INTEGER := 0, iCaseAware PLS_INTEGER := 0) RETURN RAW;

Описание

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

  • iOwnerTagID - id родительского тега; если значение отрицательно, поиск производится по всей таблице без учёта тега-владельца;
  • sNSURI - значение URI пространства имён;
  • sAttribName - наименование искомого атрибута (без учёта регистра символов);
  • iStrict - определяет поведение при отсутствии атрибута с таким наименованием или наличии более одного атрибута с разными значениями;
  • iStrictValue - определяет поведение в том случае, если значение атрибута не удаётся привести к GUID;
  • iCaseAware - учитывать ли регистр символов в имени атрибута (0/1).

Разное

PrepareUTF8Data

FUNCTION PrepareUTF8Data(cData CLOB) RETURN BLOB;

Описание

Перекодирует данные в UTF-8 и преобразует в BLOB.