Configuration de Gestion des actifs › Signatures logicielles personnalisées › Extensions dmscript

Extensions dmscript

Création de définitions de logiciels et d'enregistrements de détection

Lorsque vous créez des scripts personnalisés de signatures intelligentes, appelez les fonctions dmscript dans votre script de signatures intelligentes de manière à signaler les enregistrements de logiciels qui sont détectés sur l'ordinateur de l'agent. dmscript fournit des fonctions intégrées qui écrivent les enregistrements de logiciels détectés dans un fichier de sortie.

Remarque : dmscript est un langage de script qui fournit un moyen commun d'exécuter des commandes sur des agents. Pour plus d'informations sur dmscript, reportez-vous au Manuel du langage de script Desktop Management dans la bibliothèque CA IT Client Manager.

Le script de signatures intelligentes doit appeler les fonctions dans l'ordre suivant :

1. OpenDetectedSoftwareOutputFiles
2. CreateDetectedSoftwareProduct
3. CreateDetectedSoftwareRelease
4. CreateDetectedSoftwarePatch
5. CreateDetectedSoftwareReleaseInstance
6. CloseDetectedSoftwareOutputFiles

Pour plus d'informations sur les fonctions de scripts de signatures intelligentes, consultez le Manuel du langage de script Desktop Management.

Hiérarchie des objets Script de signatures intelligentes

Il importe de comprendre la hiérarchie des objets Script de signatures intelligentes lorsque vous créez des scripts personnalisés de signatures intelligentes. Les objets doivent exister dans une hiérarchie particulière. Chaque objet a un parent, qui doit être créé au préalable. La hiérarchie est organisée de la façon suivante :

• Un script de signatures intelligentes contient des informations pour détecter un nombre de produits.
• Un produit, par exemple Microsoft Office, a plusieurs versions finales comme Office 2003, Office 2010, etc.
• Une version finale a un certain nombre de patchs qui contiennent des correctifs.
• Un ordinateur a un nombre d'instances installées d'une version finale ou d'un patch.
• Les produits, versions finales et patchs sont créés à mesure que les définitions de logiciels et les instances sont créées en tant que logiciels détectés.
• Lorsqu'un objet est créé, dmscript vérifie la disponibilité de l'objet parent. Par exemple, si une version finale est créée, dmscript vérifie si le produit parent existe. Ce contrôle contribue à garantir l'établissement de relations appropriées entre le produit, la version finale, le patch et les instances associés.

Paramètres fixes et variables

Les fonctions de création des fichiers de sortie des logiciels détectés fournissent des possibilités d'extensions futures en acceptant des paramètres fixes et des paramètres variables. Alors que les paramètres fixes sont obligatoires, les paramètres variables sont facultatifs. Les paramètres variables incluent généralement les propriétés qui sont associées au script de signatures intelligentes et offrent un moyen d'ajouter des propriétés supplémentaires. Vous pouvez développer les fonctions à l'avenir pour ajouter des paramètres variables sans affecter les scripts existants.

Lors de la spécification et de l'utilisation de paramètres fixes et variables, tenez compte des directives suivantes :

• Les paramètres fixes sont obligatoires et requièrent des valeurs explicitement.
• Les paramètres variables sont facultatifs et spécifiés dans le paramètre OptionalProperties. Celui-ci correspond à une chaîne et peut contenir autant de paires nom-valeur de propriété que souhaité, formulées selon le format suivant :

  propriété=valeur | propriété=valeur |...
  

• Utilisez le caractère | pour séparer les paires nom-valeur de propriété. Les espaces avant et après le caractère | ne sont pas significatifs.
• Si le paramètre OptionalProperties contient des propriétés inconnues, cela génère des avertissements, mais n'arrête pas le script. Ce comportement permet aux agents de différentes versions finales de traiter les scripts de signatures intelligentes provenant du gestionnaire de domaines. Si un script utilise une propriété qui est inconnue d'une version particulière de dmscript, la propriété est ignorée, mais un avertissement est écrit dans le journal de suivi dmscript.
• Les valeurs inconnues dans les paramètres facultatifs génèrent un avertissement, mais sont transmises au moteur afin d'être interprétées ou ignorées. Par exemple, la valeur du paramètre bitness peut uniquement être 32 ou 64, mais si vous transférez la valeur 16, le script n'échoue pas.

Architectures prises en charge

Vous trouverez ci-après la liste des noms d'architecture que vous pouvez transférer aux fonctions DMscript qui écrivent les enregistrements détectés dans le fichier de sortie de détection des logiciels :

• AMD64
• ARM
• Alpha
• Big Endian MIPS
• HP Precision
• IA64
• IBM S/390
• Little Endian MIPS
• Motorola 680x0
• PA_RISC
• PC Power
• SPARC
• s390x
• x64
• x86

Codes d'erreur et propriétés facultatives

La méthode LogDetectedSoftwareError accepte les messages d'erreur dans un format spécifique. Les messages d'erreur sont des chaînes localisables qui sont générées en cas d'erreur d'exécution du script de signatures intelligentes au niveau de l'agent. Les messages d'erreur sont alors envoyés au gestionnaire de domaines et affichés comme commentaire de statut en regard de la tâche de collecte de l'inventaire des logiciels dans l'explorateur DSM.

Exemple : LogDetectedSoftwareError

LogDetectedSoftwareError("ISE:00400","PARAM5=Microsoft Windows 7 Edition Intégrale x64 64 fr-fr|PARAM6=VersionNumber=6.1.7600 |VersionLabel=6.1.7600 |Language=fr-fr |Bitness=64 |Architecture=x64 |Manufacturer=Microsoft Corporation|Category=Systèmes d'exploitation |Description=Produit Microsoft Windows 7|PARAM7=SWDETECT_BADARGS");

L'analyseur de scripts de signatures intelligentes génère automatiquement les messages d'erreur suivants pour signaler les problèmes liés au lancement d'un script de signatures intelligentes :

Vous pouvez générer les messages d'erreur suivants pour gérer des problèmes liés à la création d'un script de signatures intelligentes :