Condividi tramite

Convertitore (TCP/IP)

  • Articolo

Il costrutto TCP/IP Converter consente di estendere lo schema di comunicazione bidi con query che recuperano dati da un particolare oggetto MIB (SNMP Management Information Base) e quindi convertire i dati in un valore stringa basato su un elenco di coppie valore specificate in Elementi di conversione. Il costrutto Converter è definito in Tcpbidi.xsd.

Attributo Descrizione
deviceIndex (Facoltativo) Valore booleano che, se TRUE, indica che l'algoritmo associato deve includere l'indice del dispositivo nell'OID specificato; quando questo attributo FALSE, all'OID viene aggiunto uno zero finale. Il valore predefinito è FALSE. Per altre informazioni, vedere la nota che segue questa tabella.
drvPrinterEvent (Facoltativo) Valore booleano che indica se il monitoraggio delle porte invia notifiche al driver. Un valore TRUE indica che il monitoraggio delle porte invia notifiche al driver; FALSE indica che il monitoraggio delle porte non invia notifiche al driver.
nome Valore stringa che rappresenta il nome dell'elemento dello schema.
oid Valore stringa che rappresenta l'indirizzo dell'oggetto MIB, come ID oggetto (OID).
refreshInterval (Facoltativo) Valore intero dell'intervallo di polling, espresso in secondi. Il valore predefinito è 600 secondi.
useFirstIndex (Facoltativo) Valore booleano che può essere impostato per leggere la prima voce in una tabella MIB. Questo attributo viene usato solo quando il costrutto Converter si trova all'interno di un'istanza di Property.

Nota

Un dispositivo di rete che supporta il protocollo SNMP può essere l'host per diversi sottodispositivi, ad esempio Processore, Rete, Stampante e Archiviazione su disco. Le tabelle MIB implementate nelle stampanti di rete includono voci indicizzate dagli indici dei dispositivi. Per recuperare dati dalla tabella MIB , ad esempio il nome di un contenitore di input, la query deve avere un indice del dispositivo che identifica correttamente il sottodispositivo. Il monitoraggio della porta TCP/IP standard consente di configurare manualmente l'indice del dispositivo tramite l'interfaccia utente di configurazione della porta. Un'estensione bidi con l'attributo deviceIndex impostato su TRUE genera un OID con l'indice del dispositivo appropriato ottenuto dall'interfaccia utente di configurazione della porta. Inoltre, se il costrutto Converter è contenuto in un'istanza property e l'attributo deviceIndex è mancante o impostato su FALSE, l'OID avrà un indice zero aggiunto alla fine.

I tipi di dati MIB seguenti sono supportati dalle routine di conversione:

  • INTEGER

  • Integer32

  • Misuratore32

  • Counter32

  • TimeTicks

  • Unsigned32

  • Counter64

  • Opaco

  • OCTET STRING

  • IDENTIFICATORE OGGETTO

Elemento Conversion

Ogni costrutto Converter includerà uno o più elementi Conversion per definire il mapping dei valori letti dagli elementi MIB nei valori dello schema Bidi.

Attributo Descrizione
mibValue (Facoltativo) Valore stringa che rappresenta un valore di dati possibile che può essere letto dal MIB.
bidiValue (Facoltativo) Valore stringa che rappresenta il valore bidi restituito se i dati corrispondono all'attributo mibValue per questo elemento Conversion.

Esempio di codice

Nell'esempio di codice seguente viene esteso lo schema delle comunicazioni bidi aggiungendo nuove proprietà e costrutti Converter.

<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'esempio precedente restituisce le query seguenti.

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

Il costrutto Converter per BinType è contenuto in un'istanza di IndexedProperty e, di conseguenza, la voce di riga della tabella MIB corrente viene aggiunta automaticamente all'OID.

Poiché il costrutto Converter per CurrentValue è contenuto in un'istanza di Property e l'attributo useFirstIndex è impostato su "true", all'OID viene aggiunto automaticamente un carattere finale "1".

Il costrutto Converter per InterfaceName è contenuto in un'istanza di Property, quindi un valore zero finale viene aggiunto automaticamente all'OID.