Installera Documentize via NuGet

Hur man installerar via NuGet Package Manager Console

1. Öppna ditt projekt:

   • Starta Visual Studio och öppna din .NET-applikation.

2. Öppna Package Manager Console:

   • Gå till Verktyg > NuGet Package Manager > Package Manager Console.

3. Installera paketet:

   • För att installera den senaste fullständiga versionen, skriv kommandot Install-Package Documentize.
   • För att installera den senaste versionen inklusive hotfixar, använd Install-Package Documentize -prerelease.
   • Tryck på Enter för att köra kommandot.

Hur man uppdaterar paket via NuGet Package Manager Console

Om du redan har installerat Documentize via NuGet och vill uppdatera till den senaste versionen:

1. Öppna ditt projekt:

   • Starta Visual Studio och öppna din .NET-applikation.

2. Öppna Package Manager Console:

   • Gå till Verktyg > NuGet Package Manager > Package Manager Console.

3. Uppdatera paketet:

   • För att uppdatera till den senaste fullständiga versionen, skriv Update-Package Documentize.
   • För att uppdatera till den senaste versionen inklusive hotfixar, använd Update-Package Documentize -prerelease.
   • Tryck på Enter för att köra kommandot.

Hur man installerar via NuGet Package Manager GUI

1. Öppna ditt projekt:

   • Starta Visual Studio och öppna din .NET-applikation.

2. Navigera till Hantera NuGet-paket:

   • Från Projekt-menyn, välj Hantera NuGet-paket.

3. Sök efter Documentize:

   • Gå till fliken Bläddra och skriv Documentize i sökrutan.

4. Installera paketet:

   • Klicka på Installera/uppdatera bredvid den senaste versionen av Documentize.
   • Bekräfta genom att klicka på Acceptera i popup-fönstret.

Fördelar med att använda NuGet

• Automatisk hantering av beroenden:

  • NuGet hanterar automatiskt beroenden, vilket säkerställer att alla nödvändiga bibliotek inkluderas och uppdateras korrekt. Detta minskar risken för saknade eller inkompatibla beroenden.

• Förenklade uppdateringar:

  • Att uppdatera paket är enkelt med NuGet, antingen via Package Manager Console eller GUI. Detta gör det lätt att hålla dina bibliotek uppdaterade med de senaste funktionerna och buggfixarna.

• Integrerad med Visual Studio:

  • NuGet är sömlöst integrerat med Visual Studio, vilket ger ett användarvänligt gränssnitt för att hantera paket utan att behöva lämna utvecklingsmiljön.

• Versionshantering:

  • NuGet låter dig specificera och hantera olika versioner av bibliotek, vilket möjliggör enkelt återställande till tidigare versioner eller test av nya släpp utan att störa din utveckling.

Nackdelar med att använda NuGet

• Begränsat till Visual Studio:

  • NuGet är främst designat för användning inom Visual Studio. Även om det kan användas i andra miljöer är integrationen som bäst i Visual Studio.

• Potential för versionskonflikter:

  • I större projekt med många beroenden kan hantering av versioner och lösning av konflikter bli komplext. NuGet tillhandahåller verktyg för att hantera detta, men det kräver noggrant fokus.

• Nätverksberoende:

  • Installation och uppdatering av paket kräver en internetuppkoppling. Om du arbetar i en miljö med begränsad eller ingen internetåtkomst kan du behöva använda offline-metoder eller förladdade paket.

• Komplexitet för stora projekt:

  • För mycket stora projekt med omfattande beroendeträd kan bördan av att hantera paket genom NuGet bli besvärlig. I sådana fall kan ytterligare verktyg eller strategier behövas för att effektivt hantera beroenden.

Installera Documentize via MSI

Hur man installerar via MSI-installationsprogrammet

1. Ladda ner MSI-installationsprogrammet:

   • Klicka på v24.12 MSI för att ladda ner MSI-installationsprogrammet för den senaste versionen av Documentize.

2. Kör installationsprogrammet:

   • Dubbelklicka på den nedladdade MSI-filen för att starta installationsguiden.

3. Följ installationsguiden:

   • Följ instruktionerna på skärmen som tillhandahålls av installationsprogrammet. Du kan behöva godkänna licensavtalet och välja installationsalternativ.

