새로 병합한 지원서 팩의 1페이지 Applicant 상자에 이름을 입력하고 탭으로 이동하면, 수많은 뷰어에서 6페이지의 Applicant 상자에 같은 텍스트가 채워집니다. 그 두 컨트롤을 묶어 놓은 사람은 없습니다. 팩의 파트 1과 파트 3은 다른 사람이 만들었고, 둘 다 최상위 필드를 Applicant라고 불렀으며, PDF 폼은 필드를 정규화된 전체 이름으로 식별합니다. 파일 형식의 관점에서 같은 이름을 가진 두 필드는 두 번 그려진 하나의 필드입니다
해법은 병합이 일어나기 전에 공유된 이름이 무엇을 의미할지 정하는 것입니다. 거부하거나, 의도적으로 공유하거나, 새로 들어오는 쪽의 이름을 바꾸거나입니다. 사후에 결정하는 것은 들리는 것보다 훨씬 어렵습니다
ISO 32000이 필드 이름으로 말하는 것
필드 이름은 식별자이며 규격이 그렇게 말합니다. ISO 32000-1 §12.7.3.2는 정규화된 전체 이름을 필드와 그 조상들의 부분 이름(T 항목)을 마침표로 이어 붙여 만듭니다. 같은 절은 여러 필드 딕셔너리가 하나의 정규화된 전체 이름을 공유하는 것을 허용하며, 그것들을 같은 근원 필드의 서로 다른 표현으로 기술하는데, 모양만 다르고 나머지는 같아야 합니다. 독립적으로 작성된 두 폼의 Fields 배열을 이어 붙이면 우연히도 정확히 그 배치가 만들어집니다
피해의 크기는 충돌하는 필드가 무엇을 담고 있었는지에 달려 있습니다. 한 폼에서 생년월일이었던 Date가 다른 폼에서 서명일이었다면 이제 값 슬롯은 하나뿐이고, 뷰어가 정착시킨 값이 양쪽에 들어갑니다. 경비 시트의 Total과 입금 폼의 Total은 둘 중 하나가 계산되는 순간 어긋납니다. 시그니처 필드가 최악입니다. 다른 페이지의 두 시그니처 위젯, 하나의 이름, 그리고 서명자가 실제로 승인한 위젯이 어느 것인지에 대한 깔끔한 답이 없습니다
대소문자도 문제가 됩니다. 부분 이름은 텍스트 문자열이고 규격에는 대소문자를 접는 규정이 없으므로 Total과 total은 서로 다른 두 필드입니다. 비교 전에 이름을 소문자로 만드는 충돌 검사는 존재하지 않는 충돌을 보고하고, 이름 변경 정책 아래에서는 손댈 필요가 없던 필드의 이름을 바꿔 버립니다
무엇이든 움직이기 전에 이름 검사하기
PDF Library for Delphi는 MergeDocumentEx(DocumentID, DuplicateFieldStrategy)에서 충돌을 처리합니다. 이 호출은 DocumentID가 가리키는 문서를 현재 선택된 문서로 병합하며, 객체 하나가 renumber되기 전에 모든 이름 충돌을 정리합니다. 전략은 TPDFlibDuplicateFieldStrategy 값, 즉 dfsReject, dfsMerge, dfsAutoNumber입니다. 평범한 MergeDocument는 여전히 두 루트 필드 배열을 그대로 이어 붙이는데, 두 폼을 모두 소유하고 이름이 겹치지 않는다는 것을 알 때는 그것이 옳은 선택입니다
순서가 설계 전부입니다. 병합은 들어오는 문서의 객체 번호를 대상과 충돌하지 않도록 옮기고, 그 페이지를 대상의 페이지 트리에 이식하며, 그 필드를 폼에 추가해야 합니다. 충돌이 이 단계들 이후에야 드러난다면 거부는 더 이상 공짜가 아닙니다. 대상은 이미 페이지를 흡수했고, 소스의 객체들은 어느 파일도 처음에 갖지 않았던 번호를 지니며, 호출자에게는 두 파일을 디스크에서 다시 읽는 것 외에 돌아갈 상태가 없습니다. MergeDocumentEx는 두 문서의 최상위 필드 이름을 먼저 순서가 있는 대소문자 구분 집합으로 모은 다음 그 집합을 대상으로 전략을 적용합니다. dfsReject 아래에서 충돌은 호출이 0을 반환하고 LastErrorCode가 705로 설정되게 만들며, 두 문서는 로드된 그대로 유지됩니다. 거부 직후 소스 문서에서 필드 값을 읽으면 원래 텍스트가 돌아옵니다
검사 자체는 저렴합니다. 대상에 이름 n개, 소스에 이름 m개가 있을 때 하나의 집합으로 정렬하는 비용은 대략 (n + m) log(n + m) 회의 비교이므로, 수백 개 필드짜리 팩은 파일 파싱 옆에서는 눈에 띄지 않습니다
이 검사의 세 가지 성질은 실제 폼 팩에서 모습을 드러냅니다:
- 비교는 최상위 필드만 이뤄집니다. 계층형 폼에서 이는 부모의 부분 이름을 뜻하므로, 각각
applicant라는 부모를 둔 두 폼은 자식이 달라도 충돌하고, 자동 번호 매기기는 부모의 이름을 바꿉니다. 들어온 자식들은 그다음applicant_2.name,applicant_2.address로 읽힙니다 - 들어오는 이름은 검사되는 대로 집합에 합류합니다. 대상에 그런 이름의 필드가 전혀 없더라도, 소스 문서가 이미 같은 이름의 최상위 필드 두 개를 가지고 있으면 두 번째에서 전략이 발동합니다
- 부분 이름이 빈 필드는 건너뛰고, 어느 문서에 AcroForm이 없으면 비교할 것이 없으므로 어떤 전략 아래에서도 병합은 진행됩니다
로딩 쪽에는 자신만의 함정이 하나 있습니다. LoadFromFile은 라이브러리에 새 문서를 추가하고 그것을 선택하므로, 간직할 식별자는 각 로드 이후 SelectedDocument가 돌려주는 값입니다. 로드 전에 잡아 두면 여러분이 병합한다고 생각하는 문서와 다른 문서를 쥐고 있는 것입니다
uses
SysUtils, PDFlibrary;
procedure BuildPack(const Part1, Part2, OutFile: WideString);
var
Lib: TPDFlib;
TargetDoc, SourceDoc: Integer;
begin
Lib := TPDFlib.Create;
try
if Lib.LoadFromFile(Part1, '') = 0 then
raise Exception.CreateFmt('Cannot load %s', [Part1]);
TargetDoc := Lib.SelectedDocument; // 로드 후에 읽는다, 이전이 아니라
if Lib.LoadFromFile(Part2, '') = 0 then
raise Exception.CreateFmt('Cannot load %s', [Part2]);
SourceDoc := Lib.SelectedDocument;
Lib.SelectDocument(TargetDoc); // 선택된 문서가 병합을 받는다
if Lib.MergeDocumentEx(SourceDoc, dfsReject) = 0 then
begin
if Lib.LastErrorCode <> 705 then
raise Exception.CreateFmt('Merge failed, error %d', [Lib.LastErrorCode]);
// 중복 최상위 이름: 두 문서 모두 온전하므로,
// SourceDoc은 곧바로 두 번째 시도에 재사용할 수 있다
WriteLn('Duplicate field names in ', Part2, ', retrying with auto-numbering');
if Lib.MergeDocumentEx(SourceDoc, dfsAutoNumber) = 0 then
raise Exception.CreateFmt('Merge failed, error %d', [Lib.LastErrorCode]);
end;
Lib.SaveToFile(OutFile);
finally
Lib.Free;
end;
end;
먼저 엄격하게, 다음으로 관대하게. 이 두 단계 구조가 동작하는 이유는 거부가 SourceDoc을 로드된 온전한 상태로 남겨두기 때문입니다. 절반쯤 실패한 병합이라면 폴백 분기는 두 파일을 다시 읽는 것부터 시작해야 합니다. 705를 특정해서 검사하는 것도 중요합니다. 잘못된 문서 식별자나 범위를 벗어난 전략 값은 다른 코드로 호출을 실패하게 만들며, 다른 전략으로 재시도해도 그중 하나도 해결되지 않습니다
전략 고르기: 거부, 공유, 재번호 매기기
무인 파이프라인이라면 dfsReject를 기본으로 삼고 705를 소스 폼 소유자의 티켓으로 취급하십시오. 상류에서 필드 이름을 한 번 바꾸는 것이, 병합이 몰래 만든 Total_2 때문에 수개월 뒤에야 내보내기 매핑이 조용히 어긋났다는 것을 발견하는 것보다 쌉니다. 자동 전략이 빛을 발하는 시점은 사람이 폼을 살펴보고 공유된 이름의 의미를 결정한 뒤입니다
dfsMerge는 공유된 이름을 의도적으로 유지합니다. 무엇이든 추가되기 전에 대상 필드의 값과 기본 값이 들어오는 필드로 복사되므로, 병합된 파일은 일관된 상태로 시작하고 이름으로 위젯을 묶는 뷰어는 하나의 값을 가진 하나의 논리 필드를 봅니다. 두 필드 딕셔너리는 별개의 객체로 남아 각자 자신의 페이지, 외양, 액션을 유지합니다. 이들을 하나의 딕셔너리로 접으면 들어오는 폼에 속한 서식과 동작이 버려지는데, 외관상 단순화를 위해 그 무역을 감수할 이유는 없습니다
dfsAutoNumber는 들어오는 중복 이름에 숫자 접미사를 덧붙여 이름을 바꿉니다. _2에서 시작해 처음 비어 있는 번호를 택합니다. 대상에 이미 Shared와 Shared_2가 있다면 새로운 것은 Shared_3이 됩니다. 결과는 존재하는 이름에만 의존하고 객체 번호에는 의존하지 않으므로, 같은 파일 쌍을 두 번 병합하면 두 번 모두 같은 이름이 나옵니다. 다운스트림 FDF 임포트와 데이터베이스 매핑이 의존하는 성질입니다
두 자동 전략 사이의 선택은 한 질문으로 귀결됩니다. 한 컨트롤을 채우면 다른 컨트롤도 채워져야 하는가? 팩의 모든 파트에 반복되는 서명자 이름이라면 그렇고, dfsMerge가 맞습니다. 폼마다 다르게 계산되는 합계라면 아닙니다. 거기서는 dfsAutoNumber를 택하거나, 더 좋게는 소스 폼에서 필드 이름을 바꿔 접미사가 등장하지 않게 하십시오
병합된 폼에는 이후 무엇이 들어 있나?
"Target value"를 담은 최상위 텍스트 필드 Shared를 가진 대상과 자체 Shared를 가진 소스를 생각해 봅시다. dfsMerge 후에는 FormFieldCount가 두 필드를 세고, 둘 다 제목이 Shared이며 둘 다 "Target value"를 보고합니다. dfsAutoNumber 후에는 같은 입력이 Shared와 Shared_2를 주고, 들어온 필드는 소스 파일에서 가지고 있던 값을 유지합니다
dfsMerge 결과에는 날카로운 모서리가 있는데, 그것은 여러분 자신의 채우기 코드에 있습니다. FindFormFieldByTitle은 제목이 일치하는 첫 번째 인덱스를 돌려주고, SetFormFieldValue는 정확히 하나의 필드에 기록합니다. Shared를 한 번 찾아 설정하는 루틴은 대상의 사본을 갱신하고 들어온 사본은 병합 시점에 받은 값을 그대로 쥐고 있게 둡니다. 저장된 파일은 이제 하나의 이름과 서로 다른 두 값을 가진 두 필드를 담고, 뷰어가 어느 쪽을 보여 줄지는 뷰어 마음입니다. 모든 일치 항목에 기록하십시오:
// Title을 지닌 모든 필드를 설정하고 몇 개가 기록되었는지 돌려준다.
// dfsMerge 병합 뒤에는 하나의 논리 필드가 여러 인덱스에 나타날 수 있다
function SetAllFieldsNamed(Lib: TPDFlib; const Title, Value: WideString): Integer;
var
I: Integer;
begin
Result := 0;
for I := 1 to Lib.FormFieldCount do
if Lib.GetFormFieldTitle(I) = Title then
begin
if Lib.SetFormFieldValue(I, Value) = 1 then
Inc(Result)
else
WriteLn(Format('Field %d (%s) not written, error %d',
[I, Title, Lib.LastErrorCode])); // 읽기 전용 필드가 여기로 온다
end;
end;
병합된 팩을 데이터 피드에 연결하기 전에 병합이 실제로 만든 것을 덤프하십시오. 두 줄짜리 루프면 충분하고, 임포트 작업보다 먼저 바뀐 부모와 _2 접미사를 잡아냅니다:
for I := 1 to Lib.FormFieldCount do
WriteLn(Format('%3d %-30s %s',
[I, Lib.GetFormFieldTitle(I), Lib.GetFormFieldValue(I)]));
실전에서 폼 팩 조립하기
성공적인 병합은 소스 문서를 소비합니다. 소스는 라이브러리의 문서 목록에서 제거되어 DocumentCount가 하나 줄고, 오래된 SourceDoc 식별자는 다시 써서는 안 됩니다. 병합된 문서는 두 PDF 버전 중 높은 쪽을 택합니다. PDF 2.0 폼을 1.7 문서로 병합하면 2.0 파일이 나오는데, 다운스트림 보관 단계가 특정 버전을 기대한다면 이것이 문제가 됩니다
병합 순서가 누구의 이름이 살아남는지 결정합니다. 선택된 문서는 자신의 이름을 모두 유지하고, 이름 변경과 값 복사는 언제나 들어오는 필드에만 적용되므로, A를 B로 병합하는 것과 B를 A로 병합하는 것은 다른 자동 번호 결과를 냅니다. 팩에 주력 폼, 즉 백오피스가 이미 필드 이름을 알고 있는 그 하나가 있다면 그것을 대상으로 삼고 보조 폼을 그쪽으로 병합하십시오
서명은 마지막에 하십시오. 시그니처는 자신이 서명한 리비전의 바이트를 커버하고, 병합은 파일을 다시 쓰므로, 조립 전에 서명된 파트는 문서와 일치하는 시그니처를 더 이상 지니지 않습니다. 팩을 조립하고 필드 목록을 확인한 다음, 완성된 파일에 시그니처를 적용하십시오. 작업이 페이지를 이어 붙이는 것뿐이고 폼이 문제가 되지 않는다면 바이트 참조 이동을 사용하는 빠른 PDF 병합이 더 빠른 길입니다
데이터 쪽도 병합과 함께 계획하십시오. 필드 값이 이름으로 필드를 지목하는 외부 시스템에서 들어온다면 dfsAutoNumber를 택하기 전에 명명을 정리하십시오. Shared_2는 Shared를 기대하는 매핑과 맞지 않습니다. 값 임포트와 익스포트 형식은 FDF, XFDF, XFA 폼 데이터 교환에서 다루고, 이름으로 필드를 참조하는 계산 스크립트와 액션도 이름 변경의 영향을 같은 방식으로 받으며 대화형 폼 액션과 JavaScript에서 그 참조들이 어디 사는지 보여 줍니다
중복을 인식하는 폼 병합, 필드 채우기, 전자 서명은 모두 Delphi, C++Builder, Free Pascal 프로젝트를 위한 같은 라이브러리의 일부입니다. PDF Library for Delphi 제품 페이지에 폼과 문서 조립 API의 나머지가 정리되어 있습니다