Saltar al contenido

Conexión de Microsoft SharePoint Server en Jitterbit Studio

Introducción

Una conexión de Microsoft SharePoint Server, creada mediante 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 mediante el conector de Microsoft SharePoint Server desde una de estas ubicaciones:

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

Configurar una conexión de Microsoft SharePoint Server

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

Consejo

Los campos con un icono de variable permiten usar 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 disponibles.

  • Nombre de 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 diagonales (/) ni dos puntos (:). Este nombre también se utiliza para identificar el extremo 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 autenticación: Selecciona el esquema de autorización, uno de:

        • AzureAD

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

            • OFF

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

            • REFRESH

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

            • GETANDREFRESH

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

        • AzureServicePrincipalCert

          • Inquilino de Azure: Ingresa el inquilino de Azure.

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

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

            • OFF

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

            • REFRESH

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

            • GETANDREFRESH

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

  • Certificado OAuth JWT: Ingresa el certificado OAuth JWT.

            -   **Tipo de certificado OAuth JWT:** Selecciona el tipo de certificado OAuth JWT, uno de:

            -   **USER**

            -   **MACHINE**

            -   **PFXFILE**

            -   **PFXBLOB**

            -   **JKSFILE**

            -   **JKSBLOB**

            -   **PEMKEY_FILE**

            -   **PEMKEY_BLOB**

            -   **PUBLIC_KEY_FILE**

            -   **PUBLIC_KEY_BLOB**

            -   **SSHPUBLIC_KEY_FILE**

            -   **SSHPUBLIC_KEY_BLOB**

            -   **P7BFILE**

            -   **PPKFILE**

            -   **XMLFILE**

            -   **XMLBLOB**

            -   **BCFKSFILE**

            -   **BCFKSBLOB**

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

    -   **AzurePassword**

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

    -   **Basic**

        -   **Usuario:** Ingresa el usuario.

        -   **Contraseña:** Ingresa la contraseña.

    -   **OAuth**

        -   **Iniciar OAuth:** Selecciona la configuración de OAuth, uno de:

            -   **OFF**

                -   **Token de acceso OAuth:** Ingresa el token de acceso OAuth.

            -   **REFRESH**

                -   **Token de acceso OAuth:** Ingresa el token de acceso OAuth.

            -   **GETANDREFRESH**

        -   **Token de actualización OAuth:** Ingresa el token de actualización OAuth.

    -   **OAuthJWT**

        -   **Inquilino de Azure:** Ingresa el inquilino de Azure.

        -   **Emisor de JWT de OAuth:** Ingresa el emisor de JWT de OAuth.

        -   **Iniciar OAuth:** Selecciona la configuración de OAuth, uno de:

            -   **OFF**

                -   **Token de acceso OAuth:** Ingresa el token de acceso OAuth.

            -   **REFRESH**

                -   **Token de acceso OAuth:** Ingresa el token de acceso OAuth.

            -   **GETANDREFRESH**

        -   **Token de actualización OAuth:** Ingresa el token de actualización OAuth.

        -   **Certificado OAuth JWT:** Ingresa el certificado OAuth JWT.

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

                -   **USER**

            -   **MACHINE**

            -   **PFXFILE**

            -   **PFXBLOB**

            -   **JKSFILE**

            -   **JKSBLOB**

            -   **PEMKEY_FILE**

            -   **PEMKEY_BLOB**

            -   **PUBLIC_KEY_FILE**

            -   **PUBLIC_KEY_BLOB**

            -   **SSHPUBLIC_KEY_FILE**

            -   **SSHPUBLIC_KEY_BLOB**

            -   **P7BFILE**

            -   **PPKFILE**

            -   **XMLFILE**

            -   **XMLBLOB**

            -   **BCFKSFILE**

            -   **BCFKSBLOB**

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

    • SharePoint OnPremise

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

        • NTLM

          • Usuario: Ingresa el usuario.

          • Contraseña: Ingresa la contraseña.

        • Negotiate

          • Usuario: Ingresa el usuario.

          • Contraseña: Ingresa la contraseña.

        • None

        • Basic

          • Usuario: Ingresa el usuario.

          • Contraseña: Ingresa la contraseña.

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

  • Esquema: Selecciona 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 que dependan de conexiones que usan el esquema SOAP de SharePoint Online comenzarán a fallar. Para migrar:

    1. Crea una nueva conexión configurada con el esquema REST.
    2. Establece 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. Prueba la conexión.
    4. Para cada actividad que use la conexión SOAP anterior, abre la pantalla de configuración de la actividad, coloca el cursor sobre el nombre del punto de conexión para mostrar el icono de edición , haz clic en el menú del punto de conexión y selecciona la nueva conexión REST.
    5. Si experimentas problemas al cambiar el punto de conexión, crea nuevas actividades desde el nuevo punto de conexión REST desde cero y reemplázalas manualmente en cada operación donde se usaban las actividades anteriores.
    6. Completa los pasos de configuración de cada actividad. Dado que el esquema REST expone diferentes tablas y columnas que SOAP, revisa y actualiza las selecciones de tablas y asignaciones de campos según sea necesario.
    7. Vuelve a implementar cualquier operación que dependa de la conexión y ejecútalas para validar las actividades actualizadas.
    8. Retira la conexión anterior basada en SOAP.

    Contacta al soporte de Jitterbit para obtener ayuda.

  • Usar configuración de proxy: Selecciona para usar la configuración de proxy del agente privado.

  • Configuraciones avanzadas: Cuando se selecciona, muestra la tabla Propiedades de configuraciones avanzadas, que se usa 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 fila nueva o cualquier cambio realizado en una fila existente. Visible al pasar el cursor sobre una fila en modo de edición.
    • Editar: Te 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 compatibles con otros servicios. Agrega la propiedad de configuración UseSimpleNames y establécela en true para aplicar un esquema de nombres restringido a caracteres alfanuméricos y guiones bajos en columnas y tablas. Los caracteres no alfanuméricos se convierten a guiones bajos cuando esta opción está habilitada.

    Importante

    Los campos en la tabla Advanced Configurations Properties muestran el icono de variable solo en modo de edición. Para que los valores de variables 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 Advanced Configurations Properties no permiten usar variables para pasar JSON sin procesar. Si tu caso de uso no permite definir JSON sin procesar directamente en los campos, escapa el contenido JSON antes de pasarlo con una variable. Por ejemplo, escapar {"success": "true"}; se convierte en {\"success\": \"true\"};.

  • Probar: Haz clic para verificar la conexión usando la configuración especificada. 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 permite suspender la descarga de la versión más reciente del conector usando la política de organización Disable Auto Connector Update.

  • 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 Component dependencies, deletion, and removal). Un mensaje te pide que confirmes que deseas eliminar la conexión.

Configurar conexiones OAuth

Este conector admite una conexión usando OAuth mediante propiedades de configuración específicas. Después de seleccionar un esquema de autenticación que incluya Initiate OAuth, podrás especificar la configuración en los campos que se muestran.

Nota

Es posible que se requieran IDs adicionales, secretos, alcances y otros tokens de autenticación para completar exitosamente la autenticación OAuth. Consulta la documentación del endpoint para obtener información adicional sobre sus requisitos.

Este conector admite dos escenarios. En cualquiera de los escenarios, necesitarás usar una herramienta de terceros (como Postman o una herramienta similar) para obtener el token o tokens de acceso requeridos del endpoint involucrado. Ambos escenarios funcionan solo para grupos de agentes individuales. Se trata de grupos de agentes que constan de un único agente.

  • Escenario 1: Usar un token de acceso OAuth que expira después de un período de tiempo establecido.

    Con esta configuración, proporcionas un token de acceso OAuth que dura un período de tiempo establecido, según lo determine el endpoint en particular. El conector usará el token para establecer la conexión. Sin embargo, la conexión dejará de funcionar una vez que expire el token de acceso. Configurarías el conector para usar el token estableciendo estas propiedades:

    Propiedad de configuración Valor
    Initiate OAuth OFF
    OAuth Access Token Establécelo 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 usará un token de actualización para obtener un nuevo token de acceso una vez que expire el token de acceso actual. Este es generalmente el mejor método para configurar OAuth.

Proporcionas un token de acceso OAuth y un token de actualización OAuth, según lo determine el endpoint en particular. Configurarías el conector para usar estos tokens estableciendo estas propiedades:

Propiedad de configuración Valor
Iniciar OAuth REFRESH
Token de acceso OAuth Establece el valor del token de acceso OAuth obtenido del endpoint
Token de actualización OAuth Establece el valor del token de actualización OAuth obtenido del endpoint

Nota

Si utilizas múltiples conexiones de Microsoft SharePoint Server basadas en OAuth en el mismo agente privado, establece la propiedad de configuración OAuthSettingsLocation en una ruta de agente única y escribible para cada conexión. En el archivo jitterbit.conf del agente, establece EnableLocalFileLocation=true. Si no realizas 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 crear una conexión de conector de Microsoft SharePoint Server, colocas un tipo de actividad en el lienzo de diseño para crear instancias de actividad que se utilicen como orígenes (para proporcionar datos en una operación) o como destinos (para consumir datos en una operación).

Las acciones de 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 obtener más detalles, consulta 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 SharePoint Server y está diseñada para usarse como origen en una operación.

  • Crear: Inserta un registro en una tabla en Microsoft SharePoint Server y está diseñada para usarse como destino en una operación.

  • Actualizar: Actualiza un registro en una tabla en Microsoft SharePoint Server y está diseñada para usarse como destino en una operación.

  • Eliminar: Elimina un registro de una tabla en Microsoft SharePoint Server y está diseñada para usarse como destino en una operación.

  • Ejecutar: Ejecuta un procedimiento en Microsoft SharePoint Server y está diseñada para usarse como destino en una operación.