Saltar al contenido

Actividad de entrada de búsqueda LDAP

Introducción

Una actividad de entrada de búsqueda LDAP devuelve entradas en un extremo LDAP y está destinada a utilizarse como una fuente para proporcionar datos a una operación. Después de configurar una conexión LDAP, puede configurar tantas actividades LDAP como desee para cada conexión LDAP.

Crear una actividad LDAP

Una instancia de una actividad se crea a partir de una conexión utilizando un tipo de actividad.

Para crear una instancia de una actividad, arrastre el tipo de actividad al tela de diseño o copie el tipo de actividad y péguelo en el tela de diseño. Para obtener más detalles, consulte Creación de una instancia de actividad en Reutilización de componentes.

Se puede editar una actividad existente desde estas ubicaciones:

Configurar una actividad de entrada de búsqueda LDAP

Siga estos pasos para configurar una actividad de entrada de búsqueda LDAP:

Paso 1: Ingrese un nombre y seleccione una clase estructural

Paso 1 de configuración de la actividad de entrada de búsqueda LDAP

  • Nombre: Ingrese un nombre para identificar la actividad de entrada de búsqueda LDAP. El nombre debe ser único para cada actividad de entrada de búsqueda LDAP y no debe contener barras diagonales (/) o dos puntos (:).

  • Seleccionar clase estructural: Esta sección muestra las clases estructurales disponibles en el extremo LDAP. al volver a abrir una configuración de actividad existente, solo se muestra la clase estructural seleccionada en lugar de volver a cargarla toda la lista de clases estructurales.

    • Clase estructural seleccionada: Después de seleccionar una clase estructural, esta aparece aquí.

    • Buscar: Ingrese el valor de cualquier columna en el cuadro de búsqueda para filtrar la lista de clases estructurales. La búsqueda no distingue entre mayúsculas y minúsculas. Si ya se muestran clases estructurales dentro la tabla, los resultados de la tabla se filtran en tiempo real con cada pulsación de tecla. Para recargar clases estructurales desde el extremo durante la búsqueda, ingrese los criterios de búsqueda y luego actualice, como se describe a continuación.

    • Actualizar: Haga clic en el ícono de actualización Ícono de actualización o la palabra Actualizar para recargar clases estructurales desde el extremo LDAP. Esto puede ser útil si ha agregado recientemente clases estructurales al extremo LDAP. Esta acción actualiza todos los metadatos utilizados para crear el tabla de clases estructurales mostradas en la configuración.

    • Selección de una clase estructural: Dentro de la tabla, haga clic en cualquier lugar de una fila para seleccionar una clase estructural. Solo se puede seleccionar una clase estructural. La información disponible para cada una clase estructural se obtiene desde el extremo LDAP:

      • Nombre: El nombre de la clase estructural del extremo LDAP.
      • Descripción: La descripción de la clase estructural del extremo LDAP.

    Consejo

    Si la tabla no se llena con las clases estructurales disponibles, la conexión LDAP puede no funcionar correctamente. Asegúrese de estar conectado volviendo a abrir la conexión y volviendo a probar las credenciales.

  • Guardar y salir: Si está habilitado, haga clic para guardar la configuración de este paso y cerrar la configuración de la actividad.

  • Siguiente: Haga clic para almacenar temporalmente la configuración de este paso y continuar con el siguiente paso. La configuración no se guardará hasta que haga clic en el botón Terminado en el último paso.

  • Descartar cambios: Después de realizar cambios, haga clic para cerrar la configuración sin guardar los cambios realizados en ningún paso. Un mensaje le solicitará que confirme que desea descartar los cambios.

Paso 2: Seleccionar clases auxiliares

Paso 2 de la configuración de la actividad de entrada de búsqueda LDAP

  • Clases de objetos: Esta sección se utiliza para restringir aún más la búsqueda seleccionando clases auxiliares. La sección es opcional y se puede omitir seleccionando Siguiente.

    • Clases auxiliares disponibles: Esta columna muestra las clases auxiliares para seleccionar.

      • Buscar: Ingrese el valor de cualquier columna en el cuadro de búsqueda para filtrar la lista de auxiliares. clases. La búsqueda no distingue entre mayúsculas y minúsculas. Si las clases de objetos ya se muestran dentro de la tabla, la tabla Los resultados se filtran en tiempo real con cada pulsación de tecla. Para volver a cargar las clases auxiliares desde el extremo cuando Para buscar, ingrese los criterios de búsqueda y luego actualice, como se describe a continuación.

      • Actualizar: Haga clic en el ícono de actualización Ícono de actualización para recargar clases auxiliares desde el extremo LDAP. Esto puede resultar útil si ha agregado recientemente clases auxiliares al extremo LDAP.

      • Agregar una clase auxiliar: Dentro de la columna, haga clic en cualquier lugar de una fila para seleccionar una o más clases auxiliares. clases. Luego, haga clic en el ícono Agregar para agregar las clases seleccionadas a la columna Clases auxiliares seleccionadas:

        Añadir icono

    • Clases auxiliares seleccionadas: Esta columna muestra las clases auxiliares seleccionadas.

      • Eliminación de una clase auxiliar: Dentro de la columna, haga clic en cualquier lugar de una fila para seleccionar una o más clases auxiliares. . Luego, haga clic en el ícono de eliminación para regresar las clases seleccionadas a la columna Clases auxiliares disponibles:

        Eliminar ícono

  • Atrás: Haga clic para almacenar temporalmente la configuración de este paso y volver al paso anterior.

  • Siguiente: Haga clic para almacenar temporalmente la configuración de este paso y continuar con el siguiente. La configuración no se guardará hasta que haga clic en el botón Terminado en el último paso.

  • Descartar cambios: Después de realizar cambios, haga clic para cerrar la configuración sin guardar los cambios realizados en ningún paso. Un mensaje le solicitará que confirme que desea descartar los cambios.

Paso 3: Especificar la configuración

Paso 3 de la configuración de la actividad de entrada de búsqueda LDAP

Sugerencia

