Aller au contenu

Liste des opérations disponibles par règles de synchronisations

Conversion Matching
rules 		Comparaison Création Modification Suppression
ADDVALUE X X X X
CHANGE X X X X
COMPAREATTNAME 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

Options disponibles pour chaque opération :

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** 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** X X X
SPLIT X X X X

** : Les filtres sont différents en fonction de la règle utilisant l'opération.

  • B64 : Permet de convertir la valeur de l’attribut au format Base 64.
  • CI : Insensible à la casse : la comparaison se fait sans regarder la casse.
  • DATE : Permet de convertir la valeur de l’attribut au format DATE.
  • DATE_FILETIME : Permet de convertir la valeur de l’attribut au format DATETIME.
  • DN : comparaison de DN.
  • PARTIAL : compare partiellement les données. Renvoie vrai si au moins une valeur est contenue dans l’attribut de comparaison.
  • PWD : Permet de chiffrer la donnée.
  • USEMAP : utilisation d’une map pour retrouver l’attribut, permet d’accélérer la comparaison.

ADDVALUE

Opération qui permet d’ajouter des valeurs à un attribut qui, par définition, peut être multivalué. Elle permet également la concaténation des valeurs de plusieurs attributs.

Syntaxe de la fonction :

  • [Description] : texte libre pour décrire l’opération (facultatif).
  • [Attribute] : nom de l’attribut à modifier. Si l’attribut n’existe pas, il sera automatiquement créé.
  • [Expression] : formule à saisir. Il est possible d’utiliser des mots-clés ou de saisir en tout ou partie des valeurs fixes (texte en dur). Se reporter au chapitre « Liste des mots-clés » pour connaître la syntaxe à appliquer dans votre cas d’usage.

Exemple de configuration suivante :

CHANGE

Opération qui permet de modifier une valeur d’attribut. L’attribut doit exister et être monovalué. La valeur initiale de l’attribut est écrasée et ne pourra plus être réutilisée.

Syntaxe de la fonction :

  • [Description] : texte libre pour décrire l’opération (facultatif).
  • [Attribute] : nom de l’attribut à modifier. Si l’attribut n’existe pas, l’opération ne fonctionnera pas.
  • [Expression] : formule à saisir. Il est possible d’utiliser des mots-clés ou de saisir en tout ou partie des valeurs fixes (texte en dur). Se reporter au chapitre « Liste des mots-clés » pour connaître la syntaxe à appliquer dans votre cas d’usage.

Exemple de configuration suivante :

COMPAREATTNAME

Opération qui permet de lister les attributs à ne pas comparer et de faire une comparaison de tous les autres attributs qui ont le même nom dans les 2 référentiels. Les noms d’attributs dans le référentiel source qui ne trouveraient pas son homonyme dans le référentiel cible seront ignorés et non comparés. Elle peut être utilisée en remplacement du mapping unitaire des attributs à comparer.

Attention, opération disponible qu’à partir de la version 6.2 et qui ne peut être utilisée que dans les règles de OnCompare dans une opération MATCH dans des connecteurs de remontée des états de provisioning (statuts).

Syntaxe de la fonction :

  • [Attribute] = Liste des attributs à ne pas comparer. Les attributs doivent être séparés par une virgule et sans espace.

Exemple de configuration suivante :

CONTAIN

Opération qui réalise une comparaison afin de vérifier que les valeurs de l’attribut de la source autoritaire soient bien présentes dans l’attribut de la source cible. Le résultat de l’opération sera la concaténation des valeurs de l’attribut de la source cible avec les valeurs de l’attribut de la source autoritaire qui n’ont pas été trouvées.

Exemple

Valeurs_attribut_source_autoritaire =

  • Val_1
  • Val_2
  • Val_3

Valeurs_attribut_source_cible =

  • Val_4
  • Val_5
  • Val_6

Résultat dans l’attribut de la source cible =

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

Aucun mot-clé ne peut être utilisé dans cette opération.

Syntaxe de la fonction :

  • [Description] : texte libre pour décrire l’opération (facultatif).
  • [Attribute] : nom de l’attribut présent dans la source cible sur lequel on souhaite porter la comparaison.
  • [Attribute Name] : nom de l’attribut présent dans la source autoritaire sur lequel on souhaite porter la comparaison.

Exemple de configuration suivante :

CONVERT

COPY

Opération qui permet de copier la valeur d’un attribut dans un autre attribut. Elle fonctionne pour des attributs monovalués et multivalués.

Syntaxe de la fonction :

  • [Description] : texte libre pour décrire l’opération (facultatif).
  • [Attribute] : nom de l’attribut à modifier. L’attribut doit exister.
  • [Attribute Name] : nom de l’attribut source dont la valeur va être copiée.

