Conexión de Microsoft SharePoint 365 en Jitterbit Studio

Introducción

Una conexión de Microsoft SharePoint 365, creada mediante el conector de Microsoft SharePoint 365, establece acceso a Microsoft SharePoint 365. Una vez que se configura una conexión, se pueden crear instancias de actividades de Microsoft SharePoint 365 asociadas a esa conexión para usarlas como orígenes (para proporcionar datos en una operación) o como destinos (para consumir datos en una operación).

Nota

El conector de Microsoft SharePoint 365 admite autenticación OAuth 2.0.

Crear o editar una conexión de Microsoft SharePoint 365

Se crea una nueva conexión de Microsoft SharePoint 365 mediante el conector de Microsoft SharePoint 365 desde una de estas ubicaciones:

La pestaña Project endpoints and connectors (Puntos de conexión y conectores del proyecto) de la paleta de componentes de diseño (consulta Design component palette).
La página Global Endpoints (Puntos de conexión globales) (consulta Create a global endpoint en Global Endpoints).

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

La pestaña Project endpoints and connectors (Puntos de conexión y conectores del proyecto) de la paleta de componentes de diseño (consulta Design component palette).
La pestaña Components (Componentes) del panel del proyecto (consulta Component actions menu en Project pane Components tab).
La página Global Endpoints (Puntos de conexión globales) (consulta Edit a global endpoint en Global Endpoints).

Configurar una conexión de Microsoft SharePoint 365

A continuación se describe cada elemento de la interfaz de usuario de la pantalla de configuración de la conexión de Microsoft SharePoint 365.

La interfaz utilizada en la configuración de la conexión depende del Authentication type (Tipo de autenticación) seleccionado:

Microsoft Entra ID: Esta opción autentica aplicaciones registradas con Microsoft Entra ID (anteriormente conocido como Azure Active Directory o Azure AD).
Azure Access Control Service (Deprecated): Esta opción autentica aplicaciones mediante el modelo de complemento de SharePoint y Azure Access Control Service (ACS).

Microsoft Entra ID

Si se selecciona Microsoft Entra ID como Authentication type (Tipo de autenticación), se presenta la interfaz descrita a continuación.

Consejo

