Přehled Polí

Aspose.Words je knihovna tříd určená pro zpracování dokumentů Microsoft Word na straně serveru a podporuje pole následujícími způsoby:

  • všechna pole v dokumentu jsou zachována během otevření / uložení a konverzí
  • je možné aktualizovat výsledky většiny polí

V tomto článku se dozvíme více o struktuře pole, polích podporovaných v Aspose.Words a podrobnostech práce s takovými poli.

Struktura Polí

Pole se skládá z:

  • Počáteční a oddělovací uzly pole se používají k zahrnutí obsahu, který tvoří kód pole (obvykle jako prostý text).
  • Oddělovač pole a konec pole zahrnují výsledek pole. To může být tvořeno různými typy obsahu od běhů textu přes odstavce až po tabulky.
  • Některá pole nemusí mít oddělovač, což znamená, že celý obsah tvoří kód pole.
  • Kód pole definuje chování pole a skládá se z identifikátoru pole a často dalších parametrů, jako jsou názvy polí a přepínače.
  • Výsledek pole obsahuje nejnovější vyhodnocení pole. Tato hodnota je uložena v poli výsledek a je to, co se uživateli zobrazí. Některá pole nemusí mít žádné výsledky pole, takže v dokumentu nic nezobrazí. Stejně tak některá pole nemusí být aktualizována, proto také nebudou mít žádný výsledek pole.

fields-overview-aspose-words-cpp-1

Obsah, který tvoří kód pole, je uložen jako Run uzly mezi FieldStart a FieldSeparator. Výsledek pole je uložen mezi uzly FieldSeparator a FieldEnd a může být tvořen různými typy obsahu. Normálně výsledek pole obsahuje pouze text složený z uzlů Run, je však možné, že uzel FieldEnd bude umístěn ve zcela jiném odstavci, a tak bude výsledek pole složen z uzly na úrovni bloku například Table a Paragraph uzly také.

Zde je pohled na to, jak je pole uloženo v Aspose.Words pomocí příkladu “DocumentExplorer”.

fields-overview-aspose-words-cpp-2

Pole v modelu objektu Aspose.Words dokumentu (DOM)

Když je dokument načten do Aspose.Words, pole dokumentu se načtou do Aspose.Words Model Objektu Dokumentu jako sada samostatných komponent (uzlů). Jedno pole je načteno jako kolekce uzlů FieldStart, FieldSeparator a FieldEnd spolu s obsahem mezi těmito uzly. Pokud pole nemá výsledek pole, nebude zde žádný FieldSeparator uzel. Všechny tyto uzly se vždy nacházejí inline (jako děti Paragraph nebo SmartTag).

V Aspose.Words každý z uzlů FieldXXX pochází z FieldChar. Tato třída poskytuje vlastnost pro kontrolu typu pole reprezentovaného zadaným uzlem pomocí vlastnosti FieldType. Například FieldType.FieldMergeField představuje pole sloučení v dokumentu.

Podporovaná Pole

Výpočet následujících polí je podporován v aktuální verzi Aspose.Words:

  • = (vzorec)
  • ADDRESSBLOCK
  • ASK
  • AUTHOR
  • AUTONUM
  • AUTONUMLGL
  • AUTONUMOUT
  • AUTOTEXT
  • BARCODE
  • COMMENTS
  • COMPARE
  • CREATEDATE
  • DATABASE
  • DATE
  • DISPLAYBARCODE
  • DOCPROPERTY
  • DOCVARIABLE
  • EDITTIME
  • EQ
  • FILENAME
  • FILESIZE
  • FILLIN
  • FORMCHECKBOX
  • FORMDROPDOWN
  • FORMTEXT
  • GLOSSARY
  • GOTOBUTTON
  • GREETINGLINE
  • HYPERLINK
  • IF
  • IMPORT
  • INCLUDE
  • INCLUDEPICTURE
  • INCLUDETEXT
  • INDEX
  • INFO
  • KEYWORDS
  • LASTSAVEDBY
  • LISTNUM
  • MACROBUTTON
  • MERGEBARCODE
  • MERGEFIELD
  • MERGEREC
  • MERGESEQ
  • NEXT
  • NEXTIF
  • NOTEREF
  • NUMCHARS
  • NUMPAGES
  • NUMWORDS
  • PAGE
  • PAGEREF
  • PRINTDATE
  • QUOTE
  • REF
  • REVNUM
  • SAVEDATE
  • SECTION
  • SECTIONPAGES
  • SEQ
  • SET
  • SHAPE
  • SKIPIF
  • STYLEREF
  • SUBJECT
  • SYMBOL
  • TEMPLATE
  • TIME
  • TITLE
  • TOA
  • TOC
  • USERADDRESS
  • USERINITIALS
  • USERNAME

Sofistikovaná Analýza Pole

Aspose.Words sleduje způsob, jakým Microsoft Word zpracovává pole a ve výsledku správně zpracovává:

  • vnořená pole: IF { =OR({ COMPARE { =2.5 +PRODUCT(3,5 ,8.4) } > 4}, { =2/2 }) } = 1 "Credit not acceptable" "Credit acceptable"
  • argument pole může být výsledkem vnořeného pole
  • pole lze vnořit do kódu pole i do výsledku pole
  • mezery / žádné mezery, uvozovky / žádné uvozovky, únikové znaky v polích atd.: MERGEFIELD \f"Text after""Field \n\ame with \" and \\\ and \\\*"\bTextBefor\e
  • pole, která pokrývají více odstavců

Pole Vzorců

Aspose.Words poskytuje velmi seriózní implementaci formula engine a podporuje následující:

  • aritmetické a logické operátory: =(54+4*(6-77)-(5))+(-6-5)/4/5
  • funkce: =ABS(-01.4)+2.645/(5.6^3.5)+776457 \\\# "#,##0"
  • odkazy na záložky: =IF(C>4, 5,ABS(A)*.76) +3.85
  • přepínače formátování čísel: =00000000 \\\# "$#,##0.00;($#,##0.00)"

Jsou podporovány následující funkce ve výrazech: ABS, AND, AVERAGE, COUNT, DEFINED, FALSE, IF, INT, MAX, MIN, MOD, NOT, OR, PRODUCT, ROUND, SIGN, SUM, TRUE.

IF and COMPARE Fields

Jen některé z výrazů IF, které Aspose.Words lze snadno vypočítat, by vám měly poskytnout představu o tom, jak mocná je tato funkce:

  • IF 3 > 5.7^4+MAX(4,3) True False
  • IF "abcd" > "abc" True False
  • IF "?ab*" = "1abdsg" True False
  • IF 4 = "2*2" True False
  • COMPARE 3+5/34 < 4.6/3/2

DATE and TIME Fields

Aspose.Words podporuje všechny přepínače formátování data a času dostupné v Microsoft Word, některé příklady jsou:

  • DATE @ "d-MMM-yy"
  • DATE @ "d/MM/yyyy h:mm am/pm

Mail Merge pole

Aspose.Words neomezuje složitost polí Mail Merge ve vašich dokumentech a podporuje vnořená pole IF a vzorce a může dokonce vypočítat název slučovacího pole pomocí vzorce.

Některé příklady Mail Merge polí, které Aspose.Words podporuje:

  • Mail merge přepínače polí: MERGEFIELD FirstName \\\\\\\\* FirstCap \b "Mr. "
  • vnořená slučovací pole ve vzorci: IF { MERGEFIELDValue1 } >= {MERGEFIELD Value2 } True False
  • Vypočítejte název pole sloučení za běhu: MERGEFIELD { IF{MERGEFIELDValue1 } >= {MERGEFIELD Value2 } FirstName"LastName" }
  • podmíněný přesun na další záznam ve zdroji dat: NEXTIF { MERGEFIELDValue1 } <= { =IF(-2.45 >= 6*{MERGEFIELD Value2 }, 2, -.45) }

Přepínače Formátu

Pole v dokumentu může obsahovat přepínače formátování, které určují, jak má být výsledná hodnota naformátována. Aspose.Words podporuje následující přepínače formátu:

  • @ - formátování data a času
  • \# - formátování čísel
  • \\\\* Caps
  • \\\\* FirstCap
  • \\\\* Lower
  • \\\\* Upper
  • \\\\* CHARFORMAT - formát výsledku podle prvního znaku kódu pole
  • \\\\* MERGEFORMAT - formátovat výsledek podle toho, jak se formátuje Starý výsledek

Formátování data a čísla v polích

Když Aspose.Words vypočítá výsledek pole, často potřebuje analyzovat řetězec na hodnotu čísla nebo data a také jej naformátovat zpět na string.By výchozí Aspose.Words používá aktuální kulturu podprocesu k provádění analýzy a formátování při výpočtu hodnot polí během aktualizace polí a mail merge. K dispozici jsou také možnosti ve formě třídy FieldOptions, která umožňuje další kontrolu nad tím, která kultura se používá během aktualizace pole.

  • ve výchozím nastavení je vlastnost FieldUpdateCultureSource nastavena na CurrentThread, která formátuje pole pomocí aktuální kultury vláken
  • tuto vlastnost lze nastavit na FieldCode, takže pro formátování se místo toho použije jazyk nastavený z kódu pole pole

Formátování pomocí kultury aktuálního vlákna

Chcete-li ovládat kulturu použitou při výpočtu pole, stačí před vyvoláním výpočtu pole nastavit vlastnost CurrentCulture na kulturu podle vašeho výběru.

Následující příklad kódu ukazuje, jak změnit kulturu použitou ve formátovacích polích během aktualizace:

EXAMPLE

Použití aktuální kultury k formátování polí umožňuje systému snadno a důsledně řídit, jak jsou všechna pole v dokumentu formátována během aktualizace polí.

Formátování pomocí kultury v dokumentu

Na druhou stranu Microsoft Word formátuje každé jednotlivé pole na základě jazyka textu nalezeného v poli (konkrétně běhů z kódu pole). Někdy během aktualizace pole to může být požadované chování, například pokud máte globalizované dokumenty obsahující obsah složený z mnoha různých jazyků a chcete, aby každá pole ctila národní prostředí použité z textu. Aspose.Words tuto funkci také podporuje.

Třída Document poskytuje vlastnost FieldOptions, která obsahuje členy, které lze použít k řízení aktualizace polí v dokumentu.

Následující příklad kódu ukazuje, jak určit, kde je vybrána kultura použitá pro formátování data během aktualizace pole a Mail Merge:

EXAMPLE

Vložte pole do C++