フィールドの概要

通常、フィールドは、Microsoft Word に挿入されると、すでに最新の値が含まれています。たとえば、フィールドが数式またはページ番号である場合、そのフィールドには、ドキュメントの特定のバージョンに対して正しく計算された値が含まれます。ただし、フィールドを含むドキュメントを生成または変更する (たとえば、2 つのドキュメントを結合したり、データを入力したりする) アプリケーションがある場合、ドキュメントを有効にするには、理想的にはすべてのフィールドを更新する必要があります。

フィールドは次のもので構成されます。

fields-aspose-words

フィールド開始ノードと区切りノードは、フィールドコードを構成するコンテンツ (通常はプレーンテキストとして) を包含するために使用されます。
フィールド区切り文字とフィールド末尾はフィールド結果を囲みます。これは、一連のテキストから段落、表に至るまで、さまざまなタイプのコンテンツで構成されます。
一部のフィールドには区切り文字がない場合があります。つまり、コンテンツ全体がフィールドコードを構成します。
フィールドコードはフィールドの動作を定義し、フィールド識別子と、多くの場合フィールド名やスイッチなどの他のパラメータで構成されます。
フィールドの結果には、フィールドの最新の評価が含まれます。この値はフィールド結果に保存され、ユーザーに表示されます。一部のフィールドにはフィールド結果がない場合があるため、ドキュメントには何も表示されません。同様に、一部のフィールドはまだ更新されていない可能性があるため、フィールド結果もありません。

ここでは、ギットハブにある「DocumentExplorer」 の例を使用して、フィールドが Aspose.Words にどのように保存されるかを示します。

document-explorer-aspose-words

Aspose.Words は、Microsoft Word ドキュメントのサーバー側処理用に設計されたクラスライブラリであり、次の方法でフィールドをサポートします。

ドキュメント内のすべてのフィールドは、開く/保存するとき、および変換中に保持されます。
最も人気のある分野のいくつかの結果を更新することが可能です。

Microsoft Word のフィールド

Microsoft Word ドキュメントのフィールドは複雑です。 50 を超えるフィールドタイプ (それぞれに独自の結果計算手順が必要)、数式と式、ブックマークと参照、関数、およびさまざまなスイッチがあります。フィールドはネストすることもできます。通常、ドキュメントを開くと、ドキュメント内のすべてのフィールドのフィールド結果 (フィールドの値) が表示されます。 ALT+F9 を押すと、Microsoft Word ですべてのフィールドのフィールド結果またはフィールドコードの表示を切り替えることができます。

フィールドコード	フィールドの結果

Microsoft Word へのフィールドの挿入

Microsoft Word にフィールドを挿入するには:

[Insert] メニューをクリックします。
[Quick Parts] ドロップダウンメニューをクリックします。 1.Fieldを選択します
フィールドの詳細を入力する画面が表示されます。左側には使用可能なフィールドのリストが表示され、右側にはフィールドのプロパティを視覚的に編集するための画面が表示されます。
さらに、Field Codes ボタンを押すと、フィールドコードを直接書き出すことができます。
Optionsボタンを使用してスイッチを挿入することもできます
いずれかの方法を使用して、必要なフィールドに適切な情報を入力し、Ok を押します。
フィールドが文書内の現在のカーソル位置に挿入されます。

Microsoft Word のフィールドの更新

Microsoft Word の単一フィールドを更新するには:

更新するフィールドにキャレットを移動します。
F9 を押してフィールドを更新します。

Microsoft Word のすべてのフィールドを更新するには:

Ctrl+A を押して、ドキュメント内のすべてのコンテンツを選択します。
F9 を押して、選択範囲内にあるすべてのフィールドを更新します。

フィールドコードとフィールド結果の表示を切り替える

Microsoft Word の単一フィールドのフィールドコードを切り替えるには:

キャレットを目的のフィールドに移動します。
SHIFT+F9 を押して、このフィールドだけのフィールドコードを切り替えます。

Microsoft Word のすべてのフィールドのフィールドコードを切り替えるには:

1.ALT+F9を押します

Microsoft Word でのフィールドの静的テキストへの変換

Microsoft Word で動的フィールドを静的テキストに変換するには:

変換するフィールドにキャレットを移動します。
Ctrl+Shift+F9 を押してフィールドを静的テキストに変換します。

