Grooper Help - Version 25.0
25.0.0017 2,127
  • Overview
  • Help Status

Import Device

Capture Device Grooper.Capture

Implements a virtual scanner by importing images from a file system directory or ZIP file.

Remarks

Overview

The Import Device class simulates a document scanner by importing images from a specified directory or ZIP file, rather than using physical scanning hardware. This enables batch ingestion of images for testing, migration, or integration scenarios where direct scanning is not possible or required.

  • Supports importing from local or network folders, as well as ZIP files (including remote ZIPs via FTP/HTTP/HTTPS).
  • Each scan operation processes the contents of the configured source as a linear stream of images, mimicking the output of a traditional scanner.
  • Useful for environments where images are generated by other systems, or for replaying/scaling up test scenarios.

Configuration and Usage

  • Set the 'Import Source' property to choose between directory or ZIP file import modes.
  • Configure the 'Import Path' or 'ZIP File Path' as appropriate for your source.
  • For remote ZIP files, provide 'User Name' and 'Password' if authentication is required.
  • Use 'Delete Files' to automatically remove source files after successful import (directory mode only).
  • Adjust 'Color Format Conversion' to control color depth, and 'PDF Render Settings' for PDF-to-image conversion.
  • Use 'Scanning Speed' to throttle import rate and simulate scanner throughput.

Features

  • Flexible Import Sources:
    Import from folders, local ZIP files, or remote ZIP files via FTP/HTTP/HTTPS.
  • Authentication Support:
    Supports basic authentication for remote ZIP sources.
  • PDF and Image Handling:
    Automatically splits multi-page PDFs and multi-frame image files.
  • Color and Format Conversion:
    Optionally convert imported images to a specified color format.
  • Iteration:
    The 'Iteration Count' property allows repeated import of the same image set for testing or simulation.
  • Speed Throttling:
    Simulate scanner speeds by limiting images per minute.

Best Practices

  • Use 'Delete Files' with caution to avoid accidental data loss.
  • For large imports, ensure sufficient memory and disk space, especially when using unlimited iteration or high speeds.
  • Test import settings with a small sample before running large jobs.
  • Use 'PDF Render Settings' to optimize quality and performance for PDF sources.

For more information, see the documentation for Capture Device, Scanner Profile, and PDF Render Settings.

Properties

NameTypeDescription

See Also

Used By

Notification