Macros

Les macros sont des chaînes spéciales dont les valeurs sont remplacées par une autre chaîne selon la fonction de cette macro. ADManager Plus prend en charge différents types de macros qui analysent les valeurs dynamiques chaque fois qu'elles sont utilisées lors de l'exécution.

Par exemple : Dans la macro %sAMAccountName%, les valeurs d'entrée seraient le nom de compte SAM des objets sur lesquels la macro est exécutée.

Syntaxe des macros

Lors de l'utilisation de macros dans ADManager Plus, il est essentiel de suivre la syntaxe décrite ci-dessous. Selon la catégorie ou le type de la macro, le préfixe variera.

• %<prefix>.<macroname>%
• %<prefix>.<macroname>(Arg1, Arg2, ...)%
• %<prefix>.<macroname>(#%<prefix>.<macroname>%#, Arg2, ...)%

Différents types de macros dans ADManager Plus

Comment utiliser les macros dans ADManager Plus ?

Cliquez sur l'icône du sélecteur de macro dans les modules listés ci-dessous qui prennent en charge les macros, et configurez-les selon vos besoins.

• Webhooks entrants
• Webhooks sortants
• Modèles de webhook
• Formats de mappage d'attributs
• Configuration de script personnalisé
• Modèle de notification

Macros imbriquées

Les macros imbriquées dans ADManager Plus permettent à une macro d'être intégrée ou appelée à l'intérieur d'une autre macro. Vous pouvez utiliser des macros imbriquées en entourant la macro interne avec #. Le variable d'environnement, macros de recherche et remplacement, encoder et macros de décodage de composant URI sont des exemples de macros imbriquées.

Exemple :

• %fx.findAndReplace(input:#%ad.OU_DN_NAME%#,find:test.com,replace:test123.com)%

Macros Active Directory

Les macros d'attributs Active Directory (AD) vous permettent d'obtenir les valeurs LDAP des objets utilisateur et groupe sur lesquels la macro est exécutée de manière dynamique. Par défaut, vingt attributs AD sont disponibles en tant que macros dans ADManager Plus. Si vous souhaitez ajouter des attributs personnalisés, configurez-les sous Admin > LDAP Attributes. Lors de l'ajout d'attributs personnalisés, assurez-vous qu'ils sont associés à la catégorie de rapport appropriée.

Macros Microsoft 365

Ces macros vous permettent d'obtenir les valeurs d'attributs Microsoft 365 des objets utilisateur et groupe sur lesquels la macro est exécutée de manière dynamique. Par défaut, 18 attributs Microsoft 365 sont disponibles en tant que macros dans ADManager Plus.

Détails de l'action

Macro d'horodatage

Les macros d'horodatage sont des espaces réservés ou des variables utilisés pour représenter des valeurs spécifiques de date et heure de manière dynamique. Pour utiliser cette macro, sélectionnez la Horodatage macro sous Détails de l'action et spécifiez le format de date et heure pour que les valeurs soient mises à jour en temps réel chaque fois que la macro est utilisée.

Par exemple,

Lors de l'automatisation des tâches d'intégration des utilisateurs, vous pouvez définir la date de début de création du compte utilisateur deux jours après la configuration de l'automatisation en utilisant la macro d'horodatage comme indiqué ci-dessous.

Syntaxe :

%act.timestamp_<dateformat>_<timeinterval type>_<timeinterval value>%

Exemple :

%act.timestamp_dd-MM-yyyy_afterNDays_2%

Variable d'environnement

Une variable d'environnement est une paire nom-valeur qui peut être utilisée comme macros pour les valeurs qui changent rarement, comme Authtoken, IDs, etc. Elles peuvent être utilisées à la place de l'URL, l'en-tête, le paramètre et le corps du message lors de la création d'un nouveau modèle webhook.

Syntaxe

%env.<Variable name>%

Exemple

%env.securedToken%

Fonctions personnalisées

Créez des fonctions personnalisées dont la valeur est récupérée à partir d'un script. La valeur résultante de l'exécution du script lors de l'analyse de la macro de variable sera utilisée comme valeur de la fonction personnalisée.

Syntaxe :

%fx.<Variable name>_<Argument 1>_...<Argument n>%

Exemple :

%fx.generateSecuredToken_#%act.timestamp_dd-MM-yyyy_current time%#_%admin%

Rechercher et remplacer

La macro de recherche et remplacement vous aide à rechercher une partie spécifique de la chaîne source et à la remplacer par une autre chaîne. Dans ADManager Plus, vous pouvez rechercher et remplacer des chaînes source et des macros. Pour utiliser ceci, dans la fenêtre contextuelle Sélectionner les macros, accédez à Functions > Find and Replace.

Syntaxe :

%fx.findAndReplace(input:<inputValue>,find:<findValue>,replace:<replaceValue>)%

Exemple :

%fx.findAndReplace(input:#%ad.OU_DN_NAME%#,find:test.com,replace:test123.com)%

La macro Encode URI fonctionne de manière similaire au composant réel

Javascript encodeURI. Par défaut, l'URL de l'API et les paramètres des modèles webhook seront codés avant l'exécution. Outre ceux-ci, si vous souhaitez coder d'autres valeurs, utilisez cette option. %fx.encodeURIComponent("<value>")%

Syntaxe :

%fx.encodeURIComponent("Ad secure pwd")%

Exemple :

L*urO@82#

Vous pouvez également stocker les informations sensibles dans une variable d'environnement et l'ajouter en tant que macro imbriquée dans la macro Encode URI. Décoder URI

La macro Decode URI fonctionne de manière similaire au composant réel

Javascript decodeURI . Si vous souhaitez décoder les valeurs d'attribut codées récupérées de l'application intégrée, saisissez la valeur dans lechamp. Décoder le composant URI Ad%20secure%20pwd

Récupérer les correspondances d'expression régulière

champ Retrieve Regex Match (Sélectionner field (Select Macros > Fonctions), fournissez le nom de la colonne et le modèle à rechercher et à faire correspondre. Une fois terminé, cliquez sur Ajouter.

De cette façon, lorsque les données sont extraites du point de terminaison, elles incluront uniquement le modèle de chaîne requis pour le traitement de l'API et rejetteront le reste dans la valeur d'attribut.

Utilitaire

Ajouter

Si vous souhaitez utiliser deux macros consécutives, utilisez :APPEND: entre elles lors de l'extraction des données des points de terminaison.

Syntaxe :

%<prefix>.<macroname>%:APPEND:%<prefix>.<macroname>%

Exemple :

%ad.givenName%:APPEND:%ad.department%