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.
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 comoprénom queda fuera de ese conjunto, por lo que se lee desde
__source.
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.
__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.