a. Leer rangos de celdas.
b. Agregar filas al final de una hoja de cálculo.
c. Actualizar el contenido de un rango de celdas.
d. Limpiar el contenido de un rango de celdas.
Configuración del nodoA continuación, se detallan los campos necesarios para su configuración:
- Name (opcional): permite personalizar el nombre del nodo dentro del flujo, reemplazando el valor predeterminado.
- Credentials (obligatorio): credenciales de autenticación de Microsoft Authentication Library (Client Credentials). Es posible guardar múltiples credenciales, aunque solo una puede estar activa al mismo tiempo.
- Location Type (obligatorio): define el tipo de ubicación del libro de trabajo. Las opciones disponibles son SharePoint Site y Shared Drive.
-
SharePoint Site Domain (obligatorio): dominio del sitio de SharePoint.
→ Ejemplo: contoso.sharepoint.com -
SharePoint Site Name (obligatorio): nombre del sitio de SharePoint.
→ Ejemplo: MySite - Shared Drive Name (obligatorio solo para Location Type = Shared Drive): nombre de la biblioteca de documentos compartida.
- Workbook URL (obligatorio): URL completa del libro de Excel almacenado en la unidad. Esta URL se obtiene mediante la opción Copiar vínculo en SharePoint.
- Action (obligatorio): define el tipo de operación que realizará el nodo.
-
Output Path (obligatorio): variable donde se almacenarán los resultados o metadatos de la operación.
→ Ejemplo: msg.output
Puedes descargar un flujo de ejemplo en este enlace. Configuración de credencialesA continuación, se detallan los campos requeridos para configurar Microsoft Authentication Library:
- Tenant ID (obligatorio): identificador del tenant de Azure Active Directory.
- Client ID (obligatorio): identificador de la aplicación registrada en Azure AD.
- Client Secret (obligatorio): secreto de cliente de la aplicación registrada en Azure AD.
El campo SheetName/Cells acepta distintos formatos según la acción seleccionada:- Solo nombre de hoja: Sheet1 - Válido únicamente para la acción Append Rows.
- Rango completo: Sheet1!A1:C3 - Válido para las acciones Get Cells, Update Cells y Clear Cells.
También es posible utilizar templates para construir rangos dinámicamente.→ Ejemplo: {{{sheetRange}}}
Configuración de operacionesA continuación, se describen los campos específicos de cada acción:
Get Cells: Lee un rango de celdas del libro de Excel y almacena el resultado en una propiedad del mensaje de salida.-
Cells (obligatorio): rango de celdas a leer.
→ Formato: SheetName!A1:C3 - Flatten Output (opcional): si está activado, convierte el arreglo bidimensional resultante en un arreglo unidimensional.
Por defecto, esta última opción se encuentra desactivada:→ Ejemplo:
- Resultado por defecto: [["Juan"], ["Pérez"]]
- Con Flatten Output activado: ["Juan", "Pérez"]
Append Rows: Agrega nuevas filas al final del rango utilizado en la hoja especificada.-
SheetName (obligatorio): nombre de la hoja destino.
→ Formato: SheetName (sin rango de celdas) -
Input Data (obligatorio): variable desde la cual se leen los datos a almacenar.
→ Ejemplo: msg.input
Este campo puede contener:- Un valor único: "Juan" → agrega una fila con una sola celda.
- Un arreglo de valores: [["Juan", "Pérez"]] → agrega una fila con múltiples celdas.
- Un arreglo de arreglos: [["Juan", "Pérez"], ["Ana", "García"]] → agrega múltiples filas.
Update Cells: Reemplaza el contenido del rango de celdas especificado con los nuevos valores provistos.-
Cells (obligatorio): rango de celdas a actualizar.
→ Formato: SheetName!A1:C3 -
Input Data (obligatorio): variable desde la cual se leen los datos a almacenar. Debe ser un arreglo bidimensional que coincida con el rango especificado.
→ Ejemplo: msg.input
Ejemplo: Para actualizar el rango Sheet1!A1:B2, el campo Input Data debe contener → [["Valor A1", "Valor B1"], ["Valor A2", "Valor B2"]] Clear Cells: Elimina el contenido de las celdas del rango especificado, conservando el formato aplicado.-
Cells (obligatorio): rango de celdas a limpiar.
→ Formato: SheetName!A1:C3
Esta operación elimina únicamente los valores de las celdas. Los formatos, bordes y estilos se conservan.
En el siguiente video te mostramos cómo configurar el nodo en Studio: