Native XFA exData XML

De algemene event-host creëert afwezige exData-value-properties en importeert echte foreign XML-kinderen in diens native formulier-occurrences; XHTML-draw-content bereikt de rich text PDF-consumer na native XDP-persistentie en herladen

XML importeren en lezen

const content = row.label.value.exData;
content.contentType = "text/html";
content.loadXML(
  '<body xmlns="http://www.w3.org/1999/xhtml">' +
  '<p><span style="font-size:18pt;color:#0000FF">Changed</span></p>' +
  '</body>',
  false,
  true
);
const currentXML = content.saveXML();
const readableXML = content.saveXML("pretty");

loadXML(source, ignoreRoot=true, overwrite=false) accepteert een welgevormde XML-documentstring en geeft undefined terug; ignoreRoot plakt de kinderen van de aggregerende wortel aan, terwijl false de wortel zelf aanplakt

Overwrite vervangt bestaande content vóór import; diens default false plakt content aan in documentvolgorde, met behoud van eerder geïmporteerde kinderen

saveXML() geeft het huidige exData-element en diens content terug als een UTF-8 XML-declaratie en fragment-string; het optionele letterlijke pretty springt in voor element-only-content terwijl mixed text- en CDATA-whitespace behouden blijven

Geïmporteerde elementnamen, namespace-declaraties, namespace-gekwalificeerde attributes, letterlijke Unicode, character references, mixed text en CDATA blijven native XML; markup wordt niet als een platte rawValue-string opgeslagen

Creëren en defaults

Value-properties staan één exData-kind toe, mutual exclusive met de andere waardekeuzes; een ontbrekende draw-waarde en exData-kind kunnen tijdens hetzelfde event worden aangemaakt en geïmporteerd

exData defaultt naar maxLength=-1 en transferEncoding=none, met lege contentType-, href-, id-, name-, rid-, use- en usehref-attributes

De event-host legt geen scalar-waarde-accessor bloot op exData; gebruik loadXML en saveXML voor foreign XML-content

Directe reads, identiteit en transacties

Een pure native XML-operatie valideert en serialiseert elke request voordat de script-executie verdergaat; misvormde XML gooit binnen het script en kan met try/catch worden afgehandeld zonder de huidige content te wijzigen

De deterministische response-replay deelt de bestaande script-transactie en voert geen UI-, bestands-, netwerk- of transport-zij-effecten uit

Daaropvolgende saveXML-aanroepen zien eerdere geslaagde imports en huidige exData-attributes tijdens hetzelfde event; vastgehouden referenties resolven de huidige node-identiteit in latere events

Alleen de getargete herhaalde occurrence ontvangt native content, en een nieuwe occurrence initialiseert vanuit template-XML in plaats van de geïmporteerde override van een bestaande occurrence te kopiëren

Een geïmporteerde lege wortel met overwrite=true wist de echte content en blijft leeg na persistentie en herladen; hij keert niet terug naar template-content

Niet-afgevangen scriptfouten en native publicatiefalen herstellen exacte native XDP-bytes, inclusief eerdere gewone veld-writes en XML-mutaties

Budgetten en opgeslagen consumptie

Script-limieten begrenzen XML-invoer- en -uitvoer-bytes, native element- en tekstnodes, diepte, operaties, verstreken tijd en replay-responses; widget MaxValueChars begrenst ook de gepubliceerde XML-waarde

De FPC-brug behoudt UTF-8-bytes door XML-responses en gewone action-waarden heen, inclusief tekens met accenten en supplementary Unicode

Opgeslagen XHTML-draw-content gebruikt het bestaande font-, grootte-, kleur- en inline CSS-gedrag van de rich text-consumer; onafhankelijke PDF-readers verifiëren eerste-instance-tekst, vervangings-styling, nieuwe-instance-content en expliciet wissen

Resterende XML-integratiedoelen

Deze levering implementeert exData-content-operaties; andere nodeclass loadXML/saveXML-methodes, structurele Data DOM-import en algemene foreign-node-mutatie blijven aparte doelen

DTD-declaraties en custom entity-catalogi blijven onimplemented; vooraf gedefinieerde entities en decimale of hexadecimale character references worden ondersteund

Comments en processing instructions binnen elementen blijven native door import, directe reads, save, reload en rollback heen; documentniveau-markup buiten de wortel en complete XML-lexicale round trips blijven aparte doelen

Externe href-resolutie, encoded exData-overdrachten, maxLength-afdwinging, foreign media-consumers en Unicode-rich-widget-appearances blijven aparte implementatiedoelen

Referenties en related APIs

Import-wortel- en vervanging-semantics volgen de Adobe XFA Element API; XML-namen, referenties en whitespace volgen XML 1.0

Zie TXFAEventBinding, TXFAEventActionKind, Rich Text Properties en Interactive XFA Runtime