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

  1. Accede al Portal de Azure.
  2. En el panel de navegación de la izquierda, selecciona Azure Active Directory y, luego, applicationRegistrations.
  3. Haz clic en Nuevo registro.
  4. Ingresa un nombre para la aplicación.
  5. 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.
  6. 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.
  7. 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.
  8. 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.
  9. Selecciona Permisos de API > Agregar > Permisos delegados.
  10. 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.
  11. Guarda los cambios.
  12. 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

  1. Usa la barra de búsqueda para buscar el servicio de Suscripciones.
  2. Abre la página Suscripciones.
  3. Selecciona la suscripción a la que se asignará la aplicación.
  4. Abre el Control de acceso (IAM).
  5. Selecciona Agregar > Agregar asignación de rol. Microsoft Excel Online abre la página Agregar asignación de rol.
  6. Asigna el rol de propietario a tu aplicación personalizada de Azure AD.

Asigna un rol a la aplicación

  1. Para acceder a los recursos de tu suscripción, debes asignar un rol a la aplicación.
  2. Para abrir la página Suscripciones, busca y selecciona el servicio Suscripciones en la barra de búsqueda.
  3. Selecciona la suscripción a la que deseas asignar la aplicación.
  4. 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.
  5. Selecciona Propietario como el rol que se asignará a la app de Azure AD que creaste.
  1. Accede al portal de Azure.
  2. Navega a Registros de aplicaciones y busca la aplicación de OAuth personalizada que creaste.
  3. En Permisos de API, haz clic en Otorgar consentimiento.

Otorga permisos para las credenciales de cliente

  1. Accede al portal de Azure.
  2. Navega a Registros de apps.
  3. Busca la aplicación que acabas de crear y abre Permisos de API.
  4. Selecciona los permisos de Microsoft Graph. Existen dos conjuntos distintos de permisos: Delegados y de Aplicación.
  5. 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:

  1. En la consola de Cloud, ve a la página Conectores de Integration > Conexiones y, luego, selecciona o crea un proyecto de Google Cloud.

    Ir a la página Conexiones

  2. Haz clic en + Crear nuevo para abrir la página Crear conexión.
  3. En la sección Ubicación, elige la ubicación para la conexión.
    1. 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.

    2. Haz clic en Siguiente.
  4. En la sección Detalles de la conexión, completa lo siguiente:
    1. Conector: Seleccione Excel Online en la lista desplegable de conectores disponibles.
    2. Versión del conector: selecciona la versión del conector de la lista desplegable de versiones disponibles.
    3. 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.
    4. De manera opcional, ingresa una Descripción para la instancia de conexión.
    5. De manera opcional, habilita Cloud Logging y, luego, selecciona un nivel de registro. De forma predeterminada, el nivel de registro se establece en Error.
    6. Cuenta de servicio: Selecciona una cuenta de servicio que tenga los roles necesarios.
    7. 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.

    8. 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.
    9. 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.
    10. URL de Sharepoint: Es la URL base de tu servidor de Sharepoint.
    11. Mostrar documentos compartidos: Indica si quieres mostrar o no los documentos compartidos.
    12. Libro de trabajo: Es el nombre o el ID del libro de trabajo.
    13. Header: Indica si los nombres de columna se deben detectar en la primera fila o no.
    14. 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}]
    15. De manera opcional, haz clic en + Agregar etiqueta para agregar una etiqueta a la conexión en forma de un par clave-valor.
    16. Haz clic en Siguiente.
    1. 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.
    2. Haz clic en Siguiente.
  5. Revisa: Revisa tus detalles de conexión y autenticación.
  6. 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:

  1. 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).

  2. Haz clic en Se requiere autorización.

    Se mostrará el panel Editar autorización.

  3. Copia el valor de Redirect URI (URI de redireccionamiento) a tu aplicación externa.
  4. Verifica los detalles de la autorización.
  5. 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:

  1. Haz clic en la conexión requerida en la página Conexiones.

    Se abrirá la página de detalles de la conexión.

  2. Haz clic en Editar para editar los detalles de la conexión.
  3. 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.

  4. Haz clic en Guardar. Esto te llevará a la página de detalles de la conexión.
  5. Haz clic en Editar autorización en la sección Autenticación. Esto muestra el panel Autorizar.
  6. 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.

  1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
  2. Selecciona la acción AddWorksheet y haz clic en Listo.
  3. En la sección Asignación de datos, Open Data Mapping Editor y, luego, ingresa un valor similar al siguiente en el campo Input:
    {   
    "WorkbookId": "01M7ENMYA2QJVY77NPOFD3WQIJ6PNNX5VL",
    "Title": "Worksheet_SP1"
    }
  4. 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

  1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
  2. Selecciona Unidades de la lista Entity.
  3. Selecciona la operación List y, luego, haz clic en Listo.

Ejemplo: Enumera todos los SharedDocuments

  1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
  2. Selecciona SharedDocuments en la lista Entity.
  3. Selecciona la operación List y, luego, haz clic en Listo.

Ejemplo: enumera todos los libros de trabajo

  1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
  2. Selecciona Workbooks de la lista Entity.
  3. Selecciona la operación List y, luego, haz clic en Listo.

Ejemplo: Cómo obtener viajes

  1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
  2. Elige Unidades en la lista Entity.
  3. Selecciona la operación Get y, luego, haz clic en Listo.
  4. 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.

Ejemplo: Cómo obtener SharedDocument

  1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
  2. Selecciona SharedDocuments en la lista Entity.
  3. Selecciona la operación Get y haz clic en Listo.
  4. 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

  1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
  2. Selecciona Libros de trabajo en la lista Entity.
  3. Selecciona la operación Get y haz clic en Listo.
  4. 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

  1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
  2. Selecciona Libro 4567_Hoja1 de la lista Entity.
  3. Selecciona la operación Delete y, luego, haz clic en Listo.
  4. 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

  1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
  2. Selecciona Formulae_Sheet_List en la lista Entity.
  3. Selecciona la operación Create y haz clic en Listo.
  4. En la sección Asignador de datos de la Tarea, haz clic en OpenDataMapping y, luego, ingresa un valor similar al siguiente en el field:
     {
      "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

  1. In the Configure connector task dialog, click Entities.
  2. Select Book 4567_Book4567_Sheet1 from the Entity list.
  3. Select the Create operation, and then click Done.
  4. In the Data mapper section of the Task click OpenDataMapping editor and then enter a value similar to the following in the field:
     {
        "Name": "workbooknew",
        "Type": "newly created",
        "Sl no": 5.0
      }
      

    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

  1. In the Configure connector task dialog, click Entities.
  2. Select Book 4567_Book4567_Sheet1 from the Entity list.
  3. Select the Create operation, and then click Done.
  4. In the Data mapper section of the Task click OpenDataMapping editor and then enter a value similar to the following in the field:
      {
        "A": "6",
        "B": "Halo",
        "C": "Stardust"
      } 
      

    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

  1. In the Configure connector task dialog, click Entities.
  2. Select Formulae_Sheet_List from the Entity list.
  3. Select the Update operation, and then click Done.
  4. 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.
  5. In the Data mapper section of the Task click OpenDataMapping editor and then enter a value similar to the following in the field:
     
      {
      "B": "=MAX(C8:D8)",
      "C": "7",
      "D": "10"
      } 
      
  6. 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

  1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
  2. Selecciona Libro 4567_Book4567_Sheet1 en la lista Entity.
  3. Selecciona la operación Update y haz clic en Listo.
  4. 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.
  5. En la sección Asignador de datos de la Tarea, haz clic en OpenDataMapping y, luego, ingresa un valor similar al siguiente en el field:
     
       {
        "B": "cosmically",
        "C": "interlinked"
      }  
      
  6. 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

  1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
  2. li>Selecciona Libro 4567_Libro4567_Hoja1 en la lista Entity.
  3. Selecciona la operación Update y haz clic en Listo.
  4. 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.
  5. En la sección Asignador de datos de la Tarea, haz clic en OpenDataMapping y, luego, ingresa un valor similar al siguiente en el field:
     
       {
        "Name": "updated",
        "Type": "newupdate"
      }
      
  6. 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?