Microsoft Word でのフィールドの削除

Microsoft Word でフィールドを削除するには:

フィールドを構成するコンテンツ全体を選択します。フィールドコードが表示されている場合は、開始中括弧と終了中括弧も選択する必要があります。
Delete を押してフィールド全体を削除します。

Aspose.Words のフィールド

ドキュメントが Aspose.Words にロードされると、ドキュメントのフィールドが個別のコンポーネント (ノード) のセットとして Aspose.Words Document Object Model にロードされます。単一のフィールドは、FieldStart、FieldSeparator、および FieldEnd ノードのコレクションとして、これらのノード間のコンテンツとともにロードされます。フィールドにフィールド結果がない場合、FieldSeparator ノードは存在しません。これらのノードはすべて、常にインラインで (Paragraph または SmartTag の子として) 見つかります。

フィールドコードを構成するコンテンツは、FieldStart と FieldSeparator の間に Run ノードとして格納されます。フィールドの結果は FieldSeparator ノードと FieldEnd ノードの間に保存され、さまざまなタイプのコンテンツで構成されます。通常、フィールド結果には Run ノードで構成されるテキストのみが含まれますが、FieldEnd ノードがまったく別の段落に配置される可能性があるため、フィールド結果が Table ノードや Paragraph ノードなどのブロックレベルノードで構成されることもあります。

Aspose.Words では、各 FieldXXX ノードは FieldChar から派生します。このクラスは、FieldChar.field_type プロパティを通じて、指定されたノードによって表されるフィールドのタイプをチェックするプロパティを提供します。たとえば、FieldType.FIELD_MERGE_FIELD はドキュメント内の差し込みフィールドを表します。

Word 文書には、FieldXXX ノードのコレクションとして Aspose.Words にインポートされない特定のフィールドがいくつかあります。たとえば、LINK フィールドと INCLUDEPICTURE フィールドは Shape オブジェクトとして Aspose.Words にインポートされます。このオブジェクトは、通常これらのフィールドに保存されている画像データを操作するためのプロパティを提供します。

フォームフィールドも、独自の特別なクラスとして Aspose.Words にインポートされます。 FormField クラスは Word 文書内のフォームフィールドを表し、フォームフィールドに固有の追加メソッドを提供します。

更新中にサポートされるフィールド

次のフィールドの計算は、Aspose.Words の現在のバージョンでサポートされています。

= (数式フィールド)
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 (TOT および TOF を含む)
TC

高度な解析

Aspose.Words は Microsoft Word がフィールドを処理する方法に従い、その結果、以下を正しく処理します。

入れ子になったフィールド : IF { =OR({ COMPARE { =2.5 +PRODUCT(3,5 ,8.4) } > 4}, { =2/2 }) } = 1 "Credit not acceptable" "Credit acceptable"
フィールド引数は、ネストされたフィールドの結果である場合があります。
フィールドは、フィールド結果だけでなくフィールドコード内にもネストできます。
スペース/スペースなし、引用符/引用符なし、フィールド内のエスケープ文字など: MERGEFIELD \f"Text after""Field \n\ame with \" and \\\ and \\\*"\bTextBefor\e
複数の段落にまたがるフィールド。

数式フィールド

Aspose.Words は、数式エンジンの非常に本格的な実装を提供し、以下をサポートします。

算術演算子および論理演算子: =(54+4*(6-77)-(5))+(-6-5)/4/5
機能： =ABS(-01.4)+2.645/(5.6^3.5)+776457 \\\# "#,##0"
ブックマークへの参照: =IF(C>4, 5,ABS(A)*.76) +3.85
数値書式設定スイッチ: =00000000 \\\# "$#,##0.00;($#,##0.00)"

式内の次の関数がサポートされています: ABS、AND、AVERAGE、COUNT、DEFINED、FALSE、IF、INT、MAX、MIN、MOD、NOT、OR、PRODUCT、ROUND、SIGN、SUM、TRUE。

`IF` および `COMPARE` フィールド

Aspose.Words が簡単に計算できる IF 式の一部を見れば、この機能がいかに強力であるかがわかるはずです。

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` および `TIME` フィールド

Aspose.Words は、Microsoft Word で使用可能なすべての日付と時刻の書式設定スイッチをサポートしています。いくつかの例を次に示します。

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

Mail Mergeフィールド

Aspose.Words は、ドキュメント内の mail merge フィールドの複雑さに制限を設けず、ネストされた IF フィールドと数式フィールドをサポートし、数式を使用して差し込みフィールドの名前を計算することもできます。

Aspose.Words がサポートする mail merge フィールドの例をいくつか示します。

Mail merge フィールドスイッチ: MERGEFIELD FirstName \\\\\\\\* FirstCap \b "Mr. "
数式内のネストされた差し込みフィールド: IF { MERGEFIELDValue1 } >= {MERGEFIELD Value2 } True False
実行時に差し込みフィールドの名前を計算します。 MERGEFIELD { IF{MERGEFIELDValue1 } >= {MERGEFIELD Value2 } FirstName"LastName" }
データソース内の次のレコードへの条件付き移動: NEXTIF { MERGEFIELDValue1 } <= { =IF(-2.45 >= 6*{MERGEFIELD Value2 }, 2, -.45) }

フォーマットスイッチ

ドキュメント内のフィールドには、結果の値の書式設定方法を指定する書式設定スイッチを含めることができます。 Aspose.Words は次の形式スイッチをサポートしています。

@ - 日付と時刻の形式
\# - 数値の書式設定
\\\\* キャップ
\\\\* FirstCap
\\\\* より低い
\\\\* 上部
\\\\* CHARFORMAT – フィールドコードの最初の文字に従って結果をフォーマットします。
\\\\* MERGEFORMAT – 古い結果のフォーマットに従って結果をフォーマットします。

Date とフィールドの数値フォーマット

Aspose.Words がフィールド結果を計算する場合、多くの場合、文字列を数値または日付値に解析し、文字列にフォーマットし直す必要があります。デフォルトでは、Aspose.Words はフィールド更新中にフィールド値を計算するときに、現在のスレッドカルチャを使用して解析とフォーマットを実行します。そしてmail merge。 FieldOptions クラスの形式で提供されるオプションもあり、フィールドの更新中にどのカルチャを使用するかをさらに制御できます。

デフォルトでは、FieldOptions.field_update_culture_source プロパティは、現在のスレッドカルチャを使用してフィールドをフォーマットする FieldUpdateCultureSource.CURRENT_THREAD に設定されます。
このプロパティを FieldUpdateCultureSource.FIELD_CODE に設定すると、フィールドのフィールドコードから設定された言語が代わりに書式設定に使用されます。

現在のスレッドのカルチャを使用したフォーマット

フィールド計算中に使用されるカルチャを制御するには、フィールド計算を呼び出す前に、ロケール.setlocale メソッドを使用して選択したカルチャを設定します。以下の例は、更新中にフィールドの書式設定で使用されるカルチャを変更する方法を示しています。

現在のカルチャを使用してフィールドを書式設定すると、システムはフィールド更新時にドキュメント内のすべてのフィールドの書式設定方法を簡単かつ一貫して制御できるようになります。

ドキュメント内のカルチャを使用した書式設定

一方、Microsoft Word は、フィールド内で見つかったテキストの言語 (具体的には、フィールドコードからのラン) に基づいて、個々のフィールドをフォーマットします。フィールドの更新中に、これが望ましい動作となる場合があります。たとえば、さまざまな言語で構成されたコンテンツを含むグローバル化されたドキュメントがあり、テキストで使用されているロケールを各フィールドに適用したい場合などです。 Aspose.Words もこの機能をサポートしています。

Document クラスは、ドキュメント内でフィールドを更新する方法を制御するために使用できるメンバーを含む field_options プロパティを提供します。以下の例は、フィールド更新および mail merge の際の日付書式設定に使用されるカルチャがどこから選択されるかを指定する方法を示しています。

フィールドコードとフィールド結果の検索

DocumentBuilder.insert_field を使用して挿入されたフィールドは Field オブジェクトを返します。これは、フィールドのそのようなプロパティをすばやく検索するための便利なメソッドを提供するファサードクラスです。ドキュメント内の差し込みフィールドの名前のみを検索する場合は、代わりに組み込みメソッド MailMerge.get_field_names を使用できることに注意してください。以下の例は、文書内のすべての差し込みフィールドの名前を取得する方法を示しています。

差し込みフィールドの名前を変更する方法

以下の例は、Word 文書内の差し込みフィールドの名前を変更する方法を示しています。

Python へのフィールドの挿入