Saltar al contenido

Conexión de Microsoft SharePoint Server

Introducción

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

Crear o editar una conexión de Microsoft SharePoint Server

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

Una conexión existente de Microsoft SharePoint Server se puede editar desde estas ubicaciones:

Configurar una conexión de Microsoft SharePoint Server

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

Consejo

Los campos con un ícono de variable admiten el uso de variables globales, variables de proyecto y variables de Jitterbit. Comience escribiendo un corchete cuadrado abierto [ en el campo o haciendo clic en el ícono de variable para mostrar un menú que enumera las variables existentes de las que elegir.

  • 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 Server y no debe contener barras inclinadas (/) ni dos puntos (:). Este nombre también se utiliza para identificar el punto final de Microsoft SharePoint Server, que se refiere tanto a una conexión específica como a sus actividades.

  • URL: Ingresa la URL.

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

    • SharePoint Online

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

        • AzureAD

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

            • APAGADO

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

            • REFRESCAR

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

            • OBTENER Y REFRESCAR

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

        • AzureServicePrincipalCert

          • Inquilino de Azure: Ingresa el inquilino de Azure.

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

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

            • APAGADO

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

            • REFRESCAR

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

            • OBTENER Y REFRESCAR

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

          • Certificado JWT OAuth: Ingresa el certificado JWT OAuth.

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

            • USUARIO

            • MÁQUINA

            • ARCHIVO PFX

            • BLOB PFX

            • ARCHIVO JKS

            • BLOB JKS

            • ARCHIVO PEMKEY

            • BLOB PEMKEY

            • ARCHIVO_CLAVE_PUBLICA

            • BLOB_CLAVE_PUBLICA

            • ARCHIVO_CLAVE_PUBLICA_SSH

            • BLOB_CLAVE_PUBLICA_SSH

            • ARCHIVO_P7B

            • ARCHIVO_PPK

            • ARCHIVO_XML

            • BLOB_XML

            • ARCHIVO_BCFKS

            • BLOB_BCFKS

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

        • ContraseñaAzure

          • Usuario: Ingresa el usuario.

          • Contraseña: Ingresa la contraseña.

          • Inquilino de Azure: Ingresa el inquilino de Azure.

          • ID de cliente OAuth: Ingresa el ID de cliente OAuth.

        • AzureMSI

        • PingFederate

          • Usuario: Ingresa el usuario.

          • Contraseña: Ingresa la contraseña.

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

          • Dominio SSO: Ingresa el dominio SSO.

          • Propiedades SSO: Ingresa las propiedades SSO.

        • ADFS

          • Usuario: Ingresa el usuario.

          • Contraseña: Ingresa la contraseña.

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

          • Dominio SSO: Ingresa el dominio SSO.

          • Propiedades SSO: Ingresa las propiedades SSO.

        • OneLogin

          • Usuario: Ingresa el usuario.

          • Contraseña: Ingresa la contraseña.

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

          • Dominio SSO: Ingresa el dominio SSO.

          • Propiedades SSO: Ingresa las propiedades SSO.

        • Okta

          • Usuario: Ingresa el usuario.

          • Contraseña: Ingresa la contraseña.

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

          • Dominio SSO: Ingresa el dominio SSO.

          • Propiedades SSO: Ingresa las propiedades SSO.

        • SharePointOAuth

          • ID de cliente OAuth: Ingresa el ID de cliente OAuth.

          • Secreto de cliente OAuth: Ingresa el secreto de cliente OAuth.

        • NTLM

          • Usuario: Ingresa el usuario.

          • Contraseña: Ingresa la contraseña.

        • Básico

          • Usuario: Ingresa el usuario.

          • Contraseña: Ingresa la contraseña.

        • OAuth

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

            • APAGADO

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

            • REFRESCAR

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

            • OBTENERYREFRESCAR

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

        • OAuthJWT

          • Inquilino de Azure: Ingresa el inquilino de Azure.

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

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

            • APAGADO

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

            • REFRESCAR

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

            • OBTENERYREFRESCAR

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

          • Certificado JWT OAuth: Ingresa el certificado JWT OAuth.

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

            • USUARIO

            • MÁQUINA

            • ARCHIVOPFX

            • BLOBPFX

            • ARCHIVOJKS

            • BLOBJKS

            • ARCHIVOKEY_PEM

            • BLOBKEY_PEM

            • ARCHIVOPÚBLICO

            • BLOBPÚBLICO

            • SSHPUBLIC_KEY_FILE

            • SSHPUBLIC_KEY_BLOB

            • P7BFILE

            • PPKFILE

            • XMLFILE

            • XMLBLOB

            • BCFKSFILE

            • BCFKSBLOB

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

    • SharePoint OnPremise

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

        • NTLM

          • Usuario: Ingrese el usuario.

          • Contraseña: Ingrese la contraseña.

        • Negociar

          • Usuario: Ingrese el usuario.

          • Contraseña: Ingrese la contraseña.

        • Ninguno

        • Básico

          • Usuario: Ingrese el usuario.

          • Contraseña: Ingrese la contraseña.

        • ADFS

          • Usuario: Ingrese el usuario.

          • Contraseña: Ingrese la contraseña.

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

          • Dominio SSO: Ingrese el dominio SSO.

          • Propiedades SSO: Ingrese las propiedades SSO.

  • Esquema: Seleccione el esquema, uno de:

    • SOAP

    • REST

    Importante

    Microsoft está retirando la autenticación IDCRL, lo que afecta las conexiones del esquema SOAP a SharePoint Online. Después del 1 de mayo de 2026, las operaciones dependientes de conexiones que utilizan el esquema SOAP de SharePoint Online comenzarán a fallar. Para migrar:

    1. Cree una nueva conexión configurada con el esquema REST.
    2. Establezca el esquema de autenticación en una opción compatible con REST. Para SharePoint Online, los esquemas compatibles incluyen AzureAD, AzureServicePrincipalCert, AzurePassword, AzureMSI, SharePointOAuth, ADFS, Okta, PingFederate y OneLogin.
    3. Pruebe la conexión.
    4. Para cada actividad que utilice la antigua conexión SOAP, abra la pantalla de configuración de la actividad, pase el cursor sobre el nombre del punto final para mostrar el icono de edición , haga clic en el menú del punto final y seleccione la nueva conexión REST.
    5. Si experimenta problemas al cambiar el punto final, cree nuevas actividades desde el nuevo punto final REST desde cero y reemplácelas manualmente en cada operación donde se utilizaron las actividades antiguas.
    6. Complete los pasos de configuración de cada actividad. Dado que el esquema REST expone diferentes tablas y columnas que SOAP, revise y actualice las selecciones de tablas y los mapeos de campos según sea necesario.
    7. Vuelva a implementar cualquier operación dependiente de la conexión y ejecútelas para validar las actividades actualizadas.
    8. Desactive la antigua conexión basada en SOAP.

    Contacta al soporte de Jitterbit para obtener asistencia.

  • Usar Configuraciones de Proxy: Selecciona para usar configuraciones de proxy de agente privado.

  • Configuraciones Avanzadas: Cuando se selecciona, 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. Ingresa 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.

    Nota

    Los nombres de columnas y tablas de Microsoft SharePoint Server pueden contener caracteres especiales no soportados por otros servicios. Agrega la propiedad de configuración UseSimpleNames y configúralo en true para imponer un esquema de nombres restringido a caracteres alfanuméricos y guiones bajos para columnas y tablas. Los caracteres no alfanuméricos se convierten en guiones bajos cuando está habilitado.

    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 llenen 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 soportan el uso de variables para pasar JSON en bruto. Si tu caso de uso no admite definir JSON en bruto en los campos directamente, escapa el contenido JSON antes de pasarlo con una variable. Por ejemplo, escapar {"success": "true"}; se convierte en {\"success\": \"true\"};.

  • Prueba: 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 Desactivar actualización automática del conector política de organización.

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

Nota

Se pueden requerir IDs adicionales, secretos, ámbitos y otros tokens de autenticación para completar con éxito la autenticación OAuth. Consulte la documentación del endpoint para obtener información adicional sobre sus requisitos.

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 agentes 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 establecido.

Con esta configuración, se proporciona un token de acceso OAuth que dura un período de tiempo determinado, según el endpoint particular. El conector utilizará el token para establecer la conexión. Sin embargo, la conexión dejará de funcionar una vez que el token de acceso expire. Se configuraría el conector para usar el token estableciendo estas propiedades:

Propiedad de Configuración Valor
Iniciar OAuth OFF
Token de Acceso OAuth Establecer en el 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 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 en el valor del token de acceso OAuth obtenido del endpoint
    Token de Actualización OAuth Establecer en el valor del token de actualización OAuth obtenido del endpoint

Nota

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

Próximos pasos

Después de que se ha creado una conexión con el conector de Microsoft SharePoint Server, 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, consulta los menús de acciones en Conceptos básicos del conector.

Estos tipos de actividad están disponibles:

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

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

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

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

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