Lista de operaciones disponibles por las reglas de sincronización

	Conversión	Reglas de Matching	Comparación	Creación	Modificación	Eliminación
ADDVALUE	X			X	X	X
CHANGE	X			X	X	X
COMPAREATTNAME			X
COMPAREWITHEXCLUSIONS		X	X
COMPARE			X
CONVERT	X
COPY	X			X	X	X
DELETE	X
DELVALUE	X			X	X	X
DELVALUEBYVALUE	X			X	X	X
DSTCOPY	X			X	X	X
EQ		X	X
FILTERAR	X
GETSTRUCTCHILD	X
GROUPAR	X
ISCONTAINED			X
MERGE	X
MODVALUE	X			X	X	X
MULTCOPY				X	X	X
MULTDSTCOPY				X	X	X
MULTIEVALEQ		X
MULTSET	X			X	X	X
MVEQ			X
RENAME	X
SET	X			X	X	X
SIMPLEEQ		X
SPLIT	X

Opciones disponibles para cada operación:

	B64	CI	DATE	DATE_FILETIME	DN	PARTIAL	PWD	USEMAP
ADDVALUE	X		X	X			X
CHANGE	X		X	X			X
COMPAREATTNAME		X			X
CONTAIN		X			X
CONVERT	X		X	X			X
COPY	X		X	X			X
DELETE	X		X	X			X
DELVALUE	X		X	X			X
DELVALUEBYVALUE	X		X	X			X
DSTCOPY	X		X	X			X
EQ** Las demás		X			X			X
FILTREAR	X		X	X			X
GETSTRUCTCHILD	X		X	X			X
GROUPAR	X		X	X			X
ISCONTAINED		X			X
MERGE	X		X	X			X
MODVALUE	X		X	X			X
MULTCOPY	X		X	X			X
MULTDSTCOPY	X		X	X			X
MULTIEVALEQ		X				X		X
MULTSET	X		X	X			X
MVEQ		X			X
RENAME	X		X	X			X
SET	X		X	X			X
SIMPLEEQ** El número de la línea de referencia es el número de la línea de referencia.		X			X			X
SPLIT	X		X	X			X

**: Los filtros difieren según la regla que utiliza la operación.

• B64: Convierte el valor del atributo en el formato Base 64.
• CI: caso insensible: la comparación se realiza independientemente del caso.
• DATE: Convierte el valor del atributo en el formato DATE.
• DATE_FILETIME: Convierte el valor del atributo en el formato DATETIME.
• DN: comparación de las DN.
• PARTIAL: compara parcialmente los datos. Devuelve verdad si al menos un valor está contenido en el atributo de comparación.
• PWD: Permite el cifrado de datos.
• USEMAP: el uso de un mapa para encontrar el atributo, acelera el proceso de comparación.

ADDVALUE

Operación que permite agregar valores a un atributo que, por definición, puede tener varios valores. También permite la concatenación de valores de varios atributos.

Sintaxis de las funciones:

• [Descripción]: texto libre para describir la operación (opcional).
• [Atributo]: nombre del atributo a modificar. Si el atributo no existe, se creará automáticamente.
• [Expresión]: fórmula que se introducirá. Es posible utilizar palabras clave o introducir todo o parte de valores fijos (texto codificado). Consulte el capítulo "Lista de palabras clave" para conocer la sintaxis que se aplicará en su caso de uso.

Ejemplo de la siguiente configuración:

CHANGE

Operación que permite modificar el valor de un atributo. El atributo debe existir y tener un solo valor. El valor inicial del atributo se sobrescribe y ya no se puede reutilizar.

Atención

La operación CHANGE está obsoleta a partir de la versión 7.1 y se suprimirá a partir de la versión 7.2. Duplica la operación MODVALUE: utilice a partir de ahora MODVALUE para modificar el valor de un atributo.

Sintaxis de las funciones:

• [Descripción]: texto libre para describir la operación (opcional).
• [Atributo]: nombre del atributo a modificar, si no existe, la operación no funcionará.
• [Expresión]: fórmula que se introducirá. Es posible utilizar palabras clave o introducir todo o parte de valores fijos (texto codificado). Consulte el capítulo "Lista de palabras clave" para conocer la sintaxis que se aplicará en su caso de uso.

Ejemplo de la siguiente configuración:

COMPAREATTNAME

