Descriptions détaillées des actions de l'auditeur ESM
Descriptions détaillées des actions de l'auditeur ESM
AlwaysFailDataCardAction
- Empêche la sauvegarde des données de la carte.
Classe
com.efecte.datamodel.entity.action.implementations.AlwaysFailDataCardAction
Éléments de configuration
| Nom | Requis | Description |
|---|---|---|
| Message d'erreur | Non | Un message d'erreur facultatif affiché pour l'utilisateur dans les fichiers journaux. La valeur peut être un texte de présentation à des fins de localisation. La valeur par défaut est « Erreur de validation » (text_validator_error). |
ChangeDataCardValuesAction
- Définit la valeur d'un attribut.
- Efface la valeur d'un attribut.
Classe
com.efecte.datamodel.entity.action.implementations.ChangeDataCardValuesAction
Éléments de configuration
| Nom | Requis | Description |
|---|---|---|
| Code | Oui | Code de l'attribut. |
| Valeur | Oui | Nouvelle valeur pour l'attribut. Étant donné que la valeur est donnée sous forme de texte, les types de données possibles sont limités ; par exemple, les références ne fonctionnent pas. Une valeur vide (<value></value>) signifie que la valeur de l'attribut est vidée. |
Copier les valeurs de la carte de donnéesAction
- Copie une valeur de la carte de données source vers la valeur d'un autre attribut ou vers une valeur d'un attribut dans la carte de données cible.
- Peut également copier des valeurs derrière des références.
- Si l'attribut copié est à valeurs multiples, les valeurs existantes seront REMPLACÉES.
- Les valeurs multiples fonctionnent uniquement sur la carte de données de l'hôte, pas derrière les références.
- Lors de la copie de valeurs vers un attribut cible à valeurs multiples, seule la première valeur est copiée si l'attribut cible est du type de données de référence et que l'attribut source ne l'est pas.
Classe
com.efecte.datamodel.entity.action.implementations.CopyDataCardValuesAction
Éléments de configuration
| Nom | Requis | Description |
|---|---|---|
| Code | Oui | Code de l'attribut à modifier. |
| Valeur | Oui | Code de l'attribut de la carte de données source d'où la valeur est copiée. Ou, en cas de copie depuis une référence : $source_data_card_reference_attribute_code:referred_data_card_attribute_code$ |
CopierSourceReferenceAction
- Crée une référence des cartes de données cibles vers la carte de données source.
Classe
com.efecte.datamodel.entity.action.implementations.CopySourceReferenceAction
Éléments de configuration
| Nom | Requis | Description |
|---|---|---|
| Code | Oui | Un code d'attribut de référence dans la carte de données cible. Cet attribut obtiendra une référence à la carte de données source. |
Créer une action de carte de données
- Crée une nouvelle carte de données, basée sur le modèle configuré et dans un dossier configuré.
- En option, ajoute des références entre le créateur et les cartes de données créées.
- Définit éventuellement toutes les valeurs d'attribut dans la carte créée.
- En tant que cas particulier, vous pouvez ajouter l'heure à laquelle l'édition dans l'interface utilisateur ESM a commencé (voir « :EDITING_START_TIME : » ci-dessous).
Classe
com.efecte.datamodel.entity.action.implementations.CreateDataCardAction
Éléments de configuration
| Nom | Requis | Description |
|---|---|---|
| Modèle | Oui | Code du modèle sur lequel sera basée la nouvelle carte de données. |
| Dossier | Oui | Code du dossier dans lequel la carte de données créée sera stockée. :SOURCE: utilisera le dossier du créateur. |
| Référence de la source | Non | Code d'attribut pour l'attribut de référence ou de référence arrière dans la carte de données du créateur qui obtiendra une référence à la carte de données nouvellement créée. |
| attribut_code_en_création | Non | Valeur spécifique au type de données à attribuer à l'attribut indiqué. Notez que cette valeur est soumise à des macros spécifiques au type de données, telles que les macros de date. |
| attribut_code_en_création | Non | :EDITING_START_TIME: place l'heure de début de modification dans un attribut date ou chaîne de la carte de données créée. Notez que l'heure de début de modification n'est disponible que si la modification ayant déclenché cette action a été effectuée via la vue d'édition de l'interface graphique ; cet élément de configuration doit donc être utilisé avec la condition source GuiEdit. |
| attribut_code_en_création | Non | :SOURCE: créera une référence au créateur dans un attribut de référence ou copiera le nom du créateur dans un attribut de chaîne. |
| attribut_code_en_création | Non | $reférence_path_to_creator_attribute$ copie la valeur de l'attribut indiqué du créateur dans l'attribut indiqué du créé. |
EntitéDataCardAction
- Déplace une carte de données vers la corbeille ou la restaure depuis la corbeille.
- Supprime définitivement une carte de données.
- Masque ou rend une carte de données visible.
Note:
Par exemple, le gestionnaire DatacardHiddenState peut entrer en conflit avec un écouteur contenant cette action. Si le modèle possède un gestionnaire DatacardHiddenState, l'implémentation de l'écouteur doit en tenir compte. Vérifiez l'ordre d'exécution des écouteurs et des gestionnaires.
Classe
com.efecte.datamodel.entity.action.implementations.EntityDataCardAction
Éléments de configuration
| Nom | Requis | Description |
|---|---|---|
| Action de l'entité | Oui | Action : « corbeille », « restaurer », « supprimer définitivement », « masquer », « rendre visible ». |
ExpressionAction
- Exécutera un script Python défini sur les cartes de données cibles.
Note:
Le nom de l'action est un peu trompeur, car il exécute des scripts et non des expressions (car les termes sont utilisés dans le contexte des gestionnaires de validateur et d'expression).
Classe
com.efecte.datamodel.entity.action.implementations.ExpressionAction
Éléments de configuration
| Nom | Requis | Description |
|---|---|---|
| Code | Oui | Code d'un attribut de la carte de données cible. Le résultat de l'expression sera défini sur cet attribut. |
| Expression | Oui | Le script Python à exécuter. |
DossierDataCardAction
- Déplace une carte de données vers un dossier spécifique.
Classe
com.efecte.datamodel.entity.action.implementations.FolderDataCardAction
Éléments de configuration
| Nom | Requis | Description |
|---|---|---|
| Dossier | Non | Code du dossier où la carte de données est déplacée, ou « : SOURCE : » si la carte de données est déplacée vers le même dossier où se trouvent les données sources. |
| Attribut de dossier | Non | Code d'attribut dont la valeur correspond au code du dossier où la carte de données est déplacée. Si un dossier est configuré, il sera utilisé à la place. |
| Dossier de secours | Non | Code du dossier dans lequel la carte de données est déplacée s'il n'y a pas de dossier disponible qui a été configuré avec un dossier ou un attribut Dossier . |
EnregistrerDataCardAction
- Crée une référence des cartes de données cibles vers la carte de données source.
- Cela permet de calculer de nouvelles valeurs pour les attributs contenant un gestionnaire (ExpressionHandler ou autre).
Classe
com.efecte.datamodel.entity.action.SaveDataCardAction
Éléments de configuration
| Nom | Requis | Description |
|---|---|---|
| - | - | - |
EnregistrerDataCardXmlToFileAction
- Enregistre la carte de données au format XML dans un fichier et un dossier spécifiés.
- Cette action fonctionne uniquement sur la carte de données source enregistrée.
- Si le fichier existe, il sera écrasé (le fichier est supprimé avant l'écriture du nouveau fichier).
- L'action essaie d'abord d'écrire le XML dans un fichier temporaire, puis renomme le fichier temporaire en fichier spécifié.
- Ceci a pour but d'empêcher quiconque de lire le fichier de résultat avant qu'il ne soit complètement écrit.
Classe
com.efecte.datamodel.entity.action.SaveDataCardXmlToFileAction
Éléments de configuration
| Nom | Requis | Description |
|---|---|---|
| Fichier cible | Oui | Nom du fichier (chemin) où le XML est enregistré. Peut contenir les macros suivantes : $now$, $TIMESTAMP$ et $ENTITY_ID$. Celles-ci contiennent respectivement la date du jour (au format aaaa-MM-jj), l'horodatage (temps écoulé en millisecondes depuis l'époque) et l'identifiant de la carte de données dans la base de données. |
EnvoyerDataCardXmlToWebService
- Envoie la carte de données au format XML au service Web SOAP configuré.
- Notez que cette action fonctionne uniquement sur la carte de données source qui est enregistrée.
Authentification de base préventive
Cette fonctionnalité permet des processus d’authentification plus efficaces en envoyant les informations d’identification de manière proactive, réduisant ainsi le nombre d’allers-retours requis pour l’authentification.
Comment activer :
- Globalement : définir le paramètre de plate-forme datacard.listeners.preemptive.authentication=true
- Par écouteur : dans la configuration de l'action, ajoutez « preemptiveAuthentication=true » à l'élément « connectionParameters »
Remarque : si cette option est activée globalement, vous pouvez la désactiver pour des actions spécifiques en définissant « preemptiveAuthentication=false » dans l'élément de configuration « connectionParameters » de l'action.
Classe
com.efecte.datamodel.entity.action.implementations.webservice.SendDataCardXmlToWebService
Éléments de configuration
| Nom | Requis | Description |
|---|---|---|
| adresse du point de terminaison | Oui | Adresse du point de terminaison définissant l'emplacement du service Web. Exemple : http://localhost:8080/axis2/services/EfecteNotifyService. Vous pouvez saisir directement l'utilisateur et le mot de passe dans l'URL si l'authentification HTTP BASIC est utilisée côté service Web. L'URL ressemblera alors à ceci : http://user:password@localhost:8080/axis2/services/EfecteNotifyService |
| ensemble d'entités espace de noms cible | Oui | Espace de noms cible pour l'élément entityset. Exemple : http://integration.efecte.com/notify/request |
| nom de l'opération | Oui | Opération : actuellement, seule la valeur peut être « Notifier ». |
| Exiger des données modifiées | Oui | Vrai ou Faux. Si la valeur est Vrai, le message est envoyé uniquement en cas de modification. Si la valeur est Faux, le message est systématiquement envoyé lors de l'enregistrement de la carte de données. Les conditions source peuvent toujours être utilisées pour définir le moment d'exécution de cette action. Par exemple, le message est envoyé uniquement lorsque la valeur d'un attribut a changé. |
| nom d'utilisateur | Non | Nom d'utilisateur pour l'authentification HTTP de base. S'il n'est pas spécifié, l'authentification de base n'est pas utilisée. |
| mot de passe | Non | Mot de passe pour l'authentification HTTP de base. S'il n'est pas fourni, l'authentification de base n'est pas utilisée. |
| utiliserChunkedTransferEncoding | Non | « Vrai » ou « Faux ». La valeur par défaut est « Vrai ». Si la valeur est « Faux », le codage de transfert fragmenté n'est pas utilisé. |
| paramètres de connexion | Définit les options de configuration de connexion. <élément_de_configuration> <name>Paramètres de connexion</name> <value>acceptSelfSignedCertificates=false,allowAllHostnamesInCertificate=true,connectionRequestTimeout=60,connectTimeout=60,socketTimeout=60</value> </configuration_item> Si l'authentification de base préventive n'est pas définie sur « true » dans le paramètre de la plateforme « datacard.listeners.preemptive.authentication » et que vous souhaitez l'activer pour cet écouteur, ajoutez ceci sous « connectionParameters » : preemptiveAuthentication=true |
EnvoyerDataCardXmlToHttpAction
- Envoie la carte de données sous forme de message XML à un service externe.
- Le message envoyé peut être transformé dans n’importe quel format souhaité à l’aide d’une transformation XSLT.
- Les messages sont envoyés vers une file d'attente, qui se charge de renvoyer le message si l'envoi échoue.
Authentification de base préventive
Cette fonctionnalité permet des processus d’authentification plus efficaces en envoyant les informations d’identification de manière proactive, réduisant ainsi le nombre d’allers-retours requis pour l’authentification.
Comment activer :
- Globalement : définir le paramètre de plate-forme datacard.listeners.preemptive.authentication=true
- Par écouteur : dans la configuration de l'action, ajoutez « preemptiveAuthentication=true » à l'élément « connectionParameters »
Remarque : si cette option est activée globalement, vous pouvez la désactiver pour des actions spécifiques en définissant « preemptiveAuthentication=false » dans l'élément de configuration « connectionParameters » de l'action.
Classe
com.efecte.datamodel.entity.action.implementations.http.SendDataCardXmlToHttpAction
Éléments de configuration
| Nom | Requis | Description |
|---|---|---|
| URL du point de terminaison | L'URL où le tiers fournit le service. Le port et le contexte du service doivent être combinés dans cette URL. | |
| méthode endpoint | Définit quel type de méthode sera utilisé pour contacter un tiers. (publier/supprimer). | |
| service de point de terminaison | Le service qui va être consommé est fourni par un tiers, c'est-à-dire ESSAnnouncement, Autre (= ESM). | |
| nom d'utilisateur | Nom d'utilisateur défini dans l'authentification BASIC par un tiers. | |
| mot de passe | Mot de passe défini dans l'authentification BASIC par un tiers. | |
| modèle de date et d'heure | Définit le modèle de format de date et d'heure qui sera utilisé dans le XML comme charge utile à envoyer. Exemple: <configuration_item> <name>datetimePattern</name> <value>aaaa-MM-jj'T'HH:mm:ssXXX</value> </configuration_item> |
|
| Code de réponse attenduMessage |
La combinaison du code de réponse et du message attendus. Exemple 1 : Les codes de réponse 200 et 404 sont tous deux acceptés. Pour le code 200, le message de réponse doit être vide ou nul. Pour le code 404, le message de réponse doit contenir « Impossible de supprimer une annonce inexistante ». |
|
| fichier de transformation xsl | Définit l'endroit où nous pourrions définir le fichier xsl dans le système de fichiers. <élément_de_configuration> <name>xslTransformFile</name> <value>/home/likewise-open/server777/ESSAnnouncement1.xsl</value> </configuration_item> |
|
| xsl |
Définit le code comme xsl intégré : <xsl:transform version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns="http://www.efecte.com/integration/update/xsd/1.0" > ]]> |
|
| Paramètres xsl | Définit plusieurs paramètres d'entrée pour la transformation par XSL. Exemple 1 : <élément_de_configuration> <name>Paramètres xsl</name> <value>ess_tenant=client</value> </configuration_item> Exemple 2 : <élément_de_configuration> <name>xslParameters</name> <value>ess_tenant=client, xxx=yyy</value> </configuration_item> |
|
| fichier xsdSchema | Définit le fichier xsd correspondant pour valider le contenu xml qui va être envoyé. <élément_de_configuration> <name>xsdSchemaFile</name> <value>/home/likewise-open/server777/update.xsd</value> </configuration_item> |
|
| paramètres de connexion | Définit les options de configuration de connexion. <élément_de_configuration> <name>Paramètres de connexion</name> <value>acceptSelfSignedCertificates=false,allowAllHostnamesInCertificate=true,connectionRequestTimeout=60,connectTimeout=60,socketTimeout=60</value> </configuration_item> Si l'authentification de base préventive n'est pas définie sur « true » dans le paramètre de la plateforme « datacard.listeners.preemptive.authentication » et que vous souhaitez l'activer pour cet écouteur, ajoutez ceci sous « connectionParameters » : preemptiveAuthentication=true |
|
| Encodage de sortie | Définit l'encodage pour la sortie XML. <élément_de_configuration> <name>outputEncoding</name> <value>UTF-8</value> </configuration_item> |
Envoyer un e-mail
- Envoie du courrier.
- REMARQUES :
- La suppression de la carte de données déclenche également des écouteurs, alors soyez prudent avec les conditions de la source.
- L'action n'empêche pas le stockage des données de la carte même si le courrier ne peut pas être envoyé pour une raison quelconque (mauvaise configuration, serveur de messagerie en panne, etc.).
- Si les écouteurs sont configurés pour être exécutés en tant qu'utilisateur non root, assurez-vous que l'utilisateur configuré peut accéder aux attributs requis.
- Les paramètres du serveur de messagerie sont définis dans les paramètres de la plateforme. Ils ne peuvent pas être modifiés dans la configuration de l'écouteur.
- Au moins un des éléments de configuration À, Cc ou Cci doit avoir une valeur.
Classe
com.efecte.datamodel.entity.action.implementations.SendMailAction
Éléments de configuration
| Nom | Requis | Description |
|---|---|---|
| Depuis | Oui | Adresse(s) de l'expéditeur. Peut inclure des références à des attributs au format $attribute_code$ ou $code_of_reference:attribute_code$. Séparez les adresses par une virgule ou un point-virgule. |
| À | Non | Adresse(s) du/des destinataire(s). Peut inclure des références à des attributs au format $attribute_code$ ou $code_of_reference:attribute_code$. Séparez les adresses par une virgule ou un point-virgule. |
| Cc | Non | Adresse(s) du/des destinataire(s) en copie carbone. Peut inclure des références à des attributs au format $attribute_code$ ou $code_of_reference:attribute_code$. Séparez les adresses par une virgule ou un point-virgule. |
| Cci | Non | Adresse(s) du/des destinataire(s) en copie carbone invisible. Peut inclure des références à des attributs au format $attribute_code$ ou $code_of_reference:attribute_code$. Séparez les adresses par une virgule ou un point-virgule. |
| Sujet | Non | Objet du message. Peut inclure des références à des attributs au format $attribute_code$ ou $code_of_reference:attribute_code$. Les valeurs multiples sont séparées par une virgule. |
| Message | Non | Texte du message. Le texte peut contenir des sauts de ligne. <![CDATA[]]> peut être utilisé si des caractères spéciaux sont nécessaires. Peut inclure des références à des attributs au format $attribute_code$ ou $code_of_reference:attribute_code$. Les valeurs multiples sont séparées par une virgule. |
| Type de contenu | Non | Type MIME du message. Par exemple, text/html. La valeur par défaut est text/html. Les valeurs possibles sont text/plain et text/html. |
| Envoyer une fois | Non | ID unique. Si l'option « Envoyer une fois » est activée, l'écouteur n'enverra qu'un seul e-mail par carte de données donnée. Si AutoMailSender est remplacé par un écouteur, utilisez l'ID de classe de l'attribut AutoMailSender comme valeur. Lorsque vous créez une nouvelle action SendMailAction sans configuration préalable d'AutoMailSender, utilisez l'ID unique de votre choix. Assurez-vous simplement qu'aucun autre écouteur n'utilise le même ID (sauf si vous souhaitez que deux ou plusieurs écouteurs utilisent le même ID). |
| Pièces jointes | Non | Nom(s) des fichiers du répertoire « uploads/sendmailaction ». Les fichiers doivent être ajoutés manuellement au serveur, car Efecte ne dispose pas d'interface graphique pour cela. Référence(s) aux attributs au format $attribute_code$ ou $code_of_reference:attribute_code$. Les attributs doivent être de type Référence externe. Séparez les fichiers par un point-virgule. |
EnvoyerSourceChangedJMSMessageAction
- L'action enverra un message JMS à la file d'attente lors de l'enregistrement de la carte de données. Le contenu du message correspond à l'intégralité de la carte de données au format Efecte XML.
Classe
com.efecte.datamodel.entity.action.implementations.SendSourceChangedJMSMessageAction
Éléments de configuration
| Nom | Requis | Description |
|---|---|---|
| URL | Oui | URL où le message est envoyé. |
| Sujet | Oui | Sujet de la file d'attente. |
| Utilisateur | Non | Compte utilisateur. |
| Mot de passe | Non | Mot de passe pour le compte utilisateur. |
| Exiger des données modifiées | Oui | Vrai ou Faux. Si la valeur est Vrai, le message est envoyé uniquement en cas de modification. Si la valeur est Faux, le message est systématiquement envoyé lors de l'enregistrement de la carte de données. Les conditions source peuvent toujours être utilisées pour définir le moment d'exécution de cette action. Par exemple, le message est envoyé uniquement lorsque la valeur d'un attribut a changé. |
| Encodage Xml | Non | Codage optionnel pour le XML. |
Action de mise à jour Sccm ciblée
- Déclenche une mise à jour SCCM ciblée.
- Cela doit être joint au modèle de logiciel administré et doit être déclenché lorsqu'un AS devient « surveillé » (généralement une partie de la configuration de base).
- L'action recherche tous les ordinateurs sur lesquels ce logiciel semble être installé (d'après le champ « Tous les logiciels installés »). Elle récupère ensuite les identifiants de ressources SCCM de ces ordinateurs, les met en file d'attente pour la mise à jour, puis demande à SccmIntegrationTask d'effectuer une exécution ciblée en utilisant uniquement les identifiants en file d'attente.
Note:
L'exécution de la tâche s'effectue en arrière-plan, ce qui évite tout retard important lors de l'enregistrement de la carte de données d'origine. L'exécution démarre après quelques minutes. Ainsi, si plusieurs cartes AS sont surveillées en peu de temps, tous les identifiants de ressources sont regroupés et mis à jour dans la même tâche SccmIntegrationTask.
Éléments de configuration
| Nom | Requis | Description |
|---|---|---|
| - | - | - |
TransformerDataCardAction
- L'action transforme la carte de données actuellement modifiée en une autre. Utilise les règles et le dossier cible définis dans les transformations.
- Une ActionChain peut contenir plusieurs actions TransformDataCard. La création de plusieurs cartes dans une ActionChain est également prise en charge.
Remarque : Titre
Vous devez vous assurer, avec les conditions source, que la transformation n'intervient que dans les situations souhaitées, par exemple lorsqu'un attribut obtient une valeur pour la première fois. Sinon, de nouvelles cartes de données risquent d'être créées chaque fois que la carte de données hôte est déplacée, copiée vers un autre dossier ou supprimée.
Éléments de configuration
| Nom | Requis | Description |
|---|---|---|
| Modèle de cible | Oui | Code du modèle cible. |