Conexión de Microsoft Excel Online

Introducción

Una conexión de Microsoft Excel Online, creada utilizando el conector de Microsoft Excel Online, establece acceso a Microsoft Excel Online. Estas actividades, una vez configuradas, interactúan con Microsoft Excel Online a través de la conexión.

Crear o editar una conexión de Microsoft Excel Online

Se crea una nueva conexión de Microsoft Excel Online utilizando el conector de Microsoft Excel Online desde una de estas ubicaciones:

• La pestaña Puntos finales y conectores del componente de diseño en la paleta de componentes de diseño (ver Paleta de componentes de diseño).
• La página de Puntos finales globales (ver Crear un punto final global en Puntos finales globales).

Una conexión existente de Microsoft Excel Online se puede editar desde estas ubicaciones:

• La pestaña Puntos finales y conectores del componente de diseño en la paleta de componentes de diseño (ver Paleta de componentes de diseño).
• La pestaña Componentes del panel del proyecto (ver Menú de acciones del componente en Pestaña de componentes del panel del proyecto).
• La página de Puntos finales globales (ver Editar un punto final global en Puntos finales globales).

Configurar una conexión de Microsoft Excel Online

Cada elemento de la interfaz de usuario de la pantalla de configuración de la conexión de Microsoft Excel Online se describe a continuación.

• Nombre de la conexión: Ingresa un nombre para identificar la conexión. El nombre debe ser único para cada conexión de Microsoft Excel Online y no debe contener barras diagonales (/) ni dos puntos (:). Este nombre también se utiliza para identificar el punto final de Microsoft Excel Online, que se refiere tanto a una conexión específica como a sus actividades.

• Esquema de autenticación: Selecciona el esquema de autorización, uno de:

  • AzureAD

    • Iniciar OAuth: Selecciona la configuración de OAuth, una de:

      • APAGADO

        • Token de acceso OAuth: Ingresa el token de acceso OAuth.

      • OBTENER Y REFRESCAR

      • REFRESCAR

        • Token de acceso OAuth: Ingresa el token de acceso OAuth.

    • Token de actualización OAuth: Ingresa el token de actualización OAuth.

  • AzureMSI

  • AzureServicePrincipal

    • Inquilino de Azure: Ingresa el inquilino de Azure.

    • Iniciar OAuth: Selecciona la configuración de OAuth, una de:

      • APAGADO

        • Token de acceso OAuth: Ingresa el token de acceso OAuth.

      • OBTENER Y REFRESCAR

      • REFRESCAR

        • Token de acceso OAuth: Ingresa el token de acceso OAuth.

    • Id. de cliente OAuth: Ingresa el ID de cliente OAuth.

    • Secreto de cliente OAuth: Ingresa el secreto de cliente OAuth.

    • Token de actualización OAuth: Ingresa el token de actualización OAuth.

  • AzureServicePrincipalCert

    • Inquilino de Azure: Ingresa el inquilino de Azure.

    • Iniciar OAuth: Selecciona la configuración de OAuth, una de:

      • APAGADO

        • Token de acceso OAuth: Ingresa el token de acceso OAuth.

      • OBTENER Y REFRESCAR

      • REFRESCAR

        • Token de acceso OAuth: Ingresa el token de acceso OAuth.

    • Id. de cliente OAuth: Ingresa el ID de cliente OAuth.

    • Token de actualización OAuth: Ingresa el token de actualización OAuth.

    • Certificado JWT OAuth: Ingresa el certificado JWT OAuth.

    • Tipo de certificado JWT OAuth: Selecciona el tipo de certificado JWT OAuth, uno de:

      • USUARIO

      • MÁQUINA

      • ARCHIVO_PFX

      • BLOB_PFX

      • ARCHIVO_JKS

      • BLOB_JKS

      • ARCHIVO_CLAVE_PEM

      • BLOB_CLAVE_PEM

      • ARCHIVO_CLAVE_PUBLICA

      • BLOB_CLAVE_PUBLICA

      • ARCHIVO_CLAVE_PUBLICA_SSH

      • BLOB_CLAVE_PUBLICA_SSH

      • ARCHIVO_P7B

      • ARCHIVO_PPK

      • ARCHIVO_XML

      • BLOB_XML

    • Contraseña del Certificado OAuth JWT: Ingresa la contraseña del certificado OAuth JWT.

    • Sujeto del Certificado OAuth JWT: Ingresa el sujeto del certificado OAuth JWT.

• Libro de trabajo: Ingresa el libro de trabajo.

• Unidad: Ingresa la unidad.

• Incluir sitios de Share Point: Cuando se selecciona, especifica incluir sitios de SharePoint.

• Mostrar documentos compartidos: Cuando se selecciona, especifica usar mostrar documentos compartidos.

• Usar configuraciones de proxy: Selecciona para usar configuraciones de proxy de agente privado.