Exemple de configuration suivante :

L’attribut ‘nom_usage’ prendra la valeur de l’attribut ‘nom_naissance’.

DELETE

Opération qui permet de supprimer un attribut dans une source spécifiée (Export source, export cible ou DELTA)

Syntaxe de la fonction :

  • [Description] : texte libre pour décrire l’opération (facultatif).
  • [Attribute] : nom de l’attribut à supprimer.
  • [Expression] : ne pas remplir ce champ.

DELVALUE

Opération qui permet de supprimer des valeurs d’un attribut en fonction d’une expression booléenne : si l’expression renvoie « Vrai », alors les valeurs sont supprimées. Elle s’applique donc en générale sur des attributs multivalués.

Syntaxe de la fonction :

  • [Description] : texte libre pour décrire l’opération (facultatif).
  • [Attribute] : nom de l’attribut à modifier.
  • [Expression] : formule à saisir. Il est possible d’utiliser des mots-clés ou de saisir en tout ou partie des valeurs fixes (texte en dur). Se reporter au chapitre « Liste des mots-clés » pour connaître la syntaxe à appliquer dans votre cas d’usage.

Exemple de configuration suivante :

Si l’attribut « groupes » contient la valeur ‘GRP_ACCES_COMMUN’, alors elle sera supprimée de la liste des valeurs de « groupes » et la liste modifiées de l’attribut « groupes » sera copiée dans l’attribut « memberof@ ».

DELVALUEBYVALUE

Opération qui permet de supprimer des valeurs dans un attribut à partir d’une liste donnée. Elle s’applique donc en générale sur des attributs multivalués.

Syntaxe de la fonction :

  • [Description] : texte libre pour décrire l’opération (facultatif).
  • [Attribute] : nom de l’attribut à modifier.
  • [Expression] : Valeurs à renseigner, séparées par des « ; ». Il est possible d’utiliser des mots-clés ou de saisir en tout ou partie des valeurs fixes (texte en dur). Se reporter au chapitre « Liste des mots-clés » pour connaître la syntaxe à appliquer dans votre cas d’usage.

Exemple de configuration suivante :

Les valeurs de l’attribut «groupes_admin » et la valeur « GRP_ACCES_COMMUN » sont supprimées de la liste des valeurs contenues dans « memberof@ ».

DSTCOPY

Opération qui permet de copier la valeur d’un attribut se trouvant dans l’export cible dans un autre attribut à destination du fichier DELTA. Elle fonctionne pour des attributs monovalués et multivalués. Elle s’utilise généralement pour reporter des valeurs issues du référentiel cible non connue dans le référentiel source, soit souvent en cas de suppression (n’est pas connu dans la source mais toujours présent dans la cible).

Syntaxe de la fonction :

  • [Description] : texte libre pour décrire l’opération (facultatif).
  • [Attribute] : nom de l’attribut de destination.
  • [Attribute Name] : nom de l’attribut source dont la valeur va être copiée.

Exemple de configuration suivante :

EQ

Opération qui réalise une comparaison entre 2 attributs monovalués.

Syntaxe de la fonction :

  • [Description] : texte libre pour décrire l’opération (facultatif).
  • [Attribute] : nom de l’attribut à comparer, présent dans l’export source.
  • [Expression] : formule à saisir. Il est possible d’utiliser des mots-clés ou de saisir en tout ou partie des valeurs fixes (texte en dur). Se reporter au chapitre « Liste des mots-clés » pour connaître la syntaxe à appliquer dans votre cas d’usage.

Exemple de la configuration suivante :

GETSTRUCTCHILD

Permet de récupérer la liste des structures filles dans l’attribut « Nom_attribut_destination » d’une structure donnée dans « Nom_attribut_structure_mère ». Cette opération ne peut être réalisée que sur des données issues du référentiel Identity (exemple : sur un export des identités qui possède un attribut de type structure).

Syntaxe de la fonction :

  • [Description] : texte libre pour décrire l’opération (facultatif).
  • [Attribute] : nom de l’attribut de destination qui recevra la liste des structures filles.
  • [Expression] : Nom de l’attribut de la structure mère sans aucun mot-clé.

Exemple de configuration suivante :

Renvoie toutes les structures filles de la structure ayant pour code « Site ».

ISCONTAINED

Opération qui permet de comparer un attribut multivalué présent dans la source autoritaire avec un attribut multivalué présent dans la source cible afin d’extraire uniquement la liste des valeurs qui sont présentes dans 2 attributs comparés.

Exemple :

Valeurs_attribut_source_autoritaire =

  • Val_1
  • Val_2
  • Val_3
  • Val_4

Valeurs_attribut_source_cible =

  • Val_3
  • Val_4
  • Val_5

Résultat dans l’attribut de la source cible =

  • Val_3
  • Val_4

Aucun mot-clé ne peut être utilisé dans cette opération.

Syntaxe de la fonction :

  • [Description] : texte libre pour décrire l’opération (facultatif).
  • [Attribute] : nom de l’attribut présent dans la source cible sur lequel on souhaite porter la comparaison.
  • [Attribute Name] : nom de l’attribut présent dans la source autoritaire sur lequel on souhaite porter la comparaison.

Exemple de la configurationsuivante :

MERGE

Opération qui permet de créer une concaténation de valeurs à partir d’un attribut multivalué et de l’affecter à un attribut monovalué.

Attention, cette opération n'est disponible qu’à partir de la version 6.2.

Syntaxe de la fonction :

  • [name_out_attribute_monovalue] = Nom de l'attribut monovalué qui sera créé en sortie.
  • [Expression] = [separator];[name_attribute_multivalues]
    • [separator] : Le séparateur doit être composé d’un seul caractère et ne peut pas être « ; », ce caractère étant utilisé dans le fichier de configuration des connecteurs.
    • [name_attribute_multivalues] : Nom de l’attribut multivalué dont on souhaite concaténer les valeurs.

Mode d'utilisation :

L'opération MERGE peut être utilisée dans les règles de synchronisation et uniquement dans les opérations de type CONVERT.

Exemple de configuration suivante :

  • Avec l'attribut "wiki_mod_1" égal à :
    • Droit_001
    • Droit_002
    • Droit_003
  • Résultat : dans le fichier sync.xml, l'attribut "lst_droit" aura comme valeur :
    • Droit_001#Droit_002#Droit_003

MODVALUE

Opération qui permet de modifier une valeur d’attribut. L’attribut doit exister et être monovalué. La valeur initiale de l’attribut est écrasée et ne pourra plus être réutilisée.

Syntaxe de la fonction :

  • [Description] : texte libre pour décrire l’opération (facultatif).
  • [Attribute] : nom de l’attribut à modifier. Si l’attribut n’existe pas, l’opération ne fonctionnera pas.
  • [Expression] : formule à saisir. Il est possible d’utiliser des mots-clés ou de saisir en tout ou partie des valeurs fixes (texte en dur). Se reporter au chapitre « Liste des mots-clés » pour connaître la syntaxe à appliquer dans votre cas d’usage.

Exemple de configuration suivante :

MULTCOPY

Copie les attributs depuis la source

Opération qui permet de copier des valeurs d’attributs se trouvant dans l’export source dans des attributs à destination du fichier DELTA. Elle fonctionne pour des attributs monovalués .

Syntaxe de la fonction :

  • [Description] : texte libre pour décrire l’opération (facultatif).
  • [Nom attribut à copier] : Nom de l’attribut qui doit se trouver dans l’export source. L’attribut doit exister.
  • [Nom attribut cible] : L’attribut doit exister. Nom de l’attribut qui doit se trouver dans l’export cible qui doit se trouvera dans le fichier DELTA.

L’opération est à réaliser autant de fois que nécessaire.

Exemple de configuration suivante :

MULTDSTCOPY

Opération qui permet de copier des valeurs d’attributs se trouvant dans l’export cible dans des attributs à destination du fichier DELTA. Elle fonctionne pour des attributs monovalués . Elle s’utilise généralement pour reporter des valeurs issues du référentiel cible non connue dans le référentiel source, soit souvent en cas de suppression (n’est plus connu dans la source mais toujours présent dans la cible).

Syntaxe de la fonction :

  • [Description] : texte libre pour décrire l’opération (facultatif).
  • [Nom attribut à copier] : Nom de l’attribut qui doit se trouver dans l’export cible. L’attribut doit exister.
  • [Nom attribut cible] : Nom de l’attribut de destination qui doit se trouvera dans le fichier DELTA.

L’opération est à réaliser autant de fois que nécessaire.

Exemple de configuration suivante :

MULTIEVALEQ

Opération qui réalise une comparaison entre plusieurs attributs multivalués.

Syntaxe de la fonction :

  • [Description] : texte libre pour décrire l’opération (facultatif).
  • [Nom attribut source] : nom de l’attribut à comparer, présent dans l’export source.
  • [Nom attribut destination] : nom de l’attribut à comparer, présent dans l’export destination.

L’opération est à réaliser autant de fois que nécessaire. Les objets sont appairés si l’ensemble des attributs sont égaux.

Exemple de configuration suivante :

MULTSET

Opération qui permet de réaliser des copies d'attributs multivalués avec la possibilité d’ajouter un préfixe.

Syntaxe de la fonction :

  • [Nom_attribut_dest] = Nom de l'attribut qui sera alimenté en sortie. L'attribut n'est pas obligatoirement existant au préalable.
  • [Nom_attribut_src] = Nom de l'attribut dont les valeurs vont être copiées. Attention, ne pas utiliser les mot-clés <syncattsrc> ou <syncattdst>.
  • [prefixe] = Chaîne de caractère à ajouter devant chaque valeur de l'attribut [Nom_attribut_src]. Le préfixe peut être la valeur d'un attribut en utilisant le mot clé <syncattsrc:<uid>>. Si on ne souhaite pas ajouter de préfixe, alors il faut juste indiquer <uid> dans le second paramètre de l'expression attendue.

Mode d'utilisation :

L'opération MULTSET peut être utilisée dans les règles de synchronisation dans les opérations de type CONVERT ou MATCH (OnCreate, OnModify et OnDelete).

Exemple de configuration suivante :

  • Avec l'attribut "code_postal" égal à :
    • 68300
    • 68390
    • 38670
  • Résultat : dans le fichier sync.xml, l'attribut "Code_postal_prefixe" aura comme valeurs :
    • CP_68300
    • CP_68390
    • CP_38670

MVEQ

Opération qui réalise une comparaison entre 2 attributs multivalués.

Syntaxe de la fonction :

  • [Description] : texte libre pour décrire l’opération (facultatif).
  • [Attribute] : nom de l’attribut à comparer, présent dans l’export cible.
  • [Attribute Name] : nom de l’attribut à comparer, présent dans l’export source.

Exemple de configuration suivante :

RENAME

Opération qui renomme un attribut.

Syntaxe de la fonction :

  • [Description] : texte libre pour décrire l’opération (facultatif).
  • [Attribute] : nouveau nom de l’attribut.
  • [Expression] : nom de l’attribut qui doit être renommé

Exemple de configuration suivante :

SET

Opération qui permet d’affecter une valeur à un attribut, monovalué uniquement, existant ou non.

Syntaxe de la fonction :

  • [Description] : texte libre pour décrire l’opération (facultatif).
  • [Attribute] : nom de l’attribut à valoriser. Si l’attribut existe, la valeur initiale sera écrasée, si l’attribut n’existe pas, il sera créé.
  • [Expression] : formule à saisir. Il est possible d’utiliser des mots-clés ou de saisir en tout ou partie des valeurs fixes (texte en dur). Se reporter au chapitre « Liste des mots-clés » pour connaître la syntaxe à appliquer dans votre cas d’usage.

Exemple de configuration suivante :

SIMPLEEQ

Opération qui réalise une comparaison entre plusieurs attributs monovalués.

Syntaxe de la fonction :

  • [Description] : texte libre pour décrire l’opération (facultatif).
  • [Nom attribut source] : nom de l’attribut à comparer, présent dans l’export source.
  • [Nom attribut destination] : nom de l’attribut à comparer, présent dans l’export destination.

L’opération est à réaliser autant de fois que nécessaire. Les objets sont appairés si l’ensemble des attributs sont égaux.

Exemple de configuration suivante :

SPLIT

Opération qui permet de créer une séparation de valeurs à partir d’un attribut monovalué et d’un séparateur puis de l’affecter à un attribut multivalué.

Attention, cette opération n'est disponible qu’à partir de la version 6.2.

Syntaxe de la fonction :

  • [name_out_attribute_multivalues] = Nom de l'attribut multivalué qui sera créé en sortie.
  • [Expression] = [separator];[name_attribute_monovalue]
    • [separator] : Le séparateur doit être composé d’un seul caractère et ne peut pas être « ; », ce caractère étant utilisé dans le fichier de configuration des connecteurs.
    • [name_attribute_multivalues] : Nom de l’attribut multivalué dont on souhaite concaténer les valeurs.

Résultats possibles :

  • Si le séparateur est trouvé au moins une fois : renvoie une liste de valeurs
  • Si le séparateur n’est pas trouvé : renvoie la chaîne complète

Résultats possibles :

L'opération SPLIT peut être utilisée dans les règles de synchronisation et uniquement dans les opérations de type CONVERT.

Exemple de configuration suivante :

  • Avec l'attribut "chaine_droits" égal à :
    • Droit_001#Droit_002#Droit_003
  • Résultat : dans le fichier sync.xml, l'attribut " lst_droit_multi" aura comme valeur :
    • Droit_001
    • Droit_002
    • Droit_003