Документация 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
Описание
Перекодирует данные в UTF-8 и преобразует в BLOB.