Operación que permite enumerar atributos que no deben ser comparados y comparar todos los demás atributos que tienen el mismo nombre en ambos repositorios. Los nombres de atributos en el repositorio de origen que no tienen una contraparte en el repositorio de destino serán ignorados y no comparados. Puede usarse para reemplazar el mapeo unitario de los atributos a comparar.

Tenga en cuenta que esta operación sólo está disponible a partir de la versión 6.2 y sólo puede utilizarse en reglas de comparación en una operación MATCH en conectores de aprovisionamiento de estado de aprovisionamiento (estado).

Sintaxis de las funciones:

• [Atributo] = Lista de atributos que no se pueden comparar. Los atributos deben estar separados por comas y sin espacios.

Ejemplo de la siguiente configuración:

COMPAREWITHEXCLUSIONS

Operación que compara todos los atributos entre las dos fuentes, sin precisar el nombre de los atributos del repositorio de origen ni el del repositorio de destino. Es posible especificar los nombres de los atributos que no deben compararse, lo que equivale a definir los atributos cuyos códigos difieren entre los dos repositorios.

Tenga en cuenta que esta operación solo está disponible a partir de la versión 7.1 y solo puede utilizarse en la regla de Matching y en las reglas de comparación.

Se recomienda utilizar esta operación cuando la mayoría de los atributos tienen el mismo nombre en los repositorios de origen y de destino, con el fin de ahorrar tiempo de configuración.

A diferencia de la operación COMPAREATTNAME, que ignora los atributos sin homónimo en el repositorio de destino y solo se utiliza en los conectores de recuperación de los estados de aprovisionamiento, esta operación también señala los atributos presentes en uno solo de los dos repositorios.

Las modificaciones identificadas por esta operación responden a los siguientes casos de uso:

• un atributo existe en el repositorio de origen y en el repositorio de destino, con valores diferentes;
• un atributo existe en el repositorio de origen pero no en el repositorio de destino;
• un atributo existe en el repositorio de destino pero no en el repositorio de origen.

Sintaxis de las funciones:

COMPAREWITHEXCLUSIONS:[atributo_1],[atributo_2],…

Los atributos excluidos de la comparación se enumeran después de los dos puntos, separados por comas.

Ejemplo de la siguiente configuración:

COMPAREWITHEXCLUSIONS:whenChanged,objectGUID

Todos los atributos se comparan entre los dos repositorios, excepto whenChanged y objectGUID.

CONTAIN

Operación que realiza una comparación para verificar que los valores del atributo fuente autorizada están presentes en el atributo fuente objetivo. El resultado de la operación será la concatenación de los valores del atributo fuente objetivo con los valores del atributo fuente autorizada que no se encontraron.

**Ejemplo **

Se ha de indicar el nombre de la entidad que ha emitido el certificado de conformidad.

• Val_1
• Val_2
• Val_3

Se ha de indicar el número de la cuenta de la cuenta de la cuenta de la cuenta de la cuenta de la cuenta de la cuenta de la cuenta de la cuenta de la cuenta de la cuenta de la cuenta de la cuenta.

• Val_4
• Val_5
• Val_6

Resultado en el atributo de origen objetivo =

• Val_1
• Val_2
• Val_3
• Val_4
• Val_5
• Val_6

No se pueden utilizar palabras clave en esta operación.

Sintaxis de las funciones:

• [Descripción]: texto libre para describir la operación (opcional).
• [Atributo]: nombre del atributo presente en la fuente de destino en la que se va a realizar la comparación.
• [Nombre del atributo]: nombre del atributo presente en la fuente autorizada con el que se va a realizar la comparación.

Ejemplo de la siguiente configuración:

CONVERT

COPY

Operación que permite copiar el valor de un atributo a otro atributo. Funciona para atributos de valor único y de valor múltiple.

Sintaxis de las funciones:

• [Descripción]: texto libre para describir la operación (opcional).
• [Atributo]: nombre del atributo que se desea modificar. El atributo debe existir.
• [Nombre del atributo]: nombre del atributo de origen cuyo valor se copiará.

Ejemplo de la siguiente configuración:

El atributo usual_name tomará el valor del atributo birth_name.

DELETE

Operación que permite eliminar un atributo en una fuente especificada (fuente de exportación, destino de exportación o DELTA).

