EnableTrace Property

Summary

Indicates whether this DocumentConverter should output debug messages to the standard .NET trace listeners.

Syntax

C++/CLI

Java

Python

public bool EnableTrace { get; set; }

public:  
   property bool EnableTrace 
   { 
      bool get() 
      void set(bool value) 
   }

public boolean getEnableTrace() 
public void setEnableTrace(boolean value)

EnableTrace # get and set (DocumentConverterDiagnostics)

Property Value

true if this DocumentConverter should output debug messages to the standard .NET trace listeners; otherwise, false Default value is false.

Remarks

If the value of this property is set to true, then this DocumentConverter object will output debug messages with current status (page being loaded, converted, saved, etc.) and any errors that may occur to the default .NET trace listener.

For example, to enable tracing to the .NET console, use the following code:

// Trace to the console 
System.Diagnostics.Trace.Listeners.Add(new TextWriterTraceListener(Console.Out)); 
// Enable tracing in the document converter 
documentConverter.Diagnostics.EnableTrace = true; 
// Run the job 
documentConverter.Jobs.RunJob(job);

When tracing is enabled, the engine will use the DocumentConverterJobData.JobName value when writing trace messages to help easily identity jobs.

For more information on .NET tracing and how to redirect the messages to a file, the system log or a database, refer to System.Diagnostics.Trace in MSDN.

Example

Java

using Leadtools; 
using Leadtools.Codecs; 
using Leadtools.Document.Writer; 
using Leadtools.Svg; 
using LeadtoolsExamples.Common; 
using Leadtools.Document; 
using Leadtools.Caching; 
using Leadtools.Annotations.Engine; 
using Leadtools.Ocr; 
using Leadtools.Document.Converter; 
using Leadtools.Annotations.Rendering; 
 
public void DocumentConverterDiagnosticsExample() 
{ 
   using (DocumentConverter documentConverter = new DocumentConverter()) 
   { 
      //enables diagnostics print out 
      documentConverter.Diagnostics.EnableTrace = true; 
 
      //output traces to console's window 
      Trace.Listeners.Add(new TextWriterTraceListener(Console.Out)); 
 
      var inFile = Path.Combine(ImagesPath.Path, @"Leadtools.docx"); 
      var outFile = Path.Combine(ImagesPath.Path, @"output.pdf"); 
      var format = DocumentFormat.Pdf; 
      var jobData = DocumentConverterJobs.CreateJobData(inFile, outFile, format); 
      jobData.JobName = "conversion job"; 
 
      var job = documentConverter.Jobs.CreateJob(jobData); 
      documentConverter.Jobs.RunJob(job); 
 
      if (job.Status == DocumentConverterJobStatus.Success) 
      { 
         Console.WriteLine("Success"); 
      } 
      else 
      { 
         Console.WriteLine("{0} Errors", job.Status); 
         foreach (var error in job.Errors) 
         { 
            Console.WriteLine("  {0} at {1}: {2}", error.Operation, error.InputDocumentPageNumber, error.Error.Message); 
         } 
      } 
   } 
}

 
import static org.junit.Assert.assertTrue; 
 
import java.io.File; 
import java.io.FileOutputStream; 
import java.io.IOException; 
import java.net.URI; 
import java.util.concurrent.Executors; 
import java.util.logging.ConsoleHandler; 
import java.util.logging.Handler; 
import java.util.logging.Level; 
import java.util.logging.Logger; 
 
import org.junit.*; 
import org.junit.runner.JUnitCore; 
import org.junit.runner.Result; 
import org.junit.runner.notification.Failure; 
 
import leadtools.*; 
import leadtools.annotations.rendering.AnnJavaRenderingEngine; 
import leadtools.caching.FileCache; 
import leadtools.codecs.*; 
import leadtools.document.DocumentFactory; 
import leadtools.document.DownloadDocumentOptions; 
import leadtools.document.LEADDocument; 
import leadtools.document.LoadDocumentOptions; 
import leadtools.document.LoadFromCacheOptions; 
import leadtools.document.UploadDocumentOptions; 
import leadtools.document.converter.DocumentConverter; 
import leadtools.document.converter.DocumentConverterEmptyPageMode; 
import leadtools.document.converter.DocumentConverterJob; 
import leadtools.document.converter.DocumentConverterJobData; 
import leadtools.document.converter.DocumentConverterJobError; 
import leadtools.document.converter.DocumentConverterJobErrorMode; 
import leadtools.document.converter.DocumentConverterJobStatus; 
import leadtools.document.converter.DocumentConverterJobs; 
import leadtools.document.writer.DocumentFormat; 
import leadtools.document.writer.DocumentWriter; 
import leadtools.ocr.OcrEngine; 
import leadtools.ocr.OcrEngineManager; 
import leadtools.ocr.OcrEngineType; 
 
 
public void documentConverterDiagnosticsExample() { 
   String LEAD_VARS_ImagesDir = "C:\\LEADTOOLS23\\Resources\\Images"; 
   DocumentConverter documentConverter = new DocumentConverter(); 
   documentConverter.getDiagnostics().setEnableTrace(true); 
 
   Logger logger = Logger.getLogger(DocumentConverter.class.getName()); 
   logger.setLevel(Level.ALL); 
   Handler consoleHandler = new ConsoleHandler(); 
   consoleHandler.setLevel(Level.ALL); 
   logger.addHandler(consoleHandler); 
 
   String inFile = combine(LEAD_VARS_ImagesDir, "Leadtools.pdf"); 
   String outFile = combine(LEAD_VARS_ImagesDir, "output.docx"); 
   DocumentFormat format = DocumentFormat.DOCX; 
   DocumentConverterJobData jobData = DocumentConverterJobs.createJobData(inFile, outFile, format); 
   jobData.setJobName("Conversion Job"); 
   RasterDefaults.setExecutorService(Executors.newFixedThreadPool(5)); 
 
   DocumentConverterJob job = documentConverter.getJobs().createJob(jobData); 
   documentConverter.getJobs().runJob(job); 
   assertTrue(job.getStatus() == DocumentConverterJobStatus.SUCCESS); 
 
   if (job.getStatus() == DocumentConverterJobStatus.SUCCESS) { 
      System.out.println("Success!"); 
   } else { 
      for (DocumentConverterJobError error : job.getErrors()) { 
         System.out.println(error.getError().toString()); 
      } 
   } 
}

Requirements

Target Platforms

Reference

DocumentConverterDiagnostics Class

DocumentConverterDiagnostics Members

Leadtools.Document.Converter Namespace

Download our FREE evaluation

Help Version 23.0.2024.2.29

Leadtools.Document.Converter Assembly

Introduction

Getting Started

Namespaces

Leadtools.Document.Converter Namespace

Assemblies