4. Slutför installationen:

   • När installationen är klar kommer Documentize DLL:erna att installeras i din systems globala assemblies-cache (GAC) eller en annan angiven plats.

5. Verifiera installationen:

   • Kontrollera att DLL:erna är korrekt installerade genom att verifiera deras närvaro i den angivna installationsmappen eller GAC.

Fördelar med att använda MSI-installationsprogrammet

• Användarvänlighet:

  • MSI-installationsprogrammet erbjuder en enkel och vägledd installationsprocess. Det hanterar alla nödvändiga konfigurationer och placerar DLL:erna på en central plats, vilket gör det lätt att använda Documentize över flera projekt.

• Systemomfattande installation:

  • MSI-metoden installerar Documentize i systemets globala assemblies-cache (GAC) eller en annan central plats. Detta gör att alla applikationer på systemet kan komma åt DLL:erna utan att behöva referera till dem individuellt i varje projekt.

• Automatiska uppdateringar:

  • Om Documentize tillhandahåller en uppdaterad installationsfil kan du enkelt uppdatera din installation genom att köra den nya MSI-filen, som vanligtvis hanterar uppdateringsprocessen smidigt.

• Konsistens:

  • Att använda MSI-installationsprogrammet säkerställer att alla nödvändiga filer installeras korrekt och konsekvent över olika miljöer, vilket minskar risken för saknade eller felplacerade DLL:er.

Nackdelar med att använda MSI-installationsprogrammet

• Begränsad flexibilitet:

  • MSI-installationsprogrammet installerar Documentize på en systemomfattande plats, vilket kanske inte är lämpligt för alla utvecklingsmiljöer. Det kan sakna den flexibilitet som behövs för projekt specifika konfigurationer eller versioner.

• Potentiell overhead:

  • Att installera DLL:er i GAC kan introducera overhead och komplexitet, särskilt i scenarier där flera versioner av Documentize kan behövas samtidigt.

• Manuell borttagning:

  • Om du behöver avinstallera Documentize måste du använda avinstallationsprogrammet som tillhandahålls av MSI, vilket kan lämna kvar resterande filer eller konfigurationer om det inte hanteras korrekt.

• Versionskonflikter:

  • Systemomfattande installationer kan leda till versionskonflikter om olika projekt kräver olika versioner av Documentize. Hantering av dessa konflikter kan kräva ytterligare konfiguration eller rensning.

Installera Documentize via ZIP

Så här installerar du via ZIP-arkiv

1. Ladda ner ZIP-arkivet:

   • Klicka på v24.12 ZIP för att ladda ner den senaste versionen av Documentize i ett arkivformat.

2. Extrahera innehållet:

   • Efter nedladdning, extrahera innehållet i ZIP-filen till en katalog av ditt val. Du kan välja att behålla dessa filer i en gemensam katalog eller inom din projektstruktur.

3. Lägg till referenser till ditt projekt:

   • Öppna ditt projekt i din IDE (t.ex. Visual Studio).
   • Gå till Projekt > Lägg till referens > Bläddra och navigera till den katalog där du extraherade DLL-filerna.
   • Välj de relevanta DLL-filerna och lägg till dem som referenser till ditt projekt.

4. Manuella uppdateringar:

   • Om en ny version av Documentize släpps måste du manuellt ladda ner det uppdaterade ZIP-arkivet och ersätta de gamla DLL-filerna i ditt projekt med de nya.

Fördelar med att använda ZIP-arkivet

• Full kontroll:

  • Du har full kontroll över var och hur DLL:erna lagras och refereras i ditt projekt. Detta kan vara fördelaktigt om du föredrar en anpassad konfiguration eller behöver hantera beroenden manuellt.

• Ingen beroende av pakethanterare:

  • Till skillnad från NuGet, förlitar du dig inte på en pakethanterare för att hantera installationer. Detta kan vara fördelaktigt i miljöer där pakethanterare inte är tillgängliga eller föredras.

• Portabilitet:

  • ZIP-arkivet kan enkelt delas och flyttas mellan olika system, vilket gör det idealiskt för projekt som behöver vara portabla eller distribueras utan att förlita sig på externa verktyg.

Nackdelar med att använda ZIP-arkivet

