Jak zapisać i edytować historię poprawek PDF w C
IronPDF umożliwia programistom C# śledzenie i zarządzanie zmianami w dokumentach PDF w czasie za pomocą historii poprawek. Zapisuj wersje dokumentu za pomocą metody SaveAsRevision i przywracaj poprzednie wersje za pomocą GetRevision podczas współpracy nad dokumentami.
Szybki start: Zapisuj poprawki PDF z IronPDF
Zarządzaj i zapisuj poprawki PDF za pomocą IronPDF w swoich aplikacjach C#. W niniejszym przewodniku pokazano zapisywanie wersji dokumentów za pomocą metody SaveAsRevision programu IronPDF, służącej do śledzenia zmian w plikach PDF i zarządzania nimi. Załaduj plik PDF i zapisz go jako oddzielną poprawkę, aby zarchiwizować wszystkie modyfikacje.
-
Install IronPDF with NuGet Package Manager
PM > Install-Package IronPdf -
Skopiuj i uruchom ten fragment kodu.
var pdf = IronPdf.PdfDocument.FromFile("example.pdf"); pdf.SaveAsRevision("revision1.pdf"); -
Wdrożenie do testowania w środowisku produkcyjnym
Rozpocznij używanie IronPDF w swoim projekcie już dziś z darmową wersją próbną
as-heading:3(Minimalny Przepływ Pracy (6 kroków))
- Pobierz bibliotekę C# do zapisywania i edytowania historii poprawek PDF z IronPDF
- Użyj metody
SaveAsRevision, aby zapisać wersje PDF. - Pobierz wersje PDF za pomocą metody
GetRevision. - Uzyskaj dostęp do właściwości
RevisionCount, aby sprawdzić liczbę poprawek. - Wywołaj metodę
TrackChanges: ChangeTrackingModes.EnableChangeTrackingdo zarządzania metadanymi wersji pośrednich. - Zapisz ostateczną wersję pliku PDF za pomocą
SaveAs.
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 wywołujemy SaveAsRevision, aby zapisać zmianę 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.
TrackChanges na wartość false. Ta opcja musi być ustawiona na true, aby używać funkcji zapisu przyrostowego.: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 do zachowania pełnej ścieżki audytu. 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.
Dłączego 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. Niniejszy dokument może być przekazywany między działami firmy po uzyskaniu zgody, aż do momentu sfinalizowania w 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.
Jak powrócić do starej poprawki?
Aby przywrócić poprzednią wersję pliku PDF, należy użyć 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 nową instancję dokumentu PDF zawierającą wyłącznie treść do określonego numeru wersji. 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:
-
Zawsze włączaj śledzenie zmian: Ustaw
EnableChangeTrackingpodczas otwierania plików PDF, które wymagają historii zmian. -
Dokumentuj swoją strategię poprawek: Prowadź jasną dokumentację na temat tego, kiedy i dłączego poprawki są zapisywane, zwłaszcza w środowiskach wieloosobowych.
-
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.
-
Regularne eksporty: Okresowo eksportuj ważne poprawki do oddzielnych plików dla archiwizacji długoterminowej.
- 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.
Często Zadawane Pytania
Jak zapisać rewizje PDF w C#?
Możesz zapisać rewizje PDF w C# używając metody SaveAsRevision IronPDF. Po prostu załaduj swój dokument PDF i wywołaj pdf.SaveAsRevision('revision1.pdf') aby stworzyć zapisaną wersję, która śledzi wszystkie zmiany dokumentu.
Jaki jest cel śledzenia historii rewizji PDF?
Funkcja historii rewizji IronPDF pozwala deweloperom śledzić zmiany dokumentu w czasie, umożliwiając współpracę nad dokumentami, gdzie można cofnąć się do poprzednich wersji używając metody GetRevision. To jest kluczowe do utrzymania ścieżek audytowych w aplikacjach enterprise.
Jak włączyć śledzenie zmian dla zapisów inkrementalnych?
Aby włączyć śledzenie zmian w IronPDF, ustaw opcję TrackChanges na true i użyj parametru ChangeTrackingModes.EnableChangeTracking. To zachowuje wszystkie modyfikacje dokumentu jako osobne warstwy, pozwalając nawigować przez pełną historię dokumentu.
Czy mogę podpisać PDF i zachować jego historię rewizji?
Tak, IronPDF pozwala na podpisanie PDF-ów przy jednoczesnym zachowaniu historii rewizji. Kiedy podpisujesz dokument, podpis odnosi się do bieżącej iteracji. Możesz ustawić specyficzne uprawnienia, takie jak tylko wypełnianie formularzy, aby zapobiec unieważnieniu podpisu przez przyszłe edycje.
Jak mogę pobrać poprzednie wersje PDF?
IronPDF oferuje metodę GetRevision do pobierania poprzednich wersji dokumentu PDF. Możesz także użyć właściwości RevisionCount, aby określić, ile rewizji istnieje w historii dokumentu.
Co się dzieje z podpisami, kiedy zapisuję nową rewizję?
Gdy używasz metody SaveAsRevision IronPDF po podpisaniu dokumentu, podpis pozostaje ważny dla tej specyficznej rewizji. Jednak każda edycja przekraczająca dozwolone uprawnienia (jak wypełnianie formularzy) unieważni podpis, zapewniając integralność dokumentu.
Czy historia rewizji jest widoczna we wszystkich przeglądarkach PDF?
Choć IronPDF zapisuje pełną historię rewizji podobnie do commitów Git, nie wszystkie przeglądarki PDF wyświetlają tę informację. Proste przeglądarki, takie jak Chrome, pokazują tylko bieżącą wersję, podczas gdy zaawansowane przeglądarki, takie jak Adobe Acrobat, mogą wyświetlać pełną historię rewizji.
Jak zapisanie inkrementalne poprawia wydajność PDF?
Funkcja zapisywania inkrementalnego IronPDF poprawia wydajność eksportu poprzez zapisywanie tylko zmian zamiast przepisania całego dokumentu. Można zoptymalizować wydajność ustawiając TrackChanges na false, gdy śledzenie rewizji nie jest potrzebne, chociaż musi być to włączone dla zapisów inkrementalnych.

