Microsoft 365 Excel

Descripcion

Este modulo permite trabajar con archivos Excel almacenados en OneDrive mediante Microsoft Graph API. Operaciones disponibles:

• Listar archivos Excel: Busca todos los archivos .xlsx en OneDrive del usuario.
• Listar hojas: Obtiene las hojas (worksheets) de un archivo Excel.
• Leer rango: Lee datos de un rango especifico en notacion A1 (ej: A1:D10). Devuelve valores, texto y formulas.
• Leer como objetos: Lee datos usando la primera fila como encabezados y devuelve un array de objetos JSON, ideal para procesamiento de datos.
• Escribir rango: Escribe datos en un rango. Acepta arrays 2D, arrays de objetos (se convierten automaticamente con headers) o strings JSON.
• Agregar hoja: Crea una nueva hoja en el archivo.
• Eliminar hoja: Elimina una hoja existente.
• Obtener rango utilizado: Obtiene el rango de celdas con datos.
• Limpiar rango: Limpia contenido y formato de un rango.

Configuracion

Parametro	Tipo	Requerido	Descripcion
credentials_id	credentials	Si	Cuenta Microsoft OAuth configurada
fileId	string	Si	ID del archivo Excel en OneDrive
operation	select	Si	Operacion a realizar

Sub-nodo Read Range / Read as Objects

Parametro	Tipo	Requerido	Descripcion
sheetName	string	Si	Nombre de la hoja (default: Sheet1)
range	string	Si	Rango en notacion A1 (default: A1:Z100)
outputKey	string	No	Clave de salida (default: data / rows)

Sub-nodo Write Range

Parametro	Tipo	Requerido	Descripcion
sheetName	string	Si	Nombre de la hoja
range	string	Si	Rango inicial donde escribir (ej: A1)
valuesKey	string	No	Clave en data con los valores (default: values)

Sub-nodo Add Worksheet

Parametro	Tipo	Requerido	Descripcion
sheetName	string	Si	Nombre de la nueva hoja

Credenciales

Requiere credenciales de tipo Microsoft OAuth2 con:

• Scopes: Files.ReadWrite, Files.ReadWrite.All
• El modulo gestiona el refresh del token automaticamente

Salida

{
  "nextModule": "siguiente_modulo",
  "data": {
    "rows": [
      { "_rowIndex": 2, "Nombre": "Juan", "Email": "juan@test.com", "Total": 150 },
      { "_rowIndex": 3, "Nombre": "Maria", "Email": "maria@test.com", "Total": 200 }
    ]
  },
  "_meta_": { "operation": "readRangeAsObjects", "microsoftService": "excel", "fileId": "abc123" }
}

Ejemplo de Uso

Caso basico - Leer datos como objetos

{
  "credentials_id": "mi-cuenta-ms365",
  "fileId": "ABC123DEF456",
  "operation": "readRangeAsObjects",
  "sheetName": "Ventas",
  "range": "A1:E50"
}

API Utilizada

• Microsoft Graph API - Excel workbook endpoints (/me/drive/items/{id}/workbook/worksheets)

Notas

• Al usar “Leer como objetos”, la primera fila se toma como encabezados (headers)
• El campo _rowIndex en la salida indica la fila real en Excel (empezando desde 2)
• Al escribir, si se pasa un array de objetos, se convierten automaticamente a formato tabular con headers
• El rango de escritura se calcula automaticamente basandose en la dimension de los datos
• Los nombres de hojas con caracteres especiales se codifican automaticamente

Nodos Relacionados

• MS365 OneDrive - Gestionar archivos en OneDrive
• MS365 Calendar - Calendario de Microsoft 365
• MS365 Outlook - Correo electronico con Outlook