Log selection

Belongs to

Category: General
Type: Checks

What it does

Allows you to log the presence or absence of a selection you made with another Action in the same Action list.

This Action is useful if you want to check something for which no "Check" Action is available. For example, if you want to check if the PDF contains red text, you can first select all red text, and then use Log selection to display a message either if the document does or does not contain red text.

Note that you can also log the presence or absence of layers.

How to proceed

From the list at the top of the pane, choose the appropriate option:
- To display a message if the selection was found, select Log a message if objects are selected.
- To display a message if the selection was NOT found, select Log a message if no objects are selected.
Indicate whether or not the following information should be logged as well (if applicable):
- The type of page and document objects
- The annotation objects
  
  Note: By default, annotations aren't logged. Even if Log selection applies to a selection made by Select annotations, nothing will be logged, unless the Report the annotation objects checkbox is selected.
Enter the message that should appear in the Report if the selection was found/not found (depending on the choice made in step1).

Note: You can configure different descriptions for different languages (for example: JPEG images in English versus JPEG afbeeldingen in Dutch). The language shown in the log file depends on the PitStop Pro language (See Edit > Preferences > PitStop Pro Preferences ).
Select the desired log level.

Note: In this case, it doesn't make sense to choose "Don't log", since the result of this Action is always shown in the Enfocus Navigator.

Example

To check for the presence of red text in a document, you could create the following Action List:

Select fill and stroke color 
        <!-- Add Select color. Select fill and stroke and determine the color you want to check for, for example using the Grab fill and Grab stroke icon -->
Select text segments 
        <!-- Select text segments -->
AND                  
        <!-- AND : necessary to combine the two previous Actions -->
Log selection        
        <!-- Choose "Log a message if objects are selected".
             Configure an English message, for example "This document contains some text in red". 
             Select "Log as warning". -->

If you run this Action List, all red text will be selected and logged as a warning. In the Enfocus Navigator, if you select an object in the Description field, you will see the description ("Red text") under Details. You will also find a warning in the Preflight Report (e.g. "This document contains some text in red (x times on pages y-z)").

Alternatively, if you only want a warning if no red text is found, in the attributes of Log selection, choose "Log a message if no objects are selected" and configure a message such as "This document does not contain any red text".