Microsoft Excel

Automatiza la lectura, escritura y gestión de datos en Microsoft Excel 365.

La integración de Microsoft Excel te permite automatizar tareas de hojas de cálculo directamente dentro de tus flujos de Dapta. Con estos nodos, puedes leer, escribir y gestionar archivos de Excel alojados en OneDrive for Business o SharePoint de manera fluida.

🚀 Capacidades Clave

• Leer Datos: Recupera filas con opciones avanzadas de filtrado y paginación.

• Escribir Datos: Añade nuevas filas o actualiza registros existentes de forma eficiente.

• Sincronización Inteligente (Upsert): Crea automáticamente una fila si no existe, o la actualiza si ya está presente.

• Operaciones por Lotes: Actualiza o elimina múltiples filas que coincidan con un criterio en un solo paso.

• Seguridad de Fórmulas: Las actualizaciones preservan estrictamente las fórmulas existentes en tus hojas.

---

⚙️ Requisitos Previos

Para usar esta integración, necesitas:

1. Una cuenta de Microsoft 365 Business o Escolar (OneDrive for Business / SharePoint).

2. Un archivo de Excel (.xlsx) almacenado en tu carpeta de OneDrive o SharePoint.

3. Nota: Las cuentas personales de OneDrive (ej. hotmail/outlook.com) pueden tener compatibilidad limitada.

---

🔐 Autenticación

Para conectar tu cuenta de Microsoft Excel a Dapta, elige uno de los siguientes métodos:

Opción 1: Conexión Rápida (Recomendada)

1. Añade el nodo de Microsoft Excel a tu lienzo de flujo.

2. Ubica el desplegable Credential en el panel de configuración.

3. Haz clic en el botón + (Más) junto al desplegable.

4. Sigue los pasos de inicio de sesión de Microsoft para autorizar tu cuenta.

5. Tu nueva credencial se guardará y seleccionará automáticamente.

Opción 2: Menú de Configuración

1. Navega a la Página de Credenciales en tu panel de Dapta.

2. Haz clic en Add Credential y selecciona Microsoft Excel.

3. Haz clic en Connect e inicia sesión con tu cuenta de Microsoft 365.

4. Una vez conectado, regresa a tu flujo y selecciona esta credencial.

---

🛠️ Operaciones

1. Get Rows (Obtener Filas)

Recupera datos de una hoja de trabajo específica. Usa filtros para refinar tus resultados.

Parámetros

• Workbook (Desplegable, Requerido) Selecciona el archivo de Excel fuente.

• Worksheet (Desplegable, Requerido) Selecciona la pestaña de la hoja específica.

• Filters (Lista, Opcional) Define condiciones para filtrar filas (ej. Status = Pending). Múltiples filtros usan lógica AND.

• Use Pagination (Booleano, Opcional) Activa esto para procesar archivos grandes en fragmentos.

• Limit (Número, Opcional) Máximo de filas a devolver por solicitud (si la paginación está activa). Por defecto: 100.

• Offset (Número, Opcional) Número de filas a omitir (si la paginación está activa). Esencial para recorrer conjuntos de datos en bucle.

Ejemplo de Salida

{
  "results": 2,
  "values": [
    {
      "row_number": 2,
      "Name": "Alice Smith",
      "Email": "[email protected]",
      "Status": "Active"
    },
    {
      "row_number": 5,
      "Name": "Bob Jones",
      "Email": "[email protected]",
      "Status": "Active"
    }
  ],
  "pagination": {
    "enabled": true,
    "total": 50,
    "has_more": true
  }
}

---

2. Append Row (Agregar Fila)

Añade una nueva fila al final de la hoja de trabajo seleccionada.

Parámetros

• Workbook (Desplegable, Requerido) Selecciona el archivo de Excel.

• Worksheet (Desplegable, Requerido) Selecciona la hoja de destino.

• Values to Send (Mapa, Requerido) Mapea tus datos a las columnas específicas de Excel (ej. Columna A -> {{name}}).

Consejo: Puedes mapear valores dinámicamente usando variables de nodos anteriores. Las columnas no mapeadas quedarán vacías.

---

3. Update Row (Actualizar Fila)

Modifica filas existentes basándose en una clave de búsqueda. Puedes actualizar una sola coincidencia o todas.

Características Clave:

• Preservación de Fórmulas: Actualizar un valor activará el recálculo automático de fórmulas dependientes.

• Actualizaciones Parciales: Solo se modifican las columnas mapeadas; las demás permanecen intactas.

Parámetros

• Workbook (Desplegable, Requerido) Selecciona el archivo de Excel.

• Worksheet (Desplegable, Requerido) Selecciona la hoja de destino.

• Key Column (Texto, Requerido) El encabezado de columna donde buscar (ej. Email).

• Key Value (Texto, Requerido) El valor a buscar (ej. [email protected]).

• Values to Update (Mapa, Requerido) Los nuevos datos para escribir en la(s) fila(s) coincidente(s).

• Update All Matches (Booleano, Opcional)

  • false (Por defecto): Actualiza solo la primera fila encontrada.

  • true: Actualiza todas las filas que coincidan con el Key Value.

• Max Rows to Update (Número, Opcional) Límite de seguridad para actualizaciones por lotes. Por defecto: 1000.

---

4. Upsert Row (Actualizar o Crear)

La forma más robusta de sincronizar datos. Verifica la existencia de una fila antes de actuar:

• ¿Encontrada? → Actualiza la fila existente.

• ¿No Encontrada? → Crea una nueva fila.

Parámetros

Igual que Update Row. Key Column y Key Value se usan para verificar la existencia.

---

5. Delete Row (Eliminar Fila)

Elimina filas del archivo basándose en una coincidencia o un número de fila específico.

Parámetros

• Delete Mode (Selección, Requerido) Elige entre By Match (Por Coincidencia) o By Row Number (Por Número).

• Key Column (Texto, Requerido) (Modo Match) La columna donde buscar.

• Key Value (Texto, Requerido) (Modo Match) El valor para identificar la(s) fila(s) a eliminar.

• Row Number (Número, Requerido) (Modo Row Number) El índice de fila específico a eliminar (ej. 5).

• Delete All Matches (Booleano, Opcional) Si es true, elimina TODAS las filas coincidentes encontradas. Úsalo con precaución.

• Max Rows to Delete (Número, Opcional) Límite de seguridad para borrado por lotes. Por defecto: 1000.

---

🚧 Límites de Uso y Cuotas

Para garantizar la estabilidad, la API de Microsoft Graph impone límites de velocidad.

• Límites de API: Procesar miles de filas en un bucle rápido puede provocar un error 429 Too Many Requests.

• Recomendación: Usa siempre Paginación para grandes conjuntos de datos.

• Consejo: Si iteras sobre una lista grande, añade un nodo Wait (Espera) de 1-2 segundos entre iteraciones para evitar límites de velocidad.

---

❓ Solución de Problemas

Problema	Causa	Solución
"Column not found"	Diferencia mayúsculas	Los nombres son sensibles a mayúsculas. Asegúrate que "Email" coincida exactamente con Excel.
"File not found"	Archivo movido	Si el archivo fue renombrado o movido en OneDrive, vuelve a seleccionarlo en el desplegable.
"Values are empty"	Mapeo incorrecto	Verifica que tus variables de entrada (ej. {{step.data}}) realmente contengan datos.
Lentitud	Archivo grande	Usa Paginación o filtros para limitar la cantidad de datos solicitados.

Límite: La API procesa hasta 10,000 filas por defecto. Para conjuntos de datos mayores a este, debes usar paginación.