Conexión de Microsoft Excel en Jitterbit Studio

Introducción

Una conexión de Microsoft Excel, creada utilizando 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.

Crear o editar una conexión de Microsoft Excel

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

• La pestaña Puntos finales y conectores del proyecto 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 de Microsoft Excel existente se puede editar desde estas ubicaciones:

• La pestaña Puntos finales y conectores del proyecto 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 de componentes 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

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

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

• Autenticación: Cuando está seleccionado (por defecto), muestra configuraciones adicionales. Para documentación, consulte Estableciendo una conexión y Propiedades de configuraciones adicionales:

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

    • Ninguno

    • Básico

    • Automático

    • Digest

    • NTLM

    • Negociar

    • OAuth

    • OAuthJWT

    • SFTP

    • FTP

    • CertificadoSSL

    • AwsRootKeys

    • AwsIAMRoles

    • AwsEC2Roles

    • AwsMFA

    • AwsTempCredentials

    • AwsCredentialsFile

    • AzureAD

    • AzureServicePrincipal

    • AzureMSI

    • OKTA

    • ADFS

    • OneLogin

    • PingFederate

    • HMAC

  • Usuario: Ingresa el usuario.

  • Contraseña: Ingresa la contraseña.

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

    • SharePointOnline

    • SharePointOnPremise

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

  • URI: Ingresa el URI.

  • Definir Tablas: Ingresa las tablas definidas.

  • Encabezado: Ingresa el encabezado.

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

    • Horizontal

    • Vertical

  • Archivo de Excel: Ingresa el archivo de Excel.

  • Cambios en Búfer: Cuando se selecciona (por defecto), especifica que se deben almacenar los cambios en búfer.

  • Región: Ingresa la región.

  • Id del Proyecto: Ingresa el ID del proyecto.

  • Espacio de Nombres de Oracle: Ingresa el espacio de nombres de Oracle.

  • URL Base de Almacenamiento: Ingresa la URL base de almacenamiento.

  • Usar Alojamiento Virtual: Cuando se selecciona (por defecto), especifica que se debe usar alojamiento virtual.

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

  • Clave de Acceso de AWS: Ingresa la clave de acceso de AWS.

  • Clave Secreta de AWS: Ingresa la clave secreta de AWS.

  • ARN de Rol de AWS: Ingresa el ARN del rol de AWS.

  • ARN de Principal de AWS: Ingresa el ARN del principal de AWS.

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

    • OHIO

    • VIRGINIANORTE

    • CALIFORNIANORTE

    • OREGON

    • 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

    • BAHREIN

    • SAO PAULO

    • GOVCLOUDEAST

    • GOVCLOUDWEST

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

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

  • Token MFA: Ingresa el token MFA.

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

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

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

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

  • Inquilino de Azure: Ingresa el inquilino de Azure.

  • Entorno de Azure: Selecciona el entorno de Azure, uno de:

    • GLOBAL

    • CHINA

    • ALEMANIA

    • USGOVT

    • USGOVTDOD

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

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

  • Propiedades SSO: Ingresa las propiedades SSO.

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

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

    • APAGADO

    • OBTENERYREFRESCAR

    • REFRESCAR

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

    • Deshabilitado

    • 1.0

    • 2.0

  • ID de Cliente OAuth: Ingresar el ID de cliente OAuth.

  • Secreto de Cliente OAuth: Ingresar el secreto de cliente OAuth.

  • Token de Acceso OAuth: Ingresar el token de acceso OAuth.

  • Secreto del Token de Acceso OAuth: Ingresar el secreto del token de acceso OAuth.

  • URL de Callback: Ingresar la URL de callback.

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

    • CÓDIGO

    • CLIENTE

    • CONTRASEÑA

  • Modo de Concesión de Contraseña OAuth: Seleccionar el modo de concesión de contraseña OAuth, uno de:

    • Post

    • Básico

  • Incluir URL de Callback OAuth: Cuando se selecciona (por defecto), especifica incluir la URL de callback OAuth.

  • URL de Autorización OAuth: Ingresar la URL de autorización OAuth.

  • URL de Token de Acceso OAuth: Ingresar la URL de token de acceso OAuth.

  • URL de Token de Refresco OAuth: Ingresar la URL de token de refresco OAuth.

  • URL de Solicitud de Token OAuth: Ingresar la URL de solicitud de token OAuth.

  • Verificador OAuth: Ingresar el verificador OAuth.

  • Token de Autenticación: Ingresar el token de autenticación.

  • Clave de Autenticación: Ingresar la clave de autenticación.

  • Parámetros OAuth: Ingresar los parámetros OAuth.

  • Token de Refresco OAuth: Ingresar el token de refresco OAuth.

  • Expira en OAuth: Ingresar el tiempo en segundos que expira el token OAuth.

  • Marca de Tiempo del Token OAuth: Ingresar la marca de tiempo del token OAuth.

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

  • Certificado JWT OAuth: Ingresar el certificado JWT OAuth.

  • Tipo de Certificado OAuth JWT: Selecciona 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: Ingresa la contraseña del certificado OAuth JWT.

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

  • Emisor del OAuth JWT: Ingresa el emisor del OAuth JWT.

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

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

  • KDC de Kerberos: Ingresa el KDC de Kerberos.

  • Reino de Kerberos: Ingresa el reino de Kerberos.

  • SPN de Kerberos: Ingresa el SPN de Kerberos.

  • Archivo Keytab de Kerberos: Ingresa el archivo keytab de Kerberos.

  • Reino del Servicio de Kerberos: Ingresa el reino del servicio de Kerberos.

  • KDC del Servicio de Kerberos: Ingresa el KDC del servicio de Kerberos.

  • Cache de Tickets de Kerberos: Ingresa la caché de tickets de Kerberos.

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

  • Certificado de Cliente SSL: Ingresa 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.

  • Sujeto del Certificado de Cliente SSL: Ingrese el sujeto del certificado de cliente SSL.

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

    • AUTOMÁTICO

    • NINGUNO

    • IMPLÍCITO

    • EXPLÍCITO

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

• SSH: Cuando se selecciona, muestra configuraciones adicionales. Para documentación, consulte Estableciendo 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 Configuraciones de Proxy: Seleccionar para usar configuraciones de proxy de agente privado.

• Configuraciones Avanzadas: Al seleccionar, se 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. Ingrese 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.

  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 completen 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 su caso de uso no admite definir JSON sin procesar en los campos directamente, escape el contenido JSON antes de pasarlo con una variable. Por ejemplo, escapar {"success": "true"}; se convierte en {\"success\": \"true\"};.

• Probar: Haga 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: Haga 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, haga clic para cerrar la configuración sin guardar. Un mensaje le pide 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 le pide que confirme que desea 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á especificar la configuración en los campos que se muestran.

Para este conector, se admiten dos escenarios. En cualquiera de los escenarios, necesitará 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, proporciona un token de acceso OAuth que dura un período de tiempo determinado, según lo establecido por el endpoint particular. El conector utilizará el token para realizar la conexión. Sin embargo, la conexión dejará de funcionar una vez que el token de acceso expire. Debería configurar 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.

  Se proporciona un token de acceso OAuth y un token de actualización OAuth, según lo determinado por el endpoint particular. Se configuraría 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

Próximos pasos

Después de que se haya creado una conexión de conector de Microsoft Excel, 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 Menús de acciones en Conceptos básicos del conector.

Estos tipos de actividad están disponibles:

• 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 en 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.

• Eliminar: 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.