Saltearse al contenido
Nappai Documentation

File

El componente File permite a los usuarios subir o seleccionar un archivo de texto desde el panel de control de Nappai y convertir su contenido en un objeto de datos que puede ser utilizado en el flujo de trabajo. También ofrece la posibilidad de descargar el archivo original dentro del flujo.

⚠️ ADVERTENCIA DE DEPRECACIÓN

Este componente está deprecado y será eliminado en una versión futura de Nappai. Por favor, migra a los componentes alternativos recomendados.

¿Cómo funciona?

Cuando el usuario sube o selecciona un archivo, el componente verifica que el tipo de archivo sea uno de los soportados (por ejemplo, .txt, .csv, .json, .yaml, .yml, .md, .html, .xml, .ini, .properties, .tsv, .xlsx, .xls). Si el archivo es .doc, se muestra un error indicando que debe guardarse como .docx.

El contenido del archivo se lee localmente y se convierte en un objeto Data mediante la función parse_text_file_to_data. Si el usuario activa la opción Silent Errors, los errores de lectura no interrumpirán el flujo; en su lugar, se registrará un mensaje de error y el flujo continuará.

El componente también ofrece una salida Files que devuelve un objeto Message con la ruta del archivo, lo que permite que otros componentes descarguen o utilicen el archivo original.

Entradas

Upload file or select file

Tipo: FileInput
Descripción: Permite al usuario subir un archivo desde su equipo o seleccionar uno que ya esté disponible en el sistema. El componente solo acepta los tipos de archivo listados en la descripción del componente.

Silent Errors

Tipo: BoolInput
Descripción: Si se activa, los errores que ocurran durante la lectura del archivo no generarán una excepción; en su lugar, el flujo continuará y se registrará un mensaje de error.

Salidas

Data

Tipo: Data (método: load_file)
Descripción: Contiene el contenido del archivo convertido en un formato estructurado que puede ser procesado por otros componentes del flujo.

Files

Tipo: Message (método: result_file)
Descripción: Devuelve un mensaje con la ruta del archivo, lo que permite que el archivo sea descargado o utilizado por componentes posteriores.

Ejemplo de Uso

  1. Cargar un archivo CSV

    • Arrastra el componente File al lienzo.
    • En la entrada Upload file or select file, haz clic en Upload y selecciona ventas_2024.csv.
    • Deja Silent Errors desactivado.
    • Conecta la salida Data a un componente de análisis de datos (por ejemplo, DataFrame).
    • El flujo leerá el CSV y lo convertirá en un DataFrame que puede ser filtrado, graficado o exportado.

  2. Descargar el archivo original

    • Conecta la salida Files a un componente de descarga (por ejemplo, Download File).
    • Cuando el flujo se ejecute, el usuario podrá descargar el archivo ventas_2024.csv directamente desde el panel de Nappai.

Componentes Relacionados

  • DataFrame – Convierte datos estructurados en un DataFrame para análisis y visualización.
  • Download File – Permite que los usuarios descarguen archivos generados o seleccionados en el flujo.
  • Text Parser – Analiza texto plano y extrae información específica (por ejemplo, expresiones regulares).

Consejos y Mejores Prácticas

  • Usa tipos de archivo compatibles: Evita subir archivos .doc; guarda los documentos como .docx o .pdf si necesitas procesarlos.
  • Activa Silent Errors en flujos de prueba: Durante el desarrollo, habilita Silent Errors para identificar problemas sin interrumpir el flujo.
  • Combina con componentes de transformación: Después de cargar el archivo, utiliza componentes como Text Parser o DataFrame para limpiar y estructurar los datos antes de analizarlos.
  • Mantén la versión actualizada: Dado que este componente está deprecado, planifica migrar a la nueva versión recomendada antes de la próxima actualización de Nappai.

Consideraciones de Seguridad

  • Validación de archivos: El componente solo acepta tipos de archivo de texto; sin embargo, siempre verifica el contenido antes de procesarlo para evitar la ejecución de código malicioso.
  • Control de acceso: Asegúrate de que solo los usuarios autorizados puedan subir archivos sensibles.
  • Almacenamiento temporal: Los archivos se guardan temporalmente en el servidor; revisa las políticas de retención de datos de tu organización para garantizar el cumplimiento de normativas.