Conexión a Microsoft SharePoint 365¶

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 configurada una conexión, puede crear instancias de actividades de Microsoft SharePoint 365 asociadas con 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).

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 extremos y conectores del proyecto de la paleta de componentes de diseño (consulte paleta de componentes de diseño).
• La página Conexiones globales (vea Crear un extremo global en Conexiones globales).

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

• La pestaña extremos y conectores del proyecto de la paleta de componentes de diseño (consulte paleta de componentes de diseño).
• La pestaña Componentes del panel del proyecto (vea menú de acciones de componentes en la pestañaComponentes del panel Proyecto).
• La página Conexiones globales (vea Editar un extremo global en Conexiones globales).

Configurar una Conexión a Microsoft SharePoint 365¶

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

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

• Servicio de control de acceso de Azure: Esta opción autentica aplicaciones mediante el modelo de complemento de SharePoint y el Servicio de control de acceso de Azure (ACS).
• Active Directory de Azure: Esta opción autentica las aplicaciones registradas con Microsoft Azure Entra (anteriormente conocido como Azure Active Directory o Azure AD).

Servicio de Control de Acceso de Azure¶

Si se selecciona Servicio de control de acceso de Azure como Tipo de autenticación, se presenta esta interfaz de usuario:

• Nombre de la conexión: Ingrese 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. / o dos puntos : Este nombre también se utiliza para identificar el extremo de Microsoft SharePoint 365, que hace referencia tanto a una conexión específica como a sus actividades.

• URL del inquilino de Office 365: Ingrese la URL del inquilino de Microsoft Office 365.

• ID de cliente: Ingrese el ID de cliente para la aplicación Microsoft SharePoint 365 (descrito en Requisitos previos).

• ID del inquilino: Ingrese el ID del inquilino.

• Tipo de autenticación: Seleccione Servicio de control de acceso de Azure.

• Secreto del cliente: Ingrese el secreto del cliente para la aplicación Microsoft SharePoint 365 (descrito en Requisitos previos).

• Usar configuración de proxy (solo Agente Privado): Al usar un agente privado, se puede seleccionar esta configuración para usar 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, 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.

Active Directory de Azure¶

Si se selecciona Azure Active Directory como Tipo de autenticación, se presenta esta interfaz de usuario:

• Nombre de la conexión: Ingrese 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. / o dos puntos : Este nombre también se utiliza para identificar el extremo de Microsoft SharePoint 365, que hace referencia tanto a una conexión específica como a sus actividades.

• URL del inquilino de Office 365: Ingrese la URL del inquilino de Microsoft Office 365.

• ID de cliente: Ingrese el ID de cliente para la aplicación Microsoft SharePoint 365 (descrito en Requisitos previos).

• ID del inquilino: Ingrese el ID del inquilino (descrito en Requisitos previos).

• Tipo de autenticación: Seleccione Azure Active Directory.

• Afirmación del cliente: Ingrese la afirmación del cliente (descrita en Requisitos previos).

• Ámbito: Ingrese el ámbito 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 configuración para usar 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, 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.

Posible Error de Conexión¶

Si recibe este error al probar la conexión, ejecute el siguiente secuencia de comandos en PowerShell para habilitar la autenticación de aplicaciones personalizada:

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

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

Próximos Pasos¶

Después de crear una conexión de Microsoft SharePoint 365, coloque un tipo de actividad en el tela de diseño para crear instancias de actividad que se usará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:

• Subir archivo: Carga un archivo PDF o de texto en Microsoft SharePoint 365 y está destinado a usarse como destino en una operación.

• Consulta: Consulta datos de objetos en Microsoft SharePoint 365 y está pensado para usarse como origen en una operación.

• Actualizar: Actualiza los datos de los objetos en Microsoft SharePoint 365 y está pensado para usarse como destino en una operación.

• Crear: Crea datos de objetos en Microsoft SharePoint 365 y está pensado para usarse como destino en una operación.

• Borrar: Elimina datos de objetos de Microsoft SharePoint 365 y está pensado para usarse como destino en una operación.