Actividad de Entrada de Búsqueda LDAP¶

Introducción¶

Una actividad de búsqueda de entrada LDAP devuelve entradas en un extremo LDAP y está destinada a usarse como 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 cópielo y péguelo en el tela de diseño. Para obtener más información, consulte Creación de una instancia de actividad en Reutilización de componentes.

Una actividad existente se puede editar desde estas ubicaciones:

El tela de diseño (consulte Menú de acciones del componente en Tela de Diseño).
La pestaña Componentes del panel del proyecto (consulte Menú de acciones de componentes en Pestaña Componentes del panel de proyecto).

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 2: Seleccionar clases auxiliares
Paso 3: Especificar configuración
Paso 4: revisar los esquemas de datos

Paso 1: Ingrese un Nombre y Seleccione una Clase Estructural¶

Nombre: Introduzca un nombre que se utilizará 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 (:).
Seleccione clase estructural: Esta sección muestra las clases estructurales disponibles en el extremo LDAP. Cuando al reabrir una configuración de actividad existente, solo se muestra la clase estructural seleccionada en lugar de recargar toda la lista de clases estructurales.
- Clase estructural seleccionada: Después de seleccionar una clase estructural, se enumera 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 las clases estructurales ya se muestran 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 icono 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 que se muestran en la configuración.
- Seleccionar una clase estructural: Dentro de la tabla, haga clic en cualquier lugar de una fila para seleccionar una clase estructural. Sólo se puede seleccionar una clase estructural. La información disponible para cada la clase estructural se obtiene del 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 completa con las clases estructurales disponibles, la conexión LDAP puede no tener éxito. 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 para este paso y cerrar la configuración de la actividad.
Siguiente: Haga clic para almacenar temporalmente la configuración para este paso y continuar con el siguiente. El 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 ningún paso. Un mensaje le pide que confirme que desea descartar los cambios.

Paso 2: Seleccione Clases Auxiliares¶

Clases de Objetos: Esta sección se utiliza para restringir aún más la búsqueda seleccionando clases auxiliares. Este 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 recargar clases auxiliares desde el extremo cuando buscando, ingrese los criterios de búsqueda y luego actualice, como se describe a continuación.
  - Actualizar: Haga clic en el icono de actualización para recargar clases auxiliares desde el extremo LDAP. Esto puede resultar útil si recientemente agregó 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:
- Clases auxiliares seleccionadas: Esta columna muestra las clases auxiliares seleccionadas.
  - Eliminar 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 icono de eliminar para devolver las clases seleccionadas a la columna Clases auxiliares disponibles:
Volver: 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 para este paso y continuar con el siguiente. El 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 ningún paso. Un mensaje le pide que confirme que desea descartar los cambios.

Paso 3: Especificar la Configuración¶

Consejo

Campos con un ícono de variable admite el uso de variables globales, variables del proyecto, y variables de Jitterbit. Comience escribiendo un corchete abierto [ en el campo o haciendo clic en el icono 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 atributos para seleccionar.
- Buscar: Ingrese el valor de cualquier columna en el cuadro de búsqueda para filtrar la lista de atributos. El 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 filtrado en tiempo real con cada pulsación de tecla. Para recargar atributos desde el extremo durante la búsqueda, ingrese buscar criterios y luego actualizar, como se describe a continuación.
- Actualizar: Haga clic en el icono de actualización para recargar atributos del 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: Introduzca una expresión de filtro.

Como mínimo, la expresión de filtro debe incluir la clase estructural precompletada 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 clase estructural recién completada previamente.

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

Nota

Dependiendo de los requisitos del extremo LDAP, es posible que deba cambiar el caso de la expresión de filtro rellenada previamente para la clase estructural. Por ejemplo, cambiar ObjectClass a objectClass.
Alcance: Especifique el alcance a utilizar para la búsqueda, uno de Objeto (Base), Un nivel o Subárbol:
- Objeto (Base): Solo se buscará la entrada especificada en el campo Base DN, sin incluir los subordinados.
- Un nivel: Solo se buscarán los hijos inmediatos de la entrada especificada en el campo Base DN, sin incluir la entrada Base DN en sí.
- Subárbol: Se buscará la entrada especificada en el campo Base DN y todos sus subordinados hasta cualquier profundidad.
Tamaño de página: Introduzca el número 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.
Volver: 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 para este paso y continuar con el siguiente. El 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 ningún paso. Un mensaje le pide que confirme que desea descartar los cambios.

Paso 4: Revisar los Esquemas de Datos¶

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 adelante durante el proceso de mapeo de transformación , donde puede asignar campos de destino utilizando objetos de origen, secuencias de comandos, variables, valores personalizados y más.

El conector LDAP utiliza la API LDAP de Apache Directory versión 1.0.1. Esta API admite todo tipo de servidores LDAP, no solo ApacheDS. Referirse a Documentación de Apache LDAP API 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

respuesta de búsqueda	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 distinguido (`dn`) y una lista de atributos

artículo	Una entrada LDAP

Clase de objeto	Definición de clase de objeto

artículo	El elemento de clase de objeto
#texto	Valor del elemento de clase de objeto

dn	El nombre distinguido que representa una posición en una jerarquía

atributos	Los atributos LDAP

contraseña de usuario	La contraseña del usuario

artículo	El elemento de contraseña de usuario
#texto	Valor del elemento de contraseña de usuario

Actualizar: Haga clic en el icono 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 encima del 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 están configurados para [0, 1] cardinalidad. Los cambios realizados en el esquema de datos de respuesta deben ser aceptables para el extremo y deben realizarse sólo después de consultar cualquier documentación disponible para el extremo.
Volver: Haga clic para almacenar temporalmente la configuración de este paso y volver 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 ningún paso. Un mensaje le pide 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 operación. También puede configurar una operación configuraciones de operación, que incluyen la capacidad de encadenar operaciones que estén en el mismo o diferente flujos de trabajo.

Una vez creada una actividad LDAP, se puede acceder a las acciones del menú para esa actividad. desde el panel del proyecto en las pestañas Flujos de Trabajo o Componentes, y desde el tela de diseño. Ver Menú de acciones de actividad para detalles.

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

Patrón de transformación
Patrón de archivo de dos objetivos (solo como primera fuente)
Patrón de archivo HTTP de dos destinos (solo como primera fuente)
Patrón de dos transformaciones (como primera o segunda fuente)

Otros patrones no son válidos al utilizar actividades de entrada de búsqueda LDAP. Vea los patrones de validación en el Validez de la operación página.

Para usar la actividad con funciones de secuencias de comandos, escriba los datos en una ubicación temporal y luego use esa ubicación temporal. ubicación en la función de scripting.

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