Conector de Microsoft Excel

To download the app, visit: [connectors](https://tulip.co/library/<span translate=)/microsoft-excel-connector/">Library

Conector de Microsoft Excel

Integración con la API de hojas de cálculo de Microsoft O365 V1.0

Introducción

La API de hojas de cálculo de Microsoft Excel permite a los usuarios crear, leer y editar hojas de cálculo de Microsoft Excel con los permisos de acceso adecuados en sus cuentas de Office 365. El objetivo de este conector es integrar Tulip con Microsoft mediante la API Graph de Microsoft (v1.0) utilizando conectores HTTP, y proporcionar a nuestros clientes un conector listo para usar que puedan importar a su instancia.

Objetivo

Este documento destacará las diferentes funciones del conector que se pueden implementar mediante llamadas HTTP a la API Graph de Microsoft (v1.0) para interactuar con las hojas de cálculo de Excel de M365, con el fin de mostrar diversas acciones de lectura y escritura en la hoja de cálculo que podrían aprovecharse para distintos casos de uso.

Documentación de la API

Documentación de la API Graph de Microsoft

Requisitos previos

Crear una cuenta en Microsoft O365 y configurar las credenciales de OAuth 2.0 en Microsoft Entra ID.
Registra la API con los ámbitos necesarios en el portal de Microsoft. Azure - Entra ID

Vídeo sobre cómo configurar el conector:

Detalles de conexión de Tulip

La siguiente información deberá configurarse en la sección

Se ejecuta en: Host del conector en la nube
Host: graph.microsoft.com
Puerto: 443
TLS: Sí

OAuth 2: Para obtener el token de acceso para comunicarse con la API Graph de Microsoft

Funciones del conector

1) Obtener los detalles de una unidad

Objetivo

Este conector recuperará todos los elementos de una unidad.

Punto final

Llamada HTTP GET al punto final:https://graph.micrsoft.com:443/v1.0/me/drive/root/children

Entradas necesarias

No se requieren entradas

Extractor de salida obligatorio

SheetID: Identificador único del libro de trabajo que se utilizará para llevar a cabo las demás tareas.
CreatedAt: Fecha y hora de creación del libro de trabajo.
Última modificación: Fecha y hora de la última modificación del libro de trabajo.
Nombre de la hoja: El nombre del libro de trabajo.
URL de la hoja de cálculo: la URL del libro de trabajo.

2) Obtener todas las hojas de cálculo de un libro de trabajo

Objetivo

Este conector recuperará todas las hojas de cálculo de un libro de trabajo al pasar el ID del libro de trabajo.

Punto de conexión

HTTP GET al punto final:https://graph.microsoft.com:443/v1.0/me/drive/items/{workbookID}/workbook/worksheets

Datos de entrada necesarios

A continuación se indican los parámetros de la URL que deben pasarse

ID del libro de trabajo

Extractor de salida obligatorio

sheetId: identificador único de la hoja de cálculo que se utilizará para llevar a cabo las demás tareas.
sheetName: El nombre que se muestra de la hoja de cálculo.
sheetPosition: La posición de la hoja de cálculo dentro del libro, con base en cero.
sheetVisibility: Visibilidad de la hoja de cálculo. Los valores posibles son Visible, Hidden y VeryHidden.

3) Obtener los metadatos de la hoja de cálculo

Objetivo

Este conector recuperará los datos a partir del ID del libro y el nombre de la hoja de cálculo.

Punto final

Llamada HTTP GET al punto final https://graph.microsoft.com:443/v1.0/me/drive/items/{workbookID}/workbook/worksheets/{worksheetName}/

Datos de entrada necesarios

A continuación se indican los parámetros de la URL que deben pasarse

ID del libro de trabajo
Nombre de la hoja de cálculo

Extractor de salida obligatorio

sheetId: Identificador único de la hoja de cálculo que se utilizará para llevar a cabo las demás tareas.
sheetName: El nombre que se muestra de la hoja de cálculo.
sheetPosition: Posición de la hoja de cálculo dentro del libro, con referencia a partir de cero.
sheetVisibility: La visibilidad de la hoja de cálculo. Los valores posibles son: Visible, Hidden, VeryHidden.

4) Creación de una nueva hoja de cálculo

Objetivo