Los campos con un icono de variable admiten el uso de variables globales, variables del proyecto y variables de Jitterbit. Comienza escribiendo un corchete de apertura [ en el campo o haz clic en el icono de variable para mostrar un menú con las variables existentes entre las que elegir.

Connection name (Nombre de la conexión): Ingresa un nombre para identificar la conexión. El nombre debe ser único para cada conexión de Microsoft SharePoint 365 y no debe contener barras diagonales / ni dos puntos :. Este nombre también se utiliza para identificar el punto de conexión de Microsoft SharePoint 365, que se refiere tanto a una conexión específica como a sus actividades.
Office 365 tenant URL (URL del inquilino de Office 365): Ingresa la URL del inquilino de Microsoft Office 365.
Client ID (ID de cliente): Ingresa el ID de cliente de la aplicación de Microsoft SharePoint 365 (descrito en Prerequisites).
Tenant ID (ID de inquilino): Ingresa el ID de inquilino (descrito en Prerequisites).
Authentication type (Tipo de autenticación): Selecciona Microsoft Entra ID.
Aserción de cliente: Ingresa la aserción de cliente, que se puede generar usando una herramienta como jwt.io o usando la función CreateJwtToken en un script de Jitterbit.
Alcance: Ingresa el alcance de OpenID Connect en este formato: https://jbexample.sharepoint.com/.default.
Usar configuración de proxy (solo agente privado): Al usar un agente privado, se puede seleccionar esta opción para usar la configuración de proxy del agente privado.
Prueba: Haz clic para verificar la conexión usando la configuración proporcionada. Cuando se prueba la conexión, el agente o los agentes en el grupo de agentes asociado al entorno actual descargan la versión más reciente del conector. Este conector admite suspender la descarga de la versión más reciente del conector usando la política de organización Deshabilitar actualización automática de conector.
Guardar: Haz 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, haz clic para cerrar la configuración sin guardar. Un mensaje te pide que confirmes 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 (consulta Dependencias de componentes, eliminación y extracción). Un mensaje te pide que confirmes que deseas eliminar la conexión.

Servicio de control de acceso de Azure (Obsoleto)

Advertencia

Microsoft retiró el Servicio de control de acceso de Azure (ACS) el 2 de abril de 2026.

Si estás usando el conector de Jitterbit Microsoft SharePoint 365 con autenticación del Servicio de control de acceso de Azure, cambia a la autenticación de Microsoft Entra ID. Las operaciones que usan una actividad de punto de conexión de Microsoft SharePoint 365 con autenticación del Servicio de control de acceso de Azure fallan con errores de autenticación al realizar solicitudes.

Si se selecciona Servicio de control de acceso de Azure (Obsoleto) como el Tipo de autenticación, se presenta la interfaz descrita a continuación.

Consejo

Los campos con un icono de variable admiten el uso de variables globales, variables de proyecto y variables de Jitterbit. Comienza escribiendo un corchete de apertura [ en el campo o haz clic en el icono de variable para mostrar un menú con las variables existentes entre las que puedes elegir.

Nombre de conexión: Ingresa un nombre para identificar la conexión. El nombre debe ser único para cada conexión de Microsoft SharePoint 365 y no debe contener barras diagonales / ni dos puntos :. Este nombre también se usa para identificar el punto de conexión de Microsoft SharePoint 365, que hace referencia tanto a una conexión específica como a sus actividades.
URL del inquilino de Office 365: Ingresa la URL del inquilino de Microsoft Office 365.
ID de cliente: Ingresa el ID de cliente de la aplicación de Microsoft SharePoint 365 (descrito en Requisitos previos).
ID de inquilino: Ingresa el ID de inquilino.
Tipo de autenticación: Selecciona Servicio de control de acceso de Azure (Obsoleto).
Secreto de cliente: Ingresa el secreto de cliente de la aplicación de Microsoft SharePoint 365 (descrito en Requisitos previos).
Usar configuración de proxy (solo agente privado): Al usar un agente privado, se puede seleccionar esta opción para usar la configuración de proxy del agente privado.
Probar: Haz clic para verificar la conexión con la configuración proporcionada. Cuando se prueba la conexión, el agente o los agentes del grupo de agentes asociado al entorno actual descargan la versión más reciente del conector. Este conector permite suspender la descarga de la versión más reciente del conector mediante la política de organización Deshabilitar actualización automática del conector.
Guardar: Haz 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, haz clic para cerrar la configuración sin guardar. Un mensaje te pide que confirmes 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 (consulta Dependencias de componentes, eliminación y extracción). Un mensaje te pide que confirmes que deseas eliminar la conexión.

Posible error de conexión

Si recibes este error al probar la conexión, ejecuta el siguiente script en PowerShell para habilitar la autenticación de aplicaciones personalizadas:

{"error":"invalid_request","error_description":"Token type is not allowed."}

PowerShell Script

Install-Module -Name Microsoft.Online.SharePoint.PowerShell

$adminUPN= "<the full email address of the SharePoint administrator account, example: jan@mydomain.onmicrosoft.com>" $orgName="<mydomain>"

$userCredential = Get-Credential -<the username of the SharePoint administrator account> $adminUPN -Message "<the password of the SharePoint administrator account>" Connect-SPOService -Url https://$orgName-admin.sharepoint.com -Credential

$userCredential set-spotenant -DisableCustomAppAuthentication $false

Nota

Reemplaza el texto de marcador de posición (incluidos los corchetes angulares < >) con los valores apropiados para la instancia de SharePoint.

Pasos siguientes

Después de crear una conexión de Microsoft SharePoint 365, colocas un tipo de actividad en el lienzo de diseño para crear instancias de actividad que se usen 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 de menú de una conexión y sus tipos de actividad desde el panel del proyecto y la paleta de componentes de diseño. Para obtener más detalles, consulta Menús de acciones en Conceptos básicos de conectores.

Estos tipos de actividad están disponibles:

Cargar archivo: Carga un archivo PDF o de texto en Microsoft SharePoint 365 y está diseñado para usarse como destino en una operación.
Consultar: Consulta datos de objetos en Microsoft SharePoint 365 y está diseñado para usarse como origen en una operación.
Actualizar: Actualiza datos de objetos en Microsoft SharePoint 365 y está diseñado para usarse como destino en una operación.
Crear: Crea datos de objetos en Microsoft SharePoint 365 y está diseñado para usarse como destino en una operación.
Eliminar: Elimina datos de objetos de Microsoft SharePoint 365 y está diseñado para usarse como destino en una operación.