Saltar al contenido

Conexión a Microsoft Excel

Introducción

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

Importante

Recomendamos utilizar el conector Microsoft Excel v2 para conectarse a Microsoft Excel ya que permite propiedades de configuración adicionales.

Crear o Editar una Conexión de Microsoft Excel

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

Se puede editar una conexión existente de Microsoft Excel desde estas ubicaciones:

Configurar una Conexión de Microsoft Excel

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

Consejo

Campos con un ícono de variable Ícono de variable admite el uso de variables globales, variables del proyecto, y variables de Jitterbit. Comience escribiendo un corchete abierto [ en el campo o haciendo clic en el icono de variable para mostrar una lista de las variables existentes para elegir.

  • Nombre de la conexión: Introduzca un nombre que se utilizará para identificar la conexión. El nombre debe ser único para cada conexión de Microsoft Excel y no debe contener barras diagonales (/) o dos puntos (:). Este nombre también se utiliza para identificar el extremo de Microsoft Excel, que hace referencia tanto a una conexión específica como a sus actividades.

  • Autenticación: Cuando se selecciona (predeterminado), muestra configuraciones adicionales. Para obtener documentación, consulte Establecimiento de una conexión y Propiedades de configuraciones adicionales:

    • Esquema de autorización: Seleccione el esquema de autorización, uno de:

      • Ninguno

      • Básico

      • Automático

      • Resumen

      • NTLM

      • Negociar

      • OAuth

      • OAuthJWT

      • SFTP

      • FTP

      • Certificado SSL

      • AwsRootKeys

      • AwsIAMRoles

      • AwsEC2Roles

      • AwsMFA

      • AwsTempCredentials

      • AwsCredentialsFile

      • AzureAD

      • AzureServicePrincipal

      • AzureMSI

      • OKTA

      • ADFS

      • OneLogin

      • PingFederate

      • HMAC

    • Usuario: Introduzca el usuario.

    • Contraseña: Ingrese la contraseña.

    • Edición de Share Point: Seleccione la edición de SharePoint, una de:

      • SharePointOnline

      • SharePointOnPremise

  • Conexión: Cuando se selecciona, muestra configuraciones adicionales. Para obtener documentación, consulte Establecimiento de una conexión y Propiedades de configuraciones adicionales:

    • URI: Ingrese el URI.

    • Definir tablas: Ingrese las tablas definidas.

    • Encabezado: Ingrese el encabezado.

    • Orientación: Seleccione la orientación, una de:

      • Horizontal

      • Vertical

    • Archivo Excel: Ingrese el archivo Excel.

    • Cambios de búfer: Cuando se selecciona (predeterminado), especifica los cambios en el búfer.

    • Región: Ingrese la región.

    • Id. del proyecto: Introduzca el ID del proyecto.

    • Espacio de nombres de Oracle: Ingrese el espacio de nombres de Oracle.

    • URL base de almacenamiento: Ingrese la URL base de almacenamiento.

    • Usar alojamiento virtual: Cuando se selecciona (predeterminado), especifica el uso de alojamiento virtual.

  • Autenticación de AWS: Cuando se selecciona, muestra configuraciones adicionales. Para obtener documentación, consulte Establecimiento de una conexión y Propiedades de configuraciones adicionales:

    • Clave de acceso de AWS: Ingrese la clave de acceso de AWS.

    • Clave secreta de AWS: Introduzca la clave secreta de AWS.

    • ARN del rol de AWS: Ingrese el ARN del rol de AWS.

    • ARN principal de AWS: Introduzca el ARN principal de AWS.

    • Región de AWS: Seleccione la región de AWS, una de:

      • OHIO

      • VIRGINIA DEL NORTE

      • NORTE DE ALIFORNIA

      • OREGÓN

      • CIUDAD DEL CABO

      • HONG KONG

      • MUMBAI

      • OSAKA

      • SEÚL

      • SINGAPUR

      • SÍDNEY

      • TOKIO

      • CENTRAL

      • PEKÍN

      • NINGXIA

      • FRÁNCFORT

      • IRLANDA

      • LONDRES

      • MILÁN

      • PARÍS

      • ESTOCOLMO

      • BAHRÉIN

      • SAOPAULO

      • GOVCLOUDEAST

      • GOVCLOUDWEST

    • Token de sesión de AWS: Introduzca el token de sesión de AWS.

    • Número de serie de MFA: Ingrese el número de serie de MFA.

    • Token MFA: Ingrese el token MFA.

  • Autenticación de Azure: Cuando se selecciona, muestra configuraciones adicionales. Para obtener documentación, consulte Establecimiento de una conexión y Propiedades de configuraciones adicionales:

    • Cuenta de almacenamiento de Azure: Ingrese la cuenta de almacenamiento de Azure.

    • Clave de acceso de Azure: Ingrese la clave de acceso de Azure.

    • Firma de acceso compartido de Azure: Introduzca la firma de acceso compartido de Azure.

    • Inquilino de Azure: Introduzca el inquilino de Azure.

    • Ambiente Azure: Seleccione el ambiente Azure, uno de:

      • GLOBAL

      • CHINA

      • ALEMANIA

      • USGOVT

      • USGOVTDOD

  • SSO: Cuando se selecciona, muestra configuraciones adicionales. Para obtener documentación, consulte Establecimiento de una conexión y Propiedades de configuraciones adicionales:

    • URL de inicio de sesión de SSO: Ingrese la URL de inicio de sesión de SSO.

    • Propiedades de SSO: Ingrese las propiedades de SSO.

  • OAuth: Cuando se selecciona, muestra configuraciones adicionales. Para obtener documentación, consulte Establecimiento de una conexión y Propiedades de configuraciones adicionales:

    • Iniciar OAuth: Seleccione la configuración de OAuth, una de las siguientes:

      • APAGADO

      • GETANDREFRESH

      • ACTUALIZAR

    • Versión de OAuth: Seleccione la versión de OAuth, una de:

      • Desactivado

      • 1.0

      • 2.0

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

    • Secreto del cliente OAuth: Ingrese el secreto del cliente OAuth.

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

    • Secreto del token de acceso de OAuth: Ingrese el secreto del token de acceso de OAuth.

    • URL de devolución de llamada: Ingrese la URL de devolución de llamada.

    • Tipo de concesión de OAuth: Seleccione el tipo de concesión de OAuth, uno de:

      • CÓDIGO

      • CLIENTE

      • CONTRASEÑA

    • Modo de concesión de contraseña de OAuth: Seleccione el modo de concesión de contraseña de OAuth, uno de:

      • Publicar

      • Básico

    • OAuth incluye URL de devolución de llamada: Cuando se selecciona (predeterminado), especifica incluir la URL de devolución de llamada de OAuth.

    • URL de autorización de OAuth: Ingrese la URL de autorización de OAuth.

    • URL del token de acceso de OAuth: Ingrese la URL del token de acceso de OAuth.

    • URL del token de actualización de OAuth: Ingrese la URL del token de actualización de OAuth.

    • URL del token de solicitud de OAuth: Ingrese la URL del token de solicitud de OAuth.

    • Verificador OAuth: Ingrese el verificador OAuth.

    • Token de autenticación: Ingrese el token de autenticación.

    • Clave de autenticación: Ingrese la clave de autenticación.

    • Parámetros de OAuth: Introduzca los parámetros de OAuth.

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

    • OAuth caduca en: Introduzca el tiempo en segundos en el que caduca el token de OAuth.

    • Marca de tiempo del token de OAuth: Ingrese la marca de tiempo del token de OAuth.

  • JWT OAuth: Cuando se selecciona, muestra configuraciones adicionales. Para obtener documentación, consulte Establecimiento de una conexión y Propiedades de configuraciones adicionales:

    • Certificado OAuth JWT: Ingrese el certificado OAuth JWT.

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

      • USUARIO

      • MÁQUINA

      • PFXFILE

      • PFXBLOB

      • JKSFILE

      • JKSBLOB

      • PEMKEY_FILE

      • PEMKEY_BLOB

      • PUBLIC_KEY_FILE

      • PUBLIC_KEY_BLOB

      • SSHPUBLIC_KEY_FILE

      • SSHPUBLIC_KEY_BLOB

      • P7BFILE

      • PPKFILE

      • XMLFILE

      • XMLBLOB

      • GOOGLEJSON

      • GOOGLEJSONBLOB

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

    • Asunto del certificado OAuth JWT: Ingrese el asunto del certificado OAuth JWT.

    • Emisor de OAuth JWT: Ingrese el emisor de OAuth JWT.

    • Asunto OAuth JWT: Ingrese el asunto OAuth JWT.

  • Kerberos: Cuando se selecciona, muestra configuraciones adicionales. Para obtener documentación, consulte Establecimiento de una conexión y Propiedades de configuraciones adicionales:

    • Kerberos KDC: Introduzca el KDC de Kerberos.

    • Reino Kerberos: Ingrese al reino Kerberos.

    • SPN de Kerberos: Introduzca el SPN de Kerberos.

    • Archivo de tabla de claves de Kerberos: Introduzca el archivo de tabla de claves de Kerberos.

    • Reino de servicio Kerberos: Ingrese al dominio de servicio Kerberos.

    • KDC del servicio Kerberos: Ingrese al KDC del servicio Kerberos.

    • Caché de tickets de Kerberos: Ingrese la caché de tickets de Kerberos.

  • SSL: Cuando se selecciona, muestra configuraciones adicionales. Para obtener documentación, consulte Establecimiento de una conexión y Propiedades de configuraciones adicionales:

    • Certificado de cliente SSL: Ingrese el certificado de cliente SSL.

    • Tipo de certificado de cliente SSL: Seleccione el tipo de certificado de cliente SSL, uno de:

      • USUARIO

      • MÁQUINA

      • PFXFILE

      • PFXBLOB

      • JKSFILE

      • JKSBLOB

      • PEMKEY_FILE

      • PEMKEY_BLOB

      • PUBLIC_KEY_FILE

      • PUBLIC_KEY_BLOB

      • SSHPUBLIC_KEY_FILE

      • SSHPUBLIC_KEY_BLOB

      • P7BFILE

      • PPKFILE

      • XMLFILE

      • XMLBLOB

    • Contraseña del certificado de cliente SSL: Ingrese la contraseña del certificado de cliente SSL.

    • Asunto del certificado de cliente SSL: Ingrese el asunto del certificado de cliente SSL.

    • Modo SSL: Seleccione el modo SSL, uno de:

      • AUTOMÁTICO

      • NINGUNO

      • IMPLÍCITO

      • EXPLICITO

    • Certificado de servidor SSL: Ingrese el certificado del servidor SSL.

  • SSH: Cuando se selecciona, muestra configuraciones adicionales. Para obtener documentación, consulte Establecimiento de una conexión y Propiedades de configuraciones adicionales:

    • Modo de autenticación SSH: Seleccione el modo de autenticación SSH, uno de:

      • Ninguno

      • Contraseña

      • Clave_pública

    • Certificado de cliente SSH: Ingrese el certificado de cliente SSH.

    • Contraseña del certificado de cliente SSH: Ingrese la contraseña del certificado de cliente SSH.

    • Tipo de certificado de cliente SSH: Seleccione el tipo de certificado de cliente SSH, uno de:

      • USUARIO

      • MÁQUINA

      • PFXFILE

      • PFXBLOB

      • JKSFILE

      • JKSBLOB

      • PEMKEY_FILE

      • PEMKEY_BLOB

      • PUBLIC_KEY_FILE

      • PUBLIC_KEY_BLOB

      • SSHPUBLIC_KEY_BLOB

      • P7BFILE

      • P7BBLOB

      • SSHPUBLIC_KEY_FILE

      • PPKFILE

      • PPKBLOB

      • XMLFILE

      • XMLBLOB

  • Usar configuración de proxy: Seleccione para usar configuración de proxy de agente privado.

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

    Haga clic en el ícono de agregar ícono de agregar para agregar una fila a la tabla siguiente e ingresar un par clave-valor para cada propiedad.

    Para guardar la fila, haga clic en el ícono de envío icono de envío en la columna más a la derecha.

    Para editar o eliminar una sola fila, pase el cursor sobre la columna más a la derecha y use el ícono de edición ícono de edición o eliminar icono eliminar icono.

    Para eliminar todas las filas, haga clic en Borrar todo.

    Importante

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

  • Prueba: Haga clic para verificar la conexión utilizando la configuración especificada. Cuando se prueba la conexión, los agentes del grupo de agentes asociado con el ambiente actual descargan la última versión del conector. Este conector admite la suspensión de la descarga de la última versión del conector mediante la política de la organización Deshabilitar actualización automática del conector.

  • Guardar cambios: Haga clic para guardar y cerrar la configuración de conexión.

  • Descartar cambios: Después de realizar cambios en una configuración nueva o existente, haga clic para cerrar la configuración sin guardar. Un mensaje le solicitará que confirme que desea descartar los cambios.

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

Configurar Conexiones OAuth

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

Nota

Es posible que se requieran identificadores, secretos, ámbitos y otros tokens de autenticación adicionales para completar con éxito la autenticación OAuth. Consulte la documentación del extremo para obtener información adicional sobre sus requisitos.

Para este conector, se admiten dos escenarios. En cualquiera de los dos, deberá utilizar una herramienta de externo (como Postman o una herramienta similar) para obtener el token o los tokens de acceso necesarios del extremo 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 caduca después de un período de tiempo determinado.

    Con esta configuración, se proporciona un token de acceso OAuth que dura un período de tiempo determinado, según lo determine el extremo en particular. El conector utilizará el token para realizar la conexión. Sin embargo, la conexión dejará de funcionar una vez que caduque el token de acceso. Para configurar el conector para que utilice el token, debe configurar estas propiedades:

    Propiedad de configuración Valor
    Iniciar OAuth OFF
    Token de acceso OAuth Establezca el valor del token de acceso OAuth obtenido del extremo

  • 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 suele ser el mejor método para configurar OAuth.

    Debe proporcionar un token de acceso OAuth y un token de actualización OAuth, según lo determine el extremo en particular. Debe configurar el conector para que use estos tokens configurando estas propiedades:

    Propiedad de configuración Valor
    Iniciar OAuth REFRESH
    Token de acceso OAuth Establezca el valor del token de acceso OAuth obtenido del extremo
    Token de actualización de OAuth Establezca el valor del token de actualización de OAuth obtenido del extremo

Nota

Si utiliza varias conexiones de Microsoft Excel basadas en OAuth en el mismo agente privado, configure la propiedad de configuración OAuthSettingsLocation a una ruta de agente única y escribible para cada conexión. En el jitterbit.conf archivo para el agente, establezca EnableLocalFileLocation=true Si no realiza estos dos pasos, las conexiones múltiples utilizarán la misma ruta predeterminada y se sobrescribirán entre sí.

Próximos Pasos

Después de crear una conexión de conector de Microsoft Excel, coloque un tipo de actividad en el tela de diseño para crear instancias de actividad que se utilizarán como orígenes (para proporcionar datos en una operación) o como destinos (para consumir datos en una operación).

Se puede acceder a las acciones del menú de una conexión y sus tipos de actividad desde el panel de proyecto y la paleta de componentes de diseño. Para obtener más información, consulte Menús de acciones en Conceptos básicos del conector.

Están disponibles estos tipos de actividades:

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

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

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

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

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