Sintaxis de las funciones:

• [Descripción]: texto libre para describir la operación (opcional).
• [Atributo]: nombre del atributo que se quiere eliminar.
• [Expresión]: no se debe rellenar este campo.

DELVALUE

Operación que permite eliminar valores de un atributo basado en una expresión booleana: si la expresión devuelve Verdadero, entonces los valores se eliminan. Por lo tanto, generalmente se aplica a atributos de varios valores.

Sintaxis de las funciones:

• [Descripción]: texto libre para describir la operación (opcional).
• [Atributo]: nombre del atributo que se quiere modificar.
• [Expresión]: fórmula que se introducirá. Es posible utilizar palabras clave o introducir todo o parte de valores fijos (texto codificado). Consulte el capítulo "Lista de palabras clave" para conocer la sintaxis que se aplicará en su caso de uso.

Ejemplo de la siguiente configuración:

Si el atributo groups contiene el valor GRP_ACCES_COMMUN, entonces se eliminará de la lista de valores groups y la lista modificada del atributo groups se copiará al atributo memberof@.

DELVALUEBYVALUE

Operación que permite eliminar valores de un atributo basado en una lista dada, por lo que generalmente se aplica a los atributos de varios valores.

Sintaxis de las funciones:

• [Descripción]: texto libre para describir la operación (opcional).
• [Atributo]: nombre del atributo que se quiere modificar.
• [Expresión]: Valores que se introducirán, separados por ;. Es posible utilizar palabras clave o introducir la totalidad o parte de valores fijos (texto codificado). Consulte el capítulo Lista de palabras clave para conocer la sintaxis que se aplicará en su caso de uso.

Ejemplo de la siguiente configuración:

Los valores del atributo groups_admin y el valor GRP_ACCES_COMMUN se suprimen de la lista de valores contenida en memberof@.

DSTCOPY

Operación que copia el valor de un atributo encontrado en la exportación de destino a otro atributo en el archivo DELTA. Funciona para atributos de un solo valor y de varios valores. Generalmente se utiliza para transferir valores del repositorio de destino que son desconocidos en el repositorio de origen, a menudo en el caso de eliminación (no conocido en la fuente pero aún presente en el destino).

Sintaxis de las funciones:

• [Descripción]: texto libre para describir la operación (opcional).
• [Atributo]: nombre del atributo de destino.
• [Nombre del atributo]: nombre del atributo de origen cuyo valor se copiará.

Ejemplo de la siguiente configuración:

EQ

Operación que compara dos atributos de un solo valor.

Sintaxis de las funciones:

• [Descripción]: texto libre para describir la operación (opcional).
• [Atributo]: nombre del atributo que se comparará, presente en la exportación de origen.
• [Expresión]: fórmula que se introducirá. Es posible utilizar palabras clave o introducir todo o parte de valores fijos (texto codificado). Consulte el capítulo "Lista de palabras clave" para conocer la sintaxis que se aplicará en su caso de uso.

Ejemplo de la siguiente configuración de la:

GETSTRUCTCHILD

Permite recuperar la lista de estructuras hijas en el atributo Destination_attribute_name de una estructura dada en Parent_structure_attribute_name. Esta operación sólo puede realizarse en datos del repositorio Identity (por ejemplo, en una exportación de identidades que tiene un atributo de tipo estructura).

Sintaxis de las funciones:

• [Descripción]: texto libre para describir la operación (opcional).
• [Atributo]: nombre del atributo de destino que recibirá la lista de estructuras hijas.
• [Expresión]: Nombre del atributo de la estructura madre sin palabras clave.

Ejemplo de la siguiente configuración:

Devuelve todas las estructuras hijas de la estructura con el código Sitio.

ISCONTAINED

Operación que compara un atributo de varios valores en la fuente autorizada con un atributo de varios valores en la fuente de destino para extraer sólo la lista de valores que están presentes en ambos atributos.

Ejemplo:

Se ha de indicar el nombre de la entidad que ha emitido el certificado de conformidad.

• Val_1
• Val_2
• Val_3
• Val_4

Se ha de indicar el número de la cuenta de la cuenta de la cuenta de la cuenta de la cuenta de la cuenta de la cuenta de la cuenta de la cuenta de la cuenta de la cuenta de la cuenta de la cuenta.

• Val_3
• Val_4
• Val_5

Resultado en el atributo de origen objetivo =

• Val_3
• Val_4

No se pueden utilizar palabras clave en esta operación.

Sintaxis de las funciones:

• [Descripción]: texto libre para describir la operación (opcional).
• [Atributo]: nombre del atributo presente en la fuente de destino en la que se va a realizar la comparación.
• [Nombre del atributo]: nombre del atributo presente en la fuente autorizada con el que se va a realizar la comparación.

Ejemplo de la siguiente configuración:

MERGE

Operación que permite crear una concatenación de valores a partir de un atributo de varios valores y asignarlo a un atributo de un solo valor.

Tenga en cuenta que esta operación sólo está disponible a partir de la versión 6.2.

Sintaxis de las funciones:

• [nombre_de_atributo_monovalor] = Nombre del atributo que se suministrará como salida.
• [Expresión] = [separador];[nombre_atributo_multivalores]
  • [separador]: El separador debe ser un solo carácter y no puede ser ";", ya que este carácter se utiliza en el archivo de configuración del conector.
  • [nombre_atributo_multivalores]: Nombre del atributo multivalor cuyos valores deben estar concatenados.

Modo de uso:

La operación MERGE puede utilizarse en reglas de sincronización y sólo en operaciones CONVERT.

Ejemplo de la siguiente configuración:

• Con el atributo "wiki_mod_1" igual a:
  • Droit_001
  • Droit_002
  • Droit_003
• Resultado: en el archivo sync.xml, el atributo "lst_right" tendrá el siguiente valor:
  • Droit_001#Droit_002#Droit_003

MODVALUE

Operación que permite modificar el valor de un atributo. El atributo debe existir y tener un solo valor. El valor inicial del atributo se sobrescribe y ya no se puede reutilizar.

Nota

Esta operación sustituye a la operación CHANGE, obsoleta a partir de la versión 7.1 y suprimida a partir de la versión 7.2.

Sintaxis de las funciones:

• [Descripción]: texto libre para describir la operación (opcional).
• [Atributo]: nombre del atributo a modificar, si no existe, la operación no funcionará.
• [Expresión]: fórmula que se introducirá. Es posible utilizar palabras clave o introducir todo o parte de valores fijos (texto codificado). Consulte el capítulo "Lista de palabras clave" para conocer la sintaxis que se aplicará en su caso de uso.

Ejemplo de la siguiente configuración:

MULTCOPY

Copiar atributos desde el origen

Operación que copia los valores de atributo de la exportación de origen a los atributos en el archivo DELTA. Funciona para atributos de valor único .

Sintaxis de las funciones:

• [Descripción]: texto libre para describir la operación (opcional).
• [Nombre del atributo a copiar]: Nombre del atributo que debe estar en la exportación de origen. El atributo debe existir.
• [Nombre del atributo objetivo]: El atributo debe existir. Nombre del atributo que debe incluirse en la exportación objetivo, que se ubicará en el archivo DELTA.

La operación debe realizarse tantas veces como sea necesario.

Ejemplo de la siguiente configuración:

MULTDSTCOPY

Operación que copia los valores de atributo encontrados en la exportación de destino a los atributos en el archivo DELTA. Funciona para atributos de valor único . Generalmente se utiliza para informar valores del repositorio de destino que son desconocidos en el repositorio de origen, a menudo en el caso de eliminación (ya no se conocen en el origen pero aún están presentes en el destino).

Sintaxis de las funciones:

• [Descripción]: texto libre para describir la operación (opcional).
• [Nombre del atributo a copiar]: Nombre del atributo que debe incluirse en la exportación de destino. El atributo debe existir.
• [Nombre del atributo objetivo]: Nombre del atributo de destino que debe encontrarse en el archivo DELTA.

La operación debe realizarse tantas veces como sea necesario.

Ejemplo de la siguiente configuración:

MULTIEVALEQ

Operación que compara varios atributos de varios valores.

Sintaxis de las funciones:

• [Descripción]: texto libre para describir la operación (opcional).
• [Nombre del atributo fuente]: nombre del atributo que se comparará, presente en la exportación fuente.
• [Nombre del atributo de destino]: nombre del atributo que se comparará, presente en la exportación de destino.

La operación debe realizarse tantas veces como sea necesario. Los objetos se emparejan si todos los atributos son iguales.

