Excel en línea
Usa el conector de Excel en línea para realizar operaciones en Excel en línea.
Antes de comenzar
Configura tu proyecto de Google Cloud, crea tu aplicación de OAuth y otorga los permisos necesarios.Configura tu proyecto de Google Cloud
Antes de usar el conector de Excel en línea, realiza las siguientes tareas en tu proyecto de Google Cloud:
- Habilita los siguientes servicios:
secretmanager.googleapis.com
(API de Secret Manager)connectors.googleapis.com
(API de conectores)
Para comprender cómo habilitar servicios, consulta Habilita servicios.
Si estos servicios o permisos no se habilitaron antes para tu proyecto, se te solicitará que los habilites cuando configures el conector.
Crea una aplicación de OAuth personalizada: Azure AD
- Accede al Portal de Azure.
- En el panel de navegación de la izquierda, selecciona Azure Active Directory y, luego, applicationRegistrations.
- Haz clic en Nuevo registro.
- Ingresa un nombre para la aplicación.
- Selecciona la configuración de usuario deseada: usuario único o multiusuario, y uso público o privado.
- Si seleccionas la opción predeterminada, “Solo cuentas en este directorio de la organización”, debes configurar la propiedad de conexión de AzureTenant con el ID del usuario de Azure AD cuando se establece una conexión con el controlador JDBC de CData para Microsoft Excel Online. De lo contrario, el intento de autenticación fallará con un error.
- Si tu aplicación es solo para uso privado, especifica solo Cuentas en este directorio de la organización.
- Si deseas distribuir tu aplicación, elige una de las opciones de multiusuario.
- Establece la URL de redireccionamiento en http://localhost:33333 (el valor predeterminado del controlador) O especifica un puerto diferente y establece CallbackURL en la URL de respuesta exacta que definiste.
- Haz clic en Registrar para registrar la nueva aplicación. Aparecerá una pantalla de administración de aplicaciones. Observa el valor en el ID de la aplicación (cliente) como OAuthClientId y el ID del directorio (usuario) como el AzureTenant.
- Navega a Certificados y Secretos y define el tipo de autenticación de la aplicación. Hay dos tipos de autenticación disponibles: certificado (recomendado) o secreto del cliente.
- Para la autenticación de certificados, en Certificados y secretos, selecciona Subir certificado y, luego, sube el certificado desde tu máquina local.
- Para crear un secreto del cliente nuevo: en Certificados y Secretos, selecciona Secreto de cliente nuevo para la aplicación y especifica su duración. Después de guardar el secreto del cliente, Microsoft Excel Online muestra el par clave-valor. Copia este valor, ya que solo se muestra una vez. Este valor se convierte en OAuthClientSecret.
- Selecciona Permisos de API > Agregar > Permisos delegados.
- Agrega los siguientes permisos de aplicación: Sites.Read.All, Files.Read, Files.Read.All, Files.Read.Selected, Files.ReadWrite, Files.ReadWrite.All, Files.ReadWrite.AppFolder, Files.ReadWrite.Selected y offline_access.
- Guarda los cambios.
- Si especificaste el uso de permisos que requieren el consentimiento del administrador (como los permisos de la aplicación), puedes otorgarlos desde el inquilino actual en la página Permisos de API.
Crear una aplicación de OAuth personalizada - Principal del servicio de Azure
- Usa la barra de búsqueda para buscar el servicio de Suscripciones.
- Abre la página Suscripciones.
- Selecciona la suscripción a la que se asignará la aplicación.
- Abre el Control de acceso (IAM).
- Selecciona Agregar > Agregar asignación de rol. Microsoft Excel Online abre la página Agregar asignación de rol.
- Asigna el rol de propietario a tu aplicación personalizada de Azure AD.
Asigna un rol a la aplicación
- Para acceder a los recursos de tu suscripción, debes asignar un rol a la aplicación.
- Para abrir la página Suscripciones, busca y selecciona el servicio Suscripciones en la barra de búsqueda.
- Selecciona la suscripción a la que deseas asignar la aplicación.
- Abre el Control de acceso (IAM) y selecciona Agregar > Agrega una asignación de rol para abrir la página Agregar asignación de rol.
- Selecciona Propietario como el rol que se asignará a la app de Azure AD que creaste.
Otorgar el consentimiento del administrador
- Accede al portal de Azure.
- Navega a Registros de aplicaciones y busca la aplicación de OAuth personalizada que creaste.
- En Permisos de API, haz clic en Otorgar consentimiento.
Otorga permisos para las credenciales de cliente
- Accede al portal de Azure.
- Navega a Registros de apps.
- Busca la aplicación que acabas de crear y abre Permisos de API.
- Selecciona los permisos de Microsoft Graph. Existen dos conjuntos distintos de permisos: Delegados y de Aplicación.
- En Permisos de la aplicación, selecciona los permisos que necesitas para tu integración.
Configura el conector
Para configurar el conector, debes crear una conexión a tu fuente de datos (sistema de backend). Una conexión es específica de una fuente de datos. Significa que, si tienes muchas fuentes de datos, debes crear una conexión independiente para cada fuente. Para crear una conexión, sigue estos pasos:
- En la consola de Cloud, ve a la página Conectores de Integration > Conexiones y, luego, selecciona o crea un proyecto de Google Cloud.
- Haz clic en + Crear nuevo para abrir la página Crear conexión.
- En la sección Ubicación, elige la ubicación para la conexión.
- Región: selecciona una ubicación de la lista desplegable.
Entre las regiones admitidas para los conectores, se incluyen las siguientes:
Para obtener la lista de todas las regiones compatibles, consulta Ubicaciones.
- Haz clic en Siguiente.
- Región: selecciona una ubicación de la lista desplegable.
- En la sección Detalles de la conexión, completa lo siguiente:
- Conector: Seleccione Excel Online en la lista desplegable de conectores disponibles.
- Versión del conector: selecciona la versión del conector de la lista desplegable de versiones disponibles.
- En el campo Nombre de la conexión, ingresa un nombre para la instancia de conexión.
Los nombres de las conexiones deben cumplir con los siguientes criterios:
- Los nombres de las conexiones pueden usar letras, números o guiones.
- Las letras deben estar en minúsculas.
- Los nombres de las conexiones deben comenzar con una letra y terminar con una letra o un número.
- Los nombres de las conexiones no pueden superar los 49 caracteres.
- De manera opcional, ingresa una Descripción para la instancia de conexión.
- De manera opcional, habilita Cloud Logging y, luego, selecciona un nivel de registro. De forma predeterminada, el nivel de registro se establece en
Error
. - Cuenta de servicio: Selecciona una cuenta de servicio que tenga los roles necesarios.
- De manera opcional, configura los parámetros de nodo de conexión:
- Cantidad mínima de nodos: Ingresa la cantidad mínima de nodos de conexión.
- Cantidad máxima de nodos: Ingresa la cantidad máxima de nodos de conexión.
Un nodo es una unidad (o réplica) de una conexión que procesa transacciones. Se requieren más nodos para procesar más transacciones para una conexión y, del mismo modo, se requieren menos para procesar menos transacciones. Para comprender cómo los nodos afectan el precio del conector, consulta Precios de nodos de conexión. Si no ingresas ningún valor, se establecen de forma predeterminada los nodos mínimos en 2 (para una mejor disponibilidad) y los nodos máximos se establecen en 50.
- Usuario de Azure: Es el usuario de Microsoft Online que se usa para acceder a los datos. Si no se especifica, se usa tu inquilino predeterminado.
- Unidad: Es el ID de la unidad. Puedes usar las vistas Drives y SharePointSites para ver todos los sitios y unidades a los que tienes acceso.
- URL de Sharepoint: Es la URL base de tu servidor de Sharepoint.
- Mostrar documentos compartidos: Indica si quieres mostrar o no los documentos compartidos.
- Libro de trabajo: Es el nombre o el ID del libro de trabajo.
- Header: Indica si los nombres de columna se deben detectar en la primera fila o no.
- Tabla: Restringe la conexión a una tabla que contiene un rango de celdas de una hoja de cálculo. Formato: [{Nombre del libro de trabajo}_{Nombre de la hoja de cálculo}!{Rango}]
- De manera opcional, haz clic en + Agregar etiqueta para agregar una etiqueta a la conexión en forma de un par clave-valor.
- Haz clic en Siguiente.
- En la sección Autenticación, ingresa los detalles de autenticación. Para comprender cómo configurar estos detalles de autenticación, consulta Configura la autenticación.
- Haz clic en Siguiente.
- Revisa: Revisa tus detalles de conexión y autenticación.
- Haz clic en Crear.
Configura la autenticación
Ingresa los detalles según la autenticación que desees usar.
- ID de cliente: el ID de cliente que se usa para solicitar tokens de acceso.
- Alcance: una lista separada por comas de los permisos deseados.
- Secreto de cliente: el secreto del cliente que se usa para solicitar tokens de acceso.
- URL de autorización: Es la URL de autorización que se genera cuando se crea el cliente.
Excel en línea: Tipo de conexión web
En esta sección, se enumeran los valores de muestra para los diversos campos que configuras cuando creas la conexión de Excel Online.
Nombre del campo | Detalles |
---|---|
Ubicación | us-central1 |
Conector | Excel en línea |
Versión del conector | 1 |
Nombre de la conexión | excelonline-gcp |
Cuenta de servicio | SERVICE_ACCOUNT_NAME@serviceaccount |
Usuario de Azure | 9b******-****-****-****-*********12 |
Drive | b!p_648NCXwk6hJ1pfyn0SeFaithFnRM1JmYNur9asmHAs2k8qe5UsR5a1cX6luuD0 |
URL de Sharepoint | https://*****.sharepoint.com/ |
Mostrar documentos compartidos | Verdadero |
Cantidad mínima de nodos | 2 |
Cantidad máxima de nodos | 50 |
ID de cliente | e89*****-****-****-****-*********b6 |
Permisos | https://graph.microsoft.com/.default |
Secreto del cliente | CLIENT_SECRET |
Versión del Secret | 1 |
URL de autorización | https://login.microsoftonline.com/{Azure-Tenant}/oauth2/v2.0/authorize |
Pasos adicionales después de la creación de la conexión
Si seleccionaste OAuth 2.0 - Authorization code
para la autenticación, debes seguir estos pasos adicionales después de crear la conexión:
- En la página Conexiones, busca la conexión recién creada.
Ten en cuenta que el Status del conector nuevo será Authorization required (Autorización requerida).
- Haz clic en Se requiere autorización.
Se mostrará el panel Editar autorización.
- Copia el valor de Redirect URI (URI de redireccionamiento) a tu aplicación externa.
- Verifica los detalles de la autorización.
- Haz clic en Autorizar.
Si la autorización se realiza correctamente, el estado de la conexión se establecerá como Activa en la página Conexiones.
Volver a autorizar para el código de autorización
Si usas el tipo de autenticación Authorization code
y realizaste cambios de configuración en tu aplicación de Azure Synapse, debes volver a autorizar tu conexión de Azure Synapse. Para volver a autorizar una conexión, sigue estos pasos:
- Haz clic en la conexión requerida en la página Conexiones.
Se abrirá la página de detalles de la conexión.
- Haz clic en Editar para editar los detalles de la conexión.
- Verifica los detalles de OAuth 2.0: Código de autorización en la sección Autenticación.
Si es necesario, realiza los cambios necesarios.
- Haz clic en Guardar. Esto te llevará a la página de detalles de la conexión.
- Haz clic en Editar autorización en la sección Autenticación. Esto muestra el panel Autorizar.
- Haz clic en Autorizar.
Si la autorización se realiza correctamente, el estado de la conexión se establecerá como Activa en la página Conexiones.
Limitaciones del sistema
El tamaño máximo de archivo de Excel que puede procesar el conector de Excel Online es de 25 MB.
El conector de Excel Online puede procesar 3 transacciones por segundo, por nodo, y throttles las transacciones supera este límite. De forma predeterminada, los conectores de integración asignan 2 nodos (para una mejor disponibilidad) a una conexión.
Para obtener información sobre los límites aplicables a Integration Connectors, consulta Límites.
Usa la conexión de Excel en línea en una integración
Después de crear la conexión, estará disponible en la integración de Apigee y en la integración de aplicaciones. Puedes usar la conexión en una integración a través de la tarea Conectores.
- Para comprender cómo crear y usar la tarea Connectors en la integración de Apigee, consulta Tarea Connectors.
- Para comprender cómo crear y usar la tarea Conectores en Application Integration, consulta la Tarea Conectores.
Entidades, operaciones y acciones
Todos los Integration Connectors proporcionan una capa de abstracción para los objetos de la aplicación conectada. Solo puedes acceder a los objetos de una aplicación a través de esta abstracción. La abstracción se expone como entidades, operaciones y acciones.
- Entidades: Una entidad puede considerarse como un objeto o una colección de propiedades en la aplicación o servicio conectados. La definición de una entidad difiere de conector a conector. Por ejemplo, en un conector de bases de datos, las tablas son las entidades; en un conector de servidor de archivos, las carpetas son las entidades; en un conector de sistema de mensajería, las colas son las entidades.
Sin embargo, es posible que un conector no admita o tenga ninguna entidad, en cuyo caso la lista
Entities
estará vacía. - Operaciones: Una operación es la actividad que puedes realizar en una entidad. Puedes realizar cualquiera de las siguientes operaciones en una entidad:
Cuando se selecciona una entidad de la lista disponible, se genera una lista de operaciones disponibles para esa entidad. Para obtener una descripción detallada de las operaciones, consulta las operaciones de entidades de la tarea de conectores. Sin embargo, si un conector no admite ninguna de las operaciones de entidad, estas operaciones no compatibles no se incluyen en la lista
Operations
. - Acción: Una acción es una función de primera clase que está disponible para la integración mediante la interfaz de Conectores. Una acción te permite realizar cambios en una entidad o entidades y variar de un conector a otro. Normalmente, una acción tendrá algunos parámetros de entrada y una
parámetro. Sin embargo, es posible que un conector no admita ninguna acción, en cuyo caso la lista
Actions
estará vacía.
Acciones
En esta sección, se enumeran las acciones que admite el conector. Para entender cómo configurar el consulta Ejemplos de acciones.
Acción Agregar hoja de cálculo
Agrega una hoja de cálculo a un libro de trabajo en línea existente de Excel.
Parámetros de entrada de la acción AddWorksheet
Nombre del parámetro | Tipo de datos | Obligatorio | Descripción |
---|---|---|---|
Título | String | Verdadero | Nombre de la hoja de cálculo. |
WorkbookId | String | Verdadero | El ID del libro de trabajo. Este ID debe pertenecer a la unidad a la que se puede acceder con las propiedades de conexión actuales. |
Parámetros de salida de la acción AddWorksheet
Por ejemplo, sobre cómo configurar la acción AddWorksheet
,
consulta Ejemplos.
Ejemplos
En esta sección, se describe cómo realizar algunas de las acciones en este conector.
Ejemplos de acciones
En esta sección, se describe cómo realizar algunas de las acciones de este conector.
Ejemplo: Cómo realizar la acción AddWorksheet
En este ejemplo, se agrega una hoja de cálculo a un libro de Excel en línea existente.
- En el cuadro de diálogo
Configure connector task
, haz clic enActions
. - Selecciona la acción
AddWorksheet
y haz clic en Listo. - En la sección Asignación de datos,
Open Data Mapping Editor
y, luego, ingresa un valor similar al siguiente en el campoInput
:{ "WorkbookId": "01M7ENMYA2QJVY77NPOFD3WQIJ6PNNX5VL", "Title": "Worksheet_SP1" }
Si la acción se realiza correctamente, el parámetro de respuesta connectorOutputPayload
de la tarea AddWorksheet
tendrá un valor similar al siguiente:
[{ "Success": "true", "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#workbookWorksheet", "@odata.type": "#microsoft.graph.workbookWorksheet", "@odata.id": "/drives('b%21p_648NCXwk6hJ1pfyn0SeFaithFnRM1JmYNur9asmHAs2k8qe5UsR5a1cX6luuD0')/items('01M7ENMYA2QJVY77NPOFD3WQIJ6PNNX5VL')/workbook/worksheets(%27%7BD9372F53-CB1B-4082-9E13-02E65C2FC233%7D%27)", "id": "{D9372F53-CB1B-4082-9E13-02E65C2FC233}", "name": "Worksheet_SP1", "position": "1", "visibility": "Visible" }]
Ejemplos de operaciones de entidades
En esta sección, se muestra cómo realizar algunas de las operaciones de la entidad en este conector.
Ejemplo: Muestra una lista de todas las unidades
- En el cuadro de diálogo
Configure connector task
, haz clic enEntities
. - Selecciona Unidades de la lista
Entity
. - Selecciona la operación
List
y, luego, haz clic en Listo.
Ejemplo: Enumera todos los SharedDocuments
- En el cuadro de diálogo
Configure connector task
, haz clic enEntities
. - Selecciona SharedDocuments en la lista
Entity
. - Selecciona la operación
List
y, luego, haz clic en Listo.
Ejemplo: enumera todos los libros de trabajo
- En el cuadro de diálogo
Configure connector task
, haz clic enEntities
. - Selecciona Workbooks de la lista
Entity
. - Selecciona la operación
List
y, luego, haz clic en Listo.
Ejemplo: Cómo obtener viajes
- En el cuadro de diálogo
Configure connector task
, haz clic enEntities
.
Elige Unidades en la lista - Selecciona la operación
Get
y, luego, haz clic en Listo. - Establece el ID de la entidad en Get single Drives. Para establecer el ID de la entidad, en la sección Data Mapper de Data Mapping, haz clic en Open Data Mapping Editor y, luego, ingresa
b!ZETdEU1T_UOBEzbgDmsvcubxvUaXbcJNrrNPM4LqokkwLC3zCRPiQLi2PBfCs9-v
en el campo Input Value y elige EntityId como variable local.
Entity
.
Ejemplo: Cómo obtener SharedDocument
- En el cuadro de diálogo
Configure connector task
, haz clic enEntities
. - Selecciona SharedDocuments en la lista
Entity
. - Selecciona la operación
Get
y haz clic en Listo. - Establece el ID de la entidad en Get single SharedDocument. Para establecer el ID de la entidad, en
la sección Data Mapper de la Data Mapping, haz clic en Open Data Mapping Editor y
Luego, ingresa
01BDTL6TS3OQ3HDXCKGREILDYKY47S7LEI
en el campo Input Value y elige la variable EntityId como Local.
Ejemplo: Obtener libros de actividades
- En el cuadro de diálogo
Configure connector task
, haz clic enEntities
. - Selecciona Libros de trabajo en la lista
Entity
. - Selecciona la operación
Get
y haz clic en Listo. - Establece el ID de entidad en Obtener libros únicos. Para establecer el ID de la entidad, en la sección Data Mapper de Data Mapping, haz clic en Open Data Mapping Editor y, luego, ingresa
01M7ENMYA2QJVY77NPOFD3WQIJ6PNNX5VL
en el campo Input Value y elige EntityId como variable local.
Ejemplo: Borra datos de un libro
- En el cuadro de diálogo
Configure connector task
, haz clic enEntities
. - Selecciona Libro 4567_Hoja1 de la lista
Entity
. - Selecciona la operación
Delete
y, luego, haz clic en Listo. - Establece el ID de la entidad en Borrar libro 4567_Sheet1. Para establecer el ID de la entidad, en
la sección Data Mapper de la Data Mapping, haz clic en Open Data Mapping Editor y
Luego, ingresa
5.0
en el campo Input Value y elige la variable EntityId como Local.
Ejemplo: Crea una fórmula para Formulae_Sheet_List
- En el cuadro de diálogo
Configure connector task
, haz clic enEntities
. - Selecciona Formulae_Sheet_List en la lista
Entity
. - Selecciona la operación
Create
y haz clic en Listo. - En la sección Asignador de datos de la Tarea, haz clic en
OpenDataMapping
y, luego, ingresa un valor similar al siguiente en elfield:
{ "Excel_Sheet": "Old_Excel", "B": "=SUM(C8:D8)", "C": "6", "D": "6" }
Running this example, returns a response similar to the following in the Connector task's
connectorOutputPayload
output variable:{ "Id": 8.0 }
Example - Create With_Headers
- In the
Configure connector task
dialog, clickEntities
. - Select Book 4567_Book4567_Sheet1 from the
Entity
list. - Select the
Create
operation, and then click Done. - In the Data mapper section of the Task click
OpenDataMapping
editor and then enter a value similar to the following in thefield:
Running this example, returns a response similar to the following in the Connector task's
connectorOutputPayload
output variable:{ "Id": 6.0 }
Example - Create Without_Headers
- In the
Configure connector task
dialog, clickEntities
. - Select Book 4567_Book4567_Sheet1 from the
Entity
list. - Select the
Create
operation, and then click Done. - In the Data mapper section of the Task click
OpenDataMapping
editor and then enter a value similar to the following in thefield:
Running this example, returns a response similar to the following in the Connector task's
connectorOutputPayload
output variable:{ "Id": 7.0 }
Example - Update an Formula for Formulae_Sheet_List
- In the
Configure connector task
dialog, clickEntities
. - Select Formulae_Sheet_List from the
Entity
list. - Select the
Update
operation, and then click Done. - Set the entity ID to Update a Formulae_Sheet_List. To set the entity ID, in
the Data mapper section of the Tasks, click entityId and
then enter
8.0
in the given field. - In the Data mapper section of the Task click
OpenDataMapping
editor and then enter a value similar to the following in thefield:
Cuando se ejecuta este ejemplo, se muestra una respuesta similar a la siguiente en el conector
variable de salida connectorOutputPayload
de la tarea:
{ "Id": 8.0 }
Ejemplo: Actualiza Without_Header
- En el cuadro de diálogo
Configure connector task
, haz clic enEntities
. - Selecciona Libro 4567_Book4567_Sheet1 en la lista
Entity
. - Selecciona la operación
Update
y haz clic en Listo. - Establece el ID de la entidad para actualizar un libro 4567_Book4567_Sheet1. Para establecer el ID de la entidad, en
la sección Asignador de datos de Tasks, haz clic en entityId y
y, luego, ingresa
7.0
en el campo correspondiente. - En la sección Asignador de datos de la Tarea, haz clic en
OpenDataMapping
y, luego, ingresa un valor similar al siguiente en elfield:
{ "B": "cosmically", "C": "interlinked" }
Si ejecutas este ejemplo, se muestra una respuesta similar a la siguiente en la variable de salida connectorOutputPayload
de la tarea del conector:
{ "Id": 7.0 }
Ejemplo: Update_With_Header
- En el cuadro de diálogo
Configure connector task
, haz clic enEntities
.
li>Selecciona Libro 4567_Libro4567_Hoja1 en la lista - Selecciona la operación
Update
y haz clic en Listo. - Actualiza un libro 4567_Book4567_Sheet1 como ID de la entidad.
la sección Asignador de datos de Tasks, haz clic en entityId y
y, luego, ingresa
6.0
en el campo correspondiente. - En la sección Asignador de datos de la Tarea, haz clic en
OpenDataMapping
y, luego, ingresa un valor similar al siguiente en elfield:
{ "Name": "updated", "Type": "newupdate" }
Entity
.
Cuando se ejecuta este ejemplo, se muestra una respuesta similar a la siguiente en el conector
variable de salida connectorOutputPayload
de la tarea:
{ "Id": 6.0 }
Obtén ayuda de la Comunidad de Google Cloud
Puedes publicar tus preguntas y debatir sobre este conector en la comunidad de Google Cloud en Cloud Forums.¿Qué sigue?
- Obtén información sobre cómo suspender y reanudar una conexión.
- Aprende a supervisar el uso del conector.
- Obtén información para ver los registros de los conectores.