필드 개요

일반적으로 Microsoft Word에 삽입된 필드에는 이미 최신 값이 포함되어 있습니다. 예를 들어 필드가 수식이나 페이지 번호인 경우 해당 문서 버전에 대해 올바르게 계산된 값이 포함됩니다. 그러나 필드가 있는 문서를 생성하거나 수정하는 애플리케이션이 있는 경우(예: 두 개의 문서를 결합하거나 데이터로 채우기) 문서가 유용하려면 이상적으로 모든 필드를 업데이트해야 합니다.

필드는 다음으로 구성됩니다

fields-aspose-words

필드 시작 및 구분 노드는 필드 코드(일반적으로 일반 텍스트)를 구성하는 콘텐츠를 포함하는 데 사용됩니다
필드 구분 기호와 필드 끝은 필드 결과를 포함합니다. 이는 일련의 텍스트부터 단락, 표에 이르기까지 다양한 유형의 콘텐츠로 구성될 수 있습니다.
일부 필드에는 구분 기호가 없을 수 있습니다. 이는 전체 내용이 필드 코드를 구성한다는 의미입니다.
필드 코드는 필드의 동작을 정의하며 필드 식별자와 필드 이름 및 스위치와 같은 기타 매개변수로 구성됩니다.
현장 결과에는 해당 분야의 가장 최근 평가가 포함됩니다. 이 값은 필드 결과에 저장되며 사용자에게 표시됩니다. 일부 필드에는 필드 결과가 없을 수 있으므로 문서에 아무 것도 표시되지 않습니다. 마찬가지로 일부 필드는 아직 업데이트되지 않을 수 있으므로 필드 결과도 없습니다.

다음은 Github에서 찾을 수 있는 “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 드롭다운 메뉴를 클릭합니다
Field를 선택하세요
해당 필드의 세부정보를 입력할 수 있는 화면이 표시됩니다. 왼쪽에는 가능한 필드 목록이 제공되고 오른쪽에는 필드 속성을 시각적으로 편집할 수 있는 화면이 있습니다.
또한 Field Codes 버튼을 눌러 필드 코드를 직접 작성할 수 있습니다.
Options 버튼을 사용하여 스위치를 삽입할 수도 있습니다.
두 방법 중 하나를 사용하여 원하는 필드에 적절한 정보를 입력한 다음 Ok를 누릅니다.
문서의 현재 커서 위치에 필드가 삽입됩니다.

Microsoft Word의 필드 업데이트

Microsoft Word에서 단일 필드를 업데이트하려면:

업데이트하려는 필드로 캐럿을 이동합니다.
F9를 눌러 필드를 업데이트합니다.

Microsoft Word의 모든 필드를 업데이트하려면:

Ctrl+A를 눌러 문서의 모든 내용을 선택하세요.
F9를 눌러 선택 항목 내에서 발견된 모든 필드를 업데이트합니다.

필드 코드 표시와 필드 결과 표시 간 전환

Microsoft Word에서 단일 필드의 필드 코드를 전환하려면:

캐럿을 원하는 필드로 이동하세요.
Shift+F9를 눌러 이 필드에 대한 필드 코드를 전환하세요.

Microsoft Word에 있는 모든 필드의 필드 코드를 전환하려면:

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은 문서의 병합 필드를 나타냅니다.

FieldXXX 노드 모음으로 Aspose.Words로 가져오지 않는 Word 문서에 존재하는 일부 특정 필드가 있습니다. 예를 들어 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로 설정할 수 있으므로 필드의 필드 코드에서 설정된 언어가 서식 지정에 대신 사용됩니다.

현재 스레드의 문화권을 사용하여 서식 지정

필드 계산 중에 사용되는 문화권을 제어하려면 필드 계산을 호출하기 전에 locale.setlocale 메서드를 사용하여 원하는 문화권을 설정하면 됩니다. 아래 예에서는 업데이트 중에 필드 형식 지정에 사용되는 문화권을 변경하는 방법을 보여줍니다.

현재 문화권을 사용하여 필드 형식을 지정하면 시스템에서 필드 업데이트 중에 문서의 모든 필드 형식이 지정되는 방식을 쉽고 일관되게 제어할 수 있습니다.

문서의 문화를 사용하여 서식 지정

반면 Microsoft Word는 필드에 있는 텍스트의 언어(특히 필드 코드에서 실행)를 기반으로 각 개별 필드의 형식을 지정합니다. 때로는 필드 업데이트 중에 이것이 바람직한 동작일 수 있습니다. 예를 들어 다양한 언어로 구성된 콘텐츠가 포함된 세계화된 문서가 있고 각 필드가 텍스트에서 사용된 로케일을 따르도록 하려는 경우입니다. Aspose.Words도 이 기능을 지원합니다.

Document 클래스는 문서 내에서 필드가 업데이트되는 방식을 제어하는 데 사용할 수 있는 멤버가 포함된 field_options 속성을 제공합니다. 아래 예에서는 필드 업데이트 및 Mail Merge 중 날짜 형식 지정에 사용되는 문화권이 선택되는 위치를 지정하는 방법을 보여줍니다.

필드 코드 및 필드 결과 찾기

DocumentBuilder.insert_field를 사용하여 삽입된 필드는 Field 개체를 반환합니다. 이는 필드의 이러한 속성을 빠르게 찾는 데 유용한 방법을 제공하는 façade 클래스입니다. 문서에서 병합 필드의 이름만 찾는 경우 내장된 메소드 MailMerge.get_field_names을 대신 사용할 수 있습니다. 아래 예는 문서의 모든 병합 필드 이름을 가져오는 방법을 보여줍니다.

병합 필드 이름을 바꾸는 방법

아래 예에서는 Word 문서에서 병합 필드의 이름을 바꾸는 방법을 보여줍니다.

Python에 필드 삽입