Manufatura - Linha Datasul - MMI - Anexar documento e imagem na ordem de manutenção

 Tempo aproximado para leitura: 00:03:05 min

Dúvida
Como anexar documento e/ou imagem na Ordem de Manutenção nos programas MI0307 - Manutenção Manual Ordem Manutenção e html.mi0307 - Ordem de Manutenção Web?

Ambiente
TOTVS Manufatura - TOTVS Manufatura (Linha Datasul) - Manutenção Industrial (MMI) - Versão 12

Solução
O catálogo de documentos é definido nos Parâmetros da manutenção Industrial - MI0101, na Página  7, campo Catálogo Documento, com a seleção de um dos catálogos disponíveis na Pesquisa Catálogo Documentos Anexo - BTB003KA.

Versão clássica - tela Progress
Somente os arquivos existentes no caminho definido pelo catálogo selecionado é que estarão disponíveis para visualização no Cadastro da Ordem de Manutenção - MI0307.

Para anexar um documento à ordem de manutenção no modelo clássico utiliza-se o programa MI0307 na alteração da ordem de manutenção Página 2 campo Documento Anexo.
O documento deve ser selecionado no zoom do campo, que abre a tela Pesquisa documento anexo - BTB002KA. Para novos arquivos o documento deve ser cadastrado. O documento deve estar disponível no diretório definido para o catálogo.

O nome do documento em anexo não necessariamente precisa ter o mesmo nome do arquivo. No cadastro documento é definido um nome para o documento, catálogo e arquivo. O catálogo deve ser obrigatoriamente o catálogo dos documentos definidos no MI0101. 

Versão web - tela HTML
Para o anexo de documento via Ordem de manutenção web - html.mi0307 o funcionamento ocorre de forma diferenciada da versão clássica - MI0307. Na versão clássica é necessário primeiro realizar o cadastro do documento ou informar o nome do documento, contudo não é validado a existência no diretório do catálogo, caso informado um nome sem arquivo vinculado.

Na tela web é utilizado o conceito de upload. Neste processo não é necessário o cadastro do arquivo. Basta apenas realizar o upload, utilizando a opção Selecionar Arquivo e o arquivo é copiado para o diretório do catálogo de documentos. Para o uso de upload é obrigatório que o catálogo de documentos esteja informado no programa MI0101.

O upload sempre utilizará o diretório do catálogo de documentos e é necessário que este diretório esteja visível para o servidor do AppServer Progress. Geralmente é utilizado um diretório da rede interna. No programa html.environmentInf - Informações do Ambiente, é possível validar este caminho pela opção Validar acesso ao diretório.

Além disso, as validações do diretório de rede são feitas para usuário do AppServer. Desta forma este usuário precisa ter permissão no diretório informado no catálogo. Mais informações para verificar/alterar o usuário estão disponíveis no link ao final do artigo.

Os tipos de documentos permitidos para upload, conforme a documentação do programa html.mi0307 são: txt, jpg, jpeg, png, gif, bmp, pdf, xls, doc, ppt, xlsx, docx, pptx, zip, wav, mp3, mp4. 

Importante
Dar atenção para os casos em que dependendo do servidor pode ocorrer que o mesmo não aceite o upload de arquivos com acentuação, neste caso recomendamos que a acentuação seja removida do nome do arquivo.

Outra situação que vale salientar é quando o servidor do Appserver for Unix ou Linux, onde o mapeamento dos diretórios é diferente do padrão Windows, sendo necessário informar as barras na formatação exigida pelo Linux:  /servidor/pasta .

Saiba mais
Usuário que inicia o serviço Appserver Progress: Framework - Linha Datasul - TEC - Configurar Appserver Progress no Windows para iniciar com usuário diferente