Skip to content

DynamicFieldAttachment

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

Visão Geral

Com o plugin DynamicFieldAttachment, você adiciona um novo campo dinâmico do tipo "Anexo" a tickets e artigos. Os administradores configuram via SysConfig se anexos são permitidos por ticket ou por artigo e definem a quantidade máxima e o tamanho do arquivo.

Instalação

  1. Via Gerenciador de Pacotes
  • No área de administração do OTOBO, em Gerenciamento de Sistema → Gerenciamento de Pacotes, procure e instale DynamicFieldAttachment.
  1. Instalação Manual
  • Descompacte o arquivo do plugin para Kernel/Config/Files/.
  • Em Gerenciamento de Sistema → Atualizar, recarregue o sistema de arquivos.

Configuração (SysConfig)

Criar Campo Dinâmico

  • Navegue até Admin → Configurações de Ticket → Campos Dinâmicos.

  • Crie um novo campo do tipo Anexo.

  • Configure:

  • Nome: Identificador único (apenas letras e números).

  • Rótulo: Rótulo de exibição.

  • Ordem do Campo: Posição relativa a outros campos.

  • Validade: Defina como "válido".

  • Quantidade Máxima: Número de arquivos permitidos por ticket/artigo.

  • Tamanho Máximo do Arquivo: Tamanho máximo do arquivo em MB.

Registro de Backend

  • DynamicFields::Backend::Registration → ItemSeparator Separador entre o nome do arquivo e o tamanho na história do ticket.

Exibição em Interfaces

Para cada visualização desejada em Admin → Gerenciamento de Sistema → SysConfig → Frontend → Agente → Ticket → ViewXYZ:

  • Em Ticket::Frontend::AgentXYZ###DynamicField, adicione o nome do campo usando o símbolo "+".
  • Conteúdo "1" = Exibição, "2" = Campo obrigatório.

Exemplos:

  • ViewZoom para visualização de ticket em zoom.
  • ViewNote para diálogo de nota.
  • ViewPhoneNew para novo ticket de telefone.

Ampliar Máscara de Pesquisa

  • Em Frontend → Agente → Ticket → ViewSearch → Ticket::Frontend::AgentTicketSearch###DynamicField, adicione o nome do campo para pesquisar por nome de arquivo.

Uso

  • Ao criar/alterar um ticket, o campo de anexo aparece na área configurada.

  • Faça upload de arquivos até atingir a "Quantidade Máxima"; em seguida, ao salvar, é verificado:

  • Arquivos muito grandes são rejeitados e uma mensagem de erro é exibida.

  • Nomes de arquivos duplicados são bloqueados.

  • Na visualização de zoom do ticket, anexos são exibidos como lista; clique no nome do arquivo para baixá-lo.

Restrições

  • Tipo de Banco de Dados (DB) não suportado.
  • Para o backend de armazenamento, VirtualFS deve ser configurado corretamente.
  • Muitos ou grandes arquivos podem afetar o desempenho.

Suporte & Recursos Adicionais