Importación masiva

Una guía completa sobre cómo usar la función de importación masiva en Care

Descripción general

La Herramienta de Importación de Casos en CS Care es una función sofisticada que permite a los administradores importar masivamente datos de casos desde archivos CSV al sistema. Utiliza una interfaz de asistente de varios pasos para guiar a los usuarios a través de la carga, el mapeo, la configuración y la importación de datos de casos con validación exhaustiva y manejo de errores.

🎯 Propósito y casos de uso

La Herramienta de Importación de Casos está diseñada para:

• Migración inicial de datos desde sistemas heredados a CS Care

• Creación masiva de casos desde fuentes de datos externas

• Sincronización periódica de datos con sistemas asociados

• Actualización de casos existentes con información nueva

📋 Flujo de trabajo paso a paso

El proceso de importación sigue un asistente de 4 pasos:

Paso 1: Cargar CSV 📤

Qué sucede:

• El usuario selecciona y carga un archivo CSV

• El sistema analiza el CSV y extrae los encabezados

• Los datos del CSV se cargan en memoria para vista previa

Detalles técnicos:

• El archivo se analiza usando la csv-parse librería

• El sistema elimina el BOM (Byte Order Mark) si está presente

• Todos los encabezados del CSV quedan disponibles para el mapeo

Mejores prácticas:

• Asegúrese de que el CSV esté correctamente formateado con los encabezados en la primera fila

• Use codificación UTF-8

• Elimine cualquier carácter especial que pueda causar problemas de análisis

Paso 2: Mapear campos del formulario 🗺️

¿Necesita saber qué campos se pueden importar? Consulte Campos permitidos

Este es el paso más crítico donde mapea las columnas del CSV a los campos del formulario de casos.

Características clave:

A. Interfaz de dos pestañas:

• Pestaña de encuesta demográfica: Mapear campos de información personal

• Pestaña de encuesta de admisión: Mapear campos específicos de admisión del caso

B. Mapeo automático de campos: El sistema mapea inteligentemente los campos según:

• Coincidencias exactas de nombre de encabezado con rutas de campo o etiquetas

• Reconocimiento de patrones de valor para campos de selección/desplegable

• Usa normalización para coincidir nombres similares (insensible a mayúsculas, elimina espacios/caracteres especiales)

C. Opciones de mapeo de campos:

Para cada columna del CSV, puede configurar:

1. Campos de texto simples:

   • Mapeo directo: csvField → formField

2. Campos de selección/desplegable:

   • Mapeos de opciones: Mapear múltiples valores CSV a una sola opción desplegable

   • Opción de reserva: Elegir qué hacer con los valores no mapeados

     • __KEEP_ORIGINAL__: Conservar el valor original del CSV

     • O seleccionar una opción desplegable específica como valor predeterminado

3. Campos de fecha:

   • Especificar el formato de fecha para un análisis adecuado

   • Formatos compatibles: MM/DD/YYYY, YYYY-MM-DD, etc.

Funcionalidad de búsqueda:

• Búsqueda en tiempo real para filtrar encabezados del CSV

• Facilita encontrar campos específicos en CSVs grandes

Paso 3: Configuración de importación ⚙️

Configure cómo debe comportarse la importación:

A. Nombre de la fuente

• Propósito: Etiqueta para este trabajo de importación (para seguimiento/informes)

• Predeterminado: Generado automáticamente con fecha/hora

• Ejemplo: "Import 10/24/2025_1430"

B. Campo de código del caso

• Propósito: Columna CSV que contiene identificadores únicos de casos

• Uso: Requerido para actualizaciones, ayuda a identificar casos existentes

C. Modo de importación 🔄

Tres modos disponibles:

1. Solo crear (CaseImportMode.Create)

   • Siempre crea casos nuevos

   • Ignora las comprobaciones de casos existentes

   • Modo de importación más rápido

2. Solo actualizar (CaseImportMode.Update)

   • Solo actualiza casos existentes

   • Requiere atributos identificadores

   • Falla si no se encuentra el caso

3. Crear o actualizar (CaseImportMode.CreateOrUpdate)

   • Comprueba primero si el caso existe

   • Crea si no se encuentra, actualiza si se encuentra

   • Más flexible pero ligeramente más lento

D. Atributos del caso

Defina metadatos personalizados para adjuntar a los casos:

interface ICaseAttributeMapping {
  csvField: string;        // Columna en CSV
  attributeName: string;   // Nombre del atributo
  isIdentifier: boolean;   // ¿Usar para encontrar casos existentes?
}

Ejemplo:

• Campo CSV: external_id

• Nombre del atributo: legacy_system_id

• ¿Es identificador?: true ✅

Identificadores:

• Usados para localizar casos existentes durante las actualizaciones

• Se pueden tener múltiples identificadores

• Se verifican en orden hasta que se encuentra una coincidencia

E. Campo de estado

• Columna CSV que contiene información del estado del caso

• Debe mapearse a estados válidos del proyecto

---

Paso 4: Revisar 👀

Verificación final antes de que comience la importación:

Visualización del resumen:

Datos CSV:

• Registros totales: Conteo de filas a importar

• Campos totales: Número de columnas del CSV

• Campos mapeados: Columnas mapeadas correctamente

• Campos no mapeados: Columnas que se omitirán

Configuración de importación:

• Nombre de la fuente

• Campo de código del caso

• Modo de importación

• Configuración del campo de estado

Atributos del caso:

• Lista de todos los atributos configurados

• Estado de identificador resaltado

Advertencias:

• ⚠️ Advertencia de campos no mapeados: Enumera cualquier columna CSV que no se importará

• Evita la pérdida accidental de datos

Envío:

• Haga clic en "Iniciar importación" para encolar el trabajo

• Muestra un indicador de carga durante el envío

• Muestra confirmación de éxito cuando está en cola

📝 Resumen

La Herramienta de Importación de Casos es una solución potente y fácil de usar para la gestión masiva de casos en CS Care. Su interfaz basada en asistente, mapeo automático inteligente de campos, opciones de configuración flexibles y sólido manejo de errores la hacen adecuada para todo, desde cargas de datos simples hasta escenarios de migración complejos.

Fortalezas clave:

• ✅ Asistente intuitivo de 4 pasos

• ✅ Mapeo automático inteligente de campos

• ✅ Modos flexibles de crear/actualizar

• ✅ Validación integral

• ✅ Procesamiento asíncrono para importaciones grandes

• ✅ Monitoreo de progreso en tiempo real

• ✅ Seguimiento detallado de errores por fila

Al seguir las mejores prácticas y comprender cada paso, los administradores pueden importar de manera eficiente miles de casos manteniendo la integridad de los datos y minimizando errores.

---