Skip to content
OTOBO Community Guide

DynamicFieldAttachment

DynamicFieldAttachment

Section titled “DynamicFieldAttachment”

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

Overview

Section titled “Overview”

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

Installation

Section titled “Installation”
  1. Via Package Manager
  • In the OTOBO admin area under System Administration → Package Manager, search for DynamicFieldAttachment and install it.
  1. Manual Installation
  • Unpack the plugin archive to Kernel/Config/Files/.
  • In System Administration → Update, reload the file system.

Configuration (SysConfig)

Section titled “Configuration (SysConfig)”

Create DynamicField

Section titled “Create DynamicField”

  • Navigate to Admin → Ticket Settings → Dynamic Fields.

  • Create a new field of the 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

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

Display in Interfaces

Section titled “Display in Interfaces”

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

  • Under Ticket::Frontend::AgentXYZ###DynamicField, enter the field name using ”+”.
  • Content “1” = display, “2” = mandatory field.

Examples:

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

Extend Search Mask

Section titled “Extend Search Mask”
  • In Frontend → Agent → Ticket → ViewSearch → Ticket::Frontend::AgentTicketSearch###DynamicField, add the field name to search for filenames.

Usage

Section titled “Usage”

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

  • Upload files until the “Maximum number” is reached; subsequently, the following is checked upon saving:

  • Files that are too large are rejected and an error message appears.

  • Duplicate filenames are blocked.

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

Limitations

Section titled “Limitations”
  • Type Database (DB) is not supported.
  • For the storage backend, VirtualFS must be configured appropriately.
  • Many or large files can affect performance.

Support & Further Information

Section titled “Support & Further Information”