Campos con un ícono de variable Ícono de variable admite el uso de variables globales, variables del proyecto y variables Jitterbit. Comience escribiendo un corchete abierto [ en el campo o haciendo clic en el ícono de variable para mostrar una lista de las variables existentes para elegir.

  • DN base: Ingrese el nombre distinguido base que se utilizará como punto de partida para la búsqueda.

  • Atributos disponibles: Esta columna muestra los atributos para seleccionar.

    • Buscar: Ingrese el valor de cualquier columna en el cuadro de búsqueda para filtrar la lista de atributos. La búsqueda no distingue entre mayúsculas y minúsculas. Si los atributos ya se muestran dentro de la tabla, los resultados de la tabla se muestran en la siguiente figura. filtrado en tiempo real con cada pulsación de tecla. Para volver a cargar los atributos desde el extremo al realizar una búsqueda, ingrese buscar criterios y luego actualice, como se describe a continuación.

    • Actualizar: Haga clic en el ícono de actualización Ícono de actualización para recargar atributos desde el extremo LDAP. Esto puede resultar útil si ha agregado recientemente atributos al extremo LDAP.

    • Agregar un atributo: Dentro de la columna, haga doble clic en cualquier lugar de una fila para agregar el atributo a la Columna Expresión de filtro a la derecha. Luego edite la Expresión de filtro según sea necesario para crear una expresión válida. expresión.

  • Expresión de filtro: Ingrese una expresión de filtro.

    Como mínimo, la expresión de filtro debe incluir la clase estructural previamente completada seleccionada en Paso 1: Ingrese un nombre y seleccione una clase estructural. Al cambiar la clase estructural seleccionada en el paso 1, la expresión de filtro existente se reemplaza en su totalidad con la nueva clase estructural pre-poblada.

    Puede agregar atributos y otros filtros como se documenta en Tipos de filtros LDAP. No se admite la inclusión de clases de objetos estructurales adicionales.

    Nota

    Según los requisitos del extremo LDAP, es posible que deba cambiar el caso de la expresión de filtro precargada para la clase estructural. Por ejemplo, cambie ObjectClass a objectClass.

  • Alcance: Especifique el alcance que se utilizará para la búsqueda, uno de los siguientes: Objeto (base), Un nivel o Subárbol:

    • Objeto (Base): Solo se buscará la entrada especificada en el campo DN base, sin incluir los subordinados.

    • Un nivel: Solo se buscarán los hijos inmediatos de la entrada especificada en el campo DN base. sin incluir la entrada Base DN en sí.

    • Subárbol: Se buscará la entrada especificada en el campo DN base y todos sus subordinados hasta cualquier profundidad.

  • Tamaño de página: Ingrese la cantidad de registros que se devolverán para cada solicitud. La actividad envía tantas solicitudes como necesario para devolver todos los registros. Este parámetro puede estar limitado por el límite de tamaño configurado en el servidor LDAP específico.

  • Atrás: Haga clic para almacenar temporalmente la configuración de este paso y regresar al paso anterior.

  • Siguiente: Haga clic para almacenar temporalmente la configuración de este paso y continuar con el siguiente paso. La configuración no se guardará hasta que haga clic en el botón Finalizado en el último paso.

  • Descartar cambios: Después de realizar cambios, haga clic para cerrar la configuración sin guardar los cambios realizados en ninguna paso. Un mensaje le solicitará que confirme que desea descartar los cambios.

Paso 4: Revisar los esquemas de datos

Paso 4 de configuración de la actividad de entrada de búsqueda LDAP

  • Esquema de datos: Se muestra el esquema de datos de respuesta para una actividad de entrada de búsqueda LDAP. Si la operación utiliza una transformación, los esquemas de datos se muestran nuevamente más tarde durante el proceso de mapeo de la transformación , donde puedes mapear a campos de destino usando objetos de origen, secuencias de comandos, variables, valores personalizados y más.

    El conector LDAP utiliza la API LDAP de directorio Apache versión 1.0.1. Esta API admite todos los tipos de servidores LDAP, no solo ApacheDS. Consulte la Documentación de la API LDAP de Apache 1.0.1 y documentación sobre el servidor LDAP específico para obtener información sobre los campos del esquema.

    Estos son los campos del esquema que se muestran en la captura de pantalla de ejemplo anterior:

    Campo/Nodo del esquema de respuesta Notas
    json El formato del esquema de respuesta
    searchResponse La respuesta de búsqueda del lenguaje de marcado de servicios de directorio (DSML)
    entradas Entradas LDAP, cada una de las cuales contiene un nombre distintivo (dn) y una lista de atributos
    elemento Una entrada LDAP
    ObjectClass Una definición de clase de objeto
    item La clase de objeto item
    #texto Valor de la clase de objeto item
    dn El nombre distintivo que representa una posición en una jerarquía
    atributos Los atributos LDAP
    ContraseñaDeUsuario La contraseña del usuario
    item El elemento de contraseña de usuario
    #texto Valor del elemento de contraseña del usuario

  • Actualizar: Haga clic en el ícono de actualización Ícono de actualización o la palabra Actualizar para regenerar esquemas desde el extremo LDAP. Esta acción también regenera el esquema en otros ubicaciones en todo el proyecto donde se hace referencia al mismo esquema, como en una transformación adyacente.

  • Editar: Haga clic en el ícono de edición Ícono de edición sobre el esquema de datos de respuesta para ingresar al editor. El editor le permite agregar, eliminar y reorganizar nodos y campos y cambiar sus tipos de datos. Todos los nodos y campos recién agregados se configuran como [0, 1]cardinalidad. Los cambios realizados en el esquema de datos de respuesta deben ser aceptables para el extremo y deben realizarse solo después de consultar la documentación disponible para el extremo.

  • Atrás: Haga clic para almacenar temporalmente la configuración de este paso y regresar al paso anterior.

  • Terminado: Haga clic para guardar la configuración de todos los pasos y cerrar la configuración de la actividad.

  • Descartar cambios: Después de realizar cambios, haga clic para cerrar la configuración sin guardar los cambios realizados en ninguna paso. Un mensaje le solicitará que confirme que desea descartar los cambios.

Próximos pasos

Después de configurar una actividad de entrada de búsqueda LDAP, complete la configuración de la operación agregando y Configurar otras actividades, transformaciones o secuencias de comandos como pasos de la operación. También puede configurar una operación configuraciones de operación, que incluyen la capacidad de encadenar operaciones que se encuentran en el mismo o en diferentes flujos de trabajo.

Después de crear una actividad LDAP, las acciones del menú para esa actividad son accesibles desde el panel del proyecto, ya sea en la pestaña Flujos de trabajo o en la pestaña Componentes, y desde el tela de diseño. Ver menú de acciones de actividad Para más detalles.

Las actividades de entrada de búsqueda LDAP se pueden utilizar como fuente con estos patrones de operación:

Otros patrones no son válidos para las actividades de entrada de búsqueda LDAP. Consulte los patrones de validación en la Validez de la operación página.

Para utilizar la actividad con funciones de script, escriba los datos en una ubicación temporal y luego use esa ubicación temporal. Ubicación en la función de script.

Cuando esté listo, desplegar y ejecute la operación y valide el comportamiento verificando la registros de operación.