Processor

Create your first pipeline

Build, test and switch on a pipeline that compresses PDFs. You need management access.

The editor walkthrough works on Stirling Cloud and self-hosted servers. The folder walkthrough needs a self-hosted server, because Stirling Cloud has no Folder sources.

Compress editor downloads#

  1. Open Processor → Pipelines → New custom pipeline and name it Compress downloads.
  2. Choose Editor as the input and set Runs on to Every export.
  3. Select Add a tool, add Compress and choose the settings. Leave the destination as Editor.
  4. Select Test with a file and check the result.
  5. Select Create pipeline.
  6. Open a PDF in the editor and download it. The download is the compressed file.

An editor pipeline runs for everyone in your team, and each run uses credits (Credits). To read from or deliver to storage instead, connect an Amazon S3 source.

Compress files from a server folder#

An administrator must first allow the folders you use (Processor server settings).

1. Connect an inbox#

  1. Open Processor → Sources → Connect source.
  2. Choose Folder.
  3. Name it Invoice inbox and under Folder enter a path on the server, such as /data/processor/inbox.
  4. Leave Folder depth at Top level only.
  5. Expand Advanced. Under After processing, choose Keep it, and only process it again if it changes so testing does not delete originals.
  6. Select Create source.

Folder source configuration with advanced processing controls

Originals stay in place, and an unchanged file is not processed again.

2. Connect an output folder#

Create another Folder source named Processed invoices, with a path such as /data/processor/processed. Keep it outside the inbox so the pipeline does not process its own output.

3. Build the pipeline#

  1. Open Pipelines → New custom pipeline.
  2. Name it Compress incoming invoices.
  3. Choose Invoice inbox as the input and leave the trigger at Manual only.
  4. Select Add a tool, add Compress and choose the compression settings.
  5. Select Processed invoices as the destination.
  6. Complete any settings the builder highlights.

Compress incoming invoices pipeline: Invoice inbox, Compress, and Processed invoices

4. Test one document#

Select Test with a file and choose a sample PDF. The results come back as a download and are not delivered to the destination. Check the content, page count and file size.

Test with a file button above the pipeline steps

5. Save, then turn it on#

Save with Create paused while you finish checking. When you are ready, open the pipeline, change its trigger to Folder watch, select Save changes, then select Activate.

Place a new PDF in the inbox and confirm the result reaches the output folder.

6. Check it runs#

Open Documents for the processing record and Review if a run fails. Before switching the inbox to Delete the file, confirm deliveries work: originals are removed once delivered (Decide what happens to originals).