Skip to main content
Cuando Iru lee usuarios de una fuente conectada, necesita saber qué campo entrante rellena cada atributo de perfil de Iru y, a veces, cómo transformar el valor por el camino. Esto se describe con una asignación de atributos: para cada atributo de perfil de Iru, escribes una expresión que produce su valor a partir de los campos de la fuente.
Dónde se aplica la asignación de atributos. Escribes asignaciones de atributos cuando conectas un sistema de origen (los conectores de Workday y BambooHR, que exponen sus propios campos para que los asignes). No se aplica a la importación CSV: un CSV usa un conjunto fijo de columnas predefinidas, por lo que no hay expresiones que escribir.
Las expresiones de asignación se escriben en IQL, el mismo lenguaje de expresiones que Iru usa para la asignación de claims y atributos de aplicaciones, las reglas de Auto Groups y los filtros de listas. Aquí asignarás los campos de un sistema de origen conectado a los atributos de perfil de tu directorio; consulta Expresiones IQL para ver la sintaxis completa.

Cómo funciona una asignación

Cada fila de una asignación empareja un destino (un atributo de perfil de Iru) con una expresión que obtiene datos de los campos de origen.
1

Descubre los campos de origen

Iru lee el conjunto de campos que tu fuente pone a disposición. Esos nombres de campo se convierten en los identificadores a los que puedes hacer referencia en las expresiones. Consulta Directory Sync para ver cómo encaja el descubrimiento en la configuración.
2

Escribe una expresión por atributo

Para cada atributo de Iru que quieras rellenar, escribe una expresión IQL. Un nombre de campo válido puede usarse solo. Cualquier otro nombre se busca en __source. Las expresiones más largas combinan o transforman esos valores.
3

Iru la valida

Las expresiones se comprueban mientras escribes y de nuevo al guardar, de modo que los errores (un campo desconocido, un error de tipo) aparecen antes de llegar a una sincronización.
4

Se ejecuta en cada sincronización

Cuando se ejecuta la sincronización, Iru evalúa cada expresión con la fila entrante y escribe el resultado en el atributo.
Elige un campo de origen estable y único como identificador que vincule un registro de origen con un usuario de Iru, de modo que cada sincronización se resuelva en exactamente un usuario.

Escribir expresiones

Las expresiones hacen referencia a los campos de tu fuente y pueden transformarlos: convertir a mayúsculas o minúsculas, dividir, concatenar, elegir un elemento de una lista, etc. La referencia completa (objetos, funciones, operadores y ejemplos) está en la página Expresiones IQL, ya que el mismo lenguaje impulsa tanto la asignación del directorio como la asignación de aplicaciones. Un nombre de campo puede usarse solo cuando es un identificador IQL válido. Empieza con una letra ASCII o un guion bajo, y el resto son letras ASCII, números y guiones bajos. Un nombre como prénom queda fuera de ese conjunto, por lo que se lee desde __source.
Cuando el nombre tiene un espacio, un guion, dos puntos u otro símbolo, o cuando es una palabra clave de IQL como in, null, true o if, búscalo por su nombre exacto en __source. __source es un mapa con todos los campos de la fuente. Un punto entre nombres válidos accede a un valor anidado, como en name.givenName. Un nombre de campo que incluye un punto sigue siendo una sola clave: __source["name.givenName"]. Escrito sin más, Email - Work es una resta, e in es el operador de pertenencia.
El editor de asignaciones reescribe estos campos como __source["…"] cuando los eliges o los escribes. Un nombre válido se queda tal cual. Aun así, puedes escribir __source["…"] para un nombre válido. Si el nombre contiene " o \, coloca una barra invertida antes de cada uno dentro de los corchetes, como en __source["Title \"Legal\""]. El editor añade ese escape cuando reescribe el campo. Consulta Transformar valores con IQL para ver cómo funciona esto en la pestaña Mapping.

Valores asignados vacíos

Un valor asignado vacío o nulo borra el valor existente de ese atributo personalizado. La sincronización continúa. Para un atributo personalizado de tipo Boolean, Date, Integer o Decimal, un valor asignado vacío o nulo no hace fallar la sincronización. Cuando transformes un campo de texto que pueda estar vacío, como al dividir un correo electrónico, protege el valor en la pestaña Mapping.

Próximos pasos

Expresiones IQL

La referencia completa de IQL: objetos, funciones, operadores y ejemplos.

Sincronización del directorio

Conecta un sistema de RR. HH. y configura las asignaciones que impulsan estas expresiones.

Atributos de perfil

Los destinos en los que escriben tus expresiones.

Grupos automáticos

Otro lugar donde los atributos impulsan la automatización en tu directorio.