Los usuarios pueden proporcionar un ID de libro de trabajo y un nombre de hoja de cálculo como datos de entrada, y Tulip creará una nueva hoja de cálculo con el nombre facilitado. La respuesta de la API consistirá en los metadatos y diversas propiedades de la hoja de cálculo. Esto se puede utilizar posteriormente para recuperar y actualizar datos de las hojas de cálculo.
La información se extrae de la API de Microsoft Graph V1.0 y puede utilizarse posteriormente en aplicaciones de Tulip, tablas de Tulip o variables de Tulip, que se canalizarían a otras funciones del conector.

Punto de conexión

Llamada HTTP POST al punto final https://graph.microsoft.com:443/v1.0/me/drive/items/{workbookID}/workbook/worksheets/add

Datos de entrada obligatorios

A continuación se indican los parámetros que se envían como cuerpo de la solicitud

ID del libro de trabajo: el ID del libro de trabajo
Nombre de la hoja de cálculo: título de la hoja de cálculo

Extractor de salida obligatorio

WorksheetId: identificador único de la hoja de cálculo que se utilizará para llevar a cabo las demás tareas.
spreadsheetURL: la URL de la hoja de cálculo recién creada.
Los parámetros adicionales que se devuelven con la respuesta pueden incluirse como parte de los parámetros de salida.

5) Actualizar las propiedades de la hoja de cálculo

Objetivo

Los usuarios pueden pasar un ID de libro, el nombre antiguo de la hoja de cálculo, la posición de la hoja de cálculo y el nuevo nombre de la hoja de cálculo como datos de entrada, y Tulip actualizará la hoja de cálculo con el nombre proporcionado. La respuesta de la API consistirá en los metadatos y diversas propiedades de la hoja de cálculo. Esto se puede utilizar posteriormente para recuperar y actualizar datos de las hojas de cálculo.

Punto de conexión

Llamada HTTP PATCH al punto final:https://graph.microsoft.com:443/v1.0/me/drive/items/{workbookID}/workbook/worksheets/{worksheetName}

Datos de entrada obligatorios

A continuación se indican los parámetros que se envían como cuerpo de la solicitud

ID del libro: el ID del libro
Nombre de la hoja de cálculo: el título de la hoja de cálculo
Posición de la hoja de cálculo: la posición de la hoja de cálculo dentro del libro, contada a partir de cero
Nombre de la nueva hoja de cálculo: título de la nueva hoja de cálculo

Extractor de resultados requerido

sheetID: Identificador único del libro de trabajo que se utilizará para llevar a cabo las demás tareas
sheetName: el nombre que se muestra de la hoja de cálculo.
sheetPosition: La posición, contada a partir de cero, de la hoja de cálculo dentro del libro.

6) Obtener los datos de una celda específica

Objetivo

Este conector recuperará los datos de las hojas de cálculo de un libro de trabajo basándose en el WorkbookID, el nombre de la hoja de cálculo, el índice de fila y el índice de columna proporcionados como entrada. La respuesta de la API serán los datos del valor de la celda indicada.

Punto de conexión

Llamada HTTP GET al punto final:https://graph.microsoft.com:443/v1.0/me/drive/items/{workbookID}/workbook/worksheets/{worksheetName}/cell(row={índice de fila},column={índice de columna})

Datos de entrada obligatorios

A continuación se indican los parámetros de la URL que deben pasarse

ID del libro de trabajo: ID del libro de trabajo
Nombre de la hoja de cálculo: título de la hoja de cálculo
Índice de fila: número de fila de la celda que se va a recuperar
Índice de columna: número de columna de la celda que se va a recuperar

Extractor de salida obligatorio

Este conector devuelve el valor de la celda correspondiente a los índices de fila y columna proporcionados.

7) Obtener datos del rango de la hoja de cálculo

Objetivo

Este conector recuperará los datos de las hojas de cálculo de un libro de trabajo basándose en el ID del libro de trabajo, el nombre de la hoja de cálculo, el rango inicial y el rango final proporcionados como entrada. La respuesta de la API serán los datos del rango proporcionado.

Punto de conexión

Llamada HTTP GET al punto final:https://graph.microsoft.com:443/v1.0/me/drive/items/{workbookID}/workbook/worksheets/{worksheetName}/range(address=’{start range}:{end range}’)

Datos de entrada obligatorios

A continuación se indican los parámetros de la URL que deben pasarse