Ejemplo de la siguiente configuración:

MULTSET

Operación que permite hacer copias de atributos de varios valores con la opción de añadir un prefijo.

Sintaxis de las funciones:

• [Nombre_atributo_dest] = Nombre del atributo que se suministrará como salida. El atributo no necesita existir de antemano.
• [Nombre_atributo_src] = Nombre del atributo cuyos valores se copiarán. Atención, no utilice las palabras clave <syncattsrc> o <syncattdst>.
• [prefijo] = Cuerdas que se añade antes de cada valor del atributo [Nombre_atributo_src]. El prefijo puede ser el valor de un atributo usando la palabra clave >. Si no desea agregar un prefijo, entonces simplemente especifique <uid> en el segundo parámetro de la expresión esperada.

Modo de uso:

La operación MULTSET puede utilizarse en las reglas de sincronización para las operaciones CONVERT y MATCH (OnCreate, OnModify y OnDelete).

Ejemplo de la siguiente configuración:

• Con el atributo "código postal" igual a:
  • 68300
  • 68390
  • 38670
• Resultado: en el archivo sync.xml, el atributo "Code_postal_prefix" tendrá los siguientes valores:
  • CP_68300
  • CP_68390
  • CP_38670

MVEQ

Operación que compara 2 atributos de varios valores.

Sintaxis de las funciones:

• [Descripción]: texto libre para describir la operación (opcional).
• [Atributo]: nombre del atributo que se comparará, presente en la exportación objetivo.
• [Nombre del atributo]: nombre del atributo que se comparará, presente en la exportación de origen.

Ejemplo de la siguiente configuración:

RENAME

Operación que renombra un atributo.

Sintaxis de las funciones:

• [Descripción]: texto libre para describir la operación (opcional).
• [Atributo]: nuevo nombre del atributo.
• [Expresión]: nombre del atributo que se va a renombrar.

Ejemplo de la siguiente configuración:

SET

Operación que le permite asignar un valor a un atributo, solo de un valor, ya sea que exista o no.

Sintaxis de las funciones:

• [Descripción]: texto libre para describir la operación (opcional).
• [Atributo]: nombre del atributo al que se le asignará un valor. Si el atributo existe, se sobrescribirá el valor inicial; si el atributo no existe, se creará.
• [Expresión]: fórmula que se introducirá. Es posible utilizar palabras clave o introducir todo o parte de valores fijos (texto codificado). Consulte el capítulo "Lista de palabras clave" para conocer la sintaxis que se aplicará en su caso de uso.

Ejemplo de la siguiente configuración:

SIMPLEEQ

Operación que compara varios atributos de un solo valor.

Sintaxis de las funciones:

• [Descripción]: texto libre para describir la operación (opcional).
• [Nombre del atributo fuente]: nombre del atributo que se comparará, presente en la exportación fuente.
• [Nombre del atributo de destino]: nombre del atributo que se comparará, presente en la exportación de destino.

La operación debe realizarse tantas veces como sea necesario. Los objetos se emparejan si todos los atributos son iguales.

Ejemplo de la siguiente configuración:

SPLIT

Operación utilizada para crear una separación de valores de un atributo monovalente y un separador, y luego asignarlo a un atributo multivalente.

Tenga en cuenta que esta operación sólo está disponible a partir de la versión 6.2.

Sintaxis de las funciones:

• [nombre_de_atributo_multivalores] = Nombre del atributo que se suministrará como salida.
• [Expresión] = [separador];[nombre_atributo_monovalor]
  • [separador]: El separador debe ser un solo carácter y no puede ser ";", ya que este carácter se utiliza en el archivo de configuración del conector.
  • [nombre_atributo_multivalores]: Nombre del atributo multivalor cuyos valores deben estar concatenados.

Resultados posibles:

• Si el separador se encuentra al menos una vez: devuelve una lista de valores
• Si no se encuentra el separador: devuelve la cadena completa

Resultados posibles:

La operación SPLIT puede utilizarse en reglas de sincronización y sólo en operaciones CONVERT.

Ejemplo de la siguiente configuración:

• Con el atributo "string_rights" igual a:
  • Droit_001#Droit_002#Droit_003
• Resultado: en el archivo sync.xml, el atributo lst_right_multi tendrá el siguiente valor:
  • Droit_001
  • Droit_002
  • Droit_003