Plataforma heredada

Implementación de adjuntos de presupuesto

Puede adjuntar un documento a un presupuesto para realizar el seguimiento de información adicional como, por ejemplo los correos electrónicos.

Es posible que un representante de ventas de campo (FSR) desee adjuntar archivos a presupuestos. Por ejemplo, es posible que los requisitos del cliente se hayan enviado por correo electrónico al FSR como un documento de Microsoft Office Word, y es posible que el FSR desee adjuntar el documento al presupuesto, al crear el presupuesto.

Solución

Sterling Field Sales permite a los usuarios subir adjuntos a presupuestos. Los usuarios también pueden suprimir los adjuntos existentes.

El usuario puede utilizar la tarea relacionada Gestionar adjuntos para añadir o suprimir adjuntos existentes. Se llama a la API getCompleteOrderDetails para recuperar los detalles del presupuesto que se va a visualizar en la pantalla Gestionar adjuntos.

Los usuarios pueden añadir adjuntos pulsando el botón Añadir. Se visualiza el recuadro de diálogo Nuevo adjunto y se utiliza scfileuploadwidget para subir los archivos. Los archivos se suben utilizando los siguientes widgets:
  • Cuando el usuario examina y selecciona un archivo con el widget sc.file.upload.type establecido en ONSELECT. Cuando se seleccionan uno o varios archivos, una solicitud de varias partes almacena el archivo temporalmente en el servidor.
  • Después de seleccionar uno o varios archivos para subirlos, cuando el usuario pulsa el botón Guardar, el widget sc.file.upload.type se establece en ONSUBMIT y los archivos se guardan como archivos adjuntos para el presupuesto. La API changeOrder transfiere los archivos de la ubicación temporal en el servidor a la base de datos.
  • Una vez que los archivos se hayan adjuntado al presupuesto, los detalles del adjunto, como el nombre, la descripción, el tipo de contenido y el tamaño del archivo se visualizan en la interfaz de usuario. El valor del tipo de archivo se capta de los códigos comunes.
  • La salida de la API del archivo adjunto devuelve un tipo MIME de Internet. Este tipo MIME de Internet está correlacionado con los códigos comunes para generar el valor del tipo de archivo.
Una vez que los archivos se hayan adjuntado al presupuesto, el elemento FileAttachments con la información de archivo como, por ejemplo, un ID de archivo exclusivo, la ubicación del archivo y el ID de widget, se sube en el servidor. El recuadro de diálogo Nuevo adjunto se cierra y el panel Adjuntos de la pantalla Gestionar adjuntos se renueva para mostrar los adjuntos recién añadidos.
Cuando el usuario pulsa el botón Suprimir en la pantalla Gestionar adjuntos, los archivos adjuntos seleccionados se eliminan del presupuesto utilizando la API changeOrder.
Nota: Se pueden suprimir varios archivos adjuntos al mismo tiempo.
El usuario puede bajar los adjuntos subidos anteriormente. Si el usuario pulsa el enlace del Nombre del adjunto, se muestra el cuadro de diálogo de descarga de archivo y se le solicita al usuario que abra o guarde el adjunto.

Implementación

En esta sección se explican las configuraciones para esta característica:
  • Puede configurar el directorio donde los archivos adjuntos se almacenan temporalmente.
    Nota: La ubicación del archivo temporal no debe ser la misma que la ubicación del servidor de aplicaciones.
  • Puede personalizar Sterling Field Sales para añadir archivos con extensiones de archivo, que no se proporcionan, de forma predeterminada. Debe sustituir las propiedades especificadas en el archivo customeroverride.properties.
  • Debe añadir la propiedad yfs.sc.file.upload.dir con el valor /omscommonfile/fileupload utilizando la consola de administración del sistema. Para obtener más información, consulte Gestión de propiedades en la base de datos utilizando la consola de administración del sistema.
  • Puede configurar la aplicación para codificar o decodificar los archivos que se adjuntan a Sterling Field Sales. Se proporciona una nueva interfaz, IFileEncoderDecoder, para codificar el contenido del archivo antes de que se transfiera al archivo temporal.
  • Puede configurar la aplicación para habilitar la exploración de virus en el archivo adjuntado a Sterling Field Sales. Se proporciona un enlace que Sterling Field Sales puede conectar a la lógica para explorar el archivo que se sube en busca de virus. La propiedad sc.file.upload.virus.scanner debe proporcionarse en el archivo yfs.properties. IVirusScanner es la interfaz recién añadida que permite las exploraciones en busca de virus.
  • Puede configurar la característica de supresión segura que está disponible en Sterling Field Sales, de forma predeterminada. Se proporciona una nueva interfaz, ISecureFileDelete, que realiza una supresión segura de los archivos colocados en la ubicación temporal.