Partager via


Propriétés indexées TCP/IP et index d’appareil

Une propriété indexée permet d’ajouter un index numérique à un nom de propriété de schéma, ce qui permet à plusieurs propriétés associées de partager le même nom, mais chacune ayant un index numérique pour identifier la propriété individuelle. Une valeur d’index doit être un entier positif, mais il n’existe aucune limite supérieure sur sa taille. La requête de schéma détermine la valeur d’index qui doit être associée à un élément particulier. Ce mécanisme vous permet d’accéder aux données dans les tables MIB.

La construction IndexedProperty définit une propriété indexée. Les restrictions suivantes s’appliquent à cette construction.

  • Une construction IndexedProperty ne peut pas être le parent d’une construction Property. Une construction NonIndexedProperty est une construction qui définit une propriété sans index sous une construction IndexedProperty.

  • Ni une construction IndexedProperty ni une construction NonIndexedProperty ne peuvent être le parent d’une construction Installée.

Une requête peut également impliquer un autre index : un index d’appareil. Un périphérique réseau qui prend en charge SNMP peut être l’hôte de divers sous-appareils, y compris les imprimantes. Les tables MIB dans les imprimantes réseau ont des entrées indexées en fonction du type d’appareil (un index d’appareil). Pour qu’une requête récupère des données de la table MIB, la requête doit avoir l’index d’appareil approprié. Le moniteur de port TCP/IP standard permet de configurer l’index de l’appareil par l’interface utilisateur de configuration de port. Une extension bidi dans laquelle deviceIndex est défini sur TRUE (voir les constructions Value et Installed ) entraîne la génération d’un OID avec l’index de l’appareil concaténé à l’OID d’origine. L’index d’une propriété indexée est concaténé à l’OID suivant l’index de l’appareil, s’il est utilisé.

Exemple de code

L’exemple de code suivant étend le schéma de communications bidi TCP/IP en ajoutant une propriété Display à la propriété Printer . En outre, la propriété Display a une propriété indexée, Row, et deviceIndex a la valeur TRUE. Le schéma présenté ici génère une requête qui récupère le texte d’une ligne particulière de l’affichage de l’imprimante.

<Property name="Printer">
  <Property name="Display">
    <IndexedProperty name="Row">
      <Value name="Text" type="BIDI_TEXT" 
             oid="1.3.6.1.2.1.43.16.5.1.2" deviceIndex="true"/>
    </IndexedProperty>
  </Property>
</Property>

L’exemple précédent génère la requête suivante :

\Printer.Display.Row1:Text

L’OID généré à partir de cet exemple démarre identique à l’attribut oid dans la propriété Value , mais a deux index ajoutés. Les index ajoutés dans l’exemple proviennent de l’attribut deviceIndex défini sur TRUE et row étant une propriété indexée. En supposant que l’interface utilisateur de configuration de port définit l’index de périphérique comme étant 111 et que le texte de la ligne 1 de l’affichage de l’imprimante présente un intérêt, l’OID généré est 1.3.6.1.2.1.43.16.5.1.2.111.1. Cet OID est identique à l’original, à l’exception de l’index d’appareil (111) et de l’index de propriété (1) à la fin. Si deviceIndex avait été défini sur FALSE ou avait été omis, l’OID résultant aurait été 1.3.6.1.2.1.43.16.5.1.2.1. Pour afficher le texte de la ligne n de l’affichage, utilisez un index de propriété de n.