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 usarse 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 de tela de diseño o cópielo y péguelo en él. Para obtener más información, consulte Crear una instancia de actividad o herramienta en Reutilización de componentes.

Se puede editar una actividad existente desde estas ubicaciones:

El tela de diseño (vea menú de acciones del componente en Lienzo de diseño).
La pestaña Componentes del panel del proyecto (vea menú de acciones de componentes en la pestaña Componentes del panel 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 la configuración
Paso 4: Revisar los esquemas de datos

Paso 1: Ingrese un nombre y seleccione una clase estructural

Nombre: Introduzca 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. Cuando Al reabrir 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 las clases estructurales ya se muestran en la tabla, los resultados se filtran en tiempo real con cada pulsación de tecla. Para recargar las 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 Refrescar a 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.
- Seleccionar 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 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 podría no funcionar correctamente. Asegúrese de estar conectado reabriendo la conexión y probando 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 guardar 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 Finalizado en el último paso.
Descartar cambios: Después de realizar los cambios, haga clic para cerrar la configuración sin guardar los cambios realizados en ningún paso. Un mensaje le pedirá que confirme que desea descartar los cambios.

Paso 2: Seleccionar clases auxiliares

Clases de objeto: Esta sección se utiliza para restringir aún más la búsqueda seleccionando clases auxiliares. Esta 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 objeto ya se muestran en la tabla, la tabla los resultados se filtran en tiempo real con cada pulsación de tecla. Para recargar 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 para recargar clases auxiliares desde el extremo LDAP. Esto puede ser útil si ha añadido 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 haz clic en el ícono de agregar. Para añadir 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 parte de una fila para seleccionar una o más clases auxiliares. A continuación, haga clic en el icono de eliminar. Para regresar las clases seleccionadas a la columna Clases Auxiliares Disponibles.
Atrás: Haga clic para guardar temporalmente la configuración de este paso y volver al paso anterior.
Siguiente: Haga clic para guardar 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 Finalizado en el último paso.
Descartar Cambios: Después de realizar los cambios, haga clic para cerrar la configuración sin guardar los cambios realizados en ningún paso. Un mensaje le pedirá que confirme que desea descartar los cambios.

Paso 3: Especificar la configuración

Consejo

Campos con un icono de variable soporte utilizando variables globales, variables del proyecto y variables de 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 en la tabla, los resultados de la tabla son... filtrado en tiempo real con cada pulsación de tecla. Para recargar los atributos desde el extremo durante la búsqueda, introduzca "buscar". criterios y luego actualice, como se describe a continuación.
- Actualizar: Haga clic en el ícono de actualización para recargar atributos desde el extremo LDAP. Esto puede ser útil si ha añadido atributos recientemente 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 uso de mayúsculas y minúsculas en 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 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.
Atrás: Haga clic para guardar temporalmente la configuración de este paso y regresar al paso anterior.
Siguiente: Haga clic para guardar temporalmente la configuración de este paso y continuar con el siguiente. La configuración de 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 pedirá 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 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 de 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 1.0.1 de Apache y documentación sobre el servidor LDAP específico para obtener información sobre los campos del esquema.

Estos son los campos de 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	Respuesta de búsqueda del Lenguaje de marcado de servicios de directorio (DSML)

entradas	Entradas LDAP, cada una con un nombre distinguido (`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 distinguido 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 del usuario
#texto	Valor del elemento de contraseña del usuario

Actualizar: Haz clic en el icono de actualización. o la palabra Refrescar a 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 Sobre el esquema de datos de respuesta para acceder al editor. El editor permite agregar, eliminar y reorganizar nodos y campos, así como 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 únicamente tras consultar la documentación disponible del extremo. Tras realizar modificaciones en el esquema, se muestra la fecha de la última edición en la parte superior del esquema correspondiente para indicar que se han realizado modificaciones manuales. Al actualizar el esquema, se esquema su estructura predeterminada.
Atrás: Haga clic para guardar 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 ningún paso. Un mensaje le pedirá 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 o herramientas 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, en las pestañas Flujos de trabajo o 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:

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 usar actividades de entrada de búsqueda LDAP. Consulte los patrones de validación en la página Validez de la operación página.

Para utilizar la actividad con funciones de scripting, 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.