Entidade ARQUIVOS_ANEXOS

ARQANE.ARQUIVOS_ANEXOS

Descrição

Os arquivos anexos ao registros do sistema. Cada arquivo pode ter um objetivo diferente (dependendo do tipo de anexo) e um tipo de arquivo (normalmente representado pela extensão do arquivo anexado).

Anexos podem ser utilizados de inúmeras formas, tal como:

Atributos

AtributoDomínioRegrasDescrição
IDID(18)Rqd PK Id:
Chave de identificação interna
ARQUIVO_ANEXOTEXT(1024)Rqd UK Arquivo anexo:
Identificação do arquivo anexo.
Gerado automaticamente concatenando pasta, nome e extensão.
Ver procedimento específico para maiores detalhes.

Exemplos:
  • 00/00/01.jpg
  • 02/38/51.wmv
NOMETEXT(250)Nome:
Nome do arquivo. Preenchido pelo processo de upload.
TITULOTEXTTítulo:
Título (legenda) informada para o arquivo.
Pode ser o título do relatório, uma legenda para uma foto, etc.
DESCRICAOTEXT_LONGDescrição:
Texto livre para descrever/resumir o conteúdo do arquivo.
TIPO_ANEXO_IDID(18)Rqd FK Tipo de anexo:
Indica o tipo de anexo que o arquivo representa. Os tipos de anexos estabelecem como os arquivos anexos são classificados com relação a sua finalidade. Este tipo está relacionado com o que o arquivo representa e não com o formato como ele está armazenado. Com os tipos de anexos pode-se, por exemplo, separar as fotos de um produto que vão para as lojas virtuais de outras fotos que não devem ir.
Exemplos de tipos de anexos são: Foto, Desenho, Contrato, Manual, Planta baixa, Tutorial, Relatório NF, Relatório Pedido de Compra, etc.

Ver Tipos de anexos

Referência para TIPOS_ANEXOS
TIPO_ARQUIVO_IDID(18)Rqd FK Tipo de arquivo:
Indica o tipo de arquivo (formato dos dados). Caso não informado, o sistema tenta descobrir por conta própria. O tipo de arquivo permite, por exemplo, estabelecer como o arquivo pode ser visualizado
Ver Tipos de arquivos.

Exemplos:
  • XLS
  • DOC
  • GIF
  • JPG
  • WMV
  • AVI

Referência para TIPOS_ARQUIVOS
ARQUIVOATTACHED_FILE(250)Arquivo:
Opção para upload (carga) do arquivo. Abre uma janela do sistema operacional para escolha do arquivo a ser carregado.
Note que existem situações, como na geração de documentos, onde o arquivo é informado apenas posteriormente.
DATA_ARQUIVODATE_TIMEData do arquivo:
Data (e hora) do arquivo no sistema operacional.
TAMANHOINTEGERTamanho:
Tamanho do arquivo em bytes.
MD5UPPERAK MD5:
Hash MD5 do arquivo calculado automaticamente. Este MD5 pode ser utilizado nos processos de replicação e outros processos onde seja necessário identificar se o arquivo existe ou não no repositório de arquivos.
DATA_VALIDADEDATEAK Data de validade:
Indica a data limite para validade do arquivo. Após esta data, o sistema poderá eliminar o arquivo automaticamente.
ORIGEMTEXT_LONGOrigem:
Descrição da origem deste arquivo.
No caso de upload, a origem inclui o caminho e nome originais do arquivo.
SEQUENCIAINTEGERRqd Sequência:
Número para forçar uma ordenação dos arquivos anexos.
Desta forma é possível apresentar os arquivos na ordem desejada.

Valor padrão = 50
MODELO_UTILIZADO_IDID(18)FK Modelo utilizado:
Modelo de documento utilizado para geração do arquivo. Utilizado no caso de arquivos gerados pelo sistema e que se deseja manter uma cópia do mesmo.

Referência para MODELOS_DOCUMENTOS
SETOR_IDID(18)FK Setor:
Setor/departamento da empresa que gerou o documento.

Referência para AREAS_FUNCIONAIS
USUARIO_IDID(18)FK Usuário:
Indica o usuário que incluiu o arquivo no sistema.
Pode ser nulo (não informado) caso o arquivo seja gerado por algum processo batch (job ou outro processo externo).

Valor padrão = [USER_ID]
Referência para USUARIOS
DATA_INCLUSAODATE_TIMERqd Data de inclusão:
Data e hora de cadastro ou inclusão do arquivo.

Valor padrão = [SYSDATE]
USUARIO_ALTERACAO_IDID(18)FK Usuário alteração:
Usuário que realizou a última atualização no arquivo.

Referência para USUARIOS
DATA_ALTERACAODATE_TIMEData de alteração:
Data e hora da última alteração deste registro.

Valor padrão = [SYSDATE]
DATA_CANCELAMENTODATE_TIMEData de cancelamento:
Data e hora de cancelamento do arquivo gerado. Isso indica que o arquivo, apesar de estar registrado no sistema, não é mais válido.

Regras

Calcular o tipo de anexo

(Antes de inserir)
Caso o tipo de anexo não seja informado e existir um modelo informado, então definir o tipo de anexo como sendo o memo do modelo.

Calcular o tipo de arquivo

(Antes de inserir, Antes de alterar)
Caso não informado, o sistema define o tipo de arquivo a partir de extensão do mesmo.

Calcular a data de validade

(Antes de inserir, Antes de alterar)
A data de validade é calculada de acordo com o tipo de anexo.
Se o tempo de retenção for nulo, a data de validade também é nula (nunca será excluído).
Se o tempo de retenção for zero, assumir o valor em ARQANE.ARQUIVOS_ANEXOS.RETENCAO_MINIMA (default = 0,1 dias)
A data de validade será igual a data de emissão + o tempo de retenção.

Informar data e usuário que alterou

(Antes de alterar)

Obter dados físicos do arquivo

(Antes de inserir, Antes de alterar)
Esta rotina obtém alguns dados do arquivo físico:

Nas alterações, verifica se o arquivo existe e somente atualiza o MD5 se o tamanho e/ou data do arquivo forem alterados.

Preencher valores default

(Antes de inserir, Antes de alterar)
Método que preenche valores default para o arquivo anexo, quando não informados.

Gerar a identificação do arquivo

(Antes de inserir, Antes de alterar)
Gera a identificação do arquivo anexo conforme as preferencias ARAN.FILE_NAME_LENGHT e ARAN.FOLDER_LEVELS.

O nome do arquivo será formado pela concatenação do caminho do arquivo com seu nome e sua extensão. Ex: Se forem 3 níveis e com tamanho de arquivo de 2 caracteres, então um nome de arquivo poderia ser, p.ex.: 00/00/01.gif.

Excluir arquivo do sistema operacional

(Depois de excluir)
Excluir arquivo do sistema operacional.

Validar arquivos anexos

(Antes de inserir, Antes de alterar)
Validação para garantir que o arquivo inserido é compatível com o que está definido no tipo de anexo.

Limpar

Rotina que elimina todos os arquivos cujo tempo de retenção expirou.
Arquivos com retenção 0 serão removidos apenas 0,1 dias (2,4 horas) depois de sua emissão (parâmetro ARQANE.ARQUIVOS_ANEXOS.RETENCAO_MINIMA) para evitar a limpeza de arquivos que estão na tela de impressão.

Iniciais do nome do usuário

Retornar as iniciais do nome do usuário que gerou o arquivo.

Revisar informações dos arquivos

Revisa todos os arquivos que estão na pasta "files" e garante que as informações da entidade estão atualizadas.
Esta rotina irá: