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:
- Asegúrate de que la conectividad de red esté configurada. Para obtener información sobre los patrones de red, consulta Conectividad de red.
- 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 inquilino deseada: de un solo usuario o de varios usuarios, y de uso público o privado.
- Si seleccionas la opción predeterminada, "Solo cuentas en este directorio organizativo", debes establecer la propiedad de conexión AzureTenant en el ID del inquilino de Azure AD cuando establezcas una conexión con el controlador JDBC de CData para Microsoft Excel en línea. De lo contrario, el intento de autenticación fallará con un error.
- Si la 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 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 aplicación nueva. Aparecerá una pantalla de administración de aplicaciones. Anota el valor del ID de aplicación (cliente) como OAuthClientId y el ID de directorio (usuario) como 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 Nuevo secreto del cliente para la aplicación y especifica su duración. Después de guardar el secreto del cliente, Microsoft Excel en línea muestra el valor de la clave. 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.
Crea una aplicación de OAuth personalizada: principal de servicio de Azure
- Usa la barra de búsqueda para buscar el servicio Suscripciones.
- Abre la página Suscripciones.
- Selecciona la suscripción a la que deseas asignar la aplicación.
- Abre Control de acceso (IAM).
- Selecciona Agregar > Agregar asignación de roles. Microsoft Excel en línea abrirá la página Agregar asignación de roles.
- 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 Control de acceso (IAM) y selecciona Agregar > Agregar asignación de roles para abrir la página Agregar asignación de roles.
- Selecciona Propietario como el rol que se asignará a la app de Azure AD que creaste.
Otorga el consentimiento del administrador
- Accede al portal de Azure.
- Navega a Registros de apps 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 de permisos distintos: delegados y de la 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: Selecciona Excel en línea 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 Unidades y SharePointSites para ver todos los sitios y las 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 se deben detectar o no los nombres de las columnas desde la primera fila.
- 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 forma 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: Es una lista de los alcances deseados, separados por comas.
- 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 de los diversos campos que configuras cuando creas la conexión de Excel en línea.
Nombre del campo | Detalles |
---|---|
Ubicación | us-central1 |
Conector | Excelonline |
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 Estado del nuevo conector será Se requiere autorización.
- Haz clic en Se requiere autorización.
Se mostrará el panel Editar autorización.
- Copia el valor del URI de redireccionamiento en 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.
Cómo volver a autorizar 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. Se mostrará 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 del archivo de Excel que puede procesar el conector de Excel en línea es de 25 MB.
El conector de Excel en línea puede procesar 3 transacciones por segundo por nodo y limita las transacciones que superen este límite. De forma predeterminada, Integration Connectors 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 Application Integration. 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 Connectors en Application Integration, consulta Tarea Connectors.
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. Por lo general, una acción tendrá algunos parámetros de entrada y un parámetro de salida. 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 comprender cómo configurar las acciones, consulta Ejemplos de acciones.
Agrega la acción Hoja de cálculo
Agrega una hoja de cálculo a un libro de Excel en línea existente.
Parámetros de entrada de la acción AddWorksheet
Nombre del parámetro | Tipo de datos | Obligatorio | Descripción |
---|---|---|---|
Título | String | Verdadero | Es el nombre de la hoja de cálculo. |
WorkbookId | String | Verdadero | Es 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
Para ver ejemplos sobre cómo configurar la acción AddWorksheet
, consulta Ejemplos.
Ejemplos
En esta sección, se describe cómo realizar algunas de las acciones de 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 en la lista
Entity
. - Selecciona la operación
List
y 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 haz clic en Listo.
Ejemplo: Muestra una lista de todos los libros de trabajo
- En el cuadro de diálogo
Configure connector task
, haz clic enEntities
. - Selecciona Libros de trabajo en la lista
Entity
. - Selecciona la operación
List
y haz clic en Listo.
Ejemplo: Cómo obtener viajes
- En el cuadro de diálogo
Configure connector task
, haz clic enEntities
.
ect Drives de la lista - Selecciona la operación
Get
y 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 Data Mapping, haz clic en Open Data Mapping Editor y, luego, ingresa
01BDTL6TS3OQ3HDXCKGREILDYKY47S7LEI
en el campo Input Value y elige EntityId como variable local.
Ejemplo: Cómo obtener libros de trabajo
- 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 la entidad en Get single Workbooks. 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 haz clic en Listo. - Establece el ID de la entidad como Delete Book 4567_Sheet1. 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
5.0
en el campo Input Value y elige EntityId como variable 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 Data mapper de la Task, haz clic en el editor
OpenDataMapping
y, luego, ingresa un valor similar al siguiente enfield:
.{ "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:
Si ejecutas este ejemplo, se muestra una respuesta similar a la siguiente en la variable de salida connectorOutputPayload
de la tarea del conector:
{ "Id": 8.0 }
Ejemplo: Actualización sin encabezado
- En el cuadro de diálogo
Configure connector task
, haz clic enEntities
. - Selecciona Libro 4567_Libro4567_Hoja1 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 Data mapper de Tasks, haz clic en entityId y, luego, ingresa
7.0
en el campo determinado. - En la sección Data mapper de la Task, haz clic en el editor
OpenDataMapping
y, luego, ingresa un valor similar al siguiente enfield:
.{ "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. - Establece el ID de la entidad para actualizar un libro 4567_Book4567_Sheet1. Para establecer el ID de la entidad, en la sección Data mapper de Tasks, haz clic en entityId y, luego, ingresa
6.0
en el campo determinado. - En la sección Data mapper de la Task, haz clic en el editor
OpenDataMapping
y, luego, ingresa un valor similar al siguiente enfield:
.{ "Name": "updated", "Type": "newupdate" }
Entity
.
Si ejecutas este ejemplo, se muestra una respuesta similar a la siguiente en la variable de salida connectorOutputPayload
de la tarea del conector:
{ "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 para suspender y reanudar una conexión.
- Obtén información para supervisar el uso de los conectores.
- Obtén información para ver los registros de los conectores.