Jak zapisać i edytować historię poprawek PDF w C

Jak zapisać i podpisać iterację poprawki PDF?

W poniższym przykładzie otwieramy plik PDF, dokonujemy różnych edycji, a następnie podpisujemy go przed zapisem. Dla uprawnień do popisu pozwalamy tylko na uzupełnianie formularza jako przyszłe edycje; w przeciwnym razie podpis zostanie unieważniony przez jakąkolwiek inną edycję.

Następnie dzwonimy do SaveAsRevision, aby zapisać poprawkę w historii i zapisać nasz nowy dokument na dysku. To podejście jest przydatne przy implementacji cyfrowych przepływów pracy podpisu w aplikacjach korporacyjnych, gdzie integralność dokumentów i ścieżki audytu są kluczowe.

:path=/static-assets/pdf/content-code-examples/how-to/signing-revision.cs

using IronPdf;
using IronPdf.Rendering;

// Import PDF and enable TrackChanges
PdfDocument pdf = PdfDocument.FromFile("annual_census.pdf", TrackChanges: ChangeTrackingModes.EnableChangeTracking);
// ... various edits ...
pdf.SignWithFile("/assets/IronSignature.p12", "password", null, IronPdf.Signing.SignaturePermissions.AdditionalSignaturesAndFormFillingAllowed);

PdfDocument pdfWithRevision = pdf.SaveAsRevision();

pdfWithRevision.SaveAs("annual_census_2.pdf");

Imports IronPdf
Imports IronPdf.Rendering

' Import PDF and enable TrackChanges
Private pdf As PdfDocument = PdfDocument.FromFile("annual_census.pdf", TrackChanges:= ChangeTrackingModes.EnableChangeTracking)
' ... various edits ...
pdf.SignWithFile("/assets/IronSignature.p12", "password", Nothing, IronPdf.Signing.SignaturePermissions.AdditionalSignaturesAndFormFillingAllowed)

Dim pdfWithRevision As PdfDocument = pdf.SaveAsRevision()

pdfWithRevision.SaveAs("annual_census_2.pdf")

Parametr ChangeTrackingModes.EnableChangeTracking jest niezbędny, aby utrzymać pełny dziennik kontroli. Po włączeniu IronPDF przechowuje wszystkie modyfikacje dokumentu jako oddzielne warstwy, umożliwiając nawigację przez historię dokumentu. Ta funkcja integruje się z bezpieczeństwem PDF i uprawnieniami w celu zapewnienia, że tylko autoryzowani użytkownicy mogą uzyskać dostęp do konkretnych poprawek.

Dlaczego zrozumienie zapisu przyrostowego ma znaczenie dla podpisów?

Chociaż niektórzy przeglądający, jak przeglądarka Chrome, pokazują tylko jedną wersję, pliki PDF mogą przechowywać poprzednie wersje dokumentu, podobnie jak historia zatwierdzeń Git. Zobaczysz to w zaawansowanych przeglądarkach PDF, takich jak Adobe Acrobat. Zrozumienie tego mechanizmu zapisu przyrostowego jest kluczowe przy pracy z podpisanymi PDF ponieważ każdy podpis dotyczy konkretnego stanu dokumentu.

Kiedy pracujesz z podpisami PDF, wiedz, że podpisanie PDF dotyczy bieżącej iteracji PDF. Twój PDF może mieć podpisy dla starszych iteracji lub mieć nienaruszone wersje. Możemy zobrazówać przykład jak poniżej:

Iteracja dokumentu PDF	Certyfikat A	Certyfikat B	Certyfikat C	Certyfikat D
0 (pierwszy zapis)
1
2
3	(tylko edycje pól formularza)	(tylko edycje pól formularza)
4 (tylko edytowano pola formularzy)
5	(brak dalszych edycji dozwolonych)	(brak dalszych edycji dozwolonych)		(brak dalszych edycji dozwolonych)

Powyżej mamy dokument, który przeszedł 6 iteracji. Dokument ten może być przesyłany przez działy firmy do zatwierdzenia, aż zostanie sfinalizowany przy iteracji 3. W tej iteracji zarówno Osoba A jak i Osoba B podpisali dokument z ustawionym uprawnieniem "Edytuj tylko pola formularzy". Oznacza to, że wypełnianie pól formularzy w dokumencie PDF jest dozwolone, ale jakakolwiek inna zmiana dokumentu unieważni ich podpisy.

W powyższym przykładzie załóżmy, że Osoba C wypełniła formularz i przesłała go z powrotem do Osób A, B i D, które wszystkie podpisały dokument ostatni raz z ustawieniem uprawnienia "Brak dozwolonych edycji". Ponieważ w tym dokumencie nie podjęto żadnych działań unieważniających, kiedy uruchamiamy metodę podpisu IronPDF, uzyskujemy true.

