Implementação de anexos de cotação
É possível anexar um documento a uma cotação para manter o controle de informações extras, como e-mails.
Um Representante de Vendas de Campo (FSR) talvez queira anexar arquivos a cotações. Por exemplo, os requisitos do cliente podem ter sido enviados por e-mail para o FSR como um documento do Microsoft Office Word, e o FSR pode desejar anexar o documento à cotação, ao criar a cotação.
Solução
O Sterling Field Sales permite que os usuários façam upload de anexos para cotações. Os usuários também podem excluir anexos existentes.
O usuário pode usar
a tarefa relacionada Gerenciar anexos para incluir ou excluir anexos existentes. A API getCompleteOrderDetails é chamada para recuperar os detalhes da cotação a ser exibida na tela Gerenciar anexos.
Os usuários podem incluir anexos, clicando no botão Incluir. A caixa de diálogo Novo anexo é exibida e o
scfileuploadwidget é usado para fazer upload dos arquivos. Os arquivos são transferidos por upload usando os seguintes widgets:- Quando o usuário navega e selecionar um arquivo, o widget
sc.file.upload.typeé configurado comoONSELECT. Quando um único arquivo ou vários arquivos são selecionados, uma solicitação em várias partes armazena o arquivo temporariamente no servidor. - Depois de selecionar um ou mais arquivos para upload, quando o usuário clica
no botão Salvar, o widget
sc.file.upload.typeé configurado comoONSUBMITe os arquivos são salvos como anexos para a cotação. A APIchangeOrdertransfere os arquivos do local temporário no servidor para o banco de dados. - Após os arquivos serem anexados à cotação, os detalhes do anexo do arquivo, como o nome do arquivo, descrição do arquivo, tipo de conteúdo de arquivo e o tamanho do arquivo são exibidos na UI. O valor do tipo de arquivo é buscado a partir dos códigos comuns.
- A saída da API de anexo do arquivo retorna um tipo mime Internet. Este tipo de mime Internet é mapeado com os códigos comuns para gerar o valor do tipo de arquivo.
FileAttachments
com informações do arquivo, como ID do arquivo exclusivo, local do arquivo e ID de
widget é transferido por upload no servidor. A caixa de diálogo Novo anexo é fechada
e o painel Anexos da tela Gerenciar anexos é atualizado para exibir o anexo recém-incluído.Quando o usuário clica no botão Excluir na tela Gerenciar anexos,
os anexos selecionados são removidos da cotação usando a API
changeOrder.Nota: vários anexos podem ser excluídos ao mesmo tempo.
O usuário pode fazer download de anexos transferidos por upload anteriormente. Se o usuário clicar no link no Nome do anexo, a opção de download de
arquivo que é exibida, solicita que o usuário abra ou salve o anexo.implementação
Esta seção explica as configurações para este recurso:
- É possível configurar o diretório onde os anexos são armazenados temporariamente.Nota: O local do arquivo temporário não deve ser igual ao local do servidor de aplicativos.
- É possível customizar o Sterling Field Sales para incluir arquivos com extensões de arquivo, que não são fornecidos por padrão. Deve-se substituir as propriedades especificadas no arquivo
customeroverride.properties. - Deve-se incluir a propriedade
yfs.sc.file.upload.dircom o valor como/omscommonfile/fileuploadusando o System Administration Console. Para obter mais informações, consulte Gerenciando propriedades no banco de dados usando o System Administration Console. - É possível configurar o aplicativo para codificar ou decodificar os arquivos que estão sendo anexados ao Sterling Field Sales. Uma nova interface,
IFileEncoderDecoder, é fornecida para codificar o conteúdo do arquivo antes de ser enviado para o arquivo temporário. - É possível configurar o aplicativo para ativar a varredura de vírus no arquivo que está sendo anexado ao Sterling Field Sales. É fornecido um gancho usando
o Sterling Field Sales que pode conectar a lógica para varrer o arquivo
que está sendo transferido por upload para vírus. A propriedade
sc.file.upload.virus.scannerdeve ser fornecida no arquivoyfs.properties.IVirusScanneré a interface recém-incluída que ativa as varreduras de vírus. - É possível configurar o recurso de exclusão segura que está disponível por padrão
no Sterling Field Sales. É fornecida uma nova interface,
ISecureFileDelete, que executa uma exclusão segura dos arquivos colocados no local temporário.