Command Collections in Appligent Command Line Applications

Command Collections are a versatile feature common across many Appligent Command Line Applications, designed to optimize the handling of multiple commands in a single, streamlined process. This functionality is crucial for users looking to automate batch processes, enhance productivity, and improve application performance when working with large collections of documents.

Overview

Command Collections allow users to execute a series of predefined commands stored in a single file, known as the commands file. This feature is particularly useful in environments where operations need to be repeated with various files, ensuring accuracy and efficiency.

Key Features

  • Single File for Multiple Commands: Users can write all commands into a single file, enabling batch processing with just one command to the application.
  • Progress Information: The -p option can be used with any command to provide real-time progress updates, helping users monitor the status of the processing tasks.
  • Log File Support: The -l option allows the outputs and activities of the command execution to be logged into a specified file, aiding in debugging and record-keeping.
  • Flexibility: Command Collections support a range of modifiers and options specific to each application's functionality, such as -optimize, -x, and -f, to cater to different needs and scenarios.

Applications and Examples

StampPDF Batch Example

To automate the stamping of multiple PDF documents using StampPDF Batch, prepare a commands file as follows:

-p -bates 1001 -o /appligent/stamppdf/samples/output/output1.pdf /appligent/stamppdf/samples/input/input1.pdf
-p -bates 1002 -o /appligent/stamppdf/samples/output/output2.pdf /appligent/stamppdf/samples/input/input2.pdf
-p -bates 1003 -o /appligent/stamppdf/samples/output/output3.pdf /appligent/stamppdf/samples/input/input3.pdf

Execute the commands by running:

$ ./stamppdfapp -p -l stamplog.txt -cmds CommandFile.txt

This command batch processes each PDF file with a unique Bates number, logging all activities to stamplog.txt.

FDFMerge Example

For merging FDF data into PDF forms using FDFMerge or FDFMerge Lite, create a commands file like this:

-p -optimize -f /appligent/fdfmerge/samples/testfiles/testfile1.txt -o /appligent/fdfmerge/samples/testfiles/outfile1.pdf /appligent/fdfmerge/samples/testfiles/testfile.pdf /appligent/fdfmerge/samples/testfiles/testfile.fdf
-p -x -o /appligent/fdfmerge/samples/testfiles/outfile2.pdf /appligent/fdfmerge/samples/testfiles/testfile.pdf /appligent/fdfmerge/samples/testfiles/testfile.xfdf
-p -w -x -f /appligent/fdfmerge/samples/healthform/healthform3.txt -o /appligent/fdfmerge/samples/healthform/outfiles3.pdf /appligent/fdfmerge/samples/healthform/healthform.pdf /appligent/fdfmerge/samples/healthform/healthform.xfdf

Run the command collection with:

$ ./fdfmergeapp -p -l mergelog.txt -cmds CommandFile.txt

This process will merge each form with its respective data file, optimizing the output and logging the process to mergelog.txt.

Monitoring and Outputs

The -p option will display progress in the terminal, giving you real-time updates on the status of the processing tasks. Check the output PDFs in the specified directories to ensure they are processed as expected and consult the logfile.txt for a detailed log of operations, which can help in troubleshooting and verifying task completions.

Conclusion

Appligent's Command Collections feature offers significant advantages by automating complex processes across multiple files with precision and efficiency. By integrating this capability into your workflow, you can enhance productivity, and dramatically improve application performance.