C_12255_Anlage_V1.0.0


gemSpec_Perf - Anpassungen

Vorabinformation zum Änderungseintrag:
Folgende Änderungen sind Bestandteil des Änderungseintrages:
  • Verbesserung des Formats der TSL-Dienst Bestandsdaten
Die Nummerierung der Kapitel entspricht nicht der Nummerierung aus den referenzierenden Dokumenten, da diese durch die Formatierung automatisch erzeugt wird. Dies wird bei der Einarbeitung der Änderungen entsprechend beachtet.

Hinweise zur Lesart:
Text, der zur Erklärung der Änderung dient - wird nicht mit eingearbeitet/übernommen.
Text, der neu ist oder aktualisiert wurde.
Text, der entfernt wird.

1 Produktspezifische Vorgaben

<...>

1.1 TSL-Dienst (PDT04)

<..>

1.1.1 Bestandsdaten TSL-Dienst

Erstellen neuer Versionen der Bestandsdaten-Anforderungen, um das Format der Informationen zu verbessern. 

Alte Anforderungen:

A_26634 - Performance - Bestandsdaten - Spezifika TSL-Dienst

Der Anbieter des Produkttyps MUSS in einem definierten, konfigurierbaren Zeitintervall folgende Performance-Kenngrößen je eindeutiger Konnektoren-Konfigurations-ID berichten:

  • Hash-Datei in der TI - Anzahl aller Aufrufe der Operation I_TSL_Download::get_Hash (TI)  
  • TSL-Datei in der TI - Anzahl aller Aufrufe der Operation I_TSL_Download::download_TSL (TI)
  • Anzahl der eindeutigen Konnektoren, welche eine der beiden Operationen aufrufen
Jede eindeutige Konnektoren-Konfigurations-ID setzt sich zusammen aus den folgenden Konnektor-Informationen: $ProductVendorID-$ProductCode-$HardwareVersion-$FirmwareVersion.
Der Anbieter des Produkttyps MUSS die Bestandsdaten an den Endpunkt gemäß [gemSpec_SST_LD_BD] liefern.

Voreingestellt für das Zeitintervall ist: Täglich. [<=]

A_26635 - Performance - Bestandsdaten - Spezifika TSL-Dienst - Lieferweg und Format

Der Anbieter des Produkttyps MUSS die Informationen aus [A_26634] jeweils zum Wechsel in den nächsten Berichtsintervall in folgendem JSON-Format als HTTP-Body an die Betriebsdatenerfassung (BDE) gemäß [A_23110] liefern.


"timestamp": "<Zeitstempel der Abfrage als String
gemäß ISO 8601 unter expliziter Angabe der Zeitzone UTC im konkreten Format: YYYY-MM-DDTHH:mm:ss[.fff]Z>",
"ci": "<CI-ID der abgefragten Produktinstanz gemäß [A_17764] als String>",
"countUnIp": <Anzahl der IP-Adressen, die keiner eindeutigen Konnektoren-Konfigurations-ID zugewiesen werden können als Integer>,
"tslCounterList": [   
  {   
   "id": "<Konnektoren-Konfigurations-ID gemäß [A_26634] bestehend aus pvid-pc-hwv-fwv als String>",
   "countHash": <Anzahl aller Aufrufe der Operation I_TSL_Download::get_Hash (TI) durch Konnektoren, die der eindeutigen Konnektoren-Konfigurations-ID zugewiesen werden können seit der letzten Lieferung als Integer>,
   "countTsl": <Anzahl aller Aufrufe der Operation I_TSL_Download::download_TSL (TI) durch Konnektoren, die der eindeutigen Konnektoren-Konfigurations-ID zugewiesen werden können seit der letzten Lieferung als Integer>,
   "countIP": <Anzahl der eindeutigen IP-Adressen, welche eine der beiden Operationen aufgerufen haben seit der letzten Lieferung als Integer>
  }
]  
}

Hinweis: Für jede eindeutige Konnektoren-Konfigurations-ID ist dabei ein eigenständiges JSON-Objekt mit den JSON-Keys id, countHash, countTsl und countIP innerhalb des JSON-Array tslCounterList zu erstellen. [<=]