• Manuell hantering:

  • Till skillnad från NuGet, där uppdateringar och hantering av beroenden är automatiserad, måste du med ZIP-arkivet hantera uppdateringar manuellt och se till att alla nödvändiga DLL:er refereras korrekt.

• Risk för versionskonflikter:

  • Om du hanterar flera projekt eller arbetar i ett team finns det en risk för versionskonflikter om olika projekt använder olika versioner av DLL:erna. Detta kräver noggrann spårning av versioner mellan projekten.

• Inga automatiska uppdateringar:

  • Du kommer inte att få automatiska uppdateringar eller meddelanden när en ny version är tillgänglig. Detta kan leda till risken att använda föråldrade bibliotek om du inte regelbundet kontrollerar efter uppdateringar.

Icke-Windows-miljö

Arbeta med .NET Core DLL:er i icke-Windows-miljö

Eftersom Documentize för .NET tillhandahåller .NET Standard 2.0 (.NET Core 2.0) stöd, kan det användas i Core-applikationer som körs på Linux-liknande operativsystem. Vi arbetar ständigt med att förbättra .NET Core-stödet i vårt API. Det finns dock vissa åtgärder som vi rekommenderar att våra kunder utför för att få bättre resultat när de använder funktioner i Documentize för .NET. Vänligen installera:

• libgdiplus paket
• Paket med Microsoft-kompatibla typsnitt: ttf-mscorefonts-installer (t.ex., sudo apt-get install ttf-mscorefonts-installer). Dessa typsnitt bör placeras i katalogen /usr/share/fonts/truetype/msttcorefonts eftersom Documentize för .NET skannar denna mapp på Linux-liknande operativsystem. Om operativsystemet har en annan standardmapp/katalog för typsnitt, bör du använda följande kodrad innan du utför någon åtgärd med Documentize:

  Documentize.Pdf.Text.FontRepository.Sources.Add(new FolderFontSource("<användarens sökväg till ms typsnitt>"));

v24.12

Lagt till nytt Plugin: PDF till PNG Converter

• Class PngConverter: Representerar Documentize.PngConverter plugin. Används för att konvertera PDF-dokument till PNG-format.
• Class PdfToPngOptions: Representerar PDF till PNG-konverteringsalternativ för Documentize.PngConverter plugin.

Exempelanvändning:

// skapa PngConverter
var plugin = new PngConverter();
// skapa PdfToPngOptions-objekt för att ställa in instruktioner
var opt = new PdfToPngOptions();
// lägg till sökväg till inmatningsfil
opt.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// ställ in sökväg för utdatafil
opt.AddOutput(new DirectoryDataSource("path_to_results_directory"));
// utför processen
plugin.Process(opt);

Lagt till nytt Plugin: PDF till TIFF Converter

• Class TiffConverter: Representerar Documentize.TiffConverter plugin. Används för att konvertera PDF-dokument till TIFF-format.
• Class PdfToTiffOptions: Representerar PDF till TIFF-konverteringsalternativ för Documentize.TiffConverter plugin.

Exempelanvändning:

// skapa TiffConverter
var plugin = new TiffConverter();
// skapa PdfToTiffOptions-objekt för att ställa in instruktioner
var opt = new PdfToTiffOptions();
// lägg till sökväg till inmatningsfil
opt.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// ställ in sökväg för utdatafil
opt.AddOutput(new DirectoryDataSource("path_to_results_directory"));
// utför processen
plugin.Process(opt);

Lagt till nytt Plugin: PDF Tabellgenerator

• Class TableGenerator: Representerar Documentize.TableGenerator plugin. Används för att lägga till en tabell i ett PDF-dokument.
• Class TableBuilder: Klass som representerar byggare för tabell i pdf-sidan.
• Class TableRowBuilder: Klass som representerar byggare för tabellrad.
• Class TableCellBuilder: Klass som representerar byggare för tabellcell.

Exempelanvändning:

// skapa TableGenerator
var plugin = new TableGenerator();
// skapa TableOptions-objekt för att ställa in instruktioner
TableOptions opt = new TableOptions().InsertPageBefore(1)
   .AddTable()
        .AddRow()
            .AddCell().AddParagraph("Namn")
            .AddCell().AddParagraph("Ålder")
        .AddRow()
            .AddCell().AddParagraph("Bob")
            .AddCell().AddParagraph("12")
        .AddRow()
            .AddCell().AddParagraph("Sam")
            .AddCell().AddParagraph("20")
        .AddRow()
            .AddCell().AddParagraph("Sandy")
            .AddCell().AddParagraph("26")
        .AddRow()
            .AddCell().AddParagraph("Tom")
            .AddCell().AddParagraph("12")
        .AddRow()
            .AddCell().AddParagraph("Jim")
            .AddCell().AddParagraph("27");
// lägg till sökväg till inmatningsfil
opt.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
// ställ in sökväg för utdatafil
opt.AddOutput(new FileDataSource("path_to_the_converted_file.pdf"));
// utför processen
plugin.Process(opt);

Omnamngiven Klass PdfDoc till DocConverter

• Class DocConverter: Representerar Documentize.DocConverter plugin. Används för att konvertera PDF-dokument till DOC/DOCX-format.

Exempelanvändning:

// skapa DocConverter
var plugin = new DocConverter();
// skapa PdfToDocOptions-objekt för att ställa in instruktioner
var opt = new PdfToDocOptions();
// lägg till sökväg till inmatningsfil
opt.AddInput(new FileDataSource(inputPath));
// ställ in sökväg för utdatafil
opt.AddOutput(new FileDataSource(outputPath));
// utför processen
plugin.Process(opt);

v24.11

Lagt till ny plugin: PDF till JPEG-konverterare

• Syfte: Klassen JpegConverter är utformad för att konvertera PDF-dokument till JPEG-format, vilket gör det enklare för användare att hantera och dela bilder som härstammar från PDF-filer.
• Konstruktor:
  • JpegConverter(): Initierar en ny instans av JPEG-konverteraren.

Exempel på användning:

var plugin = new JpegConverter();
var opt = new PdfToJpegOptions();
opt.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
opt.AddOutput(new DirectoryDataSource("path_to_results_directory"));
plugin.Process(opt);

• Metod:
  • Process(PdfToJpegOptions options): Påbörjar JPEG-konverteringsprocessen med de angivna alternativen.

Lagt till klass DirectoryDataSource

• Syfte: Klassen DirectoryDataSource gör det möjligt för användare att hantera katalogdata för inläsning och sparande av operationer inom plugins.
• Konstruktor:
  • DirectoryDataSource(string path): Initierar ett nytt katalogdataobjekt med den angivna sökvägen.

Exempel på användning:

var directorySource = new DirectoryDataSource("path_to_your_directory");

• Egenskaper:
  • DataType: Hämtar typen av datakälla.
  • Path: Hämtar sökvägen till den aktuella datakatalogen.

Lagt till klass PdfToJpegOptions

• Syfte: Denna klass innehåller alternativ för att konfigurera JPEG-konverteringsprocessen, vilket gör det möjligt för användare att specificera upplösning, sidlistor och bildkvalitet.
• Konstruktor:
  • PdfToJpegOptions(): Initierar en ny alternativsinstans för JPEG-konverteraren.

Egenskaper:

• OutputResolution: Anger upplösningen på de resulterande JPEG-bilderna.
• PageList: En lista över sidor som ska konverteras från PDF:en.
• Quality: Anger kvaliteten på JPEG-utdata.

v24.10

Nytt tillagt Plugin: PDF/A Converter

• En ny PDF/A-konverteringsfunktion har introducerats, vilket gör att användare enkelt kan konvertera standard PDF-filer till PDF/A-kompatibla dokument.

Exempel på användning:

var options = new PdfAConvertOptions
{
    PdfAVersion = PdfAStandardVersion.PDF_A_3B
};

options.AddInput(new FileDataSource("path_to_your_pdf_file.pdf"));
options.AddOutput(new FileDataSource("path_to_the_converted_file.pdf"));

var plugin = new PdfAConverter();
plugin.Process(options);

Buggfixar

• Åtgärdade problem relaterade till FileResult-klassen som resulterade i felaktiga utdata vägar.
• Löste mindre buggar som påverkade HtmlConverter vid hantering av stora filer.

Förbättringar

• Förbättrad prestanda för PdfExtractor och ImageExtractor för snabbare bearbetningstider.
• Uppdaterad RotateOptions-klass för att stödja ytterligare rotationsvinklar.

v24.9

Släppt