Freigeben über

Konverter (TCP/IP)

  • Artikel

Mit dem TCP/IP-Konverter-Konstrukt können Sie das bidi-Kommunikationsschema mit Abfragen erweitern, die Daten aus einem bestimmten MIB-Objekt (SNMP Management Information Base) abrufen und die Daten dann in einen Zeichenfolgenwert konvertieren, der auf einer Liste von Wertpaaren basiert, die in Konvertierungselementen angegeben sind. Das Konverterkonstrukt ist in Tcpbidi.xsd definiert.

attribute BESCHREIBUNG
deviceIndex (Optional) Ein boolescher Wert, der bei TRUE bedeutet, dass der zugeordnete Algorithmus den Geräteindex in der angegebenen OID enthalten muss. wenn dieses Attribut FALSE ist, wird eine nachfolgende Null an die OID angefügt. Der Standardwert ist FALSE. Weitere Informationen finden Sie im Hinweis unter dieser Tabelle.
drvPrinterEvent (Optional) Ein boolescher Wert, der angibt, ob der Portmonitor Benachrichtigungen an den Treiber sendet. Ein TRUE-Wert gibt an, dass der Portmonitor Benachrichtigungen an den Treiber sendet. FALSE gibt an, dass der Portmonitor keine Benachrichtigungen an den Treiber sendet.
name Ein Zeichenfolgenwert, der den Namen des Schemaelements darstellt.
Oid Ein Zeichenfolgenwert, der die Adresse des MIB-Objekts als Objekt-ID (OID) darstellt.
refreshInterval (Optional) Ein ganzzahliger Wert des Abrufintervalls in Sekunden. Der Standardwert beträgt 600 Sekunden.
useFirstIndex (Optional) Ein boolescher Wert, der zum Lesen des ersten Eintrags in einer MIB-Tabelle festgelegt werden kann. Dieses Attribut wird nur verwendet, wenn sich das Converter-Konstrukt innerhalb einer Eigenschaft instance befindet.

Hinweis

Ein Netzwerkgerät, das das SNMP-Protokoll unterstützt, kann der Host für verschiedene Untergeräte sein, z. B. Prozessor, Netzwerk, Drucker und Datenträgerspeicher. Die MIB-Tabellen, die in Netzwerkdruckern implementiert sind, enthalten Einträge, die nach Geräteindizes indiziert werden. Zum Abrufen von Daten aus der MIB-Tabelle (z. B. der Name eines Eingabebehälters) muss die Abfrage über einen Geräteindex verfügen, der das Untergerät ordnungsgemäß identifiziert. Mit dem TCP/IP-Standardportmonitor kann der Geräteindex manuell über die Benutzeroberfläche für die Portkonfiguration konfiguriert werden. Eine bidi-Erweiterung mit dem deviceIndex-Attribut , das auf TRUE festgelegt ist, generiert eine OID mit dem entsprechenden Geräteindex, der von der Benutzeroberfläche für die Portkonfiguration abgerufen wird. Wenn das Converter-Konstrukt in einer Eigenschaft instance enthalten ist und das deviceIndex-Attribut fehlt oder auf FALSE festgelegt ist, wird der OID außerdem ein Nullindex an sein Ende angefügt.

Die folgenden MIB-Datentypen werden von den Konvertierungsroutinen unterstützt:

  • INTEGER

  • Integer32

  • Gauge32

  • Counter32

  • TimeTicks

  • Unsigned32

  • Counter64

  • Nicht transparent

  • OCTET STRING

  • OBJEKTBEZEICHNER

Konvertierungselement

Jedes Konverterkonstrukt enthält ein oder mehrere Konvertierungselemente, um die Zuordnung von Werten, die aus den MIB-Elementen gelesen werden, in Bidi-Schemawerte zu definieren.

attribute BESCHREIBUNG
mibValue (Optional) Ein Zeichenfolgenwert, der einen möglichen Datenwert darstellt, der aus der MIB gelesen werden könnte.
bidiValue (Optional) Ein Zeichenfolgenwert, der den bidi-Wert darstellt, der zurückgegeben wird, wenn die Daten mit dem mibValue-Attribut für dieses Conversion-Element übereinstimmen.

Codebeispiel

Im folgenden Codebeispiel wird das bidi-Kommunikationsschema erweitert, indem neue Eigenschaften und Konverterkonstrukte hinzugefügt werden.

<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>

Das vorherige Beispiel führt zu den folgenden Abfragen.

\Printer.Layout.InputBins.Bin###:BinType
\Printer.Layout.Orientation:CurrentValue
\Printer.Custom.HostResourceMIB:InterfaceName

Das Konverterkonstrukt für BinType ist in einem IndexedProperty-instance enthalten, und daher wird der aktuelle MIB-Tabellenzeileneintrag automatisch an die OID angefügt.

Da das Converter-Konstrukt für CurrentValue in einer Eigenschaft instance enthalten ist und das useFirstIndex-Attribut auf "true" festgelegt ist, wird automatisch ein nachfolgendes "1" an die OID angefügt.

Das Converter-Konstrukt für InterfaceName ist in einer Eigenschaft instance enthalten, sodass automatisch eine nachfolgende Null an die OID angefügt wird.