Neue Anforderungen:

A_26634-01 - Performance - Bestandsdaten - Spezifika TSL-Dienst

Der Anbieter des Produkttyps MUSS in einem definierten, konfigurierbaren Zeitintervall folgende Performance-Kenngrößen je eindeutiger Konnektoren-Konfigurations-ID berichten:

  • Hash-Datei in der TI - Anzahl aller Aufrufe der Operation I_TSL_Download::get_Hash (TI)  
  • TSL-Datei in der TI - Anzahl aller Aufrufe der Operation I_TSL_Download::download_TSL (TI)
  • Anzahl der eindeutigen Konnektoren, welche eine der beiden Operationen aufrufen
Jede eindeutige Konnektoren-Konfigurations-ID setzt sich zusammen aus den folgenden Konnektor-Informationen: $ProductVendorID, $ProductCode, $HardwareVersion und $FirmwareVersion.
Der Anbieter des Produkttyps MUSS die Bestandsdaten an den Endpunkt gemäß [gemSpec_SST_LD_BD] liefern.

Voreingestellt für das Zeitintervall ist: Täglich. [<=]

A_26635-01 - Performance - Bestandsdaten - Spezifika TSL-Dienst - Lieferweg und Format

Der Anbieter des Produkttyps MUSS die Informationen aus [A_26634] jeweils zum Wechsel in den nächsten Berichtsintervall in folgendem JSON-Format als HTTP-Body an die Betriebsdatenerfassung (BDE) gemäß [A_23110] liefern.


"timestamp": "<Zeitstempel der Abfrage als String
gemäß ISO 8601 unter expliziter Angabe der Zeitzone UTC im konkreten Format: YYYY-MM-DDTHH:mm:ss[.fff]Z>",
"ci": "<CI-ID der abgefragten Produktinstanz gemäß [A_17764] als String>",
"countUnIp": <Anzahl der IP-Adressen, die keiner eindeutigen Konnektoren-Konfigurations-ID zugewiesen werden können als Integer>,
"tslCounterList": [   
  {   
   "id": "<Konnektoren-Konfigurations-ID gemäß [A_26634] bestehend aus pvid-pc-hwv-fwv als String>",
   "pvid": "<ProductVendorID des Konnektors gemäß [ProductInformation.xsd] als String>",
   "pc": "<ProductCode des Konnektors gemäß [ProductInformation.xsd] als String>",
   "hwv": "<HardwareVersion des Konnektors gemäß [ProductInformation.xsd] als String>",
   "fwv": "<FirmwareVersion des Konnektors gemäß [ProductInformation.xsd] als String>",

   "countHash": <Anzahl aller Aufrufe der Operation I_TSL_Download::get_Hash (TI) durch Konnektoren, die der eindeutigen Konnektoren-Konfigurations-ID zugewiesen werden können seit der letzten Lieferung als Integer>,
   "countTsl": <Anzahl aller Aufrufe der Operation I_TSL_Download::download_TSL (TI) durch Konnektoren, die der eindeutigen Konnektoren-Konfigurations-ID zugewiesen werden können seit der letzten Lieferung als Integer>,
   "countIP": <Anzahl der eindeutigen IP-Adressen, welche eine der beiden Operationen aufgerufen haben seit der letzten Lieferung als Integer>
  }
]  
}

Hinweise:

  • Für jede eindeutige Konnektoren-Konfigurations-ID ist dabei ein eigenständiges JSON-Objekt mit den JSON-Keys id, pvid, pc, hwv, fwv, countHash, countTsl und countIP innerhalb des JSON-Array tslCounterList zu erstellen.
  • Können Aufrufe keiner eindeutigen Konnektor-Konfiguration zugewiesen werden, sind diese in einem JSON-Objekt innerhalb des JSON-Array tslCounterList zu kumulieren, wo für die JSON-Keys pvid, pc, hwv, fwv jeweils ein NULL zu übermitteln ist
[<=]