• Configuraciones avanzadas: Cuando se selecciona, muestra la tabla de Propiedades de Configuraciones Avanzadas, que se utiliza para agregar propiedades de configuración adicionales como pares clave-valor.

  • Agregar: Agrega una fila a la tabla. Ingresa un par clave-valor para cada propiedad.
  • Enviar: Guarda el par clave-valor en la tabla. Visible al pasar el cursor sobre una fila en modo de edición.
  • Descartar: Descarta una nueva fila o cualquier edición realizada en una fila existente. Visible al pasar el cursor sobre una fila en modo de edición.
  • Editar: Permite editar un par clave-valor existente. Visible al pasar el cursor sobre una fila existente.
  • Eliminar: Elimina la fila de la tabla. Visible al pasar el cursor sobre una fila existente.
  • Limpiar todo: Elimina todas las filas de la tabla.

  Nota

  Los nombres de columnas y tablas de Microsoft Excel Online pueden contener caracteres especiales no soportados por otros servicios. Agrega la propiedad de configuración UseSimpleNames y configúralo en true para imponer un esquema de nombres restringido a caracteres alfanuméricos y guiones bajos para columnas y tablas. Los caracteres no alfanuméricos se convierten en guiones bajos cuando está habilitado.

  Importante

  Los campos en la tabla de Propiedades de Configuraciones Avanzadas muestran el ícono de variable solo en modo de edición. Para que los valores de variable de estos campos se llenen en tiempo de ejecución, la versión del agente debe ser al menos 10.75 / 11.13.

  Los campos en la tabla de Propiedades de Configuraciones Avanzadas no admiten el uso de variables para pasar JSON sin procesar. Si tu caso de uso no admite definir JSON sin procesar en los campos directamente, escapa el contenido JSON antes de pasarlo con una variable. Por ejemplo, escapar {"success": "true"}; se convierte en {\"success\": \"true\"};.

• Probar: Haz clic para verificar la conexión utilizando la configuración especificada. Cuando se prueba la conexión, la última versión del conector es descargada por el(los) agente(s) en el grupo de agentes asociado con el entorno actual. Este conector admite suspender la descarga de la última versión del conector utilizando la política de organización Deshabilitar Actualización Automática del Conector.

• Guardar Cambios: Haz clic para guardar y cerrar la configuración de la conexión.

• Descartar Cambios: Después de realizar cambios en una configuración nueva o existente, haz clic para cerrar la configuración sin guardar. Un mensaje te pide confirmar que deseas descartar los cambios.

• Eliminar: Después de abrir una configuración de conexión existente, haz clic para eliminar permanentemente la conexión del proyecto y cerrar la configuración (ver Dependencias de componentes, eliminación y remoción). Un mensaje te pide confirmar que deseas eliminar la conexión.

Configurar conexiones OAuth

Este conector admite una conexión utilizando OAuth mediante propiedades de configuración específicas. Después de seleccionar un esquema de autenticación que incluya Iniciar OAuth, podrás especificar la configuración en los campos que se muestran.

Para este conector, se admiten dos escenarios. En cualquiera de los escenarios, necesitarás utilizar una herramienta de terceros (como Postman o una herramienta similar) para obtener el token de acceso requerido o los tokens del endpoint involucrado. Ambos escenarios funcionan solo para grupos de un solo agente. Estos son grupos de agentes que consisten en un solo agente.

• Escenario 1: Usar un token de acceso OAuth que expira después de un período de tiempo determinado.

  Con esta configuración, proporcionas un token de acceso OAuth que dura un período de tiempo establecido, según lo determinado por el endpoint particular. El conector utilizará el token para establecer la conexión. Sin embargo, la conexión dejará de funcionar una vez que el token de acceso expire. Configurarías el conector para usar el token estableciendo estas propiedades:

  Propiedad de Configuración	Valor
  Iniciar OAuth	OFF
  Token de Acceso OAuth	Establecer al valor del token de acceso OAuth obtenido del endpoint

• Escenario 2: Usar un token de acceso OAuth combinado con un token de actualización OAuth para habilitar la actualización automática del acceso.

  Con esta configuración, el conector utilizará un token de actualización para obtener un nuevo token de acceso una vez que el token de acceso actual haya expirado. Este es generalmente el mejor método para configurar OAuth.

  Proporcionas un token de acceso OAuth y un token de actualización OAuth, según lo determinado por el endpoint particular. Configurarías el conector para usar estos tokens estableciendo estas propiedades:

  Propiedad de Configuración	Valor
  Iniciar OAuth	REFRESH
  Token de Acceso OAuth	Establecer al valor del token de acceso OAuth obtenido del endpoint
  Token de Actualización OAuth	Establecer al valor del token de actualización OAuth obtenido del endpoint

Next steps

Después de que se haya creado una conexión de conector de Microsoft Excel Online, se coloca un tipo de actividad en el lienzo de diseño para crear instancias de actividad que se utilizarán como fuentes (para proporcionar datos en una operación) o como destinos (para consumir datos en una operación).

Las acciones del menú para una conexión y sus tipos de actividad son accesibles desde el panel del proyecto y la paleta de componentes de diseño. Para más detalles, consulte Acciones del menú en Conceptos básicos del conector.

Estos tipos de actividad están disponibles:

• Query: Recupera registros de una tabla en Microsoft Excel Online y está destinado a ser utilizado como fuente en una operación.

• Create: Inserta un registro en una tabla en Microsoft Excel Online y está destinado a ser utilizado como destino en una operación.

• Update: Actualiza un registro en una tabla en Microsoft Excel Online y está destinado a ser utilizado como destino en una operación.

• Delete: Elimina un registro de una tabla en Microsoft Excel Online y está destinado a ser utilizado como destino en una operación.

• Execute: Ejecuta un procedimiento en Microsoft Excel Online y está destinado a ser utilizado como destino en una operación.

It seems there was no Markdown content provided for translation. Please provide the text you would like me to translate into Mexican Spanish.