Subfile Link

The 'Offset' property specifies the position, in bytes, from the beginning of the parent file where the subfile content starts.

• Used in conjunction with 'Length' to define the exact byte range for the Subfile Link.
• The value must be zero or greater and should not exceed the size of the parent file.

This property is essential for extracting or referencing a specific segment of a larger file, such as a page or document within a multi-document PDF or TIFF.

> Example:
Offset = 1024 (starts at the 1025th byte of the parent file)

The 'Length' property indicates the number of bytes, starting from 'Offset', that make up the subfile content.

• Used to determine how much data to read from the parent file for this Subfile Link.
• Must be a positive value and, when added to 'Offset', should not exceed the parent file's total size.

This property allows Grooper to treat a segment of a file as a distinct document, supporting scenarios such as splitting multi-document files or referencing embedded content.

> Example:
Length = 4096 (the subfile is 4096 bytes long, starting at the specified 'Offset')

The 'Mime Type' property returns the MIME type associated with the subfile, as determined by the parent Batch Folder's attachment.

• Used by Grooper to identify the file format and select appropriate processing or export logic.
• Common values include application/pdf, image/tiff, and others, depending on the parent file.

This property ensures that the subfile is handled correctly throughout the workflow, including extraction, validation, and export.

The 'Error Message' property is populated if Grooper encounters an error when accessing, loading, or updating the external content referenced by this link. This can help diagnose connectivity issues, permission problems, or missing content in external systems.

The 'Filename' property provides the name of the external file referenced by this Document Link, excluding any directory information. This value is useful for display, logging, and when exporting or processing files.

The filename is typically derived from the external file's path and is used throughout Grooper to identify the document in user interfaces, reports, and export operations.

For example, if the external file path is /invoices/2024/invoice.pdf, the 'Filename' will be invoice.pdf.

This property is read-only and is determined automatically from the linked file.

The 'MIME Type' property indicates the media type of the external document, such as application/pdf or image/tiff. This value is used by Grooper to determine how to process, display, or export the file.

The MIME type is typically inferred from the file extension, but may also be set explicitly by the import or export provider.

Correct configuration of the MIME type ensures that the document is handled appropriately throughout the Grooper workflow, including extraction, conversion, and export scenarios.

The 'Size' property provides the total size of the external document referenced by this Document Link, measured in bytes. This value is useful for storage planning, validation, and reporting.

The size is determined from the external file's metadata and is updated whenever the link is refreshed or the file is modified.

For example, a 2 MB PDF file will have a 'Size' value of 2,097,152 bytes.

This property is read-only and always reflects the current size of the file as reported by the external system.

The 'Link Name' distinguishes this Content Link from others attached to the same Batch Folder. Common values include "Import" for links created during import, and "Export" for links created during export. This property is used to track the origin or purpose of the link, and is referenced by the 'ImportLink' and 'ContentLink' properties on Batch Folder.

The 'Path' property returns the directory or container path of the external content, excluding the item name itself. This is useful for understanding the organization of content in external systems, and for display or navigation purposes.

If available, this property provides the user or account that originally created the external content. This information is typically populated for repository-based links (such as CMIS Repository), and may be null for file system links.

Indicates when the external content was originally created. This value is useful for auditing and tracking purposes, and is populated when available from the external system.

If available, this property provides the user or account that most recently modified the external content. This is typically available for repository-based links, and may be null for file system links.

Indicates the last modification date and time for the external content. This value is useful for tracking changes and is populated when available from the external system.