Convertisseur (TCP/IP)
La construction du convertisseur TCP/IP vous permet d’étendre le schéma de communications bidi avec des requêtes qui récupèrent des données à partir d’un objet MIB (SNMP Management Information Base) particulier, puis de convertir les données en une valeur de chaîne basée sur une liste de paires valeur spécifiées dans les éléments conversion. La construction Converter est définie dans Tcpbidi.xsd.
| Attribut | Description |
|---|---|
| deviceIndex | (Facultatif) Valeur booléenne qui, si elle est TRUE, signifie que l’algorithme associé doit inclure l’index de périphérique dans l’OID spécifié ; lorsque cet attribut FALSE, un zéro de fin est ajouté à l’OID. La valeur par défaut est FALSE. Pour plus d’informations, consultez la remarque sous ce tableau. |
| drvPrinterEvent | (Facultatif) Valeur booléenne qui indique si le moniteur de port envoie des notifications au pilote. Une valeur TRUE indique que le moniteur de port envoie des notifications au pilote ; FALSE indique que le moniteur de port n’envoie pas de notifications au pilote. |
| name | Valeur de chaîne qui représente le nom de l’élément de schéma. |
| Oid | Valeur de chaîne qui représente l’adresse de l’objet MIB, sous la forme d’un ID d’objet (OID). |
| refreshInterval | (Facultatif) Valeur entière de l’intervalle d’interrogation, en secondes. La valeur par défaut est 600 secondes. |
| useFirstIndex | (Facultatif) Valeur booléenne qui peut être définie pour lire la première entrée d’une table MIB. Cet attribut est utilisé uniquement lorsque la construction Du convertisseur se trouve dans un instance Property. |
Notes
Un périphérique réseau qui prend en charge le protocole SNMP peut être l’hôte de différents sous-appareils, tels que Processeur, Réseau, Imprimante et Stockage sur disque. Les tables MIB implémentées dans les imprimantes réseau ont des entrées indexées par index d’appareil. Pour récupérer des données de la table MIB (par exemple, le nom d’un bac d’entrée), la requête doit avoir un index d’appareil qui identifie correctement le sous-appareil. Le moniteur de port TCP/IP standard permet de configurer manuellement l’index de l’appareil via l’interface utilisateur de configuration de port. Une extension bidi avec l’attribut deviceIndex défini sur TRUE génère un OID avec l’index d’appareil approprié obtenu à partir de l’interface utilisateur de configuration de port. En outre, si la construction Converter est contenue dans un instance Property et que l’attribut deviceIndex est manquant ou défini sur FALSE, l’OID aura un index zéro ajouté à sa fin.
Les types de données MIB suivants sont pris en charge par les routines de conversion :
ENTIER
Integer32
Gauge32
Counter32
TimeTicks
Unsigned32
Counter64
Opaque
CHAÎNE D’OCTETS
IDENTIFICATEUR D'OBJET
Conversion, élément
Chaque construction du convertisseur inclut un ou plusieurs éléments Conversion pour définir le mappage des valeurs lues à partir des éléments MIB dans des valeurs de schéma Bidi.
| Attribut | Description |
|---|---|
| mibValue | (Facultatif) Valeur de chaîne qui représente une valeur de données possible pouvant être lue à partir de la MIB. |
| bidiValue | (Facultatif) Valeur de chaîne qui représente la valeur bidi retournée si les données correspondent à l’attribut mibValue pour cet élément Conversion. |
Exemple de code
L’exemple de code suivant étend le schéma de communications bidi en ajoutant de nouvelles propriétés et des constructions de convertisseur.
<Property name="Printer">
<Property name="Layout">
<Property name="InputBins">
<IndexedProperty name="Bin">
<Converter name="BinType" oid="1.3.6.1.2.1.43.8.2.1.2" deviceIndex="true">
<Conversion mibValue="2" bidiValue="Unknown"/>
<Conversion mibValue="3" bidiValue="SheetFeedAutoRemovableTray"/>
<Conversion mibValue="4" bidiValue="SheetFeedAutoNonRemovableTray"/>
<Conversion mibValue="5" bidiValue="SheetFeedManual"/>
<Conversion mibValue="6" bidiValue="ContinuousRoll"/>
<Conversion mibValue="7" bidiValue="ContinuousFanFold"/>
</Converter>
</IndexedProperty>
</Property>
<Property name="Orientation">
<Converter name="CurrentValue" oid="1.3.6.1.2.1.43.15.1.1.7" deviceIndex="true" useFirstIndex="true">
<Conversion mibValue="3" bidiValue="Portrait"/>
<Conversion mibValue="4" bidiValue="Landscape"/>
</Converter>
</Property>
</Property>
<Property name="Custom">
<Property name="HostResourceMIB">
<Converter name="InterfaceName" oid="1.3.6.1.2.1.2.1">
<Conversion mibValue="1" bidiValue="InterfaceOne"/>
<Conversion mibValue="2" bidiValue="InterfaceTwo"/>
</Converter>
</Property>
</Property
</Property>
L’exemple précédent génère les requêtes suivantes.
\Printer.Layout.InputBins.Bin###:BinType
\Printer.Layout.Orientation:CurrentValue
\Printer.Custom.HostResourceMIB:InterfaceName
La construction Converter pour BinType est contenue dans un instance IndexedProperty et, par conséquent, l’entrée de ligne de la table MIB actuelle est automatiquement ajoutée à l’OID.
Étant donné que la construction du convertisseur pour CurrentValue est contenue dans un instance Property et que l’attribut useFirstIndex est défini sur « true », un « 1 » de fin est automatiquement ajouté à l’OID.
La construction convertisseur pour InterfaceName est contenue dans un property instance, de sorte qu’un zéro de fin est automatiquement ajouté à l’OID.