Compartir a través de

Paquete de integración para SharePoint

  • Artículo

Los paquetes de integración son complementos para System Center - Orchestrator. Te ayudan a optimizar las operaciones de TI en entornos heterogéneos. Con los paquetes de integración, puedes diseñar runbooks en Orchestrator que usen actividades realizadas por otros componentes de System Center, otros productos de Microsoft y productos ajenos a Microsoft.

Obtén más información sobre la privacidad de Orchestrator.

En este artículo se proporciona información sobre el paquete de integración de System Center para Microsoft SharePoint.

El paquete de integración de System Center para Microsoft SharePoint permite la automatización de tareas comunes en SharePoint. Por ejemplo, para crear elementos de lista, cargar y descargar documentos y supervisar una lista de cambios.

Nota:

Azure Active Directory o Azure AD o AAD mencionado en paquetes de integración hace referencia a Microsoft Entra ID. Más información.

Requisitos del sistema

El paquete de integración para SharePoint requiere la instalación y configuración del software siguiente antes de implementar la integración.

  • System Center - Orchestrator
  • Microsoft .NET Framework 4
  • Microsoft SharePoint
  • System Center - Orchestrator 2019
  • Microsoft .NET Framework 4.6.1 o superior (se recomienda la versión de .NET Framework más reciente)

Importante

  1. El paquete de integración de SharePoint (v10.19.38.0 o superior) está destinado a .NET Framework 4.6.1. Asegúrate de que .NET Framework Runtime v4.6.1 o posterior esté instalado en las máquinas de Runbook Designer y Runbook Server. Recomendamos instalar la última versión disponible de .NET Framework.

  2. Crea los siguientes archivos con contenido (idéntico) como se muestra a continuación para actualizar supportedRuntimeVersion a v4:

    • %systemdrive%/Program Files (x86)/Microsoft System Center/Orchestrator/Runbook Designer/RunbookDesigner.exe.config
    • %systemdrive%/Program Files (x86)/Microsoft System Center/Orchestrator/Runbook Designer/RunbookTester.exe.config
    • %systemdrive%/Program Files (x86)/Microsoft System Center/Orchestrator/Runbook Server/PolicyModule.exe.config

    Contenido:

    <?xml version="1.0" encoding="utf-8"?>
<configuration>
  <startup useLegacyV2RuntimeActivationPolicy="true">
    <supportedRuntime version="v4.0.30319"/>
  </startup>
  <system.xml.serialization>
    <xmlSerializer tempFilesLocation="C:\ProgramData\Microsoft System Center 2012\Orchestrator\Activities\XmlSerializers\"/>
  </system.xml.serialization>
</configuration>
  • System Center - Orchestrator 2022
  • Microsoft .NET Framework 4.7 o posterior (se recomienda la versión de .NET Framework más reciente)

Descargar el paquete

SharePoint Integration Pack para Orchestrator 2022 sigue funcionando con Orchestrator 2025.

Descargue el paquete de integración de SharePoint aquí.

Registro e implementación del paquete de integración

Tras descargar el archivo del paquete de integración, regístralo con el servidor de administración de Orchestrator y luego impleméntalo en los servidores de runbook y en las instancias de Runbook Designer. Obtén información sobre cómo instalar el paquete.

El Paquete de integración de SharePoint realiza acciones en nombre de un usuario que puede acceder al dominio de SharePoint. El Paquete de integración se autentica con SharePoint como este usuario según dos modos:

  • Autenticación básica (valor predeterminado, admite SharePoint Online y SharePoint local).
  • Autenticación moderna (también conocida como OAuth) mediante Azure AD (aplicable solo para SharePoint Online).

Configuración de las conexiones del paquete para la autenticación básica

Una conexión establece un vínculo reutilizable entre Orchestrator y un sitio de SharePoint. Puede crear tantas conexiones como necesite para especificar vínculos a varios sitios. También puede crear varias conexiones con el mismo servidor con el fin de permitir diversos permisos de seguridad para las distintas cuentas de usuario.

  1. En Orchestrator Runbook Designer, selecciona Opciones y luego Microsoft SharePoint.
  2. Aparece el cuadro de diálogo Microsoft SharePoint.
  3. En la pestaña Configuraciones, selecciona Agregar para iniciar la configuración de la conexión. Aparecerá el cuadro de diálogo Agregar configuración.
  4. En el cuadro Nombre, escriba un nombre para la conexión. Este puede ser el nombre del sitio de SharePoint o un nombre descriptivo para distinguir el tipo de conexión.
  5. En el cuadro Tipo, seleccione Configuración de SharePoint.
  6. En el cuadro Sitio de SharePoint, escriba la dirección URL del sitio de SharePoint con el que se quiere integrar.
  7. En los cuadros Nombre de usuario y Contraseña, escriba las credenciales que utilizará Orchestrator para conectarse al sitio de SharePoint.
  8. En el cuadro Dominio, escriba el nombre del dominio que autorizará el acceso.
  9. En el cuadro SharePoint Online, especifica Falso si la instancia de SharePoint es local.
  10. Establece el cuadro Utilizar OAuth en Falso.
  11. En el cuadro Intervalo de supervisión predeterminado (segundos), escribe un valor de tiempo de espera en segundos o deja el valor predeterminado.
  12. En el cuadro Default Maximum Items (Elementos máximos predeterminados), escriba un valor máximo o mantenga el valor predeterminado.
  13. Seleccione Aceptar.
  14. Agrega las conexiones adicionales, si procede, y luego selecciona Finalizar.