ID del libro de trabajo: ID del libro de trabajo
Nombre de la hoja de cálculo: título de la hoja de cálculo
Rango inicial: rango inicial
Rango final: rango final

Extractor de resultados requerido

Este conector devuelve todos los valores de las celdas dentro del rango indicado.

8) Actualizar valores por rango

Objetivo

Los usuarios pueden introducir como datos de entrada un ID de libro de trabajo, un nombre de hoja de cálculo, un rango inicial, un rango final y los valores que se desean actualizar, y Tulip actualizará los valores del rango según los datos proporcionados. La respuesta de la API serán los valores actualizados del rango.

Punto de conexión

Llamada HTTP PATCH al punto final:https://graph.microsoft.com:443/v1.0/me/drive/items/{workbookID}/workbook/worksheets/{worksheetName}/range(address=’{rango inicial}:{rango final}’)

Datos de entrada obligatorios

A continuación se indican los parámetros de la URL que deben pasarse

ID del libro de trabajo: ID del libro de trabajo
Nombre de la hoja de cálculo: título de la hoja de cálculo
Rango inicial: rango inicial
Rango final: rango final
Valores de cada celda dentro del rango proporcionado

Extractor de resultados requerido

No necesitamos ningún extractor de resultados.

9) Crea una tabla en la hoja de cálculo

Objetivo

Los usuarios pueden introducir un ID de libro, un nombre de hoja de cálculo, una dirección de hoja de cálculo y si tiene encabezados, y Tulip creará una nueva tabla con el nombre indicado. La respuesta de la API será los metadatos y diversas propiedades de la tabla.
Esto se puede utilizar posteriormente para recuperar y actualizar datos de las hojas de cálculo.
La información se extrae de la API de Microsoft Graph V1.0 y, a continuación, puede utilizarse en aplicaciones de Tulip, tablas de Tulip o variables de Tulip, que se canalizarían a otras funciones del conector.

Punto final

Llamada HTTP POST al punto final https://graph.microsoft.com:443/v1.0/me/drive/items/{itemID}/workbook/worksheets/add

Datos de entrada obligatorios

A continuación se indican los parámetros que se envían como cuerpo de la solicitud

ID del libro de trabajo: el ID del libro de trabajo
Nombre de la hoja de cálculo: título de la hoja de cálculo
Dirección: dirección o nombre del objeto de rango que representa el origen de datos. Si la dirección no contiene un nombre de hoja, se utiliza la hoja activa en ese momento.
hasHeaders: valor booleano que indica si los datos que se importan tienen etiquetas de columna. Si la fuente no contiene encabezados (es decir, cuando esta propiedad se establece en «false»), Excel generará automáticamente un encabezado desplazando los datos una fila hacia abajo

Extractor de salida obligatorio

Devuelve los valores de metadatos de la tabla recién creada.

10) Añadir una nueva fila a una tabla

Objetivo

Los usuarios pueden pasar un ID de libro de trabajo, un nombre de tabla y valores de fila como entrada, y Tulip creará una nueva fila con los valores de fila proporcionados. La respuesta de la API serán los valores de la fila creada en la tabla.

Punto de conexión

Llamada HTTP POST al punto final https://graph.microsoft.com:443/v1.0/me/drive/items/{workbookID}/workbook/tables/{tablename}/rows/add

Datos de entrada obligatorios

A continuación se indican los parámetros que se envían como cuerpo de la solicitud

ID del libro de trabajo: el ID del libro de trabajo
Nombre de la hoja de cálculo: título de la hoja de cálculo
Valores de las filas

Extractor de salida obligatorio

Devuelve los valores de la fila recién creada.

11) Borrar los datos de la hoja de cálculo

Finalidad

Los usuarios pueden introducir un ID de libro, un nombre de hoja de cálculo, un rango inicial y un rango final como datos de entrada, y Tulip borrará los valores de las celdas según el rango indicado.

Punto final

Llamada HTTP POST al punto final https://graph.microsoft.com:443/v1.0/me/drive/items/{workbookID}/workbook/worksheet/{worksheetName}/range(address=’{rango inicial}:{rango final}’)/clear

Datos de entrada obligatorios

A continuación se indican los parámetros que se envían como cuerpo de la solicitud

ID del libro: el ID del libro
Nombre de la hoja de cálculo: título de la hoja de cálculo
Rango inicial
Rango final

Más información

Consulta más información sobre los conectores de Microsoft