DynamicFieldAttachment

Compatibility OTOBO ≥ 11.0.x, Znuny ≥ 7.0.x

Overview

The DynamicFieldAttachment plugin allows you to add a new dynamic field of the "Attachment" type to tickets and articles. Administrators use SysConfig to configure whether attachments are allowed per ticket or per article and set the maximum number and file size.

Installation

1. Via the Package Manager

• In the OTOBO admin area under System Administration → Package Management, search for DynamicFieldAttachment and install it.

2. Manual Installation

• Unpack the plugin archive to Kernel/Config/Files/.
• In System Administration → Update, reload the file system.

Configuration (SysConfig)

Creating a DynamicField

• Navigate to Admin → Ticket Settings → Dynamic Fields.

• Create a new field of type Attachment.

• Configure:

• Name: Unique identifier (only letters and numbers).

• Label: Display label.

• Field Order: Position relative to other fields.

• Validity: Set to "valid".

• Maximum Number: Number of allowed files per ticket/article.

• Maximum File Size: Maximum size per file in MB.

Backend Registration

• DynamicFields::Backend::Registration → ItemSeparator Separator between filename and size in the ticket history.

Display in Interfaces

For each desired view in Admin → System Administration → SysConfig → Frontend → Agent → Ticket → ViewXYZ:

• Under Ticket::Frontend::AgentXYZ###DynamicField, add the field name using "+".
• Content "1" = Display, "2" = Required field.

Examples:

• ViewZoom for the ticket zoom view.
• ViewNote for the note dialog.
• ViewPhoneNew for a new phone ticket.

Extending the Search Mask

• In Frontend → Agent → Ticket → ViewSearch → Ticket::Frontend::AgentTicketSearch###DynamicField, add the field name to search by filename.

Usage

• When creating/editing a ticket, the attachment field appears in the configured area.

• Upload files until the "Maximum Number" is reached; the following checks are performed upon saving:

• Files that are too large are discarded, and an error message is displayed.

• Duplicate filenames are blocked.

• In the ticket zoom view, attachments are displayed as a list; clicking the filename downloads the file.

Limitations

• Database type (DB) is not supported.
• The VirtualFS storage backend must be configured appropriately.
• Many or large files can affect performance.

Support & Further Information

• Manufacturer: Rother OSS GmbH
• Version: 6.0.21
• Documentation: OTOBO Docs
• Contact: hello@otobo.de