Configuración de las conexiones del paquete para la autenticación moderna (SharePoint Online)

Registra una aplicación cliente de AD en Azure Active Directory (instancia de AD) y configura el IP para utilizar este cliente. El IP se autentica en tu nombre; por lo tanto, se requieren tus credenciales en el panel de configuración del IP.

Nota:

Este modo de autenticación solo se admite para SharePoint Online.

Registro de una aplicación cliente en Azure AD

Para registrar una aplicación cliente en Azure AD, siga estos pasos:

  1. Vaya a Azure Portal.

  2. Ve a Azure Active Directory>Registros de aplicaciones y selecciona Nuevo registro para registrar la aplicación.

  3. Establece un nombre válido para la aplicación y elige el identificador URI de redirección (cliente público/aplicación nativa) indicado en el menú desplegable.

    Captura de pantalla de la página de registro.

  4. Elige el tipo de cuenta en función de la configuración de AD y de si usas productos locales y en línea.

  5. Seleccione Registrar.

Información general de la aplicación

El valor ApplicationID y TenantID aparecen en Información general; anótalos.

Captura de pantalla de Información general.

URI de redireccionamiento

Establezca el identificador URI de redirección de OAuth. Elija la plataforma Cliente público (aplicación móvil o de escritorio) :

  1. En Configuraciones de plataforma, seleccione Agregar una plataforma.

    Captura de pantalla de Agregar plataforma.

  2. Selecciona https://login.microsoftonline.com/common/oauth2/nativeclient como URI de redirección y selecciona Configurar.

    Captura de pantalla del identificador URI de redirección.

  3. En Configuración avanzada, establece Permitir flujos de clientes públicos en Sí y luego selecciona Guardar.

    Captura de pantalla Flujos de clientes.

Permisos de API

SharePoint ofrece diferentes ámbitos y permisos de API.

Siga estos pasos para establecer los permisos de API:

  1. En Permisos configurados, selecciona Agregar un permiso y SharePoint.

    Captura de pantalla de la API de SharePoint.

  2. Conceda el permiso AllSites.Write (o superior) a la aplicación y, a continuación, seleccione Agregar permisos. AllSites.Write es necesario para que funcionen todas las actividades de IP de SharePoint, y puedes elegir un ámbito más reducido en función de las actividades que utilicen tus runbooks.

    Captura de pantalla de los ámbitos de la API de SharePoint.

Configuración del paquete de integración de SharePoint para la autenticación moderna

Siga estos pasos para configurar el paquete de integración de SharePoint para la autenticación de OAuth:

  1. En Orchestrator Runbook Designer, selecciona Opciones y luego Microsoft SharePoint.

  2. Aparece el cuadro de diálogo Microsoft SharePoint.

  3. En la pestaña Configuraciones, selecciona Agregar para iniciar la configuración de la conexión. Aparecerá el cuadro de diálogo Agregar configuración.

  4. En el cuadro Nombre, escriba un nombre para la conexión. Este puede ser el nombre del sitio de SharePoint o un nombre descriptivo para distinguir el tipo de conexión.

  5. En el cuadro Tipo, seleccione Configuración de SharePoint.

  6. En el cuadro Sitio de SharePoint, escriba la dirección URL del sitio de SharePoint con el que se quiere integrar.

  7. En los cuadros Nombre de usuario y Contraseña, escriba las credenciales (de usuario) que utilizará Orchestrator para conectarse al sitio de SharePoint cuando se ejecuten los runbooks.

  8. En el cuadro Dominio, escriba el nombre del dominio que autorizará el acceso.

  9. En el cuadro SharePoint Online, especifique Verdadero.

  10. Establece el cuadro Utilizar OAuth en Verdadero.

  11. Establezca el identificador de aplicación en el identificador de aplicación que aparece en el portal.

  12. Establezca el identificador de directorio en el identificador de directorio (inquilino) que aparece en el portal. Esto también se conoce como id. de inquilino de Microsoft 365.

  13. Establezca el identificador URI de la instancia de AAD en la dirección URL de AD (o déjelo en el valor predeterminado).

  14. Seleccione Aceptar.

  15. Agrega las conexiones adicionales, si procede, y luego selecciona Finalizar.

Obtención de datos de SharePoint

Después de realizar los pasos anteriores, cree un runbook y use la actividad Obtener elementos de lista de SharePoint. Al establecer la configuración deseada en la configuración de la actividad, Runbook Designer ejercerá las opciones de conexión para recuperar algunos datos de SharePoint.

Aparecerá un elemento emergente en caso de que haya algún problema con las credenciales u otra configuración.