Administrar anexos

  • Versão de lançamento: Xanadu
  • Atualizado 1 de ago. de 2024
  • 3 min. de leitura
  • Os administradores podem configurar propriedades do sistema para como os arquivos são carregados e anexados aos registros. Carregar, exibir e excluir anexos de arquivo aciona um único evento que pode ser usado para notificações ou em scripts.

    Tabelas de anexos

    Quando você armazena um anexo em qualquer tabela, um registro é criado na tabela Anexo [sys_attachment] que contém metadados de anexo. Os dados do arquivo são armazenados na tabela Documento de anexo [sys_attachment_doc], em blocos de 4k. Por exemplo, se você anexar um arquivo de 12k chamado My_attachment.pdf, haverá uma entrada de anexo com três entradas de documento de anexo relacionadas.

    Para saber como carregar anexos em registros, consulte Adicionar e gerenciar anexos.

    Escalonamento da miniatura do fluxo de atividades

    A propriedade glide.ui.activity_stream.scale_images reduz imagens grandes e cria miniaturas para a exibição do fluxo de atividades das imagens. Esta propriedade está ativa por padrão. Isso se aplica a imagens retroativamente, portanto, todos os anexos incluídos em um fluxo de atividades no passado também veem os efeitos.
    • As dimensões máximas das miniaturas que usam esta propriedade são de 525 pixels de largura por 350 pixels de altura. O sistema privilegia a altura do pixel primeiro, para que você possa obter imagens com mais de 525 pixels.
    • Anexar arquivos de imagem com mais de 5 MB pode criar um erro de falta de memória e fazer com que a instância seja reiniciada. Ocorre um erro de falta de memória e uma reinicialização quando o sistema gera a miniatura ao anexar uma nova imagem. O erro e a reinicialização também podem ocorrer na primeira vez que você carrega imagens existentes em um registro.
    • O administrador pode adicionar a propriedade do sistema com.glide.attachment.max_get_size para controlar as dimensões máximas de escalonamento de imagem.
    Insira as seguintes informações na tabela [sys_properties.list]:
    Campo Descrição
    Nome com.glide.attachment.max_get_size
    Tipo inteiro
    Valor 5242880
    O campo de valor representa o tamanho em bytes.
    • O valor do sistema base é 5242880 bytes (5 MB). Você pode alterar o valor conforme necessário.
    • Com este conjunto de propriedades, as imagens com mais de 5 MB não são dimensionadas e, em vez disso, o sistema cria um link. Imagens com menos de 5 MB são reduzidas.

    Configurar a propriedade de tamanho máximo de imagem para fluxos de atividades

    Ao anexar uma imagem em um fluxo de atividades, o sistema controla o tamanho máximo da imagem. Use a propriedade com.glide.attachment.max_get_size para controlar as dimensões máximas de escalonamento da imagem.

    Eventos de anexo e registro em log

    Uma ação de script ou notificação pode processar eventos de anexo. Somente um evento é criado quando a ação é executada em um registro com anexos, mesmo quando o registro tem vários anexos. Os eventos a seguir são fornecidos.

    Somente um evento é criado quando a ação é executada em um registro com anexos, mesmo quando o registro tem vários anexos. Os eventos a seguir são fornecidos.

    Tabela 1. Eventos de anexo
    Evento Descrição
    anexo.ler Um anexo foi lido ou baixado.
    anexo.carregado Um anexo foi carregado. Se vários anexos forem carregados em um registro de uma só vez, somente um evento será criado.
    anexo.excluído Um anexo foi excluído. Este evento também é acionado quando o registro que contém o anexo é excluído. Se um registro que contém vários anexos for excluído, um evento separado será acionado para cada anexo no registro excluído.
    anexo.renomeado Um anexo foi renomeado.

    Registro em log de anexos

    Quando um anexo é baixado, o registro de evento attachment.read é gravado e você pode fazer algo com este evento. Por exemplo, você pode registrar quando e por quem determinados anexos são baixados. Para esta funcionalidade, o registro atual é sys_attachment e o registro de evento usa os seguintes parâmetros:
    • parm1: nome do arquivo
    • parm2: nome da tabela

    Depurar indexação de anexos

    Para alterar as opções de depuração da indexação de anexos, adicione estas propriedades do sistema.

    • glide.ts.index.attachment.debug: quando o valor é definido como verdadeiro, habilita mensagens de log para exceções que ocorrem ao indexar anexos (o padrão é falso).

      Você pode deixar esta propriedade habilitada durante as operações normais para capturar informações de rastreamento de pilha sobre quaisquer exceções.

    • glide.ts.index.attachment.list_terms.debug: quando o valor é definido como verdadeiro, registra todos os termos indexados quando um anexo é indexado (o padrão é falso).

      [Recomendado] Para obter o desempenho ideal, defina esta propriedade como falsa durante as operações normais. Habilite esta propriedade somente quando estiver depurando ativamente um problema.

    Nota:
    Para saber mais sobre as propriedades que afetam o processamento de anexos, consulte Anexos (proteção de segurança da instância) em Configurações de proteção de segurança da instância.