Extraction de données d'actifs › Méthode d'extraction des données d'actifs › Structure de mappage d'actifs

Structure de mappage d'actifs

Le code d'exemple XML suivant fournit un exemple de représentation standard d'une structure de mappage d'actifs :

<?xml version="1.0" encoding="UTF-8"?>
<asset-converter>

<datasource type="">

<connection-properties>
</connection-properties>

</datasource>

<!-- Specifies the parameters for processing -->

<processing-info>

<max-assets-to-process value=""/>

</processing-info>

<!-- Specifies the output settings -->

<output-settings>

<dest-dir value=""/>
<output-filename value=""/> 

</output-settings>
CA MDB

<mdb-type>10</mdb-type>
<mdb-connection-properties>
</mdb-connection-properties>

</mdb>

<!-- data mapping -->

<asset translator="ACBsFmt" version="1_0">

<general >
	<host_name  value=""/>
	<default_hostname  value=""/>
	<default_address value=""/>
	<default_mac value=""/>
</general>
<hardware>
	<group name="GeneralInventory">
		<attribute name="" value=""/>
	<group name="">
	</group>
	.
	.
	.
	</group>
	<group name="AdditionalInventory">
             <attribute name="" value=""/>
	.
	.
	.
	<group name="">
	</group>
	.
	.
	.
	</group>	      	
</hardware>
<software>
	<package name="" >
		<attribute name="" value=""/>
	.
	.
	.
</software>

</asset>

</asset-converter>

Balise <asset>

La balise d'actif contient les balises suivantes :

• general
• hardware
• software

Balise <general>

La balise générale contient les balises suivantes qui permettent de fournir des informations générales sur les actifs :

Important : Les 4 premières balises (host_name, default_mac, default_hostname et default_address) sont requises pour que CA Asset Converter charge les fichiers XML correctement. Les attributs obligatoires ne peuvent pas contenir de valeurs codées en dur.

• host_name
• default_mac
• default_hostname
• default_address
• vendor
• serial_number
• asset_tag
• host_key
• class_id
• default_subnet_mask
• collect_time
• trustlevel
• origin

Remarque : Tous les fichiers XML que vous créez, ainsi que les codes des exemples XML utilisés dans ce manuel, doivent être correctement formés et être conformes aux normes XML et XSD.

Exemple : Balise générale (base de données)

Le code d'exemple XML suivant illustre l'utilisation de la balise générale pour une base de données.

<asset query="select AssetID from Computer" translator="ACBsFmt" version="1_0">

<general query="select c.hostname,c.IPAddress, c.MAC_Address from Computer c where c.AssetID = {asset.AssetID}">

<host_name  value="{asset:general.hostname}"/>
<default_hostname value="{asset:general.hostname}"/>
<default_address value="{asset:general.IPAddress}"/>
<default_mac value="{asset:general.MAC_Address}"/>
</general>

       ...
</asset>

Exemple : Balise générale (fichier plat)

Le code d'exemple XML suivant illustre l'utilisation de la balise générale pour un fichier plat.

<asset file="main" translator="ACBsFmt" version="1_0">

<general file="main">

<host_name value="[4]"/> (Remarque : La valeur 4 indique qu'il existe un mappage vers la quatrième colonne dans le fichier principal.)
<default_hostname value="[4]"/>
<default_address value="[3]"/>
<default_mac value="[2]"/>

</general>
      ...

</asset>

Balise <hardware>

La balise de matériel contient les groupes suivants :

• GeneralInventory (obligatoire) : ce groupe peut contenir plusieurs balises <attribute> suivies par des balises [set the product group or family]. Les balises [set the product group or family] contiennent des informations sur chaque composant matériel de l'actif.
• AdditionalInventory (facultatif) : vous pouvez spécifier des attributs ou des groupes supplémentaires pour l'actif.

Exemple : Balise de matériel (base de données)

Le code d'exemple XML suivant illustre l'utilisation de la balise de matériel pour une base de données.

<asset query="select AssetID from Computer" translator="ACBsFmt" version="1_0">

<general>
...
</general>
<hardware>

<group name="GeneralInventory">
<group name="System" query="select p.ProcCount from Computer c where c.AssetID = {asset.AssetID}">
<attribute name="No. of Processors" type="string" value="{group(name='System').ProcCount}"/>
</group>
</group>

</hardware>
...

</asset>

Exemple : Balise de matériel (fichier plat)

Le code d'exemple XML suivant illustre l'utilisation de la balise de matériel pour un fichier plat.

<hardware>

<group name="GeneralInventory" file="">
<group name="System" file="system">

<attribute name="Model" type="string" value="[2]"/>
<attribute name="Type" type="string" value="[3]"/>
<attribute name="Vendor" type="string" value="[4]"/>

</group>
<group name="Network" file="main">

<attribute name="Computer Name" type="string" value="[4]"/>
<attribute name="IP Address" type="string" value="[3]">

</group>
...

</hardware>

Exemple : Balise d'inventaire supplémentaire

Le code d'exemple XML suivant illustre l'utilisation de la balise d'inventaire supplémentaire.

<asset>
...
<hardware>

<group name="GeneralInventory">
...
</group>
<group name="AdditionalInventory">

<attribute name="SourceVendor" value="ThirdPartyTool"/>

</group>

</hardware>
</asset>

Balise <software>

La balise de logiciel contient des informations sur les packages logiciels installés sur l'actif.

Exemple : Balise de logiciel (base de données)

Le code d'exemple XML suivant illustre l'utilisation de la balise de logiciel pour une base de données.

<asset query="select AssetID from Computer" translator="ACBsFmt" version="1_0">
...
<hardware>

<group name="GeneralInventory">
...
</group>

<group name="AdditionalInventory">
...
</group>

</hardware>
<software>

<package name="{asset:software:package.title}" query="select title,version,vendor from softwareTable where AssetID={asset.AssetID}">

<attribute name="Ver" type="string" value="{asset:software:package.version}"/>
<attribute name="Pub" type="string" value="{asset:software:package.vendor}"/>

</package>
</software>

</asset>

Exemple : Balise de logiciel (fichier plat)

Le code d'exemple XML suivant illustre l'utilisation de la balise de logiciel pour un fichier plat.

<software>

<package name="Advanced Network Diagramming" file="system">

<attribute name="Ver" type="string" value=[1]/>
<attribute name="Pub" type="string" value=[2]/>
...

</package>

</software>