description: 'Installation & Configuration of the DynamicFieldAttachment Plugin'

DynamicFieldAttachment

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

Overview

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

Installation

1. Via Package Manager

• In the OTOBO Admin area, navigate to System Management → Package Manager, search for DynamicFieldAttachment, and install it.

2. Manual Installation

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

Configuration (SysConfig)

Create Dynamic Field

• Navigate to Admin → Ticket Settings → Dynamic Fields.

• Create a new field of type Attachment.

• Configure:

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

• 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 Management → SysConfig → Frontend → Agent → Ticket → ViewXYZ:

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

Examples:

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

Extend Search Mask

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

Usage

• When creating or editing a ticket, the Attachment field will appear in the configured area.
• Upload files until the "Maximum Number" is reached; then, upon saving, the system checks:
  • Files that are too large will be discarded, and an error message will appear.
  • Duplicate filenames will be blocked.
  • In the ticket zoom view, attachments are displayed as a list; clicking the filename downloads it.

Limitations

• Type Database (DB) is not supported.
• VirtualFS must be configured appropriately for the storage backend.
• Many or large files can impact performance.

Support & Further Information

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