Przegląd pól

Zwykle pole wstawione do Microsoft Word zawiera już aktualną wartość. Przykładowo, jeżeli polem jest formuła lub numer strony, będzie ona zawierała poprawną obliczoną wartość dla danej wersji dokumentu. Ale jeśli masz aplikację, która generuje lub modyfikuje dokument z polami (na przykład łączy dwa dokumenty lub wypełnia danymi), to aby dokument był użyteczny, idealnie byłoby, gdyby wszystkie pola zostały zaktualizowane.

Pole składa się z:

• Węzły początku pola i separatora służą do objęcia treści tworzącej kod pola (zwykle jako zwykły tekst)
• Separator pola i koniec pola obejmują wynik pola. Może składać się z różnych typów treści, począwszy od ciągów tekstu, przez akapity, aż po tabele.
• Niektóre pola mogą nie mieć separatora, co oznacza, że cała treść stanowi kod pola.
• Kod pola definiuje zachowanie pola i składa się z identyfikatora pola i często innych parametrów, takich jak nazwa pola i przełączniki.
• Wynik pola zawiera najnowszą ocenę pola. Wartość ta jest zapisywana w wyniku pola i jest wyświetlana użytkownikowi. Niektóre pola mogą nie mieć żadnych wyników, dlatego nie będą wyświetlane w dokumencie. Podobnie niektóre pola mogą nie zostać jeszcze zaktualizowane, dlatego też nie będą miały żadnych wyników.

Oto widok przechowywania pola w formacie Aspose.Words na przykładzie “DocumentExplorer”, który można znaleźć w GitHub.

Aspose.Words to biblioteka klas przeznaczona do przetwarzania dokumentów Microsoft Word po stronie serwera i obsługuje pola w następujący sposób:

• Wszystkie pola w dokumencie zostają zachowane podczas otwierania/zapisywania i konwersji.
• Istnieje możliwość aktualizacji wyników niektórych z najpopularniejszych dziedzin.

Pola w Microsoft Word

Pola w dokumentach Microsoft Word są złożone. Istnieje ponad 50 typów pól (każdy wymaga własnej procedury obliczania wyników), formuły i wyrażenia, zakładki i odniesienia, funkcje i różne przełączniki. Pola można także zagnieżdżać. Zwykle po otwarciu dokumentu wynik pola (wartość pola) jest pokazywany dla wszystkich pól w dokumencie. Możesz przełączyć wyświetlanie wyników pól lub kodów pól w Microsoft Word dla wszystkich pól, naciskając ALT+F9.

Kod pola	Wynik pola

Wstawianie pól w Microsoft Word

Aby wstawić pole w formacie Microsoft Word:

1. Kliknij menu Insert.
2. Kliknij menu rozwijane Quick Parts
3. Wybierz Field
4. Pojawia się ekran umożliwiający wprowadzenie szczegółów pola. Po lewej stronie znajduje się lista możliwych pól, a po prawej stronie znajduje się ekran umożliwiający wizualną edycję właściwości pola.
   
5. Dodatkowo możesz nacisnąć przycisk Field Codes, który umożliwia bezpośrednie wpisanie kodu pola.
   
6. Przełączniki można wstawić także za pomocą przycisku Options
   
7. Za pomocą dowolnej metody wypełnij żądane pola odpowiednimi informacjami, a następnie naciśnij Ok.
8. Pole wstawiane jest do dokumentu w aktualnej pozycji kursora.
   

Aktualizacja pól w Microsoft Word

Aby zaktualizować pojedyncze pole w Microsoft Word:

1. Przesuń kursor w pole, które chcesz zaktualizować.
2. Naciśnij F9, aby zaktualizować pole.

Aby zaktualizować wszystkie pola w Microsoft Word:

1. Naciśnij Ctrl+A, aby zaznaczyć całą zawartość dokumentu.
2. Naciśnij F9, aby zaktualizować wszystkie pola znalezione w ramach zaznaczenia.

Przełączanie między wyświetlaniem kodu pola a wynikiem pola

Aby przełączyć kody pól pojedynczego pola w Microsoft Word:

1. Przesuń kursor w żądane pole.
2. Naciśnij SHIFT+F9, aby przełączyć kod pola tylko dla tego pola.

Aby przełączyć kody pól wszystkich pól w Microsoft Word:

1. Naciśnij ALT+F9

Konwersja pól na tekst statyczny w Microsoft Word

Aby przekonwertować pole dynamiczne na tekst statyczny w formacie Microsoft Word:

1. Przesuń kursor w pole, które chcesz przekonwertować.
2. Naciśnij Ctrl+Shift+F9, aby przekonwertować pola na tekst statyczny.

Usuwanie pola w Microsoft Word

Aby usunąć pole w Microsoft Word:

1. Wybierz całą treść tworzącą pole. Jeśli wyświetlane są kody pól, należy również wybrać nawiasy otwierające i końcowe.
2. Naciśnij Delete, aby usunąć całe pole.

Pola w Aspose.Words

Kiedy dokument jest ładowany do Aspose.Words, pola dokumentu są ładowane do Aspose.Words Document Object Model jako zestaw oddzielnych komponentów (węzłów). Pojedyncze pole jest ładowane jako zbiór węzłów FieldStart, FieldSeparator i FieldEnd wraz z zawartością pomiędzy tymi węzłami. Jeśli pole nie ma wyniku w postaci pola, nie będzie węzła FieldSeparator. Wszystkie te węzły zawsze znajdują się w linii (jako elementy podrzędne Paragraph lub SmartTag.

Treść tworząca kod pola jest przechowywana jako węzły Run pomiędzy FieldStart i FieldSeparator. Wynik pola jest przechowywany pomiędzy węzłami FieldSeparator i FieldEnd i może składać się z różnych typów treści. Zwykle wynik pola zawiera tylko tekst składający się z węzłów Run, jednak możliwe jest, że węzeł FieldEnd zostanie umieszczony w zupełnie innym akapicie, co spowoduje, że wynik pola będzie składał się również z węzłów na poziomie bloków, takich jak węzły Table i Paragraph.

W Aspose.Words każdy z węzłów FieldXXX pochodzi z formatu FieldChar. Ta klasa udostępnia właściwość umożliwiającą sprawdzanie typu pola reprezentowanego przez określony węzeł za pomocą właściwości FieldChar.field_type. Na przykład FieldType.FIELD_MERGE_FIELD reprezentuje pole scalania w dokumencie.

W dokumencie programu Word istnieją pewne szczególne pola, które nie są importowane do Aspose.Words jako zbiór węzłów FieldXXX. Na przykład pole LINK i pole INCLUDEPICTURE są importowane do Aspose.Words jako obiekt Shape. Obiekt ten zapewnia właściwości umożliwiające pracę z danymi obrazu zwykle przechowywanymi w tych polach.

Pola formularzy są również importowane do Aspose.Words jako osobna klasa specjalna. Klasa FormField reprezentuje pole formularza w dokumencie programu Word i udostępnia dodatkowe metody specyficzne dla pola formularza.

Pola obsługiwane podczas aktualizacji

W aktualnej wersji Aspose.Words obsługiwane jest obliczanie następujących pól:

• = (pole formuły)
• ADDRESSBLOCK
• AUTHOR
• COMPARE
• CREATEDATE
• DATE
• DOCPROPERTY
• DOCVARIABLE
• GREETINGLINE
• IF
• INCLUDETEXT
• MERGEFIELD
• MERGEREC
• MERGESEQ
• NEXT
• NEXTIF
• NUMPAGES
• PAGE
• PAGEREF
• REF
• SECTION
• SECTIONPAGES
• SEQ
• SET
• STYLEREF
• TIME
• TITLE
• TOA
• TOC (w tym TOT i TOF) -TC

Wyrafinowane parsowanie

Aspose.Words podąża za sposobem, w jaki Microsoft Word przetwarza pola, dzięki czemu poprawnie obsługuje:

• Pola zagnieżdżone : IF { =OR({ COMPARE { =2.5 +PRODUCT(3,5 ,8.4) } > 4}, { =2/2 }) } = 1 "Credit not acceptable" "Credit acceptable"
• Argument pola może być wynikiem pola zagnieżdżonego.
• Pola można zagnieżdżać w kodzie pola, jak również w wyniku pola.
• Spacje/bez spacji, cudzysłowy/bez cudzysłowów, znaki ucieczki w polach itp.: MERGEFIELD \f"Text after""Field \n\ame with \" and \\\ and \\\*"\bTextBefor\e
• Pola obejmujące wiele akapitów.

Pola formuł

Aspose.Words zapewnia bardzo poważną implementację silnika formuł i obsługuje następujące elementy:

• Operatory arytmetyczne i logiczne: =(54+4*(6-77)-(5))+(-6-5)/4/5
• Funkcje: =ABS(-01.4)+2.645/(5.6^3.5)+776457 \\\# "#,##0"
• Odniesienia do zakładek: =IF(C>4, 5,ABS(A)*.76) +3.85
• Przełączniki formatowania liczb: =00000000 \\\# "$#,##0.00;($#,##0.00)"

Obsługiwane są następujące funkcje w wyrażeniach: ABS, AND, AVERAGE, COUNT, DEFINED, FALSE, IF, INT, MAX, MIN, MOD, NOT, OR, PRODUCT, ROUND, SIGN, SUM, TRUE.

Pola IF i COMPARE

Tylko niektóre wyrażenia IF, które Aspose.Words może łatwo obliczyć, powinny dać ci wyobrażenie o tym, jak potężna jest ta funkcja:

• 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

Pola DATE i TIME

Aspose.Words obsługuje wszystkie przełączniki formatowania daty i godziny dostępne w formacie Microsoft Word, niektóre przykłady to:

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

Pola Mail Merge

Aspose.Words nie nakłada żadnych ograniczeń na złożoność pól mail merge w dokumentach i obsługuje zagnieżdżone pola IF i formuły, a nawet może obliczyć nazwę pola scalania za pomocą formuły.

Kilka przykładów pól mail merge obsługiwanych przez Aspose.Words:

• Przełączniki polowe Mail merge: MERGEFIELD FirstName \\\\\\\\* FirstCap \b "Mr. "
• Zagnieżdżone pola scalania w formule: IF { MERGEFIELDValue1 } >= {MERGEFIELD Value2 } True False
• Oblicz nazwę pola scalania w czasie wykonywania: MERGEFIELD { IFF{MERGEFIELDValue1 } >= {MERGEFIELD Value2 } FirstName"LastName" }
• Warunkowe przejście do następnego rekordu w źródle danych: NEXTIF { MERGEFIELDValue1 } <= { =IF(-2.45 >= 6*{MERGEFIELD Value2 }, 2, -.45) }

Formatuj przełączniki

Pole w dokumencie może mieć przełączniki formatowania, które określają sposób formatowania wartości wynikowej. Aspose.Words obsługuje następujące przełączniki formatu:

• @ - formatowanie daty i godziny
• \# - formatowanie liczb
• \\\\* Czapki
• \\\\* FirstCap
• \\\\* Niżej
• \\\\* Górna
• \\\\* CHARFORMAT – formatuj wynik według pierwszego znaku kodu pola.
• \\\\* MERGEFORMAT – sformatuj wynik zgodnie ze sposobem formatowania starego wyniku.

Date i formatowanie liczb w polach

Kiedy Aspose.Words oblicza wynik pola, często musi przeanalizować ciąg znaków na liczbę lub wartość daty, a także sformatować go z powrotem na ciąg znaków. Domyślnie Aspose.Words używa bieżącej kultury wątku do przeprowadzania analizy i formatowania podczas obliczania wartości pól podczas aktualizacji pola i mail merge. Dostępne są również opcje w postaci klasy FieldOptions, które pozwalają na dalszą kontrolę nad tym, która kultura jest używana podczas aktualizacji pola.

• Domyślnie właściwość FieldOptions.field_update_culture_source jest ustawiona na FieldUpdateCultureSource.CURRENT_THREAD, która formatuje pola przy użyciu bieżącej kultury wątku.
• Tę właściwość można ustawić na FieldUpdateCultureSource.FIELD_CODE, aby zamiast tego do formatowania używany był język ustawiony na podstawie kodu pola.

Formatowanie przy użyciu kultury bieżącego wątku

Aby kontrolować kulturę używaną podczas obliczania pola, wystarczy użyć metody locale.setlocale w celu ustawienia wybranej kultury przed wywołaniem obliczeń pola. Poniższy przykład pokazuje, jak zmienić kulturę używaną w formatowaniu pól podczas aktualizacji.

Użycie bieżącej kultury do formatowania pól umożliwia systemowi łatwe i spójne kontrolowanie sposobu formatowania wszystkich pól w dokumencie podczas aktualizacji pól.

Formatowanie przy użyciu kultury w dokumencie

Z drugiej strony Microsoft Word formatuje każde pole w oparciu o język tekstu znalezionego w polu (w szczególności kod pola). Czasami podczas aktualizacji pola może to być pożądane zachowanie, na przykład jeśli masz zglobalizowane dokumenty zawierające treść złożoną z wielu różnych języków i chcesz, aby każde pole honorowało ustawienia regionalne użyte w tekście. Aspose.Words obsługuje również tę funkcję.

Klasa Document udostępnia właściwość field_options zawierającą elementy, których można używać do kontrolowania sposobu aktualizowania pól w dokumencie. Poniższy przykład pokazuje, jak określić, skąd zostanie wybrana kultura używana do formatowania daty podczas aktualizacji pola i mail merge.

Znajdowanie kodu pola i wyniku pola

Pole wstawione za pomocą DocumentBuilder.insert_field zwraca obiekt Field. Jest to klasa fasady, która udostępnia przydatne metody szybkiego znajdowania takich właściwości pola. Uwaga, jeśli szukasz tylko nazw pól scalania w dokumencie, możesz zamiast tego użyć wbudowanej metody MailMerge.get_field_names. Poniższy przykład pokazuje, jak uzyskać nazwy wszystkich pól scalania w dokumencie.

Jak zmienić nazwę pola scalania

Poniższy przykład pokazuje, jak zmienić nazwę pól scalania w dokumencie programu Word.