Plataforma anterior

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 como ONSELECT. 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 como ONSUBMIT e os arquivos são salvos como anexos para a cotação. A API changeOrder transfere 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.
Após a anexação dos arquivos à cotação, o elemento 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.dir com o valor como /omscommonfile/fileupload usando 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.scanner deve ser fornecida no arquivo yfs.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.