To podejście do zapisu przyrostowego jest cenne, gdy jest połączone z kompleksowymi funkcjami bezpieczeństwa PDF, ponieważ zapewnia, że każdy podpis pozostaje ważny tylko dla specyficznego stanu dokumentu, do którego został zastosowany. To zapobiega nieautoryzowanym modyfikacjom, jednocześnie zachowując kompletną ścieżkę audytu wszystkich zmian.

Moją ulubioną biblioteką tego typu jest IronPDF. Umożliwia ona szybkie i efektywne manipulowanie plikami PDF. Posiada także wiele cennych funkcji, takich jak eksport do formatu PDF/A i cyfrowe podpisywanie dokumentów PDF.

Milan Jovanovic

Microsoft MVP

Zobacz studium przypadku

IronOCR pozwala nam oszczędzić 40 000 USD rocznie na ręcznym przetwarzaniu, jednocześnie zwiększając produktywność i uwalniając zasoby do zadań o wysokim wpływie. Gorąco polecam.

Brent Matzelle

Dyrektor technologiczny, OPYN

Zobacz studium przypadku

IronSuite odgrywa kluczową rolę w naszej działalności. Są to narzędzia zwiększające wydajność w całej firmie, w tym tworzenie planów pięter i poprawa zarządzania zapasami.

David Jones

Główny inżynier oprogramowania, Agorus Build

Zobacz studium przypadku

Jak powrócić do starej poprawki?

Aby cofnąć się do wcześniejszej wersji PDF, użyj metody GetRevision. To pozwoli zapomnieć o wszelkich zmianach dokonanych od tej poprawki, w tym o nowszych podpisach. Ta funkcjonalność jest niezbędna, gdy musisz odzyskać się od niechcianych zmian lub podczas przeglądania ewolucji dokumentu w czasie.

:path=/static-assets/pdf/content-code-examples/how-to/signing-revert-revision.cs

using IronPdf;

PdfDocument pdf = PdfDocument.FromFile("report.pdf");

int versions = pdf.RevisionCount; // total revisions

PdfDocument rolledBackPdf = pdf.GetRevision(2);
rolledBackPdf.SaveAs("report-draft.pdf");

Imports IronPdf

Private pdf As PdfDocument = PdfDocument.FromFile("report.pdf")

Private versions As Integer = pdf.RevisionCount ' total revisions

Private rolledBackPdf As PdfDocument = pdf.GetRevision(2)
rolledBackPdf.SaveAs("report-draft.pdf")

Metoda GetRevision tworzy nowe wystąpienie dokumentu PDF zawierające tylko treść do określonego numeru poprawki. To jest przydatne w scenariuszach, gdzie:

• Musisz porównać różne wersje dokumentu
• Podpis został unieważniony z powodu nieautoryzowanych zmian
• Chcesz rozgałęzić się od starszej wersji dla innego przepływu zatwierdzeń
• Musisz wykazać zgodność, pokazując stan dokumentu w określonym momencie

Podczas pracy z poprawkami, cofanie się nie wpływa na oryginalny plik PDF – tworzy nową instancję dokumentu. To podejście utrzymuje integralność danych, jednocześnie zapewniając elastyczność w zarządzaniu wersjami dokumentów. Dla bardziej zaawansowanych technik manipulacji PDF, zapoznaj się z kompleksowymi możliwościami edycyjnymi IronPDF.

Najlepsze praktyki dotyczące zarządzania poprawkami PDF

Podczas implementacji historii poprawek w twoich aplikacjach rozważ te najlepsze praktyki:

1. Zawsze włącz śledzenie zmian: Ustaw EnableChangeTracking podczas otwierania PDF-ów, które wymagają historii poprawek.

2. Dokumentuj swoją strategię poprawek: Prowadź jasną dokumentację na temat tego, kiedy i dlaczego poprawki są zapisywane, zwłaszcza w środowiskach wieloosobowych.

3. Wprowadź kontrolę dostępu: Połącz historię poprawek z uprawnieniami PDF i hasłami w celu zapewnienia, że tylko autoryzowani użytkownicy mogą tworzyć lub uzyskiwać dostęp do określonych poprawek.

4. Regularne eksporty: Okresowo eksportuj ważne poprawki do oddzielnych plików dla archiwizacji długoterminowej.

5. Testuj zgodność podpisów: Przetestuj, jak różne uprawnienia podpisu współdziałają z twoim przepływem poprawek, aby uniknąć niespodziewanych unieważnień.

Dzięki stosowaniu tych praktyk i wykorzystaniu funkcji zarządzania wersjami IronPDF, możesz tworzyć zaawansowane przepływy pracy, które zachowują pełne ścieżki audytu, jednocześnie zapewniając integralność dokumentów podczas całego procesu współpracy. Aby uzyskać więcej informacji na temat implementacji tych funkcji w twoich aplikacjach, przejrzyj kompleksową dokumentację IronPDF lub explore opcje licencjonowania dla potrzeb twojej firmy.