GetXFAFormFieldValue

Поля форм

Описание

Возвращает значение указанного поля формы XFA. Имя поля — относительный путь данных либо стандартный SOM-путь данных, начинающийся с $data, xfa.datasets.data или $record. В пакетах без обработки записей $record разрешается от внешнего элемента записи данных под $data. Селекторы классов Data DOM #dataGroup и #dataValue выбирают групповые или скалярные узлы данных по классу с числовыми или wildcard-селекторами вхождений. Простые предикатные селекторы в духе FormCalc вроде $data.Receipt.Detail.[Total_Price > 200].Description выбирают совпадающие соседние узлы по скалярному значению потомка. Полные пакеты XDP принимаются, если пакет datasets содержит xfa:data или непрефиксованный элемент data. Узлы данных сопоставляются по локальному имени XML, поэтому бизнес-элементы могут иметь свой префикс пространства имён. API значений datasets принимают и SOM-свойство parent, поднимающееся от выбранного узла к контейнеру перед чтением соседа, например $data.Receipt.Detail[1].parent.Tax. Селекторы потомков вроде $data..Total_Price разрешают первый совпавший узел ниже текущей области datasets, а child wildcard-селекторы вроде $data.Receipt.*.Total_Price возвращают совпадения под каждой прямой веткой-потомком

Синтаксис

Delphi

Function TPDFlib.GetXFAFormFieldValue(Const XFAFieldName: WideString): WideString;

ActiveX

Function PDFlib::GetXFAFormFieldValue(XFAFieldName As String) As String

DLL

const wchar_t * DLGetXFAFormFieldValue(int InstanceID, const wchar_t * XFAFieldName);

Параметры

XFAFieldName Имя обрабатываемого поля datasets XFA; принимает относительные пути полей и SOM-корни $data..., xfa.datasets.data..., !data... и $record... с разделителями-точками или слэшами до или после корня. В путях со слэшами точки сохраняются буквально, точечные SOM-пути допускают экранированные точки вроде Line\.Item, повторяющиеся узлы выбираются путями с [*] вроде $data.Receipt.Detail[*].Total_Price, parent поднимается к родителю выбранного узла до продолжения пути, селекторы классов вроде #dataGroup и #dataValue адресуют группы и скаляры Data DOM, простые предикатные селекторы вроде .[Total_Price > 200] фильтруют соседние узлы по скалярному значению потомка, селекторы потомков вроде $data..Total_Price ищут ниже текущей области datasets, а child wildcard-селекторы вроде $data.Receipt.*.Total_Price ищут под каждой прямой веткой-потомком

XFAFieldName	Имя обрабатываемого поля datasets XFA; принимает относительные пути полей и SOM-корни `$data...`, `xfa.datasets.data...`, `!data...` и `$record...` с разделителями-точками или слэшами до или после корня. В путях со слэшами точки сохраняются буквально, точечные SOM-пути допускают экранированные точки вроде `Line\.Item`, повторяющиеся узлы выбираются путями с `[]` вроде `$data.Receipt.Detail[].Total_Price`, `parent` поднимается к родителю выбранного узла до продолжения пути, селекторы классов вроде `#dataGroup` и `#dataValue` адресуют группы и скаляры Data DOM, простые предикатные селекторы вроде `.[Total_Price > 200]` фильтруют соседние узлы по скалярному значению потомка, селекторы потомков вроде `$data..Total_Price` ищут ниже текущей области datasets, а child wildcard-селекторы вроде `$data.Receipt.*.Total_Price` ищут под каждой